@debugbundle/sdk-react-native 0.1.0

package/dist/network.js

@@ -0,0 +1,179 @@
+import { DebugBundle } from "./index.js";
+import { sanitizeHeaders } from "./redaction.js";
+const TRACE_HEADER = "X-DebugBundle-Trace-Id";
+let fetchRestore = null;
+let xhrRestore = null;
+export function instrumentDebugBundleNetwork(options = {}) {
+    const client = options.client ?? DebugBundle;
+    const fetchTarget = globalThis;
+    if (fetchTarget.fetch && !fetchRestore) {
+        const originalFetch = fetchTarget.fetch.bind(globalThis);
+        fetchTarget.fetch = createInstrumentedFetch(originalFetch, client, options);
+        fetchRestore = () => {
+            fetchTarget.fetch = originalFetch;
+            fetchRestore = null;
+        };
+    }
+    if (fetchTarget.XMLHttpRequest && !xhrRestore) {
+        xhrRestore = instrumentXMLHttpRequest(fetchTarget.XMLHttpRequest, client, options);
+    }
+    return () => {
+        fetchRestore?.();
+        xhrRestore?.();
+    };
+}
+export function createInstrumentedFetch(originalFetch, client, options) {
+    return (async (input, init) => {
+        const startedAt = Date.now();
+        const url = requestUrl(input);
+        const method = requestMethod(input, init);
+        const traceId = shouldInjectTrace(url, options.tracePropagationTargets ?? []) ? existingTraceHeader(input, init) ?? generateTraceId() : null;
+        const nextInit = traceId ? withTraceHeader(init, traceId) : init;
+        try {
+            const response = await originalFetch(input, nextInit);
+            maybeCaptureNetwork(client, options, url, method, traceId, response.status, Date.now() - startedAt, headersToRecord(nextInit?.headers));
+            return response;
+        }
+        catch (error) {
+            maybeCaptureNetwork(client, options, url, method, traceId, 0, Date.now() - startedAt, headersToRecord(nextInit?.headers));
+            throw error;
+        }
+    });
+}
+export function shouldInjectTrace(url, targets) {
+    if (isRelativeUrl(url)) {
+        return true;
+    }
+    return targets.some((target) => matchesTarget(url, target));
+}
+function instrumentXMLHttpRequest(OriginalXHR, client, options) {
+    const proto = OriginalXHR.prototype;
+    if (proto.__debugBundleWrapped) {
+        return () => undefined;
+    }
+    const originalOpen = proto.open;
+    const originalSend = proto.send;
+    const originalSetRequestHeader = proto.setRequestHeader;
+    proto.open = function open(method, url) {
+        this.__debugBundleMethod = method;
+        this.__debugBundleUrl = String(url);
+        return originalOpen.apply(this, arguments);
+    };
+    proto.send = function send() {
+        const url = this.__debugBundleUrl ?? "";
+        const traceId = shouldInjectTrace(url, options.tracePropagationTargets ?? []) ? generateTraceId() : null;
+        this.__debugBundleTraceId = traceId;
+        this.__debugBundleStartedAt = Date.now();
+        if (traceId) {
+            originalSetRequestHeader.call(this, TRACE_HEADER, traceId);
+        }
+        this.addEventListener("loadend", () => {
+            maybeCaptureNetwork(client, options, url, this.__debugBundleMethod ?? "GET", this.__debugBundleTraceId ?? null, this.status, Date.now() - (this.__debugBundleStartedAt ?? Date.now()), traceId ? { [TRACE_HEADER]: traceId } : {});
+        });
+        return originalSend.apply(this, arguments);
+    };
+    proto.__debugBundleWrapped = true;
+    return () => {
+        proto.open = originalOpen;
+        proto.send = originalSend;
+        proto.__debugBundleWrapped = false;
+    };
+}
+function maybeCaptureNetwork(client, options, url, method, traceId, statusCode, durationMillis, headers) {
+    if (options.captureNetwork === false || !matchesNetworkFilter(url, statusCode, durationMillis, options.networkFilter)) {
+        return;
+    }
+    const sanitizeOptions = options.redactFields ? { redactFields: options.redactFields } : {};
+    client.captureRequest({
+        method,
+        url,
+        headers: sanitizeHeaders(headers, options.headerAllowlist, sanitizeOptions),
+        ...(traceId ? { traceId } : {})
+    }, { statusCode, durationMillis }, traceId ? { trace_id: traceId } : undefined);
+}
+function matchesNetworkFilter(url, statusCode, durationMillis, filter = {}) {
+    if (filter.urlDenylist?.some((entry) => url.includes(entry))) {
+        return false;
+    }
+    if (filter.urlAllowlist && filter.urlAllowlist.length > 0 && !filter.urlAllowlist.some((entry) => url.includes(entry))) {
+        return false;
+    }
+    if (filter.statusCodes && filter.statusCodes.length > 0 && !filter.statusCodes.includes(statusCode)) {
+        return false;
+    }
+    if (filter.minResponseTime !== undefined && durationMillis < filter.minResponseTime) {
+        return false;
+    }
+    return statusCode === 0 || statusCode >= 400 || filter.statusCodes !== undefined || filter.minResponseTime !== undefined;
+}
+function requestUrl(input) {
+    if (typeof input === "string") {
+        return input;
+    }
+    if (input instanceof URL) {
+        return input.toString();
+    }
+    return "url" in input ? input.url : String(input);
+}
+function requestMethod(input, init) {
+    if (init?.method) {
+        return init.method.toUpperCase();
+    }
+    if (typeof input === "object" && "method" in input && typeof input.method === "string") {
+        return input.method.toUpperCase();
+    }
+    return "GET";
+}
+function withTraceHeader(init, traceId) {
+    const headers = new Headers(init?.headers);
+    if (!headers.has(TRACE_HEADER)) {
+        headers.set(TRACE_HEADER, traceId);
+    }
+    return { ...init, headers };
+}
+function existingTraceHeader(input, init) {
+    const fromInit = init?.headers ? new Headers(init.headers).get(TRACE_HEADER) : null;
+    if (fromInit) {
+        return fromInit;
+    }
+    if (typeof input === "object" && "headers" in input) {
+        return new Headers(input.headers).get(TRACE_HEADER);
+    }
+    return null;
+}
+function headersToRecord(headers) {
+    const output = {};
+    if (!headers) {
+        return output;
+    }
+    new Headers(headers).forEach((value, key) => {
+        output[key] = value;
+    });
+    return output;
+}
+function isRelativeUrl(url) {
+    return url.startsWith("/") && !url.startsWith("//");
+}
+function matchesTarget(url, target) {
+    if (!target || target.includes("*")) {
+        return false;
+    }
+    try {
+        const parsedUrl = new URL(url);
+        const parsedTarget = new URL(target);
+        return parsedUrl.origin === parsedTarget.origin && parsedUrl.pathname.startsWith(parsedTarget.pathname.replace(/\/$/, ""));
+    }
+    catch {
+        return false;
+    }
+}
+function generateTraceId() {
+    if (globalThis.crypto?.randomUUID) {
+        return globalThis.crypto.randomUUID();
+    }
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (marker) => {
+        const random = Math.trunc(Math.random() * 16);
+        const value = marker === "x" ? random : (random & 0x3) | 0x8;
+        return value.toString(16);
+    });
+}

