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

package/lib/typescript/NativeAttentiveReactNativeSdk.d.ts

@@ -1,4 +1,4 @@
-import type { TurboModule } from "react-native/Libraries/TurboModule/RCTExport";
+import type { TurboModule } from 'react-native/Libraries/TurboModule/RCTExport';
 export interface Spec extends TurboModule {
     initialize: (attentiveDomain: string, mode: string, skipFatigueOnCreatives: boolean, enableDebugger: boolean) => void;
     triggerCreative: (creativeId?: string) => void;
@@ -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.
@@ -97,6 +105,17 @@ export interface Spec extends TurboModule {
      * @param authorizationStatus - Current push authorization status
      */
     handlePushOpen: (userInfo: Object, authorizationStatus: string) => void;
+    /**
+     * Returns the push notification payload that launched the app from a killed state
+     * (i.e. the user tapped a notification when the app was not running), then clears it
+     * so it is only delivered once.
+     *
+     * Android only — on iOS use `PushNotificationIOS.getInitialNotification()` instead.
+     *
+     * @returns Promise resolving to a notification data map, or null if the app was not
+     *          launched from a push notification tap.
+     */
+    getInitialPushNotification: () => Promise<Object | null>;
 }
 declare const _default: Spec | null;
 export default _default;

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":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,8CAA8C,CAAA;AAG/E,MAAM,WAAW,IAAK,SAAQ,WAAW;IACvC,UAAU,EAAE,CACV,eAAe,EAAE,MAAM,EACvB,IAAI,EAAE,MAAM,EACZ,sBAAsB,EAAE,OAAO,EAC/B,cAAc,EAAE,OAAO,KACpB,IAAI,CAAA;IACT,eAAe,EAAE,CAAC,UAAU,CAAC,EAAE,MAAM,KAAK,IAAI,CAAA;IAC9C,eAAe,EAAE,MAAM,IAAI,CAAA;IAC3B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAA;IACtC,QAAQ,EAAE,CACR,KAAK,CAAC,EAAE,MAAM,EACd,KAAK,CAAC,EAAE,MAAM,EACd,SAAS,CAAC,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,MAAM,EAClB,YAAY,CAAC,EAAE,MAAM,EACrB,iBAAiB,CAAC,EAAE,MAAM,KACvB,IAAI,CAAA;IACT,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,oBAAoB,EAAE,CACpB,KAAK,EAAE,KAAK,CAAC;QACX,SAAS,EAAE,MAAM,CAAA;QACjB,gBAAgB,EAAE,MAAM,CAAA;QACxB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAC,EACF,QAAQ,CAAC,EAAE,MAAM,KACd,IAAI,CAAA;IACT,sBAAsB,EAAE,CACtB,KAAK,EAAE,KAAK,CAAC;QACX,SAAS,EAAE,MAAM,CAAA;QACjB,gBAAgB,EAAE,MAAM,CAAA;QACxB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAC,EACF,QAAQ,CAAC,EAAE,MAAM,KACd,IAAI,CAAA;IACT,mBAAmB,EAAE,CACnB,KAAK,EAAE,KAAK,CAAC;QACX,SAAS,EAAE,MAAM,CAAA;QACjB,gBAAgB,EAAE,MAAM,CAAA;QACxB,KAAK,EAAE,MAAM,CAAA;QACb,QAAQ,EAAE,MAAM,CAAA;QAChB,YAAY,CAAC,EAAE,MAAM,CAAA;QACrB,IAAI,CAAC,EAAE,MAAM,CAAA;QACb,QAAQ,CAAC,EAAE,MAAM,CAAA;QACjB,QAAQ,CAAC,EAAE,MAAM,CAAA;KAClB,CAAC,EACF,OAAO,EAAE,MAAM,EACf,MAAM,CAAC,EAAE,MAAM,EACf,UAAU,CAAC,EAAE,MAAM,KAChB,IAAI,CAAA;IACT,iBAAiB,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,KAAK,IAAI,CAAA;IAC7D,0BAA0B,EAAE,MAAM,IAAI,CAAA;IACtC,eAAe,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAGtC;;;;OAIG;IACH,4BAA4B,EAAE,MAAM,IAAI,CAAA;IAExC;;;;;OAKG;IACH,0BAA0B,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,CAAA;IAEjD;;;;;OAKG;IACH,mBAAmB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,KAAK,IAAI,CAAA;IAEzE;;;;;;;OAOG;IACH,+BAA+B,EAAE,CAC/B,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,MAAM,EAC3B,QAAQ,EAAE,CACR,IAAI,CAAC,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,KACX,IAAI,KACN,IAAI,CAAA;IAET;;;;;OAKG;IACH,iBAAiB,EAAE,CAAC,mBAAmB,EAAE,MAAM,KAAK,IAAI,CAAA;IAExD;;;;;;OAMG;IACH,gBAAgB,EAAE,CAChB,QAAQ,EAAE,MAAM,EAChB,gBAAgB,EAAE,MAAM,EACxB,mBAAmB,EAAE,MAAM,KACxB,IAAI,CAAA;IAET;;;;OAIG;IACH,4BAA4B,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,IAAI,CAAA;IAExD;;;;;;OAMG;IACH,oBAAoB,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,KAAK,IAAI,CAAA;IAE7E;;;;;;OAMG;IACH,cAAc,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,KAAK,IAAI,CAAA;IAEvE;;;;;;;;;OASG;IACH,0BAA0B,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAA;CACzD;;AAUD,wBAA2D"}

