@attentive-mobile/attentive-react-native-sdk 1.0.5 → 2.0.0-beta.1

package/ios/Bridging/ATTNNativeSDK.swift

@@ -9,6 +9,7 @@
 import Foundation
 import attentive_ios_sdk
 import UIKit
+import UserNotifications
 
 // Debug Event structure for session history
 struct DebugEvent {
@@ -23,7 +24,7 @@ struct DebugEvent {
     self.eventType = eventType
     self.data = data
   }
-  
+
   /**
    * Formats the debug event as a human-readable string for export
    * @return A formatted string containing timestamp, event type, and data
@@ -32,17 +33,17 @@ struct DebugEvent {
     let formatter = DateFormatter()
     formatter.dateFormat = "yyyy-MM-dd HH:mm:ss.SSS"
     let timeString = formatter.string(from: timestamp)
-    
+
     var output = "[\(timeString)] \(eventType)\n"
-    
+
     // Add summary information if available
     let summary = getSummary()
     if !summary.isEmpty {
       output += "Summary: \(summary)\n"
     }
-    
+
     output += "Data:\n"
-    
+
     // Format data as JSON for better readability
     do {
       let jsonData = try JSONSerialization.data(withJSONObject: data, options: .prettyPrinted)
@@ -54,17 +55,17 @@ struct DebugEvent {
     } catch {
       output += "\(data)"
     }
-    
+
     return output + "\n" + String(repeating: "=", count: 50) + "\n"
   }
-  
+
   /**
    * Generates a summary of the debug event for quick overview
    * @return A brief summary string highlighting key information
    */
   private func getSummary() -> String {
     var summaryParts: [String] = []
-    
+
     if let itemsCount = data["items_count"] as? String {
       summaryParts.append("Items: \(itemsCount)")
     }
@@ -77,10 +78,10 @@ struct DebugEvent {
     if let eventType = data["event_type"] as? String {
       summaryParts.append("Type: \(eventType)")
     }
-    
+
     // Always show payload size info
     summaryParts.append("Payload: \(data.count) fields")
-    
+
     return summaryParts.joined(separator: " • ")
   }
 }
@@ -94,17 +95,16 @@ struct DebugEvent {
   @objc(initWithDomain:mode:skipFatigueOnCreatives:enableDebugger:)
   public init(domain: String, mode: String, skipFatigueOnCreatives: Bool, enableDebugger: Bool) {
     self.sdk = ATTNSDK(domain: domain, mode: ATTNSDKMode(rawValue: mode) ?? .production)
-    self.sdk.skipFatigueOnCreative = skipFatigueOnCreatives ?? false
-    
+    self.sdk.skipFatigueOnCreative = skipFatigueOnCreatives
+
     // Only enable debugging if both enableDebugger is true AND the app is running in debug mode
-    let enableDebuggerFromConfig = enableDebugger ?? false
     #if DEBUG
     let isDebugBuild = true
     #else
     let isDebugBuild = false
     #endif
-    self.debuggingEnabled = enableDebuggerFromConfig && isDebugBuild
-    
+    self.debuggingEnabled = enableDebugger && isDebugBuild
+
     ATTNEventTracker.setup(with: sdk)
   }
 
@@ -131,7 +131,14 @@ struct DebugEvent {
 
   @objc(identify:)
   public func identify(_ identifiers: [String: Any]) {
+    print("👤 [AttentiveSDK] identify called from React Native")
+    print("   Identifiers: \(identifiers)")
+
     sdk.identify(identifiers)
+
+    print("✅ [AttentiveSDK] identify completed")
+    print("   User is now identified with the SDK")
+    print("   SDK can now make network calls")
   }
 
   @objc
@@ -139,6 +146,346 @@ struct DebugEvent {
     sdk.clearUser()
   }
 
+  // MARK: - Push Notification Methods
+
+  /**
+   * Request push notification permission from the user.
+   * This will trigger the iOS permission dialog.
+   */
+  @objc
+  public func registerForPushNotifications() {
+    sdk.registerForPushNotifications()
+    if debuggingEnabled {
+      showDebugInfo(event: "Push Registration Requested", data: ["action": "registerForPushNotifications"])
+    }
+  }
+
+  /**
+   * Register the device token received from APNs with the Attentive backend.
+   * @param token The hex-encoded device token string
+   * @param authorizationStatus Current push authorization status string
+   */
+  @objc(registerDeviceToken:authorizationStatus:)
+  public func registerDeviceToken(_ token: String, authorizationStatus: String) {
+    // Convert hex string back to Data
+    guard let tokenData = hexStringToData(token) else {
+      print("[AttentiveSDK] Invalid device token format")
+      return
+    }
+
+    // Map string to UNAuthorizationStatus
+    let status = mapAuthorizationStatus(authorizationStatus)
+
+    sdk.registerDeviceToken(tokenData, authorizationStatus: status)
+
+    if debuggingEnabled {
+      showDebugInfo(event: "Device Token Registered", data: [
+        "token": String(token.prefix(16)) + "...",
+        "authorizationStatus": authorizationStatus
+      ])
+    }
+  }
+
+  /**
+   * Register the device token with callback for use in AppDelegate.
+   * This method is intended to be called directly from the host app's AppDelegate,
+   * not from React Native JavaScript.
+   *
+   * @param token The device token Data from APNs
+   * @param authorizationStatus Current push authorization status
+   * @param callback Completion handler called after registration attempt
+   */
+  @objc(registerDeviceTokenWithCallback:authorizationStatus:callback:)
+  public func registerDeviceToken(
+    _ token: Data,
+    authorizationStatus: UNAuthorizationStatus,
+    callback: @escaping (_ data: Data?, _ url: URL?, _ response: URLResponse?, _ error: Error?) -> Void
+  ) {
+    sdk.registerDeviceToken(token, authorizationStatus: authorizationStatus, callback: callback)
+
+    if debuggingEnabled {
+      let tokenString = token.map { String(format: "%02.2hhx", $0) }.joined()
+      showDebugInfo(event: "Device Token Registered (with callback)", data: [
+        "token": String(tokenString.prefix(16)) + "...",
+        "authorizationStatus": authorizationStatusToString(authorizationStatus)
+      ])
+    }
+  }
+
+  /**
+   * Handle a regular/direct app open event.
+   * This should be called after device token registration completes (success or failure).
+   *
+   * This is the TypeScript equivalent of the native iOS AppDelegate method:
+   * ```swift
+   * func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
+   *   UNUserNotificationCenter.current().getNotificationSettings { [weak self] settings in
+   *     guard let self = self else { return }
+   *     let authStatus = settings.authorizationStatus
+   *     attentiveSdk?.registerDeviceToken(deviceToken, authorizationStatus: authStatus, callback: { data, url, response, error in
+   *       DispatchQueue.main.async {
+   *         self.attentiveSdk?.handleRegularOpen(authorizationStatus: authStatus)
+   *       }
+   *     })
+   *   }
+   * }
+   * ```
+   *
+   * @param authorizationStatus Current push authorization status
+   */
+  @objc(handleRegularOpen:)
+  public func handleRegularOpen(authorizationStatus: UNAuthorizationStatus) {
+    print("🌉 [AttentiveSDK] handleRegularOpen called from React Native")
+    print("   Authorization Status: \(authorizationStatusToString(authorizationStatus))")
+    print("   Calling underlying iOS SDK handleRegularOpen...")
+
+    // Call the underlying Attentive iOS SDK
+    sdk.handleRegularOpen(authorizationStatus: authorizationStatus)
+
+    print("✅ [AttentiveSDK] handleRegularOpen completed")
+    print("   This should trigger a network call to: https://mobile.attentivemobile.com/mtctrl")
+    print("   If you don't see the network call:")
+    print("   1. Check that user is identified (call identify() before handleRegularOpen)")
+    print("   2. Check your proxy debugger is configured for mobile.attentivemobile.com")
+    print("   3. Verify SSL proxying is enabled")
+    print("   4. Check device has internet connection")
+
+    if debuggingEnabled {
+      showDebugInfo(event: "Regular Open Event", data: [
+        "authorizationStatus": authorizationStatusToString(authorizationStatus),
+        "expectedEndpoint": "https://mobile.attentivemobile.com/mtctrl",
+        "note": "Check network logs to verify endpoint was called"
+      ])
+    }
+  }
+
+
+  /**
+   * Handle when a push notification is opened by the user.
+   * Note: SDK 2.0.8 changed the API to require UNNotificationResponse instead of userInfo dictionary.
+   * This method is kept for backward compatibility but has limited functionality.
+   * For full functionality, handle push notifications natively in AppDelegate.
+   *
+   * @param userInfo The notification payload
+   * @param applicationState The app state when notification was opened
+   * @param authorizationStatus Current push authorization status
+   */
+  @objc(handlePushOpened:applicationState:authorizationStatus:)
+  public func handlePushOpened(_ userInfo: [String: Any], applicationState: String, authorizationStatus: String) {
+    // Note: SDK 2.0.8 changed the API to require UNNotificationResponse
+    // Since React Native doesn't provide direct access to UNNotificationResponse,
+    // apps should handle push notifications natively in AppDelegate for full functionality
+    print("[AttentiveSDK] Warning: Push notification handling from React Native is limited in SDK 2.0.8")
+    print("[AttentiveSDK] The native SDK now requires UNNotificationResponse for push tracking")
+    print("[AttentiveSDK] Please implement push handling in AppDelegate for full functionality")
+
+    if debuggingEnabled {
+      showDebugInfo(event: "Push Opened (Limited)", data: [
+        "applicationState": applicationState,
+        "authorizationStatus": authorizationStatus,
+        "userInfo": userInfo,
+        "warning": "SDK 2.0.8 requires native UNNotificationResponse handling in AppDelegate"
+      ])
+    }
+  }
+
+  /**
+   * Handle when a push notification arrives while the app is in foreground.
+   * @param userInfo The notification payload
+   */
+  @objc(handleForegroundNotification:)
+  public func handleForegroundNotification(_ userInfo: [String: Any]) {
+    // Note: SDK 2.0.8 changed the API to require UNNotificationResponse
+    // Since React Native doesn't provide this, we'll log a warning
+    print("[AttentiveSDK] Warning: Foreground notification handling from React Native is limited in SDK 2.0.8")
+    print("[AttentiveSDK] Please handle foreground notifications natively in AppDelegate for full functionality")
+
+    if debuggingEnabled {
+      showDebugInfo(event: "Foreground Notification", data: [
+        "userInfo": userInfo,
+        "warning": "SDK 2.0.8 requires native UNNotificationResponse handling"
+      ])
+    }
+  }
+
+  /**
+   * Handle a push notification when the app is in the foreground (active state).
+   * This is the native equivalent that should be called from AppDelegate when the app is active.
+   *
+   * Equivalent to Swift AppDelegate code:
+   * ```swift
+   * case .active:
+   *   self.attentiveSdk?.handleForegroundPush(response: response, authorizationStatus: authStatus)
+   * ```
+   *
+   * @param response The UNNotificationResponse from the notification center delegate
+   * @param authorizationStatus Current push authorization status
+   */
+  @objc(handleForegroundPush:authorizationStatus:)
+  public func handleForegroundPush(response: UNNotificationResponse, authorizationStatus: UNAuthorizationStatus) {
+    sdk.handleForegroundPush(response: response, authorizationStatus: authorizationStatus)
+
+    if debuggingEnabled {
+      let userInfo = response.notification.request.content.userInfo
+      showDebugInfo(event: "Foreground Push", data: [
+        "authorizationStatus": authorizationStatusToString(authorizationStatus),
+        "userInfo": userInfo as? [String: Any] ?? [:],
+        "actionIdentifier": response.actionIdentifier
+      ])
+    }
+  }
+
+  /**
+   * Handle when a push notification is opened by the user (app in background/inactive state).
+   * This is the native equivalent that should be called from AppDelegate when the app is background or inactive.
+   *
+   * Equivalent to Swift AppDelegate code:
+   * ```swift
+   * case .background, .inactive:
+   *   self.attentiveSdk?.handlePushOpen(response: response, authorizationStatus: authStatus)
+   * ```
+   *
+   * @param response The UNNotificationResponse from the notification center delegate
+   * @param authorizationStatus Current push authorization status
+   */
+  @objc(handlePushOpen:authorizationStatus:)
+  public func handlePushOpen(response: UNNotificationResponse, authorizationStatus: UNAuthorizationStatus) {
+    sdk.handlePushOpen(response: response, authorizationStatus: authorizationStatus)
+
+    if debuggingEnabled {
+      let userInfo = response.notification.request.content.userInfo
+      showDebugInfo(event: "Push Open", data: [
+        "authorizationStatus": authorizationStatusToString(authorizationStatus),
+        "userInfo": userInfo as? [String: Any] ?? [:],
+        "actionIdentifier": response.actionIdentifier
+      ])
+    }
+  }
+
+  /**
+   * Handle a push notification when the app is in the foreground (active state) - React Native version.
+   * This method accepts userInfo dictionary instead of UNNotificationResponse, making it callable from React Native.
+   *
+   * Note: This is a limited version since we don't have access to the full UNNotificationResponse.
+   * For full functionality, use the native AppDelegate implementation.
+   *
+   * @param userInfo The notification payload dictionary
+   * @param authorizationStatus Current push authorization status string
+   */
+  @objc(handleForegroundPushFromRN:authorizationStatus:)
+  public func handleForegroundPushFromRN(_ userInfo: [String: Any], authorizationStatus: String) {
+    _ = mapAuthorizationStatus(authorizationStatus)
+
+    // Note: SDK 2.0.8 requires UNNotificationResponse, but we only have userInfo from React Native
+    // This is a workaround that logs the limitation
+    print("[AttentiveSDK] handleForegroundPush called from React Native (limited functionality)")
+    print("[AttentiveSDK] For full functionality, implement in native AppDelegate")
+
+    if debuggingEnabled {
+      showDebugInfo(event: "Foreground Push (React Native)", data: [
+        "authorizationStatus": authorizationStatus,
+        "userInfo": userInfo,
+        "note": "Limited functionality - UNNotificationResponse not available from React Native"
+      ])
+    }
+  }
+
+  /**
+   * Handle when a push notification is opened by the user (app in background/inactive state) - React Native version.
+   * This method accepts userInfo dictionary instead of UNNotificationResponse, making it callable from React Native.
+   *
+   * Note: This is a limited version since we don't have access to the full UNNotificationResponse.
+   * For full functionality, use the native AppDelegate implementation.
+   *
+   * @param userInfo The notification payload dictionary
+   * @param authorizationStatus Current push authorization status string
+   */
+  @objc(handlePushOpenFromRN:authorizationStatus:)
+  public func handlePushOpenFromRN(_ userInfo: [String: Any], authorizationStatus: String) {
+    _ = mapAuthorizationStatus(authorizationStatus)
+
+    // Note: SDK 2.0.8 requires UNNotificationResponse, but we only have userInfo from React Native
+    // This is a workaround that logs the limitation
+    print("[AttentiveSDK] handlePushOpen called from React Native (limited functionality)")
+    print("[AttentiveSDK] For full functionality, implement in native AppDelegate")
+
+    if debuggingEnabled {
+      showDebugInfo(event: "Push Open (React Native)", data: [
+        "authorizationStatus": authorizationStatus,
+        "userInfo": userInfo,
+        "note": "Limited functionality - UNNotificationResponse not available from React Native"
+      ])
+    }
+  }
+
+  // MARK: - Push Notification Helpers
+
+  private func hexStringToData(_ hexString: String) -> Data? {
+    var data = Data()
+    var hex = hexString
+
+    // Remove any non-hex characters
+    hex = hex.replacingOccurrences(of: " ", with: "")
+    hex = hex.replacingOccurrences(of: "<", with: "")
+    hex = hex.replacingOccurrences(of: ">", with: "")
+
+    var index = hex.startIndex
+    while index < hex.endIndex {
+      let nextIndex = hex.index(index, offsetBy: 2, limitedBy: hex.endIndex) ?? hex.endIndex
+      if nextIndex > hex.endIndex { break }
+
+      let byteString = String(hex[index..<nextIndex])
+      if let byte = UInt8(byteString, radix: 16) {
+        data.append(byte)
+      } else {
+        return nil
+      }
+      index = nextIndex
+    }
+
+    return data.isEmpty ? nil : data
+  }
+
+  private func mapAuthorizationStatus(_ status: String) -> UNAuthorizationStatus {
+    switch status.lowercased() {
+    case "authorized":
+      return .authorized
+    case "denied":
+      return .denied
+    case "notdetermined":
+      return .notDetermined
+    case "provisional":
+      return .provisional
+    case "ephemeral":
+      if #available(iOS 14.0, *) {
+        return .ephemeral
+      }
+      return .authorized
+    default:
+      return .notDetermined
+    }
+  }
+
+  private func authorizationStatusToString(_ status: UNAuthorizationStatus) -> String {
+    switch status {
+    case .authorized:
+      return "authorized"
+    case .denied:
+      return "denied"
+    case .notDetermined:
+      return "notDetermined"
+    case .provisional:
+      return "provisional"
+    case .ephemeral:
+      if #available(iOS 14.0, *) {
+        return "ephemeral"
+      }
+      return "authorized"
+    @unknown default:
+      return "notDetermined"
+    }
+  }
+
   @objc
   public func invokeAttentiveDebugHelper() {
     if debuggingEnabled {
@@ -157,7 +504,7 @@ struct DebugEvent {
       }
     }
   }
-  
+
 }
 
 public extension ATTNNativeSDK {
@@ -170,36 +517,36 @@ public extension ATTNNativeSDK {
     guard debuggingEnabled else {
       return "Debug logging is not enabled. Please enable debugging to export logs."
     }
-    
+
     if debugHistory.isEmpty {
       return "No debug events recorded in this session."
     }
-    
+
     let formatter = DateFormatter()
     formatter.dateFormat = "yyyy-MM-dd HH:mm:ss"
     let exportDate = formatter.string(from: Date())
-    
+
     var exportContent = """
     Attentive React Native SDK - Debug Session Export
     Generated: \(exportDate)
     Total Events: \(debugHistory.count)
-    
+
     \(String(repeating: "=", count: 60))
-    
+
     """
-    
+
     // Add all events in chronological order (oldest first for better readability)
     for (index, event) in debugHistory.enumerated() {
       exportContent += "Event #\(index + 1)\n"
       exportContent += event.formatForExport()
       exportContent += "\n"
     }
-    
+
     exportContent += """
     \(String(repeating: "=", count: 60))
     End of Debug Session Export
     """
-    
+
     return exportContent
   }
 
@@ -380,7 +727,7 @@ class DebugOverlayViewController: UIViewController {
     shareButton.addTarget(self, action: #selector(shareButtonTapped), for: .touchUpInside)
     shareButton.translatesAutoresizingMaskIntoConstraints = false
     containerView.addSubview(shareButton)
-    
+
     // X Close button in top-right corner
     let closeButton = UIButton(type: .system)
     closeButton.setTitle("✕", for: .normal)
@@ -538,10 +885,10 @@ class DebugOverlayViewController: UIViewController {
   @objc private func shareButtonTapped() {
     // Generate export content for the current history
     let exportContent = generateExportContent()
-    
+
     // Create activity view controller for sharing
     let activityVC = UIActivityViewController(activityItems: [exportContent], applicationActivities: nil)
-    
+
     // For iPad - prevent crash by setting popover presentation controller
     if let popover = activityVC.popoverPresentationController {
       // Find the share button view to anchor the popover
@@ -553,10 +900,10 @@ class DebugOverlayViewController: UIViewController {
         popover.sourceRect = CGRect(x: view.bounds.midX, y: view.bounds.midY, width: 0, height: 0)
       }
     }
-    
+
     present(activityVC, animated: true)
   }
-  
+
   /**
    * Generates formatted export content for sharing
    * @return Formatted string containing all debug events
@@ -565,32 +912,32 @@ class DebugOverlayViewController: UIViewController {
     if history.isEmpty {
       return "No debug events recorded in this session."
     }
-    
+
     let formatter = DateFormatter()
     formatter.dateFormat = "yyyy-MM-dd HH:mm:ss"
     let exportDate = formatter.string(from: Date())
-    
+
     var exportContent = """
     Attentive React Native SDK - Debug Session Export
     Generated: \(exportDate)
     Total Events: \(history.count)
-    
+
     \(String(repeating: "=", count: 60))
-    
+
     """
-    
+
     // Add all events in chronological order (oldest first for better readability)
     for (index, event) in history.enumerated() {
       exportContent += "Event #\(index + 1)\n"
       exportContent += event.formatForExport()
       exportContent += "\n"
     }
-    
+
     exportContent += """
     \(String(repeating: "=", count: 60))
     End of Debug Session Export
     """
-    
+
     return exportContent
   }
 
@@ -772,7 +1119,7 @@ class EventDetailViewController: UIViewController {
     shareButton.addTarget(self, action: #selector(shareEventButtonTapped), for: .touchUpInside)
     shareButton.translatesAutoresizingMaskIntoConstraints = false
     containerView.addSubview(shareButton)
-    
+
     let closeButton = UIButton(type: .system)
     closeButton.setTitle("✕", for: .normal)
     closeButton.titleLabel?.font = UIFont.systemFont(ofSize: 18, weight: .medium)
@@ -834,19 +1181,19 @@ class EventDetailViewController: UIViewController {
    */
   @objc private func shareEventButtonTapped() {
     let exportContent = generateSingleEventExport()
-    
+
     // Create activity view controller for sharing
     let activityVC = UIActivityViewController(activityItems: [exportContent], applicationActivities: nil)
-    
+
     // For iPad - prevent crash by setting popover presentation controller
     if let popover = activityVC.popoverPresentationController {
       popover.sourceView = view
       popover.sourceRect = CGRect(x: view.bounds.midX, y: view.bounds.midY, width: 0, height: 0)
     }
-    
+
     present(activityVC, animated: true)
   }
-  
+
   /**
    * Generates formatted export content for a single event
    * @return Formatted string containing the single debug event
@@ -855,18 +1202,18 @@ class EventDetailViewController: UIViewController {
     let formatter = DateFormatter()
     formatter.dateFormat = "yyyy-MM-dd HH:mm:ss"
     let exportDate = formatter.string(from: Date())
-    
+
     let eventContent = """
     Attentive React Native SDK - Single Event Export
     Generated: \(exportDate)
-    
+
     \(String(repeating: "=", count: 60))
-    
+
     \(event.formatForExport())
     \(String(repeating: "=", count: 60))
     End of Single Event Export
     """
-    
+
     return eventContent
   }
 

package/ios/Bridging/AttentiveReactNativeSdk-Bridging-Header.h

@@ -5,3 +5,6 @@
 #import <React/RCTBridgeModule.h>
 #import <React/RCTViewManager.h>
 #import <React/RCTLog.h>
+
+// Import UserNotifications for push notification support
+@import UserNotifications;