package/dist/probes.d.ts

@@ -0,0 +1,4 @@
+import type { DebugBundleClient, DebugBundleProbeOptions } from "./types.js";
+export declare function probe(label: string, data: unknown | (() => unknown), options?: DebugBundleProbeOptions): void;
+export declare function activateDebugBundleProbeTrigger(token: string, client?: DebugBundleClient): boolean;
+//# sourceMappingURL=probes.d.ts.map

package/dist/probes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probes.d.ts","sourceRoot":"","sources":["../src/probes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE7E,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,uBAAuB,GAAG,IAAI,CAE7G;AAED,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,iBAA+B,GAAG,OAAO,CAG/G"}

package/dist/probes.js

@@ -0,0 +1,8 @@
+import { DebugBundle } from "./index.js";
+export function probe(label, data, options) {
+    DebugBundle.probe(label, data, options);
+}
+export function activateDebugBundleProbeTrigger(token, client = DebugBundle) {
+    void client.activateProbeTriggerToken(token);
+    return Boolean(token);
+}

package/dist/react.d.ts

@@ -0,0 +1,21 @@
+import * as React from "react";
+import type { DebugBundleClient } from "./types.js";
+export interface DebugBundleErrorBoundaryProps {
+    children: React.ReactNode;
+    client?: DebugBundleClient;
+    fallback?: React.ReactNode | ((error: Error) => React.ReactNode);
+    context?: Record<string, unknown>;
+    rethrow?: boolean;
+}
+interface DebugBundleErrorBoundaryState {
+    error: Error | null;
+}
+export declare class DebugBundleErrorBoundary extends React.Component<DebugBundleErrorBoundaryProps, DebugBundleErrorBoundaryState> {
+    state: DebugBundleErrorBoundaryState;
+    static getDerivedStateFromError(error: Error): DebugBundleErrorBoundaryState;
+    componentDidCatch(error: Error, info: React.ErrorInfo): void;
+    render(): React.ReactNode;
+}
+export declare function useDebugBundleAction(actionName: string, client?: DebugBundleClient): (data?: Record<string, unknown>) => void;
+export {};
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAC;IAC1B,MAAM,CAAC,EAAE,iBAAiB,CAAC;IAC3B,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC,SAAS,CAAC,CAAC;IACjE,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,UAAU,6BAA6B;IACrC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,qBAAa,wBAAyB,SAAQ,KAAK,CAAC,SAAS,CAC3D,6BAA6B,EAC7B,6BAA6B,CAC9B;IACC,KAAK,EAAE,6BAA6B,CAAmB;IAEvD,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,6BAA6B;IAI5E,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,CAAC,SAAS,GAAG,IAAI;IAY5D,MAAM,IAAI,KAAK,CAAC,SAAS;CAS1B;AAED,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,MAAM,EAClB,MAAM,GAAE,iBAA+B,GACtC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,IAAI,CAO1C"}

