@debugkit/sdk 0.0.0-stage → 0.2.0

package/dist/client-ekzlpWIR.d.cts

@@ -0,0 +1,220 @@
+import { ContextInput, EventInput, Breadcrumb, Severity, parseStack } from '@debugkit/schema/core';
+
+type Shallow<T> = {
+    [K in keyof T]?: T[K] extends object ? Partial<T[K]> : T[K];
+};
+type ContextPatch = Shallow<ContextInput>;
+/** Merge two context patches one level deep (os, device, app ... are merged field by field). */
+declare function mergeContext(a: ContextPatch, b: ContextPatch): ContextPatch;
+/**
+ * Best-effort context for browsers (React, TanStack Start/Router client, Next client ...).
+ * Safe to call in any runtime: it never touches globals that might not exist.
+ */
+declare function browserContext(): ContextPatch;
+
+/**
+ * Automatic instrumentation installed by `init()`: network requests, console, navigation,
+ * clicks and page lifecycle. Every installer is a no-op on platforms that lack the global it
+ * patches, and returns a function that undoes the patch.
+ */
+interface RequestInfo {
+    method: string;
+    url: string;
+    status?: number;
+    error?: unknown;
+    aborted?: boolean;
+    timedOut?: boolean;
+    durationMs: number;
+    /** Stack captured where the request was made, so a failure points at the calling code. */
+    stack?: string;
+}
+/** What the instrumentation needs from the client. */
+interface AutoSink {
+    request(info: RequestInfo): void;
+    crumb(category: "navigation" | "network" | "ui" | "log", message: string, level?: "debug" | "info" | "warning" | "error", data?: Record<string, string | number | boolean | null>): void;
+    navigated(to: string): void;
+    lifecycle(state: "foreground" | "background"): void;
+    ignored(url: string): boolean;
+}
+/**
+ * "https://api.x.com/v1/orders/8812?token=abc" → "api.x.com/v1/orders/:id". Query strings and
+ * fragments never leave the device (they often carry tokens and personal data), and ids are
+ * replaced so requests group by endpoint. Same-origin URLs keep only the path.
+ */
+declare function normaliseUrl(raw: string): string;
+
+declare const SDK_NAME = "@debugkit/sdk";
+declare const SDK_VERSION = "0.2.0";
+/** Optional persistence so events survive app restarts / offline. e.g. AsyncStorage. */
+interface QueueStorage {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+}
+interface InitOptions {
+    /** URL of the ingest function deployed in your cloud. */
+    endpoint: string;
+    /** Public, write-only key. Safe to ship in the app. */
+    ingestKey: string;
+    app: {
+        id: string;
+        version?: string;
+        build?: string;
+        environment?: string;
+    };
+    /**
+     * Platform context. Defaults to browserContext() in browsers. The framework entry points
+     * (`/expo`, `/react-native`, `/node`) fill this in for you.
+     */
+    context?: ContextPatch;
+    /**
+     * What deBug records on its own once initialised. Everything is on by default; pass `false`
+     * to turn it all off, or switch parts off: `autoCapture: { console: false }`.
+     */
+    autoCapture?: boolean | AutoCaptureOptions;
+    /** Network capture settings. */
+    network?: NetworkOptions;
+    /** Fraction of errors and events to keep, 0 to 1. Sessions are never sampled. Default 1. */
+    sampleRate?: number;
+    /** At most this many errors are sent per minute, and at most a sixth of that for one repeating error. Default 60. */
+    maxErrorsPerMinute?: number;
+    /** @deprecated Use `autoCapture: { errors: false }`. */
+    captureGlobalErrors?: boolean;
+    storage?: QueueStorage;
+    /** How often queued events are sent. 0 disables the timer (edge runtimes): call flush() yourself. Default 5000. */
+    flushIntervalMs?: number;
+    maxBatch?: number;
+    maxBreadcrumbs?: number;
+    /** Drop or edit events before they are sent (PII scrubbing). Return null to drop. */
+    beforeSend?: (e: EventInput) => EventInput | null;
+    fetch?: typeof fetch;
+    debug?: boolean;
+}
+interface AutoCaptureOptions {
+    /** Uncaught errors and unhandled promise rejections. */
+    errors?: boolean;
+    /** fetch and XMLHttpRequest: a breadcrumb for every request, an error for each failed one. */
+    network?: boolean;
+    /** console.warn and console.error as breadcrumbs. */
+    console?: boolean;
+    /** Page changes in browsers (History API), so any router is covered. */
+    navigation?: boolean;
+    /** Clicks on buttons, links and other controls in browsers, by their label. */
+    clicks?: boolean;
+    /** Foreground/background and online/offline as breadcrumbs; flushes when the app is hidden. */
+    lifecycle?: boolean;
+    /** Session start, errored and crashed markers, for crash-free rates per release. */
+    sessions?: boolean;
+}
+interface NetworkOptions {
+    /** URLs never recorded (substring or regex). The ingest endpoint is always skipped. */
+    ignoreUrls?: (string | RegExp)[];
+    /**
+     * Tag requests with a flow by URL, first match wins:
+     * `flows: [["/v2/auth/", "auth.login"], [/\/payments\//, "checkout.payment"]]`.
+     */
+    flows?: [string | RegExp, string][];
+    /** Which HTTP statuses count as failures. Default: 500 and above. Network failures and timeouts always count. */
+    isFailure?: (status: number, url: string) => boolean;
+    /** Requests slower than this get a warning breadcrumb. Default 3000ms. */
+    slowMs?: number;
+}
+interface EventMeta {
+    flow?: string;
+    step?: string;
+    tags?: Record<string, string>;
+}
+declare class DebugClient {
+    private opts;
+    private queue;
+    private crumbs;
+    private session;
+    private user;
+    private timer;
+    private flushing;
+    private backoffUntil;
+    private failures;
+    private ready;
+    private handlersInstalled;
+    private auto;
+    private restores;
+    private sessionState;
+    private lastNav;
+    private limits;
+    /** fetch as it was before instrumentation, so our own uploads are never recorded. */
+    private rawFetch;
+    init(options: InitOptions): this;
+    /** Which automatic captures are on, after defaults. */
+    get autoCapture(): Readonly<Required<AutoCaptureOptions>>;
+    /**
+     * Begin a new session: a fresh id and a "started" marker. Called by `init()`, and by the
+     * React Native entry when the app returns after 30 minutes in the background.
+     */
+    startSession(): void;
+    /** Record a navigation breadcrumb ("from → to"). Repeated paths are ignored. */
+    navigated(to: string): void;
+    get initialized(): boolean;
+    /** Merge extra context (e.g. after an async device lookup). Applies to events sent from now on. */
+    setContext(patch: ContextPatch): void;
+    setUser(id: string | undefined): void;
+    breadcrumb(category: Breadcrumb["category"], message: string, data?: Record<string, string | number | boolean | null>, level?: Breadcrumb["level"]): void;
+    /** Log an error. `flow` is the part of the app it belongs to, e.g. "auth.login". */
+    error(err: unknown, meta?: EventMeta & {
+        severity?: Severity;
+        handled?: boolean;
+        fatal?: boolean;
+    }): void;
+    /** Log a custom event. Use outcome to let deBug compute failure rates per flow. */
+    event(name: string, meta?: EventMeta & {
+        outcome?: "success" | "failure" | "abandoned";
+        props?: Record<string, string | number | boolean | null>;
+    }): void;
+    /**
+     * Wraps an async step: logs a success or failure outcome for the flow, plus the error.
+     * Pass `{ captureError: false }` when the error is already reported elsewhere, e.g. a
+     * server function wrapped in withDebug, so it isn't counted twice.
+     */
+    track<T>(flow: string, step: string, fn: () => Promise<T>, opts?: {
+        captureError?: boolean;
+    }): Promise<T>;
+    flush(): Promise<void>;
+    /** Stop the flush timer, undo automatic instrumentation and send what is queued. */
+    close(): Promise<void>;
+    /** @internal Used by the platform entry points for errors that have no thrown value. */
+    captureError(e: {
+        name: string;
+        message: string;
+        stack?: string;
+        frames?: ReturnType<typeof parseStack>;
+    }, meta: EventMeta & {
+        severity?: Severity;
+        handled?: boolean;
+        fatal?: boolean;
+    }, request?: {
+        method: string;
+        url: string;
+        status?: number;
+        durationMs?: number;
+    }): void;
+    /** Per-minute limits: one runaway error can't flood the queue, the network or your database. */
+    private allowError;
+    private sampled;
+    private enqueue;
+    /** Queue without sampling (sessions must be complete for crash-free rates to be right). */
+    private push;
+    private buildContext;
+    /** Set when the ingest rejects 0.2 fields: it predates them, so send what it understands. */
+    private legacyIngest;
+    private send;
+    private persist;
+    private restore;
+    private installGlobalHandlers;
+    private instrument;
+    private uninstrument;
+    /** The bridge the instrumentation (./auto, and the platform entry points) reports through. */
+    sink(): AutoSink;
+    private isIgnored;
+    private recordRequest;
+    private log;
+}
+
+export { type AutoCaptureOptions as A, type ContextPatch as C, DebugClient as D, type EventMeta as E, type InitOptions as I, type NetworkOptions as N, type QueueStorage as Q, SDK_NAME as S, SDK_VERSION as a, browserContext as b, mergeContext as m, normaliseUrl as n };

