@posthog/react-native-plugin 2.1.1 → 2.2.0

package/LICENSE

@@ -327,12 +327,12 @@ SOFTWARE.
 
 ---
 
-Some files in this codebase contain code from MCPCat/mcpcat-typescript-sdk.
+Some files in this codebase contain code from agentcathq/agentcat-typescript-sdk (formerly 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
+Copyright (c) 2025 AgentCat, Inc. (formerly 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

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.51.1"
+  implementation "com.posthog:posthog-android:3.52.0"
 }
 

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

@@ -93,6 +93,13 @@ class PosthogReactNativePluginModule(
           val theSdkVersion = getString(sdkOptions, "sdkVersion", "")
           val theFlushAt = getInt(sdkOptions, "flushAt", DEFAULT_FLUSH_AT)
 
+          // 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).
+          val theRequestHeaders =
+            getMap(sdkOptions, "requestHeaders")?.toHashMap()
+              ?.filterValues { it is String }
+              ?.mapValues { it.value as String }
+
           val config =
             PostHogAndroidConfig(apiKey, host).apply {
               debug = debugValue
@@ -100,6 +107,7 @@ class PosthogReactNativePluginModule(
               captureApplicationLifecycleEvents = false
               captureScreenViews = false
               flushAt = theFlushAt
+              theRequestHeaders?.let { requestHeaders = it }
               errorTrackingConfig.autoCapture = nativeErrorTrackingAutocapture
 
               // Keep the native exception-steps buffer aligned with the JS layer (one logical buffer).

package/ios/PosthogReactNativePlugin.swift

@@ -5,7 +5,18 @@ private func hedgeLog(_ message: String) {
     print("[PostHog] \(message)")
 }
 
-// Deduplication works on Android (both architectures) and iOS (old architecture only).
+#if !os(iOS)
+    // Session replay is part of posthog-ios's iOS-only surface, so recording is a no-op on macOS.
+    // Log once so a caller isn't left wondering why recording "started" but nothing arrives.
+    private var didLogSessionReplayUnsupported = false
+    private func logSessionReplayUnsupportedOnMacOS() {
+        guard !didLogSessionReplayUnsupported else { return }
+        didLogSessionReplayUnsupported = true
+        hedgeLog("Session replay is not supported on macOS")
+    }
+#endif
+
+// Deduplication works on Android (both architectures), iOS (old architecture only), and macOS.
 // 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"]
@@ -126,49 +137,53 @@ class PosthogReactNativePlugin: NSObject {
             isReactNativeFatalJsError(event) ? nil : event
         }
 
-        if #available(iOS 15.0, *) {
-            config.surveys = false
-        }
+        // Surveys and session replay are iOS-only in posthog-ios, so the APIs below
+        // don't exist on macOS. macOS gets error tracking only.
+        #if os(iOS)
+            if #available(iOS 15.0, *) {
+                config.surveys = false
+            }
 
-        // 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
+            // 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
+            }
+        #endif
 
         let distinctId = sdkOptions["distinctId"] as? String ?? ""
         let anonymousId = sdkOptions["anonymousId"] as? String ?? ""
@@ -178,6 +193,13 @@ class PosthogReactNativePlugin: NSObject {
         let flushAt = sdkOptions["flushAt"] as? Int ?? 20
         config.flushAt = flushAt
 
+        // 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).
+        if let rawHeaders = sdkOptions["requestHeaders"] as? [String: Any] {
+            config.requestHeaders = rawHeaders.compactMapValues { $0 as? String }
+        }
+
         if !sdkVersion.isEmpty {
             postHogSdkName = "posthog-react-native"
             postHogVersion = sdkVersion
@@ -214,8 +236,12 @@ class PosthogReactNativePlugin: NSObject {
 
     @objc(isEnabled:withRejecter:)
     func isEnabled(resolve: RCTPromiseResolveBlock, reject _: RCTPromiseRejectBlock) {
-        let isEnabled = PostHogSDK.shared.isSessionReplayActive()
-        resolve(isEnabled)
+        #if os(iOS)
+            resolve(PostHogSDK.shared.isSessionReplayActive())
+        #else
+            // Session replay is unsupported on macOS.
+            resolve(false)
+        #endif
     }
 
     @objc(endSession:withRejecter:)
@@ -254,13 +280,21 @@ class PosthogReactNativePlugin: NSObject {
     func startRecording(
         resumeCurrent: Bool, resolve: RCTPromiseResolveBlock, reject _: RCTPromiseRejectBlock
     ) {
-        PostHogSDK.shared.startSessionRecording(resumeCurrent: resumeCurrent)
+        #if os(iOS)
+            PostHogSDK.shared.startSessionRecording(resumeCurrent: resumeCurrent)
+        #else
+            logSessionReplayUnsupportedOnMacOS()
+        #endif
         resolve(nil)
     }
 
     @objc(stopRecording:withRejecter:)
     func stopRecording(resolve: RCTPromiseResolveBlock, reject _: RCTPromiseRejectBlock) {
-        PostHogSDK.shared.stopSessionRecording()
+        #if os(iOS)
+            PostHogSDK.shared.stopSessionRecording()
+        #else
+            logSessionReplayUnsupportedOnMacOS()
+        #endif
         resolve(nil)
     }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@posthog/react-native-plugin",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "PostHog React Native plugin for iOS and Android integrations",
   "source": "./src/index.tsx",
   "main": "./lib/commonjs/index.js",
@@ -39,7 +39,8 @@
   "keywords": [
     "react-native",
     "ios",
-    "android"
+    "android",
+    "macos"
   ],
   "repository": {
     "type": "git",

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.61.1'
+posthog_ios_version = '3.63.0'
 
 Pod::Spec.new do |s|
   s.name         = "posthog-react-native-plugin"
@@ -16,7 +16,7 @@ Pod::Spec.new do |s|
   s.license      = package["license"]
   s.authors      = package["author"]
 
-  s.platforms    = { :ios => min_ios_version_supported }
+  s.platforms    = { :ios => min_ios_version_supported, :osx => '10.15' }
   s.source       = { :git => "https://github.com/PostHog/posthog-js.git", :tag => "@posthog/react-native-plugin@#{s.version}" }
 
   s.source_files = "ios/**/*.{swift,h,hpp,m,mm,c,cpp}"
@@ -40,6 +40,7 @@ Pod::Spec.new do |s|
     s.dependency 'PostHog', "~> #{posthog_ios_version}"
   end
   s.ios.deployment_target = '13.0'
+  s.osx.deployment_target = '10.15'
   s.swift_versions = "5.3"