@cxpinsight/react-native 0.20.0 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,23 @@
 # Changelog
 
+## 0.21.0
+
+Requires `@cxpinsight/survey-spec@^0.11.0` (unchanged).
+
+### Added
+- **App start and frame vitals on Android.** `APP_START_COLD` (process start → the first
+  screen's first frame, once per process), `APP_START_WARM` (activity re-created while the
+  process lived on), `APP_START_HOT` (back to the foreground) and, per screen visit,
+  `SLOW_FRAMES` / `FROZEN_FRAMES` (share of drawn frames over their deadline / over 700 ms,
+  Android vitals definitions), as `web_vitals` events like the rest. Android is also told
+  when the first screen is fully drawn (`reportFullyDrawn`), so the system's own
+  startup numbers (Play Console, Macrobenchmark) see it. Measured on an API 35 emulator
+  against Android's own numbers: cold start within 64 ms of "Fully drawn", hot start within
+  a frame of `am start -W`, slow frames 8.0 % vs `gfxinfo` 8.6 %.
+  Needs a native build (not Expo Go); visits under 30 frames report no frame share.
+- iOS ships the same native module, switched off until it has been measured on iOS; iOS
+  keeps screen load, INP and JS stall from 0.20.0.
+
 ## 0.20.0
 
 Requires `@cxpinsight/survey-spec@^0.11.0`. Publish that first.

package/android/src/main/java/com/cxpinsight/reactnative/CXPVitalsModule.java