package/dist/client-ekzlpWIR.d.ts

@@ -0,0 +1,220 @@
+import { ContextInput, EventInput, Breadcrumb, Severity, parseStack } from '@debugkit/schema/core';
+
+type Shallow<T> = {
+    [K in keyof T]?: T[K] extends object ? Partial<T[K]> : T[K];
+};
+type ContextPatch = Shallow<ContextInput>;
+/** Merge two context patches one level deep (os, device, app ... are merged field by field). */
+declare function mergeContext(a: ContextPatch, b: ContextPatch): ContextPatch;
+/**
+ * Best-effort context for browsers (React, TanStack Start/Router client, Next client ...).
+ * Safe to call in any runtime: it never touches globals that might not exist.
+ */
+declare function browserContext(): ContextPatch;
+
+/**
+ * Automatic instrumentation installed by `init()`: network requests, console, navigation,
+ * clicks and page lifecycle. Every installer is a no-op on platforms that lack the global it
+ * patches, and returns a function that undoes the patch.
+ */
+interface RequestInfo {
+    method: string;
+    url: string;
+    status?: number;
+    error?: unknown;
+    aborted?: boolean;
+    timedOut?: boolean;
+    durationMs: number;
+    /** Stack captured where the request was made, so a failure points at the calling code. */
+    stack?: string;
+}
+/** What the instrumentation needs from the client. */
+interface AutoSink {
+    request(info: RequestInfo): void;
+    crumb(category: "navigation" | "network" | "ui" | "log", message: string, level?: "debug" | "info" | "warning" | "error", data?: Record<string, string | number | boolean | null>): void;
+    navigated(to: string): void;
+    lifecycle(state: "foreground" | "background"): void;
+    ignored(url: string): boolean;
+}
+/**
+ * "https://api.x.com/v1/orders/8812?token=abc" → "api.x.com/v1/orders/:id". Query strings and
+ * fragments never leave the device (they often carry tokens and personal data), and ids are
+ * replaced so requests group by endpoint. Same-origin URLs keep only the path.
+ */
+declare function normaliseUrl(raw: string): string;
+
+declare const SDK_NAME = "@debugkit/sdk";
+declare const SDK_VERSION = "0.2.0";
+/** Optional persistence so events survive app restarts / offline. e.g. AsyncStorage. */
+interface QueueStorage {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+}
+interface InitOptions {
+    /** URL of the ingest function deployed in your cloud. */
+    endpoint: string;
+    /** Public, write-only key. Safe to ship in the app. */
+    ingestKey: string;
+    app: {
+        id: string;
+        version?: string;
+        build?: string;
+        environment?: string;
+    };
+    /**
+     * Platform context. Defaults to browserContext() in browsers. The framework entry points
+     * (`/expo`, `/react-native`, `/node`) fill this in for you.
+     */
+    context?: ContextPatch;
+    /**
+     * What deBug records on its own once initialised. Everything is on by default; pass `false`
+     * to turn it all off, or switch parts off: `autoCapture: { console: false }`.
+     */
+    autoCapture?: boolean | AutoCaptureOptions;
+    /** Network capture settings. */
+    network?: NetworkOptions;
+    /** Fraction of errors and events to keep, 0 to 1. Sessions are never sampled. Default 1. */
+    sampleRate?: number;
+    /** At most this many errors are sent per minute, and at most a sixth of that for one repeating error. Default 60. */
+    maxErrorsPerMinute?: number;
+    /** @deprecated Use `autoCapture: { errors: false }`. */
+    captureGlobalErrors?: boolean;
+    storage?: QueueStorage;
+    /** How often queued events are sent. 0 disables the timer (edge runtimes): call flush() yourself. Default 5000. */
+    flushIntervalMs?: number;
+    maxBatch?: number;
+    maxBreadcrumbs?: number;
+    /** Drop or edit events before they are sent (PII scrubbing). Return null to drop. */
+    beforeSend?: (e: EventInput) => EventInput | null;
+    fetch?: typeof fetch;
+    debug?: boolean;
+}
+interface AutoCaptureOptions {
+    /** Uncaught errors and unhandled promise rejections. */
+    errors?: boolean;
+    /** fetch and XMLHttpRequest: a breadcrumb for every request, an error for each failed one. */
+    network?: boolean;
+    /** console.warn and console.error as breadcrumbs. */
+    console?: boolean;
+    /** Page changes in browsers (History API), so any router is covered. */
+    navigation?: boolean;
+    /** Clicks on buttons, links and other controls in browsers, by their label. */
+    clicks?: boolean;
+    /** Foreground/background and online/offline as breadcrumbs; flushes when the app is hidden. */
+    lifecycle?: boolean;
+    /** Session start, errored and crashed markers, for crash-free rates per release. */
+    sessions?: boolean;
+}
+interface NetworkOptions {
+    /** URLs never recorded (substring or regex). The ingest endpoint is always skipped. */
+    ignoreUrls?: (string | RegExp)[];
+    /**
+     * Tag requests with a flow by URL, first match wins:
+     * `flows: [["/v2/auth/", "auth.login"], [/\/payments\//, "checkout.payment"]]`.
+     */
+    flows?: [string | RegExp, string][];
+    /** Which HTTP statuses count as failures. Default: 500 and above. Network failures and timeouts always count. */
+    isFailure?: (status: number, url: string) => boolean;
+    /** Requests slower than this get a warning breadcrumb. Default 3000ms. */
+    slowMs?: number;
+}
+interface EventMeta {
+    flow?: string;
+    step?: string;
+    tags?: Record<string, string>;
+}
+declare class DebugClient {
+    private opts;
+    private queue;
+    private crumbs;
+    private session;
+    private user;
+    private timer;
+    private flushing;
+    private backoffUntil;
+    private failures;
+    private ready;
+    private handlersInstalled;
+    private auto;
+    private restores;
+    private sessionState;
+    private lastNav;
+    private limits;
+    /** fetch as it was before instrumentation, so our own uploads are never recorded. */
+    private rawFetch;
+    init(options: InitOptions): this;
+    /** Which automatic captures are on, after defaults. */
+    get autoCapture(): Readonly<Required<AutoCaptureOptions>>;
+    /**
+     * Begin a new session: a fresh id and a "started" marker. Called by `init()`, and by the
+     * React Native entry when the app returns after 30 minutes in the background.
+     */
+    startSession(): void;
+    /** Record a navigation breadcrumb ("from → to"). Repeated paths are ignored. */
+    navigated(to: string): void;
+    get initialized(): boolean;
+    /** Merge extra context (e.g. after an async device lookup). Applies to events sent from now on. */
+    setContext(patch: ContextPatch): void;
+    setUser(id: string | undefined): void;
+    breadcrumb(category: Breadcrumb["category"], message: string, data?: Record<string, string | number | boolean | null>, level?: Breadcrumb["level"]): void;
+    /** Log an error. `flow` is the part of the app it belongs to, e.g. "auth.login". */
+    error(err: unknown, meta?: EventMeta & {
+        severity?: Severity;
+        handled?: boolean;
+        fatal?: boolean;
+    }): void;
+    /** Log a custom event. Use outcome to let deBug compute failure rates per flow. */
+    event(name: string, meta?: EventMeta & {
+        outcome?: "success" | "failure" | "abandoned";
+        props?: Record<string, string | number | boolean | null>;
+    }): void;
+    /**
+     * Wraps an async step: logs a success or failure outcome for the flow, plus the error.
+     * Pass `{ captureError: false }` when the error is already reported elsewhere, e.g. a
+     * server function wrapped in withDebug, so it isn't counted twice.
+     */
+    track<T>(flow: string, step: string, fn: () => Promise<T>, opts?: {
+        captureError?: boolean;
+    }): Promise<T>;
+    flush(): Promise<void>;
+    /** Stop the flush timer, undo automatic instrumentation and send what is queued. */
+    close(): Promise<void>;
+    /** @internal Used by the platform entry points for errors that have no thrown value. */
+    captureError(e: {
+        name: string;
+        message: string;
+        stack?: string;
+        frames?: ReturnType<typeof parseStack>;
+    }, meta: EventMeta & {
+        severity?: Severity;
+        handled?: boolean;
+        fatal?: boolean;
+    }, request?: {
+        method: string;
+        url: string;
+        status?: number;
+        durationMs?: number;
+    }): void;
+    /** Per-minute limits: one runaway error can't flood the queue, the network or your database. */
+    private allowError;
+    private sampled;
+    private enqueue;
+    /** Queue without sampling (sessions must be complete for crash-free rates to be right). */
+    private push;
+    private buildContext;
+    /** Set when the ingest rejects 0.2 fields: it predates them, so send what it understands. */
+    private legacyIngest;
+    private send;
+    private persist;
+    private restore;
+    private installGlobalHandlers;
+    private instrument;
+    private uninstrument;
+    /** The bridge the instrumentation (./auto, and the platform entry points) reports through. */
+    sink(): AutoSink;
+    private isIgnored;
+    private recordRequest;
+    private log;
+}
+
+export { type AutoCaptureOptions as A, type ContextPatch as C, DebugClient as D, type EventMeta as E, type InitOptions as I, type NetworkOptions as N, type QueueStorage as Q, SDK_NAME as S, SDK_VERSION as a, browserContext as b, mergeContext as m, normaliseUrl as n };

