@attentive-mobile/attentive-react-native-sdk 2.0.0-beta.4 → 2.0.0-beta.5

package/README.md

@@ -169,11 +169,148 @@ Attentive.identify({phone: '+15556667777'};)
 //   phone: '+15556667777'
 ```
 
-### Push Notifications (iOS Only)
+### Push Notifications (iOS and Android)
 
-The SDK supports push notification integration for iOS. Android support is planned for a future release.
+The SDK supports push notification integration on both iOS (APNs) and Android (runtime permission + optional FCM). The following sections cover iOS-specific flows and a full **App events on Android** implementation that mirrors the behavior of the [Bonni](https://github.com/attentive-mobile/attentive-react-native-sdk/tree/main/Bonni) example app.
 
-#### Request Push Permission
+---
+
+### App Events on Android
+
+This section describes how to implement Attentive app events on Android so they behave like the iOS flow: **regular app opens** (launch and resume from background) and **notification permission** are handled using the SDK’s native Android APIs. You can add FCM token registration and push open handling when your app uses Firebase Cloud Messaging.
+
+| SDK method | Purpose on Android |
+|------------|--------------------|
+| `getPushAuthorizationStatus()` | Returns `authorized`, `denied`, or `notDetermined` (uses `POST_NOTIFICATIONS` on API 33+). Use before `handleRegularOpen` so tracking uses the correct status. |
+| `registerForPushNotifications()` | Requests `POST_NOTIFICATIONS` on Android 13+; no-op on older versions. |
+| `handleRegularOpen(authStatus)` | Tracks a regular app open (launch or return to foreground). Call after `identify()` and pass the result of `getPushAuthorizationStatus()`. |
+| `registerDeviceToken` / `registerDeviceTokenWithCallback` | Optional. Register your FCM token when using Firebase Cloud Messaging. |
+| `handlePushOpen` / `handleForegroundPush` | Optional. Call when the user opens a notification or receives one in the foreground. |
+
+#### Overview
+
+- **Regular app open** – Call `handleRegularOpen(authorizationStatus)` when the app is opened (launch or returning to foreground). The SDK uses this for tracking and the `/mtctrl` endpoint.
+- **Permission status** – On Android 13+ (API 33+), notification permission is `POST_NOTIFICATIONS`. The SDK exposes `getPushAuthorizationStatus()` so you can pass the correct status into `handleRegularOpen`.
+- **Requesting permission** – Call `registerForPushNotifications()` to trigger the system permission dialog on Android 13+; it is a no-op on older versions.
+- **Order of operations** – Always call `identify()` before any `handleRegularOpen()` so the SDK has user context for network requests.
+
+#### Prerequisites
+
+1. **AndroidManifest** – Declare the notification permission for Android 13+:
+
+```xml
+<manifest xmlns:android="http://schemas.android.com/apk/res/android">
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
+    <!-- other permissions -->
+</manifest>
+```
+
+2. **Initialize and identify first** – In your app entry (e.g. root component `useEffect`), call `initialize(config)` and `identify(identifiers)` before any push or app-event logic.
+
+#### 1. On app launch (Android)
+
+Right after `identify()`, do the following for the Android path:
+
+1. Get the current notification authorization status with `getPushAuthorizationStatus()`.
+2. Call `handleRegularOpen(authStatus)` with that status.
+3. Optionally call `registerForPushNotifications()` to prompt for permission (Android 13+).
+
+```typescript
+import { Platform } from 'react-native';
+import {
+  initialize,
+  identify,
+  getPushAuthorizationStatus,
+  registerForPushNotifications,
+  handleRegularOpen,
+  type AttentiveSdkConfiguration,
+  type PushAuthorizationStatus,
+} from 'attentive-react-native-sdk';
+
+// Inside your root component (e.g. App.tsx useEffect):
+initialize(config);
+identify({ email: 'user@example.com', clientUserId: 'id-123' });
+
+if (Platform.OS === 'android') {
+  getPushAuthorizationStatus()
+    .then((authStatus: PushAuthorizationStatus) => {
+      handleRegularOpen(authStatus);
+    })
+    .catch(() => {
+      handleRegularOpen('authorized'); // fallback
+    });
+  registerForPushNotifications(); // Shows permission dialog on Android 13+
+}
+```
+
+#### 2. When app returns to foreground (Android)
+
+Subscribe to `AppState` and, when the app becomes `active`, get the current status and call `handleRegularOpen` again:
+
+```typescript
+import { AppState } from 'react-native';
+import { getPushAuthorizationStatus, handleRegularOpen } from 'attentive-react-native-sdk';
+import type { PushAuthorizationStatus } from 'attentive-react-native-sdk';
+
+const subscription = AppState.addEventListener('change', (nextAppState) => {
+  if (nextAppState === 'active' && Platform.OS === 'android') {
+    getPushAuthorizationStatus()
+      .then((authStatus: PushAuthorizationStatus) => {
+        handleRegularOpen(authStatus);
+      })
+      .catch(() => {
+        handleRegularOpen('authorized');
+      });
+  }
+});
+
+// Cleanup on unmount:
+return () => subscription.remove();
+```
+
+#### 3. Optional: Register FCM token (Android)
+
+If your app uses Firebase Cloud Messaging and you have an FCM token, register it with the Attentive backend and then call `handleRegularOpen` in the callback (same pattern as iOS):
+
+```typescript
+import { registerDeviceTokenWithCallback, handleRegularOpen } from 'attentive-react-native-sdk';
+
+// When you receive the FCM token (e.g. from Firebase Messaging):
+getPushAuthorizationStatus().then((authStatus) => {
+  registerDeviceTokenWithCallback(
+    fcmToken,
+    authStatus,
+    (data, url, response, error) => {
+      if (error) {
+        console.error('Attentive token registration failed', error);
+      }
+      handleRegularOpen(authStatus);
+    }
+  );
+});
+```
+
+#### 4. Optional: Handle notification opens and foreground (Android)
+
+If you handle FCM messages (e.g. with `@react-native-firebase/messaging`), you can report notification opens and foreground receives the same way as on iOS:
+
+- **User opened notification (background/inactive):** `handlePushOpen(payload, authorizationStatus)`
+- **Notification received while app in foreground:** `handleForegroundPush(payload, authorizationStatus)`
+
+Get `authorizationStatus` via `getPushAuthorizationStatus()` when handling the event.
+
+#### Complete Android flow (reference)
+
+The [Bonni](https://github.com/attentive-mobile/attentive-react-native-sdk/tree/main/Bonni) example app ([App.tsx](https://github.com/attentive-mobile/attentive-react-native-sdk/blob/main/Bonni/App.tsx)) implements the full flow:
+
+1. **Launch:** `initialize` → `identify` → (Android) `getPushAuthorizationStatus()` → `handleRegularOpen(authStatus)` → `registerForPushNotifications()`.
+2. **Foreground:** `AppState.addEventListener('change', …)` → when `active` and Android → `getPushAuthorizationStatus()` → `handleRegularOpen(authStatus)`.
+3. **Optional:** When FCM token is available → `registerDeviceTokenWithCallback(token, authStatus, callback)` → in callback call `handleRegularOpen(authStatus)`.
+4. **Optional:** When user opens a notification or receives one in foreground → `handlePushOpen` / `handleForegroundPush` with payload and status from `getPushAuthorizationStatus()`.
+
+---
+
+#### Request Push Permission (iOS)
 
 ```typescript
 import { registerForPushNotifications } from 'attentive-react-native-sdk';
@@ -183,9 +320,9 @@ import { registerForPushNotifications } from 'attentive-react-native-sdk';
 registerForPushNotifications();
 ```
 
-#### Register Device Token
+#### Register Device Token (iOS: APNs / Android: FCM)
 
-When your app receives a device token from APNs, register it with the Attentive backend:
+When your app receives a device token (APNs on iOS, FCM on Android), register it with the Attentive backend:
 
 ```typescript
 import { registerDeviceToken } from 'attentive-react-native-sdk';
@@ -202,7 +339,7 @@ The `authorizationStatus` parameter should be one of:
 - `'provisional'` - Provisional authorization (quiet notifications)
 - `'ephemeral'` - App Clip notifications
 
-#### Handle Push Notification Opens
+#### Handle Push Notification Opens (iOS and Android)
 
 When a user taps on a push notification, track the event:
 
