@dashx/react-native 1.1.0 → 1.1.1

package/README.md

@@ -232,6 +232,22 @@ Unsubscribe:
 DashX.unsubscribe();
 ```
 
+### Listen for incoming messages
+
+Register a listener to handle push notifications when they arrive:
+
+```js
+import { useEffect } from 'react';
+
+useEffect(() => {
+  const subscription = DashX.onMessageReceived((message) => {
+    console.log('Notification received:', message);
+  });
+
+  return () => subscription.remove();
+}, []);
+```
+
 ### Notification preferences
 
 Fetch the user's stored notification preferences:
@@ -323,6 +339,7 @@ const styles = StyleSheet.create({
 | `fetchStoredPreferences` | `()` | `Promise<object>` | Fetch stored notification preferences |
 | `saveStoredPreferences` | `(data: object)` | `Promise<object>` | Save notification preferences |
 | `setLogLevel` | `(level: number)` | `void` | Set SDK log verbosity |
+| `onMessageReceived` | `(callback: function)` | `EmitterSubscription` | Listen for incoming push notifications |
 
 For detailed usage and advanced features, refer to the [DashX documentation](https://docs.dashx.com/developer).
 

package/android/build/intermediates/incremental/debug/packageDebugResources/compile-file-map.properties

@@ -1 +1 @@
-#Mon Mar 16 15:06:33 IST 2026
+#Tue Mar 17 06:39:15 IST 2026

package/android/build/intermediates/java_res/debug/processDebugJavaRes/out/META-INF/services/com.dashx.android.DashXLibraryInfoProvider

@@ -0,0 +1 @@
+com.dashx.rn.sdk.ReactNativeLibraryInfoProvider

package/android/build/kotlin/compileDebugKotlin/cacheable/caches-jvm/lookups/counters.tab

@@ -1,2 +1,2 @@
-3
+4
 0

package/android/build.gradle

@@ -48,10 +48,9 @@ repositories {
 }
 
 dependencies {
-    implementation "org.jetbrains.kotlin:kotlin-stdlib-jdk7"
-    implementation 'com.facebook.react:react-native:+'
+    compileOnly 'com.facebook.react:react-android:+'
     implementation 'com.google.code.gson:gson:2.9.0'
-    implementation 'org.jetbrains.kotlinx:kotlinx-serialization-json:1.5.0'
+    implementation 'org.jetbrains.kotlinx:kotlinx-serialization-json:1.9.0'
 
-    implementation "com.dashx:dashx-android:1.1.2"
+    implementation "com.dashx:dashx-android:1.1.3"
 }

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

@@ -1,6 +1,5 @@
 package com.dashx.rn.sdk
 
-import android.net.Uri
 import com.dashx.rn.sdk.util.*
 import com.dashx.android.DashX
 import com.dashx.android.DashXLog
@@ -37,7 +36,9 @@ class DashXReactNativeModule(private val reactContext: ReactApplicationContext)
     @ReactMethod
     fun identify(options: ReadableMap?) {
         val optionsHashMap = options?.toHashMap()
-        DashX.identify(optionsHashMap as HashMap<String, String>?)
+            ?.filterValues { it != null }
+            ?.mapValues { it.value.toString() }
+        DashX.identify(optionsHashMap?.let { HashMap(it) })
     }
 
     @ReactMethod
@@ -53,7 +54,10 @@ class DashXReactNativeModule(private val reactContext: ReactApplicationContext)
     @ReactMethod
     fun track(event: String, data: ReadableMap?) {
         val jsonData = try {
-            data?.toHashMap() as HashMap<String, String>?
+            data?.toHashMap()
+                ?.filterValues { it != null }
+                ?.mapValues { it.value.toString() }
+                ?.let { HashMap(it) }
         } catch (e: Exception) {
             DashXLog.d(tag, e.message)
             return
@@ -64,7 +68,12 @@ class DashXReactNativeModule(private val reactContext: ReactApplicationContext)
 
     @ReactMethod
     fun screen(screenName: String, data: ReadableMap?) {
-        DashX.screen(screenName, data?.toHashMap() as HashMap<String, String>)
+        val screenData = data?.toHashMap()
+            ?.filterValues { it != null }
+            ?.mapValues { it.value.toString() }
+            ?.let { HashMap(it) }
+            ?: HashMap()
+        DashX.screen(screenName, screenData)
     }
 
     @ReactMethod

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

@@ -0,0 +1,8 @@
+package com.dashx.rn.sdk
+
+import com.dashx.android.DashXLibraryInfoProvider
+
+class ReactNativeLibraryInfoProvider : DashXLibraryInfoProvider {
+    override val name = "@dashx/react-native"
+    override val version: String = BuildConfig.VERSION_NAME
+}

package/android/src/main/resources/META-INF/services/com.dashx.android.DashXLibraryInfoProvider

@@ -0,0 +1 @@
+com.dashx.rn.sdk.ReactNativeLibraryInfoProvider

package/index.d.ts

@@ -0,0 +1,92 @@
+import { EmitterSubscription } from 'react-native';
+
+export interface ConfigureOptions {
+  publicKey: string;
+  baseURI?: string;
+  targetEnvironment?: string;
+}
+
+export interface IdentifyOptions {
+  firstName?: string;
+  lastName?: string;
+  email?: string;
+  phone?: string;
+  [key: string]: string | undefined;
+}
+
+export type LogLevel = 0 | 1 | 2;
+
+export interface NotificationMessage {
+  [key: string]: unknown;
+}
+
+export interface DashXInstance {
+  /**
+   * Initialize the SDK with your public key and optional configuration.
+   * Call this as early as possible, e.g. in your root component.
+   */
+  configure(options: ConfigureOptions): void;
+
+  /**
+   * Identify the current user with traits such as name and email.
+   */
+  identify(options: IdentifyOptions): void;
+
+  /**
+   * Set user identity using a UID and authentication token.
+   */
+  setIdentity(uid: string, token: string): void;
+
+  /**
+   * Clear the current user identity and reset SDK state.
+   */
+  reset(): void;
+
+  /**
+   * Track a named event with optional metadata.
+   */
+  track(event: string, data?: Record<string, unknown>): void;
+
+  /**
+   * Track a screen view with optional metadata.
+   */
+  screen(screenName: string, data?: Record<string, unknown>): void;
+
+  /**
+   * Subscribe the current device to push notifications.
+   */
+  subscribe(): void;
+
+  /**
+   * Unsubscribe the current device from push notifications.
+   */
+  unsubscribe(): void;
+
+  /**
+   * Fetch stored notification preferences for the current user.
+   */
+  fetchStoredPreferences(): Promise<Record<string, unknown>>;
+
+  /**
+   * Save notification preferences for the current user.
+   */
+  saveStoredPreferences(
+    data: Record<string, unknown>
+  ): Promise<Record<string, unknown>>;
+
+  /**
+   * Set SDK log verbosity. 0 = off, 1 = errors, 2 = debug.
+   */
+  setLogLevel(level: LogLevel): void;
+
+  /**
+   * Register a listener for incoming push notification messages.
+   * Returns a subscription that can be removed via `.remove()`.
+   */
+  onMessageReceived(
+    callback: (message: NotificationMessage) => void
+  ): EmitterSubscription;
+}
+
+declare const DashX: DashXInstance;
+export default DashX;

package/index.js

@@ -1,78 +1,119 @@
-import { NativeModules, Platform } from 'react-native';
-
-const LINKING_ERROR =
-  `The package 'dashx-react-native' doesn't seem to be linked. Make sure: \n\n` +
-  Platform.select({ ios: "- You have run 'pod install'\n", default: '' }) +
-  '- You rebuilt the app after installing the package\n' +
-  '- You are not using Expo Go\n';
-
-const DashX = NativeModules.DashXReactNative
-  ? NativeModules.DashXReactNative
-  : new Proxy(
-    {},
-    {
-      get() {
-        throw new Error(LINKING_ERROR);
-      },
-    }
+import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
+
+function getLinkingError() {
+  return (
+    `The package 'dashx-react-native' doesn't seem to be linked. Make sure: \n\n` +
+    Platform.select({ ios: "- You have run 'pod install'\n", default: '' }) +
+    '- You rebuilt the app after installing the package\n' +
+    '- You are not using Expo Go\n'
   );
+}
 
-const {
-  configure,
-  identify,
-  setIdentity,
-  reset,
-  track,
-  screen,
-  fetchStoredPreferences,
-  saveStoredPreferences,
-  subscribe,
-  unsubscribe,
-  setLogLevel,
-} = DashX;
-
-DashX.configure = (options) => {
-  return configure(options);
+let _nativeDashX = null;
+function getNativeDashX() {
+  if (!_nativeDashX) {
+    _nativeDashX = NativeModules.DashXReactNative
+      ? NativeModules.DashXReactNative
+      : new Proxy(
+          {},
+          {
+            get() {
+              throw new Error(getLinkingError());
+            },
+          }
+        );
+  }
+  return _nativeDashX;
 }
 
-DashX.identify = (options) => {
-  return identify(options);
-};
+let _eventEmitter = null;
+function getEventEmitter() {
+  if (!_eventEmitter) {
+    _eventEmitter = new NativeEventEmitter(getNativeDashX());
+  }
+  return _eventEmitter;
+}
 
-DashX.setIdentity = (uid, token) => {
-  return setIdentity(uid, token);
-};
+const DashX = {
+  configure(options) {
+    if (!options || typeof options !== 'object') {
+      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');
+    }
+    return getNativeDashX().configure(options);
+  },
 
-DashX.reset = () => {
-  return reset();
-}
+  identify(options) {
+    if (!options || typeof options !== 'object') {
+      throw new Error('DashX.identify: options must be an object');
+    }
+    return getNativeDashX().identify(options);
+  },
 
-DashX.track = (event, data) => {
-  return track(event, data || null);
-}
+  setIdentity(uid, token) {
+    if (!uid || typeof uid !== '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');
+    }
+    return getNativeDashX().setIdentity(uid, token);
+  },
 
-DashX.screen = (screenName, data) => {
-  return screen(screenName, data || null)
-}
+  reset() {
+    return getNativeDashX().reset();
+  },
 
-DashX.fetchStoredPreferences = () => {
-  return fetchStoredPreferences();
-};
+  track(event, data) {
+    if (!event || typeof event !== 'string') {
+      throw new Error('DashX.track: event is required and must be a string');
+    }
+    return getNativeDashX().track(event, data || null);
+  },
 
-DashX.saveStoredPreferences = (preferenceData) => {
-  return saveStoredPreferences(preferenceData);
-};
+  screen(screenName, data) {
+    if (!screenName || typeof screenName !== 'string') {
+      throw new Error('DashX.screen: screenName is required and must be a string');
+    }
+    return getNativeDashX().screen(screenName, data || null);
+  },
 
-DashX.subscribe = () => {
-  return subscribe();
-}
+  fetchStoredPreferences() {
+    return getNativeDashX().fetchStoredPreferences();
+  },
 
-DashX.unsubscribe = () => {
-  return unsubscribe();
-}
+  saveStoredPreferences(preferenceData) {
+    if (!preferenceData || typeof preferenceData !== 'object') {
+      throw new Error(
+        'DashX.saveStoredPreferences: preferenceData is required and must be an object'
+      );
+    }
+    return getNativeDashX().saveStoredPreferences(preferenceData);
+  },
 
-DashX.setLogLevel = (level) => {
-  return setLogLevel(level);
-}
+  subscribe() {
+    return getNativeDashX().subscribe();
+  },
+
+  unsubscribe() {
+    return getNativeDashX().unsubscribe();
+  },
+
+  setLogLevel(level) {
+    if (typeof level !== 'number') {
+      throw new Error('DashX.setLogLevel: level must be a number');
+    }
+    return getNativeDashX().setLogLevel(level);
+  },
+
+  onMessageReceived(callback) {
+    if (typeof callback !== 'function') {
+      throw new Error('DashX.onMessageReceived: callback must be a function');
+    }
+    return getEventEmitter().addListener('messageReceived', callback);
+  },
+};
 
 export default DashX;