package/lib/typescript/index.d.ts

@@ -1,6 +1,11 @@
 import type { UserIdentifiers, AttentiveSdkConfiguration, ProductView, Purchase, AddToCart, CustomEvent, Item, PushAuthorizationStatus, ApplicationState, PushNotificationUserInfo, PushRegistrationResult } from './eventTypes';
 /**
- * Initialize the Attentive SDK with the provided configuration
+ * Initialize the Attentive SDK with the provided configuration.
+ * This is the only supported entry point: the app (e.g. Bonni) must call this from TypeScript
+ * once at startup; the call is forwarded to the native module on each platform (iOS/Android),
+ * which then initializes the platform Attentive SDK. Native code must not initialize the SDK
+ * on its own (e.g. in Application onCreate or AppDelegate).
+ *
  * @param configuration - Configuration object for the Attentive SDK
  */
 declare function initialize(configuration: AttentiveSdkConfiguration): void;
@@ -59,7 +64,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 +75,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 +115,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 +159,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 +195,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 +219,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 +244,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 +274,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 +292,31 @@ 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, };
+/**
+ * Returns the push notification payload that launched the app from a killed state
+ * (i.e. the user tapped an FCM notification while the app was not running) and clears
+ * it so it is only delivered once.
+ *
+ * **Android only.** On iOS, use `PushNotificationIOS.getInitialNotification()` to
+ * achieve the same result — the Attentive iOS SDK event is tracked natively in
+ * `AppDelegate.userNotificationCenter(_:didReceive:withCompletionHandler:)` via
+ * `AttentiveSDKManager.shared`.
+ *
+ * Call this once at app startup (after `initialize()`) to detect and handle the
+ * killed-state push-open scenario:
+ *
+ * ```typescript
+ * const initial = await getInitialPushNotification()
+ * if (initial) {
+ *   const authStatus = await getPushAuthorizationStatus()
+ *   handlePushOpen(initial as PushNotificationUserInfo, authStatus)
+ * }
+ * ```
+ *
+ * @returns A promise that resolves to the notification data object, or `null` if the
+ *          app was not launched via a push notification tap.
+ */
+declare function getInitialPushNotification(): Promise<Record<string, string> | null>;
+export { initialize, triggerCreative, destroyCreative, updateDomain, identify, clearUser, recordAddToCartEvent, recordProductViewEvent, recordPurchaseEvent, recordCustomEvent, invokeAttentiveDebugHelper, exportDebugLogs, registerForPushNotifications, getPushAuthorizationStatus, registerDeviceToken, registerDeviceTokenWithCallback, handleRegularOpen, handlePushOpened, handleForegroundNotification, handleForegroundPush, handlePushOpen, getInitialPushNotification, };
 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":"AACA,OAAO,KAAK,EACV,eAAe,EACf,yBAAyB,EACzB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,IAAI,EACJ,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,EACvB,MAAM,cAAc,CAAA;AA2BrB;;;GAGG;AACH,iBAAS,UAAU,CAAC,aAAa,EAAE,yBAAyB,QAO3D;AAED;;;GAGG;AACH,iBAAS,eAAe,CAAC,UAAU,CAAC,EAAE,MAAM,QAE3C;AAED;;GAEG;AACH,iBAAS,eAAe,SAEvB;AAED;;;GAGG;AACH,iBAAS,YAAY,CAAC,MAAM,EAAE,MAAM,QAEnC;AAED;;;GAGG;AACH,iBAAS,QAAQ,CAAC,WAAW,EAAE,eAAe,QAS7C;AAED;;GAEG;AACH,iBAAS,SAAS,SAEjB;AAED;;;GAGG;AACH,iBAAS,oBAAoB,CAAC,KAAK,EAAE,SAAS,QAE7C;AAED;;;GAGG;AACH,iBAAS,sBAAsB,CAAC,KAAK,EAAE,WAAW,QAEjD;AAED;;;GAGG;AACH,iBAAS,mBAAmB,CAAC,KAAK,EAAE,QAAQ,QAO3C;AAED;;;GAGG;AACH,iBAAS,iBAAiB,CAAC,KAAK,EAAE,WAAW,QAE5C;AAED;;GAEG;AACH,iBAAS,0BAA0B,SAElC;AAED;;;GAGG;AACH,iBAAS,eAAe,IAAI,OAAO,CAAC,MAAM,CAAC,CAE1C;AAMD;;;;;;;;;;;;GAYG;AACH,iBAAS,4BAA4B,IAAI,IAAI,CAE5C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,iBAAS,mBAAmB,CAC1B,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,uBAAuB,GAC3C,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,iBAAS,+BAA+B,CACtC,KAAK,EAAE,MAAM,EACb,mBAAmB,EAAE,uBAAuB,EAC5C,QAAQ,EAAE,CACR,IAAI,CAAC,EAAE,MAAM,EACb,GAAG,CAAC,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,MAAM,EACjB,KAAK,CAAC,EAAE,MAAM,KACX,IAAI,GACR,IAAI,CAMN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiDG;AACH,iBAAS,iBAAiB,CAAC,mBAAmB,EAAE,uBAAuB,GAAG,IAAI,CAU7E;AAED;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,iBAAS,gBAAgB,CACvB,QAAQ,EAAE,wBAAwB,EAClC,gBAAgB,EAAE,gBAAgB,EAClC,mBAAmB,EAAE,uBAAuB,GAC3C,IAAI,CAMN;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,iBAAS,4BAA4B,CACnC,QAAQ,EAAE,wBAAwB,GACjC,IAAI,CAEN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,iBAAS,oBAAoB,CAC3B,QAAQ,EAAE,wBAAwB,EAClC,mBAAmB,EAAE,uBAAuB,GAC3C,IAAI,CAKN;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,iBAAS,cAAc,CACrB,QAAQ,EAAE,wBAAwB,EAClC,mBAAmB,EAAE,uBAAuB,GAC3C,IAAI,CAKN;AAED,OAAO,EACL,UAAU,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,QAAQ,EACR,SAAS,EACT,oBAAoB,EACpB,sBAAsB,EACtB,mBAAmB,EACnB,iBAAiB,EACjB,0BAA0B,EAC1B,eAAe,EAEf,4BAA4B,EAC5B,mBAAmB,EACnB,+BAA+B,EAC/B,iBAAiB,EACjB,gBAAgB,EAChB,4BAA4B,EAC5B,oBAAoB,EACpB,cAAc,GACf,CAAA;AAED,YAAY,EACV,eAAe,EACf,yBAAyB,EACzB,WAAW,EACX,QAAQ,EACR,SAAS,EACT,WAAW,EACX,IAAI,EAEJ,uBAAuB,EACvB,gBAAgB,EAChB,wBAAwB,EACxB,sBAAsB,GACvB,CAAA"}