package/dist/expo-router.cjs

@@ -0,0 +1,13 @@
+'use strict';
+
+var chunkYELZOB7J_cjs = require('./chunk-YELZOB7J.cjs');
+var chunkEGCXLOFH_cjs = require('./chunk-EGCXLOFH.cjs');
+var expoRouter = require('expo-router');
+
+function useDebugExpoRouter(client = chunkEGCXLOFH_cjs.deBug) {
+  chunkYELZOB7J_cjs.useDebugNavigation(expoRouter.usePathname(), client);
+}
+
+exports.useDebugExpoRouter = useDebugExpoRouter;
+//# sourceMappingURL=expo-router.cjs.map
+//# sourceMappingURL=expo-router.cjs.map

package/dist/expo-router.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/expo-router.ts"],"names":["deBug","useDebugNavigation","usePathname"],"mappings":";;;;;;AAQO,SAAS,kBAAA,CAAmB,SAAsBA,uBAAA,EAAO;AAC9D,EAAAC,oCAAA,CAAmBC,sBAAA,IAAe,MAAM,CAAA;AAC1C","file":"expo-router.cjs","sourcesContent":["import { usePathname } from \"expo-router\";\nimport { deBug, type DebugClient } from \"./index\";\nimport { useDebugNavigation } from \"./react\";\n\n/**\n * Navigation breadcrumbs for Expo Router. Call once in your root layout:\n *   export default function RootLayout() { useDebugExpoRouter(); return <Stack />; }\n */\nexport function useDebugExpoRouter(client: DebugClient = deBug) {\n  useDebugNavigation(usePathname(), client);\n}\n"]}

