@arms/rum-reactnative 0.1.2 → 0.1.3-beta.1

package/lib/typescript/commonjs/src/types/crash.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 崩溃相关类型定义
+ */
+/** 崩溃上下文同步事件名 */
+export declare const CRASH_CONTEXT_EVENT = "crash_context_change";
+/** 崩溃上报确认事件名（reporter -> crash collector，用于 ack 后删除文件） */
+export declare const CRASH_REPORT_ACK_EVENT = "crash_report_ack";
+/**
+ * 挂在崩溃 RumEvent 上的瞬态字段名，携带 crash_id。
+ * reporter 上报前提取用于 ack、并在序列化前剥离，不会发送到后端。
+ */
+export declare const CRASH_ID_FIELD = "__rum_crash_id";
+/** 崩溃上报确认事件负载 */
+export interface CrashReportAck {
+    /** 本次上报包含的 crash_id 列表 */
+    crashIds: string[];
+    /** 上报是否成功（HTTP 2xx） */
+    success: boolean;
+}
+/**
+ * 崩溃上下文快照（session / view 变更时同步到原生侧）。
+ */
+export interface CrashContextSnapshot {
+    session_id?: string;
+    view_id?: string;
+    view_name?: string;
+    user_id?: string;
+}
+/**
+ * 原生崩溃栈帧数据结构。
+ */
+export interface NativeCrashFrame {
+    library?: string;
+    symbol?: string;
+    address?: string;
+    /** 模块加载基址（Android NDK 提供，供后端结合 build_id 符号化） */
+    image_addr?: string;
+    offset?: string;
+    line?: number;
+    /** 截断标记帧：true 表示此帧为双侧截断的中间标记，非实际栈帧 */
+    truncated?: boolean;
+    /** 被省略的帧数（-1 表示未知总数，NDK 场景） */
+    omitted_count?: number;
+}
+/**
+ * 原生崩溃数据结构（与原生侧 RumCrashReporter / CrashContextManager 写入的 JSON 对齐）。
+ * 仅声明 JS 层会用到的字段，未列出的字段会通过 snapshots 透传给后端。
+ */
+export interface NativeCrashData {
+    /** crash_id 可选，兼容旧版 NDK 崩溃文件（无 crash_id 字段） */
+    crash_id?: string;
+    timestamp?: number;
+    signal?: {
+        name?: string;
+        /** NDK 写入为数字（si_code），Java 侧可能为字符串 */
+        code?: string | number;
+        fault_address?: string;
+        /** NDK 信号编号 */
+        number?: number;
+    };
+    exception?: {
+        type?: string;
+        class_name?: string;
+        message?: string;
+    };
+    /**
+     * 顶层 frames（NDK 崩溃格式）。
+     * NDK 崩溃 JSON 的 frames 在顶层，不在 crashed_thread 内。
+     */
+    frames?: NativeCrashFrame[] | string[];
+    crashed_thread?: {
+        id?: number | string;
+        /** frames 兼容新版对象格式和旧版字符串格式 */
+        frames?: NativeCrashFrame[] | string[];
+    };
+    /** NDK 崩溃进程 ID */
+    pid?: number;
+    /** NDK 崩溃线程 ID */
+    tid?: number;
+    /** NDK 崩溃架构（arm64/arm/x86_64/x86） */
+    arch?: string;
+    binary_images?: unknown[];
+    device?: Record<string, unknown>;
+    registers?: Record<string, unknown>;
+    app?: Record<string, unknown>;
+    context?: {
+        session_id?: string;
+        view_id?: string;
+        view_name?: string;
+        user_id?: string;
+    };
+    /** 崩溃机制信息（iOS normalizeKSCrashReport / Android getPendingCrashes 写入） */
+    mechanism?: Record<string, unknown>;
+}
+//# sourceMappingURL=crash.d.ts.map

package/lib/typescript/commonjs/src/utils/action.d.ts

