@goliapkg/sentori-react-native 0.6.1 → 0.7.1

package/lib/trail.d.ts

@@ -0,0 +1,12 @@
+import { TrailBuffer, type TrailStep } from '@goliapkg/sentori-core';
+/**
+ * Phase 46 — record a step into the session-trail buffer. The buffer
+ * is a fixed-size FIFO (default 30 steps); pushing past capacity
+ * drops the oldest entry. Steps are only uploaded if
+ * `init({ capture: { sessionTrail: true } })` is on AND a
+ * `captureException` follows.
+ */
+export declare const captureStep: (label: string, opts?: Partial<TrailStep>) => void;
+export declare const getTrailBuffer: () => TrailBuffer;
+export declare const __resetTrailForTests: () => void;
+//# sourceMappingURL=trail.d.ts.map

package/lib/trail.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"trail.d.ts","sourceRoot":"","sources":["../src/trail.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAIrE;;;;;;GAMG;AACH,eAAO,MAAM,WAAW,GAAI,OAAO,MAAM,EAAE,OAAO,OAAO,CAAC,SAAS,CAAC,KAAG,IAMtE,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,WAAqB,CAAC;AAExD,eAAO,MAAM,oBAAoB,QAAO,IAEvC,CAAC"}

package/lib/trail.js

@@ -0,0 +1,28 @@
+// Phase 46 — singleton TrailBuffer for the RN SDK.
+//
+// Kept in its own module so callers (including navigation.ts, which
+// is intentionally lightweight) can record steps without pulling in
+// capture.ts → handlers/screenshot.ts → react-native. The buffer is
+// drained inside capture.ts when an event captures and
+// `sessionTrailEnabled` is on.
+import { TrailBuffer } from '@goliapkg/sentori-core';
+const _trail = new TrailBuffer(30);
+/**
+ * Phase 46 — record a step into the session-trail buffer. The buffer
+ * is a fixed-size FIFO (default 30 steps); pushing past capacity
+ * drops the oldest entry. Steps are only uploaded if
+ * `init({ capture: { sessionTrail: true } })` is on AND a
+ * `captureException` follows.
+ */
+export const captureStep = (label, opts) => {
+    _trail.push({
+        ts: Date.now(),
+        label,
+        ...(opts ?? {}),
+    });
+};
+export const getTrailBuffer = () => _trail;
+export const __resetTrailForTests = () => {
+    _trail.clear();
+};
+//# sourceMappingURL=trail.js.map

package/lib/trail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"trail.js","sourceRoot":"","sources":["../src/trail.ts"],"names":[],"mappings":"AAAA,mDAAmD;AACnD,EAAE;AACF,oEAAoE;AACpE,oEAAoE;AACpE,oEAAoE;AACpE,uDAAuD;AACvD,+BAA+B;AAE/B,OAAO,EAAE,WAAW,EAAkB,MAAM,wBAAwB,CAAC;AAErE,MAAM,MAAM,GAAG,IAAI,WAAW,CAAC,EAAE,CAAC,CAAC;AAEnC;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAE,IAAyB,EAAQ,EAAE;IAC5E,MAAM,CAAC,IAAI,CAAC;QACV,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE;QACd,KAAK;QACL,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;KAChB,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,GAAgB,EAAE,CAAC,MAAM,CAAC;AAExD,MAAM,CAAC,MAAM,oBAAoB,GAAG,GAAS,EAAE;IAC7C,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC,CAAC"}