package/dist/expo-router.d.cts

@@ -0,0 +1,10 @@
+import { D as DebugClient } from './client-ekzlpWIR.cjs';
+import '@debugkit/schema/core';
+
+/**
+ * Navigation breadcrumbs for Expo Router. Call once in your root layout:
+ *   export default function RootLayout() { useDebugExpoRouter(); return <Stack />; }
+ */
+declare function useDebugExpoRouter(client?: DebugClient): void;
+
+export { useDebugExpoRouter };

package/dist/expo-router.d.ts

@@ -0,0 +1,10 @@
+import { D as DebugClient } from './client-ekzlpWIR.js';
+import '@debugkit/schema/core';
+
+/**
+ * Navigation breadcrumbs for Expo Router. Call once in your root layout:
+ *   export default function RootLayout() { useDebugExpoRouter(); return <Stack />; }
+ */
+declare function useDebugExpoRouter(client?: DebugClient): void;
+
+export { useDebugExpoRouter };

package/dist/expo-router.js

@@ -0,0 +1,11 @@
+import { useDebugNavigation } from './chunk-3WRI3DI2.js';
+import { deBug } from './chunk-5C7KJJNO.js';
+import { usePathname } from 'expo-router';
+
+function useDebugExpoRouter(client = deBug) {
+  useDebugNavigation(usePathname(), client);
+}
+
+export { useDebugExpoRouter };
+//# sourceMappingURL=expo-router.js.map
+//# sourceMappingURL=expo-router.js.map