@@ -218,7 +355,7 @@ handlePushOpened(
 );
 ```
 
-#### Handle Foreground Notifications
+#### Handle Foreground Notifications (iOS and Android)
 
 When a notification arrives while the app is in the foreground:
 
@@ -285,6 +422,4 @@ func application(
 - [Push Notifications Setup](./PUSH_NOTIFICATIONS_SETUP.md) - General push notification setup
 - [iOS Native SDK documentation](https://github.com/attentive-mobile/attentive-ios-sdk) - Native SDK reference
 
-#### Android Support
-
-Android push notification support is not yet implemented. The push notification methods will be no-ops on Android. FCM (Firebase Cloud Messaging) integration is planned for a future release.
+For a full Android implementation (app launch, foreground, permission, and optional FCM), see the **[App Events on Android](#app-events-on-android)** section above.

package/android/src/main/AndroidManifest.xml

@@ -1,4 +1,6 @@
 <manifest xmlns:android="http://schemas.android.com/apk/res/android"
           package="com.attentivereactnativesdk">
 
+    <!-- Required for push notification permission prompt on Android 13+ (API 33+) -->
+    <uses-permission android:name="android.permission.POST_NOTIFICATIONS" />
 </manifest>

package/android/src/main/kotlin/com/attentivereactnativesdk/AttentivePushHelper.kt

@@ -0,0 +1,93 @@
+package com.attentivereactnativesdk
+
+import android.app.Activity
+import android.content.Context
+import android.content.pm.PackageManager
+import android.os.Build
+import android.util.Log
+import androidx.core.app.ActivityCompat
+import androidx.core.content.ContextCompat
+
+/**
+ * Android push notification permission helper for the Attentive SDK.
+ *
+ * On Android 13+ (API 33+), push notifications require the runtime permission
+ * [android.permission.POST_NOTIFICATIONS]. On older versions, notifications
+ * are allowed by default (no runtime permission).
+ *
+ * This helper provides:
+ * - [getAuthorizationStatus] – current permission status for parity with iOS
+ * - [requestPermission] – request POST_NOTIFICATIONS when needed (used by registerForPushNotifications)
+ */
+object AttentivePushHelper {
+
+    private const val TAG = "AttentivePushHelper"
+
+    /**
+     * Authorization status values aligned with iOS push authorization for use in handleRegularOpen etc.
+     * - "authorized" – user has granted notification permission (or API < 33)
+     * - "denied" – user denied or permission not granted
+     * - "notDetermined" – not yet requested (API 33+ only)
+     */
+    const val STATUS_AUTHORIZED = "authorized"
+    const val STATUS_DENIED = "denied"
+    const val STATUS_NOT_DETERMINED = "notDetermined"
+
+    /**
+     * Returns the current push notification authorization status.
+     *
+     * On API 33+: uses [android.permission.POST_NOTIFICATIONS].
+     * On API < 33: returns [STATUS_AUTHORIZED] (no runtime permission required).
+     *
+     * @param context Application or Activity context
+     * @return One of [STATUS_AUTHORIZED], [STATUS_DENIED], or [STATUS_NOT_DETERMINED]
+     */
+    @JvmStatic
+    fun getAuthorizationStatus(context: Context): String {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
+            // API 32 and below: notification permission not required at runtime
+            return STATUS_AUTHORIZED
+        }
+        return when (ContextCompat.checkSelfPermission(context, android.Manifest.permission.POST_NOTIFICATIONS)) {
+            PackageManager.PERMISSION_GRANTED -> STATUS_AUTHORIZED
+            else -> {
+                // Not granted. Without an Activity we cannot distinguish "denied" vs "not yet asked".
+                // Return notDetermined so the app can call registerForPushNotifications to request.
+                STATUS_NOT_DETERMINED
+            }
+        }
+    }
+
+    /**
+     * Requests the push notification permission (POST_NOTIFICATIONS) if needed.
+     * Must be called from an [Activity] (e.g. [reactApplicationContext.currentActivity]).
+     *
+     * On API < 33 this is a no-op and returns immediately.
+     *
+     * @param activity Current activity (required for requestPermissions)
+     * @param requestCode Request code for [Activity.onRequestPermissionsResult]
+     * @return true if the permission request was started or already granted, false if activity is null or permission not applicable
+     */
+    @JvmStatic
+    fun requestPermissionIfNeeded(activity: Activity?, requestCode: Int): Boolean {
+        if (Build.VERSION.SDK_INT < Build.VERSION_CODES.TIRAMISU) {
+            Log.d(TAG, "requestPermissionIfNeeded: API < 33, no runtime permission needed")
+            return true
+        }
+        if (activity == null) {
+            Log.w(TAG, "requestPermissionIfNeeded: activity is null, cannot request permission")
+            return false
+        }
+        if (ContextCompat.checkSelfPermission(activity, android.Manifest.permission.POST_NOTIFICATIONS) == PackageManager.PERMISSION_GRANTED) {
+            Log.d(TAG, "requestPermissionIfNeeded: POST_NOTIFICATIONS already granted")
+            return true
+        }
+        Log.i(TAG, "requestPermissionIfNeeded: requesting POST_NOTIFICATIONS")
+        ActivityCompat.requestPermissions(
+            activity,
+            arrayOf(android.Manifest.permission.POST_NOTIFICATIONS),
+            requestCode
+        )
+        return true
+    }
+}

package/android/src/main/kotlin/com/attentivereactnativesdk/AttentiveReactNativeSdkModule.kt

@@ -35,6 +35,7 @@ class AttentiveReactNativeSdkModule(reactContext: ReactApplicationContext) :
     companion object {
         const val NAME = "AttentiveReactNativeSdk"
         private const val TAG = NAME
+        private const val PUSH_PERMISSION_REQUEST_CODE = 3901
     }
 
     private var attentiveConfig: AttentiveConfig? = null
@@ -241,7 +242,7 @@ class AttentiveReactNativeSdkModule(reactContext: ReactApplicationContext) :
     // ==========================================================================
     //
     // These methods provide Android push notification support.
-    // 
+    //
     // IMPORTANT NOTE: The Attentive Android SDK version 1.0.1 has limited push notification
     // support compared to version 2.x. These methods provide logging and debugging infrastructure
     // but may require SDK upgrade or custom implementation for full functionality.
@@ -252,24 +253,42 @@ class AttentiveReactNativeSdkModule(reactContext: ReactApplicationContext) :
     /**
      * Request push notification permission from the user.
      *
-     * Note: For Android 13+ (API 33+), you need to request POST_NOTIFICATIONS permission
-     * in your app's AndroidManifest.xml and request it at runtime.
-     * For older versions, permissions are granted at install time.
-     *
-     * This method is currently a logging placeholder for parity with iOS.
-     * Actual permission handling should be done in the host app.
+     * On Android 13+ (API 33+), requests [android.permission.POST_NOTIFICATIONS] via the
+     * system dialog. On older versions, no-op (notifications allowed by default).
+     * Uses [AttentivePushHelper] for the actual request.
      */
     override fun registerForPushNotifications() {
         Log.i(TAG, "📱 [AttentiveSDK] registerForPushNotifications called (Android)")
-        Log.i(TAG, "   Note: Push notification permissions should be requested in your host app")
-        Log.i(TAG, "   For Android 13+, request POST_NOTIFICATIONS permission at runtime")
 
-        if (debugHelper.isDebuggingEnabled()) {
-            val debugData = mutableMapOf<String, Any>()
-            debugData["platform"] = "Android"
-            debugData["sdk_version"] = "1.0.1"
-            debugData["note"] = "Permission handling should be done in host app"
-            debugHelper.showDebugInfo("Push Registration Requested", debugData)
+        UiThreadUtil.runOnUiThread {
+            val activity = reactApplicationContext.currentActivity
+            val requested = AttentivePushHelper.requestPermissionIfNeeded(activity, PUSH_PERMISSION_REQUEST_CODE)
+            if (!requested && activity == null) {
+                Log.w(TAG, "   Current activity is null; permission request deferred. Call again when app is in foreground.")
+            }
+            if (debugHelper.isDebuggingEnabled()) {
+                val debugData = mutableMapOf<String, Any>()
+                debugData["platform"] = "Android"
+                debugData["request_started"] = requested
+                debugHelper.showDebugInfo("Push Registration Requested", debugData)
+            }
+        }
+    }
+
+    /**
+     * Returns the current push notification authorization status for Android.
+     *
+     * On API 33+: returns "authorized" if POST_NOTIFICATIONS is granted, else "notDetermined".
+     * On API < 33: returns "authorized" (no runtime permission required).
+     */
+    override fun getPushAuthorizationStatus(promise: Promise) {
+        try {
+            val status = AttentivePushHelper.getAuthorizationStatus(reactApplicationContext)
+            Log.d(TAG, "getPushAuthorizationStatus: $status")
+            promise.resolve(status)
+        } catch (e: Exception) {
+            Log.e(TAG, "getPushAuthorizationStatus error: ${e.message}", e)
+            promise.reject("GET_STATUS_ERROR", e.message ?: "Unknown error", e)
         }
     }
 
@@ -292,7 +311,7 @@ class AttentiveReactNativeSdkModule(reactContext: ReactApplicationContext) :
             // Note: Attentive Android SDK 1.0.1 may not have direct push token registration
             // For SDK version 2.x, use: AttentiveConfig.setDeviceToken() or similar
             // For now, we log the token and make it available for custom implementation
-            
+
             Log.i(TAG, "⚠️  [AttentiveSDK] Push token registration requires manual implementation")
             Log.i(TAG, "   FCM token available: ${token.take(16)}...")
             Log.i(TAG, "   Store this token and register it with Attentive backend manually")
@@ -405,22 +424,29 @@ class AttentiveReactNativeSdkModule(reactContext: ReactApplicationContext) :
         try {
             // Attentive Android SDK 1.0.1 doesn't have a built-in handleRegularOpen method
             // We can track this as a custom event or use AttentiveEventTracker
-            
+
             // Option 1: Track as custom event
+
+            Log.i(TAG, "   Tracking regular open as custom event 'app_open' with properties")
+
             val properties = mapOf(
                 "event_type" to "app_open",
                 "authorization_status" to authorizationStatus,
                 "platform" to "Android"
             )
-            
+
             try {
+                Log.i(TAG, "   Attempting to track custom event for regular app open")
+
                 val customEvent = com.attentive.androidsdk.events.CustomEvent.Builder(
                     "app_open",
                     properties
                 ).build()
-                
+
+                Log.i(TAG, "   Custom event built successfully, recording event...")
+
                 AttentiveEventTracker.getInstance().recordEvent(customEvent)
-                
+
                 Log.i(TAG, "✅ [AttentiveSDK] handleRegularOpen completed (tracked as custom event)")
                 Log.i(TAG, "   Event sent to Attentive backend")
             } catch (e: Exception) {
@@ -472,7 +498,7 @@ class AttentiveReactNativeSdkModule(reactContext: ReactApplicationContext) :
             properties["event_type"] = "push_open"
             properties["authorization_status"] = authorizationStatus
             properties["platform"] = "Android"
-            
+
             // Add notification payload to properties (converting to strings)
             payload.forEach { (key, value) ->
                 properties["notification_$key"] = value?.toString() ?: "null"
@@ -483,9 +509,9 @@ class AttentiveReactNativeSdkModule(reactContext: ReactApplicationContext) :
                     "push_open",
                     properties
                 ).build()
-                
+
                 AttentiveEventTracker.getInstance().recordEvent(customEvent)
-                
+
                 Log.i(TAG, "✅ [AttentiveSDK] handlePushOpen completed (tracked as custom event)")
                 Log.i(TAG, "   Push open event sent to Attentive backend")
             } catch (e: Exception) {
@@ -538,7 +564,7 @@ class AttentiveReactNativeSdkModule(reactContext: ReactApplicationContext) :
             properties["event_type"] = "foreground_push"
             properties["authorization_status"] = authorizationStatus
             properties["platform"] = "Android"
-            
+
             // Add notification payload to properties (converting to strings)
             payload.forEach { (key, value) ->
                 properties["notification_$key"] = value?.toString() ?: "null"
@@ -549,9 +575,9 @@ class AttentiveReactNativeSdkModule(reactContext: ReactApplicationContext) :
                     "foreground_push",
                     properties
                 ).build()
-                
+
                 AttentiveEventTracker.getInstance().recordEvent(customEvent)
-                
+
                 Log.i(TAG, "✅ [AttentiveSDK] handleForegroundPush completed (tracked as custom event)")
                 Log.i(TAG, "   Foreground push event sent to Attentive backend")
             } catch (e: Exception) {

package/ios/AttentiveReactNativeSdk.mm

@@ -335,6 +335,38 @@ customIdentifiers:(NSDictionary *)customIdentifiers {
     }
     return UNAuthorizationStatusNotDetermined;
 }
+
+// Helper to convert UNAuthorizationStatus to string for getPushAuthorizationStatus
+- (NSString *)authorizationStatusToRNString:(UNAuthorizationStatus)status {
+    switch (status) {
+        case UNAuthorizationStatusAuthorized:
+            return @"authorized";
+        case UNAuthorizationStatusDenied:
+            return @"denied";
+        case UNAuthorizationStatusNotDetermined:
+            return @"notDetermined";
+#if __IPHONE_OS_VERSION_MAX_ALLOWED >= 120000
+        case UNAuthorizationStatusProvisional:
+            return @"provisional";
+#endif
+#if __IPHONE_OS_VERSION_MAX_ALLOWED >= 140000
+        case UNAuthorizationStatusEphemeral:
+            return @"ephemeral";
+#endif
+        default:
+            return @"notDetermined";
+    }
+}
+
+- (void)getPushAuthorizationStatus:(RCTPromiseResolveBlock)resolve
+                            reject:(RCTPromiseRejectBlock)reject {
+    UNUserNotificationCenter *center = [UNUserNotificationCenter currentNotificationCenter];
+    [center getNotificationSettingsWithCompletionHandler:^(UNNotificationSettings * _Nonnull settings) {
+        NSString *status = [self authorizationStatusToRNString:settings.authorizationStatus];
+        resolve(status);
+    }];
+}
+
 - (void)triggerCreative:(NSString *)creativeId {
   dispatch_async(dispatch_get_main_queue(), ^{
     UIWindow *window = [[UIApplication sharedApplication] keyWindow];

package/lib/commonjs/NativeAttentiveReactNativeSdk.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","isTurboModuleEnabled","global","__turboModuleProxy","AttentiveReactNativeSdkModule","TurboModuleRegistry","get","NativeModules","AttentiveReactNativeSdk","_default","exports","default"],"sourceRoot":"../../src","sources":["NativeAttentiveReactNativeSdk.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AA8IA;AACA;AACA,MAAMC,oBAAoB,GAAIC,MAAM,CAASC,kBAAkB,IAAI,IAAI;AAEvE,MAAMC,6BAA6B,GAAGH,oBAAoB,GACtDI,gCAAmB,CAACC,GAAG,CAAO,yBAAyB,CAAC,GACxDC,0BAAa,CAACC,uBAAuB;AAAC,IAAAC,QAAA,GAE3BL,6BAA6B;AAAAM,OAAA,CAAAC,OAAA,GAAAF,QAAA"}
+{"version":3,"names":["_reactNative","require","isTurboModuleEnabled","global","__turboModuleProxy","AttentiveReactNativeSdkModule","TurboModuleRegistry","get","NativeModules","AttentiveReactNativeSdk","_default","exports","default"],"sourceRoot":"../../src","sources":["NativeAttentiveReactNativeSdk.ts"],"mappings":";;;;;;AACA,IAAAA,YAAA,GAAAC,OAAA;AAuJA;AACA;AACA,MAAMC,oBAAoB,GAAIC,MAAM,CAASC,kBAAkB,IAAI,IAAI;AAEvE,MAAMC,6BAA6B,GAAGH,oBAAoB,GACtDI,gCAAmB,CAACC,GAAG,CAAO,yBAAyB,CAAC,GACxDC,0BAAa,CAACC,uBAAuB;AAAC,IAAAC,QAAA,GAE3BL,6BAA6B;AAAAM,OAAA,CAAAC,OAAA,GAAAF,QAAA"}

package/lib/commonjs/index.js

@@ -6,6 +6,7 @@ Object.defineProperty(exports, "__esModule", {
 exports.clearUser = clearUser;
 exports.destroyCreative = destroyCreative;
 exports.exportDebugLogs = exportDebugLogs;
+exports.getPushAuthorizationStatus = getPushAuthorizationStatus;
 exports.handleForegroundNotification = handleForegroundNotification;
 exports.handleForegroundPush = handleForegroundPush;
 exports.handlePushOpen = handlePushOpen;
@@ -130,13 +131,13 @@ function exportDebugLogs() {
 }
 
 // =============================================================================
-// Push Notification Methods (iOS only - Android is no-op with TODO stubs)
+// Push Notification Methods (iOS and Android)
 // =============================================================================
 
 /**
  * Request push notification permission from the user.
  * On iOS, this will trigger the system permission dialog.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android 13+, this requests POST_NOTIFICATIONS; on older versions, no-op.
  *
  * @example
  * ```typescript
