@debugkit/sdk 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,177 @@
-# Temporary Holding Version
+# @debugkit/sdk
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+Log errors and events from your app into **your own** cloud. This is the client half of
+[deBug](https://github.com/Abantu-Digital/deBug): events go to an ingest function you deploy
+in Firebase or AWS, and a dashboard you run yourself tells you what is failing and why.
+
+- About 3 KB gzipped, with no runtime dependencies in your bundle.
+- Works with React, React Native (bare and Expo), Expo Router, TanStack Start/Router, Next.js
+  and plain Node.
+- Captures crashes, unhandled rejections and render errors automatically. Batches, retries,
+  and queues events while offline.
+
+## Install
+
+```bash
+npm install @debugkit/sdk
+```
+
+Pick the entry point for your platform. Each one adds the right device context and error
+hooks, and they all share the same `deBug` client.
+
+| You have | Import from | Also install |
+|---|---|---|
+| Expo | `@debugkit/sdk/expo` | `npx expo install expo-device expo-application` |
+| Expo Router | `@debugkit/sdk/expo-router`, plus the above | |
+| Bare React Native | `@debugkit/sdk/react-native` | `react-native-device-info` (optional, for model and app version) |
+| React on the web (Vite and others) | `@debugkit/sdk/react` | |
+| TanStack Start / Router | `@debugkit/sdk/react` for the browser, `@debugkit/sdk/node` for the server | |
+| Next.js, Remix, Express, any Node server | `@debugkit/sdk/node` | |
+| Anything else (workers, edge, vanilla JS) | `@debugkit/sdk` | |
+
+Your ingest endpoint and key come from your deBug deployment. During development, point at a
+dashboard running in demo mode: `http://localhost:4400/api/ingest` with key `pk_local`.
+
+## Expo
+
+```tsx
+// src/debug.ts
+import { initExpo } from "@debugkit/sdk/expo";
+
+initExpo({
+  endpoint: "https://<your-ingest-url>",
+  ingestKey: "pk_live_yourapp",
+  app: { id: "your-app" }, // version and build are read from expo-application
+});
+```
+
+```tsx
+// src/app/_layout.tsx
+import "@/debug";
+import { DebugErrorBoundary } from "@debugkit/sdk/expo";
+import { useDebugExpoRouter } from "@debugkit/sdk/expo-router";
+
+export default function RootLayout() {
+  useDebugExpoRouter(); // a breadcrumb for every screen change
+  return (
+    <DebugErrorBoundary flow="app.root" fallback={({ reset }) => <CrashScreen onRetry={reset} />}>
+      <Stack />
+    </DebugErrorBoundary>
+  );
+}
+```
+
+In Expo Go, the app version reported is Expo Go's own. Development and production builds
+report yours.
+
+## Bare React Native
+
+```tsx
+import DeviceInfo from "react-native-device-info";
+import { initReactNative, DebugErrorBoundary, trackReactNavigation } from "@debugkit/sdk/react-native";
+
+initReactNative({ endpoint, ingestKey, app: { id: "your-app" }, deviceInfo: DeviceInfo });
+
+const nav = useNavigationContainerRef();
+<NavigationContainer ref={nav} {...trackReactNavigation(nav)}>…</NavigationContainer>
+```
+
+Without `react-native-device-info` you still get the OS, OS version and JS engine. On Android
+you also get the model and brand.
+
+React Native also gets:
+
+- **Crashes** through React Native's global error handler.
+- **Unhandled promise rejections** (Hermes). In production only by default, so the yellow-box
+  warning still works in development. Pass `captureUnhandledRejections: true` to capture them
+  in development too.
+- **A flush when the app goes to the background.** Pass AsyncStorage as `storage` to keep
+  unsent events across restarts.
+
+## React (web)
+
+```tsx
+import { deBug, DebugErrorBoundary } from "@debugkit/sdk/react";
+
+deBug.init({ endpoint, ingestKey, app: { id: "your-web-app", version: "1.4.0" } });
+
+createRoot(el).render(
+  <DebugErrorBoundary fallback={<p>Something went wrong.</p>}>
+    <App />
+  </DebugErrorBoundary>,
+);
+```
+
+Uncaught errors and unhandled rejections are captured from `window`. The OS, browser, screen
+and network type are detected automatically.
+
+## TanStack Start / Router
+
+```tsx
+// src/router.tsx: the browser side
+import { deBug, trackTanStackRouter } from "@debugkit/sdk/react";
+
+if (typeof window !== "undefined") deBug.init({ endpoint, ingestKey, app: { id: "web" } });
+
+export function getRouter() {
+  const router = createRouter({ routeTree });
+  if (typeof window !== "undefined") trackTanStackRouter(router);
+  return router;
+}
+```
+
+```ts
+// src/server/debug.ts: server only
+import { deBug, initNode } from "@debugkit/sdk/node";
+
+export const serverDebug = () =>
+  deBug.initialized ? deBug : initNode({ endpoint, ingestKey, app: { id: "web", environment: "server" } });
+```
+
+```ts
+// src/server/fns.ts
+import { createServerFn } from "@tanstack/react-start";
+import { withDebug } from "@debugkit/sdk/node";
+import { serverDebug } from "./debug";
+
+export const charge = createServerFn({ method: "POST" }).handler(
+  withDebug("checkout.payment", async ({ data }) => {
+    serverDebug(); // initialise lazily, inside the handler, so none of this reaches the client bundle
+    /* … */
+  }),
+);
+```
+
+When the browser calls a server function that is wrapped in `withDebug`, record only the
+outcome there, so the error isn't counted twice:
+`deBug.track("checkout.payment", "charge", () => charge(), { captureError: false })`.
+
+## Node
+
+`initNode()` captures uncaught exceptions and unhandled rejections. It flushes events and then
+exits the way Node would. Pass `captureProcessErrors: false` to manage those hooks yourself,
+for example inside a dev server.
+
+On edge runtimes such as Cloudflare Workers, timers aren't allowed at startup. Use the base
+entry with `flushIntervalMs: 0`, and `await deBug.flush()` before each response returns.
+
+## The API
+
+```ts
+deBug.error(err, { flow: "checkout.payment", step: "create_intent" });
+deBug.event("signup_abandoned", { flow: "onboarding.signup", outcome: "abandoned" });
+await deBug.track("auth.login", "submit_otp", () => api.verifyOtp(code)); // success or failure, plus the error
+deBug.breadcrumb("navigation", "Login → OtpScreen");
+deBug.setUser("user_123");
+deBug.setContext({ app: { environment: "staging" } });
+await deBug.flush();
+```
+
+`flow` names the part of your app, in dotted lowercase like `auth.login`. It's the main axis
+of the dashboard, so keep it consistent.
+
+To scrub personal data before anything leaves the device, use `beforeSend`:
+
+```ts
+deBug.init({ …, beforeSend: (e) => (e.type === "event" && e.name === "secret" ? null : e) });
+```

package/dist/chunk-3UN5VMQU.js

@@ -0,0 +1,41 @@
+import { deBug, __publicField } from './chunk-VIJ5USKQ.js';
+import { Component, useEffect } from 'react';
+
+var DebugErrorBoundary = class extends Component {
+  constructor() {
+    super(...arguments);
+    __publicField(this, "state", { error: null });
+    __publicField(this, "reset", () => this.setState({ error: null }));
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    var _a, _b, _c;
+    const client = (_a = this.props.client) != null ? _a : deBug;
+    if (info.componentStack) {
+      client.breadcrumb("ui", "React render error", { componentStack: info.componentStack.trim().slice(0, 1500) }, "error");
+    }
+    client.error(error, { flow: this.props.flow, handled: false, tags: { source: "error-boundary" } });
+    void client.flush();
+    (_c = (_b = this.props).onError) == null ? void 0 : _c.call(_b, error, info);
+  }
+  render() {
+    const { error } = this.state;
+    if (!error) return this.props.children;
+    const { fallback } = this.props;
+    return typeof fallback === "function" ? fallback({ error, reset: this.reset }) : fallback != null ? fallback : null;
+  }
+};
+function useDebugNavigation(path, client = deBug) {
+  useEffect(() => {
+    if (path) client.breadcrumb("navigation", path);
+  }, [path, client]);
+}
+function trackTanStackRouter(router, client = deBug) {
+  return router.subscribe("onResolved", ({ toLocation }) => client.breadcrumb("navigation", toLocation.pathname));
+}
+
+export { DebugErrorBoundary, trackTanStackRouter, useDebugNavigation };
+//# sourceMappingURL=chunk-3UN5VMQU.js.map
+//# sourceMappingURL=chunk-3UN5VMQU.js.map

package/dist/chunk-3UN5VMQU.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.tsx"],"names":[],"mappings":";;;AAqBO,IAAM,kBAAA,GAAN,cAAiC,SAAA,CAA0C;AAAA,EAA3E,WAAA,GAAA;AAAA,IAAA,KAAA,CAAA,GAAA,SAAA,CAAA;AACL,IAAA,aAAA,CAAA,IAAA,EAAA,OAAA,EAAe,EAAE,OAAO,IAAA,EAAK,CAAA;AAgB7B,IAAA,aAAA,CAAA,IAAA,EAAA,OAAA,EAAQ,MAAM,IAAA,CAAK,QAAA,CAAS,EAAE,KAAA,EAAO,MAAM,CAAA,CAAA;AAAA,EAAA;AAAA,EAd3C,OAAO,yBAAyB,KAAA,EAAqB;AACnD,IAAA,OAAO,EAAE,KAAA,EAAM;AAAA,EACjB;AAAA,EAEA,iBAAA,CAAkB,OAAc,IAAA,EAAiB;AA5BnD,IAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA;AA6BI,IAAA,MAAM,MAAA,GAAA,CAAS,EAAA,GAAA,IAAA,CAAK,KAAA,CAAM,MAAA,KAAX,IAAA,GAAA,EAAA,GAAqB,KAAA;AACpC,IAAA,IAAI,KAAK,cAAA,EAAgB;AACvB,MAAA,MAAA,CAAO,UAAA,CAAW,IAAA,EAAM,oBAAA,EAAsB,EAAE,gBAAgB,IAAA,CAAK,cAAA,CAAe,IAAA,EAAK,CAAE,KAAA,CAAM,CAAA,EAAG,IAAI,CAAA,IAAK,OAAO,CAAA;AAAA,IACtH;AACA,IAAA,MAAA,CAAO,KAAA,CAAM,KAAA,EAAO,EAAE,IAAA,EAAM,KAAK,KAAA,CAAM,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,IAAA,EAAM,EAAE,MAAA,EAAQ,gBAAA,IAAoB,CAAA;AACjG,IAAA,KAAK,OAAO,KAAA,EAAM;AAClB,IAAA,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAAA,CAAK,KAAA,EAAM,OAAA,KAAX,IAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAA,EAAA,EAAqB,KAAA,EAAO,IAAA,CAAA;AAAA,EAC9B;AAAA,EAIA,MAAA,GAAS;AACP,IAAA,MAAM,EAAE,KAAA,EAAM,GAAI,IAAA,CAAK,KAAA;AACvB,IAAA,IAAI,CAAC,KAAA,EAAO,OAAO,IAAA,CAAK,KAAA,CAAM,QAAA;AAC9B,IAAA,MAAM,EAAE,QAAA,EAAS,GAAI,IAAA,CAAK,KAAA;AAC1B,IAAA,OAAO,OAAO,QAAA,KAAa,UAAA,GAAa,QAAA,CAAS,EAAE,KAAA,EAAO,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,CAAA,GAAK,QAAA,IAAA,IAAA,GAAA,QAAA,GAAY,IAAA;AAAA,EAChG;AACF;AAGO,SAAS,kBAAA,CAAmB,IAAA,EAA0B,MAAA,GAAsB,KAAA,EAAO;AACxF,EAAA,SAAA,CAAU,MAAM;AACd,IAAA,IAAI,IAAA,EAAM,MAAA,CAAO,UAAA,CAAW,YAAA,EAAc,IAAI,CAAA;AAAA,EAChD,CAAA,EAAG,CAAC,IAAA,EAAM,MAAM,CAAC,CAAA;AACnB;AAYO,SAAS,mBAAA,CAAoB,MAAA,EAAoB,MAAA,GAAsB,KAAA,EAAO;AACnF,EAAA,OAAO,MAAA,CAAO,SAAA,CAAU,YAAA,EAAc,CAAC,EAAE,UAAA,EAAW,KAAM,MAAA,CAAO,UAAA,CAAW,YAAA,EAAc,UAAA,CAAW,QAAQ,CAAC,CAAA;AAChH","file":"chunk-3UN5VMQU.js","sourcesContent":["import { Component, useEffect, type ErrorInfo, type ReactNode } from \"react\";\nimport { deBug, type DebugClient } from \"./index\";\n\nexport interface DebugErrorBoundaryProps {\n  children?: ReactNode;\n  /** What to render after a crash. A function gets the error and a reset callback. */\n  fallback?: ReactNode | ((props: { error: Error; reset: () => void }) => ReactNode);\n  /** Part of the app this boundary protects, e.g. \"checkout\". */\n  flow?: string;\n  client?: DebugClient;\n  onError?: (error: Error, info: ErrorInfo) => void;\n}\n\ninterface State {\n  error: Error | null;\n}\n\n/**\n * Catches render errors that React would otherwise swallow (or turn into a white/red screen)\n * and reports them. Works in React DOM and React Native.\n */\nexport class DebugErrorBoundary extends Component<DebugErrorBoundaryProps, State> {\n  state: State = { error: null };\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: ErrorInfo) {\n    const client = this.props.client ?? deBug;\n    if (info.componentStack) {\n      client.breadcrumb(\"ui\", \"React render error\", { componentStack: info.componentStack.trim().slice(0, 1500) }, \"error\");\n    }\n    client.error(error, { flow: this.props.flow, handled: false, tags: { source: \"error-boundary\" } });\n    void client.flush();\n    this.props.onError?.(error, info);\n  }\n\n  reset = () => this.setState({ error: null });\n\n  render() {\n    const { error } = this.state;\n    if (!error) return this.props.children;\n    const { fallback } = this.props;\n    return typeof fallback === \"function\" ? fallback({ error, reset: this.reset }) : (fallback ?? null);\n  }\n}\n\n/** Adds a navigation breadcrumb whenever `path` changes. Works with any router. */\nexport function useDebugNavigation(path: string | undefined, client: DebugClient = deBug) {\n  useEffect(() => {\n    if (path) client.breadcrumb(\"navigation\", path);\n  }, [path, client]);\n}\n\n/** Minimal shape of a TanStack Router instance (avoids a hard dependency). */\ninterface RouterLike {\n  subscribe(event: \"onResolved\", fn: (e: { toLocation: { pathname: string; href?: string } }) => void): () => void;\n}\n\n/**\n * Records a breadcrumb for every navigation in a TanStack Router app:\n *   const router = createRouter({ routeTree }); trackTanStackRouter(router);\n * Returns an unsubscribe function.\n */\nexport function trackTanStackRouter(router: RouterLike, client: DebugClient = deBug) {\n  return router.subscribe(\"onResolved\", ({ toLocation }) => client.breadcrumb(\"navigation\", toLocation.pathname));\n}\n\nexport { deBug } from \"./index\";\n"]}

