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

package/lib/module/utils/action.js

@@ -0,0 +1,299 @@
+"use strict";
+
+import { isFunction } from '@arms/rum-core';
+
+/**
+ * 行为事件监听 & 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 这三者才能覆盖所有场景。
+ */
+
+const actionListeners = [];
+let patched = false;
+
+/** 语义化名称中截取的子元素文本最大长度 */
+const MAX_TEXT_LENGTH = 20;
+
+/** 已 patch 的目标：{ module, key, original } 用于还原 */
+
+let patchTargets = [];
+export function addActionListener(listener) {
+  if (isFunction(listener)) {
+    actionListeners.push(listener);
+  }
+}
+export function removeActionListener(listener) {
+  const idx = actionListeners.indexOf(listener);
+  if (idx > -1) {
+    actionListeners.splice(idx, 1);
+  }
+}
+
+/** 采集到的原始触摸数据，交由 emitAction 组装为标准 ActionEvent */
+
+function emitAction(raw) {
+  const {
+    id,
+    componentName,
+    props,
+    children,
+    nativeEvent,
+    pressInTs,
+    layout
+  } = raw;
+
+  // 关键属性快照
+  const dataset = {};
+  if (props.id) dataset.id = props.id;
+  if (props.testID) dataset.testID = props.testID;
+  if (props.accessibilityLabel) {
+    dataset.accessibilityLabel = props.accessibilityLabel;
+  }
+  const text = getElementText(children);
+  const selector = componentName ? `${componentName}#${id}` : `#${id}`;
+  const label = `tap ${selector}`;
+  const name = text ? `${label}: ${text}` : label;
+  const position = getPosition(nativeEvent);
+  const duration = pressInTs && nativeEvent && typeof nativeEvent.timestamp === 'number' ? Math.max(0, Math.round(nativeEvent.timestamp - pressInTs)) : undefined;
+  const event = {
+    type: 'tap',
+    name,
+    targetName: selector,
+    duration,
+    position,
+    target: {
+      id,
+      dataset,
+      selector,
+      width: layout?.width,
+      height: layout?.height,
+      // 带 onPress 的 touchable 本身即为可交互元素
+      reaction: 1,
+      // 存在原生触摸事件视为可信交互，纯代码调用视为不可信
+      trust: nativeEvent ? 1 : 0
+    }
+  };
+  actionListeners.forEach(listener => {
+    listener(event);
+  });
+}
+
+/** 获取组件的显示名称，如 Pressable / TouchableOpacity */
+function getComponentName(type) {
+  if (!type) return undefined;
+  if (typeof type === 'string') return type;
+  return type.displayName || type.name || undefined;
+}
+
+/** 递归提取 children 中的文本内容，用于生成语义化名称 */
+function getElementText(children) {
+  const acc = {
+    text: ''
+  };
+  collectText(children, acc);
+  const t = acc.text.trim();
+  if (!t) return '';
+  return t.length > MAX_TEXT_LENGTH ? t.slice(0, MAX_TEXT_LENGTH) + '...' : t;
+}
+function collectText(node, acc) {
+  if (node == null || typeof node === 'boolean') return;
+  if (acc.text.length > MAX_TEXT_LENGTH) return;
+  if (typeof node === 'string' || typeof node === 'number') {
+    acc.text += String(node);
+    return;
+  }
+  if (Array.isArray(node)) {
+    node.forEach(c => collectText(c, acc));
+    return;
+  }
+  if (node.props && node.props.children != null) {
+    collectText(node.props.children, acc);
+  }
+}
+
+/** 从原生触摸事件中提取点击位置（屏幕坐标 + 元素内相对坐标） */
+function getPosition(nativeEvent) {
+  if (!nativeEvent) return undefined;
+  const {
+    pageX,
+    pageY,
+    locationX,
+    locationY
+  } = nativeEvent;
+  if (pageX == null && pageY == null && locationX == null && locationY == null) {
+    return undefined;
+  }
+  return {
+    x: round(pageX),
+    y: round(pageY),
+    ex: round(locationX),
+    ey: round(locationY)
+  };
+}
+function round(n) {
+  return typeof n === 'number' ? Math.round(n) : undefined;
+}
+
+/**
+ * 标记位：用于在已包装的 onPress 函数上做去重判断，避免重复包装
+ */
+const RUM_WRAPPED = '__rumWrapped';
+
+/**
+ * 生成一个「元素创建函数」的包装器。
+ *
+ * createElement / jsx / jsxs / jsxDEV 的前两个参数都是 (type, props)，
+ * 其余参数（children / key / source 等）原样透传即可，因此可用统一逻辑处理。
+ *
+ * 除包装 onPress 采集点击外，还会顺带包装 onPressIn（记录按下时间以计算
+ * duration）与 onLayout（记录元素尺寸 width/height），以补全行为数据。
+ *
+ * childrenInRest：经典 createElement 的 children 以可变参数传入（在 rest 中），
+ * 而 automatic 运行时 jsx/jsxs/jsxDEV 的 children 在 props.children 中。
+ */
+function makeWrapper(original, touchableTypes, childrenInRest) {
+  return function patchedElementFactory(type, props, ...rest) {
+    if (props && touchableTypes.has(type) && isFunction(props.onPress)) {
+      const id = props.id || props.testID || props.accessibilityLabel;
+      if (id && !props.onPress[RUM_WRAPPED]) {
+        const componentName = getComponentName(type);
+        const children = childrenInRest ? rest.length <= 1 ? rest[0] : rest : props.children;
+        const originalOnPress = props.onPress;
+        const originalOnPressIn = props.onPressIn;
+        const originalOnLayout = props.onLayout;
+
+        // 闭包内保存按下时间与布局尺寸，供 onPress 采集时读取
+        let pressInTs = 0;
+        let layout;
+        const wrappedOnPressIn = (...args) => {
+          const ne = args[0] && args[0].nativeEvent;
+          pressInTs = ne && typeof ne.timestamp === 'number' ? ne.timestamp : 0;
+          if (isFunction(originalOnPressIn)) return originalOnPressIn(...args);
+        };
+        const wrappedOnLayout = (...args) => {
+          const ne = args[0] && args[0].nativeEvent;
+          const l = ne && ne.layout;
+          if (l) {
+            layout = {
+              width: round(l.width),
+              height: round(l.height)
+            };
+          }
+          if (isFunction(originalOnLayout)) return originalOnLayout(...args);
+        };
+        const wrappedOnPress = (...args) => {
+          emitAction({
+            id,
+            componentName,
+            props,
+            children,
+            nativeEvent: args[0] && args[0].nativeEvent,
+            pressInTs,
+            layout
+          });
+          return originalOnPress(...args);
+        };
+        wrappedOnPress[RUM_WRAPPED] = true;
+        return original(type, {
+          ...props,
+          onPress: wrappedOnPress,
+          onPressIn: wrappedOnPressIn,
+          onLayout: wrappedOnLayout
+        }, ...rest);
+      }
+    }
+    return original(type, props, ...rest);
+  };
+}
+
+/**
+ * 安全地按字面量 require 一个模块，失败返回 undefined。
+ *
+ * 注意：Metro 的 babel 插件禁止动态 `require(变量)`，因此这里必须用
+ * 字面量字符串分别 require，不能抽成 `safeRequire(name)` 之类的通用函数。
+ */
+function safeRequireJsxRuntime() {
+  try {
+    return require('react/jsx-runtime');
+  } catch {
+    return undefined;
+  }
+}
+function safeRequireJsxDevRuntime() {
+  try {
+    return require('react/jsx-dev-runtime');
+  } catch {
+    return undefined;
+  }
+}
+function patchModuleFn(mod, key, touchableTypes) {
+  if (!mod || !isFunction(mod[key])) return;
+  const original = mod[key];
+  // 经典 createElement 的 children 以可变参数传入；jsx 运行时则在 props.children
+  const childrenInRest = key === 'createElement';
+  try {
+    mod[key] = makeWrapper(original, touchableTypes, childrenInRest);
+    patchTargets.push({
+      mod,
+      key,
+      original
+    });
+  } catch {
+    // 某些环境下属性只读，忽略
+  }
+}
+
+/**
+ * 开始自动采集用户点击行为
+ *
+ * 原理：patch React.createElement 以及 automatic JSX 运行时的 jsx/jsxs/jsxDEV，
+ * 当组件为可触摸类型且含 onPress + id/testID/accessibilityLabel 时，
+ * 包装 onPress 使其在调用时自动 emit action 事件。
+ */
+export function startTrackingActions() {
+  if (patched) return;
+  const React = require('react');
+  const RN = require('react-native');
+  const touchableTypes = new Set([RN.Pressable, RN.TouchableOpacity, RN.TouchableHighlight, RN.TouchableWithoutFeedback, RN.TouchableNativeFeedback, RN.Button].filter(Boolean));
+
+  // 经典运行时
+  patchModuleFn(React, 'createElement', touchableTypes);
+  // automatic 运行时（生产）
+  const jsxRuntime = safeRequireJsxRuntime();
+  patchModuleFn(jsxRuntime, 'jsx', touchableTypes);
+  patchModuleFn(jsxRuntime, 'jsxs', touchableTypes);
+  // automatic 运行时（开发）
+  const jsxDevRuntime = safeRequireJsxDevRuntime();
+  patchModuleFn(jsxDevRuntime, 'jsxDEV', touchableTypes);
+  patched = patchTargets.length > 0;
+}
+
+/**
+ * 停止自动采集
+ */
+export function stopTrackingActions() {
+  if (!patched) return;
+  patchTargets.forEach(({
+    mod,
+    key,
+    original
+  }) => {
+    try {
+      mod[key] = original;
+    } catch {
+      // 忽略还原失败
+    }
+  });
+  patchTargets = [];
+  patched = false;
+}
+//# sourceMappingURL=action.js.map