+{"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.6",
   "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",
@@ -176,6 +180,7 @@
     }
   },
   "dependencies": {
-    "@babel/runtime": "^7.27.0"
+    "@babel/runtime": "^7.27.0",
+    "metro-react-native-babel-preset": "^0.77.0"
   }
 }

package/src/NativeAttentiveReactNativeSdk.ts

@@ -1,5 +1,5 @@
-import type { TurboModule } from "react-native/Libraries/TurboModule/RCTExport";
-import { TurboModuleRegistry, NativeModules } from "react-native";
+import type { TurboModule } from 'react-native/Libraries/TurboModule/RCTExport'
+import { TurboModuleRegistry, NativeModules } from 'react-native'
 
 export interface Spec extends TurboModule {
   initialize: (
@@ -7,10 +7,10 @@ export interface Spec extends TurboModule {
     mode: string,
     skipFatigueOnCreatives: boolean,
     enableDebugger: boolean
-  ) => void;
-  triggerCreative: (creativeId?: string) => void;
-  destroyCreative: () => void;
-  updateDomain: (domain: string) => void;
+  ) => void
+  triggerCreative: (creativeId?: string) => void
+  destroyCreative: () => void
+  updateDomain: (domain: string) => void
   identify: (
     phone?: string,
     email?: string,
@@ -18,59 +18,68 @@ export interface Spec extends TurboModule {
     shopifyId?: string,
     clientUserId?: string,
     customIdentifiers?: Object
-  ) => void;
-  clearUser: () => void;
+  ) => void
+  clearUser: () => void
   recordAddToCartEvent: (
     items: Array<{
-      productId: string;
-      productVariantId: string;
-      price: string;
-      currency: string;
-      productImage?: string;
-      name?: string;
-      quantity?: number;
-      category?: string;
+      productId: string
+      productVariantId: string
+      price: string
+      currency: string
+      productImage?: string
+      name?: string
+      quantity?: number
+      category?: string
     }>,
     deeplink?: string
-  ) => void;
+  ) => void
   recordProductViewEvent: (
     items: Array<{
-      productId: string;
-      productVariantId: string;
-      price: string;
-      currency: string;
-      productImage?: string;
-      name?: string;
-      quantity?: number;
-      category?: string;
+      productId: string
+      productVariantId: string
+      price: string
+      currency: string
+      productImage?: string
+      name?: string
+      quantity?: number
+      category?: string
     }>,
     deeplink?: string
-  ) => void;
+  ) => void
   recordPurchaseEvent: (
     items: Array<{
-      productId: string;
-      productVariantId: string;
-      price: string;
-      currency: string;
-      productImage?: string;
-      name?: string;
-      quantity?: number;
-      category?: string;
+      productId: string
+      productVariantId: string
+      price: string
+      currency: string
+      productImage?: string
+      name?: string
+      quantity?: number
+      category?: string
     }>,
     orderId: string,
     cartId?: string,
     cartCoupon?: string
-  ) => void;
-  recordCustomEvent: (type: string, properties: Object) => void;
-  invokeAttentiveDebugHelper: () => void;
-  exportDebugLogs: () => Promise<string>;
+  ) => void
+  recordCustomEvent: (type: string, properties: Object) => void
+  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'
    */
