@scalebun/react-native 2.0.0 → 2.0.1

package/lib/commonjs/features/ota/OtaOrchestrator.js

@@ -119,12 +119,12 @@ async function deliverOtaEvents(params) {
       })
     });
     if (!res.ok) throw new Error(`HTTP ${res.status}`);
-    __DEV__ && _internalLogger.logger.debug(`[OTA] Delivered ${items.length} telemetry event(s)`);
+    _internalLogger.logger.debug(`[OTA] Delivered ${items.length} telemetry event(s)`);
   } catch (err) {
     // Failed delivery must not fail the update — but the events must not be
     // lost either: requeue so the next sync retries them.
     for (const e of events) _OtaEventEmitter.otaEventEmitter.emit(e);
-    __DEV__ && _internalLogger.logger.debug(`[OTA] Telemetry delivery failed (will retry next sync): ${err?.message}`);
+    _internalLogger.logger.debug(`[OTA] Telemetry delivery failed (will retry next sync): ${err?.message}`);
   }
 }
 
@@ -144,6 +144,8 @@ class OtaOrchestrator {
     return this.currentBundle;
   }
   isRestartRequiredState = false;
+  /** Root/jailbreak indicators observed at init; empty when none found. */
+  integrityIndicators = [];
   healthyTimer = null;
   bootGuardConfig = {};
   environment = null;
@@ -199,12 +201,30 @@ class OtaOrchestrator {
         // We cannot see which form the host used — the identity check after
         // restart is what proves it — but naming the right fix up front turns
         // a confusing silent failure into a one-line correction.
-        __DEV__ && _internalLogger.logger.debug('[OTA] React Native >= 0.82 detected. The only valid Android integration is ' + 'getDefaultReactHost(..., jsBundleFilePath = ScaleBunOtaModule.getJSBundleFile(ctx)) — ' + 'ReactNativeHost and its getJSBundleFile() override no longer exist.');
+        _internalLogger.logger.debug('[OTA] React Native >= 0.82 detected. The only valid Android integration is ' + 'getDefaultReactHost(..., jsBundleFilePath = ScaleBunOtaModule.getJSBundleFile(ctx)) — ' + 'ReactNativeHost and its getJSBundleFile() override no longer exist.');
       }
       this.initialized = true;
       this.enabled = true;
+
+      // Device integrity signal.
+      //
+      // Reported, not enforced. Root defeats any check made from inside the app,
+      // so this is not a boundary — it is context. It tells an operator that a
+      // device's OTA slot is writable by other processes, which is what makes the
+      // launch-time hash re-check in SlotManager meaningful rather than paranoid.
+      // A host app that wants to withhold updates on such devices can read
+      // `deviceIntegrityIndicators()` and decide for itself.
+      try {
+        const raw = _NativeScaleBunOta.default?.getDeviceIntegrity?.();
+        this.integrityIndicators = raw ? JSON.parse(raw) : [];
+        if (this.integrityIndicators.length > 0) {
+          _internalLogger.logger.warn(`[OTA] Device integrity indicators present: ${this.integrityIndicators.join(', ')}. ` + 'Updates still install and are still signature-verified, but an installed ' + 'bundle on this device can be modified by other privileged processes.');
+        }
+      } catch {
+        this.integrityIndicators = [];
+      }
       this.bootGuardConfig = config ?? {};
-      __DEV__ && _internalLogger.logger.debug(`[OTA] Orchestrator initialized (RN ${this.environment.rnVersionString ?? 'unknown'}` + `${this.environment.bridgeless ? ', bridgeless' : ''}` + `${this.environment.hermes ? `, Hermes HBC v${this.environment.hermesBytecodeVersion ?? '?'}` : ''})`);
+      _internalLogger.logger.debug(`[OTA] Orchestrator initialized (RN ${this.environment.rnVersionString ?? 'unknown'}` + `${this.environment.bridgeless ? ', bridgeless' : ''}` + `${this.environment.hermes ? `, Hermes HBC v${this.environment.hermesBytecodeVersion ?? '?'}` : ''})`);
 
       // ONE read of the slot state, shared by both boot-time consumers.
       //
