@goliapkg/sentori-react-native 4.0.0 → 5.1.0

package/src/verbs.ts

@@ -0,0 +1,198 @@
+// The five event verbs (design.md §4). Everything here is
+// synchronous, never throws, and returns the client-minted event id
+// — the zero-cost iron rule made code.
+//
+//   sentori.error(err)    出了什么事?
+//   sentori.warn(name)    用户哪里不舒服?
+//   sentori.trace(name)   这里发生了什么?
+//   sentori.assert(n, ok) 这里应该成立吗?
+//   sentori.probe(ref)    那个 bug 回来了吗?
+
+import {
+  coerceError,
+  parseStack,
+  pushSignal,
+  safeFn,
+  snapshotSignals,
+  uuidV7,
+} from '@goliapkg/sentori-core';
+import type {
+  EventData,
+  EventKind,
+  SentoriError,
+  Surface,
+  TraceOptions,
+  WireEvent,
+  WirePayload,
+} from '@goliapkg/sentori-core';
+
+import { getConfig } from './config';
+import { collectDevice } from './device';
+import { onEventEmitted } from './emit-hooks';
+import { currentContext, currentUserKey } from './scope';
+import { countAssert, enqueue } from './transport';
+
+/** Serialize any Error instances found in the data argument — the
+ *  error-in-data convention (design.md §4): a caught-but-noteworthy
+ *  exception needs no special API. One level deep is enough; nested
+ *  containers of errors are an anti-pattern we don't reward. */
+const serializeData = (data?: EventData): Record<string, unknown> | undefined => {
+  if (!data) return undefined;
+  const out: Record<string, unknown> = {};
+  for (const [k, v] of Object.entries(data)) {
+    out[k] = v instanceof Error ? toSentoriError(v) : v;
+  }
+  return out;
+};
+
+const toSentoriError = (e: Error): SentoriError => ({
+  type: e.name || 'Error',
+  message: e.message,
+  stack: parseStack(e.stack),
+  cause:
+    e.cause instanceof Error
+      ? toSentoriError(e.cause)
+      : null,
+});
+
+const platformOf = (): 'android' | 'ios' | 'javascript' => {
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const RN = require('react-native') as { Platform?: { OS?: string } };
+    const os = RN.Platform?.OS;
+    if (os === 'ios') return 'ios';
+    if (os === 'android') return 'android';
+  } catch {
+    // headless / test environment
+  }
+  return 'javascript';
+};
+
+type EmitOptions = {
+  name?: string;
+  surface?: Surface;
+  error?: SentoriError;
+  data?: EventData;
+  /** Attach the signal-ring snapshot (error/warn: yes; the light
+   *  kinds ship without it). */
+  withSignals?: boolean;
+};
+
+/** Assemble + enqueue one event. The single funnel every verb uses. */
+const emit = (kind: EventKind, opts: EmitOptions): string => {
+  const id = uuidV7();
+  const config = getConfig();
+  if (!config || !config.enabled) return id; // no-op before init — iron rule
+
+  const payload: WirePayload = {};
+  if (opts.error) payload.error = opts.error;
+  const data = serializeData(opts.data);
+  if (data) payload.data = data;
+  const ctx = currentContext();
+  if (ctx) payload.context = ctx;
+  if (opts.withSignals) {
+    const signals = snapshotSignals();
+    if (signals.length > 0) payload.signals = signals;
+  }
+  const device = collectDevice();
+  if (device) payload.device = device;
+
+  let event: WireEvent = {
+    id,
+    kind,
+    occurredAt: new Date().toISOString(),
+    platform: platformOf(),
+    release: config.release,
+    environment: config.environment,
+    name: opts.name,
+    surface: opts.surface,
+    userKey: currentUserKey(),
+    payload,
+  };
+
+  if (config.beforeSend) {
+    try {
+      const out = config.beforeSend(event);
+      if (out === null) return id; // deliberate drop
+      if (out && typeof out === 'object') event = out;
+    } catch {
+      // Hook broke: the un-mutated event ships. The host's bug must
+      // not cost them the crash report.
+    }
+  }
+
+  enqueue(event);
+  onEventEmitted(event);
+  return id;
+};
+
+// ── the verbs ──────────────────────────────────────────────────────
+
+export const error = safeFn('error', (err: unknown, data?: EventData): string => {
+  const coerced = coerceError(err);
+  return emit('error', {
+    error: toSentoriError(coerced),
+    data,
+    withSignals: true,
+  });
+});
+
+export const warn = safeFn(
+  'warn',
+  (name: string, data?: EventData): string => {
+    // A hand-written warn's surface can ride in data.surface; the
+    // detected scenarios pass it explicitly via warnDetected.
+    const surface =
+      data && typeof data.surface === 'object'
+        ? (data.surface as Surface)
+        : undefined;
+    return emit('warn', { name, surface, data, withSignals: true });
+  },
+);
+
+/** SDK-internal: a detected warn scenario with an explicit surface. */
+export const warnDetected = (
+  scenario: string,
+  surface: Surface,
+  data?: EventData,
+): string =>
+  emit('warn', { name: scenario, surface, data, withSignals: true });
+
+export const trace = safeFn(
+  'trace',
+  (name: string, data?: EventData, opts?: TraceOptions): string => {
+    // Every trace is context: it lands in the ring regardless.
+    pushSignal('trace', { name, ...(data ?? {}) });
+    if (opts?.quiet) return uuidV7();
+    return emit('trace', { name, data });
+  },
+);
+
+export const assert = safeFn(
+  'assert',
+  (name: string, ok: boolean, data?: EventData): string => {
+    const config = getConfig();
+    if (config) countAssert(name, ok, config.release);
+    if (ok) return uuidV7(); // passes aggregate; they are never events
+    return emit('assert', { name, data, withSignals: true });
+  },
+);
+
+export const probe = safeFn('probe', (ref: string, data?: EventData): string => {
+  // A tripwire: reaching this call IS the signal. Never throws,
+  // never changes control flow (design.md §4).
+  return emit('probe', { name: ref, data });
+});
+
+// safeFn returns `R | undefined`; the public surface promises a
+// string. An internal failure mints an id that simply never ships —
+// honest enough, and the host never sees a throw.
+export const verbs = {
+  error: (err: unknown, data?: EventData): string => error(err, data) ?? uuidV7(),
+  warn: (name: string, data?: EventData): string => warn(name, data) ?? uuidV7(),
+  trace: (name: string, data?: EventData, opts?: TraceOptions): string =>
+    trace(name, data, opts) ?? uuidV7(),
+  assert: (name: string, ok: boolean, data?: EventData): string =>
+    assert(name, ok, data) ?? uuidV7(),
+  probe: (ref: string, data?: EventData): string => probe(ref, data) ?? uuidV7(),
+};