package/lib/module/utils/api.js

@@ -1,6 +1,6 @@
 "use strict";
 
-import { isFunction, isNumber, isObject, isString, ResourceStatus } from "@arms/rum-core";
+import { isFunction, isNumber, isObject, isString, ResourceStatus } from '@arms/rum-core';
 export const ApiType = {
   FETCH: 'fetch',
   XHR: 'xmlhttprequest'
@@ -10,25 +10,25 @@ export function reviseApiAttr(attrs) {
   if (!attrs || !isObject(attrs)) return;
   const obj = {};
   if (isString(attrs.name)) {
-    obj['name'] = attrs.name.substring(0, 1e3);
+    obj.name = attrs.name.substring(0, 1e3);
   }
   if (isString(attrs.message)) {
-    obj['message'] = attrs.message.substring(0, 1e3);
+    obj.message = attrs.message.substring(0, 1e3);
   }
   if ('success' in attrs) {
-    obj['success'] = !!attrs.success ? 1 : 0;
+    obj.success = attrs.success ? 1 : 0;
   }
   if (isNumber(attrs.duration) && attrs.duration >= 0) {
-    obj['duration'] = attrs.duration;
+    obj.duration = attrs.duration;
   }
   if (isString(attrs.status_code)) {
-    obj['status_code'] = attrs.status_code.substring(0, 100);
+    obj.status_code = attrs.status_code.substring(0, 100);
   }
   if (isNumber(attrs.status_code)) {
-    obj['status_code'] = attrs.status_code;
+    obj.status_code = attrs.status_code;
   }
   if (isString(attrs.snapshots)) {
-    obj['snapshots'] = attrs.snapshots.substring(0, 5e3);
+    obj.snapshots = attrs.snapshots.substring(0, 5e3);
   }
   return obj;
 }
@@ -65,8 +65,8 @@ export function getResourceSuccessByCode(status_code) {
   let status;
   const THRESHOLD = [200, 300];
   if (status_code) {
-    // @ts-ignore
-    status = status_code >= THRESHOLD[0] && status_code < THRESHOLD[1] ? ResourceStatus.Success : ResourceStatus.Failed;
+    const code = Number(status_code);
+    status = code >= THRESHOLD[0] && code < THRESHOLD[1] ? ResourceStatus.Success : ResourceStatus.Failed;
   } else {
     status = ResourceStatus.Unknown;
   }

package/lib/module/utils/base.js

@@ -39,10 +39,10 @@ export function getStringSize(str, encode = 'utf8') {
       const code = str.charCodeAt(i);
 
       // 检查代理对（有效的高位代理后跟低位代理）
-      if (code >= 0xD800 && code <= 0xDBFF) {
+      if (code >= 0xd800 && code <= 0xdbff) {
         if (i + 1 < str.length) {
           const nextCode = str.charCodeAt(i + 1);
-          if (nextCode >= 0xDC00 && nextCode <= 0xDFFF) {
+          if (nextCode >= 0xdc00 && nextCode <= 0xdfff) {
             bytes += 4; // 有效的代理对（4字节）
             i++; // 跳过低位代理
             continue;
@@ -59,25 +59,25 @@ export function getStringSize(str, encode = 'utf8') {
       let code = str.charCodeAt(i);
 
       // 处理代理对（UTF-16辅助平面）
-      if (code >= 0xD800 && code <= 0xDBFF) {
+      if (code >= 0xd800 && code <= 0xdbff) {
         if (i + 1 < str.length) {
           const nextCode = str.charCodeAt(i + 1);
-          if (nextCode >= 0xDC00 && nextCode <= 0xDFFF) {
+          if (nextCode >= 0xdc00 && nextCode <= 0xdfff) {
             // 计算实际的Unicode码点
-            code = (code - 0xD800) * 0x400 + (nextCode - 0xDC00) + 0x10000;
+            code = (code - 0xd800) * 0x400 + (nextCode - 0xdc00) + 0x10000;
             i++; // 跳过低位代理
           }
         }
       }
 
       // 根据码点值计算UTF-8字节长度
-      if (code <= 0x7F) {
+      if (code <= 0x7f) {
         totalBytes += 1; // ASCII字符（1字节）
-      } else if (code <= 0x7FF) {
+      } else if (code <= 0x7ff) {
         totalBytes += 2; // 拉丁文补充等（2字节）
-      } else if (code <= 0xFFFF) {
+      } else if (code <= 0xffff) {
         totalBytes += 3; // 基本多语言平面（3字节）
-      } else if (code <= 0x10FFFF) {
+      } else if (code <= 0x10ffff) {
         totalBytes += 4; // 辅助平面（4字节）
       } else {
         totalBytes += 3; // 无效码点，使用替换字符长度

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