package/dist/chunk-BD2FNVCP.js

@@ -0,0 +1,71 @@
+import { deBug, timezone, locale, mergeContext } from './chunk-VIJ5USKQ.js';
+import { Platform, AppState } from 'react-native';
+
+function nativeContext(opts = {}) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  const c = (_a = Platform.constants) != null ? _a : {};
+  const di = opts.deviceInfo;
+  const rn = c.reactNativeVersion;
+  const hermes = typeof globalThis.HermesInternal !== "undefined";
+  const call = (fn) => {
+    try {
+      return fn == null ? void 0 : fn();
+    } catch {
+      return void 0;
+    }
+  };
+  const totalMemory = call((_b = di == null ? void 0 : di.getTotalMemorySync) == null ? void 0 : _b.bind(di));
+  return {
+    os: { name: Platform.OS, version: Platform.OS === "android" ? (_c = c.Release) != null ? _c : String(Platform.Version) : String(Platform.Version) },
+    runtime: { name: "react-native", version: rn ? `${rn.major}.${rn.minor}.${rn.patch}` : void 0, engine: hermes ? "hermes" : "jsc" },
+    device: {
+      model: (_d = call(di == null ? void 0 : di.getModel.bind(di))) != null ? _d : c.Model,
+      brand: (_e = call(di == null ? void 0 : di.getBrand.bind(di))) != null ? _e : c.Brand,
+      manufacturer: (_g = call((_f = di == null ? void 0 : di.getManufacturerSync) == null ? void 0 : _f.bind(di))) != null ? _g : c.Manufacturer,
+      isEmulator: (_i = call((_h = di == null ? void 0 : di.isEmulatorSync) == null ? void 0 : _h.bind(di))) != null ? _i : c.Fingerprint ? /generic|emulator/i.test(c.Fingerprint) : void 0,
+      memoryMb: totalMemory ? Math.round(totalMemory / 1024 / 1024) : void 0,
+      type: di ? call(di.isTablet.bind(di)) ? "tablet" : "phone" : Platform.OS === "ios" && Platform.isPad ? "tablet" : "phone"
+    },
+    app: { version: call(di == null ? void 0 : di.getVersion.bind(di)), build: call(di == null ? void 0 : di.getBuildNumber.bind(di)) },
+    locale: locale(),
+    timezone: timezone()
+  };
+}
+function initReactNative(options, client = deBug) {
+  var _a, _b;
+  const { deviceInfo, captureUnhandledRejections = "production", ...rest } = options;
+  const base = nativeContext({ deviceInfo });
+  client.init({
+    ...rest,
+    app: { ...base.app, ...rest.app },
+    context: mergeContext(base, (_a = rest.context) != null ? _a : {})
+  });
+  AppState.addEventListener("change", (state) => {
+    if (state !== "active") void client.flush();
+  });
+  const dev = typeof __DEV__ !== "undefined" && __DEV__;
+  const tracker = (_b = globalThis.HermesInternal) == null ? void 0 : _b.enablePromiseRejectionTracker;
+  if (tracker && (captureUnhandledRejections === true || captureUnhandledRejections === "production" && !dev)) {
+    tracker({
+      allRejections: true,
+      onUnhandled: (_id, reason) => client.error(reason, { handled: false, tags: { source: "unhandled-rejection" } }),
+      onHandled: () => {
+      }
+    });
+  }
+  return client;
+}
+function trackReactNavigation(ref, client = deBug) {
+  let last;
+  const record = () => {
+    var _a;
+    const name = (_a = ref.getCurrentRoute()) == null ? void 0 : _a.name;
+    if (name && name !== last) client.breadcrumb("navigation", last ? `${last} \u2192 ${name}` : name);
+    last = name != null ? name : last;
+  };
+  return { onReady: record, onStateChange: record };
+}
+
+export { initReactNative, nativeContext, trackReactNavigation };
+//# sourceMappingURL=chunk-BD2FNVCP.js.map
+//# sourceMappingURL=chunk-BD2FNVCP.js.map