@@ -150,12 +151,30 @@ function registerForPushNotifications() {
   AttentiveReactNativeSdk.registerForPushNotifications();
 }
 
+/**
+ * Get the current push notification authorization status.
+ * On Android, uses the SDK's native check (POST_NOTIFICATIONS on API 33+).
+ * On iOS, uses UNUserNotificationCenter notification settings.
+ *
+ * @returns Promise resolving to 'authorized' | 'denied' | 'notDetermined' (and on iOS possibly 'provisional' | 'ephemeral')
+ *
+ * @example
+ * ```typescript
+ * import { getPushAuthorizationStatus, handleRegularOpen } from 'attentive-react-native-sdk';
+ *
+ * getPushAuthorizationStatus().then((status) => handleRegularOpen(status));
+ * ```
+ */
+function getPushAuthorizationStatus() {
+  return AttentiveReactNativeSdk.getPushAuthorizationStatus();
+}
+
 /**
  * Register the device token received from APNs/FCM with the Attentive backend.
  * Call this from your AppDelegate's didRegisterForRemoteNotificationsWithDeviceToken.
  *
  * On iOS, the token should be the hex-encoded string representation of the device token Data.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param token - The device token as a hex-encoded string
  * @param authorizationStatus - Current push authorization status
@@ -178,7 +197,7 @@ function registerDeviceToken(token, authorizationStatus) {
  *
  * On iOS, this will register the device token with the Attentive SDK and invoke the callback
  * after the registration completes (success or failure).
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param token - The hex-encoded device token string from APNs
  * @param authorizationStatus - Current push authorization status
@@ -225,7 +244,7 @@ function registerDeviceTokenWithCallback(token, authorizationStatus, callback) {
  *
  * On iOS, this will notify the Attentive SDK that the app was opened directly
  * (not from a push notification tap).
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param authorizationStatus - Current push authorization status
  *
@@ -268,7 +287,7 @@ function handleRegularOpen(authorizationStatus) {
  *
  * On iOS, this will track the push open event and handle the notification appropriately
  * based on whether the app was in the foreground, background, or not running.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param applicationState - The app state when the notification was opened ('active', 'inactive', 'background')
@@ -295,7 +314,7 @@ function handlePushOpened(userInfo, applicationState, authorizationStatus) {
  * Call this from your notification handler when a notification is received while the app is active.
  *
  * On iOS, this allows the Attentive SDK to track the notification event.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  *
@@ -323,7 +342,7 @@ function handleForegroundNotification(userInfo) {
  * ```
  *
  * On iOS, this properly tracks foreground push notifications.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param authorizationStatus - Current push authorization status
@@ -356,7 +375,7 @@ function handleForegroundPush(userInfo, authorizationStatus) {
  * ```
  *
  * On iOS, this properly tracks push notification opens.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param authorizationStatus - Current push authorization status

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","_NativeAttentiveReactNativeSdk","_interopRequireDefault","obj","__esModule","default","LINKING_ERROR","Platform","select","ios","AttentiveReactNativeSdk","NativeAttentiveReactNativeSdkModule","Proxy","get","Error","initialize","configuration","attentiveDomain","mode","skipFatigueOnCreatives","enableDebugger","triggerCreative","creativeId","destroyCreative","updateDomain","domain","identify","identifiers","phone","email","klaviyoId","shopifyId","clientUserId","customIdentifiers","clearUser","recordAddToCartEvent","attrs","items","deeplink","recordProductViewEvent","recordPurchaseEvent","orderId","cartId","cartCoupon","recordCustomEvent","type","properties","invokeAttentiveDebugHelper","exportDebugLogs","registerForPushNotifications","registerDeviceToken","token","authorizationStatus","registerDeviceTokenWithCallback","callback","handleRegularOpen","console","log","handlePushOpened","userInfo","applicationState","handleForegroundNotification","handleForegroundPush","handlePushOpen"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAcA,IAAAC,8BAAA,GAAAC,sBAAA,CAAAF,OAAA;AAEwC,SAAAE,uBAAAC,GAAA,WAAAA,GAAA,IAAAA,GAAA,CAAAC,UAAA,GAAAD,GAAA,KAAAE,OAAA,EAAAF,GAAA;AAExC,MAAMG,aAAa,GAChB,qFAAoF,GACrFC,qBAAQ,CAACC,MAAM,CAAC;EACdC,GAAG,EAAE,gCAAgC;EACrCJ,OAAO,EAAE;AACX,CAAC,CAAC,GACF,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMK,uBAAuB,GAC3BC,sCAAmC,GAC/BA,sCAAmC,GACnC,IAAIC,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACR,aAAa,CAAC;EAChC;AACF,CAAC,CAEA;;AAET;AACA;AACA;AACA;AACA,SAASS,UAAUA,CAACC,aAAwC,EAAE;EAC5DN,uBAAuB,CAACK,UAAU,CAChCC,aAAa,CAACC,eAAe,EAC7BD,aAAa,CAACE,IAAI,EAClBF,aAAa,CAACG,sBAAsB,IAAI,KAAK,EAC7CH,aAAa,CAACI,cAAc,IAAI,KAAK,CACtC;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAACC,UAAmB,EAAE;EAC5CZ,uBAAuB,CAACW,eAAe,CAACC,UAAU,CAAC;AACrD;;AAEA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAAG;EACzBb,uBAAuB,CAACa,eAAe,EAAE;AAC3C;;AAEA;AACA;AACA;AACA;AACA,SAASC,YAAYA,CAACC,MAAc,EAAE;EACpCf,uBAAuB,CAACc,YAAY,CAACC,MAAM,CAAC;AAC9C;;AAEA;AACA;AACA;AACA;AACA,SAASC,QAAQA,CAACC,WAA4B,EAAE;EAC9CjB,uBAAuB,CAACgB,QAAQ,CAC9BC,WAAW,CAACC,KAAK,EACjBD,WAAW,CAACE,KAAK,EACjBF,WAAW,CAACG,SAAS,EACrBH,WAAW,CAACI,SAAS,EACrBJ,WAAW,CAACK,YAAY,EACxBL,WAAW,CAACM,iBAAiB,CAC9B;AACH;;AAEA;AACA;AACA;AACA,SAASC,SAASA,CAAA,EAAG;EACnBxB,uBAAuB,CAACwB,SAAS,EAAE;AACrC;;AAEA;AACA;AACA;AACA;AACA,SAASC,oBAAoBA,CAACC,KAAgB,EAAE;EAC9C1B,uBAAuB,CAACyB,oBAAoB,CAACC,KAAK,CAACC,KAAK,EAAED,KAAK,CAACE,QAAQ,CAAC;AAC3E;;AAEA;AACA;AACA;AACA;AACA,SAASC,sBAAsBA,CAACH,KAAkB,EAAE;EAClD1B,uBAAuB,CAAC6B,sBAAsB,CAACH,KAAK,CAACC,KAAK,EAAED,KAAK,CAACE,QAAQ,CAAC;AAC7E;;AAEA;AACA;AACA;AACA;AACA,SAASE,mBAAmBA,CAACJ,KAAe,EAAE;EAC5C1B,uBAAuB,CAAC8B,mBAAmB,CACzCJ,KAAK,CAACC,KAAK,EACXD,KAAK,CAACK,OAAO,EACbL,KAAK,CAACM,MAAM,EACZN,KAAK,CAACO,UAAU,CACjB;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACR,KAAkB,EAAE;EAC7C1B,uBAAuB,CAACkC,iBAAiB,CAACR,KAAK,CAACS,IAAI,EAAET,KAAK,CAACU,UAAU,CAAC;AACzE;;AAEA;AACA;AACA;AACA,SAASC,0BAA0BA,CAAA,EAAG;EACpCrC,uBAAuB,CAACqC,0BAA0B,EAAE;AACtD;;AAEA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAAoB;EAC1C,OAAOtC,uBAAuB,CAACsC,eAAe,EAAE;AAClD;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,4BAA4BA,CAAA,EAAS;EAC5CvC,uBAAuB,CAACuC,4BAA4B,EAAE;AACxD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,mBAAmBA,CAC1BC,KAAa,EACbC,mBAA4C,EACtC;EACN1C,uBAAuB,CAACwC,mBAAmB,CAACC,KAAK,EAAEC,mBAAmB,CAAC;AACzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,+BAA+BA,CACtCF,KAAa,EACbC,mBAA4C,EAC5CE,QAKS,EACH;EACN5C,uBAAuB,CAAC2C,+BAA+B,CACrDF,KAAK,EACLC,mBAAmB,EACnBE,QAAQ,CACT;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACH,mBAA4C,EAAQ;EAC7EI,OAAO,CAACC,GAAG,CAAC,6DAA6D,CAAC;EAC1ED,OAAO,CAACC,GAAG,CAAE,4BAA2BL,mBAAoB,EAAC,CAAC;EAC9DI,OAAO,CAACC,GAAG,CACT,mEAAmE,CACpE;EAED/C,uBAAuB,CAAC6C,iBAAiB,CAACH,mBAAmB,CAAC;EAE9DI,OAAO,CAACC,GAAG,CAAC,mDAAmD,CAAC;AAClE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,gBAAgBA,CACvBC,QAAkC,EAClCC,gBAAkC,EAClCR,mBAA4C,EACtC;EACN1C,uBAAuB,CAACgD,gBAAgB,CACtCC,QAAQ,EACRC,gBAAgB,EAChBR,mBAAmB,CACpB;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASS,4BAA4BA,CACnCF,QAAkC,EAC5B;EACNjD,uBAAuB,CAACmD,4BAA4B,CAACF,QAAQ,CAAW;AAC1E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASG,oBAAoBA,CAC3BH,QAAkC,EAClCP,mBAA4C,EACtC;EACN1C,uBAAuB,CAACoD,oBAAoB,CAC1CH,QAAQ,EACRP,mBAAmB,CACpB;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASW,cAAcA,CACrBJ,QAAkC,EAClCP,mBAA4C,EACtC;EACN1C,uBAAuB,CAACqD,cAAc,CACpCJ,QAAQ,EACRP,mBAAmB,CACpB;AACH"}
+{"version":3,"names":["_reactNative","require","_NativeAttentiveReactNativeSdk","_interopRequireDefault","obj","__esModule","default","LINKING_ERROR","Platform","select","ios","AttentiveReactNativeSdk","NativeAttentiveReactNativeSdkModule","Proxy","get","Error","initialize","configuration","attentiveDomain","mode","skipFatigueOnCreatives","enableDebugger","triggerCreative","creativeId","destroyCreative","updateDomain","domain","identify","identifiers","phone","email","klaviyoId","shopifyId","clientUserId","customIdentifiers","clearUser","recordAddToCartEvent","attrs","items","deeplink","recordProductViewEvent","recordPurchaseEvent","orderId","cartId","cartCoupon","recordCustomEvent","type","properties","invokeAttentiveDebugHelper","exportDebugLogs","registerForPushNotifications","getPushAuthorizationStatus","registerDeviceToken","token","authorizationStatus","registerDeviceTokenWithCallback","callback","handleRegularOpen","console","log","handlePushOpened","userInfo","applicationState","handleForegroundNotification","handleForegroundPush","handlePushOpen"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAcA,IAAAC,8BAAA,GAAAC,sBAAA,CAAAF,OAAA;AAEwC,SAAAE,uBAAAC,GAAA,WAAAA,GAAA,IAAAA,GAAA,CAAAC,UAAA,GAAAD,GAAA,KAAAE,OAAA,EAAAF,GAAA;AAExC,MAAMG,aAAa,GAChB,qFAAoF,GACrFC,qBAAQ,CAACC,MAAM,CAAC;EACdC,GAAG,EAAE,gCAAgC;EACrCJ,OAAO,EAAE;AACX,CAAC,CAAC,GACF,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMK,uBAAuB,GAC3BC,sCAAmC,GAC/BA,sCAAmC,GACnC,IAAIC,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACR,aAAa,CAAC;EAChC;AACF,CAAC,CAEA;;AAET;AACA;AACA;AACA;AACA,SAASS,UAAUA,CAACC,aAAwC,EAAE;EAC5DN,uBAAuB,CAACK,UAAU,CAChCC,aAAa,CAACC,eAAe,EAC7BD,aAAa,CAACE,IAAI,EAClBF,aAAa,CAACG,sBAAsB,IAAI,KAAK,EAC7CH,aAAa,CAACI,cAAc,IAAI,KAAK,CACtC;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAACC,UAAmB,EAAE;EAC5CZ,uBAAuB,CAACW,eAAe,CAACC,UAAU,CAAC;AACrD;;AAEA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAAG;EACzBb,uBAAuB,CAACa,eAAe,EAAE;AAC3C;;AAEA;AACA;AACA;AACA;AACA,SAASC,YAAYA,CAACC,MAAc,EAAE;EACpCf,uBAAuB,CAACc,YAAY,CAACC,MAAM,CAAC;AAC9C;;AAEA;AACA;AACA;AACA;AACA,SAASC,QAAQA,CAACC,WAA4B,EAAE;EAC9CjB,uBAAuB,CAACgB,QAAQ,CAC9BC,WAAW,CAACC,KAAK,EACjBD,WAAW,CAACE,KAAK,EACjBF,WAAW,CAACG,SAAS,EACrBH,WAAW,CAACI,SAAS,EACrBJ,WAAW,CAACK,YAAY,EACxBL,WAAW,CAACM,iBAAiB,CAC9B;AACH;;AAEA;AACA;AACA;AACA,SAASC,SAASA,CAAA,EAAG;EACnBxB,uBAAuB,CAACwB,SAAS,EAAE;AACrC;;AAEA;AACA;AACA;AACA;AACA,SAASC,oBAAoBA,CAACC,KAAgB,EAAE;EAC9C1B,uBAAuB,CAACyB,oBAAoB,CAACC,KAAK,CAACC,KAAK,EAAED,KAAK,CAACE,QAAQ,CAAC;AAC3E;;AAEA;AACA;AACA;AACA;AACA,SAASC,sBAAsBA,CAACH,KAAkB,EAAE;EAClD1B,uBAAuB,CAAC6B,sBAAsB,CAACH,KAAK,CAACC,KAAK,EAAED,KAAK,CAACE,QAAQ,CAAC;AAC7E;;AAEA;AACA;AACA;AACA;AACA,SAASE,mBAAmBA,CAACJ,KAAe,EAAE;EAC5C1B,uBAAuB,CAAC8B,mBAAmB,CACzCJ,KAAK,CAACC,KAAK,EACXD,KAAK,CAACK,OAAO,EACbL,KAAK,CAACM,MAAM,EACZN,KAAK,CAACO,UAAU,CACjB;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACR,KAAkB,EAAE;EAC7C1B,uBAAuB,CAACkC,iBAAiB,CAACR,KAAK,CAACS,IAAI,EAAET,KAAK,CAACU,UAAU,CAAC;AACzE;;AAEA;AACA;AACA;AACA,SAASC,0BAA0BA,CAAA,EAAG;EACpCrC,uBAAuB,CAACqC,0BAA0B,EAAE;AACtD;;AAEA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAAoB;EAC1C,OAAOtC,uBAAuB,CAACsC,eAAe,EAAE;AAClD;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,4BAA4BA,CAAA,EAAS;EAC5CvC,uBAAuB,CAACuC,4BAA4B,EAAE;AACxD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,0BAA0BA,CAAA,EAAqC;EACtE,OAAOxC,uBAAuB,CAACwC,0BAA0B,EAAE;AAC7D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,mBAAmBA,CAC1BC,KAAa,EACbC,mBAA4C,EACtC;EACN3C,uBAAuB,CAACyC,mBAAmB,CAACC,KAAK,EAAEC,mBAAmB,CAAC;AACzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,+BAA+BA,CACtCF,KAAa,EACbC,mBAA4C,EAC5CE,QAKS,EACH;EACN7C,uBAAuB,CAAC4C,+BAA+B,CACrDF,KAAK,EACLC,mBAAmB,EACnBE,QAAQ,CACT;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACH,mBAA4C,EAAQ;EAC7EI,OAAO,CAACC,GAAG,CAAC,6DAA6D,CAAC;EAC1ED,OAAO,CAACC,GAAG,CAAE,4BAA2BL,mBAAoB,EAAC,CAAC;EAC9DI,OAAO,CAACC,GAAG,CACT,mEAAmE,CACpE;EAEDhD,uBAAuB,CAAC8C,iBAAiB,CAACH,mBAAmB,CAAC;EAE9DI,OAAO,CAACC,GAAG,CAAC,mDAAmD,CAAC;AAClE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,gBAAgBA,CACvBC,QAAkC,EAClCC,gBAAkC,EAClCR,mBAA4C,EACtC;EACN3C,uBAAuB,CAACiD,gBAAgB,CACtCC,QAAQ,EACRC,gBAAgB,EAChBR,mBAAmB,CACpB;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASS,4BAA4BA,CACnCF,QAAkC,EAC5B;EACNlD,uBAAuB,CAACoD,4BAA4B,CAACF,QAAQ,CAAW;AAC1E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASG,oBAAoBA,CAC3BH,QAAkC,EAClCP,mBAA4C,EACtC;EACN3C,uBAAuB,CAACqD,oBAAoB,CAC1CH,QAAQ,EACRP,mBAAmB,CACpB;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASW,cAAcA,CACrBJ,QAAkC,EAClCP,mBAA4C,EACtC;EACN3C,uBAAuB,CAACsD,cAAc,CACpCJ,QAAQ,EACRP,mBAAmB,CACpB;AACH"}

package/lib/module/NativeAttentiveReactNativeSdk.js.map

@@ -1 +1 @@
-{"version":3,"names":["TurboModuleRegistry","NativeModules","isTurboModuleEnabled","global","__turboModuleProxy","AttentiveReactNativeSdkModule","get","AttentiveReactNativeSdk"],"sourceRoot":"../../src","sources":["NativeAttentiveReactNativeSdk.ts"],"mappings":"AACA,SAASA,mBAAmB,EAAEC,aAAa,QAAQ,cAAc;AA8IjE;AACA;AACA,MAAMC,oBAAoB,GAAIC,MAAM,CAASC,kBAAkB,IAAI,IAAI;AAEvE,MAAMC,6BAA6B,GAAGH,oBAAoB,GACtDF,mBAAmB,CAACM,GAAG,CAAO,yBAAyB,CAAC,GACxDL,aAAa,CAACM,uBAAuB;AAEzC,eAAeF,6BAA6B"}
+{"version":3,"names":["TurboModuleRegistry","NativeModules","isTurboModuleEnabled","global","__turboModuleProxy","AttentiveReactNativeSdkModule","get","AttentiveReactNativeSdk"],"sourceRoot":"../../src","sources":["NativeAttentiveReactNativeSdk.ts"],"mappings":"AACA,SAASA,mBAAmB,EAAEC,aAAa,QAAQ,cAAc;AAuJjE;AACA;AACA,MAAMC,oBAAoB,GAAIC,MAAM,CAASC,kBAAkB,IAAI,IAAI;AAEvE,MAAMC,6BAA6B,GAAGH,oBAAoB,GACtDF,mBAAmB,CAACM,GAAG,CAAO,yBAAyB,CAAC,GACxDL,aAAa,CAACM,uBAAuB;AAEzC,eAAeF,6BAA6B"}

package/lib/module/index.js

@@ -104,13 +104,13 @@ function exportDebugLogs() {
 }
 
 // =============================================================================
-// Push Notification Methods (iOS only - Android is no-op with TODO stubs)
+// Push Notification Methods (iOS and Android)
 // =============================================================================
 
 /**
  * Request push notification permission from the user.
  * On iOS, this will trigger the system permission dialog.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android 13+, this requests POST_NOTIFICATIONS; on older versions, no-op.
  *
  * @example
  * ```typescript
@@ -124,12 +124,30 @@ function registerForPushNotifications() {
   AttentiveReactNativeSdk.registerForPushNotifications();
 }
 
+/**
+ * Get the current push notification authorization status.
+ * On Android, uses the SDK's native check (POST_NOTIFICATIONS on API 33+).
+ * On iOS, uses UNUserNotificationCenter notification settings.
+ *
+ * @returns Promise resolving to 'authorized' | 'denied' | 'notDetermined' (and on iOS possibly 'provisional' | 'ephemeral')
+ *
+ * @example
+ * ```typescript
+ * import { getPushAuthorizationStatus, handleRegularOpen } from 'attentive-react-native-sdk';
+ *
+ * getPushAuthorizationStatus().then((status) => handleRegularOpen(status));
+ * ```
+ */
+function getPushAuthorizationStatus() {
+  return AttentiveReactNativeSdk.getPushAuthorizationStatus();
+}
+
 /**
  * Register the device token received from APNs/FCM with the Attentive backend.
  * Call this from your AppDelegate's didRegisterForRemoteNotificationsWithDeviceToken.
  *
  * On iOS, the token should be the hex-encoded string representation of the device token Data.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param token - The device token as a hex-encoded string
  * @param authorizationStatus - Current push authorization status
@@ -152,7 +170,7 @@ function registerDeviceToken(token, authorizationStatus) {
  *
  * On iOS, this will register the device token with the Attentive SDK and invoke the callback
  * after the registration completes (success or failure).
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param token - The hex-encoded device token string from APNs
  * @param authorizationStatus - Current push authorization status
@@ -199,7 +217,7 @@ function registerDeviceTokenWithCallback(token, authorizationStatus, callback) {
  *
  * On iOS, this will notify the Attentive SDK that the app was opened directly
  * (not from a push notification tap).
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param authorizationStatus - Current push authorization status
  *
@@ -242,7 +260,7 @@ function handleRegularOpen(authorizationStatus) {
  *
  * On iOS, this will track the push open event and handle the notification appropriately
  * based on whether the app was in the foreground, background, or not running.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param applicationState - The app state when the notification was opened ('active', 'inactive', 'background')
@@ -269,7 +287,7 @@ function handlePushOpened(userInfo, applicationState, authorizationStatus) {
  * Call this from your notification handler when a notification is received while the app is active.
  *
  * On iOS, this allows the Attentive SDK to track the notification event.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  *
@@ -297,7 +315,7 @@ function handleForegroundNotification(userInfo) {
  * ```
  *
  * On iOS, this properly tracks foreground push notifications.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param authorizationStatus - Current push authorization status
@@ -330,7 +348,7 @@ function handleForegroundPush(userInfo, authorizationStatus) {
  * ```
  *
  * On iOS, this properly tracks push notification opens.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param authorizationStatus - Current push authorization status
@@ -351,6 +369,6 @@ function handlePushOpen(userInfo, authorizationStatus) {
   AttentiveReactNativeSdk.handlePushOpen(userInfo, authorizationStatus);
 }
 export { initialize, triggerCreative, destroyCreative, updateDomain, identify, clearUser, recordAddToCartEvent, recordProductViewEvent, recordPurchaseEvent, recordCustomEvent, invokeAttentiveDebugHelper, exportDebugLogs,
-// Push Notification Methods (iOS only)
-registerForPushNotifications, registerDeviceToken, registerDeviceTokenWithCallback, handleRegularOpen, handlePushOpened, handleForegroundNotification, handleForegroundPush, handlePushOpen };
+// Push Notification Methods
+registerForPushNotifications, getPushAuthorizationStatus, registerDeviceToken, registerDeviceTokenWithCallback, handleRegularOpen, handlePushOpened, handleForegroundNotification, handleForegroundPush, handlePushOpen };
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["Platform","NativeAttentiveReactNativeSdkModule","LINKING_ERROR","select","ios","default","AttentiveReactNativeSdk","Proxy","get","Error","initialize","configuration","attentiveDomain","mode","skipFatigueOnCreatives","enableDebugger","triggerCreative","creativeId","destroyCreative","updateDomain","domain","identify","identifiers","phone","email","klaviyoId","shopifyId","clientUserId","customIdentifiers","clearUser","recordAddToCartEvent","attrs","items","deeplink","recordProductViewEvent","recordPurchaseEvent","orderId","cartId","cartCoupon","recordCustomEvent","type","properties","invokeAttentiveDebugHelper","exportDebugLogs","registerForPushNotifications","registerDeviceToken","token","authorizationStatus","registerDeviceTokenWithCallback","callback","handleRegularOpen","console","log","handlePushOpened","userInfo","applicationState","handleForegroundNotification","handleForegroundPush","handlePushOpen"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,cAAc;AAcvC,OAAOC,mCAAmC,MAEnC,iCAAiC;AAExC,MAAMC,aAAa,GAChB,qFAAoF,GACrFF,QAAQ,CAACG,MAAM,CAAC;EACdC,GAAG,EAAE,gCAAgC;EACrCC,OAAO,EAAE;AACX,CAAC,CAAC,GACF,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMC,uBAAuB,GAC3BL,mCAAmC,GAC/BA,mCAAmC,GACnC,IAAIM,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACP,aAAa,CAAC;EAChC;AACF,CAAC,CAEA;;AAET;AACA;AACA;AACA;AACA,SAASQ,UAAUA,CAACC,aAAwC,EAAE;EAC5DL,uBAAuB,CAACI,UAAU,CAChCC,aAAa,CAACC,eAAe,EAC7BD,aAAa,CAACE,IAAI,EAClBF,aAAa,CAACG,sBAAsB,IAAI,KAAK,EAC7CH,aAAa,CAACI,cAAc,IAAI,KAAK,CACtC;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAACC,UAAmB,EAAE;EAC5CX,uBAAuB,CAACU,eAAe,CAACC,UAAU,CAAC;AACrD;;AAEA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAAG;EACzBZ,uBAAuB,CAACY,eAAe,EAAE;AAC3C;;AAEA;AACA;AACA;AACA;AACA,SAASC,YAAYA,CAACC,MAAc,EAAE;EACpCd,uBAAuB,CAACa,YAAY,CAACC,MAAM,CAAC;AAC9C;;AAEA;AACA;AACA;AACA;AACA,SAASC,QAAQA,CAACC,WAA4B,EAAE;EAC9ChB,uBAAuB,CAACe,QAAQ,CAC9BC,WAAW,CAACC,KAAK,EACjBD,WAAW,CAACE,KAAK,EACjBF,WAAW,CAACG,SAAS,EACrBH,WAAW,CAACI,SAAS,EACrBJ,WAAW,CAACK,YAAY,EACxBL,WAAW,CAACM,iBAAiB,CAC9B;AACH;;AAEA;AACA;AACA;AACA,SAASC,SAASA,CAAA,EAAG;EACnBvB,uBAAuB,CAACuB,SAAS,EAAE;AACrC;;AAEA;AACA;AACA;AACA;AACA,SAASC,oBAAoBA,CAACC,KAAgB,EAAE;EAC9CzB,uBAAuB,CAACwB,oBAAoB,CAACC,KAAK,CAACC,KAAK,EAAED,KAAK,CAACE,QAAQ,CAAC;AAC3E;;AAEA;AACA;AACA;AACA;AACA,SAASC,sBAAsBA,CAACH,KAAkB,EAAE;EAClDzB,uBAAuB,CAAC4B,sBAAsB,CAACH,KAAK,CAACC,KAAK,EAAED,KAAK,CAACE,QAAQ,CAAC;AAC7E;;AAEA;AACA;AACA;AACA;AACA,SAASE,mBAAmBA,CAACJ,KAAe,EAAE;EAC5CzB,uBAAuB,CAAC6B,mBAAmB,CACzCJ,KAAK,CAACC,KAAK,EACXD,KAAK,CAACK,OAAO,EACbL,KAAK,CAACM,MAAM,EACZN,KAAK,CAACO,UAAU,CACjB;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACR,KAAkB,EAAE;EAC7CzB,uBAAuB,CAACiC,iBAAiB,CAACR,KAAK,CAACS,IAAI,EAAET,KAAK,CAACU,UAAU,CAAC;AACzE;;AAEA;AACA;AACA;AACA,SAASC,0BAA0BA,CAAA,EAAG;EACpCpC,uBAAuB,CAACoC,0BAA0B,EAAE;AACtD;;AAEA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAAoB;EAC1C,OAAOrC,uBAAuB,CAACqC,eAAe,EAAE;AAClD;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,4BAA4BA,CAAA,EAAS;EAC5CtC,uBAAuB,CAACsC,4BAA4B,EAAE;AACxD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,mBAAmBA,CAC1BC,KAAa,EACbC,mBAA4C,EACtC;EACNzC,uBAAuB,CAACuC,mBAAmB,CAACC,KAAK,EAAEC,mBAAmB,CAAC;AACzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,+BAA+BA,CACtCF,KAAa,EACbC,mBAA4C,EAC5CE,QAKS,EACH;EACN3C,uBAAuB,CAAC0C,+BAA+B,CACrDF,KAAK,EACLC,mBAAmB,EACnBE,QAAQ,CACT;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACH,mBAA4C,EAAQ;EAC7EI,OAAO,CAACC,GAAG,CAAC,6DAA6D,CAAC;EAC1ED,OAAO,CAACC,GAAG,CAAE,4BAA2BL,mBAAoB,EAAC,CAAC;EAC9DI,OAAO,CAACC,GAAG,CACT,mEAAmE,CACpE;EAED9C,uBAAuB,CAAC4C,iBAAiB,CAACH,mBAAmB,CAAC;EAE9DI,OAAO,CAACC,GAAG,CAAC,mDAAmD,CAAC;AAClE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,gBAAgBA,CACvBC,QAAkC,EAClCC,gBAAkC,EAClCR,mBAA4C,EACtC;EACNzC,uBAAuB,CAAC+C,gBAAgB,CACtCC,QAAQ,EACRC,gBAAgB,EAChBR,mBAAmB,CACpB;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASS,4BAA4BA,CACnCF,QAAkC,EAC5B;EACNhD,uBAAuB,CAACkD,4BAA4B,CAACF,QAAQ,CAAW;AAC1E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASG,oBAAoBA,CAC3BH,QAAkC,EAClCP,mBAA4C,EACtC;EACNzC,uBAAuB,CAACmD,oBAAoB,CAC1CH,QAAQ,EACRP,mBAAmB,CACpB;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASW,cAAcA,CACrBJ,QAAkC,EAClCP,mBAA4C,EACtC;EACNzC,uBAAuB,CAACoD,cAAc,CACpCJ,QAAQ,EACRP,mBAAmB,CACpB;AACH;AAEA,SACErC,UAAU,EACVM,eAAe,EACfE,eAAe,EACfC,YAAY,EACZE,QAAQ,EACRQ,SAAS,EACTC,oBAAoB,EACpBI,sBAAsB,EACtBC,mBAAmB,EACnBI,iBAAiB,EACjBG,0BAA0B,EAC1BC,eAAe;AACf;AACAC,4BAA4B,EAC5BC,mBAAmB,EACnBG,+BAA+B,EAC/BE,iBAAiB,EACjBG,gBAAgB,EAChBG,4BAA4B,EAC5BC,oBAAoB,EACpBC,cAAc"}
+{"version":3,"names":["Platform","NativeAttentiveReactNativeSdkModule","LINKING_ERROR","select","ios","default","AttentiveReactNativeSdk","Proxy","get","Error","initialize","configuration","attentiveDomain","mode","skipFatigueOnCreatives","enableDebugger","triggerCreative","creativeId","destroyCreative","updateDomain","domain","identify","identifiers","phone","email","klaviyoId","shopifyId","clientUserId","customIdentifiers","clearUser","recordAddToCartEvent","attrs","items","deeplink","recordProductViewEvent","recordPurchaseEvent","orderId","cartId","cartCoupon","recordCustomEvent","type","properties","invokeAttentiveDebugHelper","exportDebugLogs","registerForPushNotifications","getPushAuthorizationStatus","registerDeviceToken","token","authorizationStatus","registerDeviceTokenWithCallback","callback","handleRegularOpen","console","log","handlePushOpened","userInfo","applicationState","handleForegroundNotification","handleForegroundPush","handlePushOpen"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"AAAA,SAASA,QAAQ,QAAQ,cAAc;AAcvC,OAAOC,mCAAmC,MAEnC,iCAAiC;AAExC,MAAMC,aAAa,GAChB,qFAAoF,GACrFF,QAAQ,CAACG,MAAM,CAAC;EACdC,GAAG,EAAE,gCAAgC;EACrCC,OAAO,EAAE;AACX,CAAC,CAAC,GACF,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMC,uBAAuB,GAC3BL,mCAAmC,GAC/BA,mCAAmC,GACnC,IAAIM,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACP,aAAa,CAAC;EAChC;AACF,CAAC,CAEA;;AAET;AACA;AACA;AACA;AACA,SAASQ,UAAUA,CAACC,aAAwC,EAAE;EAC5DL,uBAAuB,CAACI,UAAU,CAChCC,aAAa,CAACC,eAAe,EAC7BD,aAAa,CAACE,IAAI,EAClBF,aAAa,CAACG,sBAAsB,IAAI,KAAK,EAC7CH,aAAa,CAACI,cAAc,IAAI,KAAK,CACtC;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAACC,UAAmB,EAAE;EAC5CX,uBAAuB,CAACU,eAAe,CAACC,UAAU,CAAC;AACrD;;AAEA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAAG;EACzBZ,uBAAuB,CAACY,eAAe,EAAE;AAC3C;;AAEA;AACA;AACA;AACA;AACA,SAASC,YAAYA,CAACC,MAAc,EAAE;EACpCd,uBAAuB,CAACa,YAAY,CAACC,MAAM,CAAC;AAC9C;;AAEA;AACA;AACA;AACA;AACA,SAASC,QAAQA,CAACC,WAA4B,EAAE;EAC9ChB,uBAAuB,CAACe,QAAQ,CAC9BC,WAAW,CAACC,KAAK,EACjBD,WAAW,CAACE,KAAK,EACjBF,WAAW,CAACG,SAAS,EACrBH,WAAW,CAACI,SAAS,EACrBJ,WAAW,CAACK,YAAY,EACxBL,WAAW,CAACM,iBAAiB,CAC9B;AACH;;AAEA;AACA;AACA;AACA,SAASC,SAASA,CAAA,EAAG;EACnBvB,uBAAuB,CAACuB,SAAS,EAAE;AACrC;;AAEA;AACA;AACA;AACA;AACA,SAASC,oBAAoBA,CAACC,KAAgB,EAAE;EAC9CzB,uBAAuB,CAACwB,oBAAoB,CAACC,KAAK,CAACC,KAAK,EAAED,KAAK,CAACE,QAAQ,CAAC;AAC3E;;AAEA;AACA;AACA;AACA;AACA,SAASC,sBAAsBA,CAACH,KAAkB,EAAE;EAClDzB,uBAAuB,CAAC4B,sBAAsB,CAACH,KAAK,CAACC,KAAK,EAAED,KAAK,CAACE,QAAQ,CAAC;AAC7E;;AAEA;AACA;AACA;AACA;AACA,SAASE,mBAAmBA,CAACJ,KAAe,EAAE;EAC5CzB,uBAAuB,CAAC6B,mBAAmB,CACzCJ,KAAK,CAACC,KAAK,EACXD,KAAK,CAACK,OAAO,EACbL,KAAK,CAACM,MAAM,EACZN,KAAK,CAACO,UAAU,CACjB;AACH;;AAEA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACR,KAAkB,EAAE;EAC7CzB,uBAAuB,CAACiC,iBAAiB,CAACR,KAAK,CAACS,IAAI,EAAET,KAAK,CAACU,UAAU,CAAC;AACzE;;AAEA;AACA;AACA;AACA,SAASC,0BAA0BA,CAAA,EAAG;EACpCpC,uBAAuB,CAACoC,0BAA0B,EAAE;AACtD;;AAEA;AACA;AACA;AACA;AACA,SAASC,eAAeA,CAAA,EAAoB;EAC1C,OAAOrC,uBAAuB,CAACqC,eAAe,EAAE;AAClD;;AAEA;AACA;AACA;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,4BAA4BA,CAAA,EAAS;EAC5CtC,uBAAuB,CAACsC,4BAA4B,EAAE;AACxD;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,0BAA0BA,CAAA,EAAqC;EACtE,OAAOvC,uBAAuB,CAACuC,0BAA0B,EAAE;AAC7D;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,mBAAmBA,CAC1BC,KAAa,EACbC,mBAA4C,EACtC;EACN1C,uBAAuB,CAACwC,mBAAmB,CAACC,KAAK,EAAEC,mBAAmB,CAAC;AACzE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,+BAA+BA,CACtCF,KAAa,EACbC,mBAA4C,EAC5CE,QAKS,EACH;EACN5C,uBAAuB,CAAC2C,+BAA+B,CACrDF,KAAK,EACLC,mBAAmB,EACnBE,QAAQ,CACT;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,iBAAiBA,CAACH,mBAA4C,EAAQ;EAC7EI,OAAO,CAACC,GAAG,CAAC,6DAA6D,CAAC;EAC1ED,OAAO,CAACC,GAAG,CAAE,4BAA2BL,mBAAoB,EAAC,CAAC;EAC9DI,OAAO,CAACC,GAAG,CACT,mEAAmE,CACpE;EAED/C,uBAAuB,CAAC6C,iBAAiB,CAACH,mBAAmB,CAAC;EAE9DI,OAAO,CAACC,GAAG,CAAC,mDAAmD,CAAC;AAClE;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASC,gBAAgBA,CACvBC,QAAkC,EAClCC,gBAAkC,EAClCR,mBAA4C,EACtC;EACN1C,uBAAuB,CAACgD,gBAAgB,CACtCC,QAAQ,EACRC,gBAAgB,EAChBR,mBAAmB,CACpB;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASS,4BAA4BA,CACnCF,QAAkC,EAC5B;EACNjD,uBAAuB,CAACmD,4BAA4B,CAACF,QAAQ,CAAW;AAC1E;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASG,oBAAoBA,CAC3BH,QAAkC,EAClCP,mBAA4C,EACtC;EACN1C,uBAAuB,CAACoD,oBAAoB,CAC1CH,QAAQ,EACRP,mBAAmB,CACpB;AACH;;AAEA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA;AACA,SAASW,cAAcA,CACrBJ,QAAkC,EAClCP,mBAA4C,EACtC;EACN1C,uBAAuB,CAACqD,cAAc,CACpCJ,QAAQ,EACRP,mBAAmB,CACpB;AACH;AAEA,SACEtC,UAAU,EACVM,eAAe,EACfE,eAAe,EACfC,YAAY,EACZE,QAAQ,EACRQ,SAAS,EACTC,oBAAoB,EACpBI,sBAAsB,EACtBC,mBAAmB,EACnBI,iBAAiB,EACjBG,0BAA0B,EAC1BC,eAAe;AACf;AACAC,4BAA4B,EAC5BC,0BAA0B,EAC1BC,mBAAmB,EACnBG,+BAA+B,EAC/BE,iBAAiB,EACjBG,gBAAgB,EAChBG,4BAA4B,EAC5BC,oBAAoB,EACpBC,cAAc"}

package/lib/typescript/NativeAttentiveReactNativeSdk.d.ts

@@ -41,9 +41,17 @@ export interface Spec extends TurboModule {
     exportDebugLogs: () => Promise<string>;
     /**
      * Request push notification permission from the user.
-     * iOS only - Android is a no-op.
+     * On iOS, triggers the system permission dialog.
+     * On Android 13+, requests POST_NOTIFICATIONS; on older versions, no-op.
      */
     registerForPushNotifications: () => void;
