@cxpinsight/react-native 0.18.0 → 0.18.1

package/CHANGELOG.md

@@ -1,5 +1,33 @@
 # Changelog
 
+## 0.18.1
+
+Needs one native rebuild after upgrading: the package now ships native code.
+
+### Added
+
+- **Screenshots without host code.** The SDK carries its own native module
+  (`CXPScreenshot`, iOS and Android) and captures replay screenshots itself.
+  Before, screenshots existed only when the app passed `captureScreen`; an app
+  that did not recorded timelines with no pictures while the dashboard said
+  screenshots were on. Order: your `captureScreen` → the SDK's module →
+  `react-native-view-shot` if installed → none. Frames are JPEG, 720 px wide,
+  with text inputs masked while `recordMaskInputs` is on. Android windows with
+  `FLAG_SECURE` are skipped. The dashboard's Screenshots switch turns all of it off.
+- **`session_start` says which build and wiring produced it**: `sdk_version`,
+  `screenshot_source`, `provider_mounted`, `navigation_source`, `tap_capture`.
+
+### Fixed
+
+- **A session that starts by rollover knows its screen.** Coming back after the
+  inactivity timeout started a new session with no `page_view`, so every event
+  in it carried the previous session's screen and funnels never saw an entry.
+  The current screen is now re-announced (`session_resumed: true`) without
+  firing screen-view survey triggers. That `session_start` also carries
+  `is_first_visit` and the diagnostics above, like the one at launch.
+- **Connectivity probes are not api_call events.** NetInfo's reachability check
+  (`generate_204`) and captive-portal checks are dropped from network capture.
+
 ## 0.18.0
 
 Requires `@cxpinsight/survey-spec@^0.9.0` — it calls resolveBranding,

package/CXPinsightReactNative.podspec

@@ -0,0 +1,24 @@
+require 'json'
+
+package = JSON.parse(File.read(File.join(__dir__, 'package.json')))
+
+# The SDK's own native code: one module, CXPScreenshot, so replay screenshots
+# work from installing the package alone — no captureScreen callback and no
+# second native dependency in the host app.
+Pod::Spec.new do |s|
+  s.name         = 'CXPinsightReactNative'
+  s.version      = package['version']
+  s.summary      = package['description']
+  s.license      = package['license']
+  s.authors      = 'CXPinsight'
+  s.homepage     = package['homepage']
+  s.platforms    = { :ios => '13.4' }
+  s.source       = { :git => 'https://github.com/SaifDalli2/CX_Platform.git', :tag => "react-native-v#{s.version}" }
+  s.source_files = 'ios/**/*.{h,m,mm}'
+
+  if respond_to?(:install_modules_dependencies, true)
+    install_modules_dependencies(s)
+  else
+    s.dependency 'React-Core'
+  end
+end

package/README.md

@@ -34,7 +34,6 @@ Taps on everything else — `TouchableHighlight`, `Button`, and any touchable in
 
 ```js
 import { CXPinsight } from '@cxpinsight/react-native';
-import { captureScreen } from 'react-native-view-shot';
 
 CXPinsight.init({
   applicationId: 'YOUR_APPLICATION_ID',
@@ -42,12 +41,18 @@ CXPinsight.init({
   apiBase: 'https://your-gateway.example.com',
 
   record: true,             // session replay: screens, taps, scroll, inputs
-  recordMaskInputs: true,   // never store typed text
-  captureScreen: () =>      // optional screenshots in the replay timeline
-    captureScreen({ format: 'jpg', quality: 0.3, result: 'base64' }),
+  recordMaskInputs: true,   // never store typed text; also masks inputs in screenshots
 });
 ```
 
+Screenshots in the replay are taken by the SDK's own native module — no extra
+package and no capture code. It links automatically; rebuild the app once after
+installing (`npx expo prebuild` / `pod install`). Text inputs are covered in
+every frame while `recordMaskInputs` is on, and an Android screen with
+`FLAG_SECURE` is never captured. Turn screenshots off from the dashboard
+(Recording → Screenshots). To use your own capturer instead, pass
+`captureScreen: () => Promise<base64 jpeg>`; it always takes precedence.
+
 On a physical device `apiBase` must be reachable from the device — use your machine's LAN IP, not `localhost`. The SDK checks this at startup and logs a specific message if it looks wrong.
 
 ### 3. Report screen changes
