@goliapkg/sentori-react-native 4.0.0 → 5.1.0

package/src/runtime-metrics-heap.ts

@@ -1,78 +0,0 @@
-// v2.1 W2 part 3 — JS heap auto-instrument.
-//
-// Polls `performance.memory.usedJSHeapSize` every 30 s, emits
-// runtime.heap.used_bytes. Web-only metric, RN best-effort —
-// the V8/Hermes value depends on which engine RN is wired to:
-//   • Hermes (RN ≥ 0.70 default): exposes a per-isolate count
-//     when memoryReporter is enabled (Hermes 0.12+)
-//   • JSC (legacy / explicit opt-in): no native equivalent
-//   • Web (sdk-javascript wires this same module): Chromium
-//     gates it behind a high-resolution-timer flag in some
-//     contexts; treat missing field as a silent no-op
-//
-// Cost: one number read + one emit every 30 s. Negligible.
-// The timer .unref()s so Node tests / CLI hosts exit cleanly.
-
-import { emitMetric } from '@goliapkg/sentori-core';
-
-const TICK_MS = 30_000;
-
-type MemoryShape = {
-  usedJSHeapSize?: number;
-  totalJSHeapSize?: number;
-  jsHeapSizeLimit?: number;
-};
-
-let _timer: null | ReturnType<typeof setInterval> = null;
-
-function readHeap(): MemoryShape | null {
-  const perf = (globalThis as { performance?: { memory?: MemoryShape } }).performance;
-  return perf?.memory ?? null;
-}
-
-function tickOnce(): void {
-  const m = readHeap();
-  if (!m) return;
-  if (typeof m.usedJSHeapSize === 'number' && Number.isFinite(m.usedJSHeapSize)) {
-    emitMetric('runtime.heap.used_bytes', m.usedJSHeapSize);
-  }
-  // Total + limit help capacity-plan but cost an extra ~16 B
-  // per row downstream — keep them only when present.
-  if (typeof m.totalJSHeapSize === 'number' && Number.isFinite(m.totalJSHeapSize)) {
-    emitMetric('runtime.heap.total_bytes', m.totalJSHeapSize);
-  }
-  if (typeof m.jsHeapSizeLimit === 'number' && Number.isFinite(m.jsHeapSizeLimit)) {
-    emitMetric('runtime.heap.limit_bytes', m.jsHeapSizeLimit);
-  }
-}
-
-/** Idempotent start. No-op on hosts that don't expose
- *  performance.memory — checked once at start so we don't pay
- *  for the detect on every tick. */
-export function startHeapInstrument(): void {
-  if (_timer !== null) return;
-  if (!readHeap()) return;
-  // One immediate sample at start so the first dashboard render
-  // doesn't sit empty for 30 s.
-  tickOnce();
-  _timer = setInterval(tickOnce, TICK_MS);
-  (_timer as unknown as { unref?: () => void }).unref?.();
-}
-
-/** Stop. Idempotent. */
-export function stopHeapInstrument(): void {
-  if (_timer !== null) {
-    clearInterval(_timer);
-    _timer = null;
-  }
-}
-
-/** Test-only force tick (skips the 30 s wait). */
-export function __forceHeapTickForTests(): void {
-  tickOnce();
-}
-
-/** Test-only state. */
-export function __peekHeapInstrumentState(): { running: boolean } {
-  return { running: _timer !== null };
-}

package/src/runtime-metrics-network.ts