package/lib/breadcrumbs.d.ts

@@ -1,18 +0,0 @@
-import type { Breadcrumb, BreadcrumbType } from './types';
-export type AddBreadcrumbInput = {
-    data: Record<string, unknown>;
-    timestamp?: string;
-    type: BreadcrumbType;
-};
-export declare const addBreadcrumb: (input: AddBreadcrumbInput) => void;
-export declare const getBreadcrumbs: () => Breadcrumb[];
-export declare const clearBreadcrumbs: () => void;
-export declare const __resetForTests: () => void;
-/** v0.9.8 — `__DEV__`-gated peek used by `captureException` to log
- *  diagnostic counts to Metro. Production builds never see this. */
-export declare const __peekBreadcrumbCount: () => number;
-/** Surface-area helper that the SDK uses internally to drop diagnostic
- *  breadcrumbs without leaking the object-form API. Same target buffer
- *  as the public `addBreadcrumb`. */
-export declare const addInternalBreadcrumb: (type: BreadcrumbType, data: Record<string, unknown>) => void;
-//# sourceMappingURL=breadcrumbs.d.ts.map

package/lib/breadcrumbs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":"AAgBA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AAIzD,MAAM,MAAM,kBAAkB,GAAG;IAC/B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;IAC7B,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,IAAI,EAAE,cAAc,CAAA;CACrB,CAAA;AAID,eAAO,MAAM,aAAa,GAAI,OAAO,kBAAkB,KAAG,IAQzD,CAAA;AAED,eAAO,MAAM,cAAc,QAAO,UAAU,EAAuB,CAAA;AAEnE,eAAO,MAAM,gBAAgB,QAAO,IAEnC,CAAA;AAED,eAAO,MAAM,eAAe,QAAO,IAA0B,CAAA;AAE7D;oEACoE;AACpE,eAAO,MAAM,qBAAqB,QAAO,MAAkC,CAAA;AAE3E;;qCAEqC;AACrC,eAAO,MAAM,qBAAqB,GAAI,MAAM,cAAc,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAG,IAG3F,CAAA"}