package/lib/transport.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAqBrC,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,IAUtC,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,IAOjC,CAAC;AAEF,eAAO,MAAM,UAAU,QAAa,OAAO,CAAC,IAAI,CAe/C,CAAC;AAqBF,eAAO,MAAM,KAAK,QAAa,OAAO,CAAC,IAAI,CAkB1C,CAAC;AA4FF,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,IAAI,CAatD,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,IAOlC,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,SAAS,KAAK,EAAY,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,MAAM,OAAO,KACZ,OAAO,CAAC,IAAI,CAcd,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,MAAM,EACf,MAAM,OAAO,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,EAC9C,MAAM;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,OAAM;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI,CAAA;CAAO,KAC/C,OAAO,CAAC,OAAO,SAAS,EAAE,cAAc,GAAG,IAAI,CA6CjD,CAAC"}
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAqBrC,eAAO,MAAM,OAAO,GAAI,OAAO,KAAK,KAAG,IAUtC,CAAC;AAEF,eAAO,MAAM,cAAc,QAAO,IAOjC,CAAC;AAEF,eAAO,MAAM,UAAU,QAAa,OAAO,CAAC,IAAI,CAe/C,CAAC;AAqBF,eAAO,MAAM,KAAK,QAAa,OAAO,CAAC,IAAI,CAkB1C,CAAC;AA4FF,eAAO,MAAM,iBAAiB,QAAa,OAAO,CAAC,IAAI,CAatD,CAAC;AAEF,eAAO,MAAM,eAAe,QAAO,IAOlC,CAAC;AAEF,eAAO,MAAM,WAAW,QAAO,SAAS,KAAK,EAAY,CAAC;AAE1D;;;;;;GAMG;AACH,eAAO,MAAM,eAAe,GAC1B,WAAW,MAAM,EACjB,OAAO,MAAM,EACb,MAAM,OAAO,KACZ,OAAO,CAAC,IAAI,CAcd,CAAC;AAMF;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,gBAAgB,GAC3B,SAAS,MAAM,EACf,MAAM,OAAO,SAAS,EAAE,cAAc,CAAC,MAAM,CAAC,EAC9C,MAAM;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAA;CAAE,EAC3C,OAAM;IAAE,MAAM,CAAC,EAAE,SAAS,GAAG,KAAK,GAAG,IAAI,CAAA;CAAO,KAC/C,OAAO,CAAC,OAAO,SAAS,EAAE,cAAc,GAAG,IAAI,CAmDjD,CAAC"}

package/lib/transport.js

@@ -256,9 +256,16 @@ export const uploadAttachment = async (eventId, kind, blob, opts = {}) => {
             },
             method: 'POST',
         });
-        if (resp.status !== 201)
+        // Phase 48 sub-A: accept any 2xx instead of strict 201. Reverse
+        // proxies in front of ingest occasionally rewrite 201 → 202 (the
+        // exact symptom Insight observed), and a 200 is also a valid
+        // "stored" response. We still require a JSON body shaped like
+        // UploadResponse; non-JSON bodies fall through to null.
+        if (resp.status < 200 || resp.status >= 300)
+            return null;
+        const j = (await resp.json().catch(() => null));
+        if (!j || !j.refId)
             return null;
-        const j = (await resp.json());
         return {
             kind,
             mediaType: j.mediaType,

package/lib/transport.js.map

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

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@goliapkg/sentori-react-native",
-  "version": "0.6.1",
-  "description": "Sentori SDK for React Native — JS-layer error capture, native crash handlers (iOS / Android), batched transport, fetch + react-navigation tracing.",
+  "version": "0.7.1",
+  "description": "Sentori SDK for React Native \u2014 JS-layer error capture, native crash handlers (iOS / Android), batched transport, fetch + react-navigation tracing.",
   "license": "MIT",
   "homepage": "https://sentori.golia.jp",
   "repository": {
@@ -69,6 +69,6 @@
     "access": "public"
   },
   "dependencies": {
-    "@goliapkg/sentori-core": "0.5.0"
+    "@goliapkg/sentori-core": "0.6.0"
   }
 }

package/src/capture.ts

@@ -1,13 +1,18 @@
+import { sealTrail, shouldSample } from '@goliapkg/sentori-core';
+
 import { addBreadcrumb, getBreadcrumbs } from './breadcrumbs';
 import { getConfig, isInitialized } from './config';
 import { symbolicateErrorViaMetro } from './handlers/dev-symbolicate';
 import { captureScreenshot } from './handlers/screenshot';
 import { markSessionErrored } from './session-tracker';
 import { parseStack } from './stack';