@@ -0,0 +1,63 @@
+/**
+ * 行为事件监听 & React Native 触摸自动采集
+ *
+ * 通过 patch React 的元素创建函数（createElement 及自动 JSX 运行时
+ * jsx/jsxs/jsxDEV），自动拦截 Pressable / TouchableOpacity 等可触摸组件的
+ * onPress，并从触摸事件（GestureResponderEvent）、onLayout、props/children 中
+ * 提取丰富的行为数据（位置、尺寸、持续时间、语义化名称、快照等），发射标准事件
+ * 给 ActionCollector。
+ *
+ * 说明：现代 RN/Expo（babel-preset-expo）默认使用「automatic」JSX 运行时，
+ * JSX 会被编译为 react/jsx-runtime 的 jsx()/jsxs()（生产）或
+ * react/jsx-dev-runtime 的 jsxDEV()（开发），而非 React.createElement。
+ * 因此必须同时 patch 这三者才能覆盖所有场景。
+ */
+export interface ActionEvent {
+    /** 行为类型，固定为 tap */
+    type: string;
+    /** 语义化名称，如 `tap Pressable#btn-login: 登录` */
+    name?: string;
+    /** 目标元素标识（selector），如 `Pressable#btn-login` */
+    targetName?: string;
+    /** 从按下到抬起的持续时间（毫秒），需要 onPressIn 支持 */
+    duration?: number;
+    /** 点击位置信息（相对屏幕 x/y，相对元素 ex/ey），用于热力图分析 */
+    position?: {
+        x?: number;
+        y?: number;
+        ex?: number;
+        ey?: number;
+    };
+    /** 目标元素信息 */
+    target: {
+        id: string;
+        /** 关键属性快照 { id, testID, accessibilityLabel } */
+        dataset: Record<string, any>;
+        selector?: string;
+        width?: number;
+        height?: number;
+        /** 是否为可交互元素（1=可交互），用于无效点击分析 */
+        reaction?: number;
+        /** 是否为可信交互（1=真实原生触摸），用于错误点击分析 */
+        trust?: number;
+    };
+    currentTarget?: {
+        id: string;
+    };
+}
+export type ActionListener = (event: ActionEvent) => void;
+export declare function addActionListener(listener: ActionListener): void;
+export declare function removeActionListener(listener: ActionListener): void;
+/**
+ * 开始自动采集用户点击行为
+ *
+ * 原理：patch React.createElement 以及 automatic JSX 运行时的 jsx/jsxs/jsxDEV，
+ * 当组件为可触摸类型且含 onPress + id/testID/accessibilityLabel 时，
+ * 包装 onPress 使其在调用时自动 emit action 事件。
+ */
+export declare function startTrackingActions(): void;
+/**
+ * 停止自动采集
+ */
+export declare function stopTrackingActions(): void;
+//# sourceMappingURL=action.d.ts.map

package/lib/typescript/commonjs/src/utils/crash.d.ts

@@ -0,0 +1,12 @@
+import { type RumEvent } from '@arms/rum-core';
+import type { NativeCrashData } from '../types/crash';
+/**
+ * 将原生崩溃数据转换为 RumEvent 异常事件，对齐存储模型 Exception 表的
+ * Attributes（session/view/exception 基础信息）+ Metadata（堆栈、快照等）字段。
+ */
+export declare function convertCrashToRumEvent(crashData: NativeCrashData): RumEvent;
+/**
+ * 安全调用原生桥方法，异常时静默降级。
+ */
+export declare function safeNativeCall<T>(fn: () => Promise<T>, label?: string): Promise<T | undefined>;
+//# sourceMappingURL=crash.d.ts.map

package/lib/typescript/commonjs/src/utils/platform.d.ts

@@ -0,0 +1,22 @@
+import { RumEventBundle } from '@arms/rum-core';
+export declare const VERSION: string;
+export interface Global {
+    ErrorUtils: {
+        setGlobalHandler: any;
+        reportFatalError: any;
+        getGlobalHandler: any;
+    };
+}
+export declare var global: Global;
+export declare const appName = "react-native";
+export declare function getStorage(key: string): Promise<string | null>;
+export declare function setStorage(key: string, data: string): Promise<void>;
+export declare function removeStorage(key: string): Promise<void>;
+export declare function clearStorage(): Promise<void>;
+export declare function getAllStorageKeys(): Promise<string[]>;
+/**
+ * 将设备 / 系统 / 网络等公共属性注入 bundle。
+ * 在 Reporter.request 中被调用；首次调用时懒触发设备信息采集。
+ */
+export declare const fixAttrs: (bundle: RumEventBundle) => Promise<RumEventBundle | undefined>;
+//# sourceMappingURL=platform.d.ts.map