@@ -1,103 +0,0 @@
-// v2.1 W2 part 4 — network bytes auto-instrument.
-//
-// Two counters (sent / received bytes) incremented by the existing
-// fetch patch on every request/response, drained every 30 s as
-// runtime.network.bytes_sent + runtime.network.bytes_received.
-//
-// Best-effort: not every Response exposes `content-length`
-// (chunked encoding, server stripped it, gzipped without a
-// pre-decode header). For those we report 0 — undercounts vs.
-// over-attributing arbitrary numbers. Request body size is
-// estimated only when init.body is a string or has `.byteLength`;
-// FormData / Blob / ReadableStream are not measured.
-//
-// XHR is NOT instrumented here — the existing patchXhr() in
-// handlers/network.ts does the trace span work, and XHR usage in
-// 2026-era RN apps is rare enough that the engineering cost of
-// a second patch isn't justified by the missing data. If a host
-// app shows up with significant XHR traffic we add it in a patch
-// release.
-
-import { emitMetric } from '@goliapkg/sentori-core';
-
-const TICK_MS = 30_000;
-
-let _bytesSent = 0;
-let _bytesReceived = 0;
-let _timer: null | ReturnType<typeof setInterval> = null;
-
-/** Called from handlers/network.ts on every outbound request.
- *  Cheap — two adds, no allocation. */
-export function recordNetworkBytes(sent: number, received: number): void {
-  if (sent > 0) _bytesSent += sent;
-  if (received > 0) _bytesReceived += received;
-}
-
-function estimateBodyBytes(body: BodyInit | null | undefined): number {
-  if (body == null) return 0;
-  if (typeof body === 'string') return body.length;
-  // ArrayBuffer / Uint8Array / ArrayBufferView all carry byteLength.
-  const maybe = body as { byteLength?: number };
-  if (typeof maybe.byteLength === 'number') return maybe.byteLength;
-  // FormData / Blob / ReadableStream — not measured.
-  return 0;
-}
-
-/** Estimate request bytes from a fetch init. Used by the fetch
- *  patch in handlers/network.ts. */
-export function estimateRequestBytes(init?: RequestInit): number {
-  return estimateBodyBytes(init?.body);
-}
-
-/** Read response bytes from the Content-Length header. Returns
- *  0 if missing or unparseable — undercount-safe. */
-export function estimateResponseBytes(headers: Headers | undefined | null): number {
-  if (!headers) return 0;
-  const v = headers.get?.('content-length');
-  if (!v) return 0;
-  const n = parseInt(v, 10);
-  return Number.isFinite(n) && n > 0 ? n : 0;
-}
-
-function emit(): void {
-  if (_bytesSent > 0) {
-    emitMetric('runtime.network.bytes_sent', _bytesSent);
-    _bytesSent = 0;
-  }
-  if (_bytesReceived > 0) {
-    emitMetric('runtime.network.bytes_received', _bytesReceived);
-    _bytesReceived = 0;
-  }
-}
-
-/** Idempotent start — second call is a no-op. */
-export function startNetworkBytesInstrument(): void {
-  if (_timer !== null) return;
-  _timer = setInterval(emit, TICK_MS);
-  (_timer as unknown as { unref?: () => void }).unref?.();
-}
-
-/** Stop the periodic emit. Idempotent. */
-export function stopNetworkBytesInstrument(): void {
-  if (_timer !== null) {
-    clearInterval(_timer);
-    _timer = null;
-  }
-}
-
-/** Test-only: force one emit tick + reset counters. */
-export function __forceNetworkEmitForTests(): void {
-  emit();
-}
-
-/** Test-only: peek raw counter state without resetting. */
-export function __peekNetworkCountersForTests(): { sent: number; received: number } {
-  return { sent: _bytesSent, received: _bytesReceived };
-}
-
-/** Test-only: reset for clean test runs. */
-export function __resetNetworkBytesForTests(): void {
-  stopNetworkBytesInstrument();
-  _bytesSent = 0;
-  _bytesReceived = 0;
-}

package/src/runtime-metrics.ts