package/dist/expo-router.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/expo-router.ts"],"names":[],"mappings":";;;;AAQO,SAAS,kBAAA,CAAmB,SAAsB,KAAA,EAAO;AAC9D,EAAA,kBAAA,CAAmB,WAAA,IAAe,MAAM,CAAA;AAC1C","file":"expo-router.js","sourcesContent":["import { usePathname } from \"expo-router\";\nimport { deBug, type DebugClient } from \"./index\";\nimport { useDebugNavigation } from \"./react\";\n\n/**\n * Navigation breadcrumbs for Expo Router. Call once in your root layout:\n *   export default function RootLayout() { useDebugExpoRouter(); return <Stack />; }\n */\nexport function useDebugExpoRouter(client: DebugClient = deBug) {\n  useDebugNavigation(usePathname(), client);\n}\n"]}

package/dist/expo.cjs

@@ -0,0 +1,97 @@
+'use strict';
+
+var chunkNJ6DTUVX_cjs = require('./chunk-NJ6DTUVX.cjs');
+var chunkYELZOB7J_cjs = require('./chunk-YELZOB7J.cjs');
+var chunkEGCXLOFH_cjs = require('./chunk-EGCXLOFH.cjs');
+var Application = require('expo-application');
+var Device = require('expo-device');
+
+function _interopNamespace(e) {
+  if (e && e.__esModule) return e;
+  var n = Object.create(null);
+  if (e) {
+    Object.keys(e).forEach(function (k) {
+      if (k !== 'default') {
+        var d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: function () { return e[k]; }
+        });
+      }
+    });
+  }
+  n.default = e;
+  return Object.freeze(n);
+}
+
+var Application__namespace = /*#__PURE__*/_interopNamespace(Application);
+var Device__namespace = /*#__PURE__*/_interopNamespace(Device);
+
+function osName2(raw) {
+  const n = (raw != null ? raw : "").toLowerCase();
+  if (n.includes("android")) return "android";
+  if (n === "ios" || n === "ipados") return "ios";
+  return n || "unknown";
+}
+var DEVICE_TYPES = { 1: "phone", 2: "tablet", 3: "desktop", 4: "tv" };
+function expoContext() {
+  var _a, _b, _c, _d, _e, _f, _g;
+  return {
+    os: Device__namespace.osVersion ? { name: osName2(Device__namespace.osName), version: Device__namespace.osVersion } : void 0,
+    device: {
+      model: (_a = Device__namespace.modelName) != null ? _a : void 0,
+      manufacturer: (_b = Device__namespace.manufacturer) != null ? _b : void 0,
+      brand: (_c = Device__namespace.brand) != null ? _c : void 0,
+      isEmulator: !Device__namespace.isDevice,
+      memoryMb: Device__namespace.totalMemory ? Math.round(Device__namespace.totalMemory / 1024 / 1024) : void 0,
+      type: (_e = DEVICE_TYPES[(_d = Device__namespace.deviceType) != null ? _d : 0]) != null ? _e : "unknown"
+    },
+    app: {
+      version: (_f = Application__namespace.nativeApplicationVersion) != null ? _f : void 0,
+      build: (_g = Application__namespace.nativeBuildVersion) != null ? _g : void 0
+    }
+  };
+}
+function initExpo(options, client = chunkEGCXLOFH_cjs.deBug) {
+  var _a;
+  const ctx = expoContext();
+  const merged = chunkEGCXLOFH_cjs.mergeContext(ctx, (_a = options.context) != null ? _a : {});
+  if (!ctx.os) delete merged.os;
+  return chunkNJ6DTUVX_cjs.initReactNative(
+    { ...options, app: { ...ctx.app, ...options.app }, context: merged },
+    client
+  );
+}
+
+Object.defineProperty(exports, "initReactNative", {
+  enumerable: true,
+  get: function () { return chunkNJ6DTUVX_cjs.initReactNative; }
+});
+Object.defineProperty(exports, "nativeContext", {
+  enumerable: true,
+  get: function () { return chunkNJ6DTUVX_cjs.nativeContext; }
+});
+Object.defineProperty(exports, "trackReactNavigation", {
+  enumerable: true,
+  get: function () { return chunkNJ6DTUVX_cjs.trackReactNavigation; }
+});
+Object.defineProperty(exports, "DebugErrorBoundary", {
+  enumerable: true,
+  get: function () { return chunkYELZOB7J_cjs.DebugErrorBoundary; }
+});
+Object.defineProperty(exports, "trackTanStackRouter", {
+  enumerable: true,
+  get: function () { return chunkYELZOB7J_cjs.trackTanStackRouter; }
+});
+Object.defineProperty(exports, "useDebugNavigation", {
+  enumerable: true,
+  get: function () { return chunkYELZOB7J_cjs.useDebugNavigation; }
+});
+Object.defineProperty(exports, "deBug", {
+  enumerable: true,
+  get: function () { return chunkEGCXLOFH_cjs.deBug; }
+});
+exports.expoContext = expoContext;
+exports.initExpo = initExpo;
+//# sourceMappingURL=expo.cjs.map
+//# sourceMappingURL=expo.cjs.map

