@posthog/react-native-plugin 2.2.4 → 2.3.0

package/android/build.gradle

@@ -85,6 +85,6 @@ dependencies {
   //noinspection GradleDynamicVersion
   implementation "com.facebook.react:react-native:+"
   implementation "org.jetbrains.kotlin:kotlin-stdlib:$kotlin_version"
-  implementation "com.posthog:posthog-android:3.54.0"
+  implementation "com.posthog:posthog-android:3.58.0"
 }
 

package/android/src/main/java/com/posthogreactnativeplugin/PosthogReactNativePluginModule.kt

@@ -1,6 +1,8 @@
 package com.posthogreactnativeplugin
 
+import android.content.Intent
 import android.util.Log
+import com.facebook.react.bridge.Arguments
 import com.facebook.react.bridge.Promise
 import com.facebook.react.bridge.ReactApplicationContext
 import com.facebook.react.bridge.ReactContextBaseJavaModule
@@ -8,6 +10,7 @@ import com.facebook.react.bridge.ReactMethod
 import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.bridge.UiThreadUtil
 import com.facebook.react.common.JavascriptException
+import com.facebook.react.modules.core.DeviceEventManagerModule
 import com.posthog.PostHog
 import com.posthog.PostHogConfig
 import com.posthog.android.PostHogAndroid
@@ -42,6 +45,7 @@ class PosthogReactNativePluginModule(
       decideReplayConfig = getMap(sessionReplayConfig, "decideReplayConfig"),
       nativeErrorTrackingAutocapture = getBoolean(errorTrackingConfig, "nativeAutocapture", false),
       exceptionStepsConfig = getMap(errorTrackingConfig, "exceptionSteps"),
+      pushConfig = getMap(pluginConfig, "push"),
       promise = promise,
     )
   }
@@ -63,6 +67,7 @@ class PosthogReactNativePluginModule(
       decideReplayConfig = decideReplayConfig,
       nativeErrorTrackingAutocapture = false,
       exceptionStepsConfig = null,
+      pushConfig = null,
       promise = promise,
     )
   }