+    /**
+     * Get the current push notification authorization status.
+     * On Android, uses POST_NOTIFICATIONS (API 33+); on older versions returns 'authorized'.
+     * On iOS, use PushNotificationIOS.checkPermissions instead; this method is for Android parity.
+     * @returns Promise resolving to 'authorized' | 'denied' | 'notDetermined'
+     */
+    getPushAuthorizationStatus: () => Promise<string>;
     /**
      * Register the device token received from APNs (simple version without callback).
      * iOS only - Android is a no-op.

package/lib/typescript/NativeAttentiveReactNativeSdk.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"NativeAttentiveReactNativeSdk.d.ts","sourceRoot":"","sources":["../../src/NativeAttentiveReactNativeSdk.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"NativeAttentiveReactNativeSdk.d.ts","sourceRoot":"","sources":["../../src/NativeAttentiveReactNativeSdk.ts"],"names":[],"mappings":"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"}

package/lib/typescript/index.d.ts

@@ -59,7 +59,7 @@ declare function exportDebugLogs(): Promise<string>;
 /**
  * Request push notification permission from the user.
  * On iOS, this will trigger the system permission dialog.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android 13+, this requests POST_NOTIFICATIONS; on older versions, no-op.
  *
  * @example
  * ```typescript
@@ -70,12 +70,27 @@ declare function exportDebugLogs(): Promise<string>;
  * ```
  */
 declare function registerForPushNotifications(): void;