@@ -0,0 +1,170 @@
+package com.cxpinsight.reactnative;
+
+import android.app.Activity;
+import android.app.Application;
+import android.os.Build;
+import android.os.Bundle;
+import android.os.Handler;
+import android.os.HandlerThread;
+import android.os.Process;
+import android.os.SystemClock;
+import android.view.FrameMetrics;
+import android.view.Window;
+
+import androidx.annotation.NonNull;
+import androidx.annotation.Nullable;
+
+import com.facebook.react.bridge.Arguments;
+import com.facebook.react.bridge.Promise;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.bridge.ReactContextBaseJavaModule;
+import com.facebook.react.bridge.ReactMethod;
+import com.facebook.react.bridge.WritableMap;
+
+import java.lang.ref.WeakReference;
+
+/**
+ * Mobile vitals that only native code can see — the Android half of ios/CXPVitals.m and the native
+ * half of src/core/vitals.ts.
+ *
+ * getLaunchInfo   when this process started, when an activity was last created (a WARM start: the
+ *                 process lived on, the activity did not) and when the app last came to the
+ *                 foreground (a HOT start) — wall-clock ms, the clock JS's Date.now() reads.
+ * startFrameMonitor / getFrameStats
+ *                 frames DRAWN since the monitor started (FrameMetrics, the source Google's JankStats
+ *                 uses): total, slow (over the frame's deadline — the vsync interval) and frozen (over
+ *                 700 ms), the Android vitals definitions. Cumulative; JS takes the difference per
+ *                 screen visit.
+ */
+public class CXPVitalsModule extends ReactContextBaseJavaModule {
+  static final String NAME = "CXPVitals";
+
+  private static final long FROZEN_NS = 700_000_000L;
+
+  private static volatile double activityCreatedMs = 0;
+  private static volatile double foregroundMs = 0;
+  private static volatile boolean callbacksRegistered = false;
+  // A cold start happens once per process; a JS reload in the same process is not one.
+  private static volatile boolean launchReported = false;
+
+  private long total = 0, slow = 0, frozen = 0;
+  private boolean monitoring = false;
+  private WeakReference<Window> watched = new WeakReference<>(null);
+  private Window.OnFrameMetricsAvailableListener listener;
+  private HandlerThread metricsThread;
+  private Handler metricsHandler;
+
+  CXPVitalsModule(ReactApplicationContext context) {
+    super(context);
+    registerLifecycle(context);
+  }
+
+  @NonNull
+  @Override
+  public String getName() { return NAME; }
+
+  private static double wallFromElapsed(long elapsedMs) {
+    return System.currentTimeMillis() - (SystemClock.elapsedRealtime() - elapsedMs);
+  }
+
+  private void registerLifecycle(ReactApplicationContext context) {
+    if (callbacksRegistered) return;
+    if (!(context.getApplicationContext() instanceof Application)) return;
+    callbacksRegistered = true;
+    ((Application) context.getApplicationContext()).registerActivityLifecycleCallbacks(
+      new Application.ActivityLifecycleCallbacks() {
+        @Override public void onActivityCreated(@NonNull Activity a, @Nullable Bundle b) {
+          activityCreatedMs = System.currentTimeMillis();
+        }
+        @Override public void onActivityStarted(@NonNull Activity a) {
+          foregroundMs = System.currentTimeMillis();
+          if (monitoring) attach(a);
+        }
+        @Override public void onActivityResumed(@NonNull Activity a) { if (monitoring) attach(a); }
+        @Override public void onActivityPaused(@NonNull Activity a) {}
+        @Override public void onActivityStopped(@NonNull Activity a) {}
+        @Override public void onActivitySaveInstanceState(@NonNull Activity a, @NonNull Bundle b) {}
+        @Override public void onActivityDestroyed(@NonNull Activity a) {}
+      });
+  }
+
+  @ReactMethod
+  public void getLaunchInfo(Promise promise) {
+    WritableMap m = Arguments.createMap();
+    boolean first = !launchReported;
+    launchReported = true;
+    m.putBoolean("firstInProcess", first);
+    double processStart = Build.VERSION.SDK_INT >= Build.VERSION_CODES.N
+      ? wallFromElapsed(Process.getStartElapsedRealtime()) : 0;
+    m.putDouble("processStartMs", processStart);
+    m.putBoolean("prewarmed", false);
+    m.putDouble("finishedLaunchingMs", 0);
+    m.putDouble("foregroundMs", foregroundMs);
+    m.putDouble("activityCreatedMs", activityCreatedMs);
+    m.putDouble("nowMs", System.currentTimeMillis());
+    m.putString("frameSource", "frame_metrics");
+    promise.resolve(m);
+  }
+
+  @ReactMethod
+  public void startFrameMonitor() {
+    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N) return;
+    monitoring = true;
+    Activity a = getCurrentActivity();
+    if (a != null) a.runOnUiThread(() -> attach(a));
+  }
+
+  private synchronized void attach(Activity activity) {
+    if (Build.VERSION.SDK_INT < Build.VERSION_CODES.N || activity == null) return;
+    Window window = activity.getWindow();
+    if (window == null || window == watched.get()) return;
+    Window previous = watched.get();
+    if (previous != null && listener != null) {
+      try { previous.removeOnFrameMetricsAvailableListener(listener); } catch (Exception ignored) {}
+    }
+    if (metricsThread == null) {
+      metricsThread = new HandlerThread("cxp-frame-metrics");
+      metricsThread.start();
+      metricsHandler = new Handler(metricsThread.getLooper());
+    }
+    if (listener == null) {
+      listener = (w, metrics, dropped) -> {
+        long duration = metrics.getMetric(FrameMetrics.TOTAL_DURATION);
+        long deadline = Build.VERSION.SDK_INT >= Build.VERSION_CODES.S
+          ? metrics.getMetric(FrameMetrics.DEADLINE) : 16_666_667L;
+        synchronized (CXPVitalsModule.this) {
+          total += 1 + dropped;
+          if (duration > deadline) slow += 1;
+          if (duration > FROZEN_NS) frozen += 1;
+        }
+      };
+    }
+    try {
+      window.addOnFrameMetricsAvailableListener(listener, metricsHandler);
+      watched = new WeakReference<>(window);
+    } catch (Exception ignored) {}
+  }
+
+  /**
+   * The first screen's content is on the display: tell Android, so the system logs "Fully drawn"
+   * (Time to Full Display, measured by Android from the launch) — what Play Console's startup
+   * metrics and Macrobenchmark read. Once per process; Android ignores repeats.
+   */
+  @ReactMethod
+  public void reportFullyDrawn() {
+    Activity a = getCurrentActivity();
+    if (a == null) return;
+    a.runOnUiThread(() -> { try { a.reportFullyDrawn(); } catch (Exception ignored) {} });
+  }
+
+  @ReactMethod
+  public void getFrameStats(Promise promise) {
+    WritableMap m = Arguments.createMap();
+    synchronized (this) {
+      m.putDouble("total", total);
+      m.putDouble("slow", slow);
+      m.putDouble("frozen", frozen);
+    }
+    promise.resolve(m);
+  }
+}

