@goliapkg/sentori-react-native 0.8.5 → 0.9.1

package/src/native.ts

@@ -11,6 +11,41 @@ type SentoriNativeModule = {
     release: string
     token: string
   }) => void
+  /**
+   * v0.9.4 #1 — cold start measurement. iOS:
+   * `mach_absolute_time` from `applicationDidFinishLaunching` to first
+   * JS bridge ready. Android: `Process.getStartElapsedRealtime()`.
+   * Returns null when native side hasn't captured yet.
+   */
+  getColdStartMs?: () => null | number
+  /**
+   * v0.9.4 #1 — call once at JS init() to finalize the cold-start
+   * measurement. iOS subtracts from the app-delegate anchor;
+   * Android uses Process.getStartElapsedRealtime() so the call is
+   * idempotent if missed.
+   */
+  markJsBridgeReady?: () => void
+  /**
+   * v0.9.4 #1 — slow/frozen frame counters since the most recent
+   * navigation transition. Native side hooks `CADisplayLink` (iOS)
+   * / `Choreographer.FrameCallback` (Android). Frame > 16.67ms =
+   * slow; > 700ms = frozen.
+   */
+  getFrameCounters?: () => null | { frozen: number; slow: number }
+  /** Reset counters on navigation transition (called by useTraceNavigation). */
+  resetFrameCounters?: () => void
+  /**
+   * v0.9.5 #8 — read the most-recent native exception recorded by
+   * `SentoriNativeExceptionBridge` within the last 1 s. Used by the
+   * JS-side capture path to attach native stack info to a JSError
+   * that RN wrapped from a swallowed NSException / Java Exception.
+   */
+  getRecentNativeException?: () => null | {
+    ageMs: number
+    name: string
+    reason: string
+    stack: string[]
+  }
   /**
    * v0.7.3 — JS-triggered screenshot with consumer-supplied mask IDs.
    * `maskedIds` are RN `nativeID` strings; native walks the view
@@ -127,6 +162,59 @@ export function stopAnrWatchdog(): void {
   }
 }
 
+/** v0.9.4 #1 — finalize cold-start measurement. Idempotent. */
+export function markNativeJsBridgeReady(): void {
+  try {
+    native()?.markJsBridgeReady?.()
+  } catch {
+    // ignore
+  }
+}
+
+/** v0.9.4 #1 — read cold start ms once. null when native unavailable. */
+export function getNativeColdStartMs(): null | number {
+  try {
+    const v = native()?.getColdStartMs?.()
+    return typeof v === 'number' && Number.isFinite(v) ? v : null
+  } catch {
+    return null
+  }
+}
+
+/** v0.9.4 #1 — read slow/frozen frame counters since last reset. */
+export function getNativeFrameCounters(): null | { frozen: number; slow: number } {
+  try {
+    return native()?.getFrameCounters?.() ?? null
+  } catch {
+    return null
+  }
+}
+
+/** v0.9.4 #1 — reset frame counters on navigation transition. */
+export function resetNativeFrameCounters(): void {
+  try {
+    native()?.resetFrameCounters?.()
+  } catch {
+    // ignore
+  }
+}
+
+/** v0.9.5 #8 — fetch the most-recent native exception from
+ *  SentoriNativeExceptionBridge (within last ~1 s). null if none or
+ *  bridge not linked. */
+export function getRecentNativeException(): null | {
+  ageMs: number
+  name: string
+  reason: string
+  stack: string[]
+} {
+  try {
+    return native()?.getRecentNativeException?.() ?? null
+  } catch {
+    return null
+  }
+}
+
 /**
  * v0.7.3 — drives the native screenshot path. JS side passes the
  * current list of mask `nativeID`s (read from the consumer's

package/src/navigation.ts

@@ -24,6 +24,10 @@ import { useEffect, useRef } from 'react';
 
 import { setActiveSpan, startSpan, type SpanHandle } from '@goliapkg/sentori-core';
 
+import {
+  getNativeFrameCounters,
+  resetNativeFrameCounters,
+} from './native';
 import { captureStep } from './trail';
 
 /** Minimal contract: anything with `addListener('state', cb)` and
@@ -101,11 +105,21 @@ export function useTraceNavigation(navigationRef: NavigationRefLike): void {
       const enteredAt = lastRouteEnteredAtRef.current;
       if (!span) return null;
       const dwellMs = enteredAt !== null ? Math.max(0, Date.now() - enteredAt) : null;
+      // v0.9.4 #1 — drain native frame counters at screen-leave.
+      // Empty/null when native module not linked; tags omitted.
+      const fc = getNativeFrameCounters();
+      const finishTags: Record<string, string> = {};
+      if (dwellMs !== null) finishTags['nav.dwell_ms'] = String(dwellMs);
+      if (fc) {
+        finishTags['vital.slow_frames'] = String(fc.slow);
+        finishTags['vital.frozen_frames'] = String(fc.frozen);
+      }
       span.finish({
         status: 'ok',
-        // Tag values are strings on the wire — cast at finish-time.
-        tags: dwellMs !== null ? { 'nav.dwell_ms': String(dwellMs) } : undefined,
+        tags: Object.keys(finishTags).length > 0 ? finishTags : undefined,
       });
+      // Reset counters for the next screen.
+      resetNativeFrameCounters();
       return dwellMs;
     };