rampkit-expo-dev 0.0.23 → 0.0.25

package/android/build.gradle

@@ -74,6 +74,9 @@ dependencies {
   implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7:${getKotlinVersion()}"
   implementation 'com.google.android.play:review:2.0.1'
   implementation 'com.google.android.play:review-ktx:2.0.1'
+  implementation 'com.android.billingclient:billing:6.1.0'
+  implementation 'com.android.billingclient:billing-ktx:6.1.0'
+  implementation 'org.jetbrains.kotlinx:kotlinx-coroutines-android:1.7.3'
 }
 
 def getKotlinVersion() {

package/android/src/main/java/expo/modules/rampkit/RampKitModule.kt

@@ -1,7 +1,6 @@
 package expo.modules.rampkit
 
 import android.Manifest
-import android.app.Activity
 import android.app.ActivityManager
 import android.app.NotificationChannel
 import android.app.NotificationManager
@@ -16,26 +15,39 @@ import android.os.Vibrator
 import android.os.VibratorManager
 import android.provider.Settings
 import android.util.DisplayMetrics
+import android.util.Log
 import android.view.WindowManager
 import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
+import com.android.billingclient.api.*
 import com.google.android.play.core.review.ReviewManagerFactory
 import expo.modules.kotlin.Promise
 import expo.modules.kotlin.modules.Module
 import expo.modules.kotlin.modules.ModuleDefinition
+import kotlinx.coroutines.*
+import org.json.JSONObject
+import java.io.OutputStreamWriter
+import java.net.HttpURLConnection
+import java.net.URL
 import java.text.SimpleDateFormat
 import java.util.Date
 import java.util.Locale
 import java.util.TimeZone
 import java.util.UUID
 
-class RampKitModule : Module() {
+class RampKitModule : Module(), PurchasesUpdatedListener {
+  private val TAG = "RampKit"
   private val PREFS_NAME = "rampkit_prefs"
   private val USER_ID_KEY = "rk_user_id"
   private val INSTALL_DATE_KEY = "rk_install_date"
   private val LAUNCH_COUNT_KEY = "rk_launch_count"
   private val LAST_LAUNCH_KEY = "rk_last_launch"
 
+  private var billingClient: BillingClient? = null
+  private var appId: String? = null
+  private var userId: String? = null
+  private val coroutineScope = CoroutineScope(Dispatchers.IO + SupervisorJob())
+
   private val context: Context
     get() = requireNotNull(appContext.reactContext)
 
@@ -94,7 +106,7 @@ class RampKitModule : Module() {
     }
 
     AsyncFunction("isReviewAvailable") {
-      true // Google Play In-App Review is generally available
+      true
     }
 
     AsyncFunction("getStoreUrl") {
@@ -112,6 +124,300 @@ class RampKitModule : Module() {
     AsyncFunction("getNotificationPermissions") {
       getNotificationPermissions()
     }
+
+    // ============================================================================
+    // Transaction Observer (Google Play Billing)
+    // ============================================================================
+
+    AsyncFunction("startTransactionObserver") { appId: String ->
+      startTransactionObserver(appId)
+    }
+
+    AsyncFunction("stopTransactionObserver") {
+      stopTransactionObserver()
+    }
+
+    OnDestroy {
+      stopTransactionObserver()
+      coroutineScope.cancel()
+    }
+  }
+
+  // ============================================================================
+  // PurchasesUpdatedListener Implementation
+  // ============================================================================
+
+  override fun onPurchasesUpdated(billingResult: BillingResult, purchases: MutableList<Purchase>?) {
+    if (billingResult.responseCode == BillingClient.BillingResponseCode.OK && purchases != null) {
+      for (purchase in purchases) {
+        handlePurchase(purchase)
+      }
+    } else if (billingResult.responseCode == BillingClient.BillingResponseCode.USER_CANCELED) {
+      Log.d(TAG, "User cancelled the purchase")
+    } else {
+      Log.e(TAG, "Purchase failed: ${billingResult.debugMessage}")
+    }
+  }
+
+  // ============================================================================
+  // Transaction Observer
+  // ============================================================================
+
+  private fun startTransactionObserver(appId: String) {
+    this.appId = appId
+    this.userId = getOrCreateUserId()
+
+    billingClient = BillingClient.newBuilder(context)
+      .setListener(this)
+      .enablePendingPurchases()
+      .build()
+
+    billingClient?.startConnection(object : BillingClientStateListener {
+      override fun onBillingSetupFinished(billingResult: BillingResult) {
+        if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
+          Log.d(TAG, "Billing client connected")
+          // Query existing purchases
+          queryExistingPurchases()
+        } else {
+          Log.e(TAG, "Billing setup failed: ${billingResult.debugMessage}")
+        }
+      }
+
+      override fun onBillingServiceDisconnected() {
+        Log.d(TAG, "Billing service disconnected")
+        // Try to reconnect
+        coroutineScope.launch {
+          delay(5000)
+          startTransactionObserver(appId)
+        }
+      }
+    })
+
+    Log.d(TAG, "Transaction observer started")
+  }
+
+  private fun stopTransactionObserver() {
+    billingClient?.endConnection()
+    billingClient = null
+    Log.d(TAG, "Transaction observer stopped")
+  }
+
+  private fun queryExistingPurchases() {
+    val client = billingClient ?: return
+
+    // Query in-app purchases
+    client.queryPurchasesAsync(
+      QueryPurchasesParams.newBuilder()
+        .setProductType(BillingClient.ProductType.INAPP)
+        .build()
+    ) { billingResult, purchases ->
+      if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
+        for (purchase in purchases) {
+          if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED && !purchase.isAcknowledged) {
+            handlePurchase(purchase)
+          }
+        }
+      }
+    }
+
+    // Query subscriptions
+    client.queryPurchasesAsync(
+      QueryPurchasesParams.newBuilder()
+        .setProductType(BillingClient.ProductType.SUBS)
+        .build()
+    ) { billingResult, purchases ->
+      if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
+        for (purchase in purchases) {
+          if (purchase.purchaseState == Purchase.PurchaseState.PURCHASED && !purchase.isAcknowledged) {
+            handlePurchase(purchase)
+          }
+        }
+      }
+    }
+  }
+
+  private fun handlePurchase(purchase: Purchase) {
+    val appId = this.appId ?: return
+    val userId = this.userId ?: return
+
+    when (purchase.purchaseState) {
+      Purchase.PurchaseState.PURCHASED -> {
+        // Acknowledge the purchase if not already acknowledged
+        if (!purchase.isAcknowledged) {
+          val acknowledgePurchaseParams = AcknowledgePurchaseParams.newBuilder()
+            .setPurchaseToken(purchase.purchaseToken)
+            .build()
+          
+          billingClient?.acknowledgePurchase(acknowledgePurchaseParams) { result ->
+            if (result.responseCode == BillingClient.BillingResponseCode.OK) {
+              Log.d(TAG, "Purchase acknowledged")
+            }
+          }
+        }
+
+        // Get product details for price info
+        coroutineScope.launch {
+          val productDetails = getProductDetails(purchase.products.firstOrNull() ?: "")
+          
+          val properties = mutableMapOf<String, Any?>(
+            "productId" to purchase.products.firstOrNull(),
+            "transactionId" to purchase.orderId,
+            "originalTransactionId" to purchase.orderId,
+            "purchaseToken" to purchase.purchaseToken,
+            "purchaseDate" to getIso8601Timestamp(purchase.purchaseTime),
+            "quantity" to purchase.quantity,
+            "isAutoRenewing" to purchase.isAutoRenewing
+          )
+
+          productDetails?.let { details ->
+            val pricingPhase = details.subscriptionOfferDetails?.firstOrNull()?.pricingPhases?.pricingPhaseList?.firstOrNull()
+              ?: details.oneTimePurchaseOfferDetails?.let { oneTime ->
+                object {
+                  val priceAmountMicros = oneTime.priceAmountMicros
+                  val priceCurrencyCode = oneTime.priceCurrencyCode
+                  val formattedPrice = oneTime.formattedPrice
+                }
+              }
+
+            if (pricingPhase != null) {
+              properties["price"] = when (pricingPhase) {
+                is ProductDetails.PricingPhase -> pricingPhase.priceAmountMicros / 1_000_000.0
+                else -> (pricingPhase as? Any)?.let { 
+                  (it.javaClass.getMethod("getPriceAmountMicros").invoke(it) as Long) / 1_000_000.0 
+                }
+              }
+              properties["currency"] = when (pricingPhase) {
+                is ProductDetails.PricingPhase -> pricingPhase.priceCurrencyCode
+                else -> (pricingPhase as? Any)?.let {
+                  it.javaClass.getMethod("getPriceCurrencyCode").invoke(it) as String
+                }
+              }
+              properties["localizedPrice"] = when (pricingPhase) {
+                is ProductDetails.PricingPhase -> pricingPhase.formattedPrice
+                else -> (pricingPhase as? Any)?.let {
+                  it.javaClass.getMethod("getFormattedPrice").invoke(it) as String
+                }
+              }
+            }
+            properties["localizedName"] = details.name
+            properties["productType"] = details.productType
+          }
+
+          sendPurchaseEvent(appId, userId, "purchase_completed", properties)
+        }
+      }
+      Purchase.PurchaseState.PENDING -> {
+        Log.d(TAG, "Purchase pending: ${purchase.products}")
+      }
+    }
+  }
+
+  private suspend fun getProductDetails(productId: String): ProductDetails? {
+    if (productId.isEmpty()) return null
+    val client = billingClient ?: return null
+
+    // Try as subscription first
+    var result = queryProductDetails(client, productId, BillingClient.ProductType.SUBS)
+    if (result == null) {
+      // Try as in-app purchase
+      result = queryProductDetails(client, productId, BillingClient.ProductType.INAPP)
+    }
+    return result
+  }
+
+  private suspend fun queryProductDetails(
+    client: BillingClient,
+    productId: String,
+    productType: String
+  ): ProductDetails? = suspendCancellableCoroutine { continuation ->
+    val productList = listOf(
+      QueryProductDetailsParams.Product.newBuilder()
+        .setProductId(productId)
+        .setProductType(productType)
+        .build()
+    )
+
+    val params = QueryProductDetailsParams.newBuilder()
+      .setProductList(productList)
+      .build()
+
+    client.queryProductDetailsAsync(params) { billingResult, productDetailsList ->
+      if (billingResult.responseCode == BillingClient.BillingResponseCode.OK) {
+        continuation.resume(productDetailsList.firstOrNull()) {}
+      } else {
+        continuation.resume(null) {}
+      }
+    }
+  }
+
+  private fun sendPurchaseEvent(appId: String, userId: String, eventName: String, properties: Map<String, Any?>) {
+    coroutineScope.launch {
+      try {
+        val event = JSONObject().apply {
+          put("appId", appId)
+          put("appUserId", userId)
+          put("eventId", UUID.randomUUID().toString().lowercase())
+          put("eventName", eventName)
+          put("sessionId", UUID.randomUUID().toString().lowercase())
+          put("occurredAt", getIso8601Timestamp())
+          put("device", JSONObject().apply {
+            put("platform", "Android")
+            put("platformVersion", Build.VERSION.RELEASE)
+            put("deviceModel", "${Build.MANUFACTURER} ${Build.MODEL}")
+            put("sdkVersion", "1.0.0")
+            put("appVersion", getAppVersion())
+            put("buildNumber", getBuildNumber())
+          })
+          put("context", JSONObject().apply {
+            put("locale", Locale.getDefault().toLanguageTag())
+            put("regionCode", Locale.getDefault().country)
+          })
+          put("properties", JSONObject(properties.filterValues { it != null }))
+        }
+
+        val url = URL("https://uustlzuvjmochxkxatfx.supabase.co/functions/v1/app-user-events")
+        val connection = url.openConnection() as HttpURLConnection
+        connection.apply {
+          requestMethod = "POST"
+          setRequestProperty("Content-Type", "application/json")
+          setRequestProperty("apikey", "eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InV1c3RsenV2am1vY2h4a3hhdGZ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3MzU1NjQ0NjYsImV4cCI6MjA1MTE0MDQ2Nn0.5cNrph5LHmssNo39UKpULkC9n4OD5n6gsnTEQV-gwQk")
+          setRequestProperty("Authorization", "Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InV1c3RsenV2am1vY2h4a3hhdGZ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3MzU1NjQ0NjYsImV4cCI6MjA1MTE0MDQ2Nn0.5cNrph5LHmssNo39UKpULkC9n4OD5n6gsnTEQV-gwQk")
+          doOutput = true
+        }
+
+        OutputStreamWriter(connection.outputStream).use { writer ->
+          writer.write(event.toString())
+        }
+
+        val responseCode = connection.responseCode
+        Log.d(TAG, "Purchase event sent: $eventName - Status: $responseCode")
+        connection.disconnect()
+      } catch (e: Exception) {
+        Log.e(TAG, "Failed to send purchase event", e)
+      }
+    }
+  }
+
+  private fun getAppVersion(): String? {
+    return try {
+      context.packageManager.getPackageInfo(context.packageName, 0).versionName
+    } catch (e: Exception) {
+      null
+    }
+  }
+
+  private fun getBuildNumber(): String? {
+    return try {
+      val packageInfo = context.packageManager.getPackageInfo(context.packageName, 0)
+      if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
+        packageInfo.longVersionCode.toString()
+      } else {
+        @Suppress("DEPRECATION")
+        packageInfo.versionCode.toString()
+      }
+    } catch (e: Exception) {
+      null
+    }
   }
 
   // Device Info Collection
