@dashx/react-native 1.1.0 → 1.1.2

package/README.md

@@ -161,16 +161,25 @@ import DashX from '@dashx/react-native';
 
 ### Configure
 
-Initialize the SDK as early as possible (e.g. in your root component or `App.js`):
+Initialize the SDK once at app startup. Call `configure` at the top level of your entry file (e.g. `App.js`) so it runs before any component mounts:
 
 ```js
+// App.js — call at module level, before the component
+import DashX from '@dashx/react-native';
+
 DashX.configure({
   publicKey: 'your-public-key',
   // baseURI: 'https://api.dashx.com',       // optional, custom API endpoint
   // targetEnvironment: 'production',         // optional
 });
+
+export default function App() {
+  // ...
+}
 ```
 
+Calling from `useEffect` in your root component also works, but module-level init is preferred so the SDK is ready as early as possible.
+
 | Option | Type | Required | Description |
 |--------|------|----------|-------------|
 | `publicKey` | `string` | Yes | Your DashX public key |
@@ -218,6 +227,51 @@ DashX.screen('HomeScreen', {
 });
 ```
 
+### Fetch a record
+
+Fetch a single record by URN (e.g. `"article/123"`) with optional options (matches [dashx-android](https://github.com/dashxhq/dashx-android) `fetchRecord`). **Android only**; on iOS the promise rejects until the native SDK supports it.
+
+```js
+const record = await DashX.fetchRecord('article/123', {
+  preview: false,
+  language: 'en',
+  // fields, include, exclude as arrays of objects if needed
+});
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `preview` | `boolean` | Include draft/preview content |
+| `language` | `string` | Content language |
+| `fields` | `object[]` | Fields to return |
+| `include` | `object[]` | Related data to include |
+| `exclude` | `object[]` | Fields to exclude |
+
+### Search records
+
+Search records by resource with optional filter, order, limit, and other options (matches [dashx-android](https://github.com/dashxhq/dashx-android) `searchRecords`). **Android only**; on iOS the promise rejects until the native SDK supports it.
+
+```js
+const records = await DashX.searchRecords('article', {
+  filter: { status: 'published' },
+  order: [{ field: 'createdAt', direction: 'desc' }],
+  limit: 10,
+  preview: false,
+  language: 'en',
+});
+```
+
+| Option | Type | Description |
+|--------|------|-------------|
+| `filter` | `object` | Filter criteria |
+| `order` | `object[]` | Sort order (e.g. `[{ field, direction }]`) |
+| `limit` | `number` | Max records to return |
+| `preview` | `boolean` | Preview/draft content |
+| `language` | `string` | Content language |
+| `fields` | `object[]` | Fields to return |
+| `include` | `object[]` | Related data to include |
+| `exclude` | `object[]` | Fields to exclude |
+
 ### Push notifications
 
 Subscribe the current device to push notifications:
@@ -232,6 +286,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:
@@ -264,16 +334,15 @@ Below is a full example of integrating DashX in a React Native Android app:
 
 ```js
 // App.js
-import React, { useEffect } from 'react';
+import React 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();
-  }, []);
+// Initialize once at app load
+DashX.configure({ publicKey: 'your-public-key' });
+DashX.subscribe();
 
+export default function App() {
   const handleLogin = () => {
     DashX.setIdentity('user-123', 'auth-token');
     DashX.identify({
@@ -318,11 +387,14 @@ const styles = StyleSheet.create({
 | `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 |
+| `fetchRecord` | `(urn: string, options?: object)` | `Promise<object>` | Fetch a single record by URN (e.g. `"article/123"`). Options: preview, language, fields, include, exclude. Android only; iOS rejects until implemented. |
+| `searchRecords` | `(resource: string, options?: object)` | `Promise<object[]>` | Search records (filter, order, limit, preview, language, fields, include, exclude). Android only; iOS rejects until implemented. |
 | `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).
 

package/android/.gitignore

@@ -0,0 +1,10 @@
+# Build outputs
+build/
+
+# Gradle
+.gradle/
+local.properties
+
+# IDE
+.idea/
+*.iml

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

@@ -1,7 +1,23 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
     package="com.dashx.rn.sdk" >
 
     <uses-sdk android:minSdkVersion="26" />
 
+    <application>
+
+        <!-- Replace dashx-android's FCM service with our subclass that also emits to JS. -->
+        <service
+            android:name="com.dashx.android.DashXFirebaseMessagingService"
+            tools:node="remove" />
+        <service
+            android:name="com.dashx.rn.sdk.DashXReactNativeFirebaseMessagingService"
+            android:exported="false" >
+            <intent-filter>
+                <action android:name="com.google.firebase.MESSAGING_EVENT" />
+            </intent-filter>
+        </service>
+    </application>
+
 </manifest>

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/intermediates/manifest_merge_blame_file/debug/processDebugManifest/manifest-merger-blame-debug-report.txt

@@ -1,7 +1,33 @@
 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>
+3    xmlns:tools="http://schemas.android.com/tools"
+4    package="com.dashx.rn.sdk" >
+5
+6    <uses-sdk android:minSdkVersion="26" />
+7
+8    <application>
+8-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:3:5-15:19
+9
+10        <!-- Replace dashx-android's FCM service with our subclass that also emits to JS. -->
+11        <service
+11-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:5:9-7:35
+12            android:name="com.dashx.android.DashXFirebaseMessagingService"
+12-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:6:13-75
+13            tools:node="remove" />
+13-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:7:13-32
+14        <service
+14-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:8:9-14:19
+15            android:name="com.dashx.rn.sdk.DashXReactNativeFirebaseMessagingService"
+15-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:9:13-85
+16            android:exported="false" >
+16-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:10:13-37
+17            <intent-filter>
+17-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:11:13-13:29
+18                <action android:name="com.google.firebase.MESSAGING_EVENT" />
+18-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:12:17-78
+18-->/Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:12:25-75
+19            </intent-filter>
+20        </service>
+21    </application>
+22
+23</manifest>

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

@@ -1,7 +1,23 @@
 <?xml version="1.0" encoding="utf-8"?>
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools"
     package="com.dashx.rn.sdk" >
 
     <uses-sdk android:minSdkVersion="26" />
 
+    <application>
+
+        <!-- Replace dashx-android's FCM service with our subclass that also emits to JS. -->
+        <service
+            android:name="com.dashx.android.DashXFirebaseMessagingService"
+            tools:node="remove" />
+        <service
+            android:name="com.dashx.rn.sdk.DashXReactNativeFirebaseMessagingService"
+            android:exported="false" >
+            <intent-filter>
+                <action android:name="com.google.firebase.MESSAGING_EVENT" />
+            </intent-filter>
+        </service>
+    </application>
+
 </manifest>

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

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

package/android/build/outputs/logs/manifest-merger-debug-report.txt

@@ -1,11 +1,33 @@
 -- Merging decision tree log ---
 manifest
-ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:2:1-4:12
-INJECTED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:2:1-4:12
+ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:1:1-16:12
+INJECTED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:1:1-16:12
 	package
 		INJECTED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml
+	xmlns:tools
+		ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:2:5-51
 	xmlns:android
-		ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:2:11-69
+		ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:1:11-69
+application
+ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:3:5-15:19
+service#com.dashx.android.DashXFirebaseMessagingService
+ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:5:9-7:35
+	tools:node
+		ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:7:13-32
+	android:name
+		ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:6:13-75
+service#com.dashx.rn.sdk.DashXReactNativeFirebaseMessagingService
+ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:8:9-14:19
+	android:exported
+		ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:10:13-37
+	android:name
+		ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:9:13-85
+intent-filter#action:name:com.google.firebase.MESSAGING_EVENT
+ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:11:13-13:29
+action#com.google.firebase.MESSAGING_EVENT
+ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:12:17-78
+	android:name
+		ADDED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml:12:25-75
 uses-sdk
 INJECTED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml reason: use-sdk injection requested
 INJECTED from /Users/gulshan/Work/dashx-demo-rn/node_modules/@dashx/react-native/android/src/main/AndroidManifest.xml

package/android/build.gradle

@@ -48,10 +48,12 @@ 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"
+    // 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"
 }

package/android/src/main/AndroidManifest.xml

@@ -1,4 +1,16 @@
-
-<manifest xmlns:android="http://schemas.android.com/apk/res/android">
-
+<manifest xmlns:android="http://schemas.android.com/apk/res/android"
+    xmlns:tools="http://schemas.android.com/tools">
+    <application>
+        <!-- Replace dashx-android's FCM service with our subclass that also emits to JS. -->
+        <service
+            android:name="com.dashx.android.DashXFirebaseMessagingService"
+            tools:node="remove" />
+        <service
+            android:name="com.dashx.rn.sdk.DashXReactNativeFirebaseMessagingService"
+            android:exported="false">
+            <intent-filter>
+                <action android:name="com.google.firebase.MESSAGING_EVENT" />
+            </intent-filter>
+        </service>
+    </application>
 </manifest>