@allstak/react-native 0.3.0 → 0.3.1

package/dist/index.d.mts

@@ -1,3 +1,5 @@
+import * as React from 'react';
+
 /**
  * Minimal HTTP transport for React Native. Uses the global `fetch` (always
  * present in RN >= 0.60) with a 3s timeout. Failed sends fall into a small
@@ -296,9 +298,36 @@ interface HttpTrackingOptions {
     maxBodyBytes?: number;
 }
 
+/**
+ * Per-console-method capture flags. Defaults are set to keep the
+ * dashboard signal-to-noise high: `warn` and `error` capture by default
+ * (most apps fire those at human-meaningful moments), `log` and `info`
+ * are OFF by default since typical apps log thousands of debug lines
+ * per session.
+ *
+ * Override per-method:
+ *
+ *   <AllStakProvider captureConsole={{ log: true, info: true }} />
+ *
+ * Or to fully suppress:
+ *
+ *   <AllStakProvider captureConsole={{ warn: false, error: false }} />
+ *
+ * Setting `autoConsoleBreadcrumbs={false}` on the provider/install is a
+ * higher-level kill switch — it skips wrapping any console method.
+ */
+interface ConsoleCaptureOptions {
+    log?: boolean;
+    info?: boolean;
+    warn?: boolean;
+    error?: boolean;
+}
+/** @internal — for tests. Resets the wrap-once flag. */
+declare function __resetConsoleInstrumentationFlagForTest(): void;
+
 declare const INGEST_HOST = "https://api.allstak.sa";
 declare const SDK_NAME = "allstak-react-native";
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "0.3.1";
 
 interface AllStakConfig {
     /** Project API key (`ask_live_…`). Required. */
@@ -351,6 +380,12 @@ interface AllStakConfig {
      * are ALWAYS redacted.
      */
     httpTracking?: HttpTrackingOptions;
+    /**
+     * Per-console-method capture flags. Defaults: warn + error captured,
+     * log + info NOT captured (to avoid breadcrumb spam from typical app
+     * logging). Set `{ log: true, info: true }` to opt-in.
+     */
+    captureConsole?: ConsoleCaptureOptions;
     maxBreadcrumbs?: number;
     /**
      * Probability in [0, 1] that any given error is sent. Default: 1 (no sampling).
@@ -560,6 +595,109 @@ declare const AllStak: {
     _getInstance(): AllStakClient | null;
 };
 
+/**
+ * React Native runtime integration — ErrorUtils, Hermes promise rejection
+ * tracking, Platform tags, AppState breadcrumbs, XHR network capture,
+ * fetch breadcrumbs, and console breadcrumbs.
+ *
+ * Extracted from index.ts so AllStakProvider can call it without circular
+ * imports.
+ */
+interface ReactNativeInstallOptions {
+    /** Auto-capture unhandled JS exceptions via ErrorUtils. Default: true */
+    autoErrorHandler?: boolean;
+    /** Auto-capture unhandled promise rejections (Hermes). Default: true */
+    autoPromiseRejections?: boolean;
+    /** Auto-attach Platform.* info as tags. Default: true */
+    autoDeviceTags?: boolean;
+    /** Auto-emit breadcrumbs on AppState change. Default: true */
+    autoAppStateBreadcrumbs?: boolean;
+    /** Auto-instrument XHR (RN's fetch is XHR-based) for network breadcrumbs. Default: true */
+    autoNetworkCapture?: boolean;
+    /** Wrap `globalThis.fetch` to record HTTP breadcrumbs. Default: true */
+    autoFetchBreadcrumbs?: boolean;
+    /**
+     * Wrap `console.*` methods to record log breadcrumbs. Default: true.
+     * Per-method capture is controlled by `captureConsole` in AllStakConfig
+     * (warn + error default on, log + info default off).
+     */
+    autoConsoleBreadcrumbs?: boolean;
+    /**
+     * Auto-detect `@react-navigation/native` and patch `NavigationContainer`
+     * so route changes ship as breadcrumbs without the host app needing
+     * to call `instrumentReactNavigation(ref)`. Default: true. When the
+     * package is not installed, this silently no-ops.
+     */
+    autoNavigationBreadcrumbs?: boolean;
+    /**
+     * Emit a `[AllStak] Navigation auto-instrumentation enabled/not applied`
+     * console log so developers can confirm the wiring at startup. The
+     * provider sets this from its `debug` prop; defaults to false when
+     * called manually.
+     */
+    debugLogs?: boolean;
+}
+declare function installReactNative(options?: ReactNativeInstallOptions): void;
+
+interface AllStakProviderProps extends ReactNativeInstallOptions {
+    children: React.ReactNode;
+    apiKey: string;
+    environment?: string;
+    release?: string;
+    host?: string;
+    user?: {
+        id?: string;
+        email?: string;
+    };
+    tags?: Record<string, string>;
+    debug?: boolean;
+    enableHttpTracking?: boolean;
+    httpTracking?: AllStakConfig['httpTracking'];
+    /**
+     * Per-console-method capture flags. Defaults: warn + error on, log +
+     * info off. Set `{ log: true, info: true }` to opt-in to verbose
+     * capture, or `{ warn: false, error: false }` to suppress.
+     */
+    captureConsole?: AllStakConfig['captureConsole'];
+    sampleRate?: number;
+    beforeSend?: AllStakConfig['beforeSend'];
+    replay?: AllStakConfig['replay'];
+    tracesSampleRate?: number;
+    service?: string;
+    dist?: string;
+    /**
+     * Tear down the SDK when the provider unmounts. Default `false`.
+     *
+     * Most apps mount `AllStakProvider` once at the root and never unmount
+     * it. Setting this to `true` risks disabling telemetry if the provider
+     * re-mounts (Fast Refresh in dev, route key changes, React 18 Strict
+     * Mode double-mount, etc.) — there is a brief window between unmount
+     * and remount where captures throw.
+     *
+     * Leave at the default unless you genuinely need to dispose the SDK
+     * (e.g. test harness, multi-tenant container that switches projects).
+     */
+    destroyOnUnmount?: boolean;
+    fallback?: React.ReactNode | ((props: {
+        error: Error;
+        resetError: () => void;
+    }) => React.ReactNode);
+    onError?: (error: Error, componentStack?: string) => void;
+}
+declare function AllStakProvider({ children, apiKey, environment, release, host, user, tags, debug, enableHttpTracking, httpTracking, captureConsole, sampleRate, beforeSend, replay, tracesSampleRate, service, dist, destroyOnUnmount, fallback, onError, autoErrorHandler, autoPromiseRejections, autoDeviceTags, autoAppStateBreadcrumbs, autoNetworkCapture, autoFetchBreadcrumbs, autoConsoleBreadcrumbs, autoNavigationBreadcrumbs, }: AllStakProviderProps): React.ReactElement;
+declare function useAllStak(): {
+    captureException: (error: Error, ctx?: Record<string, unknown>) => void;
+    captureMessage: (msg: string, level?: "fatal" | "error" | "warning" | "info") => void;
+    setUser: (user: {
+        id?: string;
+        email?: string;
+    }) => void;
+    setTag: (key: string, value: string) => void;
+    addBreadcrumb: (type: string, message: string, level?: string, data?: Record<string, unknown>) => void;
+};
+/** @internal — for tests. Resets the module-level remount-guard. */
+declare function __resetProviderInstanceForTest(): void;
+
 /**
  * React Native navigation breadcrumbs — two opt-in helpers:
  *
@@ -611,6 +749,38 @@ declare function instrumentReactNavigation(navigationRef: NavigationRef, options
  * as breadcrumbs. No-op if `react-native` isn't available (test env).
  */
 declare function instrumentNavigationFromLinking(): void;
+/**
+ * Best-effort automatic instrumentation of `@react-navigation/native`.
+ *
+ * **What it does:**
+ *   - Tries `require('@react-navigation/native')`. If the package is not
+ *     installed, returns `false` and is otherwise a no-op.
+ *   - If found, monkey-patches the module's exported `NavigationContainer`
+ *     with a wrapper that auto-creates an internal ref, forwards the
+ *     user's `ref` prop, and on mount calls `instrumentReactNavigation`
+ *     so route changes ship as breadcrumbs.
+ *   - Idempotent: a flag on the module's exports object prevents double
+ *     patching across hot-reload cycles or repeated `installReactNative`
+ *     calls.
+ *
+ * **Why this works:**
+ *   Babel's CommonJS interop preserves runtime property lookups for
+ *   named imports — `import { NavigationContainer } from '@react-navigation/native'`
+ *   compiles to `_rnav.NavigationContainer` accesses at use-site, so
+ *   patching the module's exports object before the host app renders
+ *   means user code transparently picks up our wrapper.
+ *
+ * **Why it might fail:**
+ *   - `@react-navigation/native` not installed → returns false silently.
+ *   - Module exports frozen or sealed (rare in CJS-style RN builds).
+ *   - User imported `NavigationContainer` via a deep path that bypasses
+ *     the index module.
+ *   In any failure case the manual API (`instrumentReactNavigation(ref)`)
+ *   is still available as a fallback.
+ */
+declare function tryAutoInstrumentNavigation(): boolean;
+/** @internal — for tests. Resets the auto-patch flag on the cached module. */
+declare function __resetAutoNavigationFlagForTest(): void;
 
 /**
  * React Native architecture / runtime detection.
@@ -658,8 +828,21 @@ declare function applyArchitectureTags(setTag: (key: string, value: string) => v
  * `document`, `localStorage`, `sessionStorage`, or browser DOM event
  * listeners.
  *
- * Usage:
+ * Recommended usage (one-liner):
+ *
+ *   import { AllStakProvider } from '@allstak/react-native';
  *
+ *   export default function App() {
+ *     return (
+ *       <AllStakProvider apiKey="YOUR_API_KEY" environment="production">
+ *         <AppRoot />
+ *       </AllStakProvider>
+ *     );
+ *   }
+ *
+ * Advanced / manual usage:
+ *
+ *   import { AllStak, installReactNative } from '@allstak/react-native';
  *   AllStak.init({ apiKey, environment, release });
  *   installReactNative();
  *
@@ -667,29 +850,24 @@ declare function applyArchitectureTags(setTag: (key: string, value: string) => v
  * under the `native/` directory in this package. See README.
  */
 
-interface ReactNativeInstallOptions {
-    /** Auto-capture unhandled JS exceptions via ErrorUtils. Default: true */
-    autoErrorHandler?: boolean;
-    /** Auto-capture unhandled promise rejections (Hermes). Default: true */
-    autoPromiseRejections?: boolean;
-    /** Auto-attach Platform.* info as tags. Default: true */
-    autoDeviceTags?: boolean;
-    /** Auto-emit breadcrumbs on AppState change. Default: true */
-    autoAppStateBreadcrumbs?: boolean;
-    /** Auto-instrument XHR (RN's fetch is XHR-based) for network breadcrumbs. Default: true */
-    autoNetworkCapture?: boolean;
-    /** Wrap `globalThis.fetch` to record HTTP breadcrumbs. Default: true */
-    autoFetchBreadcrumbs?: boolean;
-    /** Wrap `console.warn`/`console.error` to record log breadcrumbs. Default: true */
-    autoConsoleBreadcrumbs?: boolean;
-}
 declare function __setNativeModuleForTest(mod: any): void;
+/**
+ * DEV-ONLY: deliberately trigger a native iOS or Android crash via the
+ * linked AllStak native module. This is intended for verifying the
+ * native-crash → drain → ingest pipeline during SDK development. It
+ * **terminates the app process** — never expose this in production UI.
+ *
+ *   import { __devTriggerNativeCrash } from '@allstak/react-native';
+ *   if (__DEV__) __devTriggerNativeCrash();  // app dies; relaunch drains
+ *
+ * No-op when the native module is not linked.
+ */
+declare function __devTriggerNativeCrash(): Promise<void>;
 /**
  * Drain any native crash stashed by AllStakCrashHandler on the previous
  * launch and ship it to /ingest/v1/errors. No-op when the native module
  * is not linked (Expo Go, JS-only test runners, etc).
  */
 declare function drainPendingNativeCrashes(release?: string): Promise<void>;
-declare function installReactNative(options?: ReactNativeInstallOptions): void;
 
-export { AllStak, AllStakClient, type AllStakConfig, type ArchitectureInfo, type Breadcrumb, type HttpRequestEvent, HttpRequestModule, type HttpTrackingOptions, INGEST_HOST, type ReactNativeInstallOptions, ReplaySurrogate, type ReplaySurrogateOptions, SDK_NAME, SDK_VERSION, Scope, __setNativeModuleForTest, applyArchitectureTags, detectArchitecture, drainPendingNativeCrashes, installReactNative, instrumentNavigationFromLinking, instrumentReactNavigation };
+export { AllStak, AllStakClient, type AllStakConfig, AllStakProvider, type AllStakProviderProps, type ArchitectureInfo, type Breadcrumb, type ConsoleCaptureOptions, type HttpRequestEvent, HttpRequestModule, type HttpTrackingOptions, INGEST_HOST, type ReactNativeInstallOptions, ReplaySurrogate, type ReplaySurrogateOptions, SDK_NAME, SDK_VERSION, Scope, __devTriggerNativeCrash, __resetAutoNavigationFlagForTest, __resetConsoleInstrumentationFlagForTest, __resetProviderInstanceForTest, __setNativeModuleForTest, applyArchitectureTags, detectArchitecture, drainPendingNativeCrashes, installReactNative, instrumentNavigationFromLinking, instrumentReactNavigation, tryAutoInstrumentNavigation, useAllStak };

package/dist/index.d.ts

@@ -1,3 +1,5 @@
+import * as React from 'react';
+
 /**
  * Minimal HTTP transport for React Native. Uses the global `fetch` (always
  * present in RN >= 0.60) with a 3s timeout. Failed sends fall into a small
@@ -296,9 +298,36 @@ interface HttpTrackingOptions {
     maxBodyBytes?: number;
 }
 
+/**
+ * Per-console-method capture flags. Defaults are set to keep the
+ * dashboard signal-to-noise high: `warn` and `error` capture by default
+ * (most apps fire those at human-meaningful moments), `log` and `info`
+ * are OFF by default since typical apps log thousands of debug lines
+ * per session.
+ *
+ * Override per-method:
+ *
+ *   <AllStakProvider captureConsole={{ log: true, info: true }} />
+ *
+ * Or to fully suppress:
+ *
+ *   <AllStakProvider captureConsole={{ warn: false, error: false }} />
+ *
+ * Setting `autoConsoleBreadcrumbs={false}` on the provider/install is a
+ * higher-level kill switch — it skips wrapping any console method.
+ */
+interface ConsoleCaptureOptions {
+    log?: boolean;
+    info?: boolean;
+    warn?: boolean;
+    error?: boolean;
+}
+/** @internal — for tests. Resets the wrap-once flag. */
+declare function __resetConsoleInstrumentationFlagForTest(): void;
+
 declare const INGEST_HOST = "https://api.allstak.sa";
 declare const SDK_NAME = "allstak-react-native";
-declare const SDK_VERSION = "0.3.0";
+declare const SDK_VERSION = "0.3.1";
 
 interface AllStakConfig {
     /** Project API key (`ask_live_…`). Required. */
@@ -351,6 +380,12 @@ interface AllStakConfig {
      * are ALWAYS redacted.
      */
     httpTracking?: HttpTrackingOptions;
+    /**
+     * Per-console-method capture flags. Defaults: warn + error captured,
+     * log + info NOT captured (to avoid breadcrumb spam from typical app
+     * logging). Set `{ log: true, info: true }` to opt-in.
+     */
+    captureConsole?: ConsoleCaptureOptions;
     maxBreadcrumbs?: number;
     /**
      * Probability in [0, 1] that any given error is sent. Default: 1 (no sampling).
@@ -560,6 +595,109 @@ declare const AllStak: {
     _getInstance(): AllStakClient | null;
 };
 
+/**
+ * React Native runtime integration — ErrorUtils, Hermes promise rejection
+ * tracking, Platform tags, AppState breadcrumbs, XHR network capture,
+ * fetch breadcrumbs, and console breadcrumbs.
+ *
+ * Extracted from index.ts so AllStakProvider can call it without circular
+ * imports.
+ */
+interface ReactNativeInstallOptions {
+    /** Auto-capture unhandled JS exceptions via ErrorUtils. Default: true */
+    autoErrorHandler?: boolean;
+    /** Auto-capture unhandled promise rejections (Hermes). Default: true */
+    autoPromiseRejections?: boolean;
+    /** Auto-attach Platform.* info as tags. Default: true */
+    autoDeviceTags?: boolean;
+    /** Auto-emit breadcrumbs on AppState change. Default: true */
+    autoAppStateBreadcrumbs?: boolean;
+    /** Auto-instrument XHR (RN's fetch is XHR-based) for network breadcrumbs. Default: true */
+    autoNetworkCapture?: boolean;
+    /** Wrap `globalThis.fetch` to record HTTP breadcrumbs. Default: true */
+    autoFetchBreadcrumbs?: boolean;
+    /**
+     * Wrap `console.*` methods to record log breadcrumbs. Default: true.
+     * Per-method capture is controlled by `captureConsole` in AllStakConfig
+     * (warn + error default on, log + info default off).
+     */
+    autoConsoleBreadcrumbs?: boolean;
+    /**
+     * Auto-detect `@react-navigation/native` and patch `NavigationContainer`
+     * so route changes ship as breadcrumbs without the host app needing
+     * to call `instrumentReactNavigation(ref)`. Default: true. When the
+     * package is not installed, this silently no-ops.
+     */
+    autoNavigationBreadcrumbs?: boolean;
+    /**
+     * Emit a `[AllStak] Navigation auto-instrumentation enabled/not applied`
+     * console log so developers can confirm the wiring at startup. The
+     * provider sets this from its `debug` prop; defaults to false when
+     * called manually.
+     */
+    debugLogs?: boolean;
+}
+declare function installReactNative(options?: ReactNativeInstallOptions): void;
+
+interface AllStakProviderProps extends ReactNativeInstallOptions {
+    children: React.ReactNode;
+    apiKey: string;
+    environment?: string;
+    release?: string;
+    host?: string;
+    user?: {
+        id?: string;
+        email?: string;
+    };
+    tags?: Record<string, string>;
+    debug?: boolean;
+    enableHttpTracking?: boolean;
+    httpTracking?: AllStakConfig['httpTracking'];
+    /**
+     * Per-console-method capture flags. Defaults: warn + error on, log +
+     * info off. Set `{ log: true, info: true }` to opt-in to verbose
+     * capture, or `{ warn: false, error: false }` to suppress.
+     */
+    captureConsole?: AllStakConfig['captureConsole'];
+    sampleRate?: number;
+    beforeSend?: AllStakConfig['beforeSend'];
+    replay?: AllStakConfig['replay'];
+    tracesSampleRate?: number;
+    service?: string;
+    dist?: string;
+    /**
+     * Tear down the SDK when the provider unmounts. Default `false`.
+     *
+     * Most apps mount `AllStakProvider` once at the root and never unmount
+     * it. Setting this to `true` risks disabling telemetry if the provider
+     * re-mounts (Fast Refresh in dev, route key changes, React 18 Strict
+     * Mode double-mount, etc.) — there is a brief window between unmount
+     * and remount where captures throw.
+     *
+     * Leave at the default unless you genuinely need to dispose the SDK
+     * (e.g. test harness, multi-tenant container that switches projects).
+     */
+    destroyOnUnmount?: boolean;
+    fallback?: React.ReactNode | ((props: {
+        error: Error;
+        resetError: () => void;
+    }) => React.ReactNode);
+    onError?: (error: Error, componentStack?: string) => void;
+}
+declare function AllStakProvider({ children, apiKey, environment, release, host, user, tags, debug, enableHttpTracking, httpTracking, captureConsole, sampleRate, beforeSend, replay, tracesSampleRate, service, dist, destroyOnUnmount, fallback, onError, autoErrorHandler, autoPromiseRejections, autoDeviceTags, autoAppStateBreadcrumbs, autoNetworkCapture, autoFetchBreadcrumbs, autoConsoleBreadcrumbs, autoNavigationBreadcrumbs, }: AllStakProviderProps): React.ReactElement;
+declare function useAllStak(): {
+    captureException: (error: Error, ctx?: Record<string, unknown>) => void;
+    captureMessage: (msg: string, level?: "fatal" | "error" | "warning" | "info") => void;
+    setUser: (user: {
+        id?: string;
+        email?: string;
+    }) => void;
+    setTag: (key: string, value: string) => void;
+    addBreadcrumb: (type: string, message: string, level?: string, data?: Record<string, unknown>) => void;
+};
+/** @internal — for tests. Resets the module-level remount-guard. */
+declare function __resetProviderInstanceForTest(): void;
+
 /**
  * React Native navigation breadcrumbs — two opt-in helpers:
  *
@@ -611,6 +749,38 @@ declare function instrumentReactNavigation(navigationRef: NavigationRef, options
  * as breadcrumbs. No-op if `react-native` isn't available (test env).
  */
 declare function instrumentNavigationFromLinking(): void;
+/**
+ * Best-effort automatic instrumentation of `@react-navigation/native`.
+ *
+ * **What it does:**
+ *   - Tries `require('@react-navigation/native')`. If the package is not
+ *     installed, returns `false` and is otherwise a no-op.
+ *   - If found, monkey-patches the module's exported `NavigationContainer`
+ *     with a wrapper that auto-creates an internal ref, forwards the
+ *     user's `ref` prop, and on mount calls `instrumentReactNavigation`
+ *     so route changes ship as breadcrumbs.
+ *   - Idempotent: a flag on the module's exports object prevents double
+ *     patching across hot-reload cycles or repeated `installReactNative`
+ *     calls.
+ *
+ * **Why this works:**
+ *   Babel's CommonJS interop preserves runtime property lookups for
+ *   named imports — `import { NavigationContainer } from '@react-navigation/native'`
+ *   compiles to `_rnav.NavigationContainer` accesses at use-site, so
+ *   patching the module's exports object before the host app renders
+ *   means user code transparently picks up our wrapper.
+ *
+ * **Why it might fail:**
+ *   - `@react-navigation/native` not installed → returns false silently.
+ *   - Module exports frozen or sealed (rare in CJS-style RN builds).
+ *   - User imported `NavigationContainer` via a deep path that bypasses
+ *     the index module.
+ *   In any failure case the manual API (`instrumentReactNavigation(ref)`)
+ *   is still available as a fallback.
+ */
+declare function tryAutoInstrumentNavigation(): boolean;
+/** @internal — for tests. Resets the auto-patch flag on the cached module. */
+declare function __resetAutoNavigationFlagForTest(): void;
 
 /**
  * React Native architecture / runtime detection.
@@ -658,8 +828,21 @@ declare function applyArchitectureTags(setTag: (key: string, value: string) => v
  * `document`, `localStorage`, `sessionStorage`, or browser DOM event
  * listeners.
  *
- * Usage:
+ * Recommended usage (one-liner):
+ *
+ *   import { AllStakProvider } from '@allstak/react-native';
  *
+ *   export default function App() {
+ *     return (
+ *       <AllStakProvider apiKey="YOUR_API_KEY" environment="production">
+ *         <AppRoot />
+ *       </AllStakProvider>
+ *     );
+ *   }
+ *
+ * Advanced / manual usage:
+ *
+ *   import { AllStak, installReactNative } from '@allstak/react-native';
  *   AllStak.init({ apiKey, environment, release });
  *   installReactNative();
  *
@@ -667,29 +850,24 @@ declare function applyArchitectureTags(setTag: (key: string, value: string) => v
  * under the `native/` directory in this package. See README.
  */
 
-interface ReactNativeInstallOptions {
-    /** Auto-capture unhandled JS exceptions via ErrorUtils. Default: true */
-    autoErrorHandler?: boolean;
-    /** Auto-capture unhandled promise rejections (Hermes). Default: true */
-    autoPromiseRejections?: boolean;
-    /** Auto-attach Platform.* info as tags. Default: true */
-    autoDeviceTags?: boolean;
-    /** Auto-emit breadcrumbs on AppState change. Default: true */
-    autoAppStateBreadcrumbs?: boolean;
-    /** Auto-instrument XHR (RN's fetch is XHR-based) for network breadcrumbs. Default: true */
-    autoNetworkCapture?: boolean;
-    /** Wrap `globalThis.fetch` to record HTTP breadcrumbs. Default: true */
-    autoFetchBreadcrumbs?: boolean;
-    /** Wrap `console.warn`/`console.error` to record log breadcrumbs. Default: true */
-    autoConsoleBreadcrumbs?: boolean;
-}
 declare function __setNativeModuleForTest(mod: any): void;
+/**
+ * DEV-ONLY: deliberately trigger a native iOS or Android crash via the
+ * linked AllStak native module. This is intended for verifying the
+ * native-crash → drain → ingest pipeline during SDK development. It
+ * **terminates the app process** — never expose this in production UI.
+ *
+ *   import { __devTriggerNativeCrash } from '@allstak/react-native';
+ *   if (__DEV__) __devTriggerNativeCrash();  // app dies; relaunch drains
+ *
+ * No-op when the native module is not linked.
+ */
+declare function __devTriggerNativeCrash(): Promise<void>;
 /**
  * Drain any native crash stashed by AllStakCrashHandler on the previous
  * launch and ship it to /ingest/v1/errors. No-op when the native module
  * is not linked (Expo Go, JS-only test runners, etc).
  */
 declare function drainPendingNativeCrashes(release?: string): Promise<void>;
-declare function installReactNative(options?: ReactNativeInstallOptions): void;
 
-export { AllStak, AllStakClient, type AllStakConfig, type ArchitectureInfo, type Breadcrumb, type HttpRequestEvent, HttpRequestModule, type HttpTrackingOptions, INGEST_HOST, type ReactNativeInstallOptions, ReplaySurrogate, type ReplaySurrogateOptions, SDK_NAME, SDK_VERSION, Scope, __setNativeModuleForTest, applyArchitectureTags, detectArchitecture, drainPendingNativeCrashes, installReactNative, instrumentNavigationFromLinking, instrumentReactNavigation };
+export { AllStak, AllStakClient, type AllStakConfig, AllStakProvider, type AllStakProviderProps, type ArchitectureInfo, type Breadcrumb, type ConsoleCaptureOptions, type HttpRequestEvent, HttpRequestModule, type HttpTrackingOptions, INGEST_HOST, type ReactNativeInstallOptions, ReplaySurrogate, type ReplaySurrogateOptions, SDK_NAME, SDK_VERSION, Scope, __devTriggerNativeCrash, __resetAutoNavigationFlagForTest, __resetConsoleInstrumentationFlagForTest, __resetProviderInstanceForTest, __setNativeModuleForTest, applyArchitectureTags, detectArchitecture, drainPendingNativeCrashes, installReactNative, instrumentNavigationFromLinking, instrumentReactNavigation, tryAutoInstrumentNavigation, useAllStak };