@goliapkg/sentori-react-native 1.2.0 → 2.0.0

package/src/init.ts

@@ -73,6 +73,14 @@ export type InitOptions = {
      *  the buffer is sealed and uploaded as a `sessionTrail`
      *  attachment. Defaults to false. */
     sessionTrail?: boolean;
+    /** v2.0 W3 — when `true`, every `sentori.track(name, props)`
+     *  also pushes a `{ type: 'track', data: { name, props } }`
+     *  breadcrumb so a subsequent `captureException` /
+     *  `captureMessage` carries the customer journey leading up to
+     *  the failure. Defaults to `false` to preserve v1 customer
+     *  breadcrumb shape on upgrade; recommended `true` for new
+     *  integrations. See `docs/recipes/track-and-metrics.md`. */
+    trackAutoBreadcrumb?: boolean;
     /** v0.9.1 +S4 — pre-crash sentinel. Subscribes to JS-thread
      *  frame timing; when ≥ 50% of a 60-frame window misses the
      *  budget (default 32 ms / < 30 fps), emits a `kind: nearCrash`
@@ -130,6 +138,16 @@ export type InitOptions = {
      *  via `sentori.captureMessage()`. `null` / absent → keep all. */
     messages?: null | number;
   };
+  /** v2.3 — canonical sampling field (renamed from `sampling`).
+   *  Same shape; if both are passed, `sample` wins. The older
+   *  `sampling` stays accepted indefinitely as a back-compat alias —
+   *  this is the kind of rename that's only worth doing if it's
+   *  also zero-cost for existing callers. */
+  sample?: {
+    errors?: null | number;
+    traces?: null | number;
+    messages?: null | number;
+  };
   /** v2.3 — Sentori SDK's own console output gate. Default `'warn'`:
    *  SDK is silent unless something is genuinely broken (transport
    *  sustained failure, native module not found, internal SDK
@@ -181,10 +199,17 @@ 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,
-    messageSampleRate: options.sampling?.messages ?? null,
+    // v2.3 — `sample` is the canonical name; `sampling` is the
+    // back-compat alias. If both are supplied, `sample` wins.
+    errorSampleRate: options.sample?.errors ?? options.sampling?.errors ?? null,
+    traceSampleRate: options.sample?.traces ?? options.sampling?.traces ?? null,
+    messageSampleRate: options.sample?.messages ?? options.sampling?.messages ?? null,
     sessionTrailEnabled: options.capture?.sessionTrail === true,
+    // v2.0 W3 — when true, every `track()` also pushes a
+    // `type: 'track'` breadcrumb so a subsequent captureException
+    // carries the customer journey. Defaults false to preserve v1
+    // breadcrumb shape on upgrade.
+    trackAutoBreadcrumb: options.capture?.trackAutoBreadcrumb === true,
   });
 
   // Tell the native crash handler about the config so the JSON it writes

package/src/metrics.ts

@@ -11,6 +11,8 @@
 // outgoing connection pool. Batching makes the SDK safe to use as a
 // cheap counter primitive.
 
+import type { SpanContextLike } from '@goliapkg/sentori-core';
+
 import { getConfig, isInitialized } from './config';
 import { sendMetricsBatch } from './transport';
 
@@ -43,7 +45,7 @@ export function recordMetric(
   name: string,
   value: number,
   tags?: Record<string, string>,
-  opts?: { parent?: { spanId: string; traceId: string } },
+  opts?: { parent?: SpanContextLike },
 ): void {
   if (!isInitialized()) return;
   if (typeof name !== 'string' || name.length === 0 || name.length > 200) return;

package/src/track.ts

@@ -17,6 +17,7 @@
 // Hosts that don't use react-navigation can call
 // `sentori.track('$pageview', { route: 'Cart' })` themselves.
 
+import { addInternalBreadcrumb } from './breadcrumbs';
 import { getCurrentUserId } from './capture';
 import { getConfig, isInitialized } from './config';
 import { sendTrackBatch } from './transport';
@@ -74,6 +75,14 @@ export function track(name: string, props?: TrackProps, route?: string): void {
     userId: getCurrentUserId(),
   };
   _buf.push(ev);
+  // v2.0 W3 — auto-breadcrumb. When `init.capture.trackAutoBreadcrumb`
+  // is `true`, push a `{ type: 'track', data: { name, props } }`
+  // breadcrumb so the customer journey leading up to a later
+  // `captureException` / `captureMessage` is visible in the dashboard.
+  // Defaults off — see Config.trackAutoBreadcrumb docstring.
+  if (config?.trackAutoBreadcrumb === true) {
+    addInternalBreadcrumb('track', props ? { name, props } : { name });
+  }
   if (_buf.length >= MAX_BUFFER) {
     void flushTrack();
   }