rampkit-expo-dev 0.0.65 → 0.0.67

package/build/RampKitNative.d.ts

@@ -18,6 +18,8 @@ interface RampKitNativeModule {
     getNotificationPermissions(): Promise<NotificationPermissionResult>;
     startTransactionObserver(appId: string): Promise<void>;
     stopTransactionObserver(): Promise<void>;
+    trackPurchaseCompleted(productId: string, transactionId?: string, originalTransactionId?: string): Promise<void>;
+    trackPurchaseFromProduct(productId: string): Promise<void>;
 }
 export interface NativeDeviceInfo {
     appUserId: string;
@@ -162,4 +164,21 @@ export declare const TransactionObserver: {
      * Stop listening for purchase transactions
      */
     stop(): Promise<void>;
+    /**
+     * Manually track a purchase completion
+     * Use this when Superwall/RevenueCat reports a purchase but the automatic
+     * observer doesn't catch it (they finish transactions before we see them)
+     *
+     * @param productId - The product ID (e.g., "com.app.yearly")
+     * @param transactionId - Optional transaction ID if available
+     * @param originalTransactionId - Optional original transaction ID (for renewals)
+     */
+    trackPurchase(productId: string, transactionId?: string, originalTransactionId?: string): Promise<void>;
+    /**
+     * Track a purchase by looking up the product's latest transaction
+     * Use this when you only have the productId (common with Superwall)
+     *
+     * @param productId - The product ID to look up and track
+     */
+    trackPurchaseByProductId(productId: string): Promise<void>;
 };

package/build/RampKitNative.js

@@ -62,6 +62,8 @@ function createFallbackModule() {
         },
         async startTransactionObserver(_appId) { },
         async stopTransactionObserver() { },
+        async trackPurchaseCompleted(_productId, _transactionId, _originalTransactionId) { },
+        async trackPurchaseFromProduct(_productId) { },
     };
 }
 function generateFallbackUserId() {
@@ -285,4 +287,39 @@ exports.TransactionObserver = {
             console.warn("[RampKit] Failed to stop transaction observer:", e);
         }
     },
+    /**
+     * Manually track a purchase completion
+     * Use this when Superwall/RevenueCat reports a purchase but the automatic
+     * observer doesn't catch it (they finish transactions before we see them)
+     *
+     * @param productId - The product ID (e.g., "com.app.yearly")
+     * @param transactionId - Optional transaction ID if available
+     * @param originalTransactionId - Optional original transaction ID (for renewals)
+     */
+    async trackPurchase(productId, transactionId, originalTransactionId) {
+        try {
+            console.log("[RampKit] Manually tracking purchase:", productId);
+            await RampKitNativeModule.trackPurchaseCompleted(productId, transactionId, originalTransactionId);
+            console.log("[RampKit] Purchase tracked successfully:", productId);
+        }
+        catch (e) {
+            console.warn("[RampKit] Failed to track purchase:", e);
+        }
+    },
+    /**
+     * Track a purchase by looking up the product's latest transaction
+     * Use this when you only have the productId (common with Superwall)
+     *
+     * @param productId - The product ID to look up and track
+     */
+    async trackPurchaseByProductId(productId) {
+        try {
+            console.log("[RampKit] Looking up and tracking purchase for:", productId);
+            await RampKitNativeModule.trackPurchaseFromProduct(productId);
+            console.log("[RampKit] Purchase lookup and tracking complete:", productId);
+        }
+        catch (e) {
+            console.warn("[RampKit] Failed to track purchase by product:", e);
+        }
+    },
 };

package/ios/RampKitModule.swift