@@ -215,7 +220,7 @@ as partial rather than absent.
 | `apiBase` | — | Your CXPinsight gateway URL. |
 | `record` | dashboard | Session replay. Omit to follow the dashboard toggle. |
 | `recordMaskInputs` | `true` | Never persist typed text. |
-| `captureScreen` | — | Screenshot provider; omit for a timeline-only replay. |
+| `captureScreen` | built in | Your own screenshot provider. Omit it: the SDK captures screenshots itself. |
 | `captureNetwork` | `true` | Sanitised `api_call` events — method, host, path, status. Never bodies or headers. |
 | `requireConsent` | `false` | Hold all capture until `optIn()`. |
 | `autoCaptureTaps` | `true` | Capture taps on touch components the babel plugin cannot reach, including inside UI libraries. |

package/android/build.gradle

@@ -0,0 +1,33 @@
+// The SDK's own native code: one module, CXPScreenshot (see
+// src/main/java/com/cxpinsight/reactnative/CXPScreenshotModule.java).
+
+def safeExtGet(prop, fallback) {
+  rootProject.ext.has(prop) ? rootProject.ext.get(prop) : fallback
+}
+
+apply plugin: 'com.android.library'
+
+android {
+  namespace "com.cxpinsight.reactnative"
+  compileSdkVersion safeExtGet('compileSdkVersion', 35)
+
+  defaultConfig {
+    minSdkVersion safeExtGet('minSdkVersion', 24)
+    targetSdkVersion safeExtGet('targetSdkVersion', 35)
+  }
+
+  compileOptions {
+    sourceCompatibility JavaVersion.VERSION_17
+    targetCompatibility JavaVersion.VERSION_17
+  }
+}
+
+repositories {
+  google()
+  mavenCentral()
+}
+
+dependencies {
+  // Resolved to the app's React Native version by the React Native Gradle plugin.
+  implementation "com.facebook.react:react-android"
+}

package/android/src/main/AndroidManifest.xml

@@ -0,0 +1 @@
+<manifest xmlns:android="http://schemas.android.com/apk/res/android" />

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

