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

package/lib/module/utils/crash.js

@@ -0,0 +1,141 @@
+"use strict";
+
+import { RumEventType, logger } from '@arms/rum-core';
+/**
+ * 将原生崩溃数据转换为 RumEvent 异常事件，对齐存储模型 Exception 表的
+ * Attributes（session/view/exception 基础信息）+ Metadata（堆栈、快照等）字段。
+ */
+export function convertCrashToRumEvent(crashData) {
+  const exceptionName = crashData.signal?.name || crashData.exception?.class_name || 'NativeCrash';
+  const exceptionMessage = buildMessage(crashData);
+  // NDK 崩溃的 frames 在顶层，Java 崩溃的 frames 在 crashed_thread 内
+  const frames = crashData.frames || crashData.crashed_thread?.frames || [];
+  const stack = formatStack(frames);
+  // 兼容旧版字符串格式：frames[0] 可能是字符串
+  const firstFrame = frames[0];
+  const file = typeof firstFrame === 'object' ? firstFrame?.library || '' : '';
+
+  // 从第一帧提取 line，原生崩溃无列号概念，column 固定为 0
+  let line = 0;
+  let column = 0;
+  if (frames.length > 0) {
+    const topFrame = frames[0];
+    if (topFrame && typeof topFrame === 'object' && typeof topFrame.line === 'number') {
+      line = topFrame.line;
+    }
+  }
+  const view = {
+    id: crashData.context?.view_id || '',
+    name: crashData.context?.view_name || ''
+  };
+
+  // 防御性转换：NDK 旧版本使用秒级 timestamp，新版本已改为毫秒
+  // 如果 timestamp 小于 1e12（约 2001 年的毫秒值），说明是秒级，需乘以 1000
+  let timestamp = crashData.timestamp || Date.now();
+  if (timestamp < 1e12) {
+    timestamp = timestamp * 1000;
+  }
+
+  // binary_images uuid 字段兼容：统一为 uuid，保留原 build_id/debug_id
+  const rawImages = crashData.binary_images || [];
+  const normalizedImages = rawImages.map(img => {
+    if (!img.uuid && (img.build_id || img.debug_id)) {
+      return {
+        ...img,
+        uuid: img.build_id || img.debug_id
+      };
+    }
+    return img;
+  });
+  return {
+    event_type: RumEventType.EXCEPTION,
+    timestamp,
+    // 设置崩溃时的原始 session_id，新版 rum-core dispatchEvents 会按
+    // session_id 分组上报，不再丢弃非当前 session 的事件
+    session_id: crashData.context?.session_id,
+    view,
+    times: 1,
+    // === Attributes ===
+    source: 'event',
+    type: 'crash',
+    name: exceptionName,
+    message: exceptionMessage,
+    file,
+    line,
+    column,
+    // === Metadata ===
+    stack,
+    caused_by: crashData.exception?.message || (crashData.signal ? `${crashData.signal.name || ''} at ${crashData.signal.fault_address || ''}` : ''),
+    binary_images: JSON.stringify(normalizedImages),
+    snapshots: JSON.stringify({
+      device: crashData.device || {},
+      registers: crashData.registers || {},
+      app: crashData.app || {},
+      crash_context: crashData.context || {},
+      // NDK 特有字段透传：arch 决定后端符号化的寄存器解释方式和地址宽度；
+      // pid 用于关联系统日志；signal.number 为 NDK 写入的原始信号编号
+      arch: crashData.arch || '',
+      pid: crashData.pid,
+      signal_number: crashData.signal?.number,
+      // 崩溃线程 ID：NDK 崩溃使用顶层 tid，Java 崩溃使用 crashed_thread.id
+      thread_id: String(crashData.crashed_thread?.id ?? crashData.tid ?? ''),
+      // 崩溃机制信息放入 snapshots 容器
+      ...(crashData.mechanism ? {
+        mechanism: crashData.mechanism
+      } : {})
+    })
+  };
+}
+function buildMessage(crashData) {
+  if (crashData.exception?.message) {
+    return crashData.exception.message;
+  }
+  const sig = crashData.signal;
+  if (sig) {
+    const addr = sig.fault_address || '';
+    return `${sig.name || ''} (${sig.code ?? ''})${addr ? ' at ' + addr : ''}`.trim();
+  }
+  return 'Native crash';
+}
+
+/**
+ * 格式化堆栈为可读字符串。
+ * 兼容两种 frames 格式：
+ * - 新版（对象数组）：[{address, library, symbol, offset}, ...]
+ * - 旧版（字符串数组）：["0x1234", ...]（旧版 NDK 崩溃文件）
+ */
+function formatStack(frames) {
+  if (!frames || frames.length === 0) return '';
+  return frames.map((frame, index) => {
+    // 兼容旧版 NDK 的纯字符串格式
+    if (typeof frame === 'string') {
+      return `#${index} <unknown> ${frame} ()`;
+    }
+    // 截断标记帧：双侧截断时插入的中间标记
+    if (frame.truncated) {
+      const count = frame.omitted_count ?? -1;
+      return `#${index} ... ${count} frames omitted ...`;
+    }
+    const library = frame.library || '<unknown>';
+    const symbol = frame.symbol || '';
+    const address = frame.address || '';
+    const offset = frame.offset || '';
+    if (symbol) {
+      return `#${index} ${library} ${symbol} + ${offset}`;
+    }
+    return `#${index} ${library} ${address} (${offset})`;
+  }).join('\n');
+}
+
+/**
+ * 安全调用原生桥方法，异常时静默降级。
+ */
+export async function safeNativeCall(fn, label) {
+  try {
+    return await fn();
+  } catch (e) {
+    logger.warn('native-bridge', `${label || 'native call'} failed`, e);
+    return undefined;
+  }
+}
+//# sourceMappingURL=crash.js.map

package/lib/module/utils/platform.js

@@ -1,90 +1,136 @@
 "use strict";
 
 import { AppType } from '@arms/rum-core';
-import AsyncStorage from '@react-native-async-storage/async-storage';
-
-// declare var __VERSION__: string;
-// export const VERSION = __VERSION__;
-export const VERSION = 'test';
+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
 
 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
@@ -93,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/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

@@ -6,9 +6,15 @@ export default class ActionCollector implements ICollector {
     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/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/{src → commonjs/src}/shell.d.ts

@@ -1,6 +1,16 @@
 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 来组织
@@ -40,6 +50,7 @@ export declare class ArmsRum extends Shell {
      */
     startTrackingViews(navigationRef: NavigationContainerRef | any): void;
     stopTrackingViews(): void;
+    getCollector<T extends CollectorName>(name: T): CollectorMap[T] | undefined;
 }
 declare const _default: ArmsRum;
 export default _default;