@@ -9,14 +9,23 @@ public class RampKitModule: Module {
   private let installDateKey = "rk_install_date"
   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?
-  
+
+  // Queue for transactions received before SDK is configured
+  private var pendingTransactions: [Any] = []
+  private var isConfigured = false
+
   public func definition() -> ModuleDefinition {
     Name("RampKit")
+
+    // Start transaction observer immediately when module loads
+    OnCreate {
+      self.startTransactionObserverEarly()
+    }
     
     // ============================================================================
     // Device Info
@@ -89,14 +98,30 @@ public class RampKitModule: Module {
     // ============================================================================
     // Transaction Observer (StoreKit 2)
     // ============================================================================
-    
+
     AsyncFunction("startTransactionObserver") { (appId: String) in
       self.startTransactionObserver(appId: appId)
     }
-    
+
     AsyncFunction("stopTransactionObserver") { () in
       self.stopTransactionObserver()
     }
+
+    // ============================================================================
+    // Manual Purchase Tracking (Fallback for Superwall/RevenueCat)
+    // ============================================================================
+
+    AsyncFunction("trackPurchaseCompleted") { (productId: String, transactionId: String?, originalTransactionId: String?) in
+      await self.trackPurchaseCompletedManually(
+        productId: productId,
+        transactionId: transactionId,
+        originalTransactionId: originalTransactionId
+      )
+    }
+
+    AsyncFunction("trackPurchaseFromProduct") { (productId: String) in
+      await self.trackPurchaseFromProductId(productId: productId)
+    }
   }
   
   // MARK: - Device Info Collection
@@ -386,61 +411,136 @@ public class RampKitModule: Module {
   }
   
   // MARK: - StoreKit 2 Transaction Observer
-  
+
+  /// Called on module init - starts listening BEFORE JavaScript configures us
+  private func startTransactionObserverEarly() {
+    // Get userId early so we have it ready
+    self.userId = getOrCreateUserId()
+
+    guard #available(iOS 15.0, *) else {
+      print("[RampKit] ⚠️ Transaction observer requires iOS 15+")
+      return
+    }
+
+    // Don't restart if already running
+    guard transactionObserverTask == nil else {
+      print("[RampKit] Transaction observer already running")
+      return
+    }
+
+    print("[RampKit] 🚀 Starting transaction observer early (module init)...")
+
+    transactionObserverTask = Task {
+      print("[RampKit] 👂 Transaction.updates loop starting...")
+      for await result in Transaction.updates {
+        print("[RampKit] 🎉 RECEIVED TRANSACTION UPDATE!")
+        await self.handleTransactionUpdate(result)
+      }
+      print("[RampKit] ⚠️ Transaction.updates loop exited (unexpected)")
+    }
+
+    // Also check unfinished transactions
+    Task {
+      await self.handleUnfinishedTransactions()
+    }
+  }
+
+  /// Called from JavaScript - sets appId and processes any pending transactions
   private func startTransactionObserver(appId: String) {
     self.appId = appId
     self.userId = getOrCreateUserId()
-    
-    // Cancel existing observer if any
-    transactionObserverTask?.cancel()
-    
-    // Start listening for transactions (iOS 15+)
+    self.isConfigured = true
+
+    print("[RampKit] ✅ Transaction observer configured with appId: \(appId)")
+
+    // Process any transactions that arrived before we were configured
     if #available(iOS 15.0, *) {
-      transactionObserverTask = Task {
-        await self.listenForTransactions()
+      Task {
+        await self.processPendingTransactions()
       }
-      
-      // Also check for any unfinished transactions
+
+      // Debug: check current entitlements
       Task {
-        await self.handleUnfinishedTransactions()
+        await self.debugCurrentEntitlements()
       }
     }
-    
-    print("[RampKit] Transaction observer started")
+
+    // Ensure observer is running (in case OnCreate didn't fire)
+    if transactionObserverTask == nil {
+      startTransactionObserverEarly()
+    }
   }
-  
-  private func stopTransactionObserver() {
-    transactionObserverTask?.cancel()
-    transactionObserverTask = nil
-    print("[RampKit] Transaction observer stopped")
+
+  @available(iOS 15.0, *)
+  private func handleTransactionUpdate(_ result: VerificationResult<Transaction>) async {
+    do {
+      let transaction = try self.checkVerified(result)
+      print("[RampKit] ✅ Transaction verified: \(transaction.productID)")
+
+      if self.isConfigured, let _ = self.appId {
+        // We're configured, process immediately
+        await self.handleTransaction(transaction)
+      } else {
+        // Not configured yet, queue it
+        print("[RampKit] 📦 Queueing transaction (SDK not configured yet): \(transaction.productID)")
+        self.pendingTransactions.append(transaction)
+      }
+
+      // Always finish the transaction
+      await transaction.finish()
+      print("[RampKit] 🏁 Transaction finished: \(transaction.productID)")
+    } catch {
+      print("[RampKit] ❌ Transaction verification failed: \(error)")
+    }
   }
-  
+
   @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)
+  private func processPendingTransactions() async {
+    guard !pendingTransactions.isEmpty else { return }
+
+    print("[RampKit] 📤 Processing \(pendingTransactions.count) pending transaction(s)...")
+
+    for item in pendingTransactions {
+      if let transaction = item as? Transaction {
         await self.handleTransaction(transaction)
-        await transaction.finish()
-      } catch {
-        print("[RampKit] Transaction verification failed: \(error)")
       }
     }
+
+    pendingTransactions.removeAll()
+    print("[RampKit] ✅ All pending transactions processed")
   }
-  
+
+  @available(iOS 15.0, *)
+  private func debugCurrentEntitlements() async {
+    print("[RampKit] 🔍 Checking current entitlements...")
+    var count = 0
+    for await result in Transaction.currentEntitlements {
+      if case .verified(let transaction) = result {
+        count += 1
+        print("[RampKit] 📦 Current entitlement: \(transaction.productID), originalID: \(transaction.originalID), id: \(transaction.id)")
+      }
+    }
+    print("[RampKit] 🔍 Found \(count) current entitlements")
+  }
+
+  private func stopTransactionObserver() {
+    transactionObserverTask?.cancel()
+    transactionObserverTask = nil
+    isConfigured = false
+    pendingTransactions.removeAll()
+    print("[RampKit] Transaction observer stopped")
+  }
+
   @available(iOS 15.0, *)
   private func handleUnfinishedTransactions() async {
-    // Handle any transactions that weren't finished
+    print("[RampKit] 🔍 Checking for unfinished transactions...")
+    var count = 0
     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)")
-      }
+      count += 1
+      print("[RampKit] 📦 Found unfinished transaction #\(count)")
+      await self.handleTransactionUpdate(result)
     }
