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

package/lib/module/collector/view/pv.js

@@ -2,6 +2,7 @@
 
 import { isFunction, RumEventType } from '@arms/rum-core';
 import { addNavigateListener, removeNavigateListener } from "../../utils/view.js";
+import { CRASH_CONTEXT_EVENT } from "../../types/crash.js";
 export default class PvCollector {
   name = 'pv-collector';
   pageMap = {};
@@ -25,7 +26,7 @@ export default class PvCollector {
       id: key,
       params
     };
-    if (name === "__root" || !('path' in page)) return;
+    if (name === '__root') return;
     this.sendPv(page);
   };
   sendPv = page => {
@@ -35,7 +36,7 @@ export default class PvCollector {
       // 路由没有发生变化，不发送
       return;
     }
-    page.name = this.getViewName(page.path, page);
+    page.name = this.getViewName(page.path || page.name || '', page);
     if (prevPage && prevPage.id in this.pageMap) {
       delete this.pageMap[prevPage.id];
       ctx.removeView(prevPage.id);
@@ -54,6 +55,16 @@ export default class PvCollector {
       loading_type: 'initial_load',
       ...page
     });
+
+    // 同步当前 view 上下文到原生侧（崩溃报告关联用）
+    const sessionId = ctx.session?.getSessionId?.() || '';
+    const userId = ctx.session?.getUserId?.() || '';
+    ctx.emitter.emit(CRASH_CONTEXT_EVENT, {
+      session_id: sessionId,
+      user_id: userId,
+      view_id: page.id,
+      view_name: page.name
+    });
   };
   getViewName(url, page) {
     let {

package/lib/module/expoConfigPlugin.js

@@ -0,0 +1,33 @@
+"use strict";
+
+/**
+ * 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 的硬依赖。 */
+
+const withRumSdk = (config, props) => {
+  const extra = {
+    ...(config.extra ?? {})
+  };
+  extra.rumSdk = {
+    endpoint: props?.endpoint,
+    env: props?.env ?? 'prod',
+    version: props?.version
+  };
+  return {
+    ...config,
+    extra
+  };
+};
+export default withRumSdk;
+//# sourceMappingURL=expoConfigPlugin.js.map

package/lib/module/index.js

@@ -1,6 +1,7 @@
 "use strict";
 
 import armsRum, { ArmsRum } from "./shell.js";
+export { logger, callMonitored } from '@arms/rum-core';
 export { ArmsRum };
 export default armsRum;
 //# sourceMappingURL=index.js.map

package/lib/module/plugin.js

@@ -1,7 +1,7 @@
 "use strict";
 
 import { NativeModules, NativeEventEmitter } from 'react-native';
-import { isString } from "@arms/rum-core";
+import { isString } from '@arms/rum-core';
 import { VERSION } from "./utils/platform.js";
 import armsRum from "./shell.js";
 const RumSdkModule = NativeModules.RumSdkModule;
@@ -25,9 +25,12 @@ if (RumSdkModule) {
         return;
       }
     }
+    // pid 为可选配置，未提供时使用默认值（格式：react-native@{VERSION}）
+    // 这确保了即使未在ARMS控制台创建应用，SDK也能正常初始化和上报
     if (!config.pid) {
       config.pid = `react-native@${VERSION}`;
     }
+    // endpoint 为必填配置，未提供时使用本地回环地址作为兜底
     if (!config.endpoint) {
       config.endpoint = `http://127.0.0.1/?version=${VERSION}`;
     }

package/lib/module/processor/session-processor.js

@@ -1,20 +1,42 @@
 "use strict";
 
 import { debounce, ONE_SECOND } from '@arms/rum-core';
+import { CRASH_CONTEXT_EVENT } from "../types/crash.js";
+import { getCurView } from "../utils/view.js";
 export default class SessionProcessor {
   name = 'session-processor';
+  lastSessionId = '';
   setup(ctx) {
     this.ctx = ctx;
     this.update = debounce(this.update, ONE_SECOND);
+    // 延迟到下一个事件循环执行，确保 collectors 已完成 setup 并注册了
+    // CRASH_CONTEXT_EVENT 监听器（rum-core 中 processors.setup() 先于
+    // collectors.setup() 执行）。消除 session 创建后 1 秒内的 context
+    // 同步窗口，同时避免 emit 事件因无监听器而被丢弃
+    setTimeout(() => this.syncCrashContext(), 0);
     // sdk.onTouchStart(this.update)
   }
   update = e => {
     if (e && !e.isTrusted) return;
     this.ctx?.session.updateSession();
+    this.syncCrashContext();
   };
   process(ctx) {
     this.update();
     return ctx.getRumEvent();
   }
+  syncCrashContext() {
+    if (!this.ctx) return;
+    const sessionId = this.ctx.session.getSessionId();
+    if (sessionId === this.lastSessionId) return;
+    this.lastSessionId = sessionId;
+    const view = getCurView(this.ctx);
+    this.ctx.emitter.emit(CRASH_CONTEXT_EVENT, {
+      session_id: sessionId,
+      user_id: this.ctx.session.getUserId(),
+      view_id: view?.id || '',
+      view_name: view?.name || ''
+    });
+  }
 }
 //# sourceMappingURL=session-processor.js.map

package/lib/module/reporter/index.js

@@ -1,10 +1,70 @@
 "use strict";
 
-import { Reporter } from '@arms/rum-core';
+import { Reporter, Telemetry, logger } from '@arms/rum-core';
 import { fixAttrs } from "../utils/platform.js";
+import { CRASH_ID_FIELD, CRASH_REPORT_ACK_EVENT } from "../types/crash.js";
 // @ts-ignore
 import { AppState } from 'react-native';
 
+/**
+ * 从 bundle.events 的 snapshots 中提取携带的 crash_id（瞬态字段）。
+ * crash_id 由 CrashCollector 注入到 snapshots JSON 字符串中，
+ * reporter 提取后用于 ack，并在序列化前从 snapshots 中剥离，不会发送到后端。
+ * 兼容旧版降级路径：crash_id 可能残留在事件根级。
+ */
+function extractCrashIds(bundle) {
+  const ids = [];
+  const events = bundle?.events;
+  if (Array.isArray(events)) {
+    for (const ev of events) {
+      if (!ev) continue;
+      // 优先从 snapshots 提取
+      let cid;
+      try {
+        const snapshotsObj = JSON.parse(ev.snapshots);
+        cid = snapshotsObj?.[CRASH_ID_FIELD];
+      } catch {
+        // snapshots 解析失败
+      }
+      // 兼容旧版降级路径：检查根级
+      if (!cid) {
+        cid = ev[CRASH_ID_FIELD];
+      }
+      if (typeof cid === 'string' && cid) ids.push(cid);
+    }
+  }
+  return ids;
+}
+
+/**
+ * 序列化前剥离事件上的 crash_id 瞬态字段：
+ * - 从 snapshots JSON 字符串中移除；
+ * - 兼容旧版降级路径：从事件根级移除。
+ */
+function stripCrashIds(bundle) {
+  const events = bundle?.events;
+  if (!Array.isArray(events)) return;
+  for (const ev of events) {
+    if (!ev) continue;
+    // 从 snapshots 中移除
+    if (typeof ev.snapshots === 'string') {
+      try {
+        const snapshotsObj = JSON.parse(ev.snapshots);
+        if (snapshotsObj && CRASH_ID_FIELD in snapshotsObj) {
+          delete snapshotsObj[CRASH_ID_FIELD];
+          ev.snapshots = JSON.stringify(snapshotsObj);
+        }
+      } catch {
+        // snapshots 解析失败，跳过
+      }
+    }
+    // 兼容旧版降级路径：从根级移除
+    if (CRASH_ID_FIELD in ev) {
+      delete ev[CRASH_ID_FIELD];
+    }
+  }
+}
+
 /**
  * rn-app reporter
  */
@@ -16,8 +76,7 @@ class RNReporter extends Reporter {
     try {
       this.appStateListener = AppState.addEventListener('change', this.onAppStateChanged);
     } catch (error) {
-      //
-      console.info(error);
+      logger.warn('reporter', 'AppState listener binding failed', error);
     }
   }
   init(ctx) {
@@ -29,26 +88,53 @@ class RNReporter extends Reporter {
       if (typeof this.flushEventQueue === 'function') {
         this.flushEventQueue();
       }
+      // 后台前 flush 自监控数据
+      Telemetry.get()?.flush();
     }
     // else if (nextAppState === 'active') {
     //   console.warn('RUM:应用回到前台');
     // }
   };
-  request(ctx, bundle) {
-    const batchedEvents = fixAttrs(bundle);
-    const config = ctx.getConfig();
-    fetch(config.endpoint, {
-      method: 'POST',
-      headers: {
-        'Content-Type': 'text/plain'
-      },
-      body: JSON.stringify(batchedEvents)
-    }).then(_res => {
-      //
-    }).catch(this.catchHandle);
+  async request(ctx, bundle) {
+    // 先从事件中提取崩溃 crash_id（瞬态字段），用于上报后 ack 删文件
+    const crashIds = extractCrashIds(bundle);
+    try {
+      const batchedEvents = await fixAttrs(bundle);
+      // 序列化前剥离瞬态字段，避免发送到后端
+      stripCrashIds(batchedEvents);
+      const config = ctx.getConfig();
+      fetch(config.endpoint, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'text/plain'
+        },
+        body: JSON.stringify(batchedEvents)
+      }).then(res => {
+        this.ackCrashes(ctx, crashIds, !!(res && res.ok));
+      }).catch(err => {
+        this.catchHandle(err);
+        this.ackCrashes(ctx, crashIds, false);
+      });
+    } catch (err) {
+      this.catchHandle(err);
+      this.ackCrashes(ctx, crashIds, false);
+    }
+  }
+
+  /** 通过共享 emitter 通知崩溃采集器上报结果（成功则删文件，失败保留重试） */
+  ackCrashes(ctx, crashIds, success) {
+    if (!crashIds.length) return;
+    try {
+      ctx.emitter?.emit(CRASH_REPORT_ACK_EVENT, {
+        crashIds,
+        success
+      });
+    } catch (e) {
+      logger.warn('reporter', 'emit crash ack failed', e);
+    }
   }
   catchHandle = err => {
-    console.warn('[rum] sendRequest fail', err);
+    logger.error('reporter', 'sendRequest failed', err);
   };
   destroy() {
     this.appStateListener?.remove();

package/lib/module/reporter/monitor-reporter.js

@@ -0,0 +1,38 @@
+"use strict";
+
+import { convertBundlesToLogGroup } from '@arms/rum-core';
+export class RNMonitorReporter {
+  constructor(endpoint) {
+    this.endpoint = this.buildMonitorEndpoint(endpoint);
+  }
+  send(data) {
+    if (!data || data.length === 0) return;
+    try {
+      // 使用 rum-core 的 Protobuf 编码器将数据编码为 SLS LogGroup 二进制格式
+      const protobufBody = convertBundlesToLogGroup(data);
+      fetch(this.endpoint, {
+        method: 'POST',
+        headers: {
+          'Content-Type': 'application/x-protobuf',
+          'x-log-apiversion': '0.6.0',
+          'x-log-compresstype': '',
+          'x-log-date': new Date().toUTCString()
+        },
+        body: protobufBody
+      }).catch(() => {
+        // 静默处理，避免反馈循环（不调用 logger）
+      });
+    } catch (_) {
+      // 吞掉异常，防止自监控影响宿主应用
+    }
+  }
+  buildMonitorEndpoint(endpoint) {
+    try {
+      const url = new URL(endpoint);
+      return `${url.origin}/rum/monitor`;
+    } catch (_) {
+      return endpoint;
+    }
+  }
+}
+//# sourceMappingURL=monitor-reporter.js.map

package/lib/module/shell.js

@@ -1,15 +1,15 @@
 "use strict";
 
-import { Shell } from '@arms/rum-core';
-import PvCollector from "./collector/view/pv.js";
-import ExceptionCollector from "./collector/exception/index.js";
-import ApiCollector from "./collector/resource/api.js";
+import { isFunction, Shell, callMonitored } from '@arms/rum-core';
+import * as collectors from "./collector/index.js";
 import DefaultProcessor from "./processor/default-processor.js";
 import SessionProcessor from "./processor/session-processor.js";
 import Reporter from "./reporter/index.js";
+import { RNMonitorReporter } from "./reporter/monitor-reporter.js";
 import { VERSION } from "./utils/platform.js";
 import { RumSession } from "./utils/session.js";
 import { startTrackingViews, stopTrackingViews } from "./utils/view.js";
+const builtInCollectors = [...Object.values(collectors).filter(Collector => isFunction(Collector))];
 /**
  * 对外导出 shell 层, 所有 shell 层模型的 API 设计约定：
  * 1. API 命名空间按照 variables / functions / events 来组织
@@ -23,10 +23,12 @@ export class ArmsRum extends Shell {
    * 初始化
    */
   init(config) {
-    this.client.useCollectors([new PvCollector(), new ExceptionCollector(), new ApiCollector()]);
+    this.client.useCollectors(builtInCollectors.map(Collector => callMonitored(() => new Collector(), undefined, [], 'shell', `init ${Collector.name}`)).filter(Boolean));
     this.client.useProcessors([new DefaultProcessor(), new SessionProcessor()]);
     this.client.useReporter(new Reporter());
-    this.client.init(config, new RumSession());
+    // 传入 MonitorReporter 激活自监控
+    const monitorReporter = config.endpoint ? new RNMonitorReporter(config.endpoint) : undefined;
+    this.client.init(config, new RumSession(), undefined, monitorReporter);
     return this;
   }
 
@@ -37,7 +39,6 @@ export class ArmsRum extends Shell {
   setConfig(...params) {
     const ctx = this.client.getContext();
     if (params.length === 2) {
-      const ctx = this.client.getContext();
       const oldConfig = ctx.getConfig();
       ctx.setConfig({
         ...oldConfig,
@@ -47,6 +48,27 @@ export class ArmsRum extends Shell {
       ctx.setConfig(params[0]);
     }
   }
+
+  /**
+   * 开启路由变化监听，自动采集 PV 数据
+   *
+   * 必须在 NavigationContainer 的 `onReady` 回调中调用，以确保
+   * navigationRef 已正确初始化。
+   *
+   * @example
+   * ```tsx
+   * <NavigationContainer
+   *   ref={navigationRef}
+   *   onReady={() => {
+   *     ArmsRum.startTrackingViews(navigationRef);
+   *   }}
+   * >
+   *   ...
+   * </NavigationContainer>
+   * ```
+   *
+   * @param navigationRef - NavigationContainer 的 ref 引用
+   */
   startTrackingViews(navigationRef) {
     if (!navigationRef) return;
     startTrackingViews(navigationRef);
@@ -54,6 +76,9 @@ export class ArmsRum extends Shell {
   stopTrackingViews() {
     stopTrackingViews();
   }
+  getCollector(name) {
+    return this.client.getCollectors().find(collector => collector.name === name);
+  }
 }
 export default new ArmsRum();
 //# sourceMappingURL=shell.js.map

package/lib/module/types/crash.js

@@ -0,0 +1,33 @@
+"use strict";
+
+/**
+ * 崩溃相关类型定义
+ */
+
+/** 崩溃上下文同步事件名 */
+export const CRASH_CONTEXT_EVENT = 'crash_context_change';
+
+/** 崩溃上报确认事件名（reporter -> crash collector，用于 ack 后删除文件） */
+export const CRASH_REPORT_ACK_EVENT = 'crash_report_ack';
+
+/**
+ * 挂在崩溃 RumEvent 上的瞬态字段名，携带 crash_id。
+ * reporter 上报前提取用于 ack、并在序列化前剥离，不会发送到后端。
+ */
+export const CRASH_ID_FIELD = '__rum_crash_id';
+
+/** 崩溃上报确认事件负载 */
+
+/**
+ * 崩溃上下文快照（session / view 变更时同步到原生侧）。
+ */
+
+/**
+ * 原生崩溃栈帧数据结构。
+ */
+
+/**
+ * 原生崩溃数据结构（与原生侧 RumCrashReporter / CrashContextManager 写入的 JSON 对齐）。
+ * 仅声明 JS 层会用到的字段，未列出的字段会通过 snapshots 透传给后端。
+ */
+//# sourceMappingURL=crash.js.map