@@ -235,6 +255,22 @@ class OtaOrchestrator {
 
       // Prove the bundle we installed is the bundle that loaded.
       this.verifyRunningBundleIdentity();
+
+      // Boot-guard health is a LOCAL fact: this process booted from the staged
+      // bundle and did not crash. The heartbeat used to start only on the
+      // `action === 'NONE'` branch of sync(), so confirming a good bundle needed
+      // a successful network round-trip that returned exactly that answer — a
+      // device offline, rate-limited, or still being offered an update could
+      // never clear its marker, and the guard reverted a bundle that was working.
+      //
+      // It runs HERE, last, and is handed the slot state that was already read.
+      // Starting it earlier made it call getSlotState() itself, and that read is
+      // consume-on-read for the revert record — it swallowed the revert before
+      // checkBootGuardRecovery() could name the bundle that failed, so a
+      // crash-rollback went unreported. It also read bootGuardConfig before
+      // init() had assigned it, so healthyAfterMs silently fell back to the
+      // default.
+      this.startBootGuardHeartbeat(slotState);
     });
   }
 
@@ -273,7 +309,7 @@ class OtaOrchestrator {
           releaseId: record.releaseId ?? undefined,
           sha256: record.sha256
         };
-        __DEV__ && _internalLogger.logger.debug(`[OTA] Running bundle v${record.version} (${record.bundleId})`);
+        _internalLogger.logger.debug(`[OTA] Running bundle v${record.version} (${record.bundleId})`);
         return;
       }
 
@@ -283,7 +319,7 @@ class OtaOrchestrator {
       this.currentBundle = {
         sha256: current.sha256
       };
-      __DEV__ && _internalLogger.logger.debug(`[OTA] Running an OTA bundle (sha ${String(current.sha256).slice(0, 12)}…) with no local install record.`);
+      _internalLogger.logger.debug(`[OTA] Running an OTA bundle (sha ${String(current.sha256).slice(0, 12)}…) with no local install record.`);
     } catch {
       // Slot state unreadable — treat as factory bundle.
     }
