@loyalytics/swan-react-native-sdk 2.3.1-beta.0 → 2.3.1-beta.2

package/ios/SwanNotificationContentExtension/NotificationViewController.swift

@@ -10,7 +10,12 @@ import UserNotificationsUI
  *   - swan_carousel: Swipeable product carousel
  *   (Future: swan_timer, swan_cta, swan_rating)
  *
- * Action buttons (registered by SDK via Notifee setNotificationCategories):
+ * User interaction:
+ *   - Swipe left/right on the carousel to navigate between items
+ *   - Tap on the carousel image to open the deep link for the current item
+ *   - Deep link uses extensionContext.open(URL) with the deepLinkScheme from the push payload
+ *
+ * Action button identifiers (reserved for future use if categories are registered):
  *   - swan_prev: Navigate to previous carousel item
  *   - swan_next: Navigate to next carousel item
  *   - swan_open: Open deep link for current item
@@ -18,8 +23,9 @@ import UserNotificationsUI
 class NotificationViewController: UIViewController, UNNotificationContentExtension {
 
     private var carouselView: CarouselView?
+    private var currentUserInfo: [AnyHashable: Any] = [:]
 
-    /// Action button identifiers (must match what SDK registers via setNotificationCategories)
+    /// Action button identifiers (reserved for future use if notification categories are registered)
     private enum ActionID {
         static let prev = "swan_prev"
         static let next = "swan_next"
@@ -77,14 +83,22 @@ class NotificationViewController: UIViewController, UNNotificationContentExtensi
             carouselView?.scrollToNext()
             completion(.doNotDismiss)
 
-        case ActionID.open:
-            handleCarouselAction(response: response, userInfo: userInfo)
-            completion(.dismissAndForwardAction)
-
-        case UNNotificationDefaultActionIdentifier:
-            // User tapped the notification body itself
-            handleCarouselAction(response: response, userInfo: userInfo)
-            completion(.dismissAndForwardAction)
+        case ActionID.open, UNNotificationDefaultActionIdentifier:
+            guard let carousel = carouselView else {
+                completion(.dismissAndForwardAction)
+                return
+            }
+            openDeepLink(
+                itemIndex: carousel.currentIndex,
+                itemRoute: carousel.currentItem?.route,
+                userInfo: userInfo
+            ) { opened in
+                if opened {
+                    completion(.dismiss)
+                } else {
+                    completion(.dismissAndForwardAction)
+                }
+            }
 
         default:
             completion(.dismissAndForwardAction)
@@ -115,16 +129,21 @@ class NotificationViewController: UIViewController, UNNotificationContentExtensi
         let mode: CarouselView.CarouselMode = modeString == "auto" ? .auto : .manual
         carousel.configure(with: items, mode: mode, autoScrollInterval: interval / 1000.0)
 
-        // Tap on carousel image/labels saves click data and opens the app
+        self.currentUserInfo = userInfo
+
+        // Tap on carousel image/labels opens the app via deep link URL (CleverTap pattern)
+        // Falls back to App Group + performNotificationDefaultAction if openURL fails
         carousel.onItemTapped = { [weak self] in
             guard let self = self, let cv = self.carouselView else { return }
-            let messageId = userInfo["messageId"] as? String ?? ""
-            self.saveClickData(
-                messageId: messageId,
+            self.openDeepLink(
                 itemIndex: cv.currentIndex,
-                route: cv.currentItem?.route ?? ""
-            )
-            self.extensionContext?.performNotificationDefaultAction()
+                itemRoute: cv.currentItem?.route,
+                userInfo: userInfo
+            ) { opened in
+                if !opened {
+                    self.extensionContext?.performNotificationDefaultAction()
+                }
+            }
         }
 
         self.carouselView = carousel
@@ -135,21 +154,64 @@ class NotificationViewController: UIViewController, UNNotificationContentExtensi
         preferredContentSize = CGSize(width: width, height: width * imageAspectRatio + 80)
     }
 
-    private func handleCarouselAction(response: UNNotificationResponse, userInfo: [AnyHashable: Any]) {
-        guard let carousel = carouselView else { return }
-
+    // MARK: - Deep Link via URL (CleverTap pattern)
+
+    /// Try to open a deep link URL directly from the Content Extension.
+    /// If the push payload includes `deepLinkScheme`, constructs a URL like
+    /// `swanexample://product/123?swan_carousel=1&swan_comm_id=abc` and opens it.
+    /// On failure, falls back to saving click data to App Group.
+    ///
+    /// - Parameters:
+    ///   - itemIndex: Current carousel item index
+    ///   - itemRoute: Route from the tapped carousel item (e.g., "/product/123")
+    ///   - userInfo: Push notification payload
+    ///   - completion: Called with `true` if openURL succeeded, `false` if fell back
+    private func openDeepLink(
+        itemIndex: Int,
+        itemRoute: String?,
+        userInfo: [AnyHashable: Any],
+        completion: @escaping (Bool) -> Void
+    ) {
         let messageId = userInfo["messageId"] as? String ?? ""
-        let currentItem = carousel.currentItem
-
-        // Save click data to App Group for main app to read
-        saveClickData(
-            messageId: messageId,
-            itemIndex: carousel.currentIndex,
-            route: currentItem?.route ?? ""
-        )
+        let route = itemRoute ?? userInfo["defaultRoute"] as? String ?? ""
+
+        // Always save click data first — the async extensionContext.open() completion
+        // uses [weak self], so saveClickData() could be skipped if self is deallocated.
+        // Writing before the async call guarantees the data is persisted.
+        saveClickData(messageId: messageId, itemIndex: itemIndex, route: route)
+
+        // Try openURL if deepLinkScheme is provided
+        if let scheme = userInfo["deepLinkScheme"] as? String, !scheme.isEmpty, !route.isEmpty {
+            // Strip leading "/" from route
+            let path = route.hasPrefix("/") ? String(route.dropFirst()) : route
+
+            // Parse route to preserve any existing query params (e.g., /product/123?ref=push)
+            // Use a dummy scheme to make URLComponents parse it correctly
+            var components = URLComponents(string: "dummy://\(path)") ?? URLComponents()
+            components.scheme = scheme
+
+            // Merge swan_ tracking params with any existing query params from the route
+            var queryItems = components.queryItems ?? []
+            queryItems.append(contentsOf: [
+                URLQueryItem(name: "swan_carousel", value: "1"),
+                URLQueryItem(name: "swan_comm_id", value: messageId),
+                URLQueryItem(name: "swan_item_index", value: "\(itemIndex)"),
+            ])
+            components.queryItems = queryItems
+
+            if let url = components.url {
+                self.extensionContext?.open(url) { success in
+                    completion(success)
+                }
+                return
+            }
+        }
+
+        completion(false)
     }
 
     // MARK: - Click Data Persistence
+    // Tested in SwanSDKTestable/Tests/SwanParsersTests.swift (ClickDataSerializationTests)
 
     private func saveClickData(messageId: String, itemIndex: Int, route: String) {
         let appGroupId = "group.swan.sdk.notifications"

package/ios/SwanNotificationContentExtension/templates/CarouselView.swift

@@ -218,6 +218,7 @@ class CarouselView: UIView {
     }
 
     // MARK: - Parsing
+    // Tested in SwanSDKTestable/Tests/SwanParsersTests.swift (CarouselParsingTests)
 
     static func parseItems(from jsonString: String) -> [CarouselItem] {
         guard let data = jsonString.data(using: .utf8),
@@ -278,6 +279,10 @@ extension CarouselView: UICollectionViewDataSource, UICollectionViewDelegate, UI
         return collectionView.bounds.size
     }
 
+    func collectionView(_ collectionView: UICollectionView, didSelectItemAt indexPath: IndexPath) {
+        onItemTapped?()
+    }
+
     func scrollViewDidEndDecelerating(_ scrollView: UIScrollView) {
         let page = Int(scrollView.contentOffset.x / scrollView.bounds.width)
         if page != currentIndex {

package/ios/SwanNotificationServiceExtension/NotificationService.swift

@@ -164,6 +164,7 @@ class NotificationService: UNNotificationServiceExtension {
     }
 
     // MARK: - Credential Storage
+    // Tested in SwanSDKTestable/Tests/SwanParsersTests.swift (CredentialParsingTests)
 
     private struct SwanCredentials {
         let appId: String

package/lib/commonjs/components/HeaderView.js

@@ -8,7 +8,6 @@ var _reactNative = require("react-native");
 var _MaterialIcons = _interopRequireDefault(require("react-native-vector-icons/MaterialIcons"));
 var _jsxRuntime = require("react/jsx-runtime");
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-// Install with `npm install react-native-vector-icons`
 const {
   width
 } = _reactNative.Dimensions.get('window'); // Screen dimensions for responsive layout

package/lib/commonjs/components/HeaderView.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_MaterialIcons","_interopRequireDefault","_jsxRuntime","e","__esModule","default","width","Dimensions","get","HeaderView","designConfig","onClose","onButtonClick","commId","themeBackgroundColor","crossButtonColor","backgroundImageURL","iconURL","title","titleColor","description","descriptionColor","primaryButtonSwitch","primaryButtonColor","primaryButtonFontColor","primaryButtonText","primaryButtonAction","primaryButtonActionType","secondaryButtonSwitch","secondaryButtonColor","secondaryButtonFontColor","secondaryButtonText","secondaryButtonAction","secondaryButtonActionType","renderButton","type","text","bgColor","fontColor","action","actionType","extraStyle","jsx","TouchableOpacity","style","styles","button","backgroundColor","onPress","event","children","Text","buttonText","color","numberOfLines","jsxs","View","notification","Image","source","uri","background","resizeMode","foreground","content","close","name","size","iconContainer","icon","textContainer","buttonContainer","marginRight","StyleSheet","create","overflow","position","flexDirection","top","left","elevation","shadowColor","shadowOffset","height","shadowOpacity","shadowRadius","zIndex","alignItems","padding","right","borderRadius","marginLeft","flex","fontWeight","fontSize","lineHeight","marginTop","marginHorizontal","marginBottom","justifyContent","_default","exports"],"sourceRoot":"../../../src","sources":["components/HeaderView.tsx"],"mappings":"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","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","_MaterialIcons","_interopRequireDefault","_jsxRuntime","e","__esModule","default","width","Dimensions","get","HeaderView","designConfig","onClose","onButtonClick","commId","themeBackgroundColor","crossButtonColor","backgroundImageURL","iconURL","title","titleColor","description","descriptionColor","primaryButtonSwitch","primaryButtonColor","primaryButtonFontColor","primaryButtonText","primaryButtonAction","primaryButtonActionType","secondaryButtonSwitch","secondaryButtonColor","secondaryButtonFontColor","secondaryButtonText","secondaryButtonAction","secondaryButtonActionType","renderButton","type","text","bgColor","fontColor","action","actionType","extraStyle","jsx","TouchableOpacity","style","styles","button","backgroundColor","onPress","event","children","Text","buttonText","color","numberOfLines","jsxs","View","notification","Image","source","uri","background","resizeMode","foreground","content","close","name","size","iconContainer","icon","textContainer","buttonContainer","marginRight","StyleSheet","create","overflow","position","flexDirection","top","left","elevation","shadowColor","shadowOffset","height","shadowOpacity","shadowRadius","zIndex","alignItems","padding","right","borderRadius","marginLeft","flex","fontWeight","fontSize","lineHeight","marginTop","marginHorizontal","marginBottom","justifyContent","_default","exports"],"sourceRoot":"../../../src","sources":["components/HeaderView.tsx"],"mappings":"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","ignoreList":[]}

package/lib/commonjs/index.js

@@ -11,6 +11,7 @@ Object.defineProperty(exports, "SharedCredentialsManager", {
   }
 });
 exports.SwanEcomSDK = void 0;
+exports._resetClickDedup = _resetClickDedup;
 exports.createBackgroundMessageHandler = createBackgroundMessageHandler;
 exports.createForegroundMessageHandler = createForegroundMessageHandler;
 exports.createNotifeeBackgroundHandler = createNotifeeBackgroundHandler;
@@ -29,7 +30,6 @@ var _FullScreenView = _interopRequireDefault(require("./components/FullScreenVie
 var _react = require("react");
 var _reactNativeSqlite = _interopRequireDefault(require("react-native-sqlite-2"));
 var _reactNativeDeviceInfo = _interopRequireDefault(require("react-native-device-info"));
-var _geolocation = _interopRequireDefault(require("@react-native-community/geolocation"));
 var _Logger = _interopRequireDefault(require("./utils/Logger.js"));
 var _EventQueueManager = require("./core/EventQueueManager.js");
 var _FlushManager = require("./core/FlushManager.js");
@@ -125,6 +125,28 @@ function parseKeyValuePairs(data) {
   }
 }
 
+/**
+ * Click deduplication guard.
+ * Prevents double click handling if both Firebase (onNotificationOpenedApp) and
+ * Notifee handlers fire for the same notification.
+ */
+const processedClickIds = new Set();
+const CLICK_ID_TTL_MS = 10_000; // Clear after 10 seconds
+
+function markClickProcessed(id) {
+  if (processedClickIds.has(id)) {
+    return false; // Already processed
+  }
+  processedClickIds.add(id);
+  setTimeout(() => processedClickIds.delete(id), CLICK_ID_TTL_MS);
+  return true; // First time processing
+}
+
+/** @internal Test-only: reset click deduplication state */
+function _resetClickDedup() {
+  processedClickIds.clear();
+}
+
 /**
  * Notification deep link payload
  * Emitted when user clicks on a push notification
@@ -166,6 +188,7 @@ class SwanSDK {
   pendingPushEventListeners = [];
   appStateSubscription = null;
   linkingSubscription = null;
+  carouselClickSubscription = null;
 
   // Track if initial notification was already handled to prevent duplicate ACKs
   initialNotificationHandled = false;
@@ -743,6 +766,29 @@ class SwanSDK {
         return;
       }
 
+      // Detect iOS carousel click via URL (Content Extension openURL pattern)
+      // URL format: scheme://route?existing=params&swan_carousel=1&swan_comm_id=messageId&swan_item_index=0
+      if (parsed.params.swan_carousel === '1') {
+        const messageId = parsed.params.swan_comm_id;
+        _Logger.default.log('[SwanSDK] Carousel click via URL, route:', parsed.path, 'messageId:', messageId);
+        if (messageId) {
+          this.sendNotificationAck(messageId, 'clicked');
+          // Mark as processed so checkPendingCarouselClick() (App Group path)
+          // doesn't emit a duplicate NOTIFICATION_OPENED event
+          markClickProcessed(messageId);
+        }
+
+        // Reconstruct route with original query params (exclude swan_ tracking params)
+        const originalParams = Object.entries(parsed.params).filter(([key]) => !key.startsWith('swan_')).map(([key, value]) => `${key}=${encodeURIComponent(value)}`).join('&');
+        const route = originalParams ? `${parsed.path}?${originalParams}` : parsed.path;
+        const payload = {
+          route: route || undefined,
+          keyValuePairs: {}
+        };
+        this.emitNotificationOpened(payload);
+        return; // Handled — don't process as regular deep link
+      }
+
       // Extract swan_ prefixed parameters
       const swanParams = {};
       for (const [key, value] of Object.entries(parsed.params)) {
@@ -912,9 +958,16 @@ class SwanSDK {
       _Logger.default.log('[SwanSDK] Tracking initial app launch event...');
       this.appLaunched();
 
+      // Check for pending carousel click (covers killed/quit → fresh launch)
+      this.checkPendingCarouselClick();
+
       // AppState listener setup (always runs)
       _Logger.default.log('[SwanSDK] Setting up AppState listener...');
       this.setupAppStateListener();
+
+      // Listen for native carousel click events (covers foreground click case
+      // where AppState stays 'active' and polling never triggers)
+      this.setupCarouselClickListener();
       _Logger.default.log('Event queue system initialized successfully');
     } catch (error) {
       _Logger.default.error('Failed to initialize event queue:', error);
@@ -936,10 +989,47 @@ class SwanSDK {
       if (nextAppState === 'active') {
         _Logger.default.log('[SwanSDK] App came to foreground, tracking appLaunched event');
         this.appLaunched();
+        this.checkPendingCarouselClick();
       }
     });
     _Logger.default.log('[SwanSDK] AppState listener set up successfully');
   }
+
+  /**
+   * Listen for native carousel click events emitted via DeviceEventEmitter.
+   * Covers the foreground-click case where AppState stays 'active'.
+   */
+  setupCarouselClickListener() {
+    if (_reactNative.Platform.OS !== 'android') return;
+    if (this.carouselClickSubscription) {
+      this.carouselClickSubscription.remove();
+    }
+    this.carouselClickSubscription = _reactNative.DeviceEventEmitter.addListener('swanCarouselClick', clickData => {
+      _Logger.default.log('[SwanSDK] Carousel click event from native:', JSON.stringify(clickData));
+
+      // Consume the pending click so polling doesn't fire again
+      const {
+        SwanNotificationModule
+      } = _reactNative.NativeModules;
+      SwanNotificationModule?.getPendingCarouselClick?.();
+      const {
+        messageId,
+        route,
+        title,
+        body
+      } = clickData;
+      if (messageId) {
+        this.sendNotificationAck(messageId, 'clicked');
+      }
+      const deepLinkPayload = {
+        route: route || undefined,
+        title: title || undefined,
+        body: body || undefined,
+        keyValuePairs: {}
+      };
+      this.emitNotificationOpened(deepLinkPayload);
+    });
+  }
   createTable(tableName) {
     return new Promise((resolve, reject) => {
       if (!this.db) {
@@ -1423,7 +1513,8 @@ class SwanSDK {
       // This will trigger the Info.plist strings we discussed
       // It handles the 'Not Determined' -> 'Requested' flow automatically
       try {
-        _geolocation.default.requestAuthorization();
+        const Geolocation = require('@react-native-community/geolocation').default;
+        Geolocation.requestAuthorization();
         return true; // iOS handles the dialog; if denied, getCurrentPosition will trigger the error callback
       } catch (e) {
         return false;
@@ -1440,13 +1531,20 @@ class SwanSDK {
    * @param checkOnly - If true, only checks for existing permission without requesting (non-blocking)
    */
   async getDeviceLocation(checkOnly = false) {
+    let Geolocation;
+    try {
+      Geolocation = require('@react-native-community/geolocation').default;
+    } catch (e) {
+      _Logger.default.warn('[SwanSDK] @react-native-community/geolocation is not installed, skipping location');
+      return null;
+    }
     const hasPermission = await this.hasLocationPermission(checkOnly);
     if (!hasPermission) {
       _Logger.default.log('[SwanSDK] Location permission not granted (checkOnly mode), skipping location');
       return null;
     }
     return new Promise(resolve => {
-      _geolocation.default.getCurrentPosition(position => {
+      Geolocation.getCurrentPosition(position => {
         _Logger.default.log(position);
         const {
           latitude,
@@ -1705,6 +1803,72 @@ class SwanSDK {
     this.trackEvent(ECOM_EVENTS.APP_LAUNCHED, data || {});
   }
 
+  /**
+   * Check for a pending carousel click and emit NOTIFICATION_OPENED.
+   * Native carousel clicks bypass Notifee, so the JS event system never fires.
+   *
+   * Android: reads from SwanNotificationModule.getPendingCarouselClick()
+   * iOS: reads from App Group via SharedCredentialsManager.readTemplateClickData()
+   *   (Content Extension writes click data to App Group UserDefaults)
+   *
+   * @internal
+   */
+  async checkPendingCarouselClick() {
+    try {
+      let clickData = null;
+      if (_reactNative.Platform.OS === 'android') {
+        const {
+          SwanNotificationModule
+        } = _reactNative.NativeModules;
+        if (!SwanNotificationModule?.getPendingCarouselClick) return;
+        clickData = await SwanNotificationModule.getPendingCarouselClick();
+      } else if (_reactNative.Platform.OS === 'ios') {
+        // Read click data from App Group (written by Content Extension)
+        clickData = await _SharedCredentialsManager.SharedCredentialsManager.readTemplateClickData();
+
+        // If no data yet, retry after a short delay.
+        // The Content Extension may still be writing when the app foregrounds.
+        if (!clickData) {
+          await new Promise(r => setTimeout(r, 500));
+          clickData = await _SharedCredentialsManager.SharedCredentialsManager.readTemplateClickData();
+        }
+      }
+      if (!clickData) return;
+      _Logger.default.log('[SwanSDK] Pending carousel click found:', JSON.stringify(clickData));
+      const {
+        messageId,
+        route,
+        title,
+        body
+      } = clickData;
+
+      // Deduplication: prevent double click handling.
+      // On iOS, multiple handlers can fire for the same carousel tap
+      // (Notifee foreground, Firebase onNotificationOpenedApp, AppState change).
+      // Use the same markClickProcessed() as other handlers to prevent duplicates.
+      if (messageId && !markClickProcessed(messageId)) {
+        _Logger.default.log('[SwanSDK] Carousel click already processed for messageId:', messageId);
+        return;
+      }
+
+      // Send click ACK
+      if (messageId) {
+        this.sendNotificationAck(messageId, 'clicked');
+      }
+
+      // Emit NOTIFICATION_OPENED event (same as Notifee click handler)
+      const deepLinkPayload = {
+        route: route || undefined,
+        title: title || undefined,
+        body: body || undefined,
+        keyValuePairs: {}
+      };
+      this.emitNotificationOpened(deepLinkPayload);
+    } catch (error) {
+      _Logger.default.error('[SwanSDK] Error checking pending carousel click:', error);
+    }
+  }
+
   /**
    * @param { { success: boolean } } data
    */
@@ -2709,7 +2873,7 @@ class SwanSDK {
       if (initialNotification && !this.initialNotificationHandled) {
         const messageId = initialNotification?.notification?.id;
         const notificationData = initialNotification.data || {};
-        if (messageId) {
+        if (messageId && markClickProcessed(messageId)) {
           _Logger.default.log('[SwanSDK] App opened from Notifee notification tap:', messageId);
           this.initialNotificationHandled = true;
           await this.sendNotificationAck(messageId, 'clicked');
@@ -2750,13 +2914,17 @@ class SwanSDK {
       const messaging = require('@react-native-firebase/messaging').default;
       const initialNotification = await messaging().getInitialNotification();
       if (initialNotification && !this.initialNotificationHandled) {
-        _Logger.default.log('[SwanSDK] App opened from Firebase notification (killed state):', initialNotification.messageId);
+        const messageId = initialNotification.messageId;
+
+        // Deduplication: prevent double click handling
+        if (messageId && !markClickProcessed(messageId)) {
+          _Logger.default.log('[SwanSDK] Firebase initial notification click already processed:', messageId);
+          return;
+        }
+        _Logger.default.log('[SwanSDK] App opened from Firebase notification (killed state):', messageId);
 
         // Mark as handled to prevent duplicate ACKs
         this.initialNotificationHandled = true;
-
-        // Get messageId and notification data
-        const messageId = initialNotification.messageId;
         const notificationData = initialNotification.data || {};
 
         // Extract deep link information
@@ -3398,6 +3566,21 @@ function createBackgroundMessageHandler() {
       return;
     }
 
+    // If iOS displayed the notification natively (aps.alert present),
+    // skip Notifee display to avoid duplicates. Just send delivery ACK.
+    if (_reactNative.Platform.OS === 'ios' && remoteMessage?.notification) {
+      _Logger.default.log('[SwanSDK] iOS native notification (aps.alert), skipping Notifee display');
+      const sdkReady = sdkInstance && sdkInstance.isReady();
+      if (sdkReady) {
+        await sdkInstance.sendNotificationAck(messageId, 'delivered');
+      } else if (messageId) {
+        sendDirectNotificationAck(messageId, 'delivered').catch(err => {
+          _Logger.default.log('[SwanSDK] Direct delivery ACK failed:', err);
+        });
+      }
+      return;
+    }
+
     // Handle silent push (no UI display)
     if (isSilent) {
       console.log('[SwanSDK] Silent push received in background, skipping notification display');
@@ -3549,18 +3732,26 @@ function createNotificationOpenedHandler() {
       const messageId = event?.messageId;
       const notificationData = event?.data || {};
 
-      // For iOS carousel notifications, iOS displays the notification (not Notifee),
-      // so this handler MUST process the click regardless of NES status.
-      // For non-carousel, defer to Notifee click handlers unless NES is active.
-      const isIOSCarousel = _reactNative.Platform.OS === 'ios' && notificationData.notificationType === 'carousel';
-      if (!isIOSCarousel) {
-        const isNESActive = await _SharedCredentialsManager.SharedCredentialsManager.isNotificationServiceExtensionActive();
-        if (!isNESActive && _reactNative.Platform.OS === 'ios') {
-          _Logger.default.log('[SwanSDK] Non-carousel iOS without NES, deferring to Notifee click handler');
-          return;
-        }
+      // Use custom messageId (from push payload data) for deduplication.
+      // On iOS, both Firebase onNotificationOpenedApp AND Notifee event handlers
+      // fire for the same notification tap (Content Extension performNotificationDefaultAction).
+      // Firebase uses its own messageId, Notifee uses data.messageId — they differ.
+      // Using the custom messageId ensures both handlers use the same dedup key.
+      const customMessageId = notificationData.messageId;
+      const dedupId = customMessageId || messageId;
+
+      // Deduplication: prevent double click handling
+      if (dedupId && !markClickProcessed(dedupId)) {
+        _Logger.default.log('[SwanSDK] Click already processed for messageId:', dedupId);
+        return;
       }
 
+      // If onNotificationOpenedApp fires, it means iOS displayed the notification
+      // natively (aps.alert present). Notifee handlers won't fire for iOS-native
+      // notifications, so this handler MUST process the click.
+      // For data-only messages (no aps.alert), Firebase never calls this handler.
+      const isIOSCarousel = _reactNative.Platform.OS === 'ios' && notificationData.notificationType === 'carousel';
+
       // Extract deep link information
       // For carousel notifications, the default route is in 'defaultRoute' field
       let route = notificationData.route || notificationData.defaultRoute;
@@ -3593,6 +3784,11 @@ function createNotificationOpenedHandler() {
       // Emit notificationOpened event for host app to handle
       sdkInstance.emitNotificationOpened(deepLinkPayload);
 
+      // Send delivery ACK (background handler may not have fired for aps.alert notifications)
+      if (messageId && _reactNative.Platform.OS === 'ios') {
+        await sdkInstance.sendNotificationAck(messageId, 'delivered');
+      }
+
       // Send click ACK
       if (messageId) {
         await sdkInstance.sendNotificationAck(messageId, 'clicked');
@@ -3649,6 +3845,12 @@ function createNotifeeForegroundHandler() {
       const messageId = event?.detail?.notification?.data?.messageId;
       const notificationData = event?.detail?.notification?.data || {};
 
+      // Deduplication: prevent double click handling
+      if (messageId && !markClickProcessed(messageId)) {
+        _Logger.default.log('[SwanSDK] Click already processed for messageId:', messageId);
+        return;
+      }
+
       // Extract deep link information
       // Note: route field can contain either a path (/products/123) or full URL (myapp://products/123)
       // For carousel notifications, the default route is in 'defaultRoute' field
@@ -3733,6 +3935,12 @@ function createNotifeeBackgroundHandler() {
       const messageId = detail?.notification?.data?.messageId;
       const notificationData = detail?.notification?.data || {};
 
+      // Deduplication: prevent double click handling
+      if (messageId && !markClickProcessed(messageId)) {
+        _Logger.default.log('[SwanSDK] Click already processed for messageId:', messageId);
+        return;
+      }
+
       // Extract deep link information
       // Note: route field can contain either a path (/products/123) or full URL (myapp://products/123)
       // For carousel notifications, the default route is in 'defaultRoute' field