-  registerForPushNotifications: () => void;
+  getPushAuthorizationStatus: () => Promise<string>
 
   /**
    * Register the device token received from APNs (simple version without callback).
@@ -78,7 +87,7 @@ export interface Spec extends TurboModule {
    * @param token - The hex-encoded device token string
    * @param authorizationStatus - Current push authorization status
    */
-  registerDeviceToken: (token: string, authorizationStatus: string) => void;
+  registerDeviceToken: (token: string, authorizationStatus: string) => void
 
   /**
    * Register the device token received from APNs with a callback.
@@ -91,8 +100,13 @@ export interface Spec extends TurboModule {
   registerDeviceTokenWithCallback: (
     token: string,
     authorizationStatus: string,
-    callback: (data?: Object, url?: string, response?: Object, error?: Object) => void
-  ) => void;
+    callback: (
+      data?: Object,
+      url?: string,
+      response?: Object,
+      error?: Object
+    ) => void
+  ) => void
 
   /**
    * Handle regular/direct app open (not from a push notification).
@@ -100,7 +114,7 @@ export interface Spec extends TurboModule {
    * This should be called after device token registration to track app opens.
    * @param authorizationStatus - Current push authorization status
    */
-  handleRegularOpen: (authorizationStatus: string) => void;
+  handleRegularOpen: (authorizationStatus: string) => void
 
   /**
    * Handle when a push notification is opened by the user.
@@ -113,14 +127,14 @@ export interface Spec extends TurboModule {
     userInfo: Object,
     applicationState: string,
     authorizationStatus: string
-  ) => void;
+  ) => void
 
   /**
    * Handle when a push notification arrives while the app is in foreground.
    * iOS only - Android is a no-op.
    * @param userInfo - The notification payload
    */
-  handleForegroundNotification: (userInfo: Object) => void;
+  handleForegroundNotification: (userInfo: Object) => void
 
   /**
    * Handle a push notification when the app is in the foreground (active state).
@@ -129,7 +143,7 @@ export interface Spec extends TurboModule {
    * @param userInfo - The notification payload
    * @param authorizationStatus - Current push authorization status
    */
