@dashx/react-native 1.1.2 → 1.1.4

package/android/build/reports/lint-results-debug.txt

@@ -0,0 +1,12 @@
+/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/java/com/dashx/rn/sdk/DashXReactNativeFirebaseMessagingService.kt:15: Warning: Apps that use Firebase Cloud Messaging should implement onNewToken() in order to observe token changes [MissingFirebaseInstanceTokenRefresh]
+class DashXReactNativeFirebaseMessagingService : DashXFirebaseMessagingService() {
+      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+   Explanation for issues of type "MissingFirebaseInstanceTokenRefresh":
+   Apps that use Firebase Cloud Messaging should implement the
+   FirebaseMessagingService#onNewToken() callback in order to observe token
+   changes.
+
+   https://firebase.google.com/docs/cloud-messaging/android/client#monitor-token-generation
+
+0 errors, 1 warning

package/android/build/reports/lint-results-debug.xml

@@ -0,0 +1,22 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<issues format="6" by="lint 8.12.0">
+
+    <issue
+        id="MissingFirebaseInstanceTokenRefresh"
+        severity="Warning"
+        message="Apps that use Firebase Cloud Messaging should implement `onNewToken()` in order to observe token changes"
+        category="Correctness"
+        priority="6"
+        summary="Missing Firebase Messaging Callback"
+        explanation="Apps that use Firebase Cloud Messaging should implement the `FirebaseMessagingService#onNewToken()` callback in order to observe token changes."
+        url="https://firebase.google.com/docs/cloud-messaging/android/client#monitor-token-generation"
+        urls="https://firebase.google.com/docs/cloud-messaging/android/client#monitor-token-generation"
+        errorLine1="class DashXReactNativeFirebaseMessagingService : DashXFirebaseMessagingService() {"
+        errorLine2="      ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~">
+        <location
+            file="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/java/com/dashx/rn/sdk/DashXReactNativeFirebaseMessagingService.kt"
+            line="15"
+            column="7"/>
+    </issue>
+
+</issues>

package/android/build.gradle

@@ -12,7 +12,7 @@ def getVersionFromNpm() {
 
 android {
     namespace 'com.dashx.rn.sdk'
-    compileSdkVersion 35
+    compileSdkVersion 34
 
     buildFeatures {
         buildConfig = true
@@ -55,5 +55,5 @@ 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.1.4"
+    implementation "com.dashx:dashx-android:1.1.7"
 }

package/android/gradle/wrapper/gradle-wrapper.properties

@@ -1,6 +1,6 @@
 #Mon Oct 30 16:24:27 IST 2023
 distributionBase=GRADLE_USER_HOME
 distributionPath=wrapper/dists
-distributionUrl=https\://services.gradle.org/distributions/gradle-7.2-bin.zip
+distributionUrl=https\://services.gradle.org/distributions/gradle-8.14.3-bin.zip
 zipStoreBase=GRADLE_USER_HOME
 zipStorePath=wrapper/dists

package/babel.config.js

@@ -1,3 +1,3 @@
 module.exports = {
-  presets: ['module:metro-react-native-babel-preset'],
+  presets: ['module:@react-native/babel-preset'],
 };

package/index.d.ts

@@ -1,5 +1,14 @@
 import { EmitterSubscription } from 'react-native';
 
+/**
+ * Error codes returned by native SDKs in promise rejections.
+ * Consistent across iOS and Android.
+ */
+export enum DashXErrorCode {
+  /** An unspecified error occurred. */
+  EUNSPECIFIED = 'EUNSPECIFIED',
+}
+
 export interface ConfigureOptions {
   publicKey: string;
   baseURI?: string;
@@ -28,6 +37,7 @@ export interface SearchRecordsOptions {
   filter?: Record<string, unknown>;
   order?: Record<string, unknown>[];
   limit?: number;
+  page?: number;
   preview?: boolean;
   language?: string;
   fields?: Record<string, unknown>[];
@@ -35,6 +45,23 @@ export interface SearchRecordsOptions {
   exclude?: Record<string, unknown>[];
 }
 
+export interface AssetData {
+  status?: string;
+  url?: string;
+  playbackIds?: { id?: string; policy?: string }[];
+}
+
+export interface AssetResponse {
+  status?: string;
+  data?: { asset?: AssetData };
+}
+
+/**
+ * Mirrors UNAuthorizationStatus integer values:
+ * 0 = notDetermined, 1 = denied, 2 = authorized, 3 = provisional, 4 = ephemeral
+ */
+export type NotificationPermissionStatus = 0 | 1 | 2 | 3 | 4;
+
 export interface NotificationMessage {
   [key: string]: unknown;
 }
@@ -123,6 +150,49 @@ export interface DashXInstance {
   onMessageReceived(
     callback: (message: NotificationMessage) => void
   ): EmitterSubscription;
+
+  /**
+   * Upload a local file to DashX. Returns an AssetResponse with the asset status and URL.
+   * @param filePath Absolute path to the local file.
+   */
+  uploadAsset(
+    filePath: string,
+    resource: string,
+    attribute: string
+  ): Promise<AssetResponse>;
+
+  /**
+   * Fetch details of a previously uploaded asset by its ID.
+   */
+  fetchAsset(assetId: string): Promise<AssetResponse>;
+
+  /**
+   * Enable automatic app lifecycle event tracking (iOS only).
+   */
+  enableLifecycleTracking(): void;
+
+  /**
+   * Enable IDFA/ATT ad tracking and request the App Tracking Transparency permission (iOS only).
+   */
+  enableAdTracking(): void;
+
+  /**
+   * Request push notification permission from the user.
+   * Resolves with a NotificationPermissionStatus integer.
+   */
+  requestNotificationPermission(): Promise<NotificationPermissionStatus>;
+
+  /**
+   * Get the current push notification permission status without prompting.
+   * Resolves with a NotificationPermissionStatus integer.
+   */
+  getNotificationPermissionStatus(): Promise<NotificationPermissionStatus>;
+
+  /**
+   * Register a listener for deep link / universal link events dispatched by the SDK.
+   * Returns a subscription that can be removed via `.remove()`.
+   */
+  onLinkReceived(callback: (url: string) => void): EmitterSubscription;
 }
 
 declare const DashX: DashXInstance;

package/index.js

@@ -40,7 +40,9 @@ const DashX = {
       throw new Error('DashX.configure: options must be an object');
     }
     if (!options.publicKey || typeof options.publicKey !== 'string') {
-      throw new Error('DashX.configure: publicKey is required and must be a string');
+      throw new Error(
+        'DashX.configure: publicKey is required and must be a string'
+      );
     }
     return getNativeDashX().configure(options);
   },
@@ -54,10 +56,14 @@ const DashX = {
 
   setIdentity(uid, token) {
     if (!uid || typeof uid !== 'string') {
-      throw new Error('DashX.setIdentity: uid is required and must be a string');
+      throw new Error(
+        'DashX.setIdentity: uid is required and must be a string'
+      );
     }
     if (!token || typeof token !== 'string') {
-      throw new Error('DashX.setIdentity: token is required and must be a string');
+      throw new Error(
+        'DashX.setIdentity: token is required and must be a string'
+      );
     }
     return getNativeDashX().setIdentity(uid, token);
   },
@@ -75,14 +81,18 @@ const DashX = {
 
   screen(screenName, data) {
     if (!screenName || typeof screenName !== 'string') {
-      throw new Error('DashX.screen: screenName is required and must be a string');
+      throw new Error(
+        'DashX.screen: screenName is required and must be a string'
+      );
     }
     return getNativeDashX().screen(screenName, data || null);
   },
 
   fetchRecord(urn, options = {}) {
     if (!urn || typeof urn !== 'string') {
-      throw new Error('DashX.fetchRecord: urn is required and must be a string (e.g. "article/123")');
+      throw new Error(
+        'DashX.fetchRecord: urn is required and must be a string (e.g. "article/123")'
+      );
     }
     if (options !== null && typeof options !== 'object') {
       throw new Error('DashX.fetchRecord: options must be an object');
@@ -92,7 +102,9 @@ const DashX = {
 
   searchRecords(resource, options = {}) {
     if (!resource || typeof resource !== 'string') {
-      throw new Error('DashX.searchRecords: resource is required and must be a string');
+      throw new Error(
+        'DashX.searchRecords: resource is required and must be a string'
+      );
     }
     if (options !== null && typeof options !== 'object') {
       throw new Error('DashX.searchRecords: options must be an object');
@@ -134,6 +146,51 @@ const DashX = {
     }
     return getEventEmitter().addListener('messageReceived', callback);
   },
+
+  uploadAsset(filePath, resource, attribute) {
+    if (!filePath || typeof filePath !== 'string') {
+      throw new Error('DashX.uploadAsset: filePath must be a string');
+    }
+    if (!resource || typeof resource !== 'string') {
+      throw new Error('DashX.uploadAsset: resource must be a string');
+    }
+    if (!attribute || typeof attribute !== 'string') {
+      throw new Error('DashX.uploadAsset: attribute must be a string');
+    }
+    return getNativeDashX().uploadAsset(filePath, resource, attribute);
+  },
+
+  fetchAsset(assetId) {
+    if (!assetId || typeof assetId !== 'string') {
+      throw new Error('DashX.fetchAsset: assetId must be a string');
+    }
+    return getNativeDashX().fetchAsset(assetId);
+  },
+
+  enableLifecycleTracking() {
+    if (Platform.OS !== 'ios') return;
+    return getNativeDashX().enableLifecycleTracking();
+  },
+
+  enableAdTracking() {
+    if (Platform.OS !== 'ios') return;
+    return getNativeDashX().enableAdTracking();
+  },
+
+  requestNotificationPermission() {
+    return getNativeDashX().requestNotificationPermission();
+  },
+
+  getNotificationPermissionStatus() {
+    return getNativeDashX().getNotificationPermissionStatus();
+  },
+
+  onLinkReceived(callback) {
+    if (typeof callback !== 'function') {
+      throw new Error('DashX.onLinkReceived: callback must be a function');
+    }
+    return getEventEmitter().addListener('linkReceived', callback);
+  },
 };
 
 export default DashX;

package/ios/DashXRCTAppDelegate.swift

@@ -1,94 +1,108 @@
-import FirebaseCore
-import FirebaseMessaging
 import Foundation
 import UIKit
 import DashX
+#if canImport(FirebaseCore)
+import FirebaseCore
+#endif
+#if canImport(FirebaseMessaging)
+import FirebaseMessaging
+#endif
 
 @objc(DashXRCTAppDelegate)
-open class DashXRCTAppDelegate: RCTAppDelegate, MessagingDelegate, UNUserNotificationCenterDelegate {
-    // MARK: Getters
-    private var app: UIApplication = .shared
+open class DashXRCTAppDelegate: RCTDefaultReactNativeFactoryDelegate, UIApplicationDelegate, UNUserNotificationCenterDelegate {
 
-    // MARK: Init
+    public var window: UIWindow?
+    private var reactNativeFactory: RCTReactNativeFactory?
 
-    public override init() {
-        super.init()
+    /// The React Native module name. Defaults to "main". Override to match your app's registered component name.
+    open var moduleName: String { "main" }
 
-        UNUserNotificationCenter.current().delegate = self
+    // MARK: - UIApplicationDelegate
 
-        // Register to ensure device token can be fetched
-        app.registerForRemoteNotifications()
-    }
-
-    // MARK: MessagingDelegate
-
-    open override func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+    open func application(_ application: UIApplication, didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
+        #if canImport(FirebaseCore)
         FirebaseApp.configure()
+        #endif
+        #if canImport(FirebaseMessaging)
         Messaging.messaging().delegate = self
+        #endif
+
+        UNUserNotificationCenter.current().delegate = self
 
-        // Requesting Push Notifications Permission
         DashX.requestNotificationPermission { authorizationStatus in
             switch authorizationStatus {
             case .authorized:
                 DashXLog.d(tag: #function, "permission authorized to receive push notifications")
+                DispatchQueue.main.async {
+                    application.registerForRemoteNotifications()
+                }
             default:
                 DashXLog.d(tag: #function, "permission denied to receive push notifications")
             }
         }
 
-        return super.application(application, didFinishLaunchingWithOptions: launchOptions)
+        let factory = RCTReactNativeFactory(delegate: self)
+        reactNativeFactory = factory
+
+        window = UIWindow(frame: UIScreen.main.bounds)
+        factory.startReactNative(withModuleName: moduleName, in: window, launchOptions: launchOptions)
+
+        return true
     }
 
     // MARK: - APNS Token Management
 
-    public override func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
+    open func application(_ application: UIApplication, didFailToRegisterForRemoteNotificationsWithError error: Error) {
         DashXLog.d(tag: #function, "Unable to register for remote notifications: \(error.localizedDescription)")
     }
 
-    public override func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
+    open func application(_ application: UIApplication, didRegisterForRemoteNotificationsWithDeviceToken deviceToken: Data) {
+        #if canImport(FirebaseMessaging)
         Messaging.messaging().setAPNSToken(deviceToken, type: .unknown)
-    }
-
-    public func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
-        guard let token = fcmToken else {
-            DashXLog.d(tag: #function, "FCM Token is empty")
-            return
+        Messaging.messaging().token { token, error in
+            if let token = token {
+                DashX.setFCMToken(to: token)
+            }
         }
+        #endif
+    }
 
-        DashXLog.d(tag: #function, "FCM Token: \(token)")
+    // MARK: - Universal Links
 
-        DashX.setFCMToken(to: token)
+    open func application(_ application: UIApplication, continue userActivity: NSUserActivity, restorationHandler: @escaping ([UIUserActivityRestoring]?) -> Void) -> Bool {
+        DashX.handleUserActivity(userActivity: userActivity)
+        return true
     }
 
     // MARK: - Push Notifications
 
-    public func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
+    open func userNotificationCenter(_ center: UNUserNotificationCenter, willPresent notification: UNNotification, withCompletionHandler completionHandler: @escaping (UNNotificationPresentationOptions) -> Void) {
         let message = notification.request.content.userInfo
 
-        // Pass notification reciept information to Firebase
+        #if canImport(FirebaseMessaging)
         Messaging.messaging().appDidReceiveMessage(message)
+        #endif
 
-        DashX.trackNotification(message: message, event: .delivered)
+        DashX.trackMessage(message: message, event: .delivered)
 
         DashXEventEmitter.instance.dispatch(name: "messageReceived", body: bridgeSafePayload(from: message))
 
-        let presentationOptions = notificationDeliveredInForeground(message: message)
-
-        completionHandler(presentationOptions)
+        completionHandler(notificationDeliveredInForeground(message: message))
     }
 
-    public func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
+    open func userNotificationCenter(_ center: UNUserNotificationCenter, didReceive response: UNNotificationResponse, withCompletionHandler completionHandler: @escaping () -> Void) {
         let message = response.notification.request.content.userInfo
 
-        // Pass notification reciept information to Firebase
+        #if canImport(FirebaseMessaging)
         Messaging.messaging().appDidReceiveMessage(message)
+        #endif
 
         DashXEventEmitter.instance.dispatch(name: "messageReceived", body: bridgeSafePayload(from: message))
 
         if response.actionIdentifier == UNNotificationDismissActionIdentifier {
-            DashX.trackNotification(message: message, event: .dismissed)
+            DashX.trackMessage(message: message, event: .dismissed)
         } else {
-            DashX.trackNotification(message: message, event: .clicked)
+            DashX.trackMessage(message: message, event: .clicked)
 
             if let url = message.dashxNotificationUrl() {
                 handleLink(url: url)
@@ -100,9 +114,10 @@ open class DashXRCTAppDelegate: RCTAppDelegate, MessagingDelegate, UNUserNotific
         completionHandler()
     }
 
-    public override func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
-        // Pass notification reciept information to Firebase
+    open func application(_ application: UIApplication, didReceiveRemoteNotification userInfo: [AnyHashable: Any], fetchCompletionHandler completionHandler: @escaping (UIBackgroundFetchResult) -> Void) {
+        #if canImport(FirebaseMessaging)
         Messaging.messaging().appDidReceiveMessage(userInfo)
+        #endif
 
         DashXEventEmitter.instance.dispatch(name: "messageReceived", body: bridgeSafePayload(from: userInfo))
 
@@ -153,15 +168,16 @@ open class DashXRCTAppDelegate: RCTAppDelegate, MessagingDelegate, UNUserNotific
         completionHandler(.newData)
     }
 
-    // MARK: - Push Notifications handlers
+    // MARK: - Override points
 
-    open func notificationDeliveredInForeground(message: [AnyHashable: Any]) -> UNNotificationPresentationOptions { return [] }
+    open func notificationDeliveredInForeground(message: [AnyHashable: Any]) -> UNNotificationPresentationOptions { return [.banner, .sound] }
 
     open func notificationClicked(message: [AnyHashable: Any], actionIdentifier: String) {}
 
     open func handleLink(url: URL) {}
 
-    /// Converts notification userInfo to a dictionary safe for the React Native bridge (string keys, JSON-serializable values).
+    // MARK: - Helpers
+
     private func bridgeSafePayload(from userInfo: [AnyHashable: Any]) -> [String: Any] {
         userInfo.reduce(into: [String: Any]()) { result, pair in
             let key = String(describing: pair.key)
@@ -178,7 +194,7 @@ open class DashXRCTAppDelegate: RCTAppDelegate, MessagingDelegate, UNUserNotific
                     if let num = item as? NSNumber { return num }
                     if let d = item as? [AnyHashable: Any] { return bridgeSafePayload(from: d) }
                     if let a = item as? [Any] {
-                        return a.map { sub in
+                        return a.map { sub -> Any in
                             if let s = sub as? String { return s }
                             if let n = sub as? NSNumber { return n }
                             if let sd = sub as? [AnyHashable: Any] { return bridgeSafePayload(from: sd) }
@@ -216,16 +232,13 @@ extension DashXRCTAppDelegate {
                 return
             }
 
-            // Create a temporary file URL to save the downloaded image
             let tmpDirectoryURL = FileManager.default.temporaryDirectory
             let uuid = UUID().uuidString
             let tmpFileURL = tmpDirectoryURL.appendingPathComponent(uuid + ".png")
 
             do {
-                // Move the downloaded file to the temporary file URL
                 try FileManager.default.moveItem(at: location, to: tmpFileURL)
 
-                // Create the notification attachment from the temporary file URL
                 let attachment = try UNNotificationAttachment(identifier: "\(id)-attachment", url: tmpFileURL, options: nil)
                 content.attachments = [attachment]
                 self.createNotification(id: id, content: content)
@@ -236,3 +249,18 @@ extension DashXRCTAppDelegate {
         task.resume()
     }
 }
+
+#if canImport(FirebaseMessaging)
+extension DashXRCTAppDelegate: MessagingDelegate {
+    open func messaging(_ messaging: Messaging, didReceiveRegistrationToken fcmToken: String?) {
+        guard let token = fcmToken else {
+            DashXLog.d(tag: #function, "FCM Token is empty")
+            return
+        }
+
+        DashXLog.d(tag: #function, "FCM Token: \(token)")
+
+        DashX.setFCMToken(to: token)
+    }
+}
+#endif

package/ios/DashXReactNative-Bridging-Header.h

@@ -1,3 +1,5 @@
 #import <React/RCTBridgeModule.h>
 #import <React/RCTEventEmitter.h>
 #import <React/RCTViewManager.h>
+#import <React_RCTAppDelegate/RCTDefaultReactNativeFactoryDelegate.h>
+#import <React_RCTAppDelegate/RCTReactNativeFactory.h>

package/ios/DashXReactNative.h

@@ -0,0 +1 @@
+#import "DashXRCTAppDelegate.h"

package/ios/DashXReactNative.mm

@@ -7,7 +7,7 @@ RCT_EXTERN_METHOD(configure:(NSDictionary *)options);
 
 RCT_EXTERN_METHOD(identify:(NSDictionary *)options);
 
-RCT_EXTERN_METHOD(setIdentity:(NSString *)uid token:(NSString *)token);
+RCT_EXTERN_METHOD(setIdentity:(NSString * _Nullable)uid token:(NSString * _Nullable)token);
 
 RCT_EXTERN_METHOD(track:(NSString *)event data:(NSDictionary * _Nullable)data);
 
@@ -29,4 +29,16 @@ RCT_EXTERN_METHOD(unsubscribe);
 
 RCT_EXTERN_METHOD(setLogLevel:(int *)level);
 
+RCT_EXTERN_METHOD(uploadAsset:(NSString *)filePath resource:(NSString *)resource attribute:(NSString *)attribute resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject);
+
+RCT_EXTERN_METHOD(fetchAsset:(NSString *)assetId resolver:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject);
+
+RCT_EXTERN_METHOD(enableLifecycleTracking);
+
+RCT_EXTERN_METHOD(enableAdTracking);
+
+RCT_EXTERN_METHOD(requestNotificationPermission:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject);
+
+RCT_EXTERN_METHOD(getNotificationPermissionStatus:(RCTPromiseResolveBlock)resolve rejecter:(RCTPromiseRejectBlock)reject);
+
 @end