package/dist/chunk-BD2FNVCP.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react-native.ts"],"names":[],"mappings":"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","file":"chunk-BD2FNVCP.js","sourcesContent":["import { AppState, Platform } from \"react-native\";\nimport { deBug, type DebugClient, type InitOptions } from \"./index\";\nimport { locale, mergeContext, timezone, type ContextPatch } from \"./context\";\n\nexport * from \"./react\";\n\n/** The subset of react-native-device-info we read. Pass the module itself: `import DeviceInfo from \"react-native-device-info\"`. */\nexport interface DeviceInfoModule {\n  getModel(): string;\n  getBrand(): string;\n  getVersion(): string;\n  getBuildNumber(): string;\n  isTablet(): boolean;\n  getManufacturerSync?(): string;\n  isEmulatorSync?(): boolean;\n  getTotalMemorySync?(): number;\n}\n\ntype RNConstants = {\n  Release?: string;\n  Model?: string;\n  Brand?: string;\n  Manufacturer?: string;\n  Fingerprint?: string;\n  reactNativeVersion?: { major: number; minor: number; patch: number };\n};\n\n/**\n * Context for bare React Native. Reads what `react-native` exposes on its own; pass\n * react-native-device-info for model, app version and memory on both platforms.\n */\nexport function nativeContext(opts: { deviceInfo?: DeviceInfoModule } = {}): ContextPatch {\n  const c = (Platform.constants ?? {}) as RNConstants;\n  const di = opts.deviceInfo;\n  const rn = c.reactNativeVersion;\n  const hermes = typeof (globalThis as { HermesInternal?: unknown }).HermesInternal !== \"undefined\";\n  const call = <T,>(fn?: () => T) => {\n    try {\n      return fn?.();\n    } catch {\n      return undefined;\n    }\n  };\n  const totalMemory = call(di?.getTotalMemorySync?.bind(di));\n  return {\n    os: { name: Platform.OS, version: Platform.OS === \"android\" ? (c.Release ?? String(Platform.Version)) : String(Platform.Version) },\n    runtime: { name: \"react-native\", version: rn ? `${rn.major}.${rn.minor}.${rn.patch}` : undefined, engine: hermes ? \"hermes\" : \"jsc\" },\n    device: {\n      model: call(di?.getModel.bind(di)) ?? c.Model,\n      brand: call(di?.getBrand.bind(di)) ?? c.Brand,\n      manufacturer: call(di?.getManufacturerSync?.bind(di)) ?? c.Manufacturer,\n      isEmulator: call(di?.isEmulatorSync?.bind(di)) ?? (c.Fingerprint ? /generic|emulator/i.test(c.Fingerprint) : undefined),\n      memoryMb: totalMemory ? Math.round(totalMemory / 1024 / 1024) : undefined,\n      type: di ? (call(di.isTablet.bind(di)) ? \"tablet\" : \"phone\") : Platform.OS === \"ios\" && (Platform as { isPad?: boolean }).isPad ? \"tablet\" : \"phone\",\n    },\n    app: { version: call(di?.getVersion.bind(di)), build: call(di?.getBuildNumber.bind(di)) } as ContextPatch[\"app\"],\n    locale: locale(),\n    timezone: timezone(),\n  };\n}\n\nexport interface ReactNativeInitOptions extends InitOptions {\n  deviceInfo?: DeviceInfoModule;\n  /**\n   * Report unhandled promise rejections (Hermes). Default \"production\": in development React\n   * Native's own yellow-box warning keeps working. `true` captures in development too.\n   */\n  captureUnhandledRejections?: boolean | \"production\";\n}\n\ndeclare const __DEV__: boolean | undefined;\n\n/** Initialise deBug in a React Native app (bare or Expo). Fills in device context and flushes when the app is backgrounded. */\nexport function initReactNative(options: ReactNativeInitOptions, client: DebugClient = deBug): DebugClient {\n  const { deviceInfo, captureUnhandledRejections = \"production\", ...rest } = options;\n  const base = nativeContext({ deviceInfo });\n  client.init({\n    ...rest,\n    app: { ...(base.app as object), ...rest.app },\n    context: mergeContext(base, rest.context ?? {}),\n  });\n\n  AppState.addEventListener(\"change\", (state) => {\n    if (state !== \"active\") void client.flush();\n  });\n\n  const dev = typeof __DEV__ !== \"undefined\" && __DEV__;\n  const tracker = (globalThis as { HermesInternal?: { enablePromiseRejectionTracker?: (o: object) => void } }).HermesInternal\n    ?.enablePromiseRejectionTracker;\n  if (tracker && (captureUnhandledRejections === true || (captureUnhandledRejections === \"production\" && !dev))) {\n    tracker({\n      allRejections: true,\n      onUnhandled: (_id: number, reason: unknown) => client.error(reason, { handled: false, tags: { source: \"unhandled-rejection\" } }),\n      onHandled: () => {},\n    });\n  }\n  return client;\n}\n\n/** Minimal shape of a React Navigation container ref. */\ninterface NavigationRefLike {\n  getCurrentRoute(): { name: string } | undefined;\n}\n\n/**\n * Breadcrumbs for React Navigation. Spread the result onto your container:\n *   const nav = useNavigationContainerRef();\n *   <NavigationContainer ref={nav} {...trackReactNavigation(nav)}>\n */\nexport function trackReactNavigation(ref: NavigationRefLike, client: DebugClient = deBug) {\n  let last: string | undefined;\n  const record = () => {\n    const name = ref.getCurrentRoute()?.name;\n    if (name && name !== last) client.breadcrumb(\"navigation\", last ? `${last} → ${name}` : name);\n    last = name ?? last;\n  };\n  return { onReady: record, onStateChange: record };\n}\n"]}