package/lib/breadcrumbs.js

@@ -1,42 +0,0 @@
-// v0.9.8 — RN SDK now owns its own BreadcrumbBuffer instance.
-//
-// Previous behaviour delegated to sentori-core's module-scoped
-// `_global` buffer. That was fine on Node / bun (single module
-// instance), but Metro's CJS/ESM interop on react-native can
-// instantiate `@goliapkg/sentori-core` twice when the host app and
-// the SDK both resolve it — the handler writes to one `_global` and
-// `capture.ts` reads from the other, leaving every event with
-// `breadcrumbs: []` (Insight 2026-05-16 report).
-//
-// Keeping the buffer local to the RN SDK is the smallest fix that
-// guarantees a single instance regardless of how the bundler
-// resolves sentori-core. addBreadcrumb / getBreadcrumbs / clearBreadcrumbs
-// are now self-contained.
-import { BreadcrumbBuffer, logger } from '@goliapkg/sentori-core';
-const _local = new BreadcrumbBuffer();
-export const addBreadcrumb = (input) => {
-    _local.push(input.type, input.data);
-    if (input.timestamp) {
-        // Override the auto-stamped `now()` with the caller's value. Rare
-        // path; most callers omit timestamp.
-        const last = _local.snapshot().at(-1);
-        if (last)
-            last.timestamp = input.timestamp;
-    }
-};
-export const getBreadcrumbs = () => _local.snapshot();
-export const clearBreadcrumbs = () => {
-    _local.clear();
-};
-export const __resetForTests = () => clearBreadcrumbs();
-/** v0.9.8 — `__DEV__`-gated peek used by `captureException` to log
- *  diagnostic counts to Metro. Production builds never see this. */
-export const __peekBreadcrumbCount = () => _local.snapshot().length;
-/** Surface-area helper that the SDK uses internally to drop diagnostic
- *  breadcrumbs without leaking the object-form API. Same target buffer
- *  as the public `addBreadcrumb`. */
-export const addInternalBreadcrumb = (type, data) => {
-    _local.push(type, data);
-    logger.debug('breadcrumb', type, data);
-};
-//# sourceMappingURL=breadcrumbs.js.map

package/lib/breadcrumbs.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":"AAAA,8DAA8D;AAC9D,EAAE;AACF,+DAA+D;AAC/D,+DAA+D;AAC/D,6DAA6D;AAC7D,mEAAmE;AACnE,oEAAoE;AACpE,8DAA8D;AAC9D,iDAAiD;AACjD,EAAE;AACF,kEAAkE;AAClE,6DAA6D;AAC7D,2EAA2E;AAC3E,0BAA0B;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,wBAAwB,CAAA;AAYjE,MAAM,MAAM,GAAG,IAAI,gBAAgB,EAAE,CAAA;AAErC,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAyB,EAAQ,EAAE;IAC/D,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAA;IACnC,IAAI,KAAK,CAAC,SAAS,EAAE,CAAC;QACpB,kEAAkE;QAClE,qCAAqC;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAA;QACrC,IAAI,IAAI;YAAE,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,SAAS,CAAA;IAC5C,CAAC;AACH,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,GAAiB,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAA;AAEnE,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAS,EAAE;IACzC,MAAM,CAAC,KAAK,EAAE,CAAA;AAChB,CAAC,CAAA;AAED,MAAM,CAAC,MAAM,eAAe,GAAG,GAAS,EAAE,CAAC,gBAAgB,EAAE,CAAA;AAE7D;oEACoE;AACpE,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAW,EAAE,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC,MAAM,CAAA;AAE3E;;qCAEqC;AACrC,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,IAAoB,EAAE,IAA6B,EAAQ,EAAE;IACjG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,CAAA;IACvB,MAAM,CAAC,KAAK,CAAC,YAAY,EAAE,IAAI,EAAE,IAAI,CAAC,CAAA;AACxC,CAAC,CAAA"}