package/lib/typescript/{src → commonjs/src}/utils/session.d.ts

@@ -8,6 +8,10 @@ interface SessionInfo {
 }
 export declare class RumSession implements IRumSession {
     ctx?: IContext;
+    /** 平台类型标识 */
+    appType: string;
+    /** SDK 版本号（延迟导入避免循环依赖） */
+    get sdkVersion(): string;
     sessionConfig: SessionConfig;
     private session;
     private userId;

package/lib/typescript/module/src/NativeRumSdkReactnative.d.ts

@@ -0,0 +1,49 @@
+import type { TurboModule } from 'react-native';
+/**
+ * 原生设备信息，对应存储模型中的公共属性：
+ * - device.* （id / type / brand / model / name）
+ * - os.*     （type / version / container / container_version）
+ * - app.package
+ * - viewport.width / viewport.height
+ */
+export interface NativeDeviceInfo {
+    device_id?: string;
+    device_type?: string;
+    device_brand?: string;
+    device_model?: string;
+    device_name?: string;
+    os_type?: string;
+    os_version?: string;
+    app_package?: string;
+    app_version?: string;
+    viewport_width?: number;
+    viewport_height?: number;
+}
+export interface Spec extends TurboModule {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear(): Promise<void>;
+    getAllKeys(): Promise<string[]>;
+    /**
+     * 采集原生平台设备信息，仅在初始化时调用一次。
+     */
+    getDeviceInfo(): Promise<NativeDeviceInfo>;
+    /** 获取待上报的崩溃报告列表（下次启动时调用） */
+    getPendingCrashes(): Promise<string>;
+    /** 清除已上报的崩溃文件 */
+    clearCrashReports(crashIds: string): Promise<void>;
+    /** 清除所有崩溃报告文件（用于清理无 crash_id 的旧版文件） */
+    clearAllCrashReports(): Promise<void>;
+    /** 清理过期和超限的崩溃文件（maxFiles 上限，maxAgeMs 过期时间） */
+    cleanupOldCrashes(maxFiles: number, maxAgeMs: number): Promise<void>;
+    /** 查询上次运行是否发生过崩溃 */
+    crashedLastRun(): Promise<boolean>;
+    /** 更新崩溃上下文快照（session/view 变更时调用） */
+    updateCrashContext(context: string): void;
+    /** 触发测试崩溃（仅用于开发调试，调用后 App 立即崩溃） */
+    triggerTestCrash(crashType: string): void;
+}
+declare const _default: Spec;
+export default _default;
+//# sourceMappingURL=NativeRumSdkReactnative.d.ts.map

package/lib/typescript/module/src/collector/action/index.d.ts

@@ -0,0 +1,21 @@
+import { ICollector, IContext, RumActionEvent, RumEvent } from '@arms/rum-core';
+export default class ActionCollector implements ICollector {
+    name: string;
+    private DELAY_TIME;
+    ctx?: IContext;
+    sendEvent?: (payload: RumEvent) => void;
+    events: string[];
+    lastEvent?: RumActionEvent;
+    lastActionId?: string;
+    timer: any;
+    setup(ctx: IContext, sendEvent: (payload: RumEvent) => void): void;
+    onEvent: (e: any) => void;
+    /**
+     * 组装热力图相关的 target 信息（selector/宽高/可交互性/可信度）。
+     * 当没有任何字段时返回 undefined，避免上报空对象。
+     */
+    private buildTarget;
+    sendAction: () => void;
+    destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/src/collector/exception/crash.d.ts

@@ -0,0 +1,28 @@
+import type { ICollector, IContext, SendEventFn } from '@arms/rum-core';
+/**
+ * 崩溃采集器（Exception 的子类型）：
+ * 1. 初始化时读取上次运行写入的原生崩溃文件，转换为 RumEvent 通过标准管线上报；
+ * 2. 通过 ctx.emitter 订阅上下文变更事件，同步到原生侧
+ *    （用于下一次启动时崩溃报告携带正确上下文）。
+ */
+export default class CrashCollector implements ICollector {
+    name: string;
+    private ctx?;
+    private sendEvent?;
+    private initialized;
+    /** 已上报待确认（ack）的 crash_id，成功后才删文件 */
+    private pendingAckIds;
+    setup(ctx: IContext, sendEvent: SendEventFn): void;
+    private processPendingCrashes;
+    /** 兜底清理：删除过期和超限的崩溃文件，防止存储耗尽 */
+    private cleanupOldCrashes;
+    private onCrashContextChange;
+    /**
+     * reporter 上报确认回调：
+     * - 成功：删除对应 crash_id 的崩溃文件（确保上报成功后才删，不丢数据）；
+     * - 失败：保留文件，下次启动重试，仅从内存待确认集合中移除。
+     */
+    private onCrashReportAck;
+    destroy(): void;
+}
+//# sourceMappingURL=crash.d.ts.map

package/lib/typescript/module/src/collector/exception/index.d.ts

@@ -0,0 +1,32 @@
+import { ICollector, IContext, RumEvent } from '@arms/rum-core';
+export default class ExceptionCollector implements ICollector {
+    name: string;
+    ctx?: IContext;
+    sendEvent?: (payload: RumEvent) => void;
+    private installed;
+    /** fatal 去重保护：防止连续 fatal error 重复上报 */
+    private handlingFatal;
+    /** 防止 errorHandle 内部 console.error 形成循环 */
+    private inErrorHandle;
+    private origin;
+    setup(ctx: IContext, sendEvent: (payload: RumEvent) => void): void;
+    hackOrigin(): void;
+    /** JSC 引擎 Promise rejection 兜底方案 */
+    private setupJSCPromiseRejection;
+    onError: (e: Error | string, isFatal?: boolean) => void;
+    onUnhandled: (_id: string, error: unknown) => void;
+    errorHandle: (error: any, source?: string) => void;
+    /**
+     * 根据stack获取Error信息
+     * TODO: 增加基于Stack解析filename和lineNumber的能力
+     * @param stack
+     * @returns
+     */
+    getErrorByStack(stack?: string): {
+        name: string;
+        message: string;
+    } | undefined;
+    errorFilter(err: Error): boolean;
+    destroy(): void;
+}
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/src/collector/index.d.ts

@@ -0,0 +1,6 @@
+export { default as PvCollector } from './view/pv';
+export { default as ExceptionCollector } from './exception/index';
+export { default as CrashCollector } from './exception/crash';
+export { default as ApiCollector } from './resource/api';
+export { default as ActionCollector } from './action/index';
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/src/collector/resource/api.d.ts

@@ -0,0 +1,21 @@
+import { ICollector, IContext, ITracingHeaders, RumEvent } from '@arms/rum-core';
+import { IApiAttr, IApiCache } from '../../utils/api';
+declare global {
+    interface XMLHttpRequest {
+        apiAttr: IApiAttr;
+        apiCache: IApiCache;
+    }
+}
+export default class ApiCollector implements ICollector {
+    name: string;
+    private ctx?;
+    private sendEvent?;
+    private originFetch;
+    setup(ctx: IContext, sendEvent: (payload: RumEvent) => void): void;
+    injectTracing(apiAttr: IApiAttr, inject: (tracingHeaders: ITracingHeaders) => void): void;
+    hackXhr(): void;
+    hackFetch(): void;
+    sendAPI(apiAttr: IApiAttr, entry: any): void;
+    destroy(): void;
+}
+//# sourceMappingURL=api.d.ts.map

package/lib/typescript/module/src/collector/view/perf.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=perf.d.ts.map

package/lib/typescript/module/src/collector/view/pv.d.ts

@@ -0,0 +1,16 @@
+import { ICollector, IContext, RumEvent } from '@arms/rum-core';
+import { IPage } from '../../types/client';
+import { Route } from '../../types';
+export default class PvCollector implements ICollector {
+    name: string;
+    ctx?: IContext;
+    sendEvent?: (payload: RumEvent) => void;
+    private prevPage?;
+    private pageMap;
+    setup(ctx: IContext, sendEvent: (payload: RumEvent) => void): void;
+    onChange: (route: Route<any>) => void;
+    sendPv: (page: IPage) => void;
+    private getViewName;
+    destroy(): void;
+}
+//# sourceMappingURL=pv.d.ts.map

package/lib/typescript/module/src/expoConfigPlugin.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Expo config plugin for @arms/rum-reactnative.
+ *
+ * 在 app.config 中声明后，将 SDK 配置写入 `expoConfig.extra.rumSdk`，运行时可通过
+ * `Constants.expoConfig?.extra?.rumSdk` 读取，避免在 JS 入口硬编码 endpoint。
+ *
+ * app.config.ts 示例：
+ *   plugins: [['@arms/rum-reactnative', { endpoint: '...', env: 'prod' }]]
+ *
+ * 仅做配置透传，不注入原生构建设置（podspec / gradle 已由 autolinking 处理）。
+ * 零运行时依赖，非 Expo 用户安装本包不会拉入 @expo/* 。
+ */
+/** 本插件触碰到的 expo config 切片，故意放宽以避免对 @expo/config-types 的硬依赖。 */
+export interface RumExpoConfig {
+    [key: string]: unknown;
+    extra?: Record<string, unknown>;
+}
+export interface RumSdkPluginProps {
+    /** ARMS 上报地址，可在控制台创建应用后获取 */
+    endpoint?: string;
+    /** 环境，默认 'prod' */
+    env?: 'prod' | 'gray' | 'pre' | 'daily' | 'local';
+    /** 应用版本号 */
+    version?: string;
+}
+declare const withRumSdk: (config: RumExpoConfig, props?: RumSdkPluginProps) => RumExpoConfig;
+export default withRumSdk;
+//# sourceMappingURL=expoConfigPlugin.d.ts.map

package/lib/typescript/module/src/index.d.ts

@@ -0,0 +1,6 @@
+import armsRum, { ArmsRum } from './shell';
+export { logger, callMonitored } from '@arms/rum-core';
+export type { ISelfMonitorConfig } from '@arms/rum-core';
+export { ArmsRum };
+export default armsRum;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/src/plugin.d.ts

@@ -0,0 +1,3 @@
+import armsRum from './shell';
+export default armsRum;
+//# sourceMappingURL=plugin.d.ts.map

package/lib/typescript/module/src/processor/default-processor.d.ts

@@ -0,0 +1,6 @@
+import { IContext, IProcessor, RumEvent } from '@arms/rum-core';
+export default class DefaultProcessor implements IProcessor {
+    name: string;
+    process(ctx: IContext): RumEvent;
+}
+//# sourceMappingURL=default-processor.d.ts.map

package/lib/typescript/module/src/processor/session-processor.d.ts

@@ -0,0 +1,11 @@
+import { IContext, IProcessor } from '@arms/rum-core';
+export default class SessionProcessor implements IProcessor {
+    name: string;
+    ctx?: IContext;
+    private lastSessionId;
+    setup(ctx: IContext): void;
+    update: (e?: Event) => void;
+    process(ctx: IContext): import("@arms/rum-core").RumEvent;
+    private syncCrashContext;
+}
+//# sourceMappingURL=session-processor.d.ts.map

package/lib/typescript/module/src/reporter/index.d.ts

@@ -0,0 +1,18 @@
+import { IContext, IReporter, Reporter, RumEventBundle } from '@arms/rum-core';
+/**
+ * rn-app reporter
+ */
+declare class RNReporter extends Reporter implements IReporter {
+    name: string;
+    private appStateListener?;
+    constructor();
+    init(ctx: IContext): void;
+    onAppStateChanged: (nextAppState: string) => void;
+    request(ctx: IContext, bundle: RumEventBundle): Promise<void>;
+    /** 通过共享 emitter 通知崩溃采集器上报结果（成功则删文件，失败保留重试） */
+    private ackCrashes;
+    catchHandle: (err: any) => void;
+    destroy(): void;
+}
+export default RNReporter;
+//# sourceMappingURL=index.d.ts.map

package/lib/typescript/module/src/reporter/monitor-reporter.d.ts

@@ -0,0 +1,8 @@
+import { IMonitorReporter, MonitorEventBundle } from '@arms/rum-core';
+export declare class RNMonitorReporter implements IMonitorReporter {
+    private endpoint;
+    constructor(endpoint: string);
+    send(data: MonitorEventBundle[]): void;
+    private buildMonitorEndpoint;
+}
+//# sourceMappingURL=monitor-reporter.d.ts.map

package/lib/typescript/module/src/shell.d.ts

@@ -0,0 +1,57 @@
+import { Shell } from '@arms/rum-core';
+import * as collectors from './collector';
+import { IRNConfig } from './types/client';
+import { NavigationContainerRef } from './types';
+declare const builtInCollectors: readonly (typeof collectors.PvCollector | typeof collectors.ExceptionCollector | typeof collectors.CrashCollector | typeof collectors.ApiCollector | typeof collectors.ActionCollector)[];
+type CollectorName = (typeof builtInCollectors)[number]['prototype']['name'];
+type CollectorMap = {
+    [K in CollectorName]: InstanceType<Extract<(typeof builtInCollectors)[number], {
+        prototype: {
+            name: K;
+        };
+    }>>;
+};
+/**
+ * 对外导出 shell 层, 所有 shell 层模型的 API 设计约定：
+ * 1. API 命名空间按照 variables / functions / events 来组织
+ * 2. 事件（events）的命名格式为：on[Will|Did]VerbNoun?，参考 https://code.visualstudio.com/api/references/vscode-api#events
+ * 3. 基于 Disposable 模式，对于事件的绑定、快捷键的绑定函数，返回值则是解绑函数
+ */
+export declare class ArmsRum extends Shell {
+    version: string;
+    /**
+     * 初始化
+     */
+    init(config: IRNConfig): this;
+    /**
+     * set config
+     */
+    setConfig<T extends keyof IRNConfig>(key: T, value: IRNConfig[T]): void;
+    setConfig(value: IRNConfig): void;
+    /**
+     * 开启路由变化监听，自动采集 PV 数据
+     *
+     * 必须在 NavigationContainer 的 `onReady` 回调中调用，以确保
+     * navigationRef 已正确初始化。
+     *
+     * @example
+     * ```tsx
+     * <NavigationContainer
+     *   ref={navigationRef}
+     *   onReady={() => {
+     *     ArmsRum.startTrackingViews(navigationRef);
+     *   }}
+     * >
+     *   ...
+     * </NavigationContainer>
+     * ```
+     *
+     * @param navigationRef - NavigationContainer 的 ref 引用
+     */
+    startTrackingViews(navigationRef: NavigationContainerRef | any): void;
+    stopTrackingViews(): void;
+    getCollector<T extends CollectorName>(name: T): CollectorMap[T] | undefined;
+}
+declare const _default: ArmsRum;
+export default _default;
+//# sourceMappingURL=shell.d.ts.map

package/lib/typescript/module/src/types/client.d.ts

@@ -0,0 +1,27 @@
+import { IConfiguration, ITracingOption } from '@arms/rum-core';
+import { IApiBaseAttr } from '../utils/api';
+export interface IPage {
+    id: string;
+    path?: string;
+    name?: string;
+    params?: object;
+}
+export interface IRNConfig extends IConfiguration {
+    /**
+     * view.name 解析
+     */
+    parseViewName?(url: string, page?: IPage): string;
+    /**
+     * resource.name 解析
+     */
+    parseResourceName?(url: string): string;
+    /**
+     * tracing 配置 'tracecontext' | 'b3' | 'b3multi' | 'jaeger';
+     */
+    tracing?: boolean | ITracingOption;
+    /**
+     * request 自定义解析;
+     */
+    evaluateApi?(request: any, response: any, error?: Error, xhr?: XMLHttpRequest): Promise<IApiBaseAttr>;
+}
+//# sourceMappingURL=client.d.ts.map

package/lib/typescript/module/src/types/crash.d.ts

@@ -0,0 +1,95 @@
+/**
+ * 崩溃相关类型定义
+ */
+/** 崩溃上下文同步事件名 */
+export declare const CRASH_CONTEXT_EVENT = "crash_context_change";
+/** 崩溃上报确认事件名（reporter -> crash collector，用于 ack 后删除文件） */
+export declare const CRASH_REPORT_ACK_EVENT = "crash_report_ack";
+/**
+ * 挂在崩溃 RumEvent 上的瞬态字段名，携带 crash_id。
+ * reporter 上报前提取用于 ack、并在序列化前剥离，不会发送到后端。
+ */
+export declare const CRASH_ID_FIELD = "__rum_crash_id";
+/** 崩溃上报确认事件负载 */
+export interface CrashReportAck {
+    /** 本次上报包含的 crash_id 列表 */
+    crashIds: string[];
+    /** 上报是否成功（HTTP 2xx） */
+    success: boolean;
+}
+/**
+ * 崩溃上下文快照（session / view 变更时同步到原生侧）。
+ */
+export interface CrashContextSnapshot {
+    session_id?: string;
+    view_id?: string;
+    view_name?: string;
+    user_id?: string;
+}
+/**
+ * 原生崩溃栈帧数据结构。
+ */
+export interface NativeCrashFrame {
+    library?: string;
+    symbol?: string;
+    address?: string;
+    /** 模块加载基址（Android NDK 提供，供后端结合 build_id 符号化） */
+    image_addr?: string;
+    offset?: string;
+    line?: number;
+    /** 截断标记帧：true 表示此帧为双侧截断的中间标记，非实际栈帧 */
+    truncated?: boolean;
+    /** 被省略的帧数（-1 表示未知总数，NDK 场景） */
+    omitted_count?: number;
+}
+/**
+ * 原生崩溃数据结构（与原生侧 RumCrashReporter / CrashContextManager 写入的 JSON 对齐）。
+ * 仅声明 JS 层会用到的字段，未列出的字段会通过 snapshots 透传给后端。
+ */
+export interface NativeCrashData {
+    /** crash_id 可选，兼容旧版 NDK 崩溃文件（无 crash_id 字段） */
+    crash_id?: string;
+    timestamp?: number;
+    signal?: {
+        name?: string;
+        /** NDK 写入为数字（si_code），Java 侧可能为字符串 */
+        code?: string | number;
+        fault_address?: string;
+        /** NDK 信号编号 */
+        number?: number;
+    };
+    exception?: {
+        type?: string;
+        class_name?: string;
+        message?: string;
+    };
+    /**
+     * 顶层 frames（NDK 崩溃格式）。
+     * NDK 崩溃 JSON 的 frames 在顶层，不在 crashed_thread 内。
+     */
+    frames?: NativeCrashFrame[] | string[];
+    crashed_thread?: {
+        id?: number | string;
+        /** frames 兼容新版对象格式和旧版字符串格式 */
+        frames?: NativeCrashFrame[] | string[];
+    };
+    /** NDK 崩溃进程 ID */
+    pid?: number;
+    /** NDK 崩溃线程 ID */
+    tid?: number;
+    /** NDK 崩溃架构（arm64/arm/x86_64/x86） */
+    arch?: string;
+    binary_images?: unknown[];
+    device?: Record<string, unknown>;
+    registers?: Record<string, unknown>;
+    app?: Record<string, unknown>;
+    context?: {
+        session_id?: string;
+        view_id?: string;
+        view_name?: string;
+        user_id?: string;
+    };
+    /** 崩溃机制信息（iOS normalizeKSCrashReport / Android getPendingCrashes 写入） */
+    mechanism?: Record<string, unknown>;
+}
+//# sourceMappingURL=crash.d.ts.map