feat(core): Aggregate TurboModule call counts and latency per (module, method, kind)

CHANGELOG.md

@@ -10,6 +10,23 @@
 
 ### Features
 
+- Aggregate TurboModule call counts + latency per `(module, method, kind)` and flush them on transaction finish and on a lazy periodic timer ([#6377](https://github.com/getsentry/sentry-react-native/pull/6377))
+
+  Counters land on the finishing transaction as a synthetic `turbo_modules.aggregate` child span (per-call breakdown in span attributes) plus headline measurements on the root span (`turbo_modules.call_count`, `turbo_modules.error_count`, `turbo_modules.total_ms`, `turbo_modules.top_module_ms`). Long-running sessions without transactions emit a periodic info-level event (default every 30s, only when there's data).
+
+  ```ts
+  Sentry.init({
+    integrations: [
+      Sentry.turboModuleContextIntegration({
+        // optional knobs (defaults shown):
+        enableAggregateStats: true,
+        aggregateFlushIntervalMs: 30_000,
+        ignoreTurboModules: ['RNSentry'],
+      }),
+    ],
+  });
+  ```
+
 - Add `Sentry.reportFullyDisplayed()` imperative API for signaling Time to Full Display ([#6419](https://github.com/getsentry/sentry-react-native/pull/6419))
 - Add `enableHistoricalTombstoneReporting` option to report historical tombstones from Android's `ApplicationExitInfo` ([#6450](https://github.com/getsentry/sentry-react-native/pull/6450))
 

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

@@ -856,17 +856,23 @@ export { TransactionEvent }
 // @public
 export interface TurboModuleCall {
     callId: number;
-    kind: 'sync' | 'async';
+    kind: TurboModuleCallKind;
     method: string;
     name: string;
     startedAtMs: number;
 }
 
+// @public
+export type TurboModuleCallKind = 'sync' | 'async';
+
 // @public
 export const turboModuleContextIntegration: (options?: TurboModuleContextOptions) => Integration;
 
 // @public (undocumented)
 export interface TurboModuleContextOptions {
+    aggregateFlushIntervalMs?: number;
+    enableAggregateStats?: boolean;
+    ignoreTurboModules?: ReadonlyArray<string>;
     modules?: Array<{
         name: string;
         module: object | null | undefined;

packages/core/src/js/index.ts

@@ -172,4 +172,4 @@ export {
   pushTurboModuleCall,
   wrapTurboModule,
 } from './turbomodule';
-export type { TurboModuleCall } from './turbomodule';
+export type { TurboModuleCall, TurboModuleCallKind } from './turbomodule';