package/lib/bundle-info.d.ts

@@ -1,12 +0,0 @@
-export type BundleInfo = {
-    /** Stable identifier — Expo `updateId` or CodePush `label`. */
-    id: string;
-    /** When the bundle was published. RFC 3339. */
-    deployedAt?: string;
-    /** Which OTA system reported it. */
-    source: 'codepush' | 'expo';
-};
-export declare function getBundleInfo(): BundleInfo | null;
-/** Test-only — reset cache. */
-export declare function __resetBundleInfoForTests(): void;
-//# sourceMappingURL=bundle-info.d.ts.map

package/lib/bundle-info.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"bundle-info.d.ts","sourceRoot":"","sources":["../src/bundle-info.ts"],"names":[],"mappings":"AAYA,MAAM,MAAM,UAAU,GAAG;IACvB,+DAA+D;IAC/D,EAAE,EAAE,MAAM,CAAC;IACX,+CAA+C;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,MAAM,EAAE,UAAU,GAAG,MAAM,CAAC;CAC7B,CAAC;AAIF,wBAAgB,aAAa,IAAI,UAAU,GAAG,IAAI,CAIjD;AAgED,+BAA+B;AAC/B,wBAAgB,yBAAyB,IAAI,IAAI,CAEhD"}

package/lib/bundle-info.js

@@ -1,73 +0,0 @@
-// v0.9.0 #10 — EAS Update / CodePush awareness.
-//
-// At capture time we want to know which JS bundle the user is running:
-// it's almost always an OTA update rather than the binary `release`,
-// and crash spikes correlate to a specific bundle id rather than the
-// app version. We try `expo-updates` first (EAS), then `react-native-
-// code-push`, then nothing. All access is `require()`-shielded so the
-// SDK still works when neither is installed.
-//
-// Cached at module load — bundle id doesn't change mid-session in
-// either Expo or CodePush.
-let _cached;
-export function getBundleInfo() {
-    if (_cached !== undefined)
-        return _cached;
-    _cached = detect();
-    return _cached;
-}
-function detect() {
-    // Expo Updates first — most modern RN deployments are on EAS Update.
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const Updates = require('expo-updates');
-        const id = Updates.updateId ?? Updates.manifest?.id;
-        if (typeof id === 'string' && id.length > 0) {
-            const deployedAt = pickDeployedAt(Updates);
-            return { deployedAt, id, source: 'expo' };
-        }
-    }
-    catch {
-        // expo-updates not installed
-    }
-    // CodePush fallback.
-    try {
-        // eslint-disable-next-line @typescript-eslint/no-require-imports
-        const cp = require('react-native-code-push');
-        // `getCurrentPackage` is async; we don't block init. Schedule a
-        // background fetch + populate the cache. First-event-after-init
-        // may miss the bundle id; subsequent events will have it.
-        if (typeof cp.getCurrentPackage === 'function') {
-            void cp
-                .getCurrentPackage()
-                .then((pkg) => {
-                if (pkg && (pkg.label || pkg.packageHash)) {
-                    _cached = {
-                        id: pkg.label ?? pkg.packageHash,
-                        source: 'codepush',
-                    };
-                }
-            })
-                .catch(() => {
-                // ignore
-            });
-        }
-    }
-    catch {
-        // not installed
-    }
-    return null;
-}
-function pickDeployedAt(u) {
-    if (u.commitTime instanceof Date)
-        return u.commitTime.toISOString();
-    const ts = u.manifest?.createdAt;
-    if (typeof ts === 'string')
-        return ts;
-    return undefined;
-}
-/** Test-only — reset cache. */
-export function __resetBundleInfoForTests() {
-    _cached = undefined;
-}
-//# sourceMappingURL=bundle-info.js.map