package/dist/react.js

@@ -0,0 +1,36 @@
+import * as React from "react";
+import { DebugBundle } from "./index.js";
+export class DebugBundleErrorBoundary extends React.Component {
+    state = { error: null };
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, info) {
+        const client = this.props.client ?? DebugBundle;
+        client.captureException(error, {
+            ...this.props.context,
+            component_stack: info.componentStack,
+            source: "react-error-boundary"
+        });
+        if (this.props.rethrow) {
+            throw error;
+        }
+    }
+    render() {
+        if (!this.state.error) {
+            return this.props.children;
+        }
+        if (typeof this.props.fallback === "function") {
+            return this.props.fallback(this.state.error);
+        }
+        return this.props.fallback ?? null;
+    }
+}
+export function useDebugBundleAction(actionName, client = DebugBundle) {
+    return (data) => {
+        client.recordBreadcrumb("action", {
+            action_name: actionName,
+            ...(data ?? {})
+        });
+    };
+}

package/dist/redaction.d.ts

@@ -0,0 +1,12 @@
+export declare const DEFAULT_HEADER_ALLOWLIST: string[];
+export interface SanitizeOptions {
+    redactFields?: string[];
+    maxDepth?: number;
+    maxStringLength?: number;
+    maxArrayLength?: number;
+    maxObjectKeys?: number;
+}
+export declare function defaultRedactFields(): string[];
+export declare function sanitizeValue(value: unknown, options?: SanitizeOptions): unknown;
+export declare function sanitizeHeaders(headers: Record<string, string> | undefined, allowlist?: string[], options?: SanitizeOptions): Record<string, string>;
+//# sourceMappingURL=redaction.d.ts.map

package/dist/redaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"redaction.d.ts","sourceRoot":"","sources":["../src/redaction.ts"],"names":[],"mappings":"AAyBA,eAAO,MAAM,wBAAwB,UAQpC,CAAC;AAEF,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,wBAAgB,mBAAmB,IAAI,MAAM,EAAE,CAE9C;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,GAAE,eAAoB,GAAG,OAAO,CAGpF;AAED,wBAAgB,eAAe,CAC7B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC3C,SAAS,GAAE,MAAM,EAA6B,EAC9C,OAAO,GAAE,eAAoB,GAC5B,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAaxB"}

package/dist/redaction.js

