@debugbundle/sdk-react-native 1.1.0 → 1.2.0

package/dist/client.js

@@ -1,7 +1,8 @@
 import { getNativeModule, degradedNativeState, safeNativeCall } from "./native.js";
+import { applyBeforeSend } from "./before-send.js";
 import { defaultRedactFields, DEFAULT_HEADER_ALLOWLIST, sanitizeHeaders, sanitizeValue } from "./redaction.js";
 const SDK_NAME = "@debugbundle/sdk-react-native";
-const DEFAULT_SDK_VERSION = "1.1.0";
+const DEFAULT_SDK_VERSION = "1.2.0";
 const LOG_LEVELS = {
     debug: 10,
     info: 20,
@@ -17,8 +18,6 @@ export class DebugBundleReactNativeClient {
     breadcrumbs = [];
     probeBuffers = new Map();
     jsProbeActivationExpiresAt = 0;
-    sessionSampledIn = true;
-    sessionEventCount = 0;
     constructor(config = {}) {
         this.config = resolveConfig(config);
         if (Object.keys(config).length > 0) {
@@ -34,9 +33,6 @@ export class DebugBundleReactNativeClient {
     init(config) {
         this.config = resolveConfig(config);
         this.nativeModule = getNativeModule();
-        this.sessionSampledIn =
-            this.config.enabled &&
-                (this.config.sessionSampleRate >= 1 || Math.random() <= this.config.sessionSampleRate);
         if (!this.config.enabled) {
             this.nativeState = { status: "disconnected", lastEventAt: null, nativeModuleAvailable: Boolean(this.nativeModule) };
             return;
@@ -49,57 +45,70 @@ export class DebugBundleReactNativeClient {
             this.nativeState = degradedNativeState("native_module_unavailable");
             return;
         }
-        void safeNativeCall(async () => {
-            this.nativeState = await this.nativeModule.initialize(this.config);
-            if (!this.nativeState.status) {
-                this.nativeState.status = "healthy";
+        try {
+            const initialization = this.nativeModule.initialize(nativeConfig(this.config));
+            if (isPromiseLike(initialization)) {
+                this.nativeState = { status: "healthy", lastEventAt: null, nativeModuleAvailable: true };
+                void safeNativeCall(async () => {
+                    this.nativeState = normalizeNativeState(await initialization);
+                }, undefined);
             }
-        }, undefined);
-        this.nativeState = { status: "healthy", lastEventAt: null, nativeModuleAvailable: true };
+            else {
+                this.nativeState = normalizeNativeState(initialization);
+            }
+        }
+        catch {
+            this.nativeState = degradedNativeState("native_initialize_failed");
+        }
     }
     captureException(error, context = {}) {
         const mergedContext = this.mergeContext(context);
+        const sanitizedError = asRecord(sanitizeValue(error, { redactFields: this.config.redactFields }));
         this.enqueue("frontend_exception", {
-            error: sanitizeValue(error, { redactFields: this.config.redactFields }),
-            context: sanitizeValue(mergedContext, { redactFields: this.config.redactFields }),
+            name: stringValue(sanitizedError.name) ?? "Error",
+            message: stringValue(sanitizedError.message) ?? "Unknown error",
+            stack: stringValue(sanitizedError.stack) ?? `${stringValue(sanitizedError.name) ?? "Error"}: ${stringValue(sanitizedError.message) ?? "Unknown error"}`,
             breadcrumbs: this.breadcrumbs.slice(),
             probe_data: this.snapshotProbeData()
-        }, stringValue(mergedContext.trace_id), false);
+        }, stringValue(mergedContext.trace_id), false, asRecord(sanitizeValue(mergedContext, {
+            redactFields: this.config.redactFields
+        })), this.config.captureErrors);
     }
     captureError(error, context = {}) {
         this.captureException(error, context);
     }
     captureLog(message, level = "warning", context = {}) {
-        if (!this.config.captureLogs || LOG_LEVELS[level] < LOG_LEVELS[this.config.logLevel]) {
-            return;
-        }
         this.enqueue("log_event", {
             level,
             message: sanitizeValue(message, { redactFields: this.config.redactFields }),
-            context: sanitizeValue(this.mergeContext(context), { redactFields: this.config.redactFields }),
-            source: "javascript"
-        }, stringValue(context.trace_id), true);
+            attributes: {
+                ...asRecord(sanitizeValue(this.mergeContext(context), { redactFields: this.config.redactFields })),
+                source: "javascript"
+            }
+        }, stringValue(context.trace_id), true, undefined, this.config.captureLogs && LOG_LEVELS[level] >= LOG_LEVELS[this.config.logLevel]);
     }
     captureRequest(request, response, context = {}) {
-        const traceId = request.traceId ?? stringValue(context.trace_id);
+        const mergedContext = this.mergeContext(context);
+        const traceId = request.traceId ?? stringValue(mergedContext.trace_id);
+        const parsedUrl = parseRequestUrl(request.url);
         const payload = {
             method: request.method,
-            url: sanitizeUrl(request.url),
+            path: parsedUrl.path,
+            query: parsedUrl.query,
             route_template: request.routeTemplate ?? null,
-            request_headers: sanitizeHeaders(request.headers, this.config.headerAllowlist, {
+            headers: sanitizeHeaders(request.headers, this.config.headerAllowlist, {
                 redactFields: this.config.redactFields
             }),
             response_status: response.statusCode,
             response_headers: sanitizeHeaders(response.headers, this.config.headerAllowlist, {
                 redactFields: this.config.redactFields
             }),
-            duration_ms: response.durationMillis ?? null,
-            source: "react-native"
+            duration_ms: response.durationMillis ?? 0
         };
-        this.recordBreadcrumb("network", payload);
-        if (this.shouldCaptureRequestEvent(response.statusCode)) {
-            this.enqueue("request_event", payload, traceId, true);
+        if (this.config.captureNetwork) {
+            this.recordBreadcrumb("network_request", payload);
         }
+        this.enqueue("request_event", payload, traceId, true, asRecord(sanitizeValue(mergedContext, { redactFields: this.config.redactFields })), this.config.captureNetwork);
     }
     captureMessage(message, level = "warning", context = {}) {
         this.recordBreadcrumb("message", {
@@ -110,7 +119,10 @@ export class DebugBundleReactNativeClient {
     }
     setContext(key, value) {
         this.context[key] = sanitizeValue(value, { redactFields: this.config.redactFields });
-        if (this.nativeModule?.setContext) {
+        if (this.nativeModule?.setContextValue) {
+            void safeNativeCall(() => this.nativeModule.setContextValue(key, { value: this.context[key] }), undefined);
+        }
+        else if (this.nativeModule?.setContext) {
             void safeNativeCall(() => this.nativeModule.setContext(key, this.context[key]), undefined);
         }
     }
@@ -118,19 +130,25 @@ export class DebugBundleReactNativeClient {
         if (!label || this.probeBuffers.size >= this.config.maxProbeLabels && !this.probeBuffers.has(label)) {
             return;
         }
-        if (options.heavy && !this.hasActiveJsProbeActivation()) {
+        const nativeProbeActive = this.nativeModule?.isProbeActive?.(label) ?? false;
+        if (options.heavy && !nativeProbeActive && !this.hasActiveJsProbeActivation()) {
             return;
         }
         const value = typeof data === "function" ? safeInvoke(data) : data;
+        const sanitizedData = objectWrap(sanitizeValue(value, { redactFields: this.config.redactFields }));
+        const occurredAt = new Date().toISOString();
         const entry = {
             label,
-            data: sanitizeValue(value, { redactFields: this.config.redactFields }),
-            timestamp: new Date().toISOString(),
+            data: sanitizedData,
+            timestamp: occurredAt,
             activation_id: null
         };
         const entries = this.probeBuffers.get(label) ?? [];
         entries.push(entry);
         this.probeBuffers.set(label, entries.slice(-this.config.maxProbeEntriesPerLabel));
+        if (this.nativeModule?.captureProbe) {
+            void safeNativeCall(() => this.nativeModule.captureProbe(label, sanitizedData, occurredAt), false);
+        }
     }
     async flush() {
         if (!this.nativeModule) {
@@ -153,12 +171,17 @@ export class DebugBundleReactNativeClient {
         return activated;
     }
     recordBreadcrumb(type, data = {}) {
-        this.breadcrumbs.push({
+        const breadcrumb = {
             breadcrumb_type: type,
-            occurred_at: new Date().toISOString(),
+            ts: new Date().toISOString(),
             data: sanitizeValue(data, { redactFields: this.config.redactFields })
-        });
+        };
+        this.breadcrumbs.push(breadcrumb);
         this.breadcrumbs = this.breadcrumbs.slice(-this.config.maxBreadcrumbs);
+        this.enqueue("frontend_breadcrumb", {
+            breadcrumb_type: type,
+            data: breadcrumb.data
+        }, null, true);
     }
     recordScreen(screenName, previousScreen = null, source = "react-navigation") {
         if (!this.config.captureScreens) {
@@ -170,12 +193,12 @@ export class DebugBundleReactNativeClient {
             source
         });
     }
-    enqueue(eventType, payload, traceId, countTowardSession) {
+    enqueue(eventType, payload, traceId, countTowardSession, context, localPolicyAllows = true) {
         if (!this.canCapture(eventType, countTowardSession)) {
             return;
         }
-        const event = {
-            schema_version: "1",
+        const authoredEvent = {
+            schema_version: "2026-03-01",
             event_id: generateId(),
             event_type: eventType,
             sdk_name: SDK_NAME,
@@ -187,29 +210,33 @@ export class DebugBundleReactNativeClient {
                 framework: "react-native"
             },
             occurred_at: new Date().toISOString(),
-            correlation: traceId ? { trace_id: traceId } : null,
-            payload,
-            device: this.nativeState.device ?? deviceFromConfig(this.config)
+            ...(traceId ? { correlation: { trace_id: traceId } } : {}),
+            ...(context && Object.keys(context).length > 0 ? { context } : {}),
+            payload: this.nativeState.device
+                ? { ...payload, device: canonicalDevice(this.nativeState.device, this.config) }
+                : payload
         };
-        if (countTowardSession) {
-            this.sessionEventCount += 1;
+        const event = applyBeforeSend(authoredEvent, this.config.beforeSend);
+        if (!event || !localPolicyAllows) {
+            return;
         }
         if (!this.nativeModule) {
             this.nativeState = degradedNativeState("native_module_unavailable");
             return;
         }
-        void safeNativeCall(() => this.nativeModule.enqueueEvent(event), undefined);
+        if (this.nativeModule.enqueueCanonicalEvent) {
+            void safeNativeCall(() => this.nativeModule.enqueueCanonicalEvent(event), undefined);
+        }
+        else {
+            void safeNativeCall(() => this.nativeModule.enqueueEvent(toLegacyNativeEvent(event)), undefined);
+        }
     }
     canCapture(eventType, countTowardSession) {
-        if (!this.config.enabled || !this.config.projectToken || !this.sessionSampledIn) {
+        if (!this.config.enabled || !this.config.projectToken) {
             return false;
         }
-        if (Math.random() > this.config.sampleRate) {
-            return false;
-        }
-        if (countTowardSession && this.sessionEventCount >= this.config.maxEventsPerSession) {
-            return eventType === "frontend_exception" || eventType === "probe_event";
-        }
+        void eventType;
+        void countTowardSession;
         return true;
     }
     mergeContext(context) {
@@ -227,9 +254,6 @@ export class DebugBundleReactNativeClient {
     hasActiveJsProbeActivation() {
         return this.jsProbeActivationExpiresAt > Date.now();
     }
-    shouldCaptureRequestEvent(statusCode) {
-        return statusCode >= 500 || [408, 423, 424, 425, 429].includes(statusCode);
-    }
 }
 export function createDebugBundleClient(config = {}) {
     return new DebugBundleReactNativeClient(config);
@@ -269,9 +293,14 @@ export function resolveConfig(config) {
         probeFlushOnError: config.probeFlushOnError ?? true,
         redactFields: config.redactFields ?? defaultRedactFields(),
         headerAllowlist: config.headerAllowlist ?? DEFAULT_HEADER_ALLOWLIST,
-        sdkVersion: config.sdkVersion ?? DEFAULT_SDK_VERSION
+        sdkVersion: config.sdkVersion ?? DEFAULT_SDK_VERSION,
+        beforeSend: config.beforeSend ?? null
     };
 }
+function nativeConfig(config) {
+    const { beforeSend: _beforeSend, ...native } = config;
+    return native;
+}
 function clampInteger(value, fallback, min, max) {
     if (!Number.isFinite(value)) {
         return fallback;
@@ -292,17 +321,78 @@ function safeInvoke(producer) {
         return { error: sanitizeValue(error) };
     }
 }
+function isPromiseLike(value) {
+    return Boolean(value && typeof value.then === "function");
+}
+function normalizeNativeState(state) {
+    return {
+        ...state,
+        status: state.status || "healthy",
+        nativeModuleAvailable: state.nativeModuleAvailable ?? true
+    };
+}
 function stringValue(value) {
     return typeof value === "string" && value.length > 0 ? value : null;
 }
-function sanitizeUrl(url) {
+function asRecord(value) {
+    if (value && typeof value === "object" && !Array.isArray(value)) {
+        return value;
+    }
+    return {};
+}
+function objectWrap(value) {
+    return value && typeof value === "object" && !Array.isArray(value)
+        ? value
+        : { value };
+}
+function parseRequestUrl(url) {
     try {
         const parsed = new URL(url);
-        parsed.search = "";
-        return parsed.toString();
+        const query = {};
+        for (const [key, value] of parsed.searchParams) {
+            const existing = query[key];
+            if (existing === undefined) {
+                query[key] = value;
+            }
+            else if (Array.isArray(existing)) {
+                existing.push(value);
+            }
+            else {
+                query[key] = [existing, value];
+            }
+        }
+        return { path: parsed.pathname || "/", query };
+    }
+    catch {
+        const [path = "/", rawQuery = ""] = url.split("?", 2);
+        const query = {};
+        for (const segment of rawQuery.split("&")) {
+            if (!segment) {
+                continue;
+            }
+            const [rawKey = "", rawValue = ""] = segment.split("=", 2);
+            const key = decodeQuerySegment(rawKey);
+            const value = decodeQuerySegment(rawValue);
+            const existing = query[key];
+            if (existing === undefined) {
+                query[key] = value;
+            }
+            else if (Array.isArray(existing)) {
+                existing.push(value);
+            }
+            else {
+                query[key] = [existing, value];
+            }
+        }
+        return { path: path || "/", query };
+    }
+}
+function decodeQuerySegment(value) {
+    try {
+        return decodeURIComponent(value.replace(/\+/g, " "));
     }
     catch {
-        return url.split("?")[0] ?? url;
+        return value;
     }
 }
 function sanitizeScreenName(screenName) {
@@ -319,10 +409,80 @@ function generateId() {
         return value.toString(16);
     });
 }
-function deviceFromConfig(config) {
+function canonicalDevice(nativeDevice, config) {
+    const source = nativeDevice ?? {};
+    const sourceOs = asRecord(source.os);
+    const sourceScreen = asRecord(source.screen);
+    const sourceViewport = asRecord(source.viewport);
+    const width = nonNegativeInteger(sourceScreen.width ?? source.screen_width);
+    const height = nonNegativeInteger(sourceScreen.height ?? source.screen_height);
     return {
-        app_version: config.appVersion,
-        build_number: config.buildNumber,
-        release_channel: config.releaseChannel
+        user_agent: stringValue(source.user_agent),
+        os: {
+            name: stringValue(sourceOs.name ?? source.os_name),
+            version: stringValue(sourceOs.version ?? source.os_version)
+        },
+        device_type: canonicalDeviceType(source.device_type),
+        screen: { width, height },
+        viewport: {
+            width: nonNegativeInteger(sourceViewport.width ?? width),
+            height: nonNegativeInteger(sourceViewport.height ?? height)
+        },
+        device_pixel_ratio: positiveNumber(source.device_pixel_ratio),
+        touch_capable: typeof source.touch_capable === "boolean" ? source.touch_capable : null,
+        language: stringValue(source.language ?? source.locale),
+        connection_type: stringValue(source.connection_type),
+        color_scheme_preference: canonicalColorScheme(source.color_scheme_preference),
+        app_version: stringValue(source.app_version) ?? config.appVersion,
+        build_number: stringValue(source.build_number) ?? config.buildNumber,
+        release_channel: stringValue(source.release_channel) ?? config.releaseChannel,
+        api_level: nullableNonNegativeInteger(source.api_level),
+        manufacturer: stringValue(source.manufacturer),
+        model: stringValue(source.model),
+        timezone: stringValue(source.timezone),
+        battery_level: nonNegativeNumber(source.battery_level),
+        battery_charging: typeof source.battery_charging === "boolean"
+            ? source.battery_charging
+            : typeof source.charging === "boolean" ? source.charging : null,
+        free_disk_bytes: nullableNonNegativeInteger(source.free_disk_bytes),
+        free_memory_bytes: nullableNonNegativeInteger(source.free_memory_bytes),
+        jailbroken: typeof source.jailbroken === "boolean"
+            ? source.jailbroken
+            : typeof source.rooted === "boolean" ? source.rooted : null
     };
 }
+function toLegacyNativeEvent(event) {
+    const context = event.context ?? {};
+    const payload = { ...event.payload, context };
+    if (event.event_type === "frontend_exception") {
+        payload.error = {
+            name: event.payload.name,
+            message: event.payload.message,
+            stack: event.payload.stack
+        };
+    }
+    else if (event.event_type === "request_event") {
+        payload.url = event.payload.path;
+    }
+    return { ...event, payload };
+}
+function canonicalDeviceType(value) {
+    return value === "desktop" || value === "mobile" || value === "tablet" ? value : "unknown";
+}
+function canonicalColorScheme(value) {
+    return value === "light" || value === "dark" || value === "no-preference" ? value : null;
+}
+function nonNegativeInteger(value) {
+    return nullableNonNegativeInteger(value) ?? 0;
+}
+function nullableNonNegativeInteger(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0
+        ? Math.trunc(value)
+        : null;
+}
+function positiveNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value > 0 ? value : null;
+}
+function nonNegativeNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) && value >= 0 ? value : null;
+}

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { DebugBundleReactNativeClient, createDebugBundleClient } from "./client.js";
 import { captureDebugBundleConsole } from "./console.js";
 import { installDebugBundleErrorHandlers } from "./errors.js";
-import type { DebugBundleCaptureContext, DebugBundleClient, DebugBundleConfig, DebugBundleLogLevel, DebugBundleProbeOptions, DebugBundleRequestInfo, DebugBundleResponseInfo, DebugBundleStatus } from "./types.js";
+import type { DebugBundleCaptureContext, DebugBundleBeforeSend, DebugBundleClient, DebugBundleConfig, DebugBundleLogLevel, DebugBundleProbeOptions, DebugBundleRequestInfo, DebugBundleResponseInfo, DebugBundleStatus } from "./types.js";
 export declare const DebugBundle: {
     init(config: DebugBundleConfig): void;
     captureException(error: unknown, context?: DebugBundleCaptureContext): void;
@@ -21,5 +21,5 @@ export declare const DebugBundle: {
 export { createDebugBundleClient, DebugBundleReactNativeClient };
 export { captureDebugBundleConsole };
 export { installDebugBundleErrorHandlers };
-export type { DebugBundleCaptureContext, DebugBundleClient, DebugBundleConfig, DebugBundleLogLevel, DebugBundleProbeOptions, DebugBundleRequestInfo, DebugBundleResponseInfo, DebugBundleStatus };
+export type { DebugBundleCaptureContext, DebugBundleBeforeSend, DebugBundleClient, DebugBundleConfig, DebugBundleLogLevel, DebugBundleProbeOptions, DebugBundleRequestInfo, DebugBundleResponseInfo, DebugBundleStatus };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EACV,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,WAAW;iBACT,iBAAiB,GAAG,IAAI;4BAWb,OAAO,YAAY,yBAAyB,GAAG,IAAI;wBAGvD,OAAO,YAAY,yBAAyB,GAAG,IAAI;wBAGnD,MAAM,UAAU,mBAAmB,YAAY,yBAAyB,GAAG,IAAI;4BAG3E,sBAAsB,YAAY,uBAAuB,YAAY,yBAAyB,GAAG,IAAI;4BAGrG,MAAM,UAAU,mBAAmB,YAAY,yBAAyB,GAAG,IAAI;oBAGvF,MAAM,SAAS,OAAO,GAAG,IAAI;iBAGhC,MAAM,QAAQ,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,uBAAuB,GAAG,IAAI;aAGrF,OAAO,CAAC,IAAI,CAAC;qCAGW,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;2BAGnC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;6BAG3C,MAAM,mBAAmB,MAAM,GAAG,IAAI,WAAW,MAAM,GAAG,IAAI;qBAGzE,iBAAiB;0BAGZ,MAAM,GAAG,IAAI;CAGjC,CAAC;AAEF,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,CAAC;AACrC,OAAO,EAAE,+BAA+B,EAAE,CAAC;AAC3C,YAAY,EACV,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAClB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,4BAA4B,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,cAAc,CAAC;AACzD,OAAO,EAAE,+BAA+B,EAAE,MAAM,aAAa,CAAC;AAC9D,OAAO,KAAK,EACV,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AAIpB,eAAO,MAAM,WAAW;iBACT,iBAAiB,GAAG,IAAI;4BAWb,OAAO,YAAY,yBAAyB,GAAG,IAAI;wBAGvD,OAAO,YAAY,yBAAyB,GAAG,IAAI;wBAGnD,MAAM,UAAU,mBAAmB,YAAY,yBAAyB,GAAG,IAAI;4BAG3E,sBAAsB,YAAY,uBAAuB,YAAY,yBAAyB,GAAG,IAAI;4BAGrG,MAAM,UAAU,mBAAmB,YAAY,yBAAyB,GAAG,IAAI;oBAGvF,MAAM,SAAS,OAAO,GAAG,IAAI;iBAGhC,MAAM,QAAQ,OAAO,GAAG,CAAC,MAAM,OAAO,CAAC,YAAY,uBAAuB,GAAG,IAAI;aAGrF,OAAO,CAAC,IAAI,CAAC;qCAGW,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;2BAGnC,MAAM,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;6BAG3C,MAAM,mBAAmB,MAAM,GAAG,IAAI,WAAW,MAAM,GAAG,IAAI;qBAGzE,iBAAiB;0BAGZ,MAAM,GAAG,IAAI;CAGjC,CAAC;AAEF,OAAO,EAAE,uBAAuB,EAAE,4BAA4B,EAAE,CAAC;AACjE,OAAO,EAAE,yBAAyB,EAAE,CAAC;AACrC,OAAO,EAAE,+BAA+B,EAAE,CAAC;AAC3C,YAAY,EACV,yBAAyB,EACzB,qBAAqB,EACrB,iBAAiB,EACjB,iBAAiB,EACjB,mBAAmB,EACnB,uBAAuB,EACvB,sBAAsB,EACtB,uBAAuB,EACvB,iBAAiB,EAClB,CAAC"}

package/dist/native.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAKlF,wBAAgB,eAAe,IAAI,uBAAuB,GAAG,IAAI,CAgBhE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAElG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAQ1E;AAED,wBAAsB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMhG;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}
+{"version":3,"file":"native.d.ts","sourceRoot":"","sources":["../src/native.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,uBAAuB,EAAE,sBAAsB,EAAE,MAAM,YAAY,CAAC;AAKlF,wBAAgB,eAAe,IAAI,uBAAuB,GAAG,IAAI,CAgBhE;AAED,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,uBAAuB,GAAG,IAAI,GAAG,SAAS,GAAG,IAAI,CAElG;AAED,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,sBAAsB,CAQ1E;AAED,wBAAsB,cAAc,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,QAAQ,EAAE,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAMhG;AAED,wBAAgB,gCAAgC,IAAI,IAAI,CAEvD"}

package/dist/native.js

@@ -1,3 +1,4 @@
+import { NativeModules, TurboModuleRegistry } from "react-native";
 let overrideModule;
 let cachedReactNativeModule;
 export function getNativeModule() {
@@ -38,22 +39,9 @@ export function resetNativeModuleCacheForTesting() {
     cachedReactNativeModule = undefined;
 }
 function resolveReactNativeModule() {
-    const required = requireReactNative();
-    const turboModule = required?.TurboModuleRegistry?.get?.("DebugBundleReactNative");
+    const turboModule = TurboModuleRegistry.get("DebugBundleReactNative");
     if (turboModule) {
         return turboModule;
     }
-    return required?.NativeModules?.DebugBundleReactNative ?? null;
-}
-function requireReactNative() {
-    try {
-        const maybeRequire = Function("return typeof require === 'function' ? require : null")();
-        if (!maybeRequire) {
-            return null;
-        }
-        return maybeRequire("react-native");
-    }
-    catch {
-        return null;
-    }
+    return NativeModules.DebugBundleReactNative ?? null;
 }

package/dist/testing.d.ts

@@ -1,7 +1,14 @@
-import type { DebugBundleEventEnvelope, NativeDebugBundleModule, NativeDebugBundleState, ResolvedDebugBundleConfig } from "./types.js";
+import type { DebugBundleEventEnvelope, NativeDebugBundleConfig, NativeDebugBundleModule, NativeDebugBundleState } from "./types.js";
 export interface RecordingNativeModule extends NativeDebugBundleModule {
     events: DebugBundleEventEnvelope[];
-    config: ResolvedDebugBundleConfig | null;
+    probes: Array<{
+        label: string;
+        data: unknown;
+        occurredAt: string;
+    }>;
+    context: Record<string, unknown>;
+    config: NativeDebugBundleConfig | null;
+    activeProbeLabels: Set<string>;
 }
 export declare function createRecordingNativeModule(initialState?: NativeDebugBundleState): RecordingNativeModule;
 export declare function installRecordingNativeModule(module?: RecordingNativeModule): RecordingNativeModule;

package/dist/testing.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"testing.d.ts","sourceRoot":"","sources":["../src/testing.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,wBAAwB,EACxB,uBAAuB,EACvB,uBAAuB,EACvB,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,qBAAsB,SAAQ,uBAAuB;IACpE,MAAM,EAAE,wBAAwB,EAAE,CAAC;IACnC,MAAM,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,OAAO,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,MAAM,EAAE,uBAAuB,GAAG,IAAI,CAAC;IACvC,iBAAiB,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;CAChC;AAED,wBAAgB,2BAA2B,CAAC,YAAY,GAAE,sBAAiE,GAAG,qBAAqB,CA4ClJ;AAED,wBAAgB,4BAA4B,CAAC,MAAM,GAAE,qBAAqD,GAAG,qBAAqB,CAGjI;AAED,wBAAgB,4BAA4B,IAAI,IAAI,CAGnD"}

package/dist/testing.js

@@ -3,15 +3,30 @@ export function createRecordingNativeModule(initialState = { status: "healthy",
     const state = { ...initialState };
     return {
         events: [],
+        probes: [],
+        context: {},
         config: null,
+        activeProbeLabels: new Set(),
         initialize(config) {
             this.config = config;
             return state;
         },
+        enqueueCanonicalEvent(event) {
+            this.events.push(event);
+            state.lastEventAt = Date.now();
+            return true;
+        },
         enqueueEvent(event) {
             this.events.push(event);
             state.lastEventAt = Date.now();
         },
+        captureProbe(label, data, occurredAt) {
+            this.probes.push({ label, data, occurredAt });
+            return this.activeProbeLabels.has(label);
+        },
+        isProbeActive(label) {
+            return this.activeProbeLabels.has(label);
+        },
         flush() {
             state.status = "healthy";
         },
@@ -21,6 +36,9 @@ export function createRecordingNativeModule(initialState = { status: "healthy",
         setContext() {
             return undefined;
         },
+        setContextValue(key, entry) {
+            this.context[key] = entry.value;
+        },
         activateProbeTriggerToken() {
             return true;
         }

package/dist/types.d.ts

@@ -1,5 +1,6 @@
 export type DebugBundleStatus = "healthy" | "degraded" | "disconnected";
 export type DebugBundleLogLevel = "debug" | "info" | "warning" | "error" | "critical";
+export type DebugBundleBeforeSend = (event: DebugBundleEventEnvelope) => DebugBundleEventEnvelope | null;
 export interface DebugBundleConfig {
     projectToken?: string;
     enabled?: boolean;
@@ -35,6 +36,7 @@ export interface DebugBundleConfig {
     redactFields?: string[];
     headerAllowlist?: string[];
     sdkVersion?: string;
+    beforeSend?: DebugBundleBeforeSend;
 }
 export interface ResolvedDebugBundleConfig {
     projectToken: string;
@@ -71,6 +73,7 @@ export interface ResolvedDebugBundleConfig {
     redactFields: string[];
     headerAllowlist: string[];
     sdkVersion: string;
+    beforeSend: DebugBundleBeforeSend | null;
 }
 export interface DebugBundleNetworkFilter {
     urlAllowlist?: string[];
@@ -97,7 +100,7 @@ export interface DebugBundleProbeOptions {
     heavy?: boolean;
 }
 export interface DebugBundleEventEnvelope {
-    schema_version: "1";
+    schema_version: "2026-03-01";
     event_id: string;
     event_type: "frontend_exception" | "frontend_breadcrumb" | "log_event" | "request_event" | "error_suppressed" | "probe_event";
     sdk_name: "@debugbundle/sdk-react-native";
@@ -109,14 +112,14 @@ export interface DebugBundleEventEnvelope {
         framework: "react-native";
     };
     occurred_at: string;
-    correlation: {
+    correlation?: {
         trace_id: string | null;
         request_id?: string | null;
         session_id?: string | null;
         user_id_hash?: string | null;
-    } | null;
+    };
+    context?: Record<string, unknown>;
     payload: Record<string, unknown>;
-    device: Record<string, unknown> | null;
 }
 export interface DebugBundleClient {
     readonly status: DebugBundleStatus;
@@ -135,13 +138,21 @@ export interface DebugBundleClient {
     recordScreen(screenName: string, previousScreen?: string | null, source?: string): void;
 }
 export interface NativeDebugBundleModule {
-    initialize(config: ResolvedDebugBundleConfig): Promise<NativeDebugBundleState> | NativeDebugBundleState;
+    initialize(config: NativeDebugBundleConfig): Promise<NativeDebugBundleState> | NativeDebugBundleState;
+    enqueueCanonicalEvent?(event: DebugBundleEventEnvelope): Promise<boolean | void> | boolean | void;
+    /** Compatibility fallback implemented by native binaries released before the canonical bridge. */
     enqueueEvent(event: DebugBundleEventEnvelope): Promise<void> | void;
+    captureProbe?(label: string, data: unknown, occurredAt: string): Promise<boolean> | boolean;
+    isProbeActive?(label: string): boolean;
     flush(): Promise<void> | void;
     getStatus(): Promise<NativeDebugBundleState> | NativeDebugBundleState;
     setContext?(key: string, value: unknown): Promise<void> | void;
+    setContextValue?(key: string, entry: {
+        value: unknown;
+    }): Promise<void> | void;
     activateProbeTriggerToken?(token: string): Promise<boolean> | boolean;
 }
+export type NativeDebugBundleConfig = Omit<ResolvedDebugBundleConfig, "beforeSend">;
 export interface NativeDebugBundleState {
     status: DebugBundleStatus;
     lastEventAt?: number | null;