package/lib/bundle-info.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"bundle-info.js","sourceRoot":"","sources":["../src/bundle-info.ts"],"names":[],"mappings":"AAAA,gDAAgD;AAChD,EAAE;AACF,uEAAuE;AACvE,qEAAqE;AACrE,qEAAqE;AACrE,sEAAsE;AACtE,sEAAsE;AACtE,6CAA6C;AAC7C,EAAE;AACF,kEAAkE;AAClE,2BAA2B;AAW3B,IAAI,OAAsC,CAAC;AAE3C,MAAM,UAAU,aAAa;IAC3B,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,OAAO,CAAC;IAC1C,OAAO,GAAG,MAAM,EAAE,CAAC;IACnB,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,MAAM;IACb,qEAAqE;IACrE,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,CAKrC,CAAC;QACF,MAAM,EAAE,GAAG,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,QAAQ,EAAE,EAAE,CAAC;QACpD,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC5C,MAAM,UAAU,GAAG,cAAc,CAAC,OAAO,CAAC,CAAC;YAC3C,OAAO,EAAE,UAAU,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAC5C,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,6BAA6B;IAC/B,CAAC;IACD,qBAAqB;IACrB,IAAI,CAAC;QACH,iEAAiE;QACjE,MAAM,EAAE,GAAG,OAAO,CAAC,wBAAwB,CAM1C,CAAC;QACF,gEAAgE;QAChE,gEAAgE;QAChE,0DAA0D;QAC1D,IAAI,OAAO,EAAE,CAAC,iBAAiB,KAAK,UAAU,EAAE,CAAC;YAC/C,KAAK,EAAE;iBACJ,iBAAiB,EAAE;iBACnB,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;gBACZ,IAAI,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,WAAW,CAAC,EAAE,CAAC;oBAC1C,OAAO,GAAG;wBACR,EAAE,EAAE,GAAG,CAAC,KAAK,IAAI,GAAG,CAAC,WAAY;wBACjC,MAAM,EAAE,UAAU;qBACnB,CAAC;gBACJ,CAAC;YACH,CAAC,CAAC;iBACD,KAAK,CAAC,GAAG,EAAE;gBACV,SAAS;YACX,CAAC,CAAC,CAAC;QACP,CAAC;IACH,CAAC;IAAC,MAAM,CAAC;QACP,gBAAgB;IAClB,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,cAAc,CAAC,CAGvB;IACC,IAAI,CAAC,CAAC,UAAU,YAAY,IAAI;QAAE,OAAO,CAAC,CAAC,UAAU,CAAC,WAAW,EAAE,CAAC;IACpE,MAAM,EAAE,GAAG,CAAC,CAAC,QAAQ,EAAE,SAAS,CAAC;IACjC,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACtC,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,+BAA+B;AAC/B,MAAM,UAAU,yBAAyB;IACvC,OAAO,GAAG,SAAS,CAAC;AACtB,CAAC"}

package/lib/capture.d.ts

