@dashx/react-native 1.0.8 → 1.1.1

package/.gitattributes

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

package/.gitignore

@@ -0,0 +1,46 @@
+
+# OSX
+#
+.DS_Store
+
+# node.js
+#
+node_modules/
+npm-debug.log
+yarn-error.log
+
+# Xcode
+#
+build/
+*.pbxuser
+!default.pbxuser
+*.mode1v3
+!default.mode1v3
+*.mode2v3
+!default.mode2v3
+*.perspectivev3
+!default.perspectivev3
+xcuserdata
+*.xccheckout
+*.moved-aside
+DerivedData
+*.hmap
+*.ipa
+*.xcuserstate
+project.xcworkspace
+
+# Android/IntelliJ
+#
+build/
+.idea
+.gradle
+local.properties
+*.iml
+
+# BUCK
+buck-out/
+\.buckd/
+*.keystore
+
+# VS Code
+.vscode/

package/.nvmrc

@@ -0,0 +1 @@
+v24

package/README.md

@@ -20,62 +20,123 @@
 
 # @dashx/react-native
 
+[![npm version](https://img.shields.io/npm/v/@dashx/react-native.svg)](https://www.npmjs.com/package/@dashx/react-native)
+[![license](https://img.shields.io/npm/l/@dashx/react-native.svg)](https://github.com/dashxhq/dashx-react-native/blob/main/LICENSE)
+[![platforms](https://img.shields.io/badge/platforms-Android%20%7C%20iOS-brightgreen.svg)](#requirements)
+
 _DashX SDK for React Native_
 
+## Requirements
+
+| Platform | Minimum Version |
+|----------|----------------|
+| iOS | 12.0+ |
+| Android | SDK 26 (Android 8.0)+ |
+| React Native | 0.71+ |
+| Node.js | 16.0+ |
+
+> **Note:** This SDK uses native modules and is **not compatible with Expo Go**. Use a [development build](https://docs.expo.dev/develop/development-builds/introduction/) if you are using Expo.
+
 ## Install
 
-**npm**
 ```sh
 npm install @dashx/react-native
 ```
 
-**yarn**
+or
+
 ```sh
 yarn add @dashx/react-native
 ```
 
 ### Setup for Android
 
-DashX requires Google Services installed in your app for Firebase to work:
+DashX requires Google Services for Firebase Cloud Messaging:
 
-- Add `google-services` plugin in your `/android/build.gradle`
+1. Add the `google-services` plugin in your `/android/build.gradle`:
 
 ```gradle
 buildscript {
   dependencies {
     // ... other dependencies
-    classpath 'com.google.gms:google-services:4.3.3'
+    classpath 'com.google.gms:google-services:4.4.2'
   }
 }
 ```
 
-- Add this line in your `/android/app/build.gradle`
+2. Apply the plugin in your `/android/app/build.gradle`:
 
 ```gradle
 apply plugin: 'com.google.gms.google-services'
 ```
 
-- Add your Android app on Firebase Console: `Project Overview > Add App > Android`
-
-- Download `google-services.json` from there.
+3. Add your Android app on [Firebase Console](https://console.firebase.google.com/): **Project Overview > Add App > Android**
 
-- Add `google-services.json` at the following location: `/android/app/google-services.json`
+4. Download `google-services.json` and place it at `/android/app/google-services.json`
 
 ### Setup for iOS
 
-- At the top of the file `/ios/{projectName}/AppDelegate.m` before [#if defined(FB_SONARKIT_ENABLED)](https://github.com/react-native-camera/react-native-camera/issues/3008#issuecomment-726432198), import Firebase:
+1. Add Firebase pods to your `Podfile`:
+
+```ruby
+pod 'FirebaseMessaging', :modular_headers => true
+```
+
+2. Run pod install:
+
+```sh
+cd ios && pod install
+```
+
+3. Add your iOS app on [Firebase Console](https://console.firebase.google.com/): **Project Overview > Add App > iOS**
+
+4. Download `GoogleService-Info.plist` and add it to your Xcode project (right-click project > **Add Files**, ensure **Copy items if needed** is checked).
+
+#### Option A: Using `DashXRCTAppDelegate` (Recommended)
+
+The SDK ships a `DashXRCTAppDelegate` class that handles Firebase configuration, FCM token management, and push notification display out of the box. Subclass it in your `AppDelegate`:
+
+```swift
+import DashXReactNative
+
+@main
+class AppDelegate: DashXRCTAppDelegate {
+  override func sourceURL(for bridge: RCTBridge) -> URL? {
+    bundleURL()
+  }
+
+  override func bundleURL() -> URL? {
+    #if DEBUG
+    RCTBundleURLProvider.sharedSettings().jsBundleURL(forBundleRoot: "index")
+    #else
+    Bundle.main.url(forResource: "main", withExtension: "jsbundle")
+    #endif
+  }
+
+  // Called when a notification is tapped
+  override func notificationClicked(message: [AnyHashable: Any], actionIdentifier: String) {
+    // Handle notification tap
+  }
+
+  // Called when a notification arrives while the app is in the foreground
+  override func notificationDeliveredInForeground(message: [AnyHashable: Any]) -> UNNotificationPresentationOptions {
+    return [.banner, .sound]
+  }
+}
+```
+
+#### Option B: Manual setup in AppDelegate
+
+If you prefer manual control, import Firebase at the top of `/ios/{projectName}/AppDelegate.m`:
 
 ```objective-c
 #import <FirebaseCore/FirebaseCore.h>
 #import <FirebaseMessaging/FirebaseMessaging.h>
 ```
 
-- In the same file, inside your `didFinishLaunchingWithOptions` add this:
+Then inside `didFinishLaunchingWithOptions`:
 
 ```objective-c
-// Register for remote notifications. This shows a permission dialog on first run, to
-// show the dialog at a more appropriate time move this registration accordingly.
-// [START register_for_notifications]
 [UNUserNotificationCenter currentNotificationCenter].delegate = self;
 UNAuthorizationOptions authOptions = UNAuthorizationOptionAlert | UNAuthorizationOptionSound | UNAuthorizationOptionBadge;
 [[UNUserNotificationCenter currentNotificationCenter]
@@ -84,55 +145,223 @@ UNAuthorizationOptions authOptions = UNAuthorizationOptionAlert | UNAuthorizatio
 }];
 
 [application registerForRemoteNotifications];
-// [END register_for_notifications]
 
-// [START configure_firebase]
 if ([FIRApp defaultApp] == nil) {
   [FIRApp configure];
 }
-// [END configure_firebase]
 
-// [START set_messaging_delegate]
 [FIRMessaging messaging].delegate = self;
-// [END set_messaging_delegate]
 ```
 
-- In your `Podfile` add this:
+## Usage
 
-```ruby
-pod 'FirebaseMessaging', :modular_headers => true
+```js
+import DashX from '@dashx/react-native';
 ```
 
-- Add your iOS app on Firebase Console: `Project Overview > Add App > iOS`
+### Configure
 
-- Download `GoogleService-Info.plist`
+Initialize the SDK as early as possible (e.g. in your root component or `App.js`):
 
-- Add `GoogleService-Info.plist` using XCode by right clicking on project and select `Add Files`, select your downloaded file and make sure `Copy items if needed` is checked.
+```js
+DashX.configure({
+  publicKey: 'your-public-key',
+  // baseURI: 'https://api.dashx.com',       // optional, custom API endpoint
+  // targetEnvironment: 'production',         // optional
+});
+```
 
-## Usage
+| Option | Type | Required | Description |
+|--------|------|----------|-------------|
+| `publicKey` | `string` | Yes | Your DashX public key |
+| `baseURI` | `string` | No | Custom API base URI |
+| `targetEnvironment` | `string` | No | Target environment name |
 
-For detailed usage, refer to the [documentation](https://docs.dashx.com/developer).
+### Identify a user
 
-## Contributing
+```js
+DashX.identify({
+  firstName: 'John',
+  lastName: 'Doe',
+  email: 'john@example.com',
+});
+```
 
-Please follow [these steps](https://github.com/dashxhq/dashx-js/tree/master/examples/react-native#setting-up-development-environment) to set-up development environment.
+### Set identity with token
 
-You'll also need Apollo CLI to generate files.
+```js
+DashX.setIdentity('user-uid', 'user-token');
+```
 
-```sh
-$ npm i -g apollo
+### Reset
+
+Clear the current identity:
+
+```js
+DashX.reset();
 ```
 
-For the next steps, please follow the guide for the respective platform:
+### Track events
 
-- [Android](android/README.md)
-- [iOS](ios/README.md)
+```js
+DashX.track('Item Purchased', {
+  itemId: 'sku-123',
+  price: 9.99,
+});
+```
+
+### Track screen views
+
+```js
+DashX.screen('HomeScreen', {
+  referrer: 'DeepLink',
+});
+```
+
+### Push notifications
+
+Subscribe the current device to push notifications:
+
+```js
+DashX.subscribe();
+```
+
+Unsubscribe:
+
+```js
+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:
+
+```js
+const preferences = await DashX.fetchStoredPreferences();
+console.log(preferences);
+```
+
+Save updated preferences:
+
+```js
+await DashX.saveStoredPreferences({
+  marketing_emails: true,
+  product_updates: false,
+});
+```
+
+### Logging
+
+Set the SDK log level for debugging:
+
+```js
+DashX.setLogLevel(1); // 0 = off, 1 = errors, 2 = debug
+```
+
+### Android example
+
+Below is a full example of integrating DashX in a React Native Android app:
+
+```js
+// App.js
+import React, { useEffect } from 'react';
+import { View, Text, Button, StyleSheet } from 'react-native';
+import DashX from '@dashx/react-native';
+
+export default function App() {
+  useEffect(() => {
+    DashX.configure({ publicKey: 'your-public-key' });
+    DashX.subscribe();
+  }, []);
+
+  const handleLogin = () => {
+    DashX.setIdentity('user-123', 'auth-token');
+    DashX.identify({
+      firstName: 'Jane',
+      lastName: 'Doe',
+      email: 'jane@example.com',
+    });
+  };
+
+  const handleTrack = () => {
+    DashX.track('Button Pressed', { screen: 'Home' });
+  };
+
+  const handleLogout = () => {
+    DashX.unsubscribe();
+    DashX.reset();
+  };
+
+  return (
+    <View style={styles.container}>
+      <Text style={styles.title}>DashX React Native Demo</Text>
+      <Button title="Login" onPress={handleLogin} />
+      <Button title="Track Event" onPress={handleTrack} />
+      <Button title="Logout" onPress={handleLogout} />
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  container: { flex: 1, justifyContent: 'center', alignItems: 'center' },
+  title: { fontSize: 24, marginBottom: 20 },
+});
+```
+
+## API Reference
+
+| Method | Signature | Returns | Description |
+|--------|-----------|---------|-------------|
+| `configure` | `(options: object)` | `void` | Initialize the SDK with your public key |
+| `identify` | `(options: object)` | `void` | Identify the current user with traits |
+| `setIdentity` | `(uid: string, token: string)` | `void` | Set user identity with UID and auth token |
+| `reset` | `()` | `void` | Clear the current user identity |
+| `track` | `(event: string, data?: object)` | `void` | Track a named event with optional data |
+| `screen` | `(screenName: string, data?: object)` | `void` | Track a screen view with optional data |
+| `subscribe` | `()` | `void` | Subscribe device for push notifications |
+| `unsubscribe` | `()` | `void` | Unsubscribe device from push notifications |
+| `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).
+
+## Contributing
+
+Please follow [these steps](https://github.com/dashxhq/dashx-js/tree/master/examples/react-native#setting-up-development-environment) to set up the development environment.
+
+You'll also need Apollo CLI to generate files:
+
+```sh
+npm i -g apollo
+```
 
 ## Publishing
 
-Simply use `yarn publish` to bump the version & release. Once done, push the commit that yarn adds to GitHub:
+Use `yarn publish` to bump the version and release, then push the commit:
 
 ```sh
-$ yarn publish
-$ git push origin main
+yarn publish
+git push origin main
 ```
+
+## License
+
+MIT

package/android/build/.transforms/9dceace6c3787533d2dbb1a387e9284c/results.bin

@@ -0,0 +1 @@
+o/bundleLibRuntimeToDirDebug

package/android/build/.transforms/f3c6049e7ab4bb564c79f3a246b8575e/results.bin

@@ -0,0 +1 @@
+o/classes

package/android/build/generated/source/buildConfig/debug/com/dashx/rn/sdk/BuildConfig.java

@@ -0,0 +1,12 @@
+/**
+ * Automatically generated file. DO NOT MODIFY
+ */
+package com.dashx.rn.sdk;
+
+public final class BuildConfig {
+  public static final boolean DEBUG = Boolean.parseBoolean("true");
+  public static final String LIBRARY_PACKAGE_NAME = "com.dashx.rn.sdk";
+  public static final String BUILD_TYPE = "debug";
+  // Field from default config.
+  public static final String VERSION_NAME = "0.0.1";
+}

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.dashx.rn.sdk" >
+
+    <uses-sdk android:minSdkVersion="26" />
+
+</manifest>

package/android/build/intermediates/aapt_friendly_merged_manifests/debug/processDebugManifest/aapt/output-metadata.json

@@ -0,0 +1,18 @@
+{
+  "version": 3,
+  "artifactType": {
+    "type": "AAPT_FRIENDLY_MERGED_MANIFESTS",
+    "kind": "Directory"
+  },
+  "applicationId": "com.dashx.rn.sdk",
+  "variantName": "debug",
+  "elements": [
+    {
+      "type": "SINGLE",
+      "filters": [],
+      "attributes": [],
+      "outputFile": "AndroidManifest.xml"
+    }
+  ],
+  "elementType": "File"
+}

package/android/build/intermediates/aar_metadata/debug/writeDebugAarMetadata/aar-metadata.properties

@@ -0,0 +1,6 @@
+aarFormatVersion=1.0
+aarMetadataVersion=1.0
+minCompileSdk=1
+minCompileSdkExtension=0
+minAndroidGradlePluginVersion=1.0.0
+coreLibraryDesugaringEnabled=false

package/android/build/intermediates/annotation_processor_list/debug/javaPreCompileDebug/annotationProcessors.json

@@ -0,0 +1 @@
+{}

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

@@ -0,0 +1 @@
+#Tue Mar 17 06:39:15 IST 2026

package/android/build/intermediates/incremental/debug/packageDebugResources/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="main" generated-set="main$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="debug" generated-set="debug$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/debug/res"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated$Generated" generated="true" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/build/generated/res/resValues/debug"/></dataSet><dataSet aapt-namespace="http://schemas.android.com/apk/res-auto" config="generated" generated-set="generated$Generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/build/generated/res/resValues/debug"/></dataSet><mergedItems/></merger>

package/android/build/intermediates/incremental/mergeDebugAssets/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/assets"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/debug/assets"/></dataSet><dataSet config="generated" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/build/intermediates/shader_assets/debug/compileDebugShaders/out"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugJniLibFolders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/jniLibs"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/debug/jniLibs"/></dataSet></merger>

package/android/build/intermediates/incremental/mergeDebugShaders/merger.xml

@@ -0,0 +1,2 @@
+<?xml version="1.0" encoding="utf-8"?>
+<merger version="3"><dataSet config="main" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/shaders"/></dataSet><dataSet config="debug" ignore_pattern="!.svn:!.git:!.ds_store:!*.scc:.*:&lt;dir>_*:!CVS:!thumbs.db:!picasa.ini:!*~"><source path="/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/debug/shaders"/></dataSet></merger>

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/intermediates/local_only_symbol_list/debug/parseDebugLocalResources/R-def.txt

@@ -0,0 +1,2 @@
+R_DEF: Internal format may change without notice
+local

package/android/build/intermediates/manifest_merge_blame_file/debug/processDebugManifest/manifest-merger-blame-debug-report.txt

@@ -0,0 +1,7 @@
+1<?xml version="1.0" encoding="utf-8"?>
+2<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+3    package="com.dashx.rn.sdk" >
+4
+5    <uses-sdk android:minSdkVersion="26" />
+6
+7</manifest>

package/android/build/intermediates/merged_manifest/debug/processDebugManifest/AndroidManifest.xml

@@ -0,0 +1,7 @@
+<?xml version="1.0" encoding="utf-8"?>
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    package="com.dashx.rn.sdk" >
+
+    <uses-sdk android:minSdkVersion="26" />
+
+</manifest>

package/android/build/intermediates/navigation_json/debug/extractDeepLinksDebug/navigation.json

@@ -0,0 +1 @@
+[]

package/android/build/intermediates/nested_resources_validation_report/debug/generateDebugResources/nestedResourcesValidationReport.txt

@@ -0,0 +1 @@
+0 Warning/Error

package/android/build/intermediates/symbol_list_with_package_name/debug/generateDebugRFile/package-aware-r.txt

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