@@ -76,6 +81,7 @@ class PosthogReactNativePluginModule(
     decideReplayConfig: ReadableMap?,
     nativeErrorTrackingAutocapture: Boolean,
     exceptionStepsConfig: ReadableMap?,
+    pushConfig: ReadableMap?,
     promise: Promise,
   ) {
     val initRunnable =
@@ -92,6 +98,9 @@ class PosthogReactNativePluginModule(
           val anonymousId = getString(sdkOptions, "anonymousId", "")
           val theSdkVersion = getString(sdkOptions, "sdkVersion", "")
           val theFlushAt = getInt(sdkOptions, "flushAt", DEFAULT_FLUSH_AT)
+          val theOptOut = getBoolean(sdkOptions, "optOut", false)
+          // Default true: an older JS layer that never sends this keeps native's own fetch.
+          val thePreloadFeatureFlags = getBoolean(sdkOptions, "preloadFeatureFlags", true)
 
           // Forward custom headers (e.g. Authorization for a reverse proxy) so the native SDK
           // attaches them to the requests it sends directly (session replay, crash uploads).
@@ -104,6 +113,8 @@ class PosthogReactNativePluginModule(
           val config =
             PostHogAndroidConfig(apiKey, host).apply {
               debug = debugValue
+              optOut = theOptOut
+              preloadFeatureFlags = thePreloadFeatureFlags
               captureDeepLinks = false
               captureApplicationLifecycleEvents = false
               captureScreenViews = false
@@ -153,6 +164,25 @@ class PosthogReactNativePluginModule(
                 snapshotEndpoint = endpoint
               }
 
+              // Only set when present: the legacy start() path predates push, and there the
+              // native defaults (both true) must win, matching posthog-android on its own.
+              if (hasKey(pushConfig, "capturePushNotificationSubscriptions")) {
+                capturePushNotificationSubscriptions =
+                  getBoolean(pushConfig, "capturePushNotificationSubscriptions", true)
+              }
+              if (hasKey(pushConfig, "capturePushNotificationOpened")) {
+                capturePushNotificationOpened = getBoolean(pushConfig, "capturePushNotificationOpened", true)
+              }
+
+              // Installed only when JS asked for it: an uninvited bridging provider would
+              // change how the native SDK handles a 401 on the subscription call.
+              if (getBoolean(pushConfig, "pushIdentityProviderEnabled", false)) {
+                pushModule = this@PosthogReactNativePluginModule
+                pushIdentityProvider = { distinctId, appId, completion ->
+                  requestPushIdentityToken(distinctId, appId, completion)
+                }
+              }
+
               if (theSdkVersion.isNotEmpty()) {
                 sdkName = "posthog-react-native"
                 sdkVersion = theSdkVersion
@@ -161,6 +191,8 @@ class PosthogReactNativePluginModule(
           PostHogAndroid.setup(context, config)
 
           setIdentify(config.cachePreferences, distinctId, anonymousId)
+
+          captureColdStartPushOpenIfNeeded(config)
         } catch (e: Throwable) {
           logError(method, e)
         } finally {
@@ -228,6 +260,50 @@ class PosthogReactNativePluginModule(
     }
   }
 
+  // Calls the native SDK rather than writing preferences like identify() does: reset() is what
+  // unregisters the logged-out user's push subscription and re-registers under the new identity.
+  @ReactMethod
+  fun reset(
+    distinctId: String,
+    anonymousId: String,
+    promise: Promise,
+  ) {
+    try {
+      PostHog.reset()
+      // Native reset() mints its own anonymous id; overwrite it with the JS one so the two
+      // SDKs stay on the same identity. Must run after reset(), which needs the pre-reset
+      // distinctId to know which subscription to unregister. Known gap (as on iOS): native's
+      // async push re-registration can read the identity before this write lands and register
+      // under a throwaway id; retryPending() converges it on the next flush.
+      setIdentify(PostHog.getConfig<PostHogConfig>()?.cachePreferences, distinctId, anonymousId)
+    } catch (e: Throwable) {
+      logError("reset", e)
+    } finally {
+      promise.resolve(null)
+    }
+  }
+
+  // Runtime consent changes must reach native: it persists its own opt-out flag and only reads
+  // the JS value at setup(), so a refreshed FCM token could otherwise auto-register after the
+  // user opted out. optIn() also resumes deferred push work on the next flush.
+  @ReactMethod
+  fun setOptOut(
+    optOut: Boolean,
+    promise: Promise,
+  ) {
+    try {
+      if (optOut) {
+        PostHog.optOut()
+      } else {
+        PostHog.optIn()
+      }
+    } catch (e: Throwable) {
+      logError("setOptOut", e)
+    } finally {
+      promise.resolve(null)
+    }
+  }
+
   private fun setIdentify(
     cachePreferences: PostHogPreferences?,
     distinctId: String,
@@ -333,15 +409,228 @@ class PosthogReactNativePluginModule(
     Log.println(Log.ERROR, POSTHOG_TAG, "Method $method, error: $error")
   }
 
+  // These reject instead of this module's usual swallow-and-resolve convention: a failed
+  // registration is a distinct signal, not a silent success. The JS layer's public methods
+  // never throw, so the rejection is what gives it something to log.
+  @ReactMethod
+  fun registerPushNotificationToken(
+    deviceToken: String?,
+    appId: String?,
+    promise: Promise,
+  ) {
+    try {
+      if (deviceToken.isNullOrBlank()) {
+        // A blank token is dropped silently by the native SDK, so surface it here
+        // instead of reporting false success.
+        promise.reject(
+          PUSH_ERROR_CODE,
+          "registerPushNotificationToken: deviceToken is blank; token not registered.",
+        )
+        return
+      }
+      val resolvedAppId = appId?.trim()?.takeIf { it.isNotEmpty() } ?: firebaseProjectId
+      if (resolvedAppId.isNullOrEmpty()) {
+        val message =
+          "registerPushNotificationToken: no appId provided and no Firebase project id " +
+            "could be resolved, skipping. Pass appId explicitly if this app does not use Firebase."
+        Log.w(POSTHOG_TAG, message)
+        promise.reject(PUSH_ERROR_CODE, message)
+        return
+      }
+      PostHog.registerPushNotificationToken(deviceToken, resolvedAppId)
+      promise.resolve(null)
+    } catch (e: Throwable) {
+      logError("registerPushNotificationToken", e)
+      promise.reject(PUSH_ERROR_CODE, e)
+    }
+  }
+
+  @ReactMethod
+  fun unregisterPushNotificationToken(promise: Promise) {
+    try {
+      PostHog.unregisterPushNotificationToken()
+      promise.resolve(null)
+    } catch (e: Throwable) {
+      logError("unregisterPushNotificationToken", e)
+      promise.reject(PUSH_ERROR_CODE, e)
+    }
+  }
+
+  @ReactMethod
+  fun capturePushNotificationOpened(
+    properties: ReadableMap,
+    promise: Promise,
+  ) {
+    try {
+      // subtitle is iOS-only; posthog-android's capturePushNotificationOpened has no
+      // subtitle parameter, so JS's value is dropped here.
+      val title = if (hasKey(properties, "title")) properties.getString("title") else null
+      val body = if (hasKey(properties, "body")) properties.getString("body") else null
+      val payload = if (hasKey(properties, "payload")) properties.getMap("payload")?.toHashMap() else null
+      val action = if (hasKey(properties, "action")) properties.getString("action") else null
+      PostHog.capturePushNotificationOpened(title, body, payload, action)
+      promise.resolve(null)
+    } catch (e: Throwable) {
+      logError("capturePushNotificationOpened", e)
+      promise.reject(PUSH_ERROR_CODE, e)
+    }
+  }
+
+  // posthog-android's open-capture integration registers ActivityLifecycleCallbacks during
+  // setup(), which the bridge reaches only after the launch Activity was created — so the
+  // cold-start tray tap it exists for is the one creation it can never observe here. Read
+  // the launch intent directly, then strip the marker so the integration (or a re-run)
+  // can't capture the same tap again from this intent object.
+  private fun captureColdStartPushOpenIfNeeded(config: PostHogAndroidConfig) {
+    if (!config.capturePushNotificationOpened) {
+      return
+    }
+    val intent = currentActivity?.intent ?: return
+    // A relaunch from recents redelivers the original tray intent to a fresh activity;
+    // capturing it would count a days-old tap as a new open.
+    if (intent.flags and Intent.FLAG_ACTIVITY_LAUNCHED_FROM_HISTORY != 0) {
+      return
+    }
+    try {
+      intent.getStringExtra(GOOGLE_MESSAGE_ID) ?: return
+      // Unmarshalling extras throws BadParcelableException on a Parcelable class this
+      // classloader lacks; read before stripping the marker so a failed read leaves the
+      // intent as the native integration expects it.
+      val payload =
+        intent.extras?.let { bundle ->
+          bundle.keySet().associateWith { key ->
+            @Suppress("DEPRECATION")
+            bundle.get(key)
+          }
+        }
+      intent.removeExtra(GOOGLE_MESSAGE_ID)
+      PostHog.capturePushNotificationOpened(null, null, payload, null)
+    } catch (e: Throwable) {
+      logError("capturePushNotificationOpened", e)
+    }
+  }
+
+  @ReactMethod
+  fun providePushIdentityToken(
+    requestId: String?,
+    token: String?,
+    promise: Promise,
+  ) {
+    try {
+      if (requestId != null) {
+        pushIdentityCompletions.remove(requestId)?.invoke(token)
+      }
+    } catch (e: Throwable) {
+      logError("providePushIdentityToken", e)
+    } finally {
+      promise.resolve(null)
+    }
+  }
+
+  // Required by NativeEventEmitter on the old architecture; events are broadcast via
+  // RCTDeviceEventEmitter, so there is nothing to do here.
+  @ReactMethod
+  fun addListener(eventName: String?) = Unit
+
+  @ReactMethod
+  fun removeListeners(count: Int) = Unit
+
+  override fun invalidate() {
+    if (pushModule === this) {
+      // Decline mints fast after teardown instead of stalling the native 10s watchdog.
+      pushModule = null
+    }
+    super.invalidate()
+  }
+
   companion object {
     const val NAME = "PosthogReactNativePlugin"
     const val POSTHOG_TAG = "PostHog"
 
+    // FCM stamps this extra on the tray-tap launch intent; mirrors posthog-android's
+    // PostHogActivityLifecycleCallbackIntegration.
+    private const val GOOGLE_MESSAGE_ID = "google.message_id"
+
     // Default session replay configuration values
     const val DEFAULT_MASK_ALL_TEXT_INPUTS = true
     const val DEFAULT_MASK_ALL_IMAGES = true
     const val DEFAULT_CAPTURE_LOG = true
     const val DEFAULT_FLUSH_AT = 20
     const val DEFAULT_THROTTLE_DELAY_MS = 1000
+
+    private const val PUSH_ERROR_CODE = "PosthogReactNativePluginError"
+    private const val PUSH_IDENTITY_EVENT = "PostHogPushIdentityRequest"
+    private const val PUSH_IDENTITY_REPLY_TTL_MS = 15_000L
+
+    // Modules die on every bridge reload, so the provider closure resolves the live
+    // module through this static reference at call time, not a captured setup-time one.
+    @Volatile
+    private var pushModule: PosthogReactNativePluginModule? = null
+
+    private val pushIdentityCompletions = java.util.concurrent.ConcurrentHashMap<String, (String?) -> Unit>()
+
+    private fun requestPushIdentityToken(
+      distinctId: String,
+      appId: String,
+      completion: (String?) -> Unit,
+    ) {
+      val module = pushModule
+      val context = module?.reactApplicationContext
+      if (module == null || context == null || !context.hasActiveReactInstance()) {
+        declinePushIdentity(completion, "no React instance attached")
+        return
+      }
+      val requestId = UUID.randomUUID().toString()
+      pushIdentityCompletions[requestId] = completion
+      try {
+        val params =
+          Arguments.createMap().apply {
+            putString("requestId", requestId)
+            putString("distinctId", distinctId)
+            putString("appId", appId)
+          }
+        context
+          .getJSModule(DeviceEventManagerModule.RCTDeviceEventEmitter::class.java)
+          .emit(PUSH_IDENTITY_EVENT, params)
+      } catch (e: Throwable) {
+        pushIdentityCompletions.remove(requestId)
+        declinePushIdentity(completion, "failed to reach JS: ${e.message}")
+        return
+      }
+      // The native SDK's own 10s mint watchdog handles the fallback; this only drops the
+      // entry so a late JS reply is ignored and the completion doesn't leak.
+      UiThreadUtil.runOnUiThread({ pushIdentityCompletions.remove(requestId) }, PUSH_IDENTITY_REPLY_TTL_MS)
+    }
+
+    // A null identity token sends the request unauthenticated, which a project requiring
+    // identity verification rejects server-side. Log the reason so that failure is
+    // greppable and distinct from a host that deliberately returned null.
+    private fun declinePushIdentity(
+      completion: (String?) -> Unit,
+      reason: String,
+    ) {
+      Log.w(POSTHOG_TAG, "Push subscription will be sent unauthenticated: $reason")
+      completion(null)
+    }
+
+    @Volatile private var cachedFirebaseProjectId: String? = null
+
+    // No Firebase dependency here, so the project id is looked up reflectively and any
+    // failure (class missing, Firebase not initialized) is swallowed. Only a successful lookup
+    // is cached: getInstance() throws until Firebase initializes, so memoizing the null would
+    // strand every later token-refresh call with no resolvable appId for the process lifetime.
+    private val firebaseProjectId: String?
+      get() =
+        cachedFirebaseProjectId
+          ?: try {
+            val firebaseAppClass = Class.forName("com.google.firebase.FirebaseApp")
+            val firebaseApp = firebaseAppClass.getMethod("getInstance").invoke(null)
+            val options = firebaseAppClass.getMethod("getOptions").invoke(firebaseApp)
+            (options?.javaClass?.getMethod("getProjectId")?.invoke(options) as? String)?.also {
+              cachedFirebaseProjectId = it
+            }
+          } catch (e: Throwable) {
+            null
+          }
   }
 }

package/ios/PosthogReactNativePlugin-Bridging-Header.h

@@ -1,2 +1,3 @@
 #import <React/RCTBridgeModule.h>
 #import <React/RCTViewManager.h>
+#import <React/RCTEventEmitter.h>

package/ios/PosthogReactNativePlugin.mm

@@ -1,6 +1,7 @@
 #import <React/RCTBridgeModule.h>
+#import <React/RCTEventEmitter.h>
 
-@interface RCT_EXTERN_MODULE(PosthogReactNativePlugin, NSObject)
+@interface RCT_EXTERN_MODULE(PosthogReactNativePlugin, RCTEventEmitter)
 
 RCT_EXTERN_METHOD(setup:(NSString)sessionId
                  withSdkOptions:(NSDictionary)sdkOptions
@@ -42,6 +43,32 @@ RCT_EXTERN_METHOD(addExceptionStep:(NSString)message
                  withResolver:(RCTPromiseResolveBlock)resolve
                  withRejecter:(RCTPromiseRejectBlock)reject)
 
+RCT_EXTERN_METHOD(reset:(NSString)distinctId
+                 withAnonymousId:(NSString)anonymousId
+                 withResolver:(RCTPromiseResolveBlock)resolve
+                 withRejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(registerPushNotificationToken:(NSString)deviceToken
+                 withAppId:(NSString)appId
+                 withResolver:(RCTPromiseResolveBlock)resolve
+                 withRejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(unregisterPushNotificationToken:(RCTPromiseResolveBlock)resolve
+                 withRejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(setOptOut:(BOOL)optOut
+                 withResolver:(RCTPromiseResolveBlock)resolve
+                 withRejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(capturePushNotificationOpened:(NSDictionary)properties
+                 withResolver:(RCTPromiseResolveBlock)resolve
+                 withRejecter:(RCTPromiseRejectBlock)reject)
+
+RCT_EXTERN_METHOD(providePushIdentityToken:(NSString)requestId
+                 withToken:(NSString)token
+                 withResolver:(RCTPromiseResolveBlock)resolve
+                 withRejecter:(RCTPromiseRejectBlock)reject)
+
 + (BOOL)requiresMainQueueSetup
 {
   return NO;

package/ios/PosthogReactNativePlugin.swift

@@ -46,10 +46,40 @@ private func isReactNativeFatalJsError(_ event: PostHogEvent) -> Bool {
     }
 }
 
+// A nil identity token sends the request unauthenticated, which a project requiring
+// identity verification rejects server-side. Log the reason so that failure is greppable
+// and distinct from a host that deliberately returned nil.
+private func declinePushIdentity(_ completion: (String?) -> Void, _ reason: String) {
+    hedgeLog("Push subscription will be sent unauthenticated: \(reason)")
+    completion(nil)
+}
+
 @objc(PosthogReactNativePlugin)
-class PosthogReactNativePlugin: NSObject {
+class PosthogReactNativePlugin: RCTEventEmitter {
     private var config: PostHogConfig?
 
+    private static let pushIdentityEvent = "PostHogPushIdentityRequest"
+
+    // This module dies on every bridge reload, so the provider closure resolves the live
+    // module through this static weak reference at call time, not a captured setup-time one.
+    private static weak var pushInstance: PosthogReactNativePlugin?
+
+    // Main-thread confined, like the rest of the identity-request bookkeeping below.
+    private var hasPushListeners = false
+    private var pushIdentityCompletions: [String: (String?) -> Void] = [:]
+
+    override func supportedEvents() -> [String]! {
+        [PosthogReactNativePlugin.pushIdentityEvent]
+    }
+
+    override func startObserving() {
+        DispatchQueue.main.async { self.hasPushListeners = true }
+    }
+
+    override func stopObserving() {
+        DispatchQueue.main.async { self.hasPushListeners = false }
+    }
+
     @objc(setup:withSdkOptions:withPluginConfig:withResolver:withRejecter:)
     func setup(
         sessionId: String, sdkOptions: [String: Any], pluginConfig: [String: Any],
@@ -68,6 +98,7 @@ class PosthogReactNativePlugin: NSObject {
             decideReplayConfig: sessionReplayConfig["decideReplayConfig"] as? [String: Any] ?? [:],
             nativeErrorTrackingAutocapture: errorTrackingConfig["nativeAutocapture"] as? Bool ?? false,
             exceptionStepsConfig: exceptionStepsConfig,
+            pushConfig: pluginConfig["push"] as? [String: Any] ?? [:],
             resolve: resolve
         )
     }
@@ -87,6 +118,7 @@ class PosthogReactNativePlugin: NSObject {
             decideReplayConfig: decideReplayConfig,
             nativeErrorTrackingAutocapture: false,
             exceptionStepsConfig: [:],
+            pushConfig: [:],
             resolve: resolve
         )
     }
@@ -100,6 +132,7 @@ class PosthogReactNativePlugin: NSObject {
         decideReplayConfig: [String: Any],
         nativeErrorTrackingAutocapture: Bool,
         exceptionStepsConfig: [String: Any],
+        pushConfig: [String: Any],
         resolve: RCTPromiseResolveBlock
     ) {
         if sessionId.isEmpty {
@@ -193,6 +226,11 @@ class PosthogReactNativePlugin: NSObject {
         let flushAt = sdkOptions["flushAt"] as? Int ?? 20
         config.flushAt = flushAt
 
+        config.optOut = sdkOptions["optOut"] as? Bool ?? false
+        // JS owns flags; it tells us when the native preload would be a duplicate. posthog-ios
+        // has no remoteConfig switch to mirror — it deprecated the option and always loads.
+        config.preloadFeatureFlags = sdkOptions["preloadFeatureFlags"] as? Bool ?? true
+
         // Forward custom headers (e.g. Authorization for a reverse proxy) so the native SDK
         // attaches them to the requests it sends directly (session replay, crash uploads).
         // Keep only string values so a stray non-string doesn't drop every header (matches Android).
@@ -205,6 +243,40 @@ class PosthogReactNativePlugin: NSObject {
             postHogVersion = sdkVersion
         }
 
+        // Only set when present: the legacy start() path predates push, and there the
+        // native defaults (both true) must win, matching posthog-ios on its own.
+        if let capturePushSubscriptions = pushConfig["capturePushNotificationSubscriptions"] as? Bool {
+            config.capturePushNotificationSubscriptions = capturePushSubscriptions
+        }
+        if let capturePushOpened = pushConfig["capturePushNotificationOpened"] as? Bool {
+            config.capturePushNotificationOpened = capturePushOpened
+        }
+
+        // Installed only when JS asked for it: an uninvited bridging provider would change
+        // how the native SDK handles a 401 on the subscription call.
+        if pushConfig["pushIdentityProviderEnabled"] as? Bool == true {
+            PosthogReactNativePlugin.pushInstance = self
+            config.pushIdentityProvider = { distinctId, appId, completion in
+                DispatchQueue.main.async {
+                    guard let instance = PosthogReactNativePlugin.pushInstance, instance.hasPushListeners else {
+                        declinePushIdentity(completion, "no JS listener attached")
+                        return
+                    }
+                    let requestId = UUID().uuidString
+                    instance.pushIdentityCompletions[requestId] = completion
+                    instance.sendEvent(
+                        withName: PosthogReactNativePlugin.pushIdentityEvent,
+                        body: ["requestId": requestId, "distinctId": distinctId, "appId": appId]
+                    )
+                    // The native SDK's own 10s mint watchdog handles the fallback; this only
+                    // drops the entry so a late JS reply is ignored and the closure doesn't leak.
+                    DispatchQueue.main.asyncAfter(deadline: .now() + 15) { [weak instance] in
+                        instance?.pushIdentityCompletions.removeValue(forKey: requestId)
+                    }
+                }
+            }
+        }
+
         PostHogSDK.shared.setup(config)
 
         self.config = config
@@ -265,6 +337,23 @@ class PosthogReactNativePlugin: NSObject {
         resolve(nil)
     }
 
+    // Calls the native SDK rather than writing storage like identify() does: reset() is what
+    // unregisters the logged-out user's push subscription and re-registers under the new identity.
+    @objc(reset:withAnonymousId:withResolver:withRejecter:)
+    func reset(
+        distinctId: String, anonymousId: String, resolve: RCTPromiseResolveBlock,
+        reject _: RCTPromiseRejectBlock
+    ) {
+        PostHogSDK.shared.reset()
+        // Native reset() mints its own anonymous id; overwrite it with the JS one so the two SDKs
+        // stay on the same identity. Must run after reset(), which needs the pre-reset distinctId
+        // to know which subscription to unregister.
+        if let storageManager = config?.storageManager {
+            setIdentify(storageManager, distinctId: distinctId, anonymousId: anonymousId)
+        }
+        resolve(nil)
+    }
+
     private func setIdentify(
         _ storageManager: PostHogStorageManager, distinctId: String, anonymousId: String
     ) {
@@ -276,6 +365,21 @@ class PosthogReactNativePlugin: NSObject {
         }
     }
 
+    // Runtime consent changes must reach native: it persists its own opt-out flag and only
+    // reads the JS value at setup(), so a refreshed APNs token could otherwise auto-register
+    // after the user opted out. optIn() also reinstalls the integrations opt-out removed.
+    @objc(setOptOut:withResolver:withRejecter:)
+    func setOptOut(
+        optOut: Bool, resolve: RCTPromiseResolveBlock, reject _: RCTPromiseRejectBlock
+    ) {
+        if optOut {
+            PostHogSDK.shared.optOut()
+        } else {
+            PostHogSDK.shared.optIn()
+        }
+        resolve(nil)
+    }
+
     @objc(startRecording:withResolver:withRejecter:)
     func startRecording(
         resumeCurrent: Bool, resolve: RCTPromiseResolveBlock, reject _: RCTPromiseRejectBlock
@@ -306,4 +410,64 @@ class PosthogReactNativePlugin: NSObject {
         PostHogSDK.shared.addExceptionStep(message, properties: properties)
         resolve(nil)
     }
+
+    @objc(registerPushNotificationToken:withAppId:withResolver:withRejecter:)
+    func registerPushNotificationToken(
+        deviceToken: String, appId: String?, resolve: RCTPromiseResolveBlock,
+        reject: RCTPromiseRejectBlock
+    ) {
+        #if os(iOS)
+            // A blank token is dropped silently by the native SDK, so surface it here
+            // instead of reporting false success.
+            if deviceToken.trimmingCharacters(in: .whitespacesAndNewlines).isEmpty {
+                reject("PosthogReactNativePluginError", "registerPushNotificationToken: deviceToken is blank; token not registered.", nil)
+                return
+            }
+            PostHogSDK.shared.registerPushNotificationToken(deviceToken, appId: appId)
+            resolve(nil)
+        #else
+            // posthog-ios push registration is iOS-only (the backend rejects the macos platform).
+            _ = reject
+            hedgeLog("registerPushNotificationToken is not supported on macOS; token not registered.")
+            resolve(nil)
+        #endif
+    }
+
+    @objc(unregisterPushNotificationToken:withRejecter:)
+    func unregisterPushNotificationToken(resolve: RCTPromiseResolveBlock, reject _: RCTPromiseRejectBlock) {
+        #if os(iOS)
+            PostHogSDK.shared.unregisterPushNotificationToken()
+        #else
+            hedgeLog("unregisterPushNotificationToken is not supported on macOS; nothing to unregister.")
+        #endif
+        resolve(nil)
+    }
+
+    @objc(capturePushNotificationOpened:withResolver:withRejecter:)
+    func capturePushNotificationOpened(
+        properties: [String: Any], resolve: RCTPromiseResolveBlock, reject _: RCTPromiseRejectBlock
+    ) {
+        PostHogSDK.shared.capturePushNotificationOpened(
+            title: properties["title"] as? String,
+            subtitle: properties["subtitle"] as? String,
+            body: properties["body"] as? String,
+            payload: properties["payload"] as? [String: Any],
+            action: properties["action"] as? String
+        )
+        resolve(nil)
+    }
+
+    @objc(providePushIdentityToken:withToken:withResolver:withRejecter:)
+    func providePushIdentityToken(
+        requestId: String, token: String?, resolve: RCTPromiseResolveBlock,
+        reject _: RCTPromiseRejectBlock
+    ) {
+        DispatchQueue.main.async { [weak self] in
+            guard let completion = self?.pushIdentityCompletions.removeValue(forKey: requestId) else {
+                return
+            }
+            completion(token)
+        }
+        resolve(nil)
+    }
 }

package/lib/commonjs/index.js

@@ -4,15 +4,21 @@ Object.defineProperty(exports, "__esModule", {
   value: true
 });
 exports.addExceptionStep = addExceptionStep;
+exports.capturePushNotificationOpened = capturePushNotificationOpened;
 exports.default = void 0;
 exports.endSession = endSession;
 exports.identify = identify;
 exports.isEnabled = isEnabled;
+exports.registerPushNotificationToken = registerPushNotificationToken;
+exports.reset = reset;
+exports.setOptOut = setOptOut;
+exports.setPushIdentityProvider = setPushIdentityProvider;
 exports.setup = setup;
 exports.start = start;
 exports.startRecording = startRecording;
 exports.startSession = startSession;
 exports.stopRecording = stopRecording;
+exports.unregisterPushNotificationToken = unregisterPushNotificationToken;
 var _reactNative = require("react-native");
 const LINKING_ERROR = `The package '@posthog/react-native-plugin' doesn't seem to be linked. Make sure: \n\n` + _reactNative.Platform.select({
   ios: "- You have run 'pod install'\n",
@@ -41,6 +47,15 @@ function isEnabled() {
 function identify(distinctId, anonymousId) {
   return PosthogReactNativePlugin.identify(distinctId, anonymousId);
 }
+
+/**
+ * Resets the native SDK's identity on logout. Unlike {@link identify}, this calls the native
+ * SDK's own `reset()`, which unregisters the logged-out user's push subscription and
+ * re-registers it under the new anonymous id.
+ */
+function reset(distinctId, anonymousId) {
+  return PosthogReactNativePlugin.reset(distinctId, anonymousId);
+}
 function startRecording(resumeCurrent) {
   return PosthogReactNativePlugin.startRecording(resumeCurrent);
 }
@@ -50,6 +65,63 @@ function stopRecording() {
 function addExceptionStep(message, properties) {
   return PosthogReactNativePlugin.addExceptionStep(message, properties ?? {});
 }
+function registerPushNotificationToken(deviceToken, appId) {
+  return PosthogReactNativePlugin.registerPushNotificationToken(deviceToken, appId);
+}
+function unregisterPushNotificationToken() {
+  return PosthogReactNativePlugin.unregisterPushNotificationToken();
+}
+
+/**
+ * Propagates a runtime consent change to the native SDK, which otherwise only reads the JS
+ * opt-out flag at setup() and could auto-register a refreshed push token after optOut().
+ */
+function setOptOut(optOut) {
+  return PosthogReactNativePlugin.setOptOut(optOut);
+}
+function capturePushNotificationOpened(properties) {
+  return PosthogReactNativePlugin.capturePushNotificationOpened(properties);
+}
+
+/**
+ * Mints a signed identity-verification token for a push subscription request.
+ * Return null to send the request without an identity token.
+ */
+
+const PUSH_IDENTITY_EVENT = 'PostHogPushIdentityRequest';
+let pushIdentitySubscription;
+
+/**
+ * Installs the JS side of the push identity-provider bridge. The native SDK asks for a
+ * token via a `PostHogPushIdentityRequest` event; the reply is routed back with
+ * `providePushIdentityToken`, keyed by the request id so late replies are ignored.
+ *
+ * Install before setup() with `push.pushIdentityProviderEnabled` set, so the native
+ * config gets its bridging provider at SDK initialization. Any provider failure
+ * degrades to a null token — an unauthenticated request — never a stalled mint.
+ */
+function setPushIdentityProvider(provider) {
+  pushIdentitySubscription?.remove();
+  // Via the proxy, not raw NativeModules: an unlinked module would build an emitter over
+  // undefined and throw a generic RN error inside the SDK's init try, taking replay down with it.
+  const emitter = new _reactNative.NativeEventEmitter(PosthogReactNativePlugin);
+  pushIdentitySubscription = emitter.addListener(PUSH_IDENTITY_EVENT, async request => {
+    let token = null;
+    try {
+      const minted = await provider(request.distinctId, request.appId);
+      token = typeof minted === 'string' ? minted : null;
+    } catch (e) {
+      // eslint-disable-next-line no-console
+      console.warn(`[PostHog] pushIdentityProvider threw: ${e}. Push subscription will be sent unauthenticated.`);
+    }
+    try {
+      await PosthogReactNativePlugin.providePushIdentityToken(request.requestId, token);
+    } catch (e) {
+      // eslint-disable-next-line no-console
+      console.warn(`[PostHog] Failed to deliver push identity token to native: ${e}`);
+    }
+  });
+}
 const PostHogReactNativePlugin = {
   setup,
   start,
@@ -57,9 +129,15 @@ const PostHogReactNativePlugin = {
   endSession,
   isEnabled,
   identify,
+  reset,
   startRecording,
   stopRecording,
-  addExceptionStep
+  addExceptionStep,
+  registerPushNotificationToken,
+  unregisterPushNotificationToken,
+  setOptOut,
+  capturePushNotificationOpened,
+  setPushIdentityProvider
 };
 var _default = exports.default = PostHogReactNativePlugin;
 //# sourceMappingURL=index.js.map

package/lib/commonjs/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["_reactNative","require","LINKING_ERROR","Platform","select","ios","default","PosthogReactNativePlugin","NativeModules","Proxy","get","Error","setup","sessionId","sdkOptions","pluginConfig","start","sdkReplayConfig","decideReplayConfig","startSession","endSession","isEnabled","identify","distinctId","anonymousId","startRecording","resumeCurrent","stopRecording","addExceptionStep","message","properties","PostHogReactNativePlugin","_default","exports"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;;;;;;;;;;;;;;AAAA,IAAAA,YAAA,GAAAC,OAAA;AAEA,MAAMC,aAAa,GACjB,uFAAuF,GACvFC,qBAAQ,CAACC,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMC,wBAAwB,GAAGC,0BAAa,CAACD,wBAAwB,GACnEC,0BAAa,CAACD,wBAAwB,GACtC,IAAIE,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACT,aAAa,CAAC;EAChC;AACF,CACF,CAAC;AAyBE,SAASU,KAAKA,CACnBC,SAAiB,EACjBC,UAAuC,EACvCC,YAA4C,GAAG,CAAC,CAAC,EAClC;EACf,OAAOR,wBAAwB,CAACK,KAAK,CAACC,SAAS,EAAEC,UAAU,EAAEC,YAAY,CAAC;AAC5E;AAEO,SAASC,KAAKA,CACnBH,SAAiB,EACjBC,UAAuC,EACvCG,eAA4C,EAC5CC,kBAA+C,EAChC;EACf,OAAOX,wBAAwB,CAACS,KAAK,CAACH,SAAS,EAAEC,UAAU,EAAEG,eAAe,EAAEC,kBAAkB,CAAC;AACnG;AAEO,SAASC,YAAYA,CAACN,SAAiB,EAAiB;EAC7D,OAAON,wBAAwB,CAACY,YAAY,CAACN,SAAS,CAAC;AACzD;AAEO,SAASO,UAAUA,CAAA,EAAkB;EAC1C,OAAOb,wBAAwB,CAACa,UAAU,CAAC,CAAC;AAC9C;AAEO,SAASC,SAASA,CAAA,EAAqB;EAC5C,OAAOd,wBAAwB,CAACc,SAAS,CAAC,CAAC;AAC7C;AAEO,SAASC,QAAQA,CAACC,UAAkB,EAAEC,WAAmB,EAAiB;EAC/E,OAAOjB,wBAAwB,CAACe,QAAQ,CAACC,UAAU,EAAEC,WAAW,CAAC;AACnE;AAEO,SAASC,cAAcA,CAACC,aAAsB,EAAiB;EACpE,OAAOnB,wBAAwB,CAACkB,cAAc,CAACC,aAAa,CAAC;AAC/D;AAEO,SAASC,aAAaA,CAAA,EAAkB;EAC7C,OAAOpB,wBAAwB,CAACoB,aAAa,CAAC,CAAC;AACjD;AAEO,SAASC,gBAAgBA,CAACC,OAAe,EAAEC,UAAwC,EAAiB;EACzG,OAAOvB,wBAAwB,CAACqB,gBAAgB,CAACC,OAAO,EAAEC,UAAU,IAAI,CAAC,CAAC,CAAC;AAC7E;AAkCA,MAAMC,wBAAwD,GAAG;EAC/DnB,KAAK;EACLI,KAAK;EACLG,YAAY;EACZC,UAAU;EACVC,SAAS;EACTC,QAAQ;EACRG,cAAc;EACdE,aAAa;EACbC;AACF,CAAC;AAAA,IAAAI,QAAA,GAAAC,OAAA,CAAA3B,OAAA,GAEcyB,wBAAwB","ignoreList":[]}
+{"version":3,"names":["_reactNative","require","LINKING_ERROR","Platform","select","ios","default","PosthogReactNativePlugin","NativeModules","Proxy","get","Error","setup","sessionId","sdkOptions","pluginConfig","start","sdkReplayConfig","decideReplayConfig","startSession","endSession","isEnabled","identify","distinctId","anonymousId","reset","startRecording","resumeCurrent","stopRecording","addExceptionStep","message","properties","registerPushNotificationToken","deviceToken","appId","unregisterPushNotificationToken","setOptOut","optOut","capturePushNotificationOpened","PUSH_IDENTITY_EVENT","pushIdentitySubscription","setPushIdentityProvider","provider","remove","emitter","NativeEventEmitter","addListener","request","token","minted","e","console","warn","providePushIdentityToken","requestId","PostHogReactNativePlugin","_default","exports"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/module/index.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import { NativeModules, Platform } from 'react-native';
+import { NativeEventEmitter, NativeModules, Platform } from 'react-native';
 const LINKING_ERROR = `The package '@posthog/react-native-plugin' doesn't seem to be linked. Make sure: \n\n` + Platform.select({
   ios: "- You have run 'pod install'\n",
   default: ''
@@ -28,6 +28,15 @@ export function isEnabled() {
 export function identify(distinctId, anonymousId) {
   return PosthogReactNativePlugin.identify(distinctId, anonymousId);
 }
+
+/**
+ * Resets the native SDK's identity on logout. Unlike {@link identify}, this calls the native
+ * SDK's own `reset()`, which unregisters the logged-out user's push subscription and
+ * re-registers it under the new anonymous id.
+ */
+export function reset(distinctId, anonymousId) {
+  return PosthogReactNativePlugin.reset(distinctId, anonymousId);
+}
 export function startRecording(resumeCurrent) {
   return PosthogReactNativePlugin.startRecording(resumeCurrent);
 }
@@ -37,6 +46,63 @@ export function stopRecording() {
 export function addExceptionStep(message, properties) {
   return PosthogReactNativePlugin.addExceptionStep(message, properties ?? {});
 }
+export function registerPushNotificationToken(deviceToken, appId) {
+  return PosthogReactNativePlugin.registerPushNotificationToken(deviceToken, appId);
+}
+export function unregisterPushNotificationToken() {
+  return PosthogReactNativePlugin.unregisterPushNotificationToken();
+}
+
+/**
+ * Propagates a runtime consent change to the native SDK, which otherwise only reads the JS
+ * opt-out flag at setup() and could auto-register a refreshed push token after optOut().
+ */
+export function setOptOut(optOut) {
+  return PosthogReactNativePlugin.setOptOut(optOut);
+}
+export function capturePushNotificationOpened(properties) {
+  return PosthogReactNativePlugin.capturePushNotificationOpened(properties);
+}
+
+/**
+ * Mints a signed identity-verification token for a push subscription request.
+ * Return null to send the request without an identity token.
+ */
+
+const PUSH_IDENTITY_EVENT = 'PostHogPushIdentityRequest';
+let pushIdentitySubscription;
+
+/**
+ * Installs the JS side of the push identity-provider bridge. The native SDK asks for a
+ * token via a `PostHogPushIdentityRequest` event; the reply is routed back with
+ * `providePushIdentityToken`, keyed by the request id so late replies are ignored.
+ *
+ * Install before setup() with `push.pushIdentityProviderEnabled` set, so the native
+ * config gets its bridging provider at SDK initialization. Any provider failure
+ * degrades to a null token — an unauthenticated request — never a stalled mint.
+ */
+export function setPushIdentityProvider(provider) {
+  pushIdentitySubscription?.remove();
+  // Via the proxy, not raw NativeModules: an unlinked module would build an emitter over
+  // undefined and throw a generic RN error inside the SDK's init try, taking replay down with it.
+  const emitter = new NativeEventEmitter(PosthogReactNativePlugin);
+  pushIdentitySubscription = emitter.addListener(PUSH_IDENTITY_EVENT, async request => {
+    let token = null;
+    try {
+      const minted = await provider(request.distinctId, request.appId);
+      token = typeof minted === 'string' ? minted : null;
+    } catch (e) {
+      // eslint-disable-next-line no-console
+      console.warn(`[PostHog] pushIdentityProvider threw: ${e}. Push subscription will be sent unauthenticated.`);
+    }
+    try {
+      await PosthogReactNativePlugin.providePushIdentityToken(request.requestId, token);
+    } catch (e) {
+      // eslint-disable-next-line no-console
+      console.warn(`[PostHog] Failed to deliver push identity token to native: ${e}`);
+    }
+  });
+}
 const PostHogReactNativePlugin = {
   setup,
   start,
@@ -44,9 +110,15 @@ const PostHogReactNativePlugin = {
   endSession,
   isEnabled,
   identify,
+  reset,
   startRecording,
   stopRecording,
-  addExceptionStep
+  addExceptionStep,
+  registerPushNotificationToken,
+  unregisterPushNotificationToken,
+  setOptOut,
+  capturePushNotificationOpened,
+  setPushIdentityProvider
 };
 export default PostHogReactNativePlugin;
 //# sourceMappingURL=index.js.map

package/lib/module/index.js.map

@@ -1 +1 @@
-{"version":3,"names":["NativeModules","Platform","LINKING_ERROR","select","ios","default","PosthogReactNativePlugin","Proxy","get","Error","setup","sessionId","sdkOptions","pluginConfig","start","sdkReplayConfig","decideReplayConfig","startSession","endSession","isEnabled","identify","distinctId","anonymousId","startRecording","resumeCurrent","stopRecording","addExceptionStep","message","properties","PostHogReactNativePlugin"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":";;AAAA,SAASA,aAAa,EAAEC,QAAQ,QAAQ,cAAc;AAEtD,MAAMC,aAAa,GACjB,uFAAuF,GACvFD,QAAQ,CAACE,MAAM,CAAC;EAAEC,GAAG,EAAE,gCAAgC;EAAEC,OAAO,EAAE;AAAG,CAAC,CAAC,GACvE,sDAAsD,GACtD,+BAA+B;AAEjC,MAAMC,wBAAwB,GAAGN,aAAa,CAACM,wBAAwB,GACnEN,aAAa,CAACM,wBAAwB,GACtC,IAAIC,KAAK,CACP,CAAC,CAAC,EACF;EACEC,GAAGA,CAAA,EAAG;IACJ,MAAM,IAAIC,KAAK,CAACP,aAAa,CAAC;EAChC;AACF,CACF,CAAC;AAyBL,OAAO,SAASQ,KAAKA,CACnBC,SAAiB,EACjBC,UAAuC,EACvCC,YAA4C,GAAG,CAAC,CAAC,EAClC;EACf,OAAOP,wBAAwB,CAACI,KAAK,CAACC,SAAS,EAAEC,UAAU,EAAEC,YAAY,CAAC;AAC5E;AAEA,OAAO,SAASC,KAAKA,CACnBH,SAAiB,EACjBC,UAAuC,EACvCG,eAA4C,EAC5CC,kBAA+C,EAChC;EACf,OAAOV,wBAAwB,CAACQ,KAAK,CAACH,SAAS,EAAEC,UAAU,EAAEG,eAAe,EAAEC,kBAAkB,CAAC;AACnG;AAEA,OAAO,SAASC,YAAYA,CAACN,SAAiB,EAAiB;EAC7D,OAAOL,wBAAwB,CAACW,YAAY,CAACN,SAAS,CAAC;AACzD;AAEA,OAAO,SAASO,UAAUA,CAAA,EAAkB;EAC1C,OAAOZ,wBAAwB,CAACY,UAAU,CAAC,CAAC;AAC9C;AAEA,OAAO,SAASC,SAASA,CAAA,EAAqB;EAC5C,OAAOb,wBAAwB,CAACa,SAAS,CAAC,CAAC;AAC7C;AAEA,OAAO,SAASC,QAAQA,CAACC,UAAkB,EAAEC,WAAmB,EAAiB;EAC/E,OAAOhB,wBAAwB,CAACc,QAAQ,CAACC,UAAU,EAAEC,WAAW,CAAC;AACnE;AAEA,OAAO,SAASC,cAAcA,CAACC,aAAsB,EAAiB;EACpE,OAAOlB,wBAAwB,CAACiB,cAAc,CAACC,aAAa,CAAC;AAC/D;AAEA,OAAO,SAASC,aAAaA,CAAA,EAAkB;EAC7C,OAAOnB,wBAAwB,CAACmB,aAAa,CAAC,CAAC;AACjD;AAEA,OAAO,SAASC,gBAAgBA,CAACC,OAAe,EAAEC,UAAwC,EAAiB;EACzG,OAAOtB,wBAAwB,CAACoB,gBAAgB,CAACC,OAAO,EAAEC,UAAU,IAAI,CAAC,CAAC,CAAC;AAC7E;AAkCA,MAAMC,wBAAwD,GAAG;EAC/DnB,KAAK;EACLI,KAAK;EACLG,YAAY;EACZC,UAAU;EACVC,SAAS;EACTC,QAAQ;EACRG,cAAc;EACdE,aAAa;EACbC;AACF,CAAC;AAED,eAAeG,wBAAwB","ignoreList":[]}
+{"version":3,"names":["NativeEventEmitter","NativeModules","Platform","LINKING_ERROR","select","ios","default","PosthogReactNativePlugin","Proxy","get","Error","setup","sessionId","sdkOptions","pluginConfig","start","sdkReplayConfig","decideReplayConfig","startSession","endSession","isEnabled","identify","distinctId","anonymousId","reset","startRecording","resumeCurrent","stopRecording","addExceptionStep","message","properties","registerPushNotificationToken","deviceToken","appId","unregisterPushNotificationToken","setOptOut","optOut","capturePushNotificationOpened","PUSH_IDENTITY_EVENT","pushIdentitySubscription","setPushIdentityProvider","provider","remove","emitter","addListener","request","token","minted","e","console","warn","providePushIdentityToken","requestId","PostHogReactNativePlugin"],"sourceRoot":"../../src","sources":["index.tsx"],"mappings":"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","ignoreList":[]}

package/lib/typescript/commonjs/src/index.d.ts

@@ -14,9 +14,21 @@ export interface PostHogReactNativePluginErrorTrackingConfig {
     nativeAutocapture?: boolean;
     exceptionSteps?: PostHogReactNativePluginExceptionStepsConfig;
 }
+export interface PostHogReactNativePluginPushConfig {
+    capturePushNotificationSubscriptions?: boolean;
+    capturePushNotificationOpened?: boolean;
+    /**
+     * A provider callback can't cross the bridge, so this only tells native whether to
+     * install the bridging provider at all — installing one the host didn't ask for
+     * would change how the native SDK handles a 401 on the subscription call.
+     * Pair with {@link setPushIdentityProvider} before calling setup().
+     */
+    pushIdentityProviderEnabled?: boolean;
+}
 export interface PostHogReactNativePluginConfig {
     sessionReplay?: PostHogReactNativePluginSessionReplayConfig;
     errorTracking?: PostHogReactNativePluginErrorTrackingConfig;
+    push?: PostHogReactNativePluginPushConfig;
 }
 export declare function setup(sessionId: string, sdkOptions: PostHogReactNativePluginMap, pluginConfig?: PostHogReactNativePluginConfig): Promise<void>;
 export declare function start(sessionId: string, sdkOptions: PostHogReactNativePluginMap, sdkReplayConfig: PostHogReactNativePluginMap, decideReplayConfig: PostHogReactNativePluginMap): Promise<void>;
@@ -24,9 +36,38 @@ export declare function startSession(sessionId: string): Promise<void>;
 export declare function endSession(): Promise<void>;
 export declare function isEnabled(): Promise<boolean>;
 export declare function identify(distinctId: string, anonymousId: string): Promise<void>;
+/**
+ * Resets the native SDK's identity on logout. Unlike {@link identify}, this calls the native
+ * SDK's own `reset()`, which unregisters the logged-out user's push subscription and
+ * re-registers it under the new anonymous id.
+ */
+export declare function reset(distinctId: string, anonymousId: string): Promise<void>;
 export declare function startRecording(resumeCurrent: boolean): Promise<void>;
 export declare function stopRecording(): Promise<void>;
 export declare function addExceptionStep(message: string, properties?: PostHogReactNativePluginMap): Promise<void>;
+export declare function registerPushNotificationToken(deviceToken: string, appId: string | null): Promise<void>;
+export declare function unregisterPushNotificationToken(): Promise<void>;
+/**
+ * Propagates a runtime consent change to the native SDK, which otherwise only reads the JS
+ * opt-out flag at setup() and could auto-register a refreshed push token after optOut().
+ */
+export declare function setOptOut(optOut: boolean): Promise<void>;
+export declare function capturePushNotificationOpened(properties: PostHogReactNativePluginMap): Promise<void>;
+/**
+ * Mints a signed identity-verification token for a push subscription request.
+ * Return null to send the request without an identity token.
+ */
+export type PostHogPushIdentityProvider = (distinctId: string, appId: string) => Promise<string | null>;
+/**
+ * Installs the JS side of the push identity-provider bridge. The native SDK asks for a
+ * token via a `PostHogPushIdentityRequest` event; the reply is routed back with
+ * `providePushIdentityToken`, keyed by the request id so late replies are ignored.
+ *
+ * Install before setup() with `push.pushIdentityProviderEnabled` set, so the native
+ * config gets its bridging provider at SDK initialization. Any provider failure
+ * degrades to a null token — an unauthenticated request — never a stalled mint.
+ */
+export declare function setPushIdentityProvider(provider: PostHogPushIdentityProvider): void;
 export interface PostHogReactNativePluginModule {
     setup: (sessionId: string, sdkOptions: PostHogReactNativePluginMap, pluginConfig?: PostHogReactNativePluginConfig) => Promise<void>;
     /**
@@ -37,9 +78,15 @@ export interface PostHogReactNativePluginModule {
     endSession: () => Promise<void>;
     isEnabled: () => Promise<boolean>;
     identify: (distinctId: string, anonymousId: string) => Promise<void>;
+    reset: (distinctId: string, anonymousId: string) => Promise<void>;
     startRecording: (resumeCurrent: boolean) => Promise<void>;
     stopRecording: () => Promise<void>;
     addExceptionStep: (message: string, properties?: PostHogReactNativePluginMap) => Promise<void>;
+    registerPushNotificationToken: (deviceToken: string, appId: string | null) => Promise<void>;
+    unregisterPushNotificationToken: () => Promise<void>;
+    setOptOut: (optOut: boolean) => Promise<void>;
+    capturePushNotificationOpened: (properties: PostHogReactNativePluginMap) => Promise<void>;
+    setPushIdentityProvider: (provider: PostHogPushIdentityProvider) => void;
 }
 declare const PostHogReactNativePlugin: PostHogReactNativePluginModule;
 export default PostHogReactNativePlugin;

package/lib/typescript/commonjs/src/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/lib/typescript/module/src/index.d.ts

@@ -14,9 +14,21 @@ export interface PostHogReactNativePluginErrorTrackingConfig {
     nativeAutocapture?: boolean;
     exceptionSteps?: PostHogReactNativePluginExceptionStepsConfig;
 }
+export interface PostHogReactNativePluginPushConfig {
+    capturePushNotificationSubscriptions?: boolean;
+    capturePushNotificationOpened?: boolean;
+    /**
+     * A provider callback can't cross the bridge, so this only tells native whether to
+     * install the bridging provider at all — installing one the host didn't ask for
+     * would change how the native SDK handles a 401 on the subscription call.
+     * Pair with {@link setPushIdentityProvider} before calling setup().
+     */
+    pushIdentityProviderEnabled?: boolean;
+}
 export interface PostHogReactNativePluginConfig {
     sessionReplay?: PostHogReactNativePluginSessionReplayConfig;
     errorTracking?: PostHogReactNativePluginErrorTrackingConfig;
+    push?: PostHogReactNativePluginPushConfig;
 }
 export declare function setup(sessionId: string, sdkOptions: PostHogReactNativePluginMap, pluginConfig?: PostHogReactNativePluginConfig): Promise<void>;
 export declare function start(sessionId: string, sdkOptions: PostHogReactNativePluginMap, sdkReplayConfig: PostHogReactNativePluginMap, decideReplayConfig: PostHogReactNativePluginMap): Promise<void>;
@@ -24,9 +36,38 @@ export declare function startSession(sessionId: string): Promise<void>;
 export declare function endSession(): Promise<void>;
 export declare function isEnabled(): Promise<boolean>;
 export declare function identify(distinctId: string, anonymousId: string): Promise<void>;
+/**
+ * Resets the native SDK's identity on logout. Unlike {@link identify}, this calls the native
+ * SDK's own `reset()`, which unregisters the logged-out user's push subscription and
+ * re-registers it under the new anonymous id.
+ */
+export declare function reset(distinctId: string, anonymousId: string): Promise<void>;
 export declare function startRecording(resumeCurrent: boolean): Promise<void>;
 export declare function stopRecording(): Promise<void>;
 export declare function addExceptionStep(message: string, properties?: PostHogReactNativePluginMap): Promise<void>;
+export declare function registerPushNotificationToken(deviceToken: string, appId: string | null): Promise<void>;
+export declare function unregisterPushNotificationToken(): Promise<void>;
+/**
+ * Propagates a runtime consent change to the native SDK, which otherwise only reads the JS
+ * opt-out flag at setup() and could auto-register a refreshed push token after optOut().
+ */
+export declare function setOptOut(optOut: boolean): Promise<void>;
+export declare function capturePushNotificationOpened(properties: PostHogReactNativePluginMap): Promise<void>;
+/**
+ * Mints a signed identity-verification token for a push subscription request.
+ * Return null to send the request without an identity token.
+ */
+export type PostHogPushIdentityProvider = (distinctId: string, appId: string) => Promise<string | null>;
+/**
+ * Installs the JS side of the push identity-provider bridge. The native SDK asks for a
+ * token via a `PostHogPushIdentityRequest` event; the reply is routed back with
+ * `providePushIdentityToken`, keyed by the request id so late replies are ignored.
+ *
+ * Install before setup() with `push.pushIdentityProviderEnabled` set, so the native
+ * config gets its bridging provider at SDK initialization. Any provider failure
+ * degrades to a null token — an unauthenticated request — never a stalled mint.
+ */
+export declare function setPushIdentityProvider(provider: PostHogPushIdentityProvider): void;
 export interface PostHogReactNativePluginModule {
     setup: (sessionId: string, sdkOptions: PostHogReactNativePluginMap, pluginConfig?: PostHogReactNativePluginConfig) => Promise<void>;
     /**
@@ -37,9 +78,15 @@ export interface PostHogReactNativePluginModule {
     endSession: () => Promise<void>;
     isEnabled: () => Promise<boolean>;
     identify: (distinctId: string, anonymousId: string) => Promise<void>;
+    reset: (distinctId: string, anonymousId: string) => Promise<void>;
     startRecording: (resumeCurrent: boolean) => Promise<void>;
     stopRecording: () => Promise<void>;
     addExceptionStep: (message: string, properties?: PostHogReactNativePluginMap) => Promise<void>;
+    registerPushNotificationToken: (deviceToken: string, appId: string | null) => Promise<void>;
+    unregisterPushNotificationToken: () => Promise<void>;
+    setOptOut: (optOut: boolean) => Promise<void>;
+    capturePushNotificationOpened: (properties: PostHogReactNativePluginMap) => Promise<void>;
+    setPushIdentityProvider: (provider: PostHogPushIdentityProvider) => void;
 }
 declare const PostHogReactNativePlugin: PostHogReactNativePluginModule;
 export default PostHogReactNativePlugin;

package/lib/typescript/module/src/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": "@posthog/react-native-plugin",
-  "version": "2.2.4",
+  "version": "2.3.0",
   "description": "PostHog React Native plugin for iOS and Android integrations",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",
@@ -69,7 +69,6 @@
     "react-native": "*"
   },
   "jest": {
-    "preset": "react-native",
     "modulePathIgnorePatterns": [
       "<rootDir>/lib/"
     ],

package/posthog-react-native-plugin.podspec

@@ -6,7 +6,7 @@ folly_compiler_flags = '-DFOLLY_NO_CONFIG -DFOLLY_MOBILE=1 -DFOLLY_USE_LIBCPP=1
 # Single source of truth for the posthog-ios native dependency version.
 # Used by both the SPM and CocoaPods resolution paths below; bump this
 # line when picking up a new posthog-ios release.
-posthog_ios_version = '3.69.0'
+posthog_ios_version = '3.69.2'
 
 Pod::Spec.new do |s|
   s.name         = "posthog-react-native-plugin"

package/src/index.tsx

@@ -1,4 +1,5 @@
-import { NativeModules, Platform } from 'react-native'
+import { NativeEventEmitter, NativeModules, Platform } from 'react-native'
+import type { EmitterSubscription } from 'react-native'
 
 const LINKING_ERROR =
   `The package '@posthog/react-native-plugin' doesn't seem to be linked. Make sure: \n\n` +
@@ -35,9 +36,22 @@ export interface PostHogReactNativePluginErrorTrackingConfig {
   exceptionSteps?: PostHogReactNativePluginExceptionStepsConfig
 }
 
+export interface PostHogReactNativePluginPushConfig {
+  capturePushNotificationSubscriptions?: boolean
+  capturePushNotificationOpened?: boolean
+  /**
+   * A provider callback can't cross the bridge, so this only tells native whether to
+   * install the bridging provider at all — installing one the host didn't ask for
+   * would change how the native SDK handles a 401 on the subscription call.
+   * Pair with {@link setPushIdentityProvider} before calling setup().
+   */
+  pushIdentityProviderEnabled?: boolean
+}
+
 export interface PostHogReactNativePluginConfig {
   sessionReplay?: PostHogReactNativePluginSessionReplayConfig
   errorTracking?: PostHogReactNativePluginErrorTrackingConfig
+  push?: PostHogReactNativePluginPushConfig
 }
 
 export function setup(
@@ -73,6 +87,15 @@ export function identify(distinctId: string, anonymousId: string): Promise<void>
   return PosthogReactNativePlugin.identify(distinctId, anonymousId)
 }
 
+/**
+ * Resets the native SDK's identity on logout. Unlike {@link identify}, this calls the native
+ * SDK's own `reset()`, which unregisters the logged-out user's push subscription and
+ * re-registers it under the new anonymous id.
+ */
+export function reset(distinctId: string, anonymousId: string): Promise<void> {
+  return PosthogReactNativePlugin.reset(distinctId, anonymousId)
+}
+
 export function startRecording(resumeCurrent: boolean): Promise<void> {
   return PosthogReactNativePlugin.startRecording(resumeCurrent)
 }
@@ -85,6 +108,71 @@ export function addExceptionStep(message: string, properties?: PostHogReactNativ
   return PosthogReactNativePlugin.addExceptionStep(message, properties ?? {})
 }
 
+export function registerPushNotificationToken(deviceToken: string, appId: string | null): Promise<void> {
+  return PosthogReactNativePlugin.registerPushNotificationToken(deviceToken, appId)
+}
+
+export function unregisterPushNotificationToken(): Promise<void> {
+  return PosthogReactNativePlugin.unregisterPushNotificationToken()
+}
+
+/**
+ * Propagates a runtime consent change to the native SDK, which otherwise only reads the JS
+ * opt-out flag at setup() and could auto-register a refreshed push token after optOut().
+ */
+export function setOptOut(optOut: boolean): Promise<void> {
+  return PosthogReactNativePlugin.setOptOut(optOut)
+}
+
+export function capturePushNotificationOpened(properties: PostHogReactNativePluginMap): Promise<void> {
+  return PosthogReactNativePlugin.capturePushNotificationOpened(properties)
+}
+
+/**
+ * Mints a signed identity-verification token for a push subscription request.
+ * Return null to send the request without an identity token.
+ */
+export type PostHogPushIdentityProvider = (distinctId: string, appId: string) => Promise<string | null>
+
+const PUSH_IDENTITY_EVENT = 'PostHogPushIdentityRequest'
+
+let pushIdentitySubscription: EmitterSubscription | undefined
+
+/**
+ * Installs the JS side of the push identity-provider bridge. The native SDK asks for a
+ * token via a `PostHogPushIdentityRequest` event; the reply is routed back with
+ * `providePushIdentityToken`, keyed by the request id so late replies are ignored.
+ *
+ * Install before setup() with `push.pushIdentityProviderEnabled` set, so the native
+ * config gets its bridging provider at SDK initialization. Any provider failure
+ * degrades to a null token — an unauthenticated request — never a stalled mint.
+ */
+export function setPushIdentityProvider(provider: PostHogPushIdentityProvider): void {
+  pushIdentitySubscription?.remove()
+  // Via the proxy, not raw NativeModules: an unlinked module would build an emitter over
+  // undefined and throw a generic RN error inside the SDK's init try, taking replay down with it.
+  const emitter = new NativeEventEmitter(PosthogReactNativePlugin)
+  pushIdentitySubscription = emitter.addListener(
+    PUSH_IDENTITY_EVENT,
+    async (request: { requestId: string; distinctId: string; appId: string }) => {
+      let token: string | null = null
+      try {
+        const minted = await provider(request.distinctId, request.appId)
+        token = typeof minted === 'string' ? minted : null
+      } catch (e) {
+        // eslint-disable-next-line no-console
+        console.warn(`[PostHog] pushIdentityProvider threw: ${e}. Push subscription will be sent unauthenticated.`)
+      }
+      try {
+        await PosthogReactNativePlugin.providePushIdentityToken(request.requestId, token)
+      } catch (e) {
+        // eslint-disable-next-line no-console
+        console.warn(`[PostHog] Failed to deliver push identity token to native: ${e}`)
+      }
+    }
+  )
+}
+
 export interface PostHogReactNativePluginModule {
   setup: (
     sessionId: string,
@@ -110,11 +198,23 @@ export interface PostHogReactNativePluginModule {
 
   identify: (distinctId: string, anonymousId: string) => Promise<void>
 
+  reset: (distinctId: string, anonymousId: string) => Promise<void>
+
   startRecording: (resumeCurrent: boolean) => Promise<void>
 
   stopRecording: () => Promise<void>
 
   addExceptionStep: (message: string, properties?: PostHogReactNativePluginMap) => Promise<void>
+
+  registerPushNotificationToken: (deviceToken: string, appId: string | null) => Promise<void>
+
+  unregisterPushNotificationToken: () => Promise<void>
+
+  setOptOut: (optOut: boolean) => Promise<void>
+
+  capturePushNotificationOpened: (properties: PostHogReactNativePluginMap) => Promise<void>
+
+  setPushIdentityProvider: (provider: PostHogPushIdentityProvider) => void
 }
 
 const PostHogReactNativePlugin: PostHogReactNativePluginModule = {
@@ -124,9 +224,15 @@ const PostHogReactNativePlugin: PostHogReactNativePluginModule = {
   endSession,
   isEnabled,
   identify,
+  reset,
   startRecording,
   stopRecording,
   addExceptionStep,
+  registerPushNotificationToken,
+  unregisterPushNotificationToken,
+  setOptOut,
+  capturePushNotificationOpened,
+  setPushIdentityProvider,
 }
 
 export default PostHogReactNativePlugin