@@ -1,140 +0,0 @@
-import { type BeforeSendHook, type CaptureMessageOptions, type LinkBy } from '@goliapkg/sentori-core';
-import type { Event, Tags, User } from './types';
-export { captureStep, __resetTrailForTests } from './trail';
-/**
- * v2.0 — set a single scope tag merged onto every subsequent
- * capture. Per-call `extras.tags` / `opts.tags` win over scope tags.
- *
- *     sentori.setTag('rollout', 'dark-mode-v2');
- *     sentori.captureException(err);  // event.tags carries rollout
- */
-export declare const setTag: (key: string, value: string) => void;
-/**
- * v2.0 — bulk variant of setTag. Existing tags are merged with
- * the input record (`Object.assign` style).
- */
-export declare const setTags: (record: Record<string, string>) => void;
-export declare const __resetScopeForTests: () => void;
-export declare const __resetScreenshotBudgetForTests: () => void;
-/**
- * Attach a stable user identifier to events captured after this call.
- *
- * PII policy (Phase 16 sub-D): the User shape is intentionally limited
- * to `{ id?, anonymous? }` — no email, name, IP, or other identifying
- * fields. Use a hashed / pseudonymous id (e.g. uuid v4 stored in
- * AsyncStorage on first launch). The server schema enforces the same
- * shape, so any extra fields you tack on at the JS layer would be
- * rejected with `validationFailed` and never persisted.
- *
- * Pass `null` to clear (e.g. on sign-out).
- */
-/**
- * Public user identity API.
- *
- *   sentori.setUser({ id: 'usr_123', name: 'Lihao', linkBy: {
- *     email: 'lihao@example.com',
- *     googleSub: '108293…',
- *   } })
- *
- * The `linkBy` map is for **cross-project lookup** (see v2.3 design,
- * §5 in docs/design/sdk-v2.3-redesign.md). Each value gets hashed
- * client-side via `crypto.subtle.digest('SHA-256', …)` BEFORE
- * leaving the device. Raw email / phone / sub **never** reach
- * Sentori; the server can't recover them.
- *
- * Hashing is async (WebCrypto is async). `setUser` itself returns
- * void synchronously so host code stays one-line; the hash work
- * runs in the background and is committed to scope when ready. If
- * a `captureException` fires BEFORE the hash settles, the event
- * carries `id` + `name` only (no linkHashes that cycle) — the next
- * event picks them up. This is fine in practice because the host
- * sets the user once near startup, well before any captures.
- *
- * If `crypto.subtle` is unavailable in the runtime, the hash
- * promise rejects and `linkBy` is silently dropped (NEVER rule —
- * SDK failure must not propagate to host code).
- */
-type SetUserInput = (User & {
-    linkBy?: LinkBy;
-}) | null;
-export declare const setUser: (input: SetUserInput) => void;
-export declare const getUser: () => User | null;
-/** v1.1 +S7 升级 — read just the current user id for the control
- *  channel poll. Returns `undefined` until `setUser({ id })` runs. */
-export declare const getCurrentUserId: () => string | undefined;
-export type CaptureExtras = {
-    tags?: Tags;
-    user?: User;
-    fingerprint?: string[];
-    /** Phase 42 sub-D.07: per-call screenshot override. `false` skips
-     *  screenshot capture even when `init({ capture: { screenshot:
-     *  true } })` is on — handy for sensitive screens. Defaults to
-     *  whatever `config.screenshotsEnabled` says. */
-    screenshot?: boolean;
-};
-/**
- * v0.8.2 — submit an end-user-supplied bug report. Use this when the
- * host app surfaces a "Report a problem" form. Pass `eventId` if the
- * user is reporting a specific crash they just saw — the server links
- * the report to that event's issue automatically.
- *
- * Returns `{ id, issueId }` on success or `null` on any failure
- * (network down, ingest token revoked, validation rejected). Doesn't
- * throw.
- */
-export declare const sendUserFeedback: (input: {
-    body: string;
-    email?: string;
-    eventId?: string;
-    name?: string;
-    title: string;
-}) => Promise<null | {
-    id: string;
-    issueId: null | string;
-}>;
-export declare const captureError: (error: Error, extras?: CaptureExtras) => void;
-declare function applyBeforeSend(event: Event, hook: BeforeSendHook | undefined): Event | null;
-/** v0.9.6 #2 — upload the wireframe replay ring as a `replay`
- *  attachment. Plain NDJSON (one snapshot per line) — server may
- *  gzip on storage; the network upload is base64.
- *
- *  rc.4: route through `base64Utf8` so non-Latin-1 text inside any
- *  walked TextView (Japanese / Chinese / em-dash etc.) doesn't blow
- *  up the Hermes-spec `btoa`. The pre-rc.4 inline `btoa(ndjson)` path
- *  threw `InvalidCharacterError` on those code points, the
- *  surrounding catch swallowed it silently, and the replay
- *  attachment never landed. Insight 2026-05-18 verify caught it
- *  after rc.3's walker fix surfaced deep TextView content. Dev
- *  logs replace the silent catch so the next failure shape is
- *  visible. */
-declare function captureAndAttachReplay(event: Event, ndjson: string): Promise<void>;
-export declare const captureException: (error: Error, extras?: CaptureExtras) => void;
-/**
- * Manually report an issue without an Error instance.
- *
- * Routes to the dashboard Issues module — distinct from `track`
- * (analytics) and `recordMetric` (numeric). Use for "operator should
- * look at this" signals: a fallback that fired, an unexpected state,
- * a feature flag rollout that crossed a threshold.
- *
- *     sentori.captureMessage('Payment provider returned 500, used fallback')
- *     sentori.captureMessage('Detected impossible state in session reducer', {
- *       level: 'error',
- *       tags: { reducer: 'session' },
- *     })
- *
- * Wrapped in `safeFn` per the NEVER rule — any internal failure is
- * swallowed and (optionally) self-reported; the host app never sees
- * a thrown error.
- */
-export declare const captureMessage: (message: string, opts?: CaptureMessageOptions | undefined) => void | undefined;
-/** rc.4 — test hook. The real replay attach path is internal so we
- *  don't bloat the public surface, but the encoding bug Insight hit
- *  on 2026-05-18 needs a behaviour-level test that exercises the
- *  same code path captureException runs in production. */
-export declare const __captureAndAttachReplayForTests: typeof captureAndAttachReplay;
-/** v2.3 — test hook for the beforeSend dispatcher. The dispatcher
- *  is internal so the unit test reaches it directly without
- *  needing to stub the whole transport pipeline. */
-export declare const __applyBeforeSendForTests: typeof applyBeforeSend;
-//# sourceMappingURL=capture.d.ts.map