+/**
+ * Get the current push notification authorization status.
+ * On Android, uses the SDK's native check (POST_NOTIFICATIONS on API 33+).
+ * On iOS, uses UNUserNotificationCenter notification settings.
+ *
+ * @returns Promise resolving to 'authorized' | 'denied' | 'notDetermined' (and on iOS possibly 'provisional' | 'ephemeral')
+ *
+ * @example
+ * ```typescript
+ * import { getPushAuthorizationStatus, handleRegularOpen } from 'attentive-react-native-sdk';
+ *
+ * getPushAuthorizationStatus().then((status) => handleRegularOpen(status));
+ * ```
+ */
+declare function getPushAuthorizationStatus(): Promise<PushAuthorizationStatus>;
 /**
  * Register the device token received from APNs/FCM with the Attentive backend.
  * Call this from your AppDelegate's didRegisterForRemoteNotificationsWithDeviceToken.
  *
  * On iOS, the token should be the hex-encoded string representation of the device token Data.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param token - The device token as a hex-encoded string
  * @param authorizationStatus - Current push authorization status
@@ -95,7 +110,7 @@ declare function registerDeviceToken(token: string, authorizationStatus: PushAut
  *
  * On iOS, this will register the device token with the Attentive SDK and invoke the callback
  * after the registration completes (success or failure).
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param token - The hex-encoded device token string from APNs
  * @param authorizationStatus - Current push authorization status
@@ -139,7 +154,7 @@ declare function registerDeviceTokenWithCallback(token: string, authorizationSta
  *
  * On iOS, this will notify the Attentive SDK that the app was opened directly
  * (not from a push notification tap).
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param authorizationStatus - Current push authorization status
  *
@@ -175,7 +190,7 @@ declare function handleRegularOpen(authorizationStatus: PushAuthorizationStatus)
  *
  * On iOS, this will track the push open event and handle the notification appropriately
  * based on whether the app was in the foreground, background, or not running.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param applicationState - The app state when the notification was opened ('active', 'inactive', 'background')
@@ -199,7 +214,7 @@ declare function handlePushOpened(userInfo: PushNotificationUserInfo, applicatio
  * Call this from your notification handler when a notification is received while the app is active.
  *
  * On iOS, this allows the Attentive SDK to track the notification event.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  *
@@ -224,7 +239,7 @@ declare function handleForegroundNotification(userInfo: PushNotificationUserInfo
  * ```
  *
  * On iOS, this properly tracks foreground push notifications.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param authorizationStatus - Current push authorization status
@@ -254,7 +269,7 @@ declare function handleForegroundPush(userInfo: PushNotificationUserInfo, author
  * ```
  *
  * On iOS, this properly tracks push notification opens.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param authorizationStatus - Current push authorization status
@@ -272,6 +287,6 @@ declare function handleForegroundPush(userInfo: PushNotificationUserInfo, author
  * ```
  */
 declare function handlePushOpen(userInfo: PushNotificationUserInfo, authorizationStatus: PushAuthorizationStatus): void;
