feat(core): Expose pauseAppHangTracking and resumeAppHangTracking APIs

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: antonis

CHANGELOG.md

@@ -19,6 +19,7 @@
 - Add `textComponentNames` option to `annotateReactComponents` for custom text components ([#6169](https://github.com/getsentry/sentry-react-native/pull/6169))
 - Expose `addConsoleInstrumentationFilter` from `@sentry/core` ([#6180](https://github.com/getsentry/sentry-react-native/pull/6180))
 - Expose experimental `captureSurfaceViews` option for Android Session Replay ([#6175](https://github.com/getsentry/sentry-react-native/pull/6175))
+- Expose `pauseAppHangTracking` and `resumeAppHangTracking` APIs on iOS ([#6192](https://github.com/getsentry/sentry-react-native/pull/6192))
 
 ### Fixes
 

packages/core/android/src/main/java/io/sentry/react/RNSentryModuleImpl.java

@@ -279,6 +279,14 @@ public void disableShakeDetection() {
     stopShakeDetection();
   }
 
+  public void pauseAppHangTracking() {
+    // No-op: App hang tracking is iOS-only
+  }
+
+  public void resumeAppHangTracking() {
+    // No-op: App hang tracking is iOS-only
+  }
+
   public void fetchModules(Promise promise) {
     final AssetManager assets = this.getReactApplicationContext().getResources().getAssets();
     try (InputStream stream = new BufferedInputStream(assets.open(modulesPath))) {

packages/core/android/src/newarch/java/io/sentry/react/RNSentryModule.java

@@ -234,6 +234,16 @@ public void disableShakeDetection() {
     this.impl.disableShakeDetection();
   }
 
+  @Override
+  public void pauseAppHangTracking() {
+    this.impl.pauseAppHangTracking();
+  }
+
+  @Override
+  public void resumeAppHangTracking() {
+    this.impl.resumeAppHangTracking();
+  }
+
   @Override
   public void invalidate() {
     this.impl.invalidate();

packages/core/android/src/oldarch/java/io/sentry/react/RNSentryModule.java

@@ -234,6 +234,16 @@ public void disableShakeDetection() {
     this.impl.disableShakeDetection();
   }
 
+  @ReactMethod
+  public void pauseAppHangTracking() {
+    this.impl.pauseAppHangTracking();
+  }
+
+  @ReactMethod
+  public void resumeAppHangTracking() {
+    this.impl.resumeAppHangTracking();
+  }
+
   @Override
   public void invalidate() {
     this.impl.invalidate();

packages/core/etc/sentry-react-native.api.md

@@ -490,6 +490,9 @@ export { OpenAiClient }
 
 export { OpenAiOptions }
 
+// @public
+export function pauseAppHangTracking(): void;
+
 // @public
 export const primitiveTagIntegration: () => Integration;
 
@@ -554,6 +557,9 @@ export const reactNavigationIntegration: (input?: Partial<ReactNavigationIntegra
     options: ReactNavigationIntegrationOptions;
 };
 
+// @public
+export function resumeAppHangTracking(): void;
+
 export { rewriteFramesIntegration }
 
 export { Scope }

packages/core/ios/RNSentry.mm

@@ -798,6 +798,10 @@ + (SentryUser *_Nullable)userFrom:(NSDictionary *)userKeys
     // the 'tracesSampleRate' or 'tracesSampler' option.
 }
 
+RCT_EXPORT_METHOD(pauseAppHangTracking) { [SentrySDKWrapper pauseAppHangTracking]; }
+
+RCT_EXPORT_METHOD(resumeAppHangTracking) { [SentrySDKWrapper resumeAppHangTracking]; }
+
 /**
  * Calls captureReplay on the native replay integration and returns
  * the BOOL result indicating whether the capture succeeded.

packages/core/ios/SentrySDKWrapper.h

@@ -12,6 +12,10 @@
 
 + (BOOL)crashedLastRun;
 
++ (void)pauseAppHangTracking;
+
++ (void)resumeAppHangTracking;
+
 + (BOOL)debug;
 
 + (NSString *)releaseName;

packages/core/ios/SentrySDKWrapper.m

@@ -18,6 +18,16 @@ + (BOOL)crashedLastRun
     return [SentrySDK crashedLastRun];
 }
 
++ (void)pauseAppHangTracking
+{
+    [SentrySDK pauseAppHangTracking];
+}
+
++ (void)resumeAppHangTracking
+{
+    [SentrySDK resumeAppHangTracking];
+}
+
 + (void)configureScope:(void (^)(SentryScope *scope))callback
 {
     [SentrySDK configureScope:callback];

packages/core/src/js/NativeRNSentry.ts

@@ -60,6 +60,8 @@ export interface Spec extends TurboModule {
   encodeToBase64(data: number[]): Promise<string | undefined | null>;
   enableShakeDetection(): void;
   disableShakeDetection(): void;
+  pauseAppHangTracking(): void;
+  resumeAppHangTracking(): void;
 }
 
 export type NativeStackFrame = {

packages/core/src/js/index.ts

@@ -98,7 +98,18 @@ export { SDK_NAME, SDK_VERSION } from './version';
 export type { ReactNativeOptions, NativeLogEntry } from './options';
 export { ReactNativeClient } from './client';
 
-export { init, wrap, nativeCrash, flush, close, withScope, crashedLastRun, appLoaded } from './sdk';
+export {
+  init,
+  wrap,
+  nativeCrash,
+  flush,
+  close,
+  withScope,
+  crashedLastRun,
+  appLoaded,
+  pauseAppHangTracking,
+  resumeAppHangTracking,
+} from './sdk';
 export { TouchEventBoundary, withTouchEventBoundary } from './touchevents';
 export { GlobalErrorBoundary, withGlobalErrorBoundary } from './GlobalErrorBoundary';
 export type { GlobalErrorBoundaryProps } from './GlobalErrorBoundary';