+    print("[RampKit] 🔍 Finished checking unfinished transactions. Found: \(count)")
   }
   
   @available(iOS 15.0, *)
@@ -457,36 +557,38 @@ public class RampKitModule: Module {
   
   @available(iOS 15.0, *)
   private func handleTransaction(_ transaction: Transaction) async {
-    guard let appId = self.appId, let userId = self.userId else { return }
+    print("[RampKit] 🔄 handleTransaction called for: \(transaction.productID)")
+    print("[RampKit]    - id: \(transaction.id)")
+    print("[RampKit]    - originalID: \(transaction.originalID)")
+    print("[RampKit]    - purchaseDate: \(transaction.purchaseDate)")
+
+    guard let appId = self.appId, let userId = self.userId else {
+      print("[RampKit] ❌ handleTransaction failed: appId=\(self.appId ?? "nil"), userId=\(self.userId ?? "nil")")
+      return
+    }
 
     let formatter = ISO8601DateFormatter()
     formatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
 
-    // Determine event type based on transaction (matching iOS SDK logic)
-    let eventName: String
-    var properties: [String: Any] = [:]
+    // Skip renewals - backend gets these from App Store Server-to-Server notifications
+    if transaction.originalID != transaction.id {
+      print("[RampKit] ⏭️ Transaction skipped (renewal): \(transaction.productID)")
+      return
+    }
 
-    // Check revocation first (subscription_canceled)
+    // Skip revocations/cancellations - backend gets these from S2S notifications
     if transaction.revocationDate != nil {
-      eventName = "subscription_canceled"
-      if let reason = transaction.revocationReason {
-        properties["revocationReason"] = reason == .developerIssue ? "developerIssue" : "other"
-      }
-      properties["revocationDate"] = transaction.revocationDate.map { formatter.string(from: $0) }
-    }
-    // Check if this is a renewal (originalID != id)
-    else if transaction.originalID != transaction.id {
-      eventName = "subscription_renewed"
-    }
-    // Check if it's a trial or intro offer
-    else if let offerType = transaction.offerType, offerType == .introductory {
-      eventName = "trial_started"
-    }
-    // Default to purchase_completed
-    else {
-      eventName = "purchase_completed"
+      print("[RampKit] ⏭️ Transaction skipped (revoked): \(transaction.productID)")
+      return
     }
 
+    print("[RampKit] ✅ Transaction is a new purchase, will send event")
+
+    // All new purchases (including trials) are tracked as purchase_completed
+    // The isTrial and offerType properties indicate trial status
+    let eventName = "purchase_completed"
+    var properties: [String: Any] = [:]
+
     // Build properties (matching iOS SDK PurchaseEventDetails)
     properties["productId"] = transaction.productID
     properties["transactionId"] = String(transaction.id)
@@ -631,8 +733,8 @@ public class RampKitModule: Module {
     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")
+    request.setValue("eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InV1c3RsenV2am1vY2h4a3hhdGZ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjIxMDM2NTUsImV4cCI6MjA3NzY3OTY1NX0.d5XsIMGnia4n9Pou0IidipyyEfSlwpXFoeDBufMOEwE", forHTTPHeaderField: "apikey")
+    request.setValue("Bearer eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJzdXBhYmFzZSIsInJlZiI6InV1c3RsenV2am1vY2h4a3hhdGZ4Iiwicm9sZSI6ImFub24iLCJpYXQiOjE3NjIxMDM2NTUsImV4cCI6MjA3NzY3OTY1NX0.d5XsIMGnia4n9Pou0IidipyyEfSlwpXFoeDBufMOEwE", forHTTPHeaderField: "Authorization")
     
     do {
       request.httpBody = try JSONSerialization.data(withJSONObject: event)
@@ -644,7 +746,104 @@ public class RampKitModule: Module {
       print("[RampKit] Failed to send purchase event: \(error)")
     }
   }
-  
+
+  // MARK: - Manual Purchase Tracking (Fallback for Superwall/RevenueCat)
+
+  /// Track a purchase manually when you have the transaction IDs
+  /// Use this when Superwall or RevenueCat provides the transaction info
+  @available(iOS 15.0, *)
+  private func trackPurchaseCompletedManually(
+    productId: String,
+    transactionId: String?,
+    originalTransactionId: String?
+  ) async {
+    print("[RampKit] 📲 Manual purchase tracking called for: \(productId)")
+
+    guard let appId = self.appId, let userId = self.userId else {
+      print("[RampKit] ❌ Manual tracking failed: SDK not initialized (appId or userId missing)")
+      return
+    }
+
+    let formatter = ISO8601DateFormatter()
+    formatter.formatOptions = [.withInternetDateTime, .withFractionalSeconds]
+
+    var properties: [String: Any] = [
+      "productId": productId,
+      "purchaseDate": formatter.string(from: Date()),
+      "source": "manual" // Mark as manually tracked
+    ]
+
+    // Add transaction IDs if available
+    if let transactionId = transactionId {
+      properties["transactionId"] = transactionId
+    }
+    if let originalTransactionId = originalTransactionId {
+      properties["originalTransactionId"] = originalTransactionId
+    } else if let transactionId = transactionId {
+      // Use transactionId as originalTransactionId if not provided (first purchase)
+      properties["originalTransactionId"] = transactionId
+    }
+
+    // Try to get product info from StoreKit
+    if let product = await getProduct(for: productId) {
+      properties["amount"] = product.price
+      properties["currency"] = product.priceFormatStyle.currencyCode
+      properties["priceFormatted"] = product.displayPrice
+      properties["productType"] = mapProductType(product.type)
+
+      if let subscription = product.subscription {
+        properties["subscriptionPeriod"] = formatSubscriptionPeriod(subscription.subscriptionPeriod)
+        properties["subscriptionGroupId"] = subscription.subscriptionGroupID
+      }
+    }
+
+    // Get storefront
+    if let storefront = await Storefront.current {
+      properties["storefront"] = storefront.countryCode
+    }
+
+    print("[RampKit] 📤 Sending manual purchase_completed event...")
+    await sendPurchaseEvent(
+      appId: appId,
+      userId: userId,
+      eventName: "purchase_completed",
+      properties: properties
+    )
+  }
+
+  /// Track a purchase by looking up the latest transaction for a product
+  /// Use this when you only know the productId (Superwall doesn't always provide transaction IDs)
+  @available(iOS 15.0, *)
+  private func trackPurchaseFromProductId(productId: String) async {
+    print("[RampKit] 🔍 Looking up transaction for product: \(productId)")
+
+    // Try to find the latest transaction for this product
+    var latestTransaction: Transaction?
+
+    for await result in Transaction.currentEntitlements {
+      if case .verified(let transaction) = result {
+        if transaction.productID == productId {
+          if latestTransaction == nil || transaction.purchaseDate > latestTransaction!.purchaseDate {
+            latestTransaction = transaction
+          }
+        }
+      }
+    }
+
+    if let transaction = latestTransaction {
+      print("[RampKit] ✅ Found transaction for product: \(productId)")
+      await handleTransaction(transaction)
+    } else {
+      print("[RampKit] ⚠️ No transaction found for product, tracking manually: \(productId)")
+      // Fall back to manual tracking without transaction IDs
+      await trackPurchaseCompletedManually(
+        productId: productId,
+        transactionId: nil,
+        originalTransactionId: nil
+      )
+    }
+  }
+
   // MARK: - Device Helpers
   
   private func getDeviceModelIdentifier() -> String {

package/package.json

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