@goliapkg/sentori-react-native 1.2.0 → 1.3.0

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/init.d.ts

@@ -100,6 +100,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,9 +50,11 @@ 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,
     });
     // Tell the native crash handler about the config so the JSON it writes

package/lib/init.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@goliapkg/sentori-react-native",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Sentori SDK for React Native — JS-layer error capture, native crash handlers (iOS / Android), batched transport, fetch + react-navigation tracing.",
   "license": "MIT",
   "homepage": "https://sentori.golia.jp",
@@ -22,6 +22,17 @@
   ],
   "main": "lib/index.js",
   "types": "lib/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./lib/index.d.ts",
+      "default": "./lib/index.js"
+    },
+    "./compat": {
+      "types": "./lib/compat/sentry.d.ts",
+      "default": "./lib/compat/sentry.js"
+    },
+    "./package.json": "./package.json"
+  },
   "bin": {
     "sentori-rn-upload-source-bundle": "bin/sentori-rn-upload-source-bundle.cjs"
   },

package/src/compat/sentry.ts

@@ -0,0 +1,482 @@
+/**
+ * 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 { type InitOptions, init as nativeInit } from '../init'
+
+// ── one-shot warn dedup ───────────────────────────────────────────────────
+
+const _warnedOnce = new Set<string>()
+function warnOnce(key: string, msg: string): void {
+  if (_warnedOnce.has(key)) return
+  _warnedOnce.add(key)
+  logger.info('compat', msg)
+}
+
+// ── DSN parsing ───────────────────────────────────────────────────────────
+
+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
+}
+
+function parseDsn(dsn: string): { token: string; ingestUrl: string } {
+  // Sentry DSN shape: `https://<key>@<host>[:port][/<projectId>]`
+  // Sentori cares about `<key>` (must be `st_pk_…`) and `<host>`.
+  let url: 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: SentryInitOpts): void {
+  const { token, ingestUrl } = parseDsn(opts.dsn)
+
+  const sentoriOpts: InitOptions = {
+    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' as const } : {}),
+  }
+
+  // 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: string): string {
+  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' as const,
+  Critical: 'fatal' as const,
+  Error: 'error' as const,
+  Warning: 'warning' as const,
+  Log: 'info' as const,
+  Info: 'info' as const,
+  Debug: 'debug' as const,
+}
+
+type SentryLevelString =
+  | 'critical'
+  | 'debug'
+  | 'error'
+  | 'fatal'
+  | 'info'
+  | 'log'
+  | 'warning'
+
+type SentoriLevel = 'debug' | 'error' | 'fatal' | 'info' | 'warning'
+
+function mapLevel(level: SentryLevelString | undefined): SentoriLevel | undefined {
+  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 as SentoriLevel
+  }
+}
+
+// ── captureException ──────────────────────────────────────────────────────
+
+type SentryCaptureContext = {
+  tags?: Record<string, string>
+  extra?: Record<string, unknown>
+  level?: SentryLevelString
+  fingerprint?: string[]
+  user?: SentrySetUserInput
+}
+
+export function captureException(
+  err: unknown,
+  hint?: { captureContext?: SentryCaptureContext } | SentryCaptureContext,
+): void {
+  // Sentry v8+ takes the context inline (Hint); earlier versions
+  // wrapped it in `{ captureContext: {...} }`. Accept both.
+  const ctx: SentryCaptureContext | undefined = (() => {
+    if (!hint) return undefined
+    if ('captureContext' in (hint as { captureContext?: unknown })) {
+      return (hint as { captureContext?: SentryCaptureContext }).captureContext
+    }
+    return hint as SentryCaptureContext
+  })()
+
+  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 as Error, {
+    ...(Object.keys(mergedTags).length > 0 ? { tags: mergedTags } : {}),
+    ...(ctx?.fingerprint ? { fingerprint: ctx.fingerprint } : {}),
+  })
+}
+
+// ── captureMessage ────────────────────────────────────────────────────────
+
+export function captureMessage(
+  msg: string,
+  levelOrCtx?: SentryCaptureContext | SentryLevelString,
+): void {
+  let level: SentoriLevel | undefined
+  let tags: Record<string, string> | undefined
+  if (typeof levelOrCtx === 'string') {
+    level = mapLevel(levelOrCtx)
+  } else if (levelOrCtx) {
+    level = mapLevel(levelOrCtx.level)
+    tags = levelOrCtx.tags
+  }
+  nativeCaptureMessage(msg, {
+    ...(level ? { level } : {}),
+    ...(tags ? { tags } : {}),
+  })
+}
+
+// ── setUser ───────────────────────────────────────────────────────────────
+
+type SentrySetUserInput = {
+  id?: string
+  email?: string
+  username?: string
+  ip_address?: string
+  segment?: string
+  [other: string]: unknown
+} | null
+
+export function setUser(user: SentrySetUserInput): void {
+  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: Record<string, string> = {}
+  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
+
+// ── addBreadcrumb ─────────────────────────────────────────────────────────
+
+type SentryBreadcrumb = {
+  category?: string
+  message?: string
+  level?: SentryLevelString
+  type?: 'default' | 'error' | 'http' | 'info' | 'navigation' | 'query' | 'user' | string
+  data?: Record<string, unknown>
+  timestamp?: number
+}
+
+type SentoriBreadcrumbType = 'custom' | 'log' | 'nav' | 'net' | 'user'
+
+function mapCategoryToType(category: string | undefined): SentoriBreadcrumbType | undefined {
+  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: string | undefined): SentoriBreadcrumbType | undefined {
+  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: SentryBreadcrumb): void {
+  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'
+
+type SentrySpanOpts = {
+  op?: string
+  name?: string
+  description?: string
+  tags?: Record<string, string>
+}
+
+export 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
+} {
+  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,
+      })
+    },
+  }
+}
+
+// ── withScope / configureScope (no-op scoping; same state as native) ─────
+
+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
+}
+
+function scopeProxy(): 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<T>(fn: (scope: ScopeProxy) => T): T {
+  // 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: (scope: ScopeProxy) => void): void {
+  fn(scopeProxy())
+}

package/src/init.ts

@@ -130,6 +130,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,9 +191,11 @@ 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,
   });