package/android/src/main/java/com/cxpinsight/reactnative/CXPinsightPackage.java

@@ -7,6 +7,7 @@ import com.facebook.react.bridge.NativeModule;
 import com.facebook.react.bridge.ReactApplicationContext;
 import com.facebook.react.uimanager.ViewManager;
 
+import java.util.Arrays;
 import java.util.Collections;
 import java.util.List;
 
@@ -14,7 +15,7 @@ public class CXPinsightPackage implements ReactPackage {
   @NonNull
   @Override
   public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
-    return Collections.<NativeModule>singletonList(new CXPScreenshotModule(reactContext));
+    return Arrays.<NativeModule>asList(new CXPScreenshotModule(reactContext), new CXPVitalsModule(reactContext));
   }
 
   @NonNull

package/ios/CXPVitals.m

@@ -0,0 +1,143 @@
+// Mobile vitals that only native code can see — the native half of src/core/vitals.ts.
+//
+//   getLaunchInfo  when this process started (and whether iOS prewarmed it), when the app finished
+//                  launching, and when it last came to the foreground — wall-clock ms, the clock
+//                  JS's Date.now() reads, so JS can measure up to the first frame it sees.
+//   startFrameMonitor / getFrameStats
+//                  frames the main thread delivered since the monitor started: total, slow (later
+//                  than 1.5 refresh intervals — a missed deadline) and frozen (over 700 ms), the
+//                  Android vitals definitions. Counts are cumulative; JS takes the difference per
+//                  screen visit. Paused while the app is in the background.
+//
+// Prewarm: since iOS 15 the system may start an app's process before anyone opens it, so the process
+// start can be minutes before the launch. Apple's advice is to measure such launches from when the
+// app finishes launching instead; `prewarmed` says which one JS should use.
+
+#import <React/RCTBridgeModule.h>
+#import <UIKit/UIKit.h>
+#import <QuartzCore/QuartzCore.h>
+#include <sys/sysctl.h>
+#include <unistd.h>
+
+static double CXPNowMs(void) { return [[NSDate date] timeIntervalSince1970] * 1000.0; }
+
+static double cxpProcessStartMs = 0;
+static double cxpFinishedLaunchingMs = 0;
+static double cxpForegroundMs = 0;
+static BOOL cxpPrewarmed = NO;
+// A cold start happens once per process; a JS reload in the same process is not one.
+static BOOL cxpLaunchReported = NO;
+
+static double CXPProcessStartMs(void)
+{
+  struct kinfo_proc info;
+  size_t size = sizeof(info);
+  int mib[4] = { CTL_KERN, KERN_PROC, KERN_PROC_PID, getpid() };
+  if (sysctl(mib, 4, &info, &size, NULL, 0) != 0) return 0;
+  struct timeval t = info.kp_proc.p_starttime;
+  return t.tv_sec * 1000.0 + t.tv_usec / 1000.0;
+}
+
+// Runs before main() — so the launch notifications below are never missed. A C constructor rather
+// than +load: RCT_EXPORT_MODULE defines +load on this class to register the module.
+__attribute__((constructor)) static void CXPVitalsLaunchHooks(void)
+{
+  cxpProcessStartMs = CXPProcessStartMs();
+  const char *prewarm = getenv("ActivePrewarm");
+  cxpPrewarmed = prewarm != NULL && strcmp(prewarm, "1") == 0;
+  NSNotificationCenter *nc = [NSNotificationCenter defaultCenter];
+  [nc addObserverForName:UIApplicationDidFinishLaunchingNotification object:nil queue:nil
+              usingBlock:^(__unused NSNotification *n) { cxpFinishedLaunchingMs = CXPNowMs(); }];
+  [nc addObserverForName:UIApplicationWillEnterForegroundNotification object:nil queue:nil
+              usingBlock:^(__unused NSNotification *n) { cxpForegroundMs = CXPNowMs(); }];
+}
+
+@interface CXPFrameMonitor : NSObject
+@property (nonatomic, strong) CADisplayLink *link;
+@property (nonatomic) CFTimeInterval last;
+@property (nonatomic) long long total;
+@property (nonatomic) long long slow;
+@property (nonatomic) long long frozen;
+@end
+
+@implementation CXPFrameMonitor
+
+- (void)start
+{
+  if (self.link) return;
+  self.link = [CADisplayLink displayLinkWithTarget:self selector:@selector(tick:)];
+  [self.link addToRunLoop:[NSRunLoop mainRunLoop] forMode:NSRunLoopCommonModes];
+  NSNotificationCenter *nc = [NSNotificationCenter defaultCenter];
+  [nc addObserver:self selector:@selector(pause) name:UIApplicationDidEnterBackgroundNotification object:nil];
+  [nc addObserver:self selector:@selector(resume) name:UIApplicationDidBecomeActiveNotification object:nil];
+}
+
+- (void)pause { self.link.paused = YES; self.last = 0; }
+- (void)resume { self.last = 0; self.link.paused = NO; }
+
+- (void)tick:(CADisplayLink *)link
+{
+  CFTimeInterval now = link.timestamp;
+  if (self.last > 0) {
+    CFTimeInterval expected = link.targetTimestamp - link.timestamp;
+    if (expected <= 0 || expected > 0.1) expected = 1.0 / 60.0;
+    CFTimeInterval dt = now - self.last;
+    self.total += 1;
+    if (dt > expected * 1.5) self.slow += 1;
+    if (dt > 0.7) self.frozen += 1;
+  }
+  self.last = now;
+}
+
+@end
+
+@interface CXPVitals : NSObject <RCTBridgeModule>
+@end
+
+@implementation CXPVitals
+
+RCT_EXPORT_MODULE(CXPVitals)
+
+static CXPFrameMonitor *cxpMonitor = nil;
+
+
++ (BOOL)requiresMainQueueSetup { return NO; }
+- (dispatch_queue_t)methodQueue { return dispatch_get_main_queue(); }
+
+RCT_EXPORT_METHOD(getLaunchInfo:(RCTPromiseResolveBlock)resolve
+                  reject:(__unused RCTPromiseRejectBlock)reject)
+{
+  BOOL first = !cxpLaunchReported;
+  cxpLaunchReported = YES;
+  resolve(@{
+    @"firstInProcess": @(first),
+    @"processStartMs": @(cxpProcessStartMs),
+    @"prewarmed": @(cxpPrewarmed),
+    @"finishedLaunchingMs": @(cxpFinishedLaunchingMs),
+    @"foregroundMs": @(cxpForegroundMs),
+    @"activityCreatedMs": @0,
+    @"nowMs": @(CXPNowMs()),
+    @"frameSource": @"display_link",
+  });
+}
+
+RCT_EXPORT_METHOD(startFrameMonitor)
+{
+  if (!cxpMonitor) cxpMonitor = [CXPFrameMonitor new];
+  [cxpMonitor start];
+}
+
+// Android's "Fully drawn" has no iOS equivalent; kept so JS calls one API on both.
+RCT_EXPORT_METHOD(reportFullyDrawn) {}
+
+RCT_EXPORT_METHOD(getFrameStats:(RCTPromiseResolveBlock)resolve
+                  reject:(__unused RCTPromiseRejectBlock)reject)
+{
+  resolve(@{
+    @"total": @(cxpMonitor ? cxpMonitor.total : 0),
+    @"slow": @(cxpMonitor ? cxpMonitor.slow : 0),
+    @"frozen": @(cxpMonitor ? cxpMonitor.frozen : 0),
+  });
+}
+
+@end