@@ -0,0 +1,132 @@
+const DEFAULT_REDACT_FIELDS = [
+    "password",
+    "secret",
+    "token",
+    "api_key",
+    "apikey",
+    "access_token",
+    "refresh_token",
+    "private_key",
+    "passwd",
+    "card_number",
+    "cvv",
+    "cvc",
+    "pin",
+    "expiry",
+    "phone",
+    "bearer",
+    "session_id",
+    "otp",
+    "verification_code",
+    "authorization",
+    "cookie",
+    "ssn"
+];
+export const DEFAULT_HEADER_ALLOWLIST = [
+    "user-agent",
+    "content-type",
+    "accept",
+    "x-request-id",
+    "x-correlation-id",
+    "x-debugbundle-trace-id",
+    "traceparent"
+];
+export function defaultRedactFields() {
+    return [...DEFAULT_REDACT_FIELDS];
+}
+export function sanitizeValue(value, options = {}) {
+    const visited = new WeakSet();
+    return sanitize(value, normalizeOptions(options), 0, visited, undefined);
+}
+export function sanitizeHeaders(headers, allowlist = DEFAULT_HEADER_ALLOWLIST, options = {}) {
+    if (!headers) {
+        return {};
+    }
+    const allowed = new Set(allowlist.map((header) => header.toLowerCase()));
+    const sanitized = {};
+    for (const [key, value] of Object.entries(headers)) {
+        const normalizedKey = key.toLowerCase();
+        if (allowed.has(normalizedKey)) {
+            sanitized[normalizedKey] = String(sanitizeValue(value, options));
+        }
+    }
+    return sanitized;
+}
+function normalizeOptions(options) {
+    return {
+        redactFields: options.redactFields ?? DEFAULT_REDACT_FIELDS,
+        maxDepth: options.maxDepth ?? 8,
+        maxStringLength: options.maxStringLength ?? 2048,
+        maxArrayLength: options.maxArrayLength ?? 50,
+        maxObjectKeys: options.maxObjectKeys ?? 50
+    };
+}
+function sanitize(value, options, depth, visited, key) {
+    if (key && isSensitiveKey(key, options.redactFields)) {
+        return "[Redacted]";
+    }
+    if (value === null || value === undefined) {
+        return value ?? null;
+    }
+    if (typeof value === "string") {
+        return truncate(value, options.maxStringLength);
+    }
+    if (typeof value === "number" || typeof value === "boolean") {
+        return value;
+    }
+    if (typeof value === "bigint") {
+        return value.toString();
+    }
+    if (typeof value === "function" || typeof value === "symbol") {
+        return `[${typeof value}]`;
+    }
+    if (value instanceof Error) {
+        return sanitizeError(value, options, depth, visited);
+    }
+    if (depth >= options.maxDepth) {
+        return "[Truncated: depth]";
+    }
+    if (typeof value === "object") {
+        if (visited.has(value)) {
+            return "[Circular]";
+        }
+        visited.add(value);
+        if (Array.isArray(value)) {
+            return value
+                .slice(0, options.maxArrayLength)
+                .map((entry) => sanitize(entry, options, depth + 1, visited, undefined));
+        }
+        const output = {};
+        for (const [entryKey, entryValue] of Object.entries(value).slice(0, options.maxObjectKeys)) {
+            output[entryKey] = sanitize(entryValue, options, depth + 1, visited, entryKey);
+        }
+        return output;
+    }
+    return String(value);
+}
+function sanitizeError(error, options, depth, visited) {
+    return {
+        name: truncate(error.name || "Error", options.maxStringLength),
+        message: truncate(error.message || "", options.maxStringLength),
+        stack: typeof error.stack === "string" ? truncate(error.stack, options.maxStringLength * 4) : null,
+        cause: "cause" in error ? sanitize(error.cause, options, depth + 1, visited, "cause") : null
+    };
+}
+function truncate(value, maxLength) {
+    if (value.length <= maxLength) {
+        return value;
+    }
+    return `${value.slice(0, maxLength)}...[Truncated]`;
+}
+function isSensitiveKey(key, sensitiveFields) {
+    const segments = splitKey(key);
+    const sensitive = new Set(sensitiveFields.flatMap(splitKey));
+    return segments.some((segment) => sensitive.has(segment));
+}
+function splitKey(key) {
+    return key
+        .replace(/([a-z0-9])([A-Z])/g, "$1_$2")
+        .split(/[^a-zA-Z0-9]+/)
+        .map((segment) => segment.toLowerCase())
+        .filter(Boolean);
+}

