@arms/rum-reactnative 0.1.1 → 0.1.3-beta.0

package/lib/module/utils/platform.js

@@ -1,87 +1,136 @@
 "use strict";
 
-import { AppType } from "@arms/rum-core";
-import AsyncStorage from '@react-native-async-storage/async-storage';
+import { AppType } from '@arms/rum-core';
+import { Dimensions, Platform } from 'react-native';
+import NativeRumSdkReactnative from "../NativeRumSdkReactnative.js";
+const _pkg = {"version":"0.1.3-beta.0"};
+export const VERSION = _pkg.version;
+
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
 
-// declare var __VERSION__: string;
-// export const VERSION = __VERSION__;
-export const VERSION = 'test';
 export const appName = 'react-native';
+
+/**
+ * 从 react-native/package.json 获取 RN 运行时版本号，
+ * 用于 os.container_version。
+ */
+function getReactNativeVersion() {
+  try {
+    const pkg = require('react-native/package.json');
+    return pkg.version ?? '';
+  } catch {
+    const info = Platform.constants?.reactNativeVersion;
+    if (info) {
+      return `${info.major}.${info.minor}.${info.patch}`;
+    }
+    return '';
+  }
+}
+
+// region Storage
+
 export function getStorage(key) {
-  return AsyncStorage.getItem(key);
+  return NativeRumSdkReactnative.getItem(key);
 }
 export function setStorage(key, data) {
-  return AsyncStorage.setItem(key, data);
+  return NativeRumSdkReactnative.setItem(key, data);
+}
+export function removeStorage(key) {
+  return NativeRumSdkReactnative.removeItem(key);
+}
+export function clearStorage() {
+  return NativeRumSdkReactnative.clear();
+}
+export function getAllStorageKeys() {
+  return NativeRumSdkReactnative.getAllKeys();
+}
+
+// endregion
+
+// region Device Info
+
+/**
+ * 调用原生桥采集设备信息。
+ * 失败时静默降级到 JS Platform API 填充基础字段。
+ */
+async function fetchDeviceInfo() {
+  try {
+    return await NativeRumSdkReactnative.getDeviceInfo();
+  } catch (err) {
+    console.warn('[rum] getDeviceInfo failed, falling back to JS defaults', err);
+    return {
+      os_type: Platform.OS === 'ios' ? 'iOS' : 'Android',
+      os_version: String(Platform.Version ?? '')
+    };
+  }
+}
+
+/**
+ * 模块级缓存，首次调用 fixAttrs 时懒初始化，避免模块加载时原生桥尚未就绪。
+ * null 表示尚未触发采集。
+ */
+let _cachedDeviceInfo = null;
+
+/**
+ * 获取设备信息（懒初始化，仅触发一次原生桥调用）。
+ */
+function getDeviceInfo() {
+  if (!_cachedDeviceInfo) {
+    _cachedDeviceInfo = fetchDeviceInfo();
+  }
+  return _cachedDeviceInfo;
 }
 