package/lib/core/vitals.d.ts

@@ -1,14 +1,19 @@
-export type VitalName = 'SCREEN_LOAD' | 'INP' | 'JS_STALL';
+export type VitalName = 'SCREEN_LOAD' | 'INP' | 'JS_STALL' | 'APP_START_COLD' | 'APP_START_WARM' | 'APP_START_HOT' | 'SLOW_FRAMES' | 'FROZEN_FRAMES';
 export interface VitalReport {
     name: VitalName;
     value: number;
     rating: 'good' | 'needs_improvement' | 'poor';
     screen: string;
     visitId: string;
-    navigationType: 'screen' | 'resume';
+    navigationType: 'screen' | 'resume' | 'cold' | 'warm' | 'hot';
     attribution: Record<string, unknown>;
 }
 type Emit = (report: VitalReport) => void;
+interface FrameStats {
+    total: number;
+    slow: number;
+    frozen: number;
+}
 export declare function rate(name: VitalName, value: number): VitalReport['rating'];
 interface Visit {
     id: string;
@@ -19,6 +24,7 @@ interface Visit {
     maxStall: number;
     stallAt: number;
     startedAt: number;
+    frames0: FrameStats | null;
 }
 export declare function startVitals(cb: Emit): void;
 export declare function stopVitals(): void;

package/lib/core/vitals.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"vitals.d.ts","sourceRoot":"","sources":["../../src/core/vitals.ts"],"names":[],"mappings":"AAoCA,MAAM,MAAM,SAAS,GAAG,aAAa,GAAG,KAAK,GAAG,UAAU,CAAC;AAE3D,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,MAAM,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,QAAQ,GAAG,QAAQ,CAAC;IACpC,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;AAS1C,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAG1E;AA2BD,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;CACnB;AA+DD,wBAAgB,WAAW,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,CAS1C;AAED,wBAAgB,UAAU,IAAI,IAAI,CAUjC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAiB7C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBtF;AAED,iBAAiB;AACjB,wBAAgB,MAAM,IAAI;IAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAE9E"}
+{"version":3,"file":"vitals.d.ts","sourceRoot":"","sources":["../../src/core/vitals.ts"],"names":[],"mappings":"AAoCA,MAAM,MAAM,SAAS,GACjB,aAAa,GAAG,KAAK,GAAG,UAAU,GAElC,gBAAgB,GAAG,gBAAgB,GAAG,eAAe,GAAG,aAAa,GAAG,eAAe,CAAC;AAE5F,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,SAAS,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,GAAG,mBAAmB,GAAG,MAAM,CAAC;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;IAC9D,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACtC;AAED,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,WAAW,KAAK,IAAI,CAAC;AAqB1C,UAAU,UAAU;IAAG,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE;AAwBpE,wBAAgB,IAAI,CAAC,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,WAAW,CAAC,QAAQ,CAAC,CAG1E;AA2BD,UAAU,KAAK;IACb,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,EAAE,WAAW,CAAC,gBAAgB,CAAC,CAAC;IAC9C,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IAC7C,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,GAAG,IAAI,CAAC;CAC5B;AAsHD,wBAAgB,WAAW,CAAC,EAAE,EAAE,IAAI,GAAG,IAAI,CA0B1C;AAED,wBAAgB,UAAU,IAAI,IAAI,CAWjC;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAsB7C;AAED;;;GAGG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAmBtF;AAED,iBAAiB;AACjB,wBAAgB,MAAM,IAAI;IAAE,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAE9E"}