package/dist/testing.d.ts

@@ -0,0 +1,9 @@
+import type { DebugBundleEventEnvelope, NativeDebugBundleModule, NativeDebugBundleState, ResolvedDebugBundleConfig } from "./types.js";
+export interface RecordingNativeModule extends NativeDebugBundleModule {
+    events: DebugBundleEventEnvelope[];
+    config: ResolvedDebugBundleConfig | null;
+}
+export declare function createRecordingNativeModule(initialState?: NativeDebugBundleState): RecordingNativeModule;
+export declare function installRecordingNativeModule(module?: RecordingNativeModule): RecordingNativeModule;
+export declare function resetDebugBundleNativeModule(): void;
+//# sourceMappingURL=testing.d.ts.map

package/dist/testing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,wBAAwB,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,YAAY,CAAC;AAEvI,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,MAAM,EAAE,yBAAyB,GAAG,IAAI,CAAC;CAC1C;AAED,wBAAgB,2BAA2B,CAAC,YAAY,GAAE,sBAAiE,GAAG,qBAAqB,CA0BlJ;AAED,wBAAgB,4BAA4B,CAAC,MAAM,GAAE,qBAAqD,GAAG,qBAAqB,CAGjI;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}

package/dist/testing.js

@@ -0,0 +1,36 @@
+import { resetNativeModuleCacheForTesting, setNativeModuleForTesting } from "./native.js";
+export function createRecordingNativeModule(initialState = { status: "healthy", lastEventAt: null }) {
+    const state = { ...initialState };
+    return {
+        events: [],
+        config: null,
+        initialize(config) {
+            this.config = config;
+            return state;
+        },
+        enqueueEvent(event) {
+            this.events.push(event);
+            state.lastEventAt = Date.now();
+        },
+        flush() {
+            state.status = "healthy";
+        },
+        getStatus() {
+            return state;
+        },
+        setContext() {
+            return undefined;
+        },
+        activateProbeTriggerToken() {
+            return true;
+        }
+    };
+}
+export function installRecordingNativeModule(module = createRecordingNativeModule()) {
+    setNativeModuleForTesting(module);
+    return module;
+}
+export function resetDebugBundleNativeModule() {
+    setNativeModuleForTesting(undefined);
+    resetNativeModuleCacheForTesting();
+}

package/dist/types.d.ts

