@goliapkg/sentori-react-native 1.2.0 → 2.0.0

package/README.md

@@ -1,5 +1,65 @@
-# @sentori/react-native
+# @goliapkg/sentori-react-native
 
-React Native SDK — JS / iOS native / Android native error capture.
+React Native SDK for [Sentori](https://sentori.golia.jp) — JS layer
++ iOS Swift + Android Kotlin native, distributed as an Expo module
+(works on bare RN too).
 
-JS layer in **Phase 3**, native layers in **Phase 7**. Currently a placeholder.
+## Install
+
+```sh
+bun add @goliapkg/sentori-react-native
+cd ios && pod install --repo-update
+```
+
+## Use
+
+```tsx
+import { sentori } from '@goliapkg/sentori-react-native'
+
+sentori.init({
+  token: 'st_pk_…',
+  release: 'my-app@1.2.3',
+  environment: 'prod',
+  capture: {
+    replay: { mode: 'wireframe', hz: 1 },
+  },
+})
+
+sentori.captureException(new Error('boom'))
+```
+
+Auto-wired:
+
+- JS `error` / `unhandledrejection` global hooks
+- iOS `NSException` handler primed by `init`
+- Android uncaught exception handler primed by `init`
+- Native screenshot + view-tree capture under JS-supplied mask IDs
+- Hang watchdog (main blocked > 2s emits `kind: "anr"`)
+- Wireframe replay sampler (60 slots × ~120 bytes/frame at idle)
+
+## Cross-project user lookup (PII-safe)
+
+```ts
+sentori.setUser({ linkBy: { email: user.email } })
+```
+
+Identity is hashed on-device with a per-org salt. The server never
+sees the raw email / phone.
+
+## Sentry compat drop-in
+
+```ts
+import * as Sentry from '@goliapkg/sentori-react-native/compat'
+
+Sentry.init({ dsn: 'st_pk_…' })
+Sentry.captureException(err)
+```
+
+→ Full guide: [sentori.golia.jp/docs/getting-started/react-native](https://sentori.golia.jp/docs/getting-started/react-native)
+→ Privacy contract: [sentori.golia.jp/docs/privacy/identity](https://sentori.golia.jp/docs/privacy/identity)
+→ Sentry translation: [sentori.golia.jp/docs/sentry-compat](https://sentori.golia.jp/docs/sentry-compat)
+
+## License
+
+Dual-licensed under [Apache-2.0](../../LICENSE-APACHE) OR
+[MIT](../../LICENSE-MIT).

package/lib/compat/sentry.d.ts

@@ -0,0 +1,112 @@
+/**
+ * v2.3 W6.3 — Sentry-compatible API surface.
+ *
+ * Drop-in for code (or LLM-generated code) written against
+ * `@sentry/react-native`. Every Sentry call maps to exactly one
+ * Sentori-native call internally. Translation differences (e.g.
+ * `Sentry.setUser({ ip_address })` — Sentori never stores IP) fire
+ * a one-shot console hint at `info` level, deduplicated per
+ * (api, dropped_field).
+ *
+ * Why this exists: LLMs have seen a LOT of Sentry code; letting
+ * them write the same syntax against Sentori is one less thing
+ * Sentori asks the host to think about. Combined with the v2.3
+ * "free bonus" stance — host adds Sentori without unlearning
+ * anything.
+ *
+ * Usage:
+ *
+ *   import * as Sentry from '@goliapkg/sentori-react-native/compat'
+ *
+ *   Sentry.init({ dsn: 'https://<token>@<host>/<projectId>', ... })
+ *   Sentry.captureException(err)
+ *   Sentry.setUser({ id, email })   // email → linkBy.email (hashed)
+ *
+ * The compat layer holds NO state of its own — it's a thin shim
+ * over the same Sentori internals. Mixing `Sentry.*` and
+ * `sentori.*` calls in the same app works fine.
+ *
+ * See `docs/design/sdk-v2.3-redesign.md` §4 for the full
+ * translation table + design rationale.
+ */
+type SentryInitOpts = {
+    dsn: string;
+    environment?: string;
+    release?: string;
+    tracesSampleRate?: number;
+    sampleRate?: number;
+    attachStacktrace?: boolean;
+    autoSessionTracking?: boolean;
+    /** Sentry's `debug: true` ≈ Sentori's `logLevel: 'debug'`. */
+    debug?: boolean;
+    /** Catch-all for fields Sentori either ignores or doesn't map yet. */
+    [other: string]: unknown;
+};
+export declare function init(opts: SentryInitOpts): void;
+/** Sentry's severity values, surfaced as strings (Sentori only
+ *  uses 5 levels). `Log` and `Critical` collapse to `'info'` and
+ *  `'fatal'` respectively. */
+export declare const Severity: {
+    Fatal: "fatal";
+    Critical: "fatal";
+    Error: "error";
+    Warning: "warning";
+    Log: "info";
+    Info: "info";
+    Debug: "debug";
+};
+type SentryLevelString = 'critical' | 'debug' | 'error' | 'fatal' | 'info' | 'log' | 'warning';
+type SentryCaptureContext = {
+    tags?: Record<string, string>;
+    extra?: Record<string, unknown>;
+    level?: SentryLevelString;
+    fingerprint?: string[];
+    user?: SentrySetUserInput;
+};
+export declare function captureException(err: unknown, hint?: {
+    captureContext?: SentryCaptureContext;
+} | SentryCaptureContext): void;
+export declare function captureMessage(msg: string, levelOrCtx?: SentryCaptureContext | SentryLevelString): void;
+type SentrySetUserInput = {
+    id?: string;
+    email?: string;
+    username?: string;
+    ip_address?: string;
+    segment?: string;
+    [other: string]: unknown;
+} | null;
+export declare function setUser(user: SentrySetUserInput): void;
+export declare const setTag: (key: string, value: string) => void;
+export declare const setTags: (record: Record<string, string>) => void;
+type SentryBreadcrumb = {
+    category?: string;
+    message?: string;
+    level?: SentryLevelString;
+    type?: 'default' | 'error' | 'http' | 'info' | 'navigation' | 'query' | 'user' | string;
+    data?: Record<string, unknown>;
+    timestamp?: number;
+};
+export declare function addBreadcrumb(crumb: SentryBreadcrumb): void;
+export { close, flush } from '../lifecycle';
+type SentrySpanOpts = {
+    op?: string;
+    name?: string;
+    description?: string;
+    tags?: Record<string, string>;
+};
+export declare function startTransaction(opts: SentrySpanOpts): {
+    finish: (status?: 'cancelled' | 'error' | 'ok') => void;
+    setStatus: (status: 'cancelled' | 'error' | 'ok') => void;
+    setTag: (k: string, v: string) => void;
+    startChild: (childOpts: SentrySpanOpts) => unknown;
+};
+type ScopeProxy = {
+    setTag: (k: string, v: string) => void;
+    setTags: (rec: Record<string, string>) => void;
+    setUser: (u: SentrySetUserInput) => void;
+    setExtra: (k: string, v: unknown) => void;
+    setLevel: (l: SentryLevelString) => void;
+};
+export declare function withScope<T>(fn: (scope: ScopeProxy) => T): T;
+export declare function configureScope(fn: (scope: ScopeProxy) => void): void;
+//# sourceMappingURL=sentry.d.ts.map

package/lib/compat/sentry.d.ts.map

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

package/lib/compat/sentry.js

@@ -0,0 +1,326 @@
+/**
+ * v2.3 W6.3 — Sentry-compatible API surface.
+ *
+ * Drop-in for code (or LLM-generated code) written against
+ * `@sentry/react-native`. Every Sentry call maps to exactly one
+ * Sentori-native call internally. Translation differences (e.g.
+ * `Sentry.setUser({ ip_address })` — Sentori never stores IP) fire
+ * a one-shot console hint at `info` level, deduplicated per
+ * (api, dropped_field).
+ *
+ * Why this exists: LLMs have seen a LOT of Sentry code; letting
+ * them write the same syntax against Sentori is one less thing
+ * Sentori asks the host to think about. Combined with the v2.3
+ * "free bonus" stance — host adds Sentori without unlearning
+ * anything.
+ *
+ * Usage:
+ *
+ *   import * as Sentry from '@goliapkg/sentori-react-native/compat'
+ *
+ *   Sentry.init({ dsn: 'https://<token>@<host>/<projectId>', ... })
+ *   Sentry.captureException(err)
+ *   Sentry.setUser({ id, email })   // email → linkBy.email (hashed)
+ *
+ * The compat layer holds NO state of its own — it's a thin shim
+ * over the same Sentori internals. Mixing `Sentry.*` and
+ * `sentori.*` calls in the same app works fine.
+ *
+ * See `docs/design/sdk-v2.3-redesign.md` §4 for the full
+ * translation table + design rationale.
+ */
+import { logger } from '@goliapkg/sentori-core';
+import { addBreadcrumb as nativeAddBreadcrumb } from '../breadcrumbs';
+import { captureException as nativeCaptureException, captureMessage as nativeCaptureMessage, setTag as nativeSetTag, setTags as nativeSetTags, setUser as nativeSetUser, } from '../capture';
+import { init as nativeInit } from '../init';
+// ── one-shot warn dedup ───────────────────────────────────────────────────
+const _warnedOnce = new Set();
+function warnOnce(key, msg) {
+    if (_warnedOnce.has(key))
+        return;
+    _warnedOnce.add(key);
+    logger.info('compat', msg);
+}
+function parseDsn(dsn) {
+    // Sentry DSN shape: `https://<key>@<host>[:port][/<projectId>]`
+    // Sentori cares about `<key>` (must be `st_pk_…`) and `<host>`.
+    let url;
+    try {
+        url = new URL(dsn);
+    }
+    catch {
+        throw new Error(`Sentory compat: dsn is not a valid URL: ${dsn}`);
+    }
+    const key = url.username;
+    if (!key) {
+        throw new Error(`Sentory compat: dsn missing token in user-info component`);
+    }
+    if (!key.startsWith('st_pk_')) {
+        throw new Error(`Sentory compat: dsn token must start with 'st_pk_' (got prefix '${key.slice(0, 8)}…'). ` +
+            `Sentori does not parse Sentry-issued tokens — generate a Sentori project token via the dashboard.`);
+    }
+    // strip user-info to reconstruct the ingest origin
+    const ingestUrl = `${url.protocol}//${url.host}`;
+    return { token: key, ingestUrl };
+}
+// ── Sentry.init ───────────────────────────────────────────────────────────
+export function init(opts) {
+    const { token, ingestUrl } = parseDsn(opts.dsn);
+    const sentoriOpts = {
+        token,
+        release: opts.release ?? '',
+        ingestUrl,
+        ...(opts.environment ? { environment: opts.environment } : {}),
+        sample: {
+            ...(opts.tracesSampleRate !== undefined ? { traces: opts.tracesSampleRate } : {}),
+            ...(opts.sampleRate !== undefined ? { errors: opts.sampleRate } : {}),
+        },
+        ...(opts.debug ? { logLevel: 'debug' } : {}),
+    };
+    // Empty release is the most common Sentry-init mistake; warn but
+    // continue.
+    if (!sentoriOpts.release) {
+        warnOnce('init:no-release', 'Sentry.init() with no `release` — Sentori requires release for grouping + drop-down menus to make sense. Set `release: "myapp@1.2.3"` for production cuts.');
+        // Sentori's init throws when release is empty; provide a
+        // reasonable fallback so the rest of the code path works in dev.
+        sentoriOpts.release = `unspecified@${Date.now()}`;
+    }
+    // Pass-through informational hints for ignored fields.
+    for (const ignored of [
+        'attachStacktrace',
+        'autoSessionTracking',
+        'integrations',
+        'beforeSend',
+        'beforeBreadcrumb',
+        'maxBreadcrumbs',
+    ]) {
+        if (ignored in opts) {
+            warnOnce(`init:ignored:${ignored}`, `Sentry.init({ ${ignored} }) ignored. ` +
+                `${getIgnoredHint(ignored)}`);
+        }
+    }
+    nativeInit(sentoriOpts);
+}
+function getIgnoredHint(field) {
+    switch (field) {
+        case 'attachStacktrace':
+            return 'Sentori always sends stack traces — no toggle.';
+        case 'autoSessionTracking':
+            return "Sentori sessions are on by default; toggle via `init({ capture: { sessions: true|false } })`.";
+        case 'integrations':
+            return 'Sentori uses `init({ capture: {...} })` toggles instead of Integration classes — see the docs.';
+        case 'beforeSend':
+        case 'beforeBreadcrumb':
+            return 'Sentori does not support an arbitrary beforeSend hook today. Server-side PII scrubbing is automatic.';
+        case 'maxBreadcrumbs':
+            return 'Sentori uses a fixed 100-slot ring buffer.';
+        default:
+            return '';
+    }
+}
+// ── Severity / level enum ─────────────────────────────────────────────────
+/** Sentry's severity values, surfaced as strings (Sentori only
+ *  uses 5 levels). `Log` and `Critical` collapse to `'info'` and
+ *  `'fatal'` respectively. */
+export const Severity = {
+    Fatal: 'fatal',
+    Critical: 'fatal',
+    Error: 'error',
+    Warning: 'warning',
+    Log: 'info',
+    Info: 'info',
+    Debug: 'debug',
+};
+function mapLevel(level) {
+    if (!level)
+        return undefined;
+    switch (level) {
+        case 'critical':
+            warnOnce('severity:critical', "Sentry.Severity.Critical → mapped to 'fatal' (Sentori's 5-level syslog-style scale).");
+            return 'fatal';
+        case 'log':
+            warnOnce('severity:log', "Sentry.Severity.Log → mapped to 'info' (Sentori's 5-level scale has no separate Log).");
+            return 'info';
+        default:
+            return level;
+    }
+}
+export function captureException(err, hint) {
+    // Sentry v8+ takes the context inline (Hint); earlier versions
+    // wrapped it in `{ captureContext: {...} }`. Accept both.
+    const ctx = (() => {
+        if (!hint)
+            return undefined;
+        if ('captureContext' in hint) {
+            return hint.captureContext;
+        }
+        return hint;
+    })();
+    if (ctx?.extra) {
+        warnOnce('captureException:extra', 'Sentry.captureException(err, { extra }) → `extra` mapped to `tags` (Sentori does not have a separate extra namespace).');
+    }
+    if (ctx?.user) {
+        // Apply the per-call user via setUser (Sentori takes the
+        // current scope user automatically).
+        setUser(ctx.user);
+    }
+    const mergedTags = {
+        ...(ctx?.tags ?? {}),
+        ...(ctx?.extra
+            ? Object.fromEntries(Object.entries(ctx.extra).map(([k, v]) => [k, String(v)]))
+            : {}),
+    };
+    nativeCaptureException(err, {
+        ...(Object.keys(mergedTags).length > 0 ? { tags: mergedTags } : {}),
+        ...(ctx?.fingerprint ? { fingerprint: ctx.fingerprint } : {}),
+    });
+}
+// ── captureMessage ────────────────────────────────────────────────────────
+export function captureMessage(msg, levelOrCtx) {
+    let level;
+    let tags;
+    if (typeof levelOrCtx === 'string') {
+        level = mapLevel(levelOrCtx);
+    }
+    else if (levelOrCtx) {
+        level = mapLevel(levelOrCtx.level);
+        tags = levelOrCtx.tags;
+    }
+    nativeCaptureMessage(msg, {
+        ...(level ? { level } : {}),
+        ...(tags ? { tags } : {}),
+    });
+}
+export function setUser(user) {
+    if (user == null) {
+        nativeSetUser(null);
+        return;
+    }
+    const { id, email, username, ip_address, segment, ...rest } = user;
+    if (ip_address !== undefined) {
+        warnOnce('setUser:ip_address', 'Sentry.setUser({ ip_address }) → dropped. Sentori never stores IP (privacy by design).');
+    }
+    if (segment !== undefined) {
+        warnOnce('setUser:segment', 'Sentry.setUser({ segment }) → mapped to tag `user.segment`. Set via setTag for clarity.');
+        if (typeof segment === 'string')
+            nativeSetTag('user.segment', segment);
+    }
+    const linkBy = {};
+    if (email)
+        linkBy.email = email;
+    if (username)
+        linkBy.username = username;
+    // Surface any other fields the host bolted on (Sentry historically
+    // accepted arbitrary keys) — they pass through as tags.
+    for (const [k, v] of Object.entries(rest)) {
+        if (v !== undefined && v !== null)
+            nativeSetTag(`user.${k}`, String(v));
+    }
+    nativeSetUser({
+        ...(id ? { id } : {}),
+        ...(Object.keys(linkBy).length > 0 ? { linkBy } : {}),
+    });
+}
+// ── setTag / setTags ──────────────────────────────────────────────────────
+// Re-export Sentori-native semantics; identical signatures.
+export const setTag = nativeSetTag;
+export const setTags = nativeSetTags;
+function mapCategoryToType(category) {
+    if (!category)
+        return undefined;
+    if (['auth', 'click', 'gesture', 'input', 'touch', 'ui'].includes(category))
+        return 'user';
+    if (['fetch', 'http', 'xhr'].includes(category))
+        return 'net';
+    if (['nav', 'navigation', 'route'].includes(category))
+        return 'nav';
+    if (['console', 'log', 'sentry'].includes(category))
+        return 'log';
+    return 'custom';
+}
+function mapSentryType(t) {
+    if (!t)
+        return undefined;
+    switch (t) {
+        case 'http':
+            return 'net';
+        case 'navigation':
+            return 'nav';
+        case 'user':
+        case 'log':
+        case 'custom':
+            return t;
+        default:
+            return 'custom';
+    }
+}
+export function addBreadcrumb(crumb) {
+    if (!crumb.message) {
+        crumb.message = crumb.category ?? crumb.type ?? '(no message)';
+    }
+    if (crumb.category && !crumb.type) {
+        warnOnce('breadcrumb:category', 'Sentry.addBreadcrumb({ category }) → mapped to `type` via well-known table; the category string itself is preserved under `data.category`.');
+    }
+    // RN SDK shape: { type, data }. No top-level `message` —
+    // Sentry's message goes into data.message.
+    nativeAddBreadcrumb({
+        type: mapSentryType(crumb.type) ?? mapCategoryToType(crumb.category) ?? 'custom',
+        data: {
+            message: crumb.message,
+            ...(crumb.data ?? {}),
+            ...(crumb.category ? { category: crumb.category } : {}),
+            ...(crumb.level ? { level: mapLevel(crumb.level) } : {}),
+        },
+    });
+}
+// ── flush / close ─────────────────────────────────────────────────────────
+// Re-export Sentori native flush + close — same signatures.
+export { close, flush } from '../lifecycle';
+// ── startTransaction / startSpan / withScope ──────────────────────────────
+// Trace mapping is non-trivial (Sentry's transaction object exposes
+// startChild, etc.). v2.3 ships a minimum-viable Sentry trace
+// surface that supports startTransaction returning a Sentori Span
+// object with a partial Sentry-style API (.startChild, .finish).
+// Anything beyond that throws a clear error directing to the native
+// `sentori.startSpan` / `sentori.withScopedSpan`.
+import { startSpan } from '@goliapkg/sentori-core';
+export function startTransaction(opts) {
+    warnOnce('startTransaction', 'Sentry.startTransaction() → mapped to sentori.startSpan() with op as name. Native equivalent: sentori.startTrace(name) or sentori.startSpan({ name }).');
+    const name = opts.name ?? opts.op ?? 'transaction';
+    const span = startSpan(name, {
+        parent: null,
+        tags: opts.tags,
+    });
+    return {
+        finish: (status) => span.finish({ status: status === 'ok' ? 'ok' : 'error' }),
+        setStatus: (status) => { span.setTag('status', status); },
+        setTag: (k, v) => { span.setTag(k, v); },
+        startChild: (childOpts) => {
+            return startSpan(childOpts.name ?? childOpts.op ?? 'child', {
+                tags: childOpts.tags,
+            });
+        },
+    };
+}
+function scopeProxy() {
+    return {
+        setTag: nativeSetTag,
+        setTags: nativeSetTags,
+        setUser,
+        setExtra: (k, v) => nativeSetTag(`extra.${k}`, String(v)),
+        setLevel: () => {
+            warnOnce('scope:setLevel', 'Sentry.withScope(s => s.setLevel(…)) → not supported. Sentori levels travel on capture call, not on scope.');
+        },
+    };
+}
+export function withScope(fn) {
+    // Sentori has no Hub; tags set inside `fn` persist (best-effort
+    // approximation of Sentry semantics). For most callers this is
+    // fine; tighter isolation needs an actual Hub which we don't ship.
+    warnOnce('withScope', 'Sentry.withScope() → tag mutations are NOT auto-reverted on scope exit. Use sentori.setTag/clearTags explicitly for tight isolation.');
+    return fn(scopeProxy());
+}
+export function configureScope(fn) {
+    fn(scopeProxy());
+}
+//# sourceMappingURL=sentry.js.map

package/lib/compat/sentry.js.map

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

package/lib/config.d.ts

@@ -37,6 +37,11 @@ export type Config = {
      *  session-trail buffer and uploads it as a `sessionTrail`
      *  attachment. Defaults to false. */
     sessionTrailEnabled: boolean;
+    /** v2.0 W3 — when true, every `track(name, props)` call also
+     *  pushes a `{ type: 'track', data: { name, props } }` breadcrumb
+     *  so a subsequent capture carries the customer journey. Defaults
+     *  to false to preserve v1 customer breadcrumb shape on upgrade. */
+    trackAutoBreadcrumb: boolean;
     /** v2.3 — Sentori console output gate.
      *
      *  Default `warn`: SDK is silent on host's console unless

package/lib/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB;sEACkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;wDAEoD;IACpD,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,kBAAkB,EAAE,OAAO,CAAC;IAC5B;8CAC0C;IAC1C,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC;IAC/B,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC;IAC/B;yDACqD;IACrD,iBAAiB,EAAE,IAAI,GAAG,MAAM,CAAC;IACjC;;yCAEqC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B;;;;;;;;mEAQ+D;IAC/D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;4CAGwC;IACxC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACrC,CAAC;AAIF,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAE1C,CAAC;AAEF,eAAO,MAAM,SAAS,QAAO,MAAM,GAAG,IAAe,CAAC;AAEtD,eAAO,MAAM,aAAa,QAAO,OAA2B,CAAC;AAE7D,eAAO,MAAM,eAAe,QAAO,IAElC,CAAC"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;;GAIG;AACH,MAAM,MAAM,SAAS,GAAG;IACtB,2DAA2D;IAC3D,UAAU,EAAE,MAAM,CAAC;IACnB;sEACkE;IAClE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB;;wDAEoD;IACpD,MAAM,EAAE;QAAE,KAAK,EAAE,OAAO,CAAC;QAAC,OAAO,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;CAC/C,CAAC;AAEF,MAAM,MAAM,MAAM,GAAG;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,wEAAwE;IACxE,kBAAkB,EAAE,OAAO,CAAC;IAC5B;8CAC0C;IAC1C,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC;IAC/B,eAAe,EAAE,IAAI,GAAG,MAAM,CAAC;IAC/B;yDACqD;IACrD,iBAAiB,EAAE,IAAI,GAAG,MAAM,CAAC;IACjC;;yCAEqC;IACrC,mBAAmB,EAAE,OAAO,CAAC;IAC7B;;;wEAGoE;IACpE,mBAAmB,EAAE,OAAO,CAAC;IAC7B;;;;;;;;mEAQ+D;IAC/D,QAAQ,CAAC,EAAE,QAAQ,CAAC;IACpB;;;4CAGwC;IACxC,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACrC,CAAC;AAIF,eAAO,MAAM,SAAS,GAAI,QAAQ,MAAM,KAAG,IAE1C,CAAC;AAEF,eAAO,MAAM,SAAS,QAAO,MAAM,GAAG,IAAe,CAAC;AAEtD,eAAO,MAAM,aAAa,QAAO,OAA2B,CAAC;AAE7D,eAAO,MAAM,eAAe,QAAO,IAElC,CAAC"}

package/lib/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAuDA,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAc,EAAQ,EAAE;IAChD,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,GAAkB,EAAE,CAAC,OAAO,CAAC;AAEtD,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG,GAAS,EAAE;IACxC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC,CAAC"}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AA4DA,IAAI,OAAO,GAAkB,IAAI,CAAC;AAElC,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,MAAc,EAAQ,EAAE;IAChD,OAAO,GAAG,MAAM,CAAC;AACnB,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,SAAS,GAAG,GAAkB,EAAE,CAAC,OAAO,CAAC;AAEtD,MAAM,CAAC,MAAM,aAAa,GAAG,GAAY,EAAE,CAAC,OAAO,KAAK,IAAI,CAAC;AAE7D,MAAM,CAAC,MAAM,eAAe,GAAG,GAAS,EAAE;IACxC,OAAO,GAAG,IAAI,CAAC;AACjB,CAAC,CAAC"}

package/lib/feedback.d.ts

@@ -0,0 +1,2 @@
+export { FeedbackButton, type FeedbackButtonHandle, type FeedbackButtonProps, } from './feedback-widget';
+//# sourceMappingURL=feedback.d.ts.map

package/lib/feedback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.d.ts","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAgBA,OAAO,EACL,cAAc,EACd,KAAK,oBAAoB,EACzB,KAAK,mBAAmB,GACzB,MAAM,mBAAmB,CAAA"}

package/lib/feedback.js

@@ -0,0 +1,17 @@
+// v2.0 W3 — `feedback` subpath. The feedback widget pulls in a
+// component tree (react + tsx) and an internal viewer route, so
+// importing it eagerly from the SDK's top-level barrel pays a
+// bundle cost every consumer pays — even ones that never render
+// the widget.
+//
+// Subpath import `@goliapkg/sentori-react-native/feedback`
+// resolves to just the widget surface. Hosts that don't render
+// the feedback button pay zero bundle delta; hosts that do reach
+// for it import via this module and get exactly what they need.
+//
+// Top-level (`index.ts`) still re-exports `FeedbackButton` for one
+// more release cycle so v1 callsites don't break on upgrade. v3
+// will drop the top-level re-export — see
+// `docs/recipes/v1-to-v2-migration.md` for the deprecation timeline.
+export { FeedbackButton, } from './feedback-widget';
+//# sourceMappingURL=feedback.js.map

package/lib/feedback.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"feedback.js","sourceRoot":"","sources":["../src/feedback.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,gEAAgE;AAChE,8DAA8D;AAC9D,gEAAgE;AAChE,cAAc;AACd,EAAE;AACF,2DAA2D;AAC3D,+DAA+D;AAC/D,iEAAiE;AACjE,gEAAgE;AAChE,EAAE;AACF,mEAAmE;AACnE,gEAAgE;AAChE,0CAA0C;AAC1C,qEAAqE;AAErE,OAAO,EACL,cAAc,GAGf,MAAM,mBAAmB,CAAA"}

package/lib/init.d.ts

@@ -39,6 +39,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`
@@ -100,6 +108,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

package/lib/init.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,KAAK,SAAS,EAAa,MAAM,UAAU,CAAC;AAerD,OAAO,EAAkB,KAAK,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAKpE,OAAO,EAAyB,KAAK,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAUnF,OAAO,KAAK,EAAkB,cAAc,EAA2B,MAAM,SAAS,CAAC;AAIvF,MAAM,MAAM,WAAW,GAAG;IACxB,sDAAsD;IACtD,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,OAAO,EAAE,MAAM,CAAC;IAChB,sEAAsE;IACtE,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,qFAAqF;IACrF,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,OAAO,CAAC,EAAE;QACR,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB,iBAAiB,CAAC,EAAE,OAAO,CAAC;QAC5B,OAAO,CAAC,EACJ,OAAO,GACP;YACE;;qEAEyD;YACzD,OAAO,CAAC,EAAE,OAAO,CAAC;SACnB,CAAC;QACN;;8DAEsD;QACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;QACnB;;;;;;;uBAOe;QACf,UAAU,CAAC,EAAE,OAAO,CAAC;QACrB;;;6CAGqC;QACrC,YAAY,CAAC,EAAE,OAAO,CAAC;QACvB;;;;6CAIqC;QACrC,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAC3B,gBAAgB,CAAC,EAAE,eAAe,EAAE,CAAC;QACrC;;;;6CAIqC;QACrC,eAAe,CAAC,EAAE,OAAO,GAAG;YAAE,WAAW,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACrD;;;mEAG2D;QAC3D,MAAM,CAAC,EAAE,KAAK,GAAG,WAAW,GAAG;YAAE,EAAE,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,KAAK,GAAG,WAAW,CAAA;SAAE,CAAC;QAC1E;;;;uCAI+B;QAC/B,cAAc,CAAC,EAAE,OAAO,GAAG;YAAE,OAAO,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;QACnE;;;6DAGqD;QACrD,SAAS,CAAC,EAAE,OAAO,GAAG,gBAAgB,CAAC;QACvC;;;sEAG8D;QAC9D,gBAAgB,CAAC,EAAE;YACjB,OAAO,EAAE,OAAO,CAAC;YACjB,qBAAqB,CAAC,EAAE,CACtB,IAAI,EAAE,OAAO,sBAAsB,EAAE,eAAe,KAElD,OAAO,sBAAsB,EAAE,iBAAiB,GAChD,OAAO,CAAC,OAAO,sBAAsB,EAAE,iBAAiB,CAAC,CAAC;YAC9D,SAAS,CAAC,EAAE,MAAM,CAAC;YACnB,SAAS,CAAC,EAAE,MAAM,CAAC;SACpB,CAAC;KACH,CAAC;IACF;;;;;gEAK4D;IAC5D,QAAQ,CAAC,EAAE;QACT,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACvB,MAAM,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;QACvB;0EACkE;QAClE,QAAQ,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;KAC1B,CAAC;IACF;;;;8DAI0D;IAC1D,QAAQ,CAAC,EAAE,OAAO,wBAAwB,EAAE,QAAQ,CAAC;IACrD;;iEAE6D;IAC7D,OAAO,CAAC,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;CACrC,CAAC;AAIF,eAAO,MAAM,IAAI,GAAI,SAAS,WAAW,KAAG,IA6N3C,CAAC;AAqBF,YAAY,EAAE,cAAc,EAAE,CAAC"}
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"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"}

package/lib/init.js

@@ -50,10 +50,17 @@ export const init = (options) => {
         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
     // on the next NSException / Java uncaught carries release + env.