@@ -0,0 +1,134 @@
+package com.cxpinsight.reactnative;
+
+import android.app.Activity;
+import android.graphics.Bitmap;
+import android.graphics.Canvas;
+import android.graphics.Paint;
+import android.util.Base64;
+import android.view.View;
+import android.view.ViewGroup;
+import android.view.WindowManager;
+import android.widget.EditText;
+
+import androidx.annotation.NonNull;
+
+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 java.io.ByteArrayOutputStream;
+import java.util.concurrent.ExecutorService;
+import java.util.concurrent.Executors;
+
+/**
+ * Replay screenshots taken by the SDK itself — the Android half of
+ * ios/CXPScreenshot.m. capture(quality, maxWidth, maskInputs) resolves a base64
+ * JPEG of the current activity's window, or null. Null means "no frame this
+ * time", never an error: a recording must not fail over a frame.
+ */
+public class CXPScreenshotModule extends ReactContextBaseJavaModule {
+  static final String NAME = "CXPScreenshot";
+
+  private final ExecutorService encoder = Executors.newSingleThreadExecutor();
+
+  CXPScreenshotModule(ReactApplicationContext context) {
+    super(context);
+  }
+
+  @NonNull
+  @Override
+  public String getName() {
+    return NAME;
+  }
+
+  @ReactMethod
+  public void capture(final double quality, final double maxWidth, final boolean maskInputs, final Promise promise) {
+    final Activity activity = getReactApplicationContext().getCurrentActivity();
+    if (activity == null) {
+      promise.resolve(null);
+      return;
+    }
+    // FLAG_SECURE is the app saying "never capture this screen". The OS already
+    // blanks it from screenshots and recents; the SDK does the same.
+    if ((activity.getWindow().getAttributes().flags & WindowManager.LayoutParams.FLAG_SECURE) != 0) {
+      promise.resolve(null);
+      return;
+    }
+    activity.runOnUiThread(new Runnable() {
+      @Override
+      public void run() {
+        final Bitmap bitmap;
+        try {
+          bitmap = draw(activity.getWindow().getDecorView().getRootView(), maxWidth, maskInputs);
+        } catch (Throwable t) {
+          promise.resolve(null);
+          return;
+        }
+        if (bitmap == null) {
+          promise.resolve(null);
+          return;
+        }
+        encoder.execute(new Runnable() {
+          @Override
+          public void run() {
+            try {
+              ByteArrayOutputStream out = new ByteArrayOutputStream();
+              int q = (int) Math.round((quality > 0 && quality <= 1 ? quality : 0.5) * 100);
+              bitmap.compress(Bitmap.CompressFormat.JPEG, q, out);
+              promise.resolve(Base64.encodeToString(out.toByteArray(), Base64.NO_WRAP));
+            } catch (Throwable t) {
+              promise.resolve(null);
+            } finally {
+              bitmap.recycle();
+            }
+          }
+        });
+      }
+    });
+  }
+
+  // Draws straight at the output width rather than full resolution and scaling
+  // after: fewer pixels, drawn once.
+  private static Bitmap draw(View root, double maxWidth, boolean maskInputs) {
+    int w = root.getWidth();
+    int h = root.getHeight();
+    if (w <= 0 || h <= 0) return null;
+    float scale = maxWidth > 0 ? Math.min(1f, (float) (maxWidth / w)) : 1f;
+    int ow = Math.max(1, Math.round(w * scale));
+    int oh = Math.max(1, Math.round(h * scale));
+
+    Bitmap bitmap = Bitmap.createBitmap(ow, oh, Bitmap.Config.ARGB_8888);
+    Canvas canvas = new Canvas(bitmap);
+    canvas.scale(scale, scale);
+    root.draw(canvas);
+
+    // Text inputs are covered, not photographed: what someone types is theirs.
+    if (maskInputs) {
+      Paint paint = new Paint();
+      paint.setColor(0xFF8C8C8C);
+      int[] rootAt = new int[2];
+      root.getLocationInWindow(rootAt);
+      maskInputs(root, canvas, paint, rootAt);
+    }
+    return bitmap;
+  }
+
+  private static void maskInputs(View view, Canvas canvas, Paint paint, int[] rootAt) {
+    if (view.getVisibility() != View.VISIBLE) return;
+    if (view instanceof EditText) {
+      int[] at = new int[2];
+      view.getLocationInWindow(at);
+      float x = at[0] - rootAt[0];
+      float y = at[1] - rootAt[1];
+      canvas.drawRect(x, y, x + view.getWidth(), y + view.getHeight(), paint);
+      return;
+    }
+    if (view instanceof ViewGroup) {
+      ViewGroup group = (ViewGroup) view;
+      for (int i = 0; i < group.getChildCount(); i++) {
+        maskInputs(group.getChildAt(i), canvas, paint, rootAt);
+      }
+    }
+  }
+}

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

@@ -0,0 +1,25 @@
+package com.cxpinsight.reactnative;
+
+import androidx.annotation.NonNull;
+
+import com.facebook.react.ReactPackage;
+import com.facebook.react.bridge.NativeModule;
+import com.facebook.react.bridge.ReactApplicationContext;
+import com.facebook.react.uimanager.ViewManager;
+
+import java.util.Collections;
+import java.util.List;
+
+public class CXPinsightPackage implements ReactPackage {
+  @NonNull
+  @Override
+  public List<NativeModule> createNativeModules(@NonNull ReactApplicationContext reactContext) {
+    return Collections.<NativeModule>singletonList(new CXPScreenshotModule(reactContext));
+  }
+
+  @NonNull
+  @Override
+  public List<ViewManager> createViewManagers(@NonNull ReactApplicationContext reactContext) {
+    return Collections.emptyList();
+  }
+}

package/ios/CXPScreenshot.m