package/lib/core/vitals.js

@@ -46,7 +46,32 @@ const THRESHOLDS = {
     SCREEN_LOAD: [2500, 4000], // web.dev LCP
     INP: [200, 500], // web.dev INP
     JS_STALL: [249, 500], // Apple: ≥ 250 ms is a (micro) hang, > 500 ms a hang
+    // Android vitals — pass/fail, so good and poor meet: excessive at ≥ 5 s / 2 s / 1.5 s.
+    APP_START_COLD: [4999, 4999],
+    APP_START_WARM: [1999, 1999],
+    APP_START_HOT: [1499, 1499],
+    // Share of frames × 100 (10000 = all of them). Android vitals: > 50 % slow, > 0.1 % frozen.
+    SLOW_FRAMES: [5000, 5000],
+    FROZEN_FRAMES: [10, 10],
 };
+// Platforms whose native vitals (app start, frames) have been measured against the platform's own
+// numbers. iOS is off until ios/CXPVitals.m is checked against a real launch and a screen recording
+// (it needs an Xcode 26 build); its JS vitals — screen load, INP, JS stall — are unaffected.
+const NATIVE_VITALS_ON = ['android'];
+function nativeVitals() {
+    try {
+        const m = react_native_1.TurboModuleRegistry?.get?.('CXPVitals')
+            ?? react_native_1.NativeModules?.CXPVitals;
+        return m || null;
+    }
+    catch {
+        return null;
+    }
+}
+// Frames in a visit below this are too few for a share to mean anything.
+const MIN_FRAMES = 30;
+// A launch longer than this is not a launch (a debugger pause, a JS reload in an old process).
+const MAX_START_MS = 120000;
 function rate(name, value) {
     const [good, poor] = THRESHOLDS[name];
     return value <= good ? 'good' : value <= poor ? 'needs_improvement' : 'poor';
@@ -80,6 +105,14 @@ let stallTimer = null;
 let lastTick = 0;
 let appStateSub = null;
 let seq = 0;
+let native = null;
+let frameSource = '';
+// Cold start: the launch's start (from native) and the first screen's first frame (from JS); reported
+// once both are known, in whichever order they arrive.
+let coldStartWall = 0;
+let firstFrameWall = 0;
+let coldReported = false;
+let backgroundAtWall = 0;
 const newId = () => 'sv_' + Date.now().toString(36) + '_' + (seq++).toString(36) + Math.random().toString(36).slice(2, 6);
 // Reports made before startVitals (the opening screen's load) wait here for the SDK.
 let held = [];
@@ -108,14 +141,27 @@ function endVisit() {
         longest_stall_at_ms: Math.round(v.stallAt - v.startedAt),
         visit_duration_ms: Math.round(now() - v.startedAt),
     });