@@ -138,7 +444,7 @@ class RampKitModule : Module() {
       "bundleId" to context.packageName,
       "appName" to getAppName(),
       "appVersion" to packageInfo?.versionName,
-      "buildNumber" to getBuildNumber(packageInfo),
+      "buildNumber" to getBuildNumberFromPackage(packageInfo),
       "platform" to "Android",
       "platformVersion" to Build.VERSION.RELEASE,
       "deviceModel" to "${Build.MANUFACTURER} ${Build.MODEL}",
@@ -295,7 +601,6 @@ class RampKitModule : Module() {
 
   // Notifications
   private fun requestNotificationPermissions(options: Map<String, Any>?): Map<String, Any> {
-    // Create notification channel for Android 8+
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.O) {
       val androidOptions = options?.get("android") as? Map<*, *>
       val channelId = androidOptions?.get("channelId") as? String ?: "default"
@@ -314,7 +619,6 @@ class RampKitModule : Module() {
       notificationManager.createNotificationChannel(channel)
     }
 
-    // For Android 13+, check POST_NOTIFICATIONS permission
     if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.TIRAMISU) {
       val granted = ContextCompat.checkSelfPermission(
         context,
@@ -322,7 +626,6 @@ class RampKitModule : Module() {
       ) == PackageManager.PERMISSION_GRANTED
 
       if (!granted) {
-        // Request permission - this will be handled by the app
         appContext.currentActivity?.let { activity ->
           ActivityCompat.requestPermissions(
             activity,
@@ -339,7 +642,6 @@ class RampKitModule : Module() {
       )
     }
 
-    // For older Android versions, notifications are allowed by default
     return mapOf(
       "granted" to true,
       "status" to "granted",
@@ -388,7 +690,7 @@ class RampKitModule : Module() {
     }
   }
 
-  private fun getBuildNumber(packageInfo: android.content.pm.PackageInfo?): String? {
+  private fun getBuildNumberFromPackage(packageInfo: android.content.pm.PackageInfo?): String? {
     return if (Build.VERSION.SDK_INT >= Build.VERSION_CODES.P) {
       packageInfo?.longVersionCode?.toString()
     } else {
@@ -442,4 +744,10 @@ class RampKitModule : Module() {
     sdf.timeZone = TimeZone.getTimeZone("UTC")
     return sdf.format(Date())
   }
+
+  private fun getIso8601Timestamp(millis: Long): String {
+    val sdf = SimpleDateFormat("yyyy-MM-dd'T'HH:mm:ss.SSS'Z'", Locale.US)
+    sdf.timeZone = TimeZone.getTimeZone("UTC")
+    return sdf.format(Date(millis))
+  }
 }

package/build/RampKit.d.ts

@@ -67,43 +67,8 @@ export declare class RampKitCore {
      * Track a CTA tap
      */
     trackCtaTap(buttonId: string, buttonText?: string): void;
-    /**
-     * Track paywall shown
-     */
-    trackPaywallShown(paywallId: string, placement?: string, products?: Array<{
-        productId: string;
-        price?: number;
-        currency?: string;
-    }>): void;
-    /**
-     * Track paywall primary action tap
-     */
-    trackPaywallPrimaryActionTap(paywallId: string, productId?: string): void;
-    /**
-     * Track paywall closed
-     */
-    trackPaywallClosed(paywallId: string, reason: "dismissed" | "purchased" | "backgrounded"): void;
-    /**
-     * Track purchase started
-     */
-    trackPurchaseStarted(productId: string, amount?: number, currency?: string): void;
-    /**
-     * Track purchase completed
-     */
-    trackPurchaseCompleted(properties: {
-        productId: string;
-        amount: number;
-        currency: string;
-        transactionId: string;
-        originalTransactionId?: string;
-        purchaseDate?: string;
-    }): void;
-    /**
-     * Track purchase failed
-     */
-    trackPurchaseFailed(productId: string, errorCode: string, errorMessage: string): void;
     /**
      * Cleanup SDK resources
      */
-    cleanup(): void;
+    cleanup(): Promise<void>;
 }

package/build/RampKit.js

@@ -10,6 +10,7 @@ const RampkitOverlay_1 = require("./RampkitOverlay");
 const userId_1 = require("./userId");
 const DeviceInfoCollector_1 = require("./DeviceInfoCollector");
 const EventManager_1 = require("./EventManager");
+const RampKitNative_1 = require("./RampKitNative");
 const constants_1 = require("./constants");
 class RampKitCore {
     constructor() {
@@ -51,6 +52,9 @@ class RampKitCore {
             EventManager_1.eventManager.trackAppSessionStarted(this.deviceInfo.isFirstLaunch, this.deviceInfo.launchCount);
             // Step 5: Setup app state listener for background/foreground tracking
             this.setupAppStateListener();
+            // Step 6: Start transaction observer for automatic purchase tracking
+            console.log("[RampKit] Init: Starting transaction observer...");
+            await RampKitNative_1.TransactionObserver.start(config.appId);
             this.initialized = true;
         }
         catch (e) {
@@ -276,46 +280,15 @@ class RampKitCore {
     trackCtaTap(buttonId, buttonText) {
         EventManager_1.eventManager.trackCtaTap(buttonId, buttonText);
     }
-    /**
-     * Track paywall shown
-     */
-    trackPaywallShown(paywallId, placement, products) {
-        EventManager_1.eventManager.trackPaywallShown(paywallId, placement, products);
-    }
-    /**
-     * Track paywall primary action tap
-     */
-    trackPaywallPrimaryActionTap(paywallId, productId) {
-        EventManager_1.eventManager.trackPaywallPrimaryActionTap(paywallId, productId);
-    }
-    /**
-     * Track paywall closed
-     */
-    trackPaywallClosed(paywallId, reason) {
-        EventManager_1.eventManager.trackPaywallClosed(paywallId, reason);
-    }
-    /**
-     * Track purchase started
-     */
-    trackPurchaseStarted(productId, amount, currency) {
-        EventManager_1.eventManager.trackPurchaseStarted(productId, amount, currency);
-    }
-    /**
-     * Track purchase completed
-     */
-    trackPurchaseCompleted(properties) {
-        EventManager_1.eventManager.trackPurchaseCompleted(properties);
-    }
-    /**
-     * Track purchase failed
-     */
-    trackPurchaseFailed(productId, errorCode, errorMessage) {
-        EventManager_1.eventManager.trackPurchaseFailed(productId, errorCode, errorMessage);
-    }
+    // Note: Purchase and paywall events are automatically tracked by the native
+    // StoreKit 2 (iOS) and Google Play Billing (Android) transaction observers.
+    // No manual tracking is needed.
     /**
      * Cleanup SDK resources
      */
-    cleanup() {
+    async cleanup() {
+        // Stop transaction observer
+        await RampKitNative_1.TransactionObserver.stop();
         if (this.appStateSubscription) {
             this.appStateSubscription.remove();
             this.appStateSubscription = null;

package/build/RampKitNative.d.ts

@@ -16,6 +16,8 @@ interface RampKitNativeModule {
     getStoreUrl(): Promise<string | null>;
     requestNotificationPermissions(options?: NotificationOptions): Promise<NotificationPermissionResult>;
     getNotificationPermissions(): Promise<NotificationPermissionResult>;
+    startTransactionObserver(appId: string): Promise<void>;
+    stopTransactionObserver(): Promise<void>;
 }
 export interface NativeDeviceInfo {
     appUserId: string;
@@ -149,3 +151,15 @@ export declare const Notifications: {
         MIN: number;
     };
 };
+export declare const TransactionObserver: {
+    /**
+     * Start listening for purchase transactions
+     * Automatically tracks purchases to the RampKit backend
+     * @param appId - The RampKit app ID
+     */
+    start(appId: string): Promise<void>;
+    /**
+     * Stop listening for purchase transactions
+     */
+    stop(): Promise<void>;
+};

package/build/RampKitNative.js

@@ -4,7 +4,7 @@
  * TypeScript interface to the native iOS/Android module
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Notifications = exports.StoreReview = exports.Haptics = void 0;
+exports.TransactionObserver = exports.Notifications = exports.StoreReview = exports.Haptics = void 0;
 exports.getDeviceInfo = getDeviceInfo;
 exports.getUserId = getUserId;
 exports.getStoredValue = getStoredValue;
@@ -60,6 +60,8 @@ function createFallbackModule() {
         async getNotificationPermissions() {
             return { granted: false, status: "denied", canAskAgain: false };
         },
+        async startTransactionObserver(_appId) { },
+        async stopTransactionObserver() { },
     };
 }
 function generateFallbackUserId() {
@@ -253,3 +255,34 @@ exports.Notifications = {
         MIN: 1,
     },
 };
+// ============================================================================
+// Transaction Observer API (StoreKit 2 / Google Play Billing)
+// ============================================================================
+exports.TransactionObserver = {
+    /**
+     * Start listening for purchase transactions
+     * Automatically tracks purchases to the RampKit backend
+     * @param appId - The RampKit app ID
+     */
+    async start(appId) {
+        try {
+            await RampKitNativeModule.startTransactionObserver(appId);
+            console.log("[RampKit] Transaction observer started");
+        }
+        catch (e) {
+            console.warn("[RampKit] Failed to start transaction observer:", e);
+        }
+    },
+    /**
+     * Stop listening for purchase transactions
+     */
+    async stop() {
+        try {
+            await RampKitNativeModule.stopTransactionObserver();
+            console.log("[RampKit] Transaction observer stopped");
+        }
+        catch (e) {
+            console.warn("[RampKit] Failed to stop transaction observer:", e);
+        }
+    },
+};

package/build/RampkitOverlay.js

@@ -366,6 +366,11 @@ function Overlay(props) {
             else if (typeof pager.setPageWithoutAnimation === "function") {
                 pager.setPageWithoutAnimation(nextIndex);
             }
+            // Explicitly send vars to the new page after setting it
+            // This ensures the webview receives the latest state
+            requestAnimationFrame(() => {
+                sendVarsToWebView(nextIndex);
+            });
             return;
         }
         setIsTransitioning(true);
@@ -380,6 +385,10 @@ function Overlay(props) {
             // @ts-ignore: method exists on PagerView instance
             (_c = (_b = (_a = pagerRef.current) === null || _a === void 0 ? void 0 : _a.setPageWithoutAnimation) === null || _b === void 0 ? void 0 : _b.call(_a, nextIndex)) !== null && _c !== void 0 ? _c : (_d = pagerRef.current) === null || _d === void 0 ? void 0 : _d.setPage(nextIndex);
             requestAnimationFrame(() => {
+                // Explicitly send vars to the new page after the page switch completes
+                // This ensures the webview receives the latest state even if onPageSelected
+                // timing was off during the transition
+                sendVarsToWebView(nextIndex);
                 react_native_1.Animated.timing(fadeOpacity, {
                     toValue: 0,
                     duration: 160,
@@ -395,14 +404,20 @@ function Overlay(props) {
             .replace(/`/g, "\\`");
         return `(function(){try{document.dispatchEvent(new MessageEvent('message',{data:${json}}));}catch(e){}})();`;
     }
-    function sendVarsToWebView(i) {
+    function sendVarsToWebView(i, isInitialLoad = false) {
         const wv = webviewsRef.current[i];
         if (!wv)
             return;
         const payload = { type: "rampkit:variables", vars: varsRef.current };
         if (__DEV__)
-            console.log("[Rampkit] sendVarsToWebView", i, varsRef.current);
-        lastInitSendRef.current[i] = Date.now();
+            console.log("[Rampkit] sendVarsToWebView", i, varsRef.current, { isInitialLoad });
+        // Only update the stale filter timestamp during initial page load,
+        // not when syncing vars on page selection. This prevents the filter
+        // from incorrectly rejecting legitimate user interactions that happen
+        // immediately after navigating to a screen.
+        if (isInitialLoad) {
+            lastInitSendRef.current[i] = Date.now();
+        }
         // @ts-ignore: injectJavaScript exists on WebView instance
         wv.injectJavaScript(buildDispatchScript(payload));
     }
@@ -470,7 +485,12 @@ function Overlay(props) {
         // ensure current page is synced with latest vars when selected
         if (__DEV__)
             console.log("[Rampkit] onPageSelected", pos);
-        sendVarsToWebView(pos);
+        // Use requestAnimationFrame to ensure the webview is fully active and ready
+        // to receive injected JS. Without this delay, the first navigation back
+        // to a screen may not properly receive the updated variables.
+        requestAnimationFrame(() => {
+            sendVarsToWebView(pos);
+        });
         // Track screen change event
         if (props.onScreenChange && props.screens[pos]) {
             props.onScreenChange(pos, props.screens[pos].id);
@@ -561,10 +581,10 @@ function Overlay(props) {
                                     props.onScreenChange(0, props.screens[0].id);
                                 }
                             }
-                            // Initialize this page with current vars
+                            // Initialize this page with current vars (isInitialLoad=true to enable stale filter)
                             if (__DEV__)
                                 console.log("[Rampkit] onLoadEnd init send vars", i);
-                            sendVarsToWebView(i);
+                            sendVarsToWebView(i, true);
                         }, onMessage: (ev) => {
                             var _a, _b, _c, _d;
                             const raw = ev.nativeEvent.data;

package/build/index.d.ts

@@ -9,7 +9,7 @@ export { eventManager } from "./EventManager";
 export { collectDeviceInfo, getSessionDurationSeconds, getSessionStartTime, } from "./DeviceInfoCollector";
 export { default as RampKitNative } from "./RampKitNative";
 export type { NativeDeviceInfo, NativeLaunchData } from "./RampKitNative";
-export { Haptics, StoreReview, Notifications } from "./RampKitNative";
+export { Haptics, StoreReview, Notifications, TransactionObserver } from "./RampKitNative";
 export type { ImpactStyle, NotificationType, NotificationOptions, NotificationPermissionResult } from "./RampKitNative";
 export type { DeviceInfo, RampKitEvent, EventDevice, EventContext, RampKitConfig, RampKitEventName, AppSessionStartedProperties, AppSessionEndedProperties, AppBackgroundedProperties, AppForegroundedProperties, OnboardingStartedProperties, OnboardingScreenViewedProperties, OnboardingQuestionAnsweredProperties, OnboardingCompletedProperties, OnboardingAbandonedProperties, ScreenViewProperties, CtaTapProperties, NotificationsPromptShownProperties, NotificationsResponseProperties, PaywallShownProperties, PaywallPrimaryActionTapProperties, PaywallClosedProperties, PurchaseStartedProperties, PurchaseCompletedProperties, PurchaseFailedProperties, } from "./types";
 export { SDK_VERSION, CAPABILITIES } from "./constants";

package/build/index.js

@@ -7,7 +7,7 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.CAPABILITIES = exports.SDK_VERSION = exports.Notifications = exports.StoreReview = exports.Haptics = exports.RampKitNative = exports.getSessionStartTime = exports.getSessionDurationSeconds = exports.collectDeviceInfo = exports.eventManager = exports.getRampKitUserId = exports.RampKit = void 0;
+exports.CAPABILITIES = exports.SDK_VERSION = exports.TransactionObserver = exports.Notifications = exports.StoreReview = exports.Haptics = exports.RampKitNative = exports.getSessionStartTime = exports.getSessionDurationSeconds = exports.collectDeviceInfo = exports.eventManager = exports.getRampKitUserId = exports.RampKit = void 0;
 const RampKit_1 = require("./RampKit");
 // Main SDK singleton instance
 exports.RampKit = RampKit_1.RampKitCore.instance;
@@ -30,6 +30,7 @@ var RampKitNative_2 = require("./RampKitNative");
 Object.defineProperty(exports, "Haptics", { enumerable: true, get: function () { return RampKitNative_2.Haptics; } });
 Object.defineProperty(exports, "StoreReview", { enumerable: true, get: function () { return RampKitNative_2.StoreReview; } });
 Object.defineProperty(exports, "Notifications", { enumerable: true, get: function () { return RampKitNative_2.Notifications; } });
+Object.defineProperty(exports, "TransactionObserver", { enumerable: true, get: function () { return RampKitNative_2.TransactionObserver; } });
 // Export constants
 var constants_1 = require("./constants");
 Object.defineProperty(exports, "SDK_VERSION", { enumerable: true, get: function () { return constants_1.SDK_VERSION; } });

package/ios/RampKitModule.swift

@@ -10,6 +10,11 @@ public class RampKitModule: Module {
   private let launchCountKey = "rk_launch_count"
   private let lastLaunchKey = "rk_last_launch"
   
+  // Transaction observer task
+  private var transactionObserverTask: Task<Void, Never>?
+  private var appId: String?
+  private var userId: String?
+  
   public func definition() -> ModuleDefinition {
     Name("RampKit")
     
@@ -62,11 +67,10 @@ public class RampKitModule: Module {
     }
     
     AsyncFunction("isReviewAvailable") { () -> Bool in
-      return true // Always available on iOS
+      return true
     }
     
     AsyncFunction("getStoreUrl") { () -> String? in
-      // Return nil - app should provide its own store URL
       return nil
     }
     
@@ -81,6 +85,18 @@ public class RampKitModule: Module {
     AsyncFunction("getNotificationPermissions") { () -> [String: Any] in
       return await self.getNotificationPermissions()
     }
+    
+    // ============================================================================
+    // Transaction Observer (StoreKit 2)
+    // ============================================================================
+    
+    AsyncFunction("startTransactionObserver") { (appId: String) in
+      self.startTransactionObserver(appId: appId)
+    }
+    
+    AsyncFunction("stopTransactionObserver") { () in
+      self.stopTransactionObserver()
+    }
   }
   
   // MARK: - Device Info Collection
@@ -369,6 +385,205 @@ public class RampKitModule: Module {
     }
   }
   
+  // MARK: - StoreKit 2 Transaction Observer
+  
+  private func startTransactionObserver(appId: String) {
+    self.appId = appId
+    self.userId = getOrCreateUserId()
+    
+    // Cancel existing observer if any
+    transactionObserverTask?.cancel()
+    
+    // Start listening for transactions (iOS 15+)
+    if #available(iOS 15.0, *) {
+      transactionObserverTask = Task {
+        await self.listenForTransactions()
+      }
+      
+      // Also check for any unfinished transactions
+      Task {
+        await self.handleUnfinishedTransactions()
+      }
+    }
+    
+    print("[RampKit] Transaction observer started")
+  }
+  
+  private func stopTransactionObserver() {
+    transactionObserverTask?.cancel()
+    transactionObserverTask = nil
+    print("[RampKit] Transaction observer stopped")
+  }
+  
+  @available(iOS 15.0, *)
+  private func listenForTransactions() async {
+    // Listen for transaction updates
+    for await result in Transaction.updates {
+      do {
+        let transaction = try self.checkVerified(result)
+        await self.handleTransaction(transaction)
+        await transaction.finish()
+      } catch {
+        print("[RampKit] Transaction verification failed: \(error)")
+      }
+    }
+  }
+  
+  @available(iOS 15.0, *)
+  private func handleUnfinishedTransactions() async {
+    // Handle any transactions that weren't finished
+    for await result in Transaction.unfinished {
+      do {
+        let transaction = try self.checkVerified(result)
+        await self.handleTransaction(transaction)
+        await transaction.finish()
+      } catch {
+        print("[RampKit] Unfinished transaction verification failed: \(error)")
+      }
+    }
+  }
+  
+  @available(iOS 15.0, *)
+  private func checkVerified<T>(_ result: VerificationResult<T>) throws -> T {
+    switch result {
+    case .unverified(_, let error):
+      throw error
+    case .verified(let safe):
+      return safe
+    }
+  }
+  
+  @available(iOS 15.0, *)
+  private func handleTransaction(_ transaction: Transaction) async {
+    guard let appId = self.appId, let userId = self.userId else { return }
+    
+    // Determine event type based on transaction
+    let eventName: String
+    var properties: [String: Any] = [:]
+    
+    switch transaction.revocationReason {
+    case .some(let reason):
+      eventName = "purchase_refunded"
+      properties["revocationReason"] = reason == .developerIssue ? "developer_issue" : "other"
+    case .none:
+      if transaction.isUpgraded {
+        eventName = "subscription_upgraded"
+      } else {
+        switch transaction.productType {
+        case .autoRenewable:
+          if transaction.originalID == transaction.id {
+            eventName = "purchase_completed"
+          } else {
+            eventName = "subscription_renewed"
+          }
+        case .consumable, .nonConsumable:
+          eventName = "purchase_completed"
+        case .nonRenewable:
+          eventName = "purchase_completed"
+        default:
+          eventName = "purchase_completed"
+        }
+      }
+    }
+    
+    // Build properties
+    properties["productId"] = transaction.productID
+    properties["transactionId"] = String(transaction.id)
+    properties["originalTransactionId"] = String(transaction.originalID)
+    properties["purchaseDate"] = ISO8601DateFormatter().string(from: transaction.purchaseDate)
+    
+    if let expirationDate = transaction.expirationDate {
+      properties["expirationDate"] = ISO8601DateFormatter().string(from: expirationDate)
+    }
+    
+    properties["quantity"] = transaction.purchasedQuantity
+    properties["productType"] = mapProductType(transaction.productType)
+    properties["environment"] = transaction.environment.rawValue
+    
+    if let webOrderLineItemID = transaction.webOrderLineItemID {
+      properties["webOrderLineItemId"] = webOrderLineItemID
+    }
+    
+    // Get price info from product if available
+    if let product = await getProduct(for: transaction.productID) {
+      properties["price"] = product.price
+      properties["currency"] = product.priceFormatStyle.currencyCode
+      properties["localizedPrice"] = product.displayPrice
+      properties["localizedName"] = product.displayName
+    }
+    
+    // Send event to backend
+    await sendPurchaseEvent(
+      appId: appId,
+      userId: userId,
+      eventName: eventName,
+      properties: properties
+    )
+  }
+  
+  @available(iOS 15.0, *)
+  private func getProduct(for productId: String) async -> Product? {
+    do {
+      let products = try await Product.products(for: [productId])
+      return products.first
+    } catch {
+      return nil
+    }
+  }
+  
+  @available(iOS 15.0, *)
+  private func mapProductType(_ type: Product.ProductType) -> String {
+    switch type {
+    case .consumable: return "consumable"
+    case .nonConsumable: return "non_consumable"
+    case .autoRenewable: return "auto_renewable"
+    case .nonRenewable: return "non_renewable"
+    @unknown default: return "unknown"
+    }
+  }
+  
+  private func sendPurchaseEvent(appId: String, userId: String, eventName: String, properties: [String: Any]) async {
+    let event: [String: Any] = [
+      "appId": appId,
+      "appUserId": userId,
+      "eventId": UUID().uuidString.lowercased(),
+      "eventName": eventName,
+      "sessionId": UUID().uuidString.lowercased(),
+      "occurredAt": ISO8601DateFormatter().string(from: Date()),
+      "device": [
+        "platform": isPad() ? "iPadOS" : "iOS",
+        "platformVersion": UIDevice.current.systemVersion,
+        "deviceModel": getDeviceModelIdentifier(),
+        "sdkVersion": "1.0.0",
+        "appVersion": Bundle.main.infoDictionary?["CFBundleShortVersionString"] as? String,
+        "buildNumber": Bundle.main.infoDictionary?["CFBundleVersion"] as? String
+      ],
+      "context": [
+        "locale": Locale.current.identifier,
+        "regionCode": Locale.current.regionCode
+      ],
+      "properties": properties
+    ]
+    
+    guard let url = URL(string: "https://uustlzuvjmochxkxatfx.supabase.co/functions/v1/app-user-events") else { return }
+    
+    var request = URLRequest(url: url)
+    request.httpMethod = "POST"
+    request.setValue("application/json", forHTTPHeaderField: "Content-Type")
+    request.setValue("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InV1c3RsenV2am1vY2h4a3hhdGZ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3MzU1NjQ0NjYsImV4cCI6MjA1MTE0MDQ2Nn0.5cNrph5LHmssNo39UKpULkC9n4OD5n6gsnTEQV-gwQk", forHTTPHeaderField: "apikey")
+    request.setValue("Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InV1c3RsenV2am1vY2h4a3hhdGZ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3MzU1NjQ0NjYsImV4cCI6MjA1MTE0MDQ2Nn0.5cNrph5LHmssNo39UKpULkC9n4OD5n6gsnTEQV-gwQk", forHTTPHeaderField: "Authorization")
+    
+    do {
+      request.httpBody = try JSONSerialization.data(withJSONObject: event)
+      let (_, response) = try await URLSession.shared.data(for: request)
+      if let httpResponse = response as? HTTPURLResponse {
+        print("[RampKit] Purchase event sent: \(eventName) - Status: \(httpResponse.statusCode)")
+      }
+    } catch {
+      print("[RampKit] Failed to send purchase event: \(error)")
+    }
+  }
+  
   // MARK: - Device Helpers
   
   private func getDeviceModelIdentifier() -> String {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "rampkit-expo-dev",
-  "version": "0.0.23",
+  "version": "0.0.25",
   "description": "The Expo SDK for RampKit. Build, test, and personalize app onboardings with instant updates.",
   "main": "build/index.js",
   "types": "build/index.d.ts",