@dashx/react-native 1.4.1 → 1.5.1

package/DashXReactNative.podspec

@@ -21,16 +21,13 @@ Pod::Spec.new do |s|
   install_modules_dependencies(s)
 
   # DashX iOS SDK — consumers must provide the source in their Podfile:
-  #   pod 'DashX/SDK', :git => 'https://github.com/dashxhq/dashx-ios.git', :tag => '1.5.1'
+  #   pod 'DashX/SDK', :git => 'https://github.com/dashxhq/dashx-ios.git', :tag => '1.6.1'
   # For local development:
   #   pod 'DashX', :path => '../dashx-ios'
   #
-  # Floor of 1.5.1 — earlier versions either fall back to silent-push on the
-  # backend (pre-1.3.0, which iOS throttles aggressively) or omit the
-  # `.timeSensitive` authorization option (pre-1.5.1, which causes
-  # `interruption-level: time-sensitive` payloads to silently downgrade to
-  # `active` on iOS 18 / 26 and stay subject to Focus / Summary filtering).
-  s.dependency "DashX/SDK", ">= 1.5.1"
+  # Floor of 1.6.1, the first release whose automatic event names match
+  # dashx-android 1.5.0 ($screen, Deep Link Opened, Push Notification Tapped).
+  s.dependency "DashX/SDK", ">= 1.6.1"
 
   # Hard dependency so that `canImport(FirebaseMessaging)`
   # evaluates at this pod's compile time, where consumer-Podfile pods aren't

package/README.md