package/dist/chunk-KUJ4EW3D.cjs

@@ -0,0 +1,45 @@
+'use strict';
+
+var chunkXEFWRCN4_cjs = require('./chunk-XEFWRCN4.cjs');
+var react = require('react');
+
+var DebugErrorBoundary = class extends react.Component {
+  constructor() {
+    super(...arguments);
+    chunkXEFWRCN4_cjs.__publicField(this, "state", { error: null });
+    chunkXEFWRCN4_cjs.__publicField(this, "reset", () => this.setState({ error: null }));
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  componentDidCatch(error, info) {
+    var _a, _b, _c;
+    const client = (_a = this.props.client) != null ? _a : chunkXEFWRCN4_cjs.deBug;
+    if (info.componentStack) {
+      client.breadcrumb("ui", "React render error", { componentStack: info.componentStack.trim().slice(0, 1500) }, "error");
+    }
+    client.error(error, { flow: this.props.flow, handled: false, tags: { source: "error-boundary" } });
+    void client.flush();
+    (_c = (_b = this.props).onError) == null ? void 0 : _c.call(_b, error, info);
+  }
+  render() {
+    const { error } = this.state;
+    if (!error) return this.props.children;
+    const { fallback } = this.props;
+    return typeof fallback === "function" ? fallback({ error, reset: this.reset }) : fallback != null ? fallback : null;
+  }
+};
+function useDebugNavigation(path, client = chunkXEFWRCN4_cjs.deBug) {
+  react.useEffect(() => {
+    if (path) client.breadcrumb("navigation", path);
+  }, [path, client]);
+}
+function trackTanStackRouter(router, client = chunkXEFWRCN4_cjs.deBug) {
+  return router.subscribe("onResolved", ({ toLocation }) => client.breadcrumb("navigation", toLocation.pathname));
+}
+
+exports.DebugErrorBoundary = DebugErrorBoundary;
+exports.trackTanStackRouter = trackTanStackRouter;
+exports.useDebugNavigation = useDebugNavigation;
+//# sourceMappingURL=chunk-KUJ4EW3D.cjs.map
+//# sourceMappingURL=chunk-KUJ4EW3D.cjs.map

package/dist/chunk-KUJ4EW3D.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react.tsx"],"names":["Component","__publicField","deBug","useEffect"],"mappings":";;;;;AAqBO,IAAM,kBAAA,GAAN,cAAiCA,eAAA,CAA0C;AAAA,EAA3E,WAAA,GAAA;AAAA,IAAA,KAAA,CAAA,GAAA,SAAA,CAAA;AACL,IAAAC,+BAAA,CAAA,IAAA,EAAA,OAAA,EAAe,EAAE,OAAO,IAAA,EAAK,CAAA;AAgB7B,IAAAA,+BAAA,CAAA,IAAA,EAAA,OAAA,EAAQ,MAAM,IAAA,CAAK,QAAA,CAAS,EAAE,KAAA,EAAO,MAAM,CAAA,CAAA;AAAA,EAAA;AAAA,EAd3C,OAAO,yBAAyB,KAAA,EAAqB;AACnD,IAAA,OAAO,EAAE,KAAA,EAAM;AAAA,EACjB;AAAA,EAEA,iBAAA,CAAkB,OAAc,IAAA,EAAiB;AA5BnD,IAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA;AA6BI,IAAA,MAAM,MAAA,GAAA,CAAS,EAAA,GAAA,IAAA,CAAK,KAAA,CAAM,MAAA,KAAX,IAAA,GAAA,EAAA,GAAqBC,uBAAA;AACpC,IAAA,IAAI,KAAK,cAAA,EAAgB;AACvB,MAAA,MAAA,CAAO,UAAA,CAAW,IAAA,EAAM,oBAAA,EAAsB,EAAE,gBAAgB,IAAA,CAAK,cAAA,CAAe,IAAA,EAAK,CAAE,KAAA,CAAM,CAAA,EAAG,IAAI,CAAA,IAAK,OAAO,CAAA;AAAA,IACtH;AACA,IAAA,MAAA,CAAO,KAAA,CAAM,KAAA,EAAO,EAAE,IAAA,EAAM,KAAK,KAAA,CAAM,IAAA,EAAM,OAAA,EAAS,KAAA,EAAO,IAAA,EAAM,EAAE,MAAA,EAAQ,gBAAA,IAAoB,CAAA;AACjG,IAAA,KAAK,OAAO,KAAA,EAAM;AAClB,IAAA,CAAA,EAAA,GAAA,CAAA,EAAA,GAAA,IAAA,CAAK,KAAA,EAAM,OAAA,KAAX,IAAA,GAAA,MAAA,GAAA,EAAA,CAAA,IAAA,CAAA,EAAA,EAAqB,KAAA,EAAO,IAAA,CAAA;AAAA,EAC9B;AAAA,EAIA,MAAA,GAAS;AACP,IAAA,MAAM,EAAE,KAAA,EAAM,GAAI,IAAA,CAAK,KAAA;AACvB,IAAA,IAAI,CAAC,KAAA,EAAO,OAAO,IAAA,CAAK,KAAA,CAAM,QAAA;AAC9B,IAAA,MAAM,EAAE,QAAA,EAAS,GAAI,IAAA,CAAK,KAAA;AAC1B,IAAA,OAAO,OAAO,QAAA,KAAa,UAAA,GAAa,QAAA,CAAS,EAAE,KAAA,EAAO,KAAA,EAAO,IAAA,CAAK,KAAA,EAAO,CAAA,GAAK,QAAA,IAAA,IAAA,GAAA,QAAA,GAAY,IAAA;AAAA,EAChG;AACF;AAGO,SAAS,kBAAA,CAAmB,IAAA,EAA0B,MAAA,GAAsBA,uBAAA,EAAO;AACxF,EAAAC,eAAA,CAAU,MAAM;AACd,IAAA,IAAI,IAAA,EAAM,MAAA,CAAO,UAAA,CAAW,YAAA,EAAc,IAAI,CAAA;AAAA,EAChD,CAAA,EAAG,CAAC,IAAA,EAAM,MAAM,CAAC,CAAA;AACnB;AAYO,SAAS,mBAAA,CAAoB,MAAA,EAAoB,MAAA,GAAsBD,uBAAA,EAAO;AACnF,EAAA,OAAO,MAAA,CAAO,SAAA,CAAU,YAAA,EAAc,CAAC,EAAE,UAAA,EAAW,KAAM,MAAA,CAAO,UAAA,CAAW,YAAA,EAAc,UAAA,CAAW,QAAQ,CAAC,CAAA;AAChH","file":"chunk-KUJ4EW3D.cjs","sourcesContent":["import { Component, useEffect, type ErrorInfo, type ReactNode } from \"react\";\nimport { deBug, type DebugClient } from \"./index\";\n\nexport interface DebugErrorBoundaryProps {\n  children?: ReactNode;\n  /** What to render after a crash. A function gets the error and a reset callback. */\n  fallback?: ReactNode | ((props: { error: Error; reset: () => void }) => ReactNode);\n  /** Part of the app this boundary protects, e.g. \"checkout\". */\n  flow?: string;\n  client?: DebugClient;\n  onError?: (error: Error, info: ErrorInfo) => void;\n}\n\ninterface State {\n  error: Error | null;\n}\n\n/**\n * Catches render errors that React would otherwise swallow (or turn into a white/red screen)\n * and reports them. Works in React DOM and React Native.\n */\nexport class DebugErrorBoundary extends Component<DebugErrorBoundaryProps, State> {\n  state: State = { error: null };\n\n  static getDerivedStateFromError(error: Error): State {\n    return { error };\n  }\n\n  componentDidCatch(error: Error, info: ErrorInfo) {\n    const client = this.props.client ?? deBug;\n    if (info.componentStack) {\n      client.breadcrumb(\"ui\", \"React render error\", { componentStack: info.componentStack.trim().slice(0, 1500) }, \"error\");\n    }\n    client.error(error, { flow: this.props.flow, handled: false, tags: { source: \"error-boundary\" } });\n    void client.flush();\n    this.props.onError?.(error, info);\n  }\n\n  reset = () => this.setState({ error: null });\n\n  render() {\n    const { error } = this.state;\n    if (!error) return this.props.children;\n    const { fallback } = this.props;\n    return typeof fallback === \"function\" ? fallback({ error, reset: this.reset }) : (fallback ?? null);\n  }\n}\n\n/** Adds a navigation breadcrumb whenever `path` changes. Works with any router. */\nexport function useDebugNavigation(path: string | undefined, client: DebugClient = deBug) {\n  useEffect(() => {\n    if (path) client.breadcrumb(\"navigation\", path);\n  }, [path, client]);\n}\n\n/** Minimal shape of a TanStack Router instance (avoids a hard dependency). */\ninterface RouterLike {\n  subscribe(event: \"onResolved\", fn: (e: { toLocation: { pathname: string; href?: string } }) => void): () => void;\n}\n\n/**\n * Records a breadcrumb for every navigation in a TanStack Router app:\n *   const router = createRouter({ routeTree }); trackTanStackRouter(router);\n * Returns an unsubscribe function.\n */\nexport function trackTanStackRouter(router: RouterLike, client: DebugClient = deBug) {\n  return router.subscribe(\"onResolved\", ({ toLocation }) => client.breadcrumb(\"navigation\", toLocation.pathname));\n}\n\nexport { deBug } from \"./index\";\n"]}