@@ -0,0 +1,99 @@
+// Replay screenshots taken by the SDK itself.
+//
+// Screenshots used to exist only when the host app passed a captureScreen
+// callback backed by a second native package. An app that followed the setup
+// guide without it — or with it installed but not wired — recorded timelines
+// with no pictures, while the dashboard said screenshots were on.
+//
+// So the SDK carries its own. One method, capture(quality, maxWidth,
+// maskInputs), resolving a base64 JPEG of the key window or null. Null means
+// "no frame this time", never an error: a recording must not fail over a frame.
+
+#import <React/RCTBridgeModule.h>
+#import <UIKit/UIKit.h>
+
+@interface CXPScreenshot : NSObject <RCTBridgeModule>
+@end
+
+@implementation CXPScreenshot
+
+RCT_EXPORT_MODULE(CXPScreenshot)
+
++ (BOOL)requiresMainQueueSetup { return NO; }
+
+// UIKit drawing belongs on the main queue. Encoding does not, and is moved off it below.
+- (dispatch_queue_t)methodQueue { return dispatch_get_main_queue(); }
+
+static UIWindow *CXPKeyWindow(void)
+{
+  for (UIScene *scene in [UIApplication sharedApplication].connectedScenes) {
+    if (scene.activationState != UISceneActivationStateForegroundActive) continue;
+    if (![scene isKindOfClass:[UIWindowScene class]]) continue;
+    for (UIWindow *w in ((UIWindowScene *)scene).windows) {
+      if (w.isKeyWindow) return w;
+    }
+  }
+  return nil;
+}
+
+// Text inputs are covered, not photographed: what someone types is theirs, and
+// a masked recording is the SDK's default everywhere else.
+static void CXPCollectInputs(UIView *view, UIWindow *window, NSMutableArray<NSValue *> *out)
+{
+  if (view.hidden || view.alpha < 0.01) return;
+  BOOL isInput = [view isKindOfClass:[UITextField class]] ||
+    ([view isKindOfClass:[UITextView class]] && ((UITextView *)view).isEditable);
+  if (isInput) {
+    [out addObject:[NSValue valueWithCGRect:[view convertRect:view.bounds toView:window]]];
+    return;
+  }
+  for (UIView *child in view.subviews) CXPCollectInputs(child, window, out);
+}
+
+RCT_EXPORT_METHOD(capture:(double)quality
+                  maxWidth:(double)maxWidth
+                  maskInputs:(BOOL)maskInputs
+                  resolve:(RCTPromiseResolveBlock)resolve
+                  reject:(__unused RCTPromiseRejectBlock)reject)
+{
+  // Backgrounded: iOS shows a snapshot, not the app, and drawing now is wasted.
+  if ([UIApplication sharedApplication].applicationState != UIApplicationStateActive) {
+    resolve([NSNull null]);
+    return;
+  }
+  UIWindow *window = CXPKeyWindow();
+  CGSize size = window.bounds.size;
+  if (!window || size.width < 1 || size.height < 1) {
+    resolve([NSNull null]);
+    return;
+  }
+
+  // Render straight at the output width rather than at the screen's 3x and
+  // scaling down after: a third of the pixels, drawn once.
+  CGFloat scale = window.screen.scale;
+  if (maxWidth > 0) scale = MIN(scale, maxWidth / size.width);
+  UIGraphicsImageRendererFormat *format = [UIGraphicsImageRendererFormat preferredFormat];
+  format.scale = scale;
+  format.opaque = YES;
+
+  NSMutableArray<NSValue *> *masks = [NSMutableArray new];
+  if (maskInputs) CXPCollectInputs(window, window, masks);
+
+  UIGraphicsImageRenderer *renderer = [[UIGraphicsImageRenderer alloc] initWithSize:size format:format];
+  UIImage *image = [renderer imageWithActions:^(UIGraphicsImageRendererContext *ctx) {
+    [window drawViewHierarchyInRect:window.bounds afterScreenUpdates:NO];
+    if (masks.count) {
+      [[UIColor colorWithWhite:0.55 alpha:1] setFill];
+      for (NSValue *r in masks) UIRectFill(r.CGRectValue);
+    }
+  }];
+
+  double q = quality > 0 && quality <= 1 ? quality : 0.5;
+  dispatch_async(dispatch_get_global_queue(QOS_CLASS_UTILITY, 0), ^{
+    NSData *jpeg = UIImageJPEGRepresentation(image, q);
+    if (!jpeg) { resolve([NSNull null]); return; }
+    resolve([jpeg base64EncodedStringWithOptions:0]);
+  });
+}
+
+@end

package/lib/CXPinsight.d.ts