@@ -46,6 +46,44 @@ yarn add @dashx/react-native
 
 For detailed documentation, visit [React Native SDK documentation](https://docs.dashx.com/sdks/client-side/react-native-sdk).
 
+## Automatic events
+
+### App lifecycle
+
+On iOS and Android, call `enableLifecycleTracking()` after `configure` to send these events:
+
+- `Application Installed` and `Application Updated` on the first launch of a new install or build
+- `Application Opened` on launch and when returning to the foreground (`from_background`)
+- `Application Backgrounded` when the app leaves the foreground (`session_length`, in seconds)
+- `Application Crashed` on an uncaught native exception (iOS only)
+
+```js
+DashX.configure({ publicKey: 'YOUR_PUBLIC_KEY' });
+DashX.enableLifecycleTracking();
+```
+
+### Screen views with React Navigation
+
+React Native screens are routes rather than native screens, so track them from the navigation container. `trackNavigation` sends `DashX.screen(route.name)`, recorded as `$screen` with the route name in `$screen_name`, for the first route and then whenever the focused route's name changes. Route params are not sent. Call it from `onReady` so the first screen is captured; it returns a function that stops tracking.
+
+```jsx
+import { NavigationContainer, useNavigationContainerRef } from '@react-navigation/native';
+import DashX from '@dashx/react-native';
+
+export default function App() {
+  const navigationRef = useNavigationContainerRef();
+
+  return (
+    <NavigationContainer
+      ref={navigationRef}
+      onReady={() => DashX.trackNavigation(navigationRef)}
+    >
+      {/* ... */}
+    </NavigationContainer>
+  );
+}
+```
+
 ## Deep linking and push navigation
 
 See the [Deep Linking & Push Navigation](https://docs.dashx.com/apps/messaging/deep-linking) guide for setup instructions, payload fields, and code examples.

package/android/build.gradle

@@ -109,7 +109,7 @@ dependencies {
     // Ensure Firebase Messaging types are available for FCM service subclass
     implementation 'com.google.firebase:firebase-messaging-ktx:23.1.2'
 
-    implementation "com.dashx:dashx-android:1.2.8"
+    implementation "com.dashx:dashx-android:1.5.0"
 
     // Unit tests for `util/Utils.kt` — JVM-only, no Robolectric. The RN
     // `react-android` artifact is pulled in at test runtime (not as a

package/android/src/main/java/com/dashx/rn/sdk/DashXReactNativeModuleImpl.kt

@@ -13,6 +13,7 @@ import androidx.core.app.ActivityCompat
 import androidx.core.content.ContextCompat
 import com.dashx.rn.sdk.util.*
 import com.dashx.android.DashX
+import com.dashx.android.DashXActivityLifecycleCallbacks
 import com.dashx.android.DashXLog
 import com.dashx.android.DashXLog.LogLevel
 import com.dashx.android.data.Asset
@@ -277,12 +278,16 @@ class DashXReactNativeModuleImpl(private val reactContext: ReactApplicationConte
         )
     }
 
-    // --- iOS-only methods: no-op stubs on Android (JS guards prevent these from being called) ---
-
     fun enableLifecycleTracking() {
-        // iOS-only; no-op on Android
+        // The SDK's tracking flags are unsynchronized statics read on the main thread.
+        val application = reactContext.applicationContext
+        UiThreadUtil.runOnUiThread {
+            DashXActivityLifecycleCallbacks.enableActivityLifecycleTracking(application)
+        }
     }
 
+    // --- iOS-only methods: no-op stubs on Android (JS guards prevent these from being called) ---
+
     fun enableAdTracking() {
         // iOS-only; no-op on Android
     }

package/index.d.ts

@@ -85,6 +85,21 @@ export interface ProcessURLOptions {
   forwardToLinkHandler?: boolean;
 }
 
+export interface NavigationRouteLike {
+  name: string;
+  params?: object;
+}
+
+/**
+ * The subset of a React Navigation `NavigationContainer` ref used by
+ * `trackNavigation`, so this package does not depend on `@react-navigation/*`.
+ */
+export interface NavigationContainerLike {
+  addListener(event: 'state', callback: (event: unknown) => void): () => void;
+  getCurrentRoute(): NavigationRouteLike | undefined;
+  isReady?(): boolean;
+}
+
 export interface DashXInstance {
   /**
    * Initialize the SDK with your public key and optional configuration.
@@ -206,10 +221,38 @@ export interface DashXInstance {
   fetchAsset(assetId: string): Promise<AssetResponse>;
 
   /**
-   * Enable automatic app lifecycle event tracking (iOS only).
+   * Enable automatic app lifecycle events (install, update, open, background)
+   * on iOS and Android. Call after `configure`.
    */
   enableLifecycleTracking(): void;
 
+  /**
+   * Send a screen view for each React Navigation route change. Sends the
+   * current route once the container is ready, then `screen(route.name)`
+   * whenever the focused route's name changes (params are not sent).
+   * Returns a function that stops tracking.
+   *
+   * Call it from `NavigationContainer`'s `onReady` so the first screen is
+   * captured. A ref from `useNavigationContainerRef()` or
+   * `createNavigationContainerRef()` may also be passed before the container
+   * mounts.
+   *
+   * @example
+   * const navigationRef = useNavigationContainerRef();
+   *
+   * <NavigationContainer
+   *   ref={navigationRef}
+   *   onReady={() => DashX.trackNavigation(navigationRef)}
+   * >
+   *   ...
+   * </NavigationContainer>
+   */
+  trackNavigation(
+    navigationRef:
+      | NavigationContainerLike
+      | { current: NavigationContainerLike | null }
+  ): () => void;
+
   /**
    * Enable IDFA/ATT ad tracking and request the App Tracking Transparency permission (iOS only).
    */

package/index.js

@@ -184,10 +184,63 @@ const DashX = {
   },
 
   enableLifecycleTracking() {
-    if (Platform.OS !== 'ios') return;
     return getNativeDashX().enableLifecycleTracking();
   },
 
+  trackNavigation(navigationRef) {
+    if (!navigationRef || typeof navigationRef !== 'object') {
+      throw new Error(
+        'DashX.trackNavigation: navigationRef must be a NavigationContainer ref'
+      );
+    }
+
+    // A ref from createNavigationContainerRef / useNavigationContainerRef
+    // queues listeners until the container mounts; a plain useRef does not.
+    const navigation =
+      typeof navigationRef.addListener === 'function'
+        ? navigationRef
+        : navigationRef.current;
+
+    if (!navigation) {
+      console.warn(
+        'DashX.trackNavigation: navigationRef.current is null. Call it from NavigationContainer onReady, or pass a ref from useNavigationContainerRef().'
+      );
+      return () => {};
+    }
+    if (
+      typeof navigation.addListener !== 'function' ||
+      typeof navigation.getCurrentRoute !== 'function'
+    ) {
+      throw new Error(
+        'DashX.trackNavigation: navigationRef must be a NavigationContainer ref'
+      );
+    }
+
+    let lastRouteName = null;
+    let active = true;
+
+    const trackCurrentRoute = () => {
+      if (!active) return;
+      // getCurrentRoute() logs an error on a container ref that is not ready.
+      if (typeof navigation.isReady === 'function' && !navigation.isReady()) {
+        return;
+      }
+      const route = navigation.getCurrentRoute();
+      const routeName = route && route.name;
+      if (!routeName || routeName === lastRouteName) return;
+      lastRouteName = routeName;
+      DashX.screen(routeName);
+    };
+
+    const removeListener = navigation.addListener('state', trackCurrentRoute);
+    trackCurrentRoute();
+
+    return () => {
+      active = false;
+      if (typeof removeListener === 'function') removeListener();
+    };
+  },
+
   enableAdTracking() {
     if (Platform.OS !== 'ios') return;
     return getNativeDashX().enableAdTracking();

package/ios/DashXReactNative.mm

@@ -21,17 +21,17 @@ RCT_EXTERN_METHOD(configure:(NSDictionary *)options);
 
 RCT_EXTERN_METHOD(identify:(NSDictionary *)options);
 
-RCT_EXTERN_METHOD(setIdentity:(NSString * _Nullable)uid token:(NSString * _Nullable)token);
+RCT_EXTERN_METHOD(setIdentity:(id _Nullable)uid token:(id _Nullable)token);
 
 RCT_EXTERN_METHOD(reset);
 
-RCT_EXTERN_METHOD(track:(NSString *)event data:(NSDictionary * _Nullable)data);
+RCT_EXTERN_METHOD(track:(NSString *)event data:(id _Nullable)data);
 
-RCT_EXTERN_METHOD(screen:(NSString *)screenName data:(NSDictionary * _Nullable)data);
+RCT_EXTERN_METHOD(screen:(NSString *)screenName data:(id _Nullable)data);
 
-RCT_EXTERN_METHOD(fetchRecord:(NSString *)urn options:(NSDictionary * _Nullable)options resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject);
+RCT_EXTERN_METHOD(fetchRecord:(NSString *)urn options:(id _Nullable)options resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject);
 
-RCT_EXTERN_METHOD(searchRecords:(NSString *)resource options:(NSDictionary * _Nullable)options resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject);
+RCT_EXTERN_METHOD(searchRecords:(NSString *)resource options:(id _Nullable)options resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject);
 
 RCT_EXTERN_METHOD(fetchStoredPreferences:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject);
 
@@ -51,9 +51,9 @@ RCT_EXTERN_METHOD(enableLifecycleTracking);
 
 RCT_EXTERN_METHOD(enableAdTracking);
 
-RCT_EXTERN_METHOD(processURL:(NSString *)url source:(NSString * _Nullable)source forwardToLinkHandler:(BOOL)forwardToLinkHandler);
+RCT_EXTERN_METHOD(processURL:(NSString *)url source:(id _Nullable)source forwardToLinkHandler:(BOOL)forwardToLinkHandler);
 
-RCT_EXTERN_METHOD(trackNotificationNavigation:(NSDictionary * _Nullable)action notificationId:(NSString * _Nullable)notificationId);
+RCT_EXTERN_METHOD(trackNotificationNavigation:(id _Nullable)action notificationId:(id _Nullable)notificationId);
 
 RCT_EXTERN_METHOD(requestNotificationPermission:(BOOL)fallbackToSettings resolve:(RCTPromiseResolveBlock)resolve reject:(RCTPromiseRejectBlock)reject);
 

package/ios/DashXReactNative.swift

@@ -40,9 +40,11 @@ class DashXReactNative: RCTEventEmitter {
         try? DashX.identify(options: stringOptions)
     }
 
+    // Nullable args are `id`: the new-arch interop runs typed ones through
+    // RCTConvert, which logs an NSNull conversion error for every null.
     @objc(setIdentity:token:)
-    func setIdentity(_ uid: NSString?, _ token: NSString?) {
-        DashX.setIdentity(uid: uid as String?, token: token as String?)
+    func setIdentity(_ uid: Any?, _ token: Any?) {
+        DashX.setIdentity(uid: uid as? String, token: token as? String)
     }
 
     @objc
@@ -51,17 +53,18 @@ class DashXReactNative: RCTEventEmitter {
     }
 
     @objc(track:data:)
-    func track(_ event: String, _ data: NSDictionary?) {
+    func track(_ event: String, _ data: Any?) {
         DashX.track(event, withData: data as? [String: Any])
     }
 
     @objc(screen:data:)
-    func screen(_ screenName: String, _ data: NSDictionary?) {
+    func screen(_ screenName: String, _ data: Any?) {
         DashX.screen(screenName, withData: data as? [String: Any])
     }
 
     @objc(fetchRecord:options:resolve:reject:)
-    func fetchRecord(_ urn: String, options: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    func fetchRecord(_ urn: String, options: Any?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+        let options = options as? NSDictionary
         DashXClient.instance.fetchRecord(
             urn: urn,
             preview: options?["preview"] as? Bool,
@@ -78,7 +81,8 @@ class DashXReactNative: RCTEventEmitter {
     }
 
     @objc(searchRecords:options:resolve:reject:)
-    func searchRecords(_ resource: String, options: NSDictionary?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+    func searchRecords(_ resource: String, options: Any?, resolve: @escaping RCTPromiseResolveBlock, reject: @escaping RCTPromiseRejectBlock) {
+        let options = options as? NSDictionary
         DashXClient.instance.searchRecords(
             resource: resource,
             filter: options?["filter"] as? [String: Any],
@@ -199,15 +203,15 @@ class DashXReactNative: RCTEventEmitter {
     }
 
     @objc(processURL:source:forwardToLinkHandler:)
-    func processURL(_ url: String, source: NSString?, forwardToLinkHandler: Bool) {
+    func processURL(_ url: String, source: Any?, forwardToLinkHandler: Bool) {
         guard let parsedURL = URL(string: url) else { return }
-        DashX.processURL(parsedURL, source: source as String?, forwardToLinkHandler: forwardToLinkHandler)
+        DashX.processURL(parsedURL, source: source as? String, forwardToLinkHandler: forwardToLinkHandler)
     }
 
     @objc(trackNotificationNavigation:notificationId:)
-    func trackNotificationNavigation(_ action: NSDictionary?, notificationId: NSString?) {
+    func trackNotificationNavigation(_ action: Any?, notificationId: Any?) {
         var navigationAction: NavigationAction? = nil
-        if let action = action, let type = action["type"] as? String {
+        if let action = action as? NSDictionary, let type = action["type"] as? String {
             switch type {
             case "deepLink":
                 if let urlString = action["url"] as? String, let url = URL(string: urlString) {
@@ -229,7 +233,7 @@ class DashXReactNative: RCTEventEmitter {
                 break
             }
         }
-        DashX.trackNotificationNavigation(navigationAction, notificationId: notificationId as String?)
+        DashX.trackNotificationNavigation(navigationAction, notificationId: notificationId as? String)
     }
 
     @objc(requestNotificationPermission:resolve:reject:)

package/package.json

@@ -1,11 +1,18 @@
 {
   "name": "@dashx/react-native",
   "title": "DashX React Native",
-  "version": "1.4.1",
+  "version": "1.5.1",
   "description": "DashX SDK for React Native",
   "main": "index.js",
   "types": "index.d.ts",
   "files": [
+    "android",
+    "DashXReactNative.podspec",
+    "index.js",
+    "index.d.ts",
+    "ios",
+    "src",
+    "README.md",
     "!**/__fixtures__",
     "!**/__mocks__",
     "!**/__tests__",
@@ -15,15 +22,8 @@
     "!android/gradlew.bat",
     "!android/gradlew",
     "!android/local.properties",
-    "!ios/build",
-    "*.podspec",
-    "android",
-    "DashXReactNative.podspec",
-    "index.js",
-    "index.d.ts",
-    "ios",
-    "src",
-    "README.md"
+    "!android/src/test",
+    "!ios/build"
   ],
   "codegenConfig": {
     "name": "RNDashXReactNativeSpec",
@@ -37,7 +37,9 @@
     "test": "jest",
     "lint": "eslint index.js && yarn run check-bridge-shim",
     "sync-bridge-shim": "node scripts/generate-bridge-shim.js",
-    "check-bridge-shim": "node scripts/generate-bridge-shim.js && git diff --exit-code ios/DashXReactNative.mm"
+    "check-bridge-shim": "node scripts/generate-bridge-shim.js && git diff --exit-code ios/DashXReactNative.mm",
+    "check-package": "node scripts/check-package.js",
+    "prepublishOnly": "node scripts/check-package.js"
   },
   "repository": {
     "type": "git",

package/.claude/settings.local.json

@@ -1,31 +0,0 @@
-{
-  "permissions": {
-    "allow": [
-      "Bash(xcodebuild -scheme DashX -destination 'generic/platform=iOS')",
-      "Bash(grep -v \"^$\")",
-      "Bash(find /Users/gulshan/Work/dashx-demo-ios -name *.entitlements)",
-      "Bash(wc -l /Users/gulshan/Work/dashx-ios/Sources/DashX/*.swift)",
-      "Bash(swift build:*)",
-      "Bash(xcodebuild -scheme DashX -destination 'generic/platform=iOS' build)",
-      "Bash(./gradlew :dashx:compileDebugKotlin)",
-      "Bash(./gradlew :dashx:compileDebugKotlin --info)",
-      "Bash(gh pr:*)",
-      "WebFetch(domain:github.com)",
-      "WebFetch(domain:patch-diff.githubusercontent.com)",
-      "WebFetch(domain:raw.githubusercontent.com)",
-      "Bash(ls -la /Users/gulshan/Work/dashx-react-native/ios/DashXRCTAppDelegate*)",
-      "Bash(npx jest *)",
-      "Bash(ls *)",
-      "Bash(grep *)",
-      "Read(//private/tmp/**)",
-      "Bash(javap -p com/dashx/android/DashX.class)",
-      "Bash(javap -p 'com/dashx/android/DashX$Companion.class')",
-      "Bash(jar xf *)",
-      "Bash(javap 'com/dashx/android/DashX$Companion.class')",
-      "Bash(javap 'com/dashx/android/data/Asset.class')",
-      "Bash(javap 'com/dashx/android/data/AssetData.class')",
-      "Read(//Users/gulshan/Work/dashx-ios/**)",
-      "WebSearch"
-    ]
-  }
-}

package/.cursor/plans/deep_linking_implementation_plan_303c2ca9.plan.md

@@ -1,216 +0,0 @@
----
-name: Deep Linking Implementation Plan
-overview: Implement MoEngage-like deep linking features in dashx-ios and dashx-android SDKs, covering notification-driven deep links, universal/app links, rich landing pages, structured navigation actions, and host-app callbacks.
-todos:
-  - id: phase-1-payload
-    content: "Phase 1: Extend payload models on both platforms (ActionButton URLs, screenName, screenData, NavigationAction type)"
-    status: pending
-  - id: phase-2-callbacks
-    content: "Phase 2: Notification click callback API -- DashXAppDelegate override (iOS) and DashXNotificationListener interface (Android)"
-    status: pending
-  - id: phase-3-action-buttons
-    content: "Phase 3: Per-action-button deep links on iOS (UNNotificationAction) and Android (NotificationCompat.Action)"
-    status: pending
-  - id: phase-4-rich-landing
-    content: "Phase 4: Rich Landing -- SFSafariViewController (iOS) and Chrome Custom Tabs (Android)"
-    status: completed
-  - id: phase-5-scene-delegate
-    content: "Phase 5: SceneDelegate deep link support -- openURLContexts and continue userActivity (iOS only)"
-    status: completed
-  - id: phase-6-analytics
-    content: "Phase 6: Deep link source tracking -- processURL / processDeepLink analytics events"
-    status: completed
-  - id: phase-7-docs
-    content: "Phase 7: Documentation and demo app updates for all deep linking features"
-    status: completed
-isProject: false
----
-
-# Deep Linking Implementation Plan
-
-## Current State vs MoEngage: Feature Comparison
-
-### What We Have Today
-
-**dashx-ios** ([DashXAppDelegate.swift](dashx-ios/Sources/DashXFirebase/DashXAppDelegate.swift), [DashXClient.swift](dashx-ios/Sources/DashX/DashXClient.swift), [DashXData.swift](dashx-ios/Sources/DashX/DashXData.swift)):
-- Notification `url` field in `DashXNotificationData` -- opens via `handleLink(url:)` callback
-- Universal link forwarding via `DashXClient.handleUserActivity()` + `linkHandler` closure (AppDelegate only)
-- `notificationClicked(message:, actionIdentifier:)` open method for subclass overrides
-- `notificationDeliveredInForeground(message:)` callback
-- Message tracking: delivered / clicked / dismissed
-- `DashXSceneDelegate` exists but only handles ad tracking -- no deep link or URL handling
-
-**dashx-android** ([NotificationProcessor.kt](dashx-android/dashx/src/main/java/com/dashx/sdk/NotificationProcessor.kt), [DashXFirebaseMessagingService.kt](dashx-android/dashx/src/main/java/com/dashx/sdk/DashXFirebaseMessagingService.kt)):
-- Notification `url` field in `DashXPayload` -- opens via system `ACTION_VIEW` intent
-- `click_action` field -- resolves as Activity class name or Intent action string
-- `NotificationReceiver` (translucent Activity) delegates to `NotificationProcessor.handleClick()`
-- Message tracking: DELIVERED / OPENED / DISMISSED
-- No callback mechanism for the host app to intercept deep link navigation
-
-### What MoEngage Has That We Don't
-
-| Feature | MoEngage | DashX iOS | DashX Android |
-|---------|----------|-----------|---------------|
-| Custom URL scheme handling | Auto via swizzle or `processURL()` | Not handled | N/A (system intent) |
-| SceneDelegate deep link support | `scene(_:openURLContexts:)` + `scene(_:continue:)` | Missing | N/A |
-| Rich Landing (in-app browser) | SFSafariViewController / Chrome Custom Tabs | Missing | Missing |
-| Navigate to Screen (structured) | `screenName` + `screenData` in payload | Missing | Missing |
-| Per-action-button deep links | Each button has its own URL/action | Buttons have no URL | No action buttons at all |
-| Notification click callback with control | `onNotificationClicked()` returns bool to control redirection | Partial (subclass override, no control flag) | Missing entirely |
-| Notification received callback | `onNotificationReceived()` | Partial (foreground only) | Missing |
-| Notification cleared callback | `onNotificationCleared()` | Has `dismissed` tracking | Has `DISMISSED` tracking |
-| Deep link URL tracking/analytics | `processURL()` tracks source attribution | Missing | Missing |
-| Customizable notification builder | `customizeNotification()` / `customizeNotificationBuilder()` | Not exposed | Not exposed |
-| Self-handled notification | `onSelfHandledNotificationReceived()` | N/A | Missing |
-| AppDelegate proxy/swizzling | Auto-intercepts deep link AppDelegate methods | Not implemented | N/A |
-
----
-
-## Implementation Plan
-
-### Phase 1: Enhanced Payload Models (Both Platforms)
-
-Extend the notification payload models to support structured navigation.
-
-**iOS** -- Update `ActionButton` and `DashXNotificationData` in [DashXData.swift](dashx-ios/Sources/DashX/DashXData.swift):
-- Add `url: String?` and `clickAction: String?` to `ActionButton`
-- Add `screenName: String?` and `screenData: [String: String]?` to `DashXNotificationData`
-- Add `clickAction: String?` (currently iOS has no `click_action` at all)
-
-**Android** -- Update `DashXPayload` in [DashXFirebaseMessagingService.kt](dashx-android/dashx/src/main/java/com/dashx/sdk/DashXFirebaseMessagingService.kt):
-- Add `screenName: String?` (`screen_name`) and `screenData: Map<String, String>?` (`screen_data`) to `DashXPayload`
-- Create an `ActionButton` model (currently Android has no action button support)
-- Add `actionButtons: List<ActionButton>?` (`action_buttons`) to `DashXPayload`
-
-Create a shared `NavigationAction` model on both platforms:
-
-```kotlin
-// Android
-sealed class NavigationAction {
-    data class DeepLink(val url: String) : NavigationAction()
-    data class Screen(val name: String, val data: Map<String, String>?) : NavigationAction()
-    data class RichLanding(val url: String) : NavigationAction()
-}
-```
-
-```swift
-// iOS
-public enum NavigationAction {
-    case deepLink(url: URL)
-    case screen(name: String, data: [String: String]?)
-    case richLanding(url: URL)
-}
-```
-
-### Phase 2: Notification Click Callback API (Both Platforms)
-
-Provide a callback mechanism that gives the host app full control over deep link handling.
-
-**iOS** -- In [DashXAppDelegate.swift](dashx-ios/Sources/DashXFirebase/DashXAppDelegate.swift):
-- Add `open func onNotificationClicked(message:, action: NavigationAction?, actionIdentifier: String) -> Bool` -- return `true` to suppress SDK default handling
-- Refactor `userNotificationCenter(_:didReceive:)` to resolve `NavigationAction` from the payload, call the callback, and only proceed with default handling if it returns `false`
-- Deprecate the existing `notificationClicked(message:actionIdentifier:)` (keep for backward compat)
-
-**Android** -- Create a new `DashXNotificationListener` interface in a new file `DashXNotificationListener.kt`:
-```kotlin
-interface DashXNotificationListener {
-    fun onNotificationReceived(payload: DashXPayload) {}
-    fun onNotificationClicked(payload: DashXPayload, action: NavigationAction?): Boolean = false
-    fun onNotificationDismissed(payload: DashXPayload) {}
-}
-```
-- Add `DashX.registerNotificationListener(listener)` and `DashX.unregisterNotificationListener()`
-- Wire into `NotificationProcessor.handleClick()` and `DashXFirebaseMessagingService.onMessageReceived()`
-- If `onNotificationClicked` returns `true`, skip the SDK's default URL/click_action handling
-
-### Phase 3: Action Button Deep Links
-
-**iOS** -- In [DashXAppDelegate.swift](dashx-ios/Sources/DashXFirebase/DashXAppDelegate.swift):
-- When building `UNNotificationAction` items from `actionButtons`, store the per-button URL/action in `userInfo` (via `UNNotificationCategory`)
-- In `didReceive response`, match `response.actionIdentifier` to the button's identifier and resolve its `NavigationAction`
-
-**Android**:
-- Parse `action_buttons` from `DashXPayload` and build `NotificationCompat.Action` items
-- Attach per-button `PendingIntent` with the button's URL or action
-- Handle button clicks in `NotificationProcessor` by resolving the specific button's `NavigationAction`
-
-### Phase 4: Rich Landing (In-App Browser)
-
-When a notification's action is `richLanding` (or a URL is explicitly marked for in-app display):
-
-**iOS**:
-- Add a helper in `DashXClient` or a new `DashXBrowser.swift` that presents `SFSafariViewController` for a given URL
-- Wire it as the default handler when `NavigationAction.richLanding` is resolved and the callback doesn't suppress it
-
-**Android**:
-- Add `implementation 'androidx.browser:browser:1.x.x'` as a dependency
-- Create `DashXBrowser.kt` that opens `CustomTabsIntent` for the URL
-- Wire as default handler for `NavigationAction.RichLanding`
-
-### Phase 5: SceneDelegate Deep Link Support (iOS Only)
-
-Update [DashXSceneDelegate.swift](dashx-ios/Sources/DashX/DashXSceneDelegate.swift) to handle both custom URL schemes and universal links:
-
-```swift
-@available(iOS 13.0, *)
-open func scene(_ scene: UIScene, openURLContexts URLContexts: Set<UIOpenURLContext>) {
-    guard let url = URLContexts.first?.url else { return }
-    DashXClient.instance.linkHandler?(url)
-}
-
-@available(iOS 13.0, *)
-open func scene(_ scene: UIScene, continue userActivity: NSUserActivity) {
-    DashXClient.instance.handleUserActivity(userActivity: userActivity)
-}
-```
-
-### Phase 6: Deep Link Source Tracking / Analytics
-
-Add a `trackDeepLink(url:, source:)` method on both platforms to record deep link opens as analytics events.
-
-**iOS** -- In [DashXClient.swift](dashx-ios/Sources/DashX/DashXClient.swift):
-- Add `public func processURL(_ url: URL, source: String? = nil)` that:
-  1. Fires a `dx_deep_link_opened` event with URL, source, timestamp
-  2. Invokes `linkHandler?(url)`
-- Update `handleUserActivity` and the notification click path to go through `processURL`
-
-**Android** -- In `DashX.kt`:
-- Add `fun processDeepLink(uri: Uri, source: String? = null)` with equivalent behavior
-- Update `NotificationProcessor.handleClick()` to call `processDeepLink` before opening the URL
-
-### Phase 7: Documentation and Demo App Updates
-
-- Update [dashx-ios/README.md](dashx-ios/README.md) and [dashx-android/README.md](dashx-android/README.md) with deep linking integration guides
-- Update [dashx-demo-rn](dashx-demo-rn/), [dashx-demo-ios](dashx-demo-ios/), and [dashx-demo-android](dashx-demo-android/) to demonstrate:
-  - Handling deep links from push notifications
-  - Custom URL scheme setup
-  - Universal Links / App Links configuration
-  - Rich landing page behavior
-  - Navigate-to-screen with custom data
-
----
-
-## Architecture: Notification Click Flow (After Implementation)
-
-```mermaid
-flowchart TD
-    NotifTap[User Taps Notification] --> ParsePayload[Parse DashX Payload]
-    ParsePayload --> ResolveAction[Resolve NavigationAction]
-    ResolveAction --> TrackClick[trackMessage: CLICKED/OPENED]
-    TrackClick --> CallbackCheck{Host App Callback}
-    CallbackCheck -->|returns true| Done[Host App Handles]
-    CallbackCheck -->|returns false| ActionType{Action Type?}
-    ActionType -->|DeepLink| OpenURL[Open URL via system / linkHandler]
-    ActionType -->|RichLanding| InAppBrowser[SFSafari / CustomTabs]
-    ActionType -->|Screen| ScreenNav[Invoke screenHandler callback]
-    ActionType -->|None| FallbackClick[Call legacy notificationClicked]
-```
-
----
-
-## Key Design Decisions
-
-- **Callback-first, not swizzle**: Unlike MoEngage's AppDelegate proxy approach, we keep our subclass/callback pattern. Swizzling is fragile and conflicts with other SDKs. The host app subclasses `DashXAppDelegate`/`DashXSceneDelegate` (iOS) or registers a `DashXNotificationListener` (Android).
-- **NavigationAction as a first-class type**: Rather than passing raw strings, provide a sealed/enum type so host apps can pattern-match on the navigation intent.
-- **Backward compatible**: The existing `handleLink(url:)`, `notificationClicked(message:actionIdentifier:)` (iOS), and `click_action`/`url` behavior (Android) continue to work. New APIs are additive.
-- **Rich landing is opt-in**: URLs default to system handling (external browser / `ACTION_VIEW`). Rich landing requires explicit `rich_landing` flag in the payload or a configuration option.

package/.gitattributes

@@ -1 +0,0 @@
-*.pbxproj -text