package/dist/chunk-NSWUGBA2.cjs

@@ -0,0 +1,75 @@
+'use strict';
+
+var chunkXEFWRCN4_cjs = require('./chunk-XEFWRCN4.cjs');
+var reactNative = require('react-native');
+
+function nativeContext(opts = {}) {
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i;
+  const c = (_a = reactNative.Platform.constants) != null ? _a : {};
+  const di = opts.deviceInfo;
+  const rn = c.reactNativeVersion;
+  const hermes = typeof globalThis.HermesInternal !== "undefined";
+  const call = (fn) => {
+    try {
+      return fn == null ? void 0 : fn();
+    } catch {
+      return void 0;
+    }
+  };
+  const totalMemory = call((_b = di == null ? void 0 : di.getTotalMemorySync) == null ? void 0 : _b.bind(di));
+  return {
+    os: { name: reactNative.Platform.OS, version: reactNative.Platform.OS === "android" ? (_c = c.Release) != null ? _c : String(reactNative.Platform.Version) : String(reactNative.Platform.Version) },
+    runtime: { name: "react-native", version: rn ? `${rn.major}.${rn.minor}.${rn.patch}` : void 0, engine: hermes ? "hermes" : "jsc" },
+    device: {
+      model: (_d = call(di == null ? void 0 : di.getModel.bind(di))) != null ? _d : c.Model,
+      brand: (_e = call(di == null ? void 0 : di.getBrand.bind(di))) != null ? _e : c.Brand,
+      manufacturer: (_g = call((_f = di == null ? void 0 : di.getManufacturerSync) == null ? void 0 : _f.bind(di))) != null ? _g : c.Manufacturer,
+      isEmulator: (_i = call((_h = di == null ? void 0 : di.isEmulatorSync) == null ? void 0 : _h.bind(di))) != null ? _i : c.Fingerprint ? /generic|emulator/i.test(c.Fingerprint) : void 0,
+      memoryMb: totalMemory ? Math.round(totalMemory / 1024 / 1024) : void 0,
+      type: di ? call(di.isTablet.bind(di)) ? "tablet" : "phone" : reactNative.Platform.OS === "ios" && reactNative.Platform.isPad ? "tablet" : "phone"
+    },
+    app: { version: call(di == null ? void 0 : di.getVersion.bind(di)), build: call(di == null ? void 0 : di.getBuildNumber.bind(di)) },
+    locale: chunkXEFWRCN4_cjs.locale(),
+    timezone: chunkXEFWRCN4_cjs.timezone()
+  };
+}
+function initReactNative(options, client = chunkXEFWRCN4_cjs.deBug) {
+  var _a, _b;
+  const { deviceInfo, captureUnhandledRejections = "production", ...rest } = options;
+  const base = nativeContext({ deviceInfo });
+  client.init({
+    ...rest,
+    app: { ...base.app, ...rest.app },
+    context: chunkXEFWRCN4_cjs.mergeContext(base, (_a = rest.context) != null ? _a : {})
+  });
+  reactNative.AppState.addEventListener("change", (state) => {
+    if (state !== "active") void client.flush();
+  });
+  const dev = typeof __DEV__ !== "undefined" && __DEV__;
+  const tracker = (_b = globalThis.HermesInternal) == null ? void 0 : _b.enablePromiseRejectionTracker;
+  if (tracker && (captureUnhandledRejections === true || captureUnhandledRejections === "production" && !dev)) {
+    tracker({
+      allRejections: true,
+      onUnhandled: (_id, reason) => client.error(reason, { handled: false, tags: { source: "unhandled-rejection" } }),
+      onHandled: () => {
+      }
+    });
+  }
+  return client;
+}
+function trackReactNavigation(ref, client = chunkXEFWRCN4_cjs.deBug) {
+  let last;
+  const record = () => {
+    var _a;
+    const name = (_a = ref.getCurrentRoute()) == null ? void 0 : _a.name;
+    if (name && name !== last) client.breadcrumb("navigation", last ? `${last} \u2192 ${name}` : name);
+    last = name != null ? name : last;
+  };
+  return { onReady: record, onStateChange: record };
+}
+
+exports.initReactNative = initReactNative;
+exports.nativeContext = nativeContext;
+exports.trackReactNavigation = trackReactNavigation;
+//# sourceMappingURL=chunk-NSWUGBA2.cjs.map
+//# sourceMappingURL=chunk-NSWUGBA2.cjs.map