@@ -331,7 +367,7 @@ class OtaOrchestrator {
     // this bundle" and answers by serving the same bundle again, forever.
     if (!record.identityToken) return;
     if (running === record.identityToken) {
-      __DEV__ && _internalLogger.logger.debug('[OTA] Install verified — running bundle matches what was installed.');
+      _internalLogger.logger.debug('[OTA] Install verified — running bundle matches what was installed.');
       this.retireIdentityToken(record);
       return;
     }
@@ -464,6 +500,14 @@ class OtaOrchestrator {
   isEnabled() {
     return this.enabled;
   }
+
+  /**
+   * Root/jailbreak indicators detected on this device, as stable reason strings.
+   * Empty means nothing was detected — not proof the device is clean.
+   */
+  deviceIntegrityIndicators() {
+    return [...this.integrityIndicators];
+  }
   isRestartRequired() {
     return this.isRestartRequiredState;
   }
@@ -571,7 +615,7 @@ class OtaOrchestrator {
           error: 'OTA native module disabled or missing'
         };
       }
-      __DEV__ && _internalLogger.logger.debug('[OTA] Sync started…');
+      _internalLogger.logger.debug('[OTA] Sync started…');
 
       // The funnel's denominator, for devices already on an OTA bundle. Emitted
       // before the request, so a check that fails outright still counts as a
@@ -590,7 +634,7 @@ class OtaOrchestrator {
       }
       const checkRes = await this.checkForUpdate(params);
       if (checkRes.action === 'NONE') {
-        __DEV__ && _internalLogger.logger.debug('[OTA] App is up to date');
+        _internalLogger.logger.debug('[OTA] App is up to date');
         // If we booted from an OTA bundle and it's healthy, clear the boot guard
         this.startBootGuardHeartbeat();
         return {
@@ -648,7 +692,7 @@ class OtaOrchestrator {
         version: bundle.version
       });
       const downloadStart = Date.now();
-      __DEV__ && _internalLogger.logger.debug(`[OTA] Downloading update v${bundle.version}…`);
+      _internalLogger.logger.debug(`[OTA] Downloading update v${bundle.version}…`);
 
       // Live progress: native tick → DOWNLOAD_PROGRESS (feeds useOtaUpdate) →
       // throttled POST to the live tracker. `bundle.size` is the authoritative
@@ -746,13 +790,13 @@ class OtaOrchestrator {
 
         // Sprint 7: Try patch first if offered, fall back to full bundle
         if (bundle.patch && _NativeScaleBunOta.default.stagePatch) {
-          __DEV__ && _internalLogger.logger.debug(`[OTA] Patch available (${(bundle.patch.size / 1024).toFixed(0)} KB vs ` + `${(bundle.size / 1024).toFixed(0)} KB full) — trying patch…`);
+          _internalLogger.logger.debug(`[OTA] Patch available (${(bundle.patch.size / 1024).toFixed(0)} KB vs ` + `${(bundle.size / 1024).toFixed(0)} KB full) — trying patch…`);
           try {
             staged = await _NativeScaleBunOta.default.stagePatch(bundle.patch.url, bundle.patch.sha256, bundle.sha256 // expected full-bundle hash after patching
             );
             if (staged) {
               patchUsed = true;
-              __DEV__ && _internalLogger.logger.debug('[OTA] Patch applied successfully');
+              _internalLogger.logger.debug('[OTA] Patch applied successfully');
             } else {
               _internalLogger.logger.warn('[OTA] Patch staging returned false — falling back to full bundle');
             }
@@ -843,7 +887,7 @@ class OtaOrchestrator {
         releaseId: bundle.releaseId,
         version: bundle.version
       });
-      __DEV__ && _internalLogger.logger.debug(`[OTA] Update v${bundle.version} installed successfully!`);
+      _internalLogger.logger.debug(`[OTA] Update v${bundle.version} installed successfully!`);
 
       // Deliver telemetry BEFORE a restart tears the JS runtime down —
       // an INSTALLED event queued but not sent would vanish with the process.
@@ -889,7 +933,7 @@ class OtaOrchestrator {
    * native boot-guard marker. If JS crashes before the timer fires, the
    * marker stays set and native code reverts on next cold start.
    */
-  startBootGuardHeartbeat() {
+  startBootGuardHeartbeat(preRead) {
     if (!_NativeScaleBunOta.default) return;
 
     // Cancel any existing timer
@@ -898,20 +942,23 @@ class OtaOrchestrator {
       this.healthyTimer = null;
     }
     try {
-      const stateJson = _NativeScaleBunOta.default.getSlotState();
-      const state = JSON.parse(stateJson);
+      // getSlotState() is CONSUME-ON-READ for the revert record, so a caller that
+      // has already read it passes the parsed result down rather than letting
+      // this read again and swallow a rollback. `null` is a real answer (module
+      // absent or payload unreadable) — only `undefined` means "nobody read it".
+      const state = preRead !== undefined ? preRead : JSON.parse(_NativeScaleBunOta.default.getSlotState());
 
       // Only run the heartbeat if boot-guard marker is present
       // (meaning we're running from a freshly-applied OTA bundle)
-      if (!state.bootMarkerPresent) {
+      if (!state?.bootMarkerPresent) {
         return;
       }
       const healthyMs = this.bootGuardConfig.healthyAfterMs ?? DEFAULT_HEALTHY_AFTER_MS;
-      __DEV__ && _internalLogger.logger.debug(`[OTA] Boot guard active — marking healthy after ${healthyMs}ms`);
+      _internalLogger.logger.debug(`[OTA] Boot guard active — marking healthy after ${healthyMs}ms`);
       this.healthyTimer = setTimeout(() => {
         (0, _crashSafe.noThrow)(() => {
           _NativeScaleBunOta.default?.markHealthy();
-          __DEV__ && _internalLogger.logger.info('[OTA] Boot guard cleared — bundle marked healthy ✓');
+          _internalLogger.logger.info('[OTA] Boot guard cleared — bundle marked healthy ✓');
           this.healthyTimer = null;
 
           // The honest activation signal. INSTALLED is emitted optimistically,
@@ -966,11 +1013,11 @@ class OtaOrchestrator {
             /* the restart below makes cleanup moot */
           }
           this.resumeRestartArmed = false;
-          __DEV__ && _internalLogger.logger.info('[OTA] App resumed — activating the staged update now');
+          _internalLogger.logger.info('[OTA] App resumed — activating the staged update now');
           this.restart();
         }
       });
-      __DEV__ && _internalLogger.logger.debug('[OTA] Update staged — will activate on next resume (ON_NEXT_RESUME)');
+      _internalLogger.logger.debug('[OTA] Update staged — will activate on next resume (ON_NEXT_RESUME)');
     } catch {
       // AppState unavailable (tests, exotic hosts): the update still activates
       // on the next cold start, which is the documented fallback behaviour.
@@ -990,7 +1037,7 @@ class OtaOrchestrator {
    */
   restart() {
     (0, _crashSafe.noThrow)(() => {
-      __DEV__ && _internalLogger.logger.info('[OTA] Triggering app restart…');
+      _internalLogger.logger.info('[OTA] Triggering app restart…');
       if (_NativeScaleBunOta.default && typeof _NativeScaleBunOta.default.restartApp === 'function') {
         _NativeScaleBunOta.default.restartApp();
       } else if (_reactNative.DevSettings && typeof _reactNative.DevSettings.reload === 'function') {

package/lib/commonjs/features/session/SessionManager.js

@@ -959,6 +959,69 @@ class SessionManager {
       state_status: stateStatus,
       ui: details?.ui,
       target_id: details?.targetId,
+      /**
+       * RN-6 — shipped with the row so the join is auditable instead of assumed.
+       *
+       * Without it, an interaction with no `target_id` is ambiguous in the worst way:
+       * it could mean the control genuinely had no identity, or that the correlation
+       * refused and the identity exists but could not be attributed. Those are
+       * different defects with different owners, and the accounting lane cannot give
+       * an honest unplaceable REASON without knowing which.
+       *
+       * Undefined on the JS-fallback path (no native event, so nothing was joined),
+       * which is itself the correct answer there rather than a fabricated 'exact'.
+       */
+      correlation: details?.correlation,
+      correlation_delta_ms: details?.correlationDeltaMs,
+      correlation_runner_up_delta_ms: details?.correlationRunnerUpDeltaMs,
+      /**
+       * RN-1/RN-2 — stored alongside `target_id` so a reader can tell an authored
+       * identifier from a structural inference. 'path' means the app authored no testID
+       * and the identity was derived from component names, which is useful but will
+       * change under refactoring; a dashboard that presents the two identically invites
+       * someone to trust a key that is about to move.
+       */
+      target_source: details?.targetSource,
+      /**
+       * RN-8 — stored so "13.8% of interactions have a screen" becomes answerable.
+       * 'none' means the app instrumented nothing the SDK could see; 'manual' means a
+       * <ScaleBunScreen> beacon; 'navigation' means the React Navigation hook. Three
+       * different owners behind one number that today has none.
+       */
+      screen_source: details?.screenSource,
+      /**
+       * RN-13 — what makes "the heat is on this control" checkable instead of assumed.
+       * Absent when the control could not be measured synchronously, which is a fact worth
+       * storing: an unmeasurable control and a mis-placed tap are different findings.
+       */
+      target_rect: details?.targetRect,
+      /**
+       * RN-3 — the backend already reads scrollX/scrollY off the payload into the fact
+       * table's own columns (it has done since the web SDK, which sends `sx`/`sy`), so
+       * these need no migration. Mobile simply never sent them.
+       *
+       * `scroll_source` says whether an offset was available at all: 'none' means the app
+       * uses a plain <ScrollView> rather than the SDK's wrapper, which is a coverage gap in
+       * the integration and not a tap at the top of a list.
+       */
+      scrollX: details?.scrollX,
+      scrollY: details?.scrollY,
+      scroll_source: details?.scrollSource,
+      /**
+       * RN-4 — what stops a recycled native view merging two different rows into one
+       * hotspot. The key is the app's own keyExtractor output, so it is stable across
+       * scrolling and across sessions; the index is carried so a recycled slot (same index,
+       * different key) can be proven rather than inferred.
+       */
+      item_key: details?.itemKey,
+      item_index: details?.itemIndex,
+      /**
+       * RN-15 — where in the control, not just which control. Turns "they tapped Add to
+       * Cart" into "they tapped its left edge", which is what tells you whether a hit area
+       * is right. Outside 0..1 is a hitSlop tap and is kept as such.
+       */
+      local_u: details?.localU,
+      local_v: details?.localV,
       gestureType,
       x: details?.x,
       y: details?.y,

package/lib/commonjs/public/ScaleBunFacade.js

@@ -175,7 +175,7 @@ class ScaleBunFacade {
           const realQueue = _container.coreContainer.get('PersistentQueue');
           const buffered = this._preInitBuffer.popBatch(this._preInitBuffer.length());
           if (buffered.length > 0) {
-            __DEV__ && _internalLogger.logger.debug(`[ScaleBun] Draining ${buffered.length} pre-init events into persistent queue`);
+            _internalLogger.logger.debug(`[ScaleBun] Draining ${buffered.length} pre-init events into persistent queue`);
             for (const envelope of buffered) {
               realQueue.add(envelope);
             }
@@ -303,7 +303,9 @@ class ScaleBunFacade {
       }
       const clientKey = this._clientKey;
       const apiUrl = this._apiBaseUrl;
-      if (!clientKey || !apiUrl) return;
+      if (!clientKey || !apiUrl) {
+        return;
+      }
       this._otaCheckInFlight = true;
       try {
         const info = await _bridgeAdapter.bridgeAdapter.getDeviceInfo();
@@ -360,7 +362,7 @@ class ScaleBunFacade {
       if (!dbgConfig) return;
       dbgConfig.__skipDeprecationWarning = true;
       this.enableDebug(dbgConfig);
-      __DEV__ && _internalLogger.logger.info('[ScaleBun] Debug auto-connected via init({ debug }).');
+      _internalLogger.logger.info('[ScaleBun] Debug auto-connected via init({ debug }).');
     } catch (err) {
       _internalLogger.logger.warn('[ScaleBun] Auto debug connection failed:', err?.message);
     }
@@ -377,7 +379,7 @@ class ScaleBunFacade {
       const apiBaseUrl = this._apiBaseUrl;
       if (!enabled || !appId || !clientKey || !apiBaseUrl) {
         if (enabled && !appId) {
-          __DEV__ && _internalLogger.logger.info('[ScaleBun] Envelope event tracking disabled — no appId in init config.');
+          _internalLogger.logger.info('[ScaleBun] Envelope event tracking disabled — no appId in init config.');
         }
         return;
       }
@@ -429,7 +431,7 @@ class ScaleBunFacade {
         onEvent: (eventName, revenue) => this._skanManager?.onEvent(eventName, revenue)
       });
       this._eventTracker.start();
-      __DEV__ && _internalLogger.logger.info('[ScaleBun] Envelope event tracking started → /v1/batch.');
+      _internalLogger.logger.info('[ScaleBun] Envelope event tracking started → /v1/batch.');
 
       // Complete the device context from the native bridge.
       //
@@ -1111,7 +1113,7 @@ class ScaleBunFacade {
       const cfg = await (this._getEngageTransport()?.fetchEngageConfig(context) ?? Promise.resolve(null));
       const messages = cfg?.inAppMessages ?? [];
       const previews = messages.filter(m => m.preview === true || m.isTest === true);
-      __DEV__ && _internalLogger.logger.info(`[Engage] debugFetchInAppMessages → ${messages.length} message(s), ${previews.length} test preview(s)`);
+      _internalLogger.logger.info(`[Engage] debugFetchInAppMessages → ${messages.length} message(s), ${previews.length} test preview(s)`);
       return messages;
     },
     /** Upload a survey/NPS/feedback response (idempotent, rides the outbox). */
@@ -1396,7 +1398,7 @@ class ScaleBunFacade {
         _internalLogger.logger.warn('SDK not initialized. Event dropped:', name);
         return;
       }
-      __DEV__ && _internalLogger.logger.debug('Tracking event:', name);
+      _internalLogger.logger.debug('Tracking event:', name);
 
       // Fan this event out to the Engage trigger engine. Same single funnel,
       // extra observer — lets behavioral triggers (custom_event, failed_action,
@@ -1569,7 +1571,7 @@ class ScaleBunFacade {
         await Promise.all([this._eventTracker?.flush() ?? Promise.resolve(), adapter?.flushAnalytics() ?? Promise.resolve()]);
         return;
       }
-      __DEV__ && _internalLogger.logger.debug('Flushing events from persistent queue...');
+      _internalLogger.logger.debug('Flushing events from persistent queue...');
       const httpClient = _container.coreContainer.get('HttpClient');
       await (0, _flushQueue.flushQueue)(this._getQueue(), httpClient, (0, _deviceId.getDeviceId)());
     });
@@ -1592,9 +1594,9 @@ class ScaleBunFacade {
       const bootstrapPerfFeature = (0, _debug.getPerformanceFeature)();
       if (bootstrapPerfFeature) {
         this._performanceFeature = bootstrapPerfFeature;
-        __DEV__ && _internalLogger.logger.debug('Performance feature linked from bootstrap');
+        _internalLogger.logger.debug('Performance feature linked from bootstrap');
       }
-      __DEV__ && _internalLogger.logger.info('Debug enabled');
+      _internalLogger.logger.info('Debug enabled');
     });
   }
 
@@ -1746,14 +1748,14 @@ class ScaleBunFacade {
         return false;
       }
       sm.startSession(metadata);
-      __DEV__ && _internalLogger.logger.info('session.start() ✅ sessionId:', sm.currentSessionId);
+      _internalLogger.logger.info('session.start() ✅ sessionId:', sm.currentSessionId);
       return true;
     },
     end: reason => {
       const sm = _SessionManager.SessionManager.getExistingInstance();
       if (!sm || !sm.isActive) return false;
       sm.endSession(reason);
-      __DEV__ && _internalLogger.logger.info('session.end() ✅');
+      _internalLogger.logger.info('session.end() ✅');
       return true;
     },
     emitEvent: (type, data) => {
@@ -1811,7 +1813,7 @@ class ScaleBunFacade {
         ...this._privacyConfig,
         ...config
       };
-      __DEV__ && _internalLogger.logger.debug('[report] Privacy config updated');
+      _internalLogger.logger.debug('[report] Privacy config updated');
     },
     /** Set branding for exported reports. */
     setBranding: config => {
@@ -1819,7 +1821,7 @@ class ScaleBunFacade {
         ...this._brandingConfig,
         ...config
       };
-      __DEV__ && _internalLogger.logger.debug('[report] Branding config updated');
+      _internalLogger.logger.debug('[report] Branding config updated');
     },
     /** Get current privacy config. */
     getPrivacy: () => ({
@@ -1874,9 +1876,9 @@ class ScaleBunFacade {
           AutoScreenDetector
         } = require('../features/navigation/AutoScreenDetector');
         AutoScreenDetector.getInstance().setNavigationRef(ref);
-        __DEV__ && _internalLogger.logger.info('[ScaleBun] Navigation ref set → auto screen detection active');
+        _internalLogger.logger.info('[ScaleBun] Navigation ref set → auto screen detection active');
       } catch (err) {
-        __DEV__ && _internalLogger.logger.debug('[ScaleBun] Navigation ref stashed (detector not ready):', err?.message);
+        _internalLogger.logger.debug('[ScaleBun] Navigation ref stashed (detector not ready):', err?.message);
       }
     });
   }

package/lib/module/bootstrap/SDKBootstrapper.js

@@ -75,6 +75,15 @@ export class SDKBootstrapper {
     // apiBaseUrl is LOCKED: whatever an integrator passed (or the schema default) is
     // discarded here so the SDK can never be repointed away from the ScaleBun cloud.
     // Change DEFAULT_API_BASE_URL at build time to target a different backend.
+    // Say so when we discard it. The value was accepted by the schema, silently
+    // overwritten here, and the SDK then talked to a different server than the
+    // integrator configured — with no log, no warning, and no error. Someone
+    // pointing the SDK at a staging or local backend would watch requests arrive
+    // at production and have nothing to go on.
+    const requestedApiBaseUrl = rawConfig?.apiBaseUrl;
+    if (typeof requestedApiBaseUrl === 'string' && requestedApiBaseUrl && requestedApiBaseUrl !== DEFAULT_API_BASE_URL) {
+      logger.warn(`[ScaleBun] Ignoring apiBaseUrl '${requestedApiBaseUrl}' — the endpoint is ` + `locked at build time and this build targets ${DEFAULT_API_BASE_URL}. To ` + `target another backend, change DEFAULT_API_BASE_URL in the SDK source and ` + `rebuild.`);
+    }
     this.config.apiBaseUrl = DEFAULT_API_BASE_URL;
     // Explicit logLevel wins; otherwise debug:true implies verbose 'debug'.
     if (this.config.logLevel) {
@@ -314,6 +323,27 @@ export class SDKBootstrapper {
     await this.featureRegistry.initializeAll(featureContext);
 
     // ── Session Replay Initialization (Core) ───────────────
+    /**
+    * RN-3 zero-config scroll instrumentation, opt-in.
+    *
+    * Placed before replay init because it patches a module export and must be in place before the
+    * host renders its first scroll view. Reports rather than assumes: the equivalent React
+    * Navigation hook once claimed success it had not verified and left a whole pipeline silently
+    * empty, so a failure here is said out loud with a reason an integrator can act on.
+    */
+    if (this.config.autoInstrumentScrollViews === true) {
+      try {
+        const {
+          autoInstrumentScrollViews
+        } = require('../features/journey/autoInstrumentScroll');
+        const outcome = autoInstrumentScrollViews();
+        if (!outcome.installed) {
+          logger.warn('[Bootstrap] autoInstrumentScrollViews was requested but could not be ' + 'installed: ' + outcome.reason + ' — taps will carry no content depth.');
+        } else {
+          __DEV__ && logger.debug('[Bootstrap] ScrollView auto-instrumentation installed');
+        }
+      } catch {/* no-throw */}
+    }
     if (features.replay !== false) {
       try {
         __DEV__ && logger.debug('[Bootstrap] Initializing unified SessionManager');

package/lib/module/core/config/schema.js

@@ -269,6 +269,22 @@ const SHAPE = {
     }
   },
   captureInteractionHeatmap: bool(true),
+  /**
+   * RN-3 zero-config: patch React Native's ScrollView export so EVERY scroll view reports its
+   * offset, not just ones wrapped in ScaleBunScrollView.
+   *
+   * DEFAULT FALSE, unlike captureInteractionHeatmap above, and the difference is deliberate.
+   * That flag changes what the SDK records about the host; this one changes what the HOST
+   * RENDERS — every scroll view in the app, including ones inside third-party libraries the app
+   * did not write, starts routing through an SDK component. The failure mode is not a wrong
+   * number in a dashboard, it is the host's UI behaving differently because an analytics SDK
+   * replaced a primitive. That is a decision an integrator makes deliberately, not one they
+   * discover afterwards.
+   *
+   * With it off, a plain <ScrollView> yields no content depth and the tap says so
+   * (scroll_source: 'none') rather than defaulting its offset to 0.
+   */
+  autoInstrumentScrollViews: bool(false),
   // Opt-in: intercept console.* and ship the lines to the Diagnose → Logs lane in SaaS
   // mode. OFF by default — console output can carry PII/secrets and adds ingest volume,
   // so capturing it is the host's explicit choice, not a silent default. When true and a

package/lib/module/core/constants/version.js

@@ -8,5 +8,5 @@
  * value, so a stale one makes a rollout unobservable — which is the exact problem sending an SDK
  * version was introduced to solve.
  */
-export const SDK_VERSION = '2.0.0';
+export const SDK_VERSION = '2.0.1';
 //# sourceMappingURL=version.js.map