+    const f0 = v.frames0;
+    if (native && f0) {
+        native.getFrameStats().then((f) => {
+            const total = f.total - f0.total;
+            if (total < MIN_FRAMES)
+                return;
+            const attr = { frames: total, slow: f.slow - f0.slow, frozen: f.frozen - f0.frozen, frame_source: frameSource };
+            report('SLOW_FRAMES', ((f.slow - f0.slow) / total) * 10000, v, attr);
+            report('FROZEN_FRAMES', ((f.frozen - f0.frozen) / total) * 10000, v, attr);
+        }, () => { });
+    }
 }
 function beginVisit(screen, navigationType) {
     visit = {
         id: newId(), screen, navigationType, worstInp: 0, worstInpAttr: null,
-        maxStall: 0, stallAt: 0, startedAt: now(),
+        maxStall: 0, stallAt: 0, startedAt: now(), frames0: null,
     };
     lastTick = now();
-    return visit;
+    const v = visit;
+    native?.getFrameStats().then((f) => { v.frames0 = f; }, () => { });
+    return v;
 }
 function tick() {
     const t = now();
@@ -132,11 +178,50 @@ function onAppState(state) {
         lastTick = now();
         if (!visit && currentScreen)
             beginVisit(currentScreen, 'resume');
+        if (backgroundAtWall && native)
+            reportReturn(backgroundAtWall);
+        backgroundAtWall = 0;
     }
     else if (state === 'background' || state === 'inactive') {
+        if (state === 'background')
+            backgroundAtWall = Date.now();
         endVisit();
     }
 }
