@cxpinsight/react-native 0.19.1 → 0.21.0

package/CHANGELOG.md

@@ -1,5 +1,47 @@
 # 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.
+
+### Added
+- **Performance vitals on mobile, in the same shape as web.** Each screen visit reports
+  `SCREEN_LOAD` (the tap or route change that opened the screen → its first frame on the
+  display), `INP` (an input → the frame showing its result, the worst in the visit) and
+  `JS_STALL` (the longest time the JS thread was blocked), as `web_vitals` events with the
+  web SDK's fields, so the dashboard's Performance tab reads both platforms the same way.
+  Thresholds follow published standards: LCP's for screen load, web INP's, Apple's hangs.
+  Measured on iOS against a 60 fps screen recording: start exact, end within a frame.
+  No setup needed; screens come from the provider's navigation tracking.
+- **An ask can send the respondent to a link after submitting** (the survey's
+  `settings.completion.redirectUrl`, resolved by survey-spec's `submitRedirect`).
+
+### Fixed
+- **The offline copy of the trigger config works on Android again.** It was one
+  AsyncStorage value, which Android cannot read back over ~2 MB (passed at ~4,000+
+  interactions). It is now stored in pieces under 900 KB; a copy stored by an earlier SDK
+  is read once and replaced.
+- **App starts revalidate the trigger config** with its ETag and use the stored copy on
+  304, instead of downloading ~300 KB each time.
+
 ## 0.19.1
 
 Requires `@cxpinsight/survey-spec@^0.10.0` (unchanged).

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/CXPinsight.d.ts

@@ -100,13 +100,20 @@ declare class CXPinsightSDK {
     private verifyConnectivity;
     track(eventName: string, data?: Record<string, unknown>, eventType?: string, teeToRecording?: boolean, 
     /** Internal: preserves the original time of a call buffered before init(). */
-    eventTimestamp?: string): void;
+    eventTimestamp?: string, 
+    /** Internal: top-level performance values (vitals), as the web SDK sends them. */
+    performance?: Record<string, number>): void;
     /**
      * The screenshot capturer for a recording that is starting now: the host's
      * captureScreen, else the SDK's own (nativeScreenshot.ts), unless the
      * dashboard turned screenshots off.
      */
     private screenshotProvider;
+    /**
+     * One mobile vital, as a `web_vitals` event in the web SDK's shape, so the Performance tab reads
+     * both platforms the same way (docs/architecture/performance-vitals-web-and-mobile.md).
+     */
+    private trackVital;
     /** Track a screen view (triggers remote page_view rules) */
     trackScreen(screenName: string, data?: Record<string, unknown>): void;
     /** Identify the current user */

package/lib/CXPinsight.d.ts.map

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

package/lib/CXPinsight.js

@@ -52,6 +52,7 @@ const SetupController_1 = require("./setup/SetupController");
 const recorder = __importStar(require("./core/mobileRecorder"));
 const interactionObserver_1 = require("./instrumented/interactionObserver");
 const lifecycle_1 = require("./core/lifecycle");
+const vitals_1 = require("./core/vitals");
 const networkCapture_1 = require("./core/networkCapture");
 const scrollCapture_1 = require("./core/scrollCapture");
 const version_1 = require("./version");
@@ -877,6 +878,8 @@ class CXPinsightSDK {
         }
         // App lifecycle → navigation events (app_opened / foregrounded / backgrounded).
         // Also pause/resume the engagement clock so time-on-app excludes backgrounded time.
+        // Mobile vitals (core/vitals.ts): screen load, INP, JS stalls — reported in the web's shape.
+        (0, vitals_1.startVitals)((r) => this.trackVital(r));
         (0, lifecycle_1.startLifecycleTracking)((evt) => {
             if (evt.type === 'app_backgrounded') {
                 this.pauseEngagementClock();
@@ -982,7 +985,9 @@ class CXPinsightSDK {
     }
     track(eventName, data, eventType, teeToRecording = true, 
     /** Internal: preserves the original time of a call buffered before init(). */
-    eventTimestamp) {
+    eventTimestamp, 
+    /** Internal: top-level performance values (vitals), as the web SDK sends them. */
+    performance) {
         if (!this.initialized || !this.config) {
             // Held, not dropped. Drained by flushPending() once init() completes.
             if (this.pending.length < CXPinsightSDK.MAX_PENDING) {
@@ -1024,6 +1029,7 @@ class CXPinsightSDK {
             // Active foreground time this session (parity with web's engagementTimeMs).
             engagementTimeMs: this.getEngagementMs(),
             ...(userProperties ? { userProperties } : {}),
+            ...(performance ? { performance } : {}),
         };
         // Product analytics consent, finally enforced. CONSENT_CATEGORIES has always
         // offered `analytics` and the banner has always shown "Product analytics",
@@ -1085,6 +1091,23 @@ class CXPinsightSDK {
         this.screenshotSource = r.source;
         return r.provider;
     }
+    /**
+     * One mobile vital, as a `web_vitals` event in the web SDK's shape, so the Performance tab reads
+     * both platforms the same way (docs/architecture/performance-vitals-web-and-mobile.md).
+     */
+    trackVital(r) {
+        this.track('web_vitals', {
+            metric_name: r.name,
+            metric_value: r.value,
+            metric_rating: r.rating,
+            page_type: r.screen,
+            page: r.screen,
+            page_load_id: r.visitId,
+            navigation_type: r.navigationType,
+            vitals_source: 'cxpinsight-rn@' + version_1.SDK_VERSION,
+            attribution: r.attribution,
+        }, 'performance', false, undefined, { [r.name.toLowerCase()]: r.value });
+    }
     /** Track a screen view (triggers remote page_view rules) */
     trackScreen(screenName, data) {
         // IDEMPOTENT FOR THE SCREEN ALREADY SHOWING.
@@ -1105,6 +1128,7 @@ class CXPinsightSDK {
         this.currentScreen = screenName;
         if (recorder.isRecording())
             recorder.recordScreen(screenName, this.previousScreen);
+        (0, vitals_1.onScreen)(screenName); // ends the previous visit's vitals, times this screen's load
         // Cross-platform normalization: emit as `page_view` (web's canonical navigation
         // event name) so the eventSignature (eventType|page|elementKey) collapses web
         // and mobile navigations to the same key when they share a page identifier.
@@ -1443,6 +1467,7 @@ class CXPinsightSDK {
         (0, autoTapCapture_1.uninstallAutoTapCapture)();
         (0, session_1.setRolloverHandler)(null);
         (0, lifecycle_1.stopLifecycleTracking)();
+        (0, vitals_1.stopVitals)();
         (0, networkCapture_1.stopNetworkCapture)();
         this.engagementActive = false;
         this.engagementAccumMs = 0;