package/dist/expo.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/expo.ts"],"names":["osName","Device","Application","deBug","mergeContext","initReactNative"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAQA,SAASA,QAAO,GAAA,EAA4B;AAC1C,EAAA,MAAM,CAAA,GAAA,CAAK,GAAA,IAAA,IAAA,GAAA,GAAA,GAAO,EAAA,EAAI,WAAA,EAAY;AAClC,EAAA,IAAI,CAAA,CAAE,QAAA,CAAS,SAAS,CAAA,EAAG,OAAO,SAAA;AAClC,EAAA,IAAI,CAAA,KAAM,KAAA,IAAS,CAAA,KAAM,QAAA,EAAU,OAAO,KAAA;AAC1C,EAAA,OAAO,CAAA,IAAK,SAAA;AACd;AAEA,IAAM,YAAA,GAAe,EAAE,CAAA,EAAG,OAAA,EAAS,GAAG,QAAA,EAAU,CAAA,EAAG,SAAA,EAAW,CAAA,EAAG,IAAA,EAAK;AAG/D,SAAS,WAAA,GAA4B;AAlB5C,EAAA,IAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA,EAAA;AAmBE,EAAA,OAAO;AAAA,IACL,EAAA,EAAWC,8BAAY,EAAE,IAAA,EAAMD,QAAcC,iBAAA,CAAA,MAAM,CAAA,EAAG,OAAA,EAAgBA,iBAAA,CAAA,SAAA,EAAU,GAAI,MAAA;AAAA,IACpF,MAAA,EAAQ;AAAA,MACN,KAAA,EAAA,CAAO,EAAA,GAAOA,iBAAA,CAAA,SAAA,KAAP,IAAA,GAAA,EAAA,GAAoB,MAAA;AAAA,MAC3B,YAAA,EAAA,CAAc,EAAA,GAAOA,iBAAA,CAAA,YAAA,KAAP,IAAA,GAAA,EAAA,GAAuB,MAAA;AAAA,MACrC,KAAA,EAAA,CAAO,EAAA,GAAOA,iBAAA,CAAA,KAAA,KAAP,IAAA,GAAA,EAAA,GAAgB,MAAA;AAAA,MACvB,YAAY,CAAQA,iBAAA,CAAA,QAAA;AAAA,MACpB,UAAiBA,iBAAA,CAAA,WAAA,GAAc,IAAA,CAAK,MAAaA,iBAAA,CAAA,WAAA,GAAc,IAAA,GAAO,IAAI,CAAA,GAAI,MAAA;AAAA,MAC9E,OAAM,EAAA,GAAA,YAAA,CAAA,CAAc,EAAA,GAAOA,iCAAP,IAAA,GAAA,EAAA,GAAqB,CAA+B,MAAlE,IAAA,GAAA,EAAA,GAAuE;AAAA,KAC/E;AAAA,IACA,GAAA,EAAK;AAAA,MACH,OAAA,EAAA,CAAS,EAAA,GAAYC,sBAAA,CAAA,wBAAA,KAAZ,IAAA,GAAA,EAAA,GAAwC,MAAA;AAAA,MACjD,KAAA,EAAA,CAAO,EAAA,GAAYA,sBAAA,CAAA,kBAAA,KAAZ,IAAA,GAAA,EAAA,GAAkC;AAAA;AAC3C,GACF;AACF;AAGO,SAAS,QAAA,CAAS,OAAA,EAAqD,MAAA,GAAsBC,uBAAA,EAAoB;AArCxH,EAAA,IAAA,EAAA;AAsCE,EAAA,MAAM,MAAM,WAAA,EAAY;AACxB,EAAA,MAAM,SAASC,8BAAA,CAAa,GAAA,EAAA,CAAK,aAAQ,OAAA,KAAR,IAAA,GAAA,EAAA,GAAmB,EAAE,CAAA;AAEtD,EAAA,IAAI,CAAC,GAAA,CAAI,EAAA,EAAI,OAAQ,MAAA,CAA4B,EAAA;AACjD,EAAA,OAAOC,iCAAA;AAAA,IACL,EAAE,GAAG,OAAA,EAAS,GAAA,EAAK,EAAE,GAAI,GAAA,CAAI,GAAA,EAAgB,GAAG,OAAA,CAAQ,GAAA,EAAI,EAAoC,SAAS,MAAA,EAAO;AAAA,IAChH;AAAA,GACF;AACF","file":"expo.cjs","sourcesContent":["import * as Application from \"expo-application\";\nimport * as Device from \"expo-device\";\nimport { deBug, type DebugClient } from \"./index\";\nimport { mergeContext, type ContextPatch } from \"./context\";\nimport { initReactNative, type ReactNativeInitOptions } from \"./react-native\";\n\nexport * from \"./react-native\";\n\nfunction osName(raw: string | null): string {\n  const n = (raw ?? \"\").toLowerCase();\n  if (n.includes(\"android\")) return \"android\";\n  if (n === \"ios\" || n === \"ipados\") return \"ios\";\n  return n || \"unknown\"; // web: the browser's OS, e.g. \"mac os\"\n}\n\nconst DEVICE_TYPES = { 1: \"phone\", 2: \"tablet\", 3: \"desktop\", 4: \"tv\" } as const;\n\n/** Device and app context from expo-device and expo-application. */\nexport function expoContext(): ContextPatch {\n  return {\n    os: Device.osVersion ? { name: osName(Device.osName), version: Device.osVersion } : undefined,\n    device: {\n      model: Device.modelName ?? undefined,\n      manufacturer: Device.manufacturer ?? undefined,\n      brand: Device.brand ?? undefined,\n      isEmulator: !Device.isDevice,\n      memoryMb: Device.totalMemory ? Math.round(Device.totalMemory / 1024 / 1024) : undefined,\n      type: DEVICE_TYPES[(Device.deviceType ?? 0) as keyof typeof DEVICE_TYPES] ?? \"unknown\",\n    },\n    app: {\n      version: Application.nativeApplicationVersion ?? undefined,\n      build: Application.nativeBuildVersion ?? undefined,\n    } as ContextPatch[\"app\"],\n  };\n}\n\n/** Initialise deBug in an Expo app. Device, OS and app version are filled in automatically. */\nexport function initExpo(options: Omit<ReactNativeInitOptions, \"deviceInfo\">, client: DebugClient = deBug): DebugClient {\n  const ctx = expoContext();\n  const merged = mergeContext(ctx, options.context ?? {});\n  // Drop undefined os so the react-native fallback is kept when expo-device has no data (e.g. web).\n  if (!ctx.os) delete (merged as { os?: unknown }).os;\n  return initReactNative(\n    { ...options, app: { ...(ctx.app as object), ...options.app } as ReactNativeInitOptions[\"app\"], context: merged },\n    client,\n  );\n}\n"]}