+import { getTrailBuffer } from './trail';
 import { enqueue, uploadAttachment } from './transport';
 import { uuidV7 } from './uuid';
 import type { App, AttachmentMeta, Device, Event, SentoriError, Tags, User } from './types';
 
+export { captureStep, __resetTrailForTests } from './trail';
+
 declare const __DEV__: boolean | undefined;
 
 let _user: User | null = null;
@@ -60,6 +65,14 @@ export const captureError = (error: Error, extras?: CaptureExtras): void => {
   const config = getConfig();
   if (!config) return;
 
+  // Phase 44 sub-B: client-side sampling. Skip the whole pipeline
+  // (no screenshot capture either) when the sample dice come up
+  // wrong. Default rate = null = keep, so existing callers unaffected.
+  if (!shouldSample(config.errorSampleRate)) {
+    addBreadcrumb({ type: 'custom', data: { reason: 'sampled-out', kind: 'error' } });
+    return;
+  }
+
   const event: Event = {
     id: uuidV7(),
     timestamp: new Date().toISOString(),
@@ -97,11 +110,49 @@ export const captureError = (error: Error, extras?: CaptureExtras): void => {
     if (wantScreenshot) {
       await captureAndAttachScreenshot(event);
     }
+    const trail = getTrailBuffer();
+    if (config.sessionTrailEnabled && trail.size() > 0) {
+      await captureAndAttachSessionTrail(event);
+    }
     enqueue(event);
   };
   void pipeline();
 };
 
+/**
+ * Phase 46 — seal the trail buffer, upload it as a `sessionTrail`
+ * attachment, attach the ref. Best-effort: any failure leaves a
+ * breadcrumb and lets the event ship without the trail.
+ *
+ * The trail is **always cleared** after `captureException`, even if
+ * upload fails — we don't want a stale 30-step buffer leaking into
+ * the next crash's trail.
+ */
+async function captureAndAttachSessionTrail(event: Event): Promise<void> {
+  const trail = getTrailBuffer();
+  const payload = sealTrail(trail);
+  trail.clear();
+  const json = JSON.stringify(payload);
+  // base64 the JSON for the `data:` URI multipart bridge (same
+  // trick the screenshot path uses).
+  const base64 =
+    typeof globalThis.btoa === 'function'
+      ? globalThis.btoa(unescape(encodeURIComponent(json)))
+      : Buffer.from(json, 'utf-8').toString('base64');
+  const attachment = await uploadAttachment(
+    event.id,
+    'sessionTrail',
+    { base64, mediaType: 'application/json' },
+    { source: 'js' },
+  );
+  if (!attachment) {
+    addBreadcrumb({ type: 'custom', data: { reason: 'session-trail-upload-failed' } });
+    return;
+  }
+  if (!event.attachments) event.attachments = [];
+  event.attachments.push(attachment);
+}
+
 export const captureException = captureError;
 
 /** Phase 42 sub-D.08: per-session screenshot quota gate. */

package/src/config.ts

@@ -6,6 +6,14 @@ export type Config = {
   enabled: boolean;
   /** Phase 42 sub-D.07: opt-in screenshot capture on captureException. */
   screenshotsEnabled: boolean;
+  /** Phase 44 sub-B: per-event-class sampling rates 0..1.
+   *  `null` = keep everything (default). */
+  errorSampleRate: null | number;
+  traceSampleRate: null | number;
+  /** Phase 46: when true, every `captureException` seals the
+   *  session-trail buffer and uploads it as a `sessionTrail`
+   *  attachment. Defaults to false. */
+  sessionTrailEnabled: boolean;
 };
 
 let _config: Config | null = null;

package/src/handlers/screenshot.ts

@@ -20,6 +20,8 @@
 
 import { InteractionManager } from 'react-native';
 
+import { engageMasks } from '../mask';
+
 type CaptureRef = (
   // Phase 42: the lib accepts a React ref or — when we pass `undefined` —
   // shoots the root window. We always go for the root (no per-component
@@ -75,6 +77,19 @@ export async function captureScreenshot(): Promise<ScreenshotBlob | null> {
     requestAnimationFrame(() => resolve());
   });
 
+  // Phase 48 sub-B — flip every registered MaskRegion overlay to
+  // opacity 1 (black covers the children) and every imperative
+  // setMaskedNode ref to opacity 0 (subtree disappears). Held for
+  // exactly one frame's worth of capture, then restored.
+  const restoreMasks = engageMasks();
+  // Yield one more frame so the overlay paint reaches the screen
+  // before captureRef snapshots. Without this the overlay opacity
+  // change is queued but the screenshotter may see the previous
+  // frame.
+  await new Promise<void>((resolve) => {
+    requestAnimationFrame(() => resolve());
+  });
+
   try {
     const base64 = await withTimeout(
       captureRef(undefined, {
@@ -87,6 +102,7 @@ export async function captureScreenshot(): Promise<ScreenshotBlob | null> {
       }),
       CAPTURE_TIMEOUT_MS,
     );
+    restoreMasks();
     if (!base64) return null;
     // view-shot doesn't ship a WebP encoder on every RN version.
     // JPEG q=70 fits the budget too (typical 40-100 KB) and every
@@ -94,6 +110,7 @@ export async function captureScreenshot(): Promise<ScreenshotBlob | null> {
     // RN minimum we support has it everywhere.
     return { base64, mediaType: 'image/jpeg' };
   } catch {
+    restoreMasks();
     return null;
   }
 }

package/src/index.ts

@@ -1,6 +1,6 @@
 import { init } from './init';
 import { addBreadcrumb } from './breadcrumbs';
-import { setUser, getUser, captureError, captureException } from './capture';
+import { setUser, getUser, captureError, captureException, captureStep } from './capture';
 import { ErrorBoundary } from './error-boundary';
 import { MaskRegion, setMaskedNode, unsetMaskedNode } from './mask';
 import {
@@ -16,6 +16,7 @@ export const sentori = {
   getUser,
   captureError,
   captureException,
+  captureStep,
   ErrorBoundary,
   MaskRegion,
   setMaskedNode,
@@ -29,7 +30,13 @@ export default sentori;
 
 export { init, init as initSentori } from './init';
 export { addBreadcrumb } from './breadcrumbs';
-export { setUser, getUser, captureError, captureException } from './capture';
+export {
+  captureError,
+  captureException,
+  captureStep,
+  getUser,
+  setUser,
+} from './capture';
 export { ErrorBoundary } from './error-boundary';
 export { MaskRegion, setMaskedNode, unsetMaskedNode } from './mask';
 export {

package/src/init.ts

@@ -38,6 +38,21 @@ export type InitOptions = {
      *  installed and `<MaskRegion>` placed over any sensitive UI. The
      *  image is webp q=70 480 px max, < 100 KB typical. */
     screenshot?: boolean;
+    /** Phase 46: record the last N steps (route changes, custom
+     *  breadcrumbs) leading up to a crash. On `captureException`
+     *  the buffer is sealed and uploaded as a `sessionTrail`
+     *  attachment. Defaults to false. */
+    sessionTrail?: boolean;
+  };
+  /** Phase 44 sub-B: client-side sampling. Each rate is `[0, 1]`;
+   *  absent / null keeps everything. Defaults to 1.0 for both
+   *  (no drop). Set traces to e.g. 0.1 once the app's at user
+   *  volume to keep ingest budget under control without changing
+   *  the server-side quota. Decisions are made per-event for
+   *  errors and per-trace (all spans together) for traces. */
+  sampling?: {
+    errors?: null | number;
+    traces?: null | number;
   };
 };
 
@@ -62,6 +77,9 @@ export const init = (options: InitOptions): void => {
     ingestUrl: options.ingestUrl ?? DEFAULT_INGEST_URL,
     enabled: true,
     screenshotsEnabled: options.capture?.screenshot === true,
+    errorSampleRate: options.sampling?.errors ?? null,
+    traceSampleRate: options.sampling?.traces ?? null,
+    sessionTrailEnabled: options.capture?.sessionTrail === true,
   });
 
   // Tell the native crash handler about the config so the JSON it writes

package/src/mask.tsx

@@ -1,89 +1,143 @@
-// Phase 42 sub-D.09/10 — mark UI regions as "do not screenshot".
+// Phase 42 sub-D.09/10 + Phase 48 sub-B — mark UI regions as "do not
+// screenshot" AND actually redact them at capture time.
 //
-// `<MaskRegion>` wraps any subtree the SDK should redact before
-// shipping a crash screenshot. It's purely declarative — the
-// component renders its children as-is in normal flight, but its
-// `View` is tagged with `collapsable={false}` + a sentinel
-// `nativeID` so the platform-level screenshotters
-// (`react-native-view-shot`, the iOS / Android native crash
-// capturers we add in sub-E / sub-F) can find it and paint over.
+// `<MaskRegion>` renders its children normally, plus a black overlay
+// `<View>` that sits on top of them with `opacity: 0`. Right before
+// `captureScreenshot()` calls into react-native-view-shot, the SDK
+// flips every registered overlay to `opacity: 1` (black square covers
+// the children), captures, then flips back to `opacity: 0` so the
+// user never sees the overlay. The overlay uses `pointerEvents="none"`
+// so it never intercepts touches.
 //
-// `setMaskedNode(ref)` is the imperative escape hatch: useful
-// when the sensitive view isn't yours to wrap (a third-party
-// modal, a video player, etc.). Pass a React ref obtained via
-// `createRef()` / `useRef()` and the SDK will redact that
-// subtree the next time it captures.
-//
-// `getMaskedRegions()` returns the current set of native tags;
-// `captureScreenshot()` would consult this list, but
-// `react-native-view-shot` doesn't expose a "redact these rects"
-// hook — so this iteration ships the registration API only and
-// the rendered overlay lives behind a default-on
-// `<View style={{ backgroundColor: '#000' }}>` you can wrap
-// yourself. The iOS / Android crash-time screenshotters in
-// sub-E / sub-F will read this list before drawing.
+// `setMaskedNode(ref)` is the imperative escape hatch for views you
+// can't wrap. We can't inject an overlay into a foreign view, so the
+// imperative path falls back to setting the registered view's own
+// `opacity: 0` for the capture window — content underneath may show
+// through, but that beats sending the sensitive content to the server.
+// Prefer `<MaskRegion>` when you control the subtree.
 
 import React, { type ReactNode, useEffect, useRef } from 'react';
-import { View, type ViewProps } from 'react-native';
+import { StyleSheet, View, type ViewProps } from 'react-native';
+
+/** What we drive in the capture window: any handle with
+ *  `setNativeProps({ opacity })`. RN's View instance satisfies this. */
+type Maskable = {
+  setNativeProps?: (props: { style?: { opacity?: number } }) => void;
+};
 
-/** Component-level node identifiers we've been asked to redact. */
-const _maskedRefs = new Set<React.Component | View | unknown>();
+const _maskedRefs = new Set<Maskable>();
+const _maskedOverlays = new Set<Maskable>();
 const _maskedNativeIds = new Set<string>();
 
 /**
- * Imperative registration: when you can't wrap the sensitive view
- * in `<MaskRegion>`, drop a ref on it and call `setMaskedNode(ref)`.
- * Future captures will mask the subtree.
+ * Imperative registration: pass a ref obtained via `useRef()` /
+ * `createRef()` to a `<View>` you want hidden from screenshots.
  */
-export function setMaskedNode(node: React.Component | View | null | unknown): void {
-  if (!node) return;
-  _maskedRefs.add(node);
+export function setMaskedNode(node: null | Maskable | unknown): void {
+  if (!node || typeof (node as Maskable).setNativeProps !== 'function') return;
+  _maskedRefs.add(node as Maskable);
 }
 
-/** Removes a previously registered ref. Pair this with mount/unmount
- *  lifecycle hooks if the node is short-lived. */
-export function unsetMaskedNode(node: React.Component | View | null | unknown): void {
+export function unsetMaskedNode(node: null | Maskable | unknown): void {
   if (!node) return;
-  _maskedRefs.delete(node);
+  _maskedRefs.delete(node as Maskable);
 }
 
 /** Returns the current set of registered masked nodes + nativeIDs.
- *  Read by the native screenshotter layer in sub-E / sub-F. */
+ *  Read by the native screenshotter layer (iOS / Android sub-E / F). */
 export function getMaskedRegions(): {
-  refs: Set<unknown>;
   nativeIds: Set<string>;
+  overlays: Set<Maskable>;
+  refs: Set<Maskable>;
 } {
-  return { nativeIds: _maskedNativeIds, refs: _maskedRefs };
+  return { nativeIds: _maskedNativeIds, overlays: _maskedOverlays, refs: _maskedRefs };
+}
+
+/**
+ * Phase 48 sub-B — engage masking right before screenshot capture.
+ * Returns a function the caller must invoke once capture is done so
+ * the user never sees the black overlays.
+ *
+ * Two paths:
+ *   - Overlays from `<MaskRegion>`: flip opacity 0 → 1 (cover children).
+ *   - Imperative refs from `setMaskedNode`: flip opacity 1 → 0 on the
+ *     view itself (whole subtree disappears for one frame).
+ *
+ * All `setNativeProps` calls are best-effort — a failure on one
+ * doesn't block the others or the capture.
+ */
+export function engageMasks(): () => void {
+  const overlaysEngaged: Maskable[] = [];
+  for (const o of _maskedOverlays) {
+    try {
+      o.setNativeProps?.({ style: { opacity: 1 } });
+      overlaysEngaged.push(o);
+    } catch {
+      // skip
+    }
+  }
+  const refsEngaged: Maskable[] = [];
+  for (const r of _maskedRefs) {
+    try {
+      r.setNativeProps?.({ style: { opacity: 0 } });
+      refsEngaged.push(r);
+    } catch {
+      // skip
+    }
+  }
+  return () => {
+    for (const o of overlaysEngaged) {
+      try {
+        o.setNativeProps?.({ style: { opacity: 0 } });
+      } catch {
+        // skip
+      }
+    }
+    for (const r of refsEngaged) {
+      try {
+        r.setNativeProps?.({ style: { opacity: 1 } });
+      } catch {
+        // skip
+      }
+    }
+  };
 }
 
 /**
  * Declarative redaction. `<MaskRegion>{children}</MaskRegion>` keeps
- * the children visible in normal flight; under capture, the wrapping
- * view is repainted black so the rendered screenshot doesn't leak
- * the underlying pixels.
+ * the children visible in normal flight; under capture the overlay's
+ * opacity is flipped to 1 and the children are hidden behind a black
+ * square in the rendered screenshot.
  */
 export function MaskRegion({
   children,
   nativeID,
   ...rest
 }: { children: ReactNode; nativeID?: string } & ViewProps): React.JSX.Element {
-  // Auto-generate a stable nativeID per mount so the native
-  // screenshotter can find this view by ID at capture time.
   const idRef = useRef<string>(
     nativeID ?? `sentori-mask-${Math.random().toString(36).slice(2, 10)}`,
   );
+  const overlayRef = useRef<null | View>(null);
 
   useEffect(() => {
     const id = idRef.current;
     _maskedNativeIds.add(id);
+    const overlay = overlayRef.current as null | Maskable;
+    if (overlay) _maskedOverlays.add(overlay);
     return () => {
       _maskedNativeIds.delete(id);
+      if (overlay) _maskedOverlays.delete(overlay);
     };
   }, []);
 
   return (
     <View collapsable={false} nativeID={idRef.current} {...rest}>
       {children}
+      <View
+        pointerEvents="none"
+        ref={overlayRef}
+        style={[StyleSheet.absoluteFill, { backgroundColor: '#000', opacity: 0 }]}
+      />
     </View>
   );
 }
@@ -91,5 +145,6 @@ export function MaskRegion({
 /** Test-only — flush registration tables. */
 export function __resetMaskedRegionsForTests(): void {
   _maskedRefs.clear();
+  _maskedOverlays.clear();
   _maskedNativeIds.clear();
 }

package/src/navigation.ts

@@ -24,6 +24,8 @@ import { useEffect, useRef } from 'react';
 
 import { setActiveSpan, startSpan, type SpanHandle } from '@goliapkg/sentori-core';
 
+import { captureStep } from './trail';
+
 /** Minimal contract: anything with `addListener('state', cb)` and
  *  `getCurrentRoute()` works. The real @react-navigation/native
  *  NavigationContainer ref matches this shape. */
@@ -72,6 +74,12 @@ export function useTraceNavigation(navigationRef: NavigationRefLike): void {
       openSpanRef.current = span;
       setActiveSpan(span);
       lastRouteRef.current = to;
+      // Phase 46 — record the screen transition into the session trail.
+      // No-op when sessionTrail isn't enabled (the buffer just grows
+      // unbounded until cleared by captureException, but stays cheap).
+      captureStep(`screen:${to}`, {
+        breadcrumb: { type: 'navigation', message: from ? `${from} → ${to}` : to },
+      });
     };
 
     // Open a span for the initial screen so its requests are grouped

package/src/trail.ts

@@ -0,0 +1,32 @@
+// Phase 46 — singleton TrailBuffer for the RN SDK.
+//
+// Kept in its own module so callers (including navigation.ts, which
+// is intentionally lightweight) can record steps without pulling in
+// capture.ts → handlers/screenshot.ts → react-native. The buffer is
+// drained inside capture.ts when an event captures and
+// `sessionTrailEnabled` is on.
+
+import { TrailBuffer, type TrailStep } from '@goliapkg/sentori-core';
+
+const _trail = new TrailBuffer(30);
+
+/**
+ * Phase 46 — record a step into the session-trail buffer. The buffer
+ * is a fixed-size FIFO (default 30 steps); pushing past capacity
+ * drops the oldest entry. Steps are only uploaded if
+ * `init({ capture: { sessionTrail: true } })` is on AND a
+ * `captureException` follows.
+ */
+export const captureStep = (label: string, opts?: Partial<TrailStep>): void => {
+  _trail.push({
+    ts: Date.now(),
+    label,
+    ...(opts ?? {}),
+  });
+};
+
+export const getTrailBuffer = (): TrailBuffer => _trail;
+
+export const __resetTrailForTests = (): void => {
+  _trail.clear();
+};

package/src/transport.ts

@@ -295,13 +295,19 @@ export const uploadAttachment = async (
       },
       method: 'POST',
     });
-    if (resp.status !== 201) return null;
-    const j = (await resp.json()) as {
+    // Phase 48 sub-A: accept any 2xx instead of strict 201. Reverse
+    // proxies in front of ingest occasionally rewrite 201 → 202 (the
+    // exact symptom Insight observed), and a 200 is also a valid
+    // "stored" response. We still require a JSON body shaped like
+    // UploadResponse; non-JSON bodies fall through to null.
+    if (resp.status < 200 || resp.status >= 300) return null;
+    const j = (await resp.json().catch(() => null)) as null | {
       refId: string;
       sizeBytes: number;
       mediaType: string;
       kind: string;
     };
+    if (!j || !j.refId) return null;
     return {
       kind,
       mediaType: j.mediaType,