package/dist/chunk-NSWUGBA2.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/react-native.ts"],"names":["Platform","locale","timezone","deBug","mergeContext","AppState"],"mappings":"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","file":"chunk-NSWUGBA2.cjs","sourcesContent":["import { AppState, Platform } from \"react-native\";\nimport { deBug, type DebugClient, type InitOptions } from \"./index\";\nimport { locale, mergeContext, timezone, type ContextPatch } from \"./context\";\n\nexport * from \"./react\";\n\n/** The subset of react-native-device-info we read. Pass the module itself: `import DeviceInfo from \"react-native-device-info\"`. */\nexport interface DeviceInfoModule {\n  getModel(): string;\n  getBrand(): string;\n  getVersion(): string;\n  getBuildNumber(): string;\n  isTablet(): boolean;\n  getManufacturerSync?(): string;\n  isEmulatorSync?(): boolean;\n  getTotalMemorySync?(): number;\n}\n\ntype RNConstants = {\n  Release?: string;\n  Model?: string;\n  Brand?: string;\n  Manufacturer?: string;\n  Fingerprint?: string;\n  reactNativeVersion?: { major: number; minor: number; patch: number };\n};\n\n/**\n * Context for bare React Native. Reads what `react-native` exposes on its own; pass\n * react-native-device-info for model, app version and memory on both platforms.\n */\nexport function nativeContext(opts: { deviceInfo?: DeviceInfoModule } = {}): ContextPatch {\n  const c = (Platform.constants ?? {}) as RNConstants;\n  const di = opts.deviceInfo;\n  const rn = c.reactNativeVersion;\n  const hermes = typeof (globalThis as { HermesInternal?: unknown }).HermesInternal !== \"undefined\";\n  const call = <T,>(fn?: () => T) => {\n    try {\n      return fn?.();\n    } catch {\n      return undefined;\n    }\n  };\n  const totalMemory = call(di?.getTotalMemorySync?.bind(di));\n  return {\n    os: { name: Platform.OS, version: Platform.OS === \"android\" ? (c.Release ?? String(Platform.Version)) : String(Platform.Version) },\n    runtime: { name: \"react-native\", version: rn ? `${rn.major}.${rn.minor}.${rn.patch}` : undefined, engine: hermes ? \"hermes\" : \"jsc\" },\n    device: {\n      model: call(di?.getModel.bind(di)) ?? c.Model,\n      brand: call(di?.getBrand.bind(di)) ?? c.Brand,\n      manufacturer: call(di?.getManufacturerSync?.bind(di)) ?? c.Manufacturer,\n      isEmulator: call(di?.isEmulatorSync?.bind(di)) ?? (c.Fingerprint ? /generic|emulator/i.test(c.Fingerprint) : undefined),\n      memoryMb: totalMemory ? Math.round(totalMemory / 1024 / 1024) : undefined,\n      type: di ? (call(di.isTablet.bind(di)) ? \"tablet\" : \"phone\") : Platform.OS === \"ios\" && (Platform as { isPad?: boolean }).isPad ? \"tablet\" : \"phone\",\n    },\n    app: { version: call(di?.getVersion.bind(di)), build: call(di?.getBuildNumber.bind(di)) } as ContextPatch[\"app\"],\n    locale: locale(),\n    timezone: timezone(),\n  };\n}\n\nexport interface ReactNativeInitOptions extends InitOptions {\n  deviceInfo?: DeviceInfoModule;\n  /**\n   * Report unhandled promise rejections (Hermes). Default \"production\": in development React\n   * Native's own yellow-box warning keeps working. `true` captures in development too.\n   */\n  captureUnhandledRejections?: boolean | \"production\";\n}\n\ndeclare const __DEV__: boolean | undefined;\n\n/** Initialise deBug in a React Native app (bare or Expo). Fills in device context and flushes when the app is backgrounded. */\nexport function initReactNative(options: ReactNativeInitOptions, client: DebugClient = deBug): DebugClient {\n  const { deviceInfo, captureUnhandledRejections = \"production\", ...rest } = options;\n  const base = nativeContext({ deviceInfo });\n  client.init({\n    ...rest,\n    app: { ...(base.app as object), ...rest.app },\n    context: mergeContext(base, rest.context ?? {}),\n  });\n\n  AppState.addEventListener(\"change\", (state) => {\n    if (state !== \"active\") void client.flush();\n  });\n\n  const dev = typeof __DEV__ !== \"undefined\" && __DEV__;\n  const tracker = (globalThis as { HermesInternal?: { enablePromiseRejectionTracker?: (o: object) => void } }).HermesInternal\n    ?.enablePromiseRejectionTracker;\n  if (tracker && (captureUnhandledRejections === true || (captureUnhandledRejections === \"production\" && !dev))) {\n    tracker({\n      allRejections: true,\n      onUnhandled: (_id: number, reason: unknown) => client.error(reason, { handled: false, tags: { source: \"unhandled-rejection\" } }),\n      onHandled: () => {},\n    });\n  }\n  return client;\n}\n\n/** Minimal shape of a React Navigation container ref. */\ninterface NavigationRefLike {\n  getCurrentRoute(): { name: string } | undefined;\n}\n\n/**\n * Breadcrumbs for React Navigation. Spread the result onto your container:\n *   const nav = useNavigationContainerRef();\n *   <NavigationContainer ref={nav} {...trackReactNavigation(nav)}>\n */\nexport function trackReactNavigation(ref: NavigationRefLike, client: DebugClient = deBug) {\n  let last: string | undefined;\n  const record = () => {\n    const name = ref.getCurrentRoute()?.name;\n    if (name && name !== last) client.breadcrumb(\"navigation\", last ? `${last} → ${name}` : name);\n    last = name ?? last;\n  };\n  return { onReady: record, onStateChange: record };\n}\n"]}