package/dist/expo.d.cts

@@ -0,0 +1,14 @@
+export { deBug } from './index.cjs';
+import { C as ContextPatch, D as DebugClient } from './client-ekzlpWIR.cjs';
+import { ReactNativeInitOptions } from './react-native.cjs';
+export { DeviceInfoModule, initReactNative, nativeContext, trackReactNavigation } from './react-native.cjs';
+export { DebugErrorBoundary, DebugErrorBoundaryProps, trackTanStackRouter, useDebugNavigation } from './react.cjs';
+import '@debugkit/schema/core';
+import 'react';
+
+/** Device and app context from expo-device and expo-application. */
+declare function expoContext(): ContextPatch;
+/** Initialise deBug in an Expo app. Device, OS and app version are filled in automatically. */
+declare function initExpo(options: Omit<ReactNativeInitOptions, "deviceInfo">, client?: DebugClient): DebugClient;
+
+export { ReactNativeInitOptions, expoContext, initExpo };

package/dist/expo.d.ts

@@ -0,0 +1,14 @@
+export { deBug } from './index.js';
+import { C as ContextPatch, D as DebugClient } from './client-ekzlpWIR.js';
+import { ReactNativeInitOptions } from './react-native.js';
+export { DeviceInfoModule, initReactNative, nativeContext, trackReactNavigation } from './react-native.js';
+export { DebugErrorBoundary, DebugErrorBoundaryProps, trackTanStackRouter, useDebugNavigation } from './react.js';
+import '@debugkit/schema/core';
+import 'react';
+
+/** Device and app context from expo-device and expo-application. */
+declare function expoContext(): ContextPatch;
+/** Initialise deBug in an Expo app. Device, OS and app version are filled in automatically. */
+declare function initExpo(options: Omit<ReactNativeInitOptions, "deviceInfo">, client?: DebugClient): DebugClient;
+
+export { ReactNativeInitOptions, expoContext, initExpo };