package/lib/capture.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../src/capture.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,cAAc,EACnB,KAAK,qBAAqB,EAE1B,KAAK,MAAM,EAMZ,MAAM,wBAAwB,CAAC;AAuBhC,OAAO,KAAK,EAA+B,KAAK,EAAgB,IAAI,EAAE,IAAI,EAAE,MAAM,SAAS,CAAC;AAE5F,OAAO,EAAE,WAAW,EAAE,oBAAoB,EAAE,MAAM,SAAS,CAAC;AAW5D;;;;;;GAMG;AACH,eAAO,MAAM,MAAM,GAAI,KAAK,MAAM,EAAE,OAAO,MAAM,KAAG,IAEnD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,OAAO,GAAI,QAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,IAExD,CAAC;AAQF,eAAO,MAAM,oBAAoB,QAAO,IAGvC,CAAC;AAYF,eAAO,MAAM,+BAA+B,QAAO,IAElD,CAAC;AAEF;;;;;;;;;;;GAWG;AACH;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,KAAK,YAAY,GAAG,CAAC,IAAI,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,IAAI,CAAC;AAExD,eAAO,MAAM,OAAO,GAAI,OAAO,YAAY,KAAG,IA2B7C,CAAC;AAEF,eAAO,MAAM,OAAO,QAAO,IAAI,GAAG,IAAa,CAAC;AAEhD;sEACsE;AACtE,eAAO,MAAM,gBAAgB,QAAO,MAAM,GAAG,SAAmC,CAAC;AAEjF,MAAM,MAAM,aAAa,GAAG;IAC1B,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB;;;qDAGiD;IACjD,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,GAAU,OAAO;IAC5C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;CACf,KAAG,OAAO,CAAC,IAAI,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,IAAI,GAAG,MAAM,CAAA;CAAE,CAKxD,CAAC;AAEF,eAAO,MAAM,YAAY,GAAI,OAAO,KAAK,EAAE,SAAS,aAAa,KAAG,IA2GnE,CAAC;AAUF,iBAAS,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,cAAc,GAAG,SAAS,GAAG,KAAK,GAAG,IAAI,CAwBrF;AAED;;;;;;;;;;;;eAYe;AACf,iBAAe,sBAAsB,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAyBjF;AAwDD,eAAO,MAAM,gBAAgB,UA7OO,KAAK,WAAW,aAAa,KAAG,IA6OxB,CAAC;AAI7C;;;;;;;;;;;;;;;;;GAiBG;AACH,eAAO,MAAM,cAAc,iFAuC1B,CAAC;AAEF;;;0DAG0D;AAC1D,eAAO,MAAM,gCAAgC,+BAAyB,CAAC;AAEvE;;oDAEoD;AACpD,eAAO,MAAM,yBAAyB,wBAAkB,CAAC"}