+/**
+ * The app came back from the background: a WARM start when Android re-created its activity while
+ * the process lived on, a HOT start otherwise — from the native moment it started coming back to
+ * the first frame JS sees.
+ */
+function reportReturn(sinceWall) {
+    const v = visit;
+    afterNextFrame(() => {
+        const endWall = Date.now();
+        native?.getLaunchInfo().then((info) => {
+            if (!v)
+                return;
+            const warm = info.activityCreatedMs > sinceWall;
+            const start = warm ? info.activityCreatedMs : info.foregroundMs;
+            if (!(start >= sinceWall) || endWall - start <= 0 || endWall - start > MAX_START_MS)
+                return;
+            v.navigationType = warm ? 'warm' : 'hot';
+            report(warm ? 'APP_START_WARM' : 'APP_START_HOT', endWall - start, v, {
+                start_source: warm ? 'activity_created' : 'foreground', frame_source: info.frameSource,
+            });
+        }, () => { });
+    });
+}
+function maybeReportCold() {
+    if (coldReported || !coldStartWall || !firstFrameWall)
+        return;
+    coldReported = true;
+    const value = firstFrameWall - coldStartWall;
+    const v = visit;
+    if (!v || value <= 0 || value > MAX_START_MS)
+        return;
+    report('APP_START_COLD', value, { ...v, navigationType: 'cold' }, { start_source: coldStartSource });
+}
+let coldStartSource = '';
 let currentScreen = null;
 function startVitals(cb) {
     emit = cb;
@@ -150,6 +235,29 @@ function startVitals(cb) {
         return;
     lastTick = now();
     stallTimer = setInterval(tick, STALL_TICK_MS);
+    native = NATIVE_VITALS_ON.includes(react_native_1.Platform.OS) ? nativeVitals() : null;
+    if (native) {
+        try {
+            native.startFrameMonitor();
+        }
+        catch { /* frames unavailable */ }
+        if (visit && !visit.frames0) {
+            const v = visit;
+            native.getFrameStats().then((f) => { v.frames0 = f; }, () => { });
+        }
+        native.getLaunchInfo().then((info) => {
+            frameSource = info.frameSource;
+            if (!info.firstInProcess) {
+                coldReported = true;
+                return;
+            }
+            // A prewarmed iOS process started before anyone opened the app; the launch is from when it
+            // finished launching (Apple's advice).
+            coldStartWall = info.prewarmed && info.finishedLaunchingMs ? info.finishedLaunchingMs : info.processStartMs;
+            coldStartSource = info.prewarmed ? 'finished_launching' : 'process_start';
+            maybeReportCold();
+        }, () => { });
+    }
     try {
         appStateSub = react_native_1.AppState.addEventListener('change', onAppState);
     }
@@ -166,6 +274,7 @@ function stopVitals() {
     currentScreen = null;
     lastInput = null;
     held = [];
+    native = null;
 }
 /**
  * A screen became current: the previous visit ends, this one starts, and its load is timed.
@@ -185,6 +294,14 @@ function onScreen(screen) {
     const byInput = lastInput && t - lastInput.at < NAV_INPUT_WINDOW_MS ? lastInput : null;
     const start = byInput ? byInput.at : t;
     afterNextFrame(() => {
+        if (!firstFrameWall) {
+            firstFrameWall = Date.now();
+            try {
+                native?.reportFullyDrawn?.();
+            }
+            catch { /* not on this platform */ }
+            maybeReportCold();
+        }
         report('SCREEN_LOAD', now() - start, v, {
             trigger: byInput ? byInput.kind : 'route_change',
             target_selector: byInput?.target ?? '',

package/lib/core/vitals.js.map

@@ -1 +1 @@
-{"version":3,"file":"vitals.js","sourceRoot":"","sources":["../../src/core/vitals.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"vitals.js","sourceRoot":"","sources":["../../src/core/vitals.ts"],"names":[],"mappings":"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"}

package/lib/version.d.ts

@@ -5,5 +5,5 @@
  * missing screenshot or tap had to be diagnosed by asking the customer for their
  * package.json. test/sdkVersion.test.js fails when this and package.json differ.
  */
-export declare const SDK_VERSION = "0.20.0";
+export declare const SDK_VERSION = "0.21.0";
 //# sourceMappingURL=version.d.ts.map

package/lib/version.js

@@ -8,5 +8,5 @@ exports.SDK_VERSION = void 0;
  * missing screenshot or tap had to be diagnosed by asking the customer for their
  * package.json. test/sdkVersion.test.js fails when this and package.json differ.
  */
-exports.SDK_VERSION = '0.20.0';
+exports.SDK_VERSION = '0.21.0';
 //# sourceMappingURL=version.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cxpinsight/react-native",
-  "version": "0.20.0",
+  "version": "0.21.0",
   "description": "CXPinsight React Native SDK — engagement tracking, native survey modals & visual setup mode",
   "main": "lib/index.js",
   "types": "lib/index.d.ts",