@posthog/react-native-plugin 2.0.0 → 2.0.1

package/LICENSE

@@ -324,3 +324,30 @@ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
 OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
 SOFTWARE.
+
+---
+
+Some files in this codebase contain code from MCPCat/mcpcat-typescript-sdk.
+In such cases it is explicitly stated in the file header. This license only applies to the relevant code in such cases.
+
+MIT License
+
+Copyright (c) 2025 MCPcat
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

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

@@ -9,6 +9,7 @@ import com.facebook.react.bridge.ReadableMap
 import com.facebook.react.bridge.UiThreadUtil
 import com.posthog.PostHog
 import com.posthog.PostHogConfig
+import com.posthog.PostHogEvent
 import com.posthog.android.PostHogAndroid
 import com.posthog.android.PostHogAndroidConfig
 import com.posthog.internal.PostHogPreferences
@@ -98,31 +99,36 @@ class PosthogReactNativePluginModule(
               flushAt = theFlushAt
               errorTrackingConfig.autoCapture = nativeErrorTrackingAutocapture
 
-              if (sessionReplayEnabled) {
-                val maskAllTextInputs = getBoolean(sdkReplayConfig, "maskAllTextInputs", DEFAULT_MASK_ALL_TEXT_INPUTS)
-                val maskAllImages = getBoolean(sdkReplayConfig, "maskAllImages", DEFAULT_MASK_ALL_IMAGES)
-                val captureLog = getBoolean(sdkReplayConfig, "captureLog", DEFAULT_CAPTURE_LOG)
-
-                // read throttleDelayMs and use androidDebouncerDelayMs as a fallback for back compatibility
-                val throttleDelayMs =
-                  when {
-                    hasKey(sdkReplayConfig, "throttleDelayMs") -> getInt(sdkReplayConfig, "throttleDelayMs", DEFAULT_THROTTLE_DELAY_MS)
-                    hasKey(sdkReplayConfig, "androidDebouncerDelayMs") -> getInt(sdkReplayConfig, "androidDebouncerDelayMs", DEFAULT_THROTTLE_DELAY_MS)
-                    else -> DEFAULT_THROTTLE_DELAY_MS
-                  }
-
-                sessionReplay = true
-                sessionReplayConfig.screenshot = true
-                sessionReplayConfig.captureLogcat = captureLog
-                sessionReplayConfig.throttleDelayMs = throttleDelayMs.toLong()
-                sessionReplayConfig.maskAllImages = maskAllImages
-                sessionReplayConfig.maskAllTextInputs = maskAllTextInputs
-                sessionReplayConfig.sampleRate = getDoubleOrNull(sdkReplayConfig, "sampleRate")
-
-                val endpoint = getString(decideReplayConfig, "endpoint", "")
-                if (endpoint.isNotEmpty()) {
-                  snapshotEndpoint = endpoint
+              // React Native rethrows fatal JS errors natively as JavascriptException.
+              // The JS layer already captured them, so drop the native duplicate.
+              addBeforeSend { event -> if (isReactNativeFatalJsError(event)) null else event }
+
+              // Always apply the session replay configuration so that recording started later
+              // (e.g. startRecording or a linked feature flag) uses the right mode and masking;
+              // sessionReplayEnabled only controls whether recording starts at setup.
+              val maskAllTextInputs = getBoolean(sdkReplayConfig, "maskAllTextInputs", DEFAULT_MASK_ALL_TEXT_INPUTS)
+              val maskAllImages = getBoolean(sdkReplayConfig, "maskAllImages", DEFAULT_MASK_ALL_IMAGES)
+              val captureLog = getBoolean(sdkReplayConfig, "captureLog", DEFAULT_CAPTURE_LOG)
+
+              // read throttleDelayMs and use androidDebouncerDelayMs as a fallback for back compatibility
+              val throttleDelayMs =
+                when {
+                  hasKey(sdkReplayConfig, "throttleDelayMs") -> getInt(sdkReplayConfig, "throttleDelayMs", DEFAULT_THROTTLE_DELAY_MS)
+                  hasKey(sdkReplayConfig, "androidDebouncerDelayMs") -> getInt(sdkReplayConfig, "androidDebouncerDelayMs", DEFAULT_THROTTLE_DELAY_MS)
+                  else -> DEFAULT_THROTTLE_DELAY_MS
                 }
+
+              sessionReplay = sessionReplayEnabled
+              sessionReplayConfig.screenshot = true
+              sessionReplayConfig.captureLogcat = captureLog
+              sessionReplayConfig.throttleDelayMs = throttleDelayMs.toLong()
+              sessionReplayConfig.maskAllImages = maskAllImages
+              sessionReplayConfig.maskAllTextInputs = maskAllTextInputs
+              sessionReplayConfig.sampleRate = getDoubleOrNull(sdkReplayConfig, "sampleRate")
+
+              val endpoint = getString(decideReplayConfig, "endpoint", "")
+              if (endpoint.isNotEmpty()) {
+                snapshotEndpoint = endpoint
               }
 
               if (theSdkVersion.isNotEmpty()) {
@@ -280,6 +286,16 @@ class PosthogReactNativePluginModule(
     key: String,
   ): Double? = runCatching { if (hasKey(map, key)) map?.getDouble(key) else null }.getOrNull()
 
+  private fun isReactNativeFatalJsError(event: PostHogEvent): Boolean {
+    if (event.event != "\$exception") return false
+    val exceptionList = event.properties?.get("\$exception_list") as? List<*> ?: return false
+    return exceptionList.any { item ->
+      val exception = item as? Map<*, *> ?: return@any false
+      exception["type"] == "JavascriptException" &&
+        (exception["module"] as? String)?.startsWith("com.facebook.react") == true
+    }
+  }
+
   private fun logError(
     method: String,
     error: Throwable,

package/ios/PosthogReactNativePlugin.swift

@@ -5,6 +5,36 @@ private func hedgeLog(_ message: String) {
     print("[PostHog] \(message)")
 }
 
+// Deduplication works on Android (both architectures) and iOS (old architecture only).
+// On the iOS new architecture, fatal JS exception events surface as a generic SIGABRT
+// crash event with no JS-error text in any field, so they currently cannot be filtered.
+private let fatalJsErrorMarkers = ["Unhandled JS Exception", "ExceptionsManager.reportException", "facebook::jsi::JSError"]
+
+private func containsFatalJsErrorMarker(_ text: String?) -> Bool {
+    guard let text else { return false }
+    return fatalJsErrorMarkers.contains { text.contains($0) }
+}
+
+private func isReactNativeFatalJsError(_ event: PostHogEvent) -> Bool {
+    guard event.event == "$exception",
+          let exceptionList = event.properties["$exception_list"] as? [[String: Any]]
+    else { return false }
+    return exceptionList.contains { exception in
+        if containsFatalJsErrorMarker(exception["type"] as? String) {
+            return true
+        }
+        if containsFatalJsErrorMarker(exception["value"] as? String) {
+            return true
+        }
+        // New-architecture RN rethrows fatal JS errors as a C++ jsi::JSError (SIGABRT);
+        // the JS-error text only survives in the signal's crash-info message.
+        let mechanism = exception["mechanism"] as? [String: Any]
+        let meta = mechanism?["meta"] as? [String: Any]
+        let signal = meta?["signal"] as? [String: Any]
+        return containsFatalJsErrorMarker(signal?["crash_info_message"] as? String)
+    }
+}
+
 @objc(PosthogReactNativePlugin)
 class PosthogReactNativePlugin: NSObject {
     private var config: PostHogConfig?
@@ -78,47 +108,54 @@ class PosthogReactNativePlugin: NSObject {
         config.debug = debug
         config.errorTrackingConfig.autoCapture = nativeErrorTrackingAutocapture
 
+        // React Native rethrows fatal JS errors natively (RCTFatalException / ExceptionsManager).
+        // The JS layer already captured them, so drop the native duplicate.
+        config.setBeforeSend { event in
+            isReactNativeFatalJsError(event) ? nil : event
+        }
+
         if #available(iOS 15.0, *) {
             config.surveys = false
         }
 
-        if sessionReplayEnabled {
-            config.sessionReplay = true
-            config.sessionReplayConfig.screenshotMode = true
+        // Always apply the session replay configuration so that recording started later
+        // (e.g. startRecording or a linked feature flag) uses the right mode and masking;
+        // sessionReplayEnabled only controls whether recording starts at setup.
+        config.sessionReplay = sessionReplayEnabled
+        config.sessionReplayConfig.screenshotMode = true
 
-            let maskAllTextInputs = sdkReplayConfig["maskAllTextInputs"] as? Bool ?? true
-            config.sessionReplayConfig.maskAllTextInputs = maskAllTextInputs
+        let maskAllTextInputs = sdkReplayConfig["maskAllTextInputs"] as? Bool ?? true
+        config.sessionReplayConfig.maskAllTextInputs = maskAllTextInputs
 
-            let maskAllImages = sdkReplayConfig["maskAllImages"] as? Bool ?? true
-            config.sessionReplayConfig.maskAllImages = maskAllImages
+        let maskAllImages = sdkReplayConfig["maskAllImages"] as? Bool ?? true
+        config.sessionReplayConfig.maskAllImages = maskAllImages
 
-            let maskAllSandboxedViews = sdkReplayConfig["maskAllSandboxedViews"] as? Bool ?? true
-            config.sessionReplayConfig.maskAllSandboxedViews = maskAllSandboxedViews
+        let maskAllSandboxedViews = sdkReplayConfig["maskAllSandboxedViews"] as? Bool ?? true
+        config.sessionReplayConfig.maskAllSandboxedViews = maskAllSandboxedViews
 
-            // read throttleDelayMs and use iOSdebouncerDelayMs as a fallback for back compatibility
-            let throttleDelayMs =
-                (sdkReplayConfig["throttleDelayMs"] as? Int)
-                    ?? (sdkReplayConfig["iOSdebouncerDelayMs"] as? Int)
-                    ?? 1000
+        // read throttleDelayMs and use iOSdebouncerDelayMs as a fallback for back compatibility
+        let throttleDelayMs =
+            (sdkReplayConfig["throttleDelayMs"] as? Int)
+                ?? (sdkReplayConfig["iOSdebouncerDelayMs"] as? Int)
+                ?? 1000
 
-            let timeInterval: TimeInterval = Double(throttleDelayMs) / 1000.0
-            config.sessionReplayConfig.throttleDelay = timeInterval
+        let timeInterval: TimeInterval = Double(throttleDelayMs) / 1000.0
+        config.sessionReplayConfig.throttleDelay = timeInterval
 
-            let captureNetworkTelemetry = sdkReplayConfig["captureNetworkTelemetry"] as? Bool ?? true
-            config.sessionReplayConfig.captureNetworkTelemetry = captureNetworkTelemetry
+        let captureNetworkTelemetry = sdkReplayConfig["captureNetworkTelemetry"] as? Bool ?? true
+        config.sessionReplayConfig.captureNetworkTelemetry = captureNetworkTelemetry
 
-            let captureLog = sdkReplayConfig["captureLog"] as? Bool ?? true
-            config.sessionReplayConfig.captureLogs = captureLog
+        let captureLog = sdkReplayConfig["captureLog"] as? Bool ?? true
+        config.sessionReplayConfig.captureLogs = captureLog
 
-            config.sessionReplayConfig.sampleRate = sdkReplayConfig["sampleRate"] as? NSNumber
+        config.sessionReplayConfig.sampleRate = sdkReplayConfig["sampleRate"] as? NSNumber
 
-            let screenshotModeBackgroundCapture = sdkReplayConfig["screenshotModeBackgroundCapture"] as? Bool ?? false
-            config.sessionReplayConfig.screenshotModeBackgroundCapture = screenshotModeBackgroundCapture
+        let screenshotModeBackgroundCapture = sdkReplayConfig["screenshotModeBackgroundCapture"] as? Bool ?? false
+        config.sessionReplayConfig.screenshotModeBackgroundCapture = screenshotModeBackgroundCapture
 
-            let endpoint = decideReplayConfig["endpoint"] as? String ?? ""
-            if !endpoint.isEmpty {
-                config.snapshotEndpoint = endpoint
-            }
+        let endpoint = decideReplayConfig["endpoint"] as? String ?? ""
+        if !endpoint.isEmpty {
+            config.snapshotEndpoint = endpoint
         }
 
         let distinctId = sdkOptions["distinctId"] as? String ?? ""

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/react-native-plugin",
-  "version": "2.0.0",
+  "version": "2.0.1",
   "description": "PostHog React Native plugin for iOS and Android integrations",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",