-  handleForegroundPush: (userInfo: Object, authorizationStatus: string) => void;
+  handleForegroundPush: (userInfo: Object, authorizationStatus: string) => void
 
   /**
    * Handle when a push notification is opened by the user (app in background/inactive state).
@@ -138,15 +152,27 @@ export interface Spec extends TurboModule {
    * @param userInfo - The notification payload
    * @param authorizationStatus - Current push authorization status
    */
-  handlePushOpen: (userInfo: Object, authorizationStatus: string) => void;
+  handlePushOpen: (userInfo: Object, authorizationStatus: string) => void
+
+  /**
+   * Returns the push notification payload that launched the app from a killed state
+   * (i.e. the user tapped a notification when the app was not running), then clears it
+   * so it is only delivered once.
+   *
+   * Android only — on iOS use `PushNotificationIOS.getInitialNotification()` instead.
+   *
+   * @returns Promise resolving to a notification data map, or null if the app was not
+   *          launched from a push notification tap.
+   */
+  getInitialPushNotification: () => Promise<Object | null>
 }
 
 // Try to load via TurboModule first (new architecture)
 // Fall back to NativeModules for old architecture
-const isTurboModuleEnabled = (global as any).__turboModuleProxy != null;
+const isTurboModuleEnabled = (global as any).__turboModuleProxy != null
 
 const AttentiveReactNativeSdkModule = isTurboModuleEnabled
-  ? TurboModuleRegistry.get<Spec>("AttentiveReactNativeSdk")
-  : NativeModules.AttentiveReactNativeSdk;
+  ? TurboModuleRegistry.get<Spec>('AttentiveReactNativeSdk')
+  : NativeModules.AttentiveReactNativeSdk
 
-export default AttentiveReactNativeSdkModule as Spec | null;
+export default AttentiveReactNativeSdkModule as Spec | null

package/src/index.tsx

@@ -39,7 +39,12 @@ const AttentiveReactNativeSdk = (
 ) as Spec
 
 /**
- * Initialize the Attentive SDK with the provided configuration
+ * Initialize the Attentive SDK with the provided configuration.
+ * This is the only supported entry point: the app (e.g. Bonni) must call this from TypeScript
+ * once at startup; the call is forwarded to the native module on each platform (iOS/Android),
+ * which then initializes the platform Attentive SDK. Native code must not initialize the SDK
+ * on its own (e.g. in Application onCreate or AppDelegate).
+ *
  * @param configuration - Configuration object for the Attentive SDK
  */
 function initialize(configuration: AttentiveSdkConfiguration) {
@@ -149,13 +154,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 +174,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 +223,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 +283,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 +330,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 +365,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 +395,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 +434,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
@@ -438,6 +461,35 @@ function handlePushOpen(
   )
 }
 
+/**
+ * Returns the push notification payload that launched the app from a killed state
+ * (i.e. the user tapped an FCM notification while the app was not running) and clears
+ * it so it is only delivered once.
+ *
+ * **Android only.** On iOS, use `PushNotificationIOS.getInitialNotification()` to
+ * achieve the same result — the Attentive iOS SDK event is tracked natively in
+ * `AppDelegate.userNotificationCenter(_:didReceive:withCompletionHandler:)` via
+ * `AttentiveSDKManager.shared`.
+ *
+ * Call this once at app startup (after `initialize()`) to detect and handle the
+ * killed-state push-open scenario:
+ *
+ * ```typescript
+ * const initial = await getInitialPushNotification()
+ * if (initial) {
+ *   const authStatus = await getPushAuthorizationStatus()
+ *   handlePushOpen(initial as PushNotificationUserInfo, authStatus)
+ * }
+ * ```
+ *
+ * @returns A promise that resolves to the notification data object, or `null` if the
+ *          app was not launched via a push notification tap.
+ */
+async function getInitialPushNotification(): Promise<Record<string, string> | null> {
+  const result = await AttentiveReactNativeSdk.getInitialPushNotification()
+  return result as Record<string, string> | null
+}
+
 export {
   initialize,
   triggerCreative,
@@ -451,8 +503,9 @@ export {
   recordCustomEvent,
   invokeAttentiveDebugHelper,
   exportDebugLogs,
-  // Push Notification Methods (iOS only)
+  // Push Notification Methods
   registerForPushNotifications,
+  getPushAuthorizationStatus,
   registerDeviceToken,
   registerDeviceTokenWithCallback,
   handleRegularOpen,
@@ -460,6 +513,7 @@ export {
   handleForegroundNotification,
   handleForegroundPush,
   handlePushOpen,
+  getInitialPushNotification,
 }
 
 export type {