-// export function getNetType(): Promise<string> {
-//   return new Promise((resolve) => {
-//     try {
-//       sdk.getNetworkType({
-//         success: function (e) {
-//           const networkType = e.networkType || e.subtype;
-//           resolve(networkType ? networkType.toLowerCase() : undefined)
-//         },
-//         fail: function (res) {
-//           resolve(undefined)
-//         }
-//       });
-//     } catch (e) {
-//       resolve(undefined)
-//     }
-//   })
-// }
-
-export const fixAttrs = function (bundle) {
+// endregion
+
+/**
+ * 将设备 / 系统 / 网络等公共属性注入 bundle。
+ * 在 Reporter.request 中被调用；首次调用时懒触发设备信息采集。
+ */
+export const fixAttrs = async function (bundle) {
   if (!bundle) return;
-  let device = {};
-  let os = {};
-  let net = {};
-  // try {
-  //   device = {
-  //     id: DeviceInfo.getUniqueIdSync(),
-  //     type: DeviceInfo.getDeviceType(),
-  //     brand: DeviceInfo.getBrand(),
-  //     model: DeviceInfo.getModel(),
-  //     name: DeviceInfo.getDeviceNameSync(),
-  //   }
-  //
-  //   os = {
-  //     type: DeviceInfo.getSystemName(),
-  //     version: DeviceInfo.getSystemVersion(),
-  //     container: appName,
-  //     container_version: DeviceInfo.getVersion(),
-  //   };
-  //
-  //   net = {
-  //     // model: ,
-  //     // @ts-ignore
-  //     ip: DeviceInfo.getIpAddressSync(),
-  //   }
-  // } catch (err) {
-  //   console.warn('[rum] react-native-device-info fail', err);
-  //   const info = Platform.constants;
-  //   const rn = info.reactNativeVersion;
-  //   os.type = info.systemName;
-  //   os.version = info.osVersion;
-  //   os.container_version = `${rn.major}.${rn.minor}.${rn.patch}`;
-  // }
-  // try {
-  //     const info = Platform.constants;
-  //     const rn = info.reactNativeVersion;
-  //     os.type = info.systemName;
-  //     os.version = info.osVersion;
-  //     os.container = appName;
-  //     os.container_version = `${rn.major}.${rn.minor}.${rn.patch}`;
-  // } catch (e) {
-  //   //
-  // }
+  const native = await getDeviceInfo();
+
+  // device.*
+  const device = {
+    id: native.device_id,
+    type: native.device_type,
+    brand: native.device_brand,
+    model: native.device_model,
+    name: native.device_name
+  };
+
+  // os.*
+  const rnVersion = getReactNativeVersion();
+  const os = {
+    type: native.os_type ?? (Platform.OS === 'ios' ? 'iOS' : 'Android'),
+    version: native.os_version ?? String(Platform.Version ?? ''),
+    container: appName,
+    container_version: rnVersion || undefined
+  };
+
+  // viewport：优先使用原生采集的物理像素，兜底 JS Dimensions（逻辑像素）
+  let viewport;
+  if (native.viewport_width && native.viewport_height) {
+    viewport = {
+      width: native.viewport_width,
+      height: native.viewport_height
+    };
+  } else {
+    try {
+      const screen = Dimensions.get('screen');
+      viewport = {
+        width: Math.round(screen.width),
+        height: Math.round(screen.height)
+      };
+    } catch {
+      // 忽略
+    }
+  }
   bundle.app.type = AppType.reactnative;
+  bundle.app.package = bundle.app.package ?? native.app_package;
+  bundle.app.version = bundle.app.version ?? native.app_version;
   bundle._v = VERSION;
-  bundle.net = {
-    ...net,
-    ...bundle.net
-  };
   bundle.device = {
     ...device,
     ...bundle.device
@@ -90,6 +139,12 @@ export const fixAttrs = function (bundle) {
     ...os,
     ...bundle.os
   };
+  if (viewport) {
+    bundle.viewport = {
+      ...bundle.viewport,
+      ...viewport
+    };
+  }
   return bundle;
 };
 //# sourceMappingURL=platform.js.map

package/lib/module/utils/session.js

@@ -6,11 +6,21 @@ import { getCurView } from "./view.js";
 import { getStorage, setStorage } from "./platform.js";
 
 // 存储userID的键名
-const USER_ID = '_arms_uid';
+const USER_ID = '_rum_uid';
+// 旧版键名（用于迁移）
+const LEGACY_USER_ID = '_arms_uid';
 // 存储session
-// const RUM_SESSION = '_arms_session';
+// const RUM_SESSION = '_rum_session';
 
 export class RumSession {
+  /** 平台类型标识 */
+  appType = 'reactnative';
+
+  /** SDK 版本号（延迟导入避免循环依赖） */
+  get sdkVersion() {
+    return require('./platform').VERSION;
+  }
+
   // @ts-ignore
 
   // private sessionId = '';
@@ -54,8 +64,8 @@ export class RumSession {
     let info = {
       sessionId: sid,
       sampled: sampled !== '0',
-      startTime: parseInt(startTime || '') || 0,
-      lastTime: parseInt(lastTime || '') || 0
+      startTime: parseInt(startTime || '', 10) || 0,
+      lastTime: parseInt(lastTime || '', 10) || 0
     };
     if (!this.checkSession(info)) {
       info = this.resetSession();
@@ -71,6 +81,15 @@ export class RumSession {
   }
   async initUser() {
     this.userId = await getStorage(USER_ID);
+    // 迁移旧版键名 _arms_uid → _rum_uid
+    if (!this.userId) {
+      const legacyId = await getStorage(LEGACY_USER_ID);
+      if (legacyId) {
+        this.userId = legacyId;
+        await setStorage(USER_ID, this.userId);
+        return;
+      }
+    }
     if (!this.userId) {
       this.userId = `uid_${generateSpanId(16, 36)}`;
       await setStorage(USER_ID, this.userId);

package/lib/module/utils/view.js

@@ -70,6 +70,7 @@ function triggerNavigateChange(event) {
 }
 export function startTrackingViews(nav) {
   if (!nav || currentNavigationRef) return;
+  currentNavigationRef = nav;
   if (isFunction(nav.events)) {
     // react-native-navigation
     nav.events().registerComponentDidAppearListener(triggerNavigateChange);
@@ -77,7 +78,7 @@ export function startTrackingViews(nav) {
     // @react-native/navigation
     nav.addListener('state', triggerNavigateChange);
   }
-  currentNavigationRef = nav;
+  triggerNavigateChange({});
 }
 export function stopTrackingViews() {
   if (!currentNavigationRef) return;

package/lib/typescript/commonjs/package.json

@@ -0,0 +1 @@
+{"type":"commonjs"}

package/lib/typescript/commonjs/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/{src → commonjs/src}/collector/action/index.d.ts

@@ -3,12 +3,18 @@ export default class ActionCollector implements ICollector {
     name: string;
     private DELAY_TIME;
     ctx?: IContext;
-    sendEvent?: ((payload: RumEvent) => void);
+    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;
 }

package/lib/typescript/commonjs/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/{src → commonjs/src}/collector/exception/index.d.ts

@@ -3,9 +3,16 @@ 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;

package/lib/typescript/commonjs/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/{src → commonjs/src}/collector/view/pv.d.ts

@@ -1,6 +1,6 @@
 import { ICollector, IContext, RumEvent } from '@arms/rum-core';
-import { IPage } from "../../types/client";
-import { Route } from "../../types";
+import { IPage } from '../../types/client';
+import { Route } from '../../types';
 export default class PvCollector implements ICollector {
     name: string;
     ctx?: IContext;

package/lib/typescript/commonjs/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/commonjs/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/{src → commonjs/src}/processor/session-processor.d.ts

@@ -2,8 +2,10 @@ 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/{src → commonjs/src}/reporter/index.d.ts

@@ -8,7 +8,9 @@ declare class RNReporter extends Reporter implements IReporter {
     constructor();
     init(ctx: IContext): void;
     onAppStateChanged: (nextAppState: string) => void;
-    request(ctx: IContext, bundle: RumEventBundle): void;
+    request(ctx: IContext, bundle: RumEventBundle): Promise<void>;
+    /** 通过共享 emitter 通知崩溃采集器上报结果（成功则删文件，失败保留重试） */
+    private ackCrashes;
     catchHandle: (err: any) => void;
     destroy(): void;
 }

package/lib/typescript/commonjs/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/commonjs/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/{src → commonjs/src}/types/client.d.ts

@@ -1,5 +1,5 @@
-import { IConfiguration, ITracingOption } from "@arms/rum-core";
-import { IApiBaseAttr } from "../utils/api";
+import { IConfiguration, ITracingOption } from '@arms/rum-core';
+import { IApiBaseAttr } from '../utils/api';
 export interface IPage {
     id: string;
     path?: string;

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