@@ -1,122 +0,0 @@
-// v2.1 W2 part 2 — RN runtime metrics flusher + cold-start
-// instrument.
-//
-// The buffer + emit primitives live in @goliapkg/sentori-core
-// (runtime-metrics.ts). This module owns:
-//   • the periodic flush timer (30 s, coalesced w/ event flush)
-//   • the rebuffer-on-failure recovery path
-//   • the cold-start auto-instrument (one-shot at init)
-//
-// Other auto-instrument modules (FPS / heap / route-nav / network
-// bytes) ship in the W2 part 3+ chunks; each is its own file with
-// its own per-tick perf budget test gated as stop-ship in CI.
-//
-// NEVER rule: every public surface here is wrapped in safeFn
-// boundaries by the SDK init layer; the flush timer itself
-// catches all rejections + reports via the circuit breaker.
-
-import {
-  drainRuntimeMetricsForFlush,
-  emitMetric,
-  rebufferRuntimeMetrics,
-  reportInternal,
-} from '@goliapkg/sentori-core';
-
-import { getConfig, isInitialized } from './config';
-import { sendRuntimeMetricsBatch } from './transport';
-
-const FLUSH_INTERVAL_MS = 30_000;
-
-let _timer: null | ReturnType<typeof setInterval> = null;
-let _coldStartT0: null | number = null;
-let _coldStartEmitted = false;
-
-/**
- * Drain core's runtime-metrics ring and POST to
- * /v1/runtime-metrics:batch. Rebuffers on failure so the next
- * tick retries; sustained outages spill into the ring's drop
- * counter which reports to the SDK self-report channel.
- *
- * Returns when the round-trip settles (success or failure). Per
- * the NEVER rule, never throws — failure is logged + rebuffered,
- * the resolved promise's value is undefined.
- */
-export async function flushRuntimeMetrics(): Promise<void> {
-  if (!isInitialized()) return;
-  const config = getConfig();
-  if (!config) return;
-  const batch = drainRuntimeMetricsForFlush();
-  if (batch.length === 0) return;
-  const ok = await sendRuntimeMetricsBatch(config.ingestUrl, config.token, batch);
-  if (!ok) {
-    rebufferRuntimeMetrics(batch);
-    reportInternal('runtime-metrics.flush', new Error('runtime-metrics POST failed'));
-  }
-}
-
-/**
- * Start the 30 s flush timer. Called once from `init()`. Idempotent
- * — repeated calls are a no-op so users that call
- * `Sentori.init({ metrics: true })` more than once (HMR, fast
- * refresh) don't get multiple timers.
- */
-export function startRuntimeMetricsTimer(): void {
-  if (_timer !== null) return;
-  _timer = setInterval(() => {
-    void flushRuntimeMetrics();
-  }, FLUSH_INTERVAL_MS);
-  // Don't keep Node alive solely for this timer. RN's setInterval
-  // is a NoopRef so this is harmless there; Node + CLI tests
-  // benefit so the process can exit cleanly.
-  (_timer as unknown as { unref?: () => void }).unref?.();
-}
-
-/**
- * Capture the wall-clock at `init()` so cold-start instrumentation
- * has a t0. Called from init() before any other auto-instrument
- * fires. Returns the captured t0 in millis (callers that want to
- * stash + use it later can hold the value).
- */
-export function markColdStartT0(): number {
-  if (_coldStartT0 === null) {
-    _coldStartT0 = Date.now();
-  }
-  return _coldStartT0;
-}
-
-/**
- * Emit one `runtime.cold_start_ms` metric point. Idempotent per
- * session — the second + later calls are a no-op so route-nav
- * instrument (W2 part 3) can call this safely without worrying
- * about double-counting.
- *
- * Hosts that want a more interactive-pixel-perfect cold-start
- * boundary (TTI vs. raw init→render) can call
- * `markTimeToFullDisplay()` and we emit that separately as
- * `runtime.time_to_full_display_ms` (existing v1 instrument).
- */
-export function emitColdStart(): void {
-  if (_coldStartEmitted) return;
-  if (_coldStartT0 === null) return;
-  const ms = Date.now() - _coldStartT0;
-  if (ms <= 0 || ms > 60_000) {
-    // Implausible — likely the host called emit before init or
-    // we got into a freeze-then-resume situation. Drop silently.
-    return;
-  }
-  emitMetric('runtime.cold_start_ms', ms);
-  _coldStartEmitted = true;
-}
-
-/**
- * Test-only escape hatch: stop the timer + reset cold-start state
- * so vitest / bun:test teardown doesn't leak intervals across runs.
- */
-export function __resetRuntimeMetricsRnForTests(): void {
-  if (_timer !== null) {
-    clearInterval(_timer);
-    _timer = null;
-  }
-  _coldStartT0 = null;
-  _coldStartEmitted = false;
-}