-export { initialize, triggerCreative, destroyCreative, updateDomain, identify, clearUser, recordAddToCartEvent, recordProductViewEvent, recordPurchaseEvent, recordCustomEvent, invokeAttentiveDebugHelper, exportDebugLogs, registerForPushNotifications, registerDeviceToken, registerDeviceTokenWithCallback, handleRegularOpen, handlePushOpened, handleForegroundNotification, handleForegroundPush, handlePushOpen, };
+export { initialize, triggerCreative, destroyCreative, updateDomain, identify, clearUser, recordAddToCartEvent, recordProductViewEvent, recordPurchaseEvent, recordCustomEvent, invokeAttentiveDebugHelper, exportDebugLogs, registerForPushNotifications, getPushAuthorizationStatus, registerDeviceToken, registerDeviceTokenWithCallback, handleRegularOpen, handlePushOpened, handleForegroundNotification, handleForegroundPush, handlePushOpen, };
 export type { UserIdentifiers, AttentiveSdkConfiguration, ProductView, Purchase, AddToCart, CustomEvent, Item, PushAuthorizationStatus, ApplicationState, PushNotificationUserInfo, PushRegistrationResult, };
 //# sourceMappingURL=index.d.ts.map

package/lib/typescript/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.tsx"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@attentive-mobile/attentive-react-native-sdk",
-  "version": "2.0.0-beta.4",
+  "version": "2.0.0-beta.5",
   "description": "React Native Module for the Attentive SDK",
   "main": "lib/commonjs/index",
   "module": "lib/module/index",