@@ -0,0 +1,152 @@
+export type DebugBundleStatus = "healthy" | "degraded" | "disconnected";
+export type DebugBundleLogLevel = "debug" | "info" | "warning" | "error" | "critical";
+export interface DebugBundleConfig {
+    projectToken?: string;
+    enabled?: boolean;
+    environment?: string;
+    service?: string;
+    endpoint?: string;
+    releaseChannel?: string;
+    appVersion?: string;
+    buildNumber?: string;
+    batchSize?: number;
+    flushInterval?: number;
+    sampleRate?: number;
+    sessionSampleRate?: number;
+    maxEventsPerSession?: number;
+    maxBreadcrumbs?: number;
+    captureErrors?: boolean;
+    captureUnhandledRejections?: boolean;
+    captureScreens?: boolean;
+    captureActions?: boolean;
+    captureNetwork?: boolean;
+    captureConsole?: boolean;
+    captureLogs?: boolean;
+    logLevel?: DebugBundleLogLevel;
+    tracePropagationTargets?: string[];
+    networkFilter?: DebugBundleNetworkFilter;
+    offlineQueueMaxEvents?: number;
+    offlineQueueMaxBytes?: number;
+    offlineQueueTtl?: number;
+    requestTimeout?: number;
+    maxProbeLabels?: number;
+    maxProbeEntriesPerLabel?: number;
+    probeFlushOnError?: boolean;
+    redactFields?: string[];
+    headerAllowlist?: string[];
+    sdkVersion?: string;
+}
+export interface ResolvedDebugBundleConfig {
+    projectToken: string;
+    enabled: boolean;
+    environment: string;
+    service: string;
+    endpoint: string;
+    releaseChannel: string;
+    appVersion: string | null;
+    buildNumber: string | null;
+    batchSize: number;
+    flushInterval: number;
+    sampleRate: number;
+    sessionSampleRate: number;
+    maxEventsPerSession: number;
+    maxBreadcrumbs: number;
+    captureErrors: boolean;
+    captureUnhandledRejections: boolean;
+    captureScreens: boolean;
+    captureActions: boolean;
+    captureNetwork: boolean;
+    captureConsole: boolean;
+    captureLogs: boolean;
+    logLevel: DebugBundleLogLevel;
+    tracePropagationTargets: string[];
+    networkFilter: DebugBundleNetworkFilter;
+    offlineQueueMaxEvents: number;
+    offlineQueueMaxBytes: number;
+    offlineQueueTtl: number;
+    requestTimeout: number;
+    maxProbeLabels: number;
+    maxProbeEntriesPerLabel: number;
+    probeFlushOnError: boolean;
+    redactFields: string[];
+    headerAllowlist: string[];
+    sdkVersion: string;
+}
+export interface DebugBundleNetworkFilter {
+    urlAllowlist?: string[];
+    urlDenylist?: string[];
+    statusCodes?: number[];
+    minResponseTime?: number;
+}
+export interface DebugBundleRequestInfo {
+    method: string;
+    url: string;
+    headers?: Record<string, string>;
+    routeTemplate?: string;
+    traceId?: string;
+}
+export interface DebugBundleResponseInfo {
+    statusCode: number;
+    durationMillis?: number;
+    headers?: Record<string, string>;
+}
+export interface DebugBundleCaptureContext {
+    [key: string]: unknown;
+}
+export interface DebugBundleProbeOptions {
+    heavy?: boolean;
+}
+export interface DebugBundleEventEnvelope {
+    schema_version: "1";
+    event_id: string;
+    event_type: "frontend_exception" | "frontend_breadcrumb" | "log_event" | "request_event" | "error_suppressed" | "probe_event";
+    sdk_name: "@debugbundle/sdk-react-native";
+    sdk_version: string;
+    service: {
+        name: string;
+        environment: string;
+        runtime: "react-native";
+        framework: "react-native";
+    };
+    occurred_at: string;
+    correlation: {
+        trace_id: string | null;
+        request_id?: string | null;
+        session_id?: string | null;
+        user_id_hash?: string | null;
+    } | null;
+    payload: Record<string, unknown>;
+    device: Record<string, unknown> | null;
+}
+export interface DebugBundleClient {
+    readonly status: DebugBundleStatus;
+    readonly lastEventAt: number | null;
+    init(config: DebugBundleConfig): void;
+    captureException(error: unknown, context?: DebugBundleCaptureContext): void;
+    captureError(error: unknown, context?: DebugBundleCaptureContext): void;
+    captureLog(message: string, level?: DebugBundleLogLevel, context?: DebugBundleCaptureContext): void;
+    captureRequest(request: DebugBundleRequestInfo, response: DebugBundleResponseInfo, context?: DebugBundleCaptureContext): void;
+    captureMessage(message: string, level?: DebugBundleLogLevel, context?: DebugBundleCaptureContext): void;
+    setContext(key: string, value: unknown): void;
+    probe(label: string, data: unknown | (() => unknown), options?: DebugBundleProbeOptions): void;
+    flush(): Promise<void>;
+    activateProbeTriggerToken(token: string): Promise<boolean>;
+    recordBreadcrumb(type: string, data?: Record<string, unknown>): void;
+    recordScreen(screenName: string, previousScreen?: string | null, source?: string): void;
+}
+export interface NativeDebugBundleModule {
+    initialize(config: ResolvedDebugBundleConfig): Promise<NativeDebugBundleState> | NativeDebugBundleState;
+    enqueueEvent(event: DebugBundleEventEnvelope): Promise<void> | void;
+    flush(): Promise<void> | void;
+    getStatus(): Promise<NativeDebugBundleState> | NativeDebugBundleState;
+    setContext?(key: string, value: unknown): Promise<void> | void;
+    activateProbeTriggerToken?(token: string): Promise<boolean> | boolean;
+}
+export interface NativeDebugBundleState {
+    status: DebugBundleStatus;
+    lastEventAt?: number | null;
+    device?: Record<string, unknown> | null;
+    nativeModuleAvailable?: boolean;
+    degradedReason?: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

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

package/dist/types.js

@@ -0,0 +1 @@
+export {};