@@ -16,6 +16,9 @@ declare class CXPinsightSDK {
     /** The field currently focused, so blur can report dwell + changed. */
     private fieldVisit;
     private currentScreen;
+    private screenshotsOff;
+    private screenshotSource;
+    private integration;
     private previousScreen;
     private engagementStartTs;
     private engagementAccumMs;
@@ -62,6 +65,13 @@ declare class CXPinsightSDK {
     private applyServerSdkConfig;
     /** Roll the recording + engagement clock onto a freshly-started session. */
     private onSessionRollover;
+    /** Which build, and how it is wired — so a gap in a session can be read, not guessed. */
+    private sessionDiagnostics;
+    /** @internal Called by CXPinsightProvider so session_start can report how screens are tracked. */
+    _noteIntegration(i: Partial<{
+        provider: boolean;
+        navigation: 'ref' | 'screen_prop' | 'none';
+    }>): void;
     /** Emit everything buffered before init() resolved, oldest first. */
     private flushPending;
     /** Wire native signals → typed analytics events (shared taxonomy). */
@@ -76,6 +86,12 @@ declare class CXPinsightSDK {
     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;
+    /**
+     * 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;
     /** 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

@@ -53,6 +53,8 @@ const interactionObserver_1 = require("./instrumented/interactionObserver");
 const lifecycle_1 = require("./core/lifecycle");
 const networkCapture_1 = require("./core/networkCapture");
 const scrollCapture_1 = require("./core/scrollCapture");
+const version_1 = require("./version");
+const nativeScreenshot_1 = require("./core/nativeScreenshot");
 const autoTapCapture_1 = require("./core/autoTapCapture");
 const consent_1 = require("./core/consent");
 // Canonical eventType per event name — keeps mobile events aligned with the shared
@@ -90,6 +92,12 @@ class CXPinsightSDK {
         this.fieldVisit = null;
         // Current + previous screen, so click/scroll/screen_view events carry screenName.
         this.currentScreen = null;
+        // Set by the dashboard's recording.screenshots === false; read by screenshotProvider().
+        this.screenshotsOff = false;
+        // Where replay screenshots come from this run — reported on session_start.
+        this.screenshotSource = 'none';
+        // How the host wired the SDK, as far as the SDK can see — reported on session_start.
+        this.integration = { provider: false, navigation: 'none' };
         this.previousScreen = null;
         // Engagement clock — active foreground time this session (paused while backgrounded),
         // attached to every event as engagementTimeMs (parity with web's time-on-page).
@@ -130,9 +138,10 @@ class CXPinsightSDK {
         if (!config.applicationId) {
             throw new Error('[CXPinsight] init requires config.applicationId');
         }
-        // Screenshots are deliberately NOT forced on: they need the host's own
-        // captureScreen callback (react-native-view-shot), which a flag cannot
-        // synthesise. If it was passed, recording uses it either way.
+        this.screenshotsOff = false;
+        // Screenshots need no flag: the SDK takes them itself (nativeScreenshot.ts)
+        // unless the host passed its own captureScreen or the dashboard turned
+        // them off.
         //
         // captureEverything says WHAT to capture within a session. It deliberately
         // does not touch recording.sampleRate, which says HOW MANY sessions to
@@ -273,7 +282,7 @@ class CXPinsightSDK {
                 applicationId: config.applicationId,
                 sampleRate: config.recordingSampleRate,
                 maskInputs: config.recordMaskInputs,
-                captureScreen: config.captureScreen,
+                captureScreen: this.screenshotProvider(),
                 // The screen the user is ON when this recording begins. Without it a
                 // recording that starts mid-session opens with screen null and stays
                 // nameless until the next navigation — which may never come.
@@ -333,6 +342,7 @@ class CXPinsightSDK {
             this.track('session_start', {
                 sessionId: (0, session_1.getSessionId)(),
                 is_first_visit: isFirstVisit,
+                ...this.sessionDiagnostics(),
             }, 'navigation', false);
         }
         // Replay anything the app tracked while init() was still resolving. After
@@ -495,8 +505,12 @@ class CXPinsightSDK {
             // controlled nothing, because screenshots depended solely on whether the
             // app passed a captureScreen callback. Turning it off now actually stops
             // them, without the app having to ship a new build.
+            //
+            // Off also has to stop the SDK's OWN capture (nativeScreenshot.ts), which
+            // needs no callback — clearing captureScreen alone would leave it running.
             if (s.recording?.screenshots === false) {
                 config.captureScreen = undefined;
+                this.screenshotsOff = true;
             }
             // Bodies ride WITH network capture rather than needing a second switch: an
             // api_call that says a request happened but not what it carried answers
@@ -536,7 +550,7 @@ class CXPinsightSDK {
                     applicationId: this.config.applicationId,
                     sampleRate: this.config.recordingSampleRate,
                     maskInputs: this.config.recordMaskInputs,
-                    captureScreen: this.config.captureScreen,
+                    captureScreen: this.screenshotProvider(),
                     screen: this.currentScreen,
                 });
             }
@@ -545,7 +559,44 @@ class CXPinsightSDK {
             }
         }
         this.startEngagementClock(); // reset engagement time for the new session
-        this.track('session_start', { sessionId: newSessionId }, 'navigation', false);
+        this.track('session_start', {
+            sessionId: newSessionId,
+            is_first_visit: false,
+            ...this.sessionDiagnostics(),
+        }, 'navigation', false);
+        // THE SCREEN THE USER IS STILL ON BELONGS TO THIS SESSION TOO.
+        //
+        // A rollover happens when the app comes back after the inactivity timeout,
+        // usually on the screen it was left on. trackScreen() is idempotent for the
+        // current screen, so nothing re-announced it: the new session had no
+        // page_view at all, every later event inherited a screen name from the
+        // previous session, and funnels starting there never saw an entry. Seen in
+        // production as sessions with pageViews 0 and every event on one screen.
+        //
+        // Only the event, not the screen-view trigger hook: re-entering a screen by waiting is
+        // not a navigation, and a screen-view survey trigger must not fire on it.
+        this.previousScreen = null;
+        if (this.currentScreen) {
+            this.track('page_view', {
+                page: this.currentScreen,
+                screen_name: this.currentScreen,
+                session_resumed: true,
+            }, 'page_view', false);
+        }
+    }
+    /** Which build, and how it is wired — so a gap in a session can be read, not guessed. */
+    sessionDiagnostics() {
+        return {
+            sdk_version: version_1.SDK_VERSION,
+            screenshot_source: this.screenshotSource,
+            provider_mounted: this.integration.provider,
+            navigation_source: this.integration.navigation,
+            tap_capture: (0, autoTapCapture_1.isAutoTapCaptureActive)(),
+        };
+    }
+    /** @internal Called by CXPinsightProvider so session_start can report how screens are tracked. */
+    _noteIntegration(i) {
+        Object.assign(this.integration, i);
     }
     /** Emit everything buffered before init() resolved, oldest first. */
     flushPending() {
@@ -888,6 +939,20 @@ class CXPinsightSDK {
         };
         (0, triggerEngine_1.onEventTracked)(eventName, targetingContext);
     }
+    /**
+     * 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.
+     */
+    screenshotProvider() {
+        if (!this.config || this.screenshotsOff) {
+            this.screenshotSource = 'none';
+            return undefined;
+        }
+        const r = (0, nativeScreenshot_1.resolveScreenshotProvider)(this.config.captureScreen, { maskInputs: this.config.recordMaskInputs });
+        this.screenshotSource = r.source;
+        return r.provider;
+    }
     /** Track a screen view (triggers remote page_view rules) */
     trackScreen(screenName, data) {
         // IDEMPOTENT FOR THE SCREEN ALREADY SHOWING.
@@ -1152,7 +1217,7 @@ class CXPinsightSDK {
             applicationId: this.config.applicationId,
             sampleRate: this.config.recordingSampleRate,
             maskInputs: this.config.recordMaskInputs,
-            captureScreen: this.config.captureScreen,
+            captureScreen: this.screenshotProvider(),
             // The screen the user is ON when this recording begins. Without it a
             // recording that starts mid-session opens with screen null and stays
             // nameless until the next navigation — which may never come.
@@ -1216,7 +1281,7 @@ class CXPinsightSDK {
                     applicationId: this.config.applicationId,
                     sampleRate: this.config.recordingSampleRate,
                     maskInputs: this.config.recordMaskInputs,
-                    captureScreen: this.config.captureScreen,
+                    captureScreen: this.screenshotProvider(),
                     // The screen the user is ON when this recording begins. Without it a
                     // recording that starts mid-session opens with screen null and stays
                     // nameless until the next navigation — which may never come.