@@ -48,7 +48,10 @@
     "ios",
     "android"
   ],
-  "repository": "https://github.com/attentive-mobile/attentive-react-native-sdk",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/attentive-mobile/attentive-react-native-sdk.git"
+  },
   "author": "Attentive <epd-accounts+npm@attentivemobile.com> (https://www.attentive.com)",
   "contributors": [
     "Wyatt Davis"
@@ -59,7 +62,8 @@
   },
   "homepage": "https://github.com/attentive-mobile/attentive-react-native-sdk#readme",
   "publishConfig": {
-    "registry": "https://registry.npmjs.org/"
+    "registry": "https://registry.npmjs.org/",
+    "access": "public"
   },
   "devDependencies": {
     "@commitlint/config-conventional": "^17.0.2",

package/src/NativeAttentiveReactNativeSdk.ts

@@ -65,13 +65,22 @@ export interface Spec extends TurboModule {
   invokeAttentiveDebugHelper: () => void;
   exportDebugLogs: () => Promise<string>;
 
-  // Push Notification Methods (iOS only)
+  // Push Notification Methods
   /**
    * Request push notification permission from the user.
-   * iOS only - Android is a no-op.
+   * On iOS, triggers the system permission dialog.
+   * On Android 13+, requests POST_NOTIFICATIONS; on older versions, no-op.
    */
   registerForPushNotifications: () => void;
 
+  /**
+   * Get the current push notification authorization status.
+   * On Android, uses POST_NOTIFICATIONS (API 33+); on older versions returns 'authorized'.
+   * On iOS, use PushNotificationIOS.checkPermissions instead; this method is for Android parity.
+   * @returns Promise resolving to 'authorized' | 'denied' | 'notDetermined'
+   */
+  getPushAuthorizationStatus: () => Promise<string>;
+
   /**
    * Register the device token received from APNs (simple version without callback).
    * iOS only - Android is a no-op.

package/src/index.tsx

@@ -149,13 +149,13 @@ function exportDebugLogs(): Promise<string> {
 }
 
 // =============================================================================
-// Push Notification Methods (iOS only - Android is no-op with TODO stubs)
+// Push Notification Methods (iOS and Android)
 // =============================================================================
 
 /**
  * Request push notification permission from the user.
  * On iOS, this will trigger the system permission dialog.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android 13+, this requests POST_NOTIFICATIONS; on older versions, no-op.
  *
  * @example
  * ```typescript
@@ -169,12 +169,30 @@ function registerForPushNotifications(): void {
   AttentiveReactNativeSdk.registerForPushNotifications()
 }
 
+/**
+ * Get the current push notification authorization status.
+ * On Android, uses the SDK's native check (POST_NOTIFICATIONS on API 33+).
+ * On iOS, uses UNUserNotificationCenter notification settings.
+ *
+ * @returns Promise resolving to 'authorized' | 'denied' | 'notDetermined' (and on iOS possibly 'provisional' | 'ephemeral')
+ *
+ * @example
+ * ```typescript
+ * import { getPushAuthorizationStatus, handleRegularOpen } from 'attentive-react-native-sdk';
+ *
+ * getPushAuthorizationStatus().then((status) => handleRegularOpen(status));
+ * ```
+ */
+function getPushAuthorizationStatus(): Promise<PushAuthorizationStatus> {
+  return AttentiveReactNativeSdk.getPushAuthorizationStatus() as Promise<PushAuthorizationStatus>
+}
+
 /**
  * Register the device token received from APNs/FCM with the Attentive backend.
  * Call this from your AppDelegate's didRegisterForRemoteNotificationsWithDeviceToken.
  *
  * On iOS, the token should be the hex-encoded string representation of the device token Data.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param token - The device token as a hex-encoded string
  * @param authorizationStatus - Current push authorization status
@@ -200,7 +218,7 @@ function registerDeviceToken(
  *
  * On iOS, this will register the device token with the Attentive SDK and invoke the callback
  * after the registration completes (success or failure).
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param token - The hex-encoded device token string from APNs
  * @param authorizationStatus - Current push authorization status
@@ -260,7 +278,7 @@ function registerDeviceTokenWithCallback(
  *
  * On iOS, this will notify the Attentive SDK that the app was opened directly
  * (not from a push notification tap).
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param authorizationStatus - Current push authorization status
  *
@@ -307,7 +325,7 @@ function handleRegularOpen(authorizationStatus: PushAuthorizationStatus): void {
  *
  * On iOS, this will track the push open event and handle the notification appropriately
  * based on whether the app was in the foreground, background, or not running.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param applicationState - The app state when the notification was opened ('active', 'inactive', 'background')
@@ -342,7 +360,7 @@ function handlePushOpened(
  * Call this from your notification handler when a notification is received while the app is active.
  *
  * On iOS, this allows the Attentive SDK to track the notification event.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  *
@@ -372,7 +390,7 @@ function handleForegroundNotification(
  * ```
  *
  * On iOS, this properly tracks foreground push notifications.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param authorizationStatus - Current push authorization status
@@ -411,7 +429,7 @@ function handleForegroundPush(
  * ```
  *
  * On iOS, this properly tracks push notification opens.
- * On Android, this is currently a no-op (TODO: implement FCM integration).
+ * On Android, registers the FCM token when provided by the host app.
  *
  * @param userInfo - The notification payload from the push notification
  * @param authorizationStatus - Current push authorization status
@@ -451,8 +469,9 @@ export {
   recordCustomEvent,
   invokeAttentiveDebugHelper,
   exportDebugLogs,
-  // Push Notification Methods (iOS only)
+  // Push Notification Methods
   registerForPushNotifications,
+  getPushAuthorizationStatus,
   registerDeviceToken,
   registerDeviceTokenWithCallback,
   handleRegularOpen,