package/src/sample-profiler.ts

@@ -1,169 +0,0 @@
-// v1.1 #4 升级 — JS sample profiler (idle-tick sampler).
-//
-// What it does:
-//   • setInterval(50ms) — captures `new Error().stack` of the tick
-//     callback, parses out the top frames, increments per-frame
-//     counts in a rolling window
-//   • every 60 s, emits a `sentori.profile` span with the aggregated
-//     flame-data (frame name → tick count) as span data
-//
-// What it does NOT do:
-//   • Sample frames during a busy JS task. JS is single-threaded;
-//     while the busy code is running, our setInterval can't fire,
-//     so the busy stack never gets sampled. Long-task monitor (#4
-//     v0.9.6) catches that case from a different angle (duration).
-//
-// Idle-tick sampling is still useful: shows which functions appear
-// most often between busy moments — typically the render hot path,
-// frequent timer callbacks, recurring middleware. Pairs with
-// long-task-monitor (catches the 200ms+ outliers).
-//
-// Real Hermes off-thread sampling profiler (which would catch busy
-// frames too) needs RN-internal HermesAPI access, deferred to v1.2.
-
-import { startSpan } from '@goliapkg/sentori-core';
-
-const SAMPLE_INTERVAL_MS = 50;
-const FLUSH_INTERVAL_MS = 60_000;
-const MAX_FRAMES = 200; // safety cap per profile
-const MAX_FRAME_NAME_LEN = 120;
-
-/** Floor on user-configured sample interval. Going below ~20 ms costs
- *  measurable JS-thread time to `new Error().stack` + regex parse on
- *  every tick — past that point you'd see the profile drag down the
- *  thing you're profiling. */
-const MIN_SAMPLE_INTERVAL_MS = 20;
-
-/** Floor on flush interval. Sub-5s windows produce a span every few
- *  seconds, which is just noise for an aggregator that's looking at
- *  per-minute hotspot trends. */
-const MIN_FLUSH_INTERVAL_MS = 5_000;
-
-/** How many stack-trace lines to keep per tick (after dropping the
- *  Error ctor + sampleTick frames). 10 is enough to see the JS-side
- *  call shape; deeper than that the bottom frames are usually RN
- *  runtime / event loop and not actionable. */
-const FRAMES_PER_TICK = 10;
-
-let _frameCounts = new Map<string, number>();
-let _windowStartedAt = 0;
-let _sampleTimer: ReturnType<typeof setInterval> | null = null;
-let _flushTimer: ReturnType<typeof setInterval> | null = null;
-
-export type SampleProfilerOptions = {
-  enabled: boolean;
-  /** Sample interval ms. Default 50. Lower → more accurate but more
-   *  JS-thread overhead. */
-  sampleMs?: number;
-  /** Flush window ms. Default 60 000 (one minute). */
-  flushMs?: number;
-};
-
-/**
- * Start the idle-tick sample profiler. Idempotent — calling twice
- * is a no-op after the first successful start.
- *
- * Pairs naturally with `longTaskMonitor` (≥200ms outliers): the
- * profiler shows the *distribution* of code that runs in idle gaps,
- * the long-task monitor catches the few outliers that are blocking
- * the thread. Together they cover the JS-side perf signal cheaply.
- */
-export function startSampleProfiler(opts: SampleProfilerOptions): void {
-  if (!opts.enabled || _sampleTimer !== null) return;
-  const sampleMs = Math.max(MIN_SAMPLE_INTERVAL_MS, opts.sampleMs ?? SAMPLE_INTERVAL_MS);
-  const flushMs = Math.max(MIN_FLUSH_INTERVAL_MS, opts.flushMs ?? FLUSH_INTERVAL_MS);
-
-  _windowStartedAt = Date.now();
-  _sampleTimer = setInterval(() => sampleTick(), sampleMs);
-  _flushTimer = setInterval(() => flushWindow(), flushMs);
-  (_sampleTimer as unknown as { unref?: () => void }).unref?.();
-  (_flushTimer as unknown as { unref?: () => void }).unref?.();
-}
-
-export function stopSampleProfiler(): void {
-  if (_sampleTimer !== null) {
-    clearInterval(_sampleTimer);
-    _sampleTimer = null;
-  }
-  if (_flushTimer !== null) {
-    clearInterval(_flushTimer);
-    _flushTimer = null;
-  }
-  _frameCounts.clear();
-  _windowStartedAt = 0;
-}
-
-function sampleTick(): void {
-  const stack = new Error().stack;
-  if (!stack) return;
-  // Skip the first 2 frames — they're our `sampleTick` + `Error
-  // ctor` which would dominate every sample.
-  const lines = stack.split('\n').slice(2, 2 + FRAMES_PER_TICK);
-  for (const line of lines) {
-    const frame = parseFrameName(line);
-    if (frame) {
-      _frameCounts.set(frame, (_frameCounts.get(frame) ?? 0) + 1);
-    }
-  }
-}
-
-/** Pull a stable identifier from one stack-trace line. Handles:
- *
- *     at FunctionName (file://path/Foo.js:123:45)
- *     at file://path/Foo.js:123:45                   (anonymous)
- *     FunctionName@file://path/Foo.js:123:45         (Hermes style)
- *
- * Drops absolute path noise — keeps `Foo.js:Line` so re-deploys
- * with stable code paths bucket together. */
-function parseFrameName(line: string): null | string {
-  const trimmed = line.trim();
-  if (trimmed.length === 0) return null;
-  // Hermes / JSC: `FunctionName@file:line:col` or just `@file:line:col`.
-  // Standard:    `at FunctionName (file:line:col)`.
-  let raw = trimmed.replace(/^at\s+/, '');
-  raw = raw.replace(/\s*[(\[].*$/, ''); // strip the file part after `(`
-  // Hermes: split on @
-  if (raw.includes('@')) {
-    raw = raw.split('@')[0] ?? raw;
-  }
-  raw = raw.trim();
-  if (raw.length === 0 || raw.length > MAX_FRAME_NAME_LEN) return null;
-  // Ignore the obvious noise frames.
-  if (raw === 'Object.<anonymous>' || raw === '<anonymous>') return null;
-  return raw;
-}
-
-function flushWindow(): void {
-  if (_frameCounts.size === 0) return;
-  const windowEndedAt = Date.now();
-  const durationMs = windowEndedAt - _windowStartedAt;
-  // Top-N frames so attachment doesn't bloat unboundedly.
-  const top = Array.from(_frameCounts.entries())
-    .sort((a, b) => b[1] - a[1])
-    .slice(0, MAX_FRAMES);
-
-  const span = startSpan('sentori.profile', {
-    name: 'js.sample-profile',
-    startNowMs: _windowStartedAt,
-    tags: {
-      'profile.kind': 'sample',
-      'profile.sample_count': String(sampleCount(top)),
-      'profile.duration_ms': String(durationMs),
-    },
-  });
-  span.setData('flameData', Object.fromEntries(top));
-  span.finish({ endNowMs: windowEndedAt, status: 'ok' });
-
-  _frameCounts.clear();
-  _windowStartedAt = windowEndedAt;
-}
-
-function sampleCount(entries: [string, number][]): number {
-  let total = 0;
-  for (const [, n] of entries) total += n;
-  return total;
-}
-
-export function __resetSampleProfilerForTests(): void {
-  stopSampleProfiler();
-}

package/src/sentinel-context.ts

@@ -1,60 +0,0 @@
-// Shared device + app collectors. Used by both capture.ts (errors)
-// and pre-crash-sentinel.ts (nearCrash). Same shape so the dashboard
-// can render both kinds of events through the same UI components.
-
-import { getCachedNetworkType } from './netinfo';
-import type { App, Device } from './types';
-
-export const collectDeviceForSentinel = (): Device => {
-  let os: Device['os'] = 'other';
-  let osVersion = '0';
-  let locale: string | undefined;
-  const networkType = getCachedNetworkType();
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    const RN = require('react-native') as {
-      NativeModules: {
-        I18nManager?: { localeIdentifier?: string };
-        SettingsManager?: {
-          settings?: { AppleLanguages?: string[]; AppleLocale?: string };
-        };
-      };
-      Platform: { OS: string; Version: number | string };
-    };
-    const rnOS = RN.Platform.OS;
-    os = rnOS === 'android' || rnOS === 'ios' || rnOS === 'web' ? rnOS : 'other';
-    osVersion = String(RN.Platform.Version);
-    if (rnOS === 'ios') {
-      const s = RN.NativeModules.SettingsManager?.settings;
-      locale = s?.AppleLocale ?? s?.AppleLanguages?.[0];
-    } else if (rnOS === 'android') {
-      locale = RN.NativeModules.I18nManager?.localeIdentifier;
-    }
-  } catch {
-    // not in RN runtime
-  }
-  const device: Device = { os, osVersion };
-  if (locale) device.locale = locale;
-  if (networkType) device.networkType = networkType;
-  return device;
-};
-
-export const getAppForSentinel = (release: string): App => {
-  const m = /^(?:[^@]+@)?([^+]+)(?:\+(.+))?$/.exec(release);
-  const version = m?.[1] ?? '0.0.0';
-  const build = m?.[2];
-
-  let rnVersion = 'unknown';
-  try {
-    // eslint-disable-next-line @typescript-eslint/no-require-imports
-    rnVersion = (require('react-native/package.json') as { version: string }).version;
-  } catch {
-    // not in RN runtime
-  }
-
-  return {
-    build,
-    framework: { name: 'react-native', version: rnVersion },
-    version,
-  };
-};

package/src/session-tracker.ts

@@ -1,53 +0,0 @@
-/**
- * Phase 26 sub-B: RN session tracker glue.
- *
- * Mirrors the JS SDK's session-tracker but sends through the RN
- * transport. AppState binding lives in `handlers/lifecycle.ts`; this
- * file is just the singleton + the start/end/markErrored/markCrashed
- * surface.
- */
-import { SessionTracker } from '@goliapkg/sentori-core';
-
-import { getConfig } from './config';
-import { getUser } from './capture';
-import { sendSessionPing } from './transport';
-
-let _tracker: null | SessionTracker = null;
-
-const tracker = (): SessionTracker => {
-  if (_tracker) return _tracker;
-  _tracker = new SessionTracker((ping) => {
-    const cfg = getConfig();
-    if (!cfg) return;
-    void sendSessionPing(cfg.ingestUrl, cfg.token, ping);
-  });
-  return _tracker;
-};
-
-export const startSession = (): void => {
-  const cfg = getConfig();
-  if (!cfg) return;
-  const user = getUser();
-  tracker().start({
-    environment: cfg.environment,
-    release: cfg.release,
-    userId: user?.id ?? null,
-  });
-};
-
-export const endSession = (status?: 'exited'): void => {
-  if (!_tracker) return;
-  _tracker.end(status);
-};
-
-export const markSessionErrored = (): void => {
-  _tracker?.markErrored();
-};
-
-export const markSessionCrashed = (): void => {
-  _tracker?.markCrashed();
-};
-
-export const __resetSessionForTests = (): void => {
-  _tracker = null;
-};

package/src/stack.ts

@@ -1,10 +0,0 @@
-// Phase 21: regex + parse loop moved to @goliapkg/sentori-core.
-// RN keeps the long path (no shortFilenames option) because Hermes
-// paths are already short and native symbolication needs the
-// absolute form.
-import { parseStack as parseStackCore } from '@goliapkg/sentori-core'
-
-import type { Frame } from './types'
-
-export const parseStack = (stack: string | undefined): Frame[] =>
-  parseStackCore(stack)