@arms/rum-core 0.1.2 → 0.1.3

package/es/index.d.ts

@@ -18,4 +18,5 @@ export * from './utils/match';
 export * from './utils/trace';
 export * from './utils/verify';
 export * from './utils/url';
+export * from './utils/events';
 export { Client, Context, Reporter, Shell };

package/es/index.js

@@ -18,4 +18,5 @@ export * from './utils/match';
 export * from './utils/trace';
 export * from './utils/verify';
 export * from './utils/url';
+export * from './utils/events';
 export { Client, Context, Reporter, Shell };

package/es/model/configManager.js

@@ -32,38 +32,38 @@ export var ConfigManager = /*#__PURE__*/function () {
     var _init = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee(config) {
       var _this = this;
       var remoteConfig, cacheConfig, asyncConfigPromise;
-      return _regeneratorRuntime.wrap(function _callee$(_context) {
+      return _regeneratorRuntime.wrap(function (_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
             if (!this.initialized) {
-              _context.next = 2;
+              _context.next = 1;
               break;
             }
             return _context.abrupt("return");
-          case 2:
+          case 1:
             this.currentConfig = _extends({}, config);
             this.initialized = true;
             remoteConfig = parseRemoteConfig(config);
             this.currentConfig.remoteConfig = remoteConfig;
             if (remoteConfig.enable) {
-              _context.next = 8;
+              _context.next = 2;
               break;
             }
             return _context.abrupt("return");
-          case 8:
-            _context.next = 10;
+          case 2:
+            _context.next = 3;
             return this.getCacheConfig();
-          case 10:
+          case 3:
             cacheConfig = _context.sent;
             if (cacheConfig && cacheConfig.content) {
               this.currentConfig = this.mergeRemoteCfg(cacheConfig.content);
             }
             if (!this.isCacheValid(cacheConfig, remoteConfig.cacheTimeout)) {
-              _context.next = 14;
+              _context.next = 4;
               break;
             }
             return _context.abrupt("return");
-          case 14:
+          case 4:
             asyncConfigPromise = this.fetchRemoteCfg(this.currentConfig).then(function (resp) {
               if (!resp) return;
               var asyncRemoteConfig = _this.parseConfig(resp);
@@ -74,12 +74,12 @@ export var ConfigManager = /*#__PURE__*/function () {
               });
             });
             if (!(remoteConfig.mode === 'remote-first')) {
-              _context.next = 18;
+              _context.next = 5;
               break;
             }
-            _context.next = 18;
+            _context.next = 5;
             return asyncConfigPromise;
-          case 18:
+          case 5:
           case "end":
             return _context.stop();
         }
@@ -110,17 +110,17 @@ export var ConfigManager = /*#__PURE__*/function () {
   /*#__PURE__*/
   function () {
     var _setConfig = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee2(config) {
-      return _regeneratorRuntime.wrap(function _callee2$(_context2) {
+      return _regeneratorRuntime.wrap(function (_context2) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             if (this.currentConfig) {
-              _context2.next = 2;
+              _context2.next = 1;
               break;
             }
             return _context2.abrupt("return");
-          case 2:
+          case 1:
             this.currentConfig = _extends({}, this.currentConfig, config);
-          case 3:
+          case 2:
           case "end":
             return _context2.stop();
         }

package/es/model/context.d.ts

@@ -1,10 +1,12 @@
 import { IConfiguration, IContext, IRumSession } from "../types/client";
 import { RumEvent, IViewData } from "../types/rum-event";
 import { IConfigManager } from "../types/config";
+import { EventEmitter } from "../utils/events";
 declare class Context implements IContext {
     private config;
     private rumEvent;
     private views;
+    emitter: EventEmitter;
     session: IRumSession;
     configManager: IConfigManager;
     constructor(config: IConfiguration, rumSession?: IRumSession, configManager?: IConfigManager);

package/es/model/context.js

@@ -1,8 +1,10 @@
+import { EventEmitter } from "../utils/events";
 var Context = /*#__PURE__*/function () {
   function Context(config, rumSession, configManager) {
     this.config = config;
     this.rumEvent = void 0;
     this.views = [];
+    this.emitter = new EventEmitter();
     this.session = void 0;
     this.configManager = void 0;
     if (rumSession) {

package/es/model/reporter.js

@@ -193,8 +193,8 @@ var Reporter = /*#__PURE__*/function () {
         _reportConfig$maxRetr,
         _reportConfig$retryDe,
         _this2 = this;
-      var reportConfig, maxRetryCount, retryDelay;
-      return _regeneratorRuntime.wrap(function _callee$(_context) {
+      var reportConfig, maxRetryCount, retryDelay, _t;
+      return _regeneratorRuntime.wrap(function (_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
             if (retry === void 0) {
@@ -203,26 +203,26 @@ var Reporter = /*#__PURE__*/function () {
             reportConfig = (_this$ctx$getConfig = this.ctx.getConfig()) === null || _this$ctx$getConfig === void 0 ? void 0 : _this$ctx$getConfig.reportConfig;
             maxRetryCount = (_reportConfig$maxRetr = reportConfig === null || reportConfig === void 0 ? void 0 : reportConfig.maxRetryCount) !== null && _reportConfig$maxRetr !== void 0 ? _reportConfig$maxRetr : 0;
             retryDelay = (_reportConfig$retryDe = reportConfig === null || reportConfig === void 0 ? void 0 : reportConfig.retryDelay) !== null && _reportConfig$retryDe !== void 0 ? _reportConfig$retryDe : 3000;
-            _context.prev = 4;
+            _context.prev = 1;
             bundle._retry = retry;
-            _context.next = 8;
+            _context.next = 2;
             return this.request(this.ctx, bundle);
-          case 8:
-            _context.next = 13;
+          case 2:
+            _context.next = 4;
             break;
-          case 10:
-            _context.prev = 10;
-            _context.t0 = _context["catch"](4);
+          case 3:
+            _context.prev = 3;
+            _t = _context["catch"](1);
             if (retry < maxRetryCount - 1) {
               setTimeout(function () {
                 return _this2.tryRequest(bundle, retry + 1);
               }, retryDelay);
             }
-          case 13:
+          case 4:
           case "end":
             return _context.stop();
         }
-      }, _callee, this, [[4, 10]]);
+      }, _callee, this, [[1, 3]]);
     }));
     function tryRequest(_x, _x2) {
       return _tryRequest.apply(this, arguments);

package/es/types/client.d.ts

@@ -2,8 +2,9 @@ import { ICollector } from './collector';
 import { IProcessor } from './processor';
 import { IReporter } from './reporter';
 import { RumEvent, RumEventBundle, IViewData } from './rum-event';
-import { MatchOption } from "../utils/match";
-import { IConfigManager } from "./config";
+import { MatchOption } from '../utils/match';
+import { IConfigManager } from './config';
+import { EventEmitter } from '../utils/events';
 export declare enum EventType {
     /**
      * 收集数据
@@ -12,6 +13,7 @@ export declare enum EventType {
 }
 export interface IContext {
     session: IRumSession;
+    emitter: EventEmitter;
     /**
      * user config
      */
@@ -90,7 +92,7 @@ export interface IRemoteConfig {
     [key: string]: unknown;
 }
 export interface ICollectorConfig {
-    name: string;
+    name?: string;
     enable?: boolean;
     sampling?: number;
     filters?: MatchOption[];
@@ -218,5 +220,12 @@ export interface IConfiguration {
      * 检测正则匹配内容
      */
     regexp?: string;
+    /**
+     * 检测元素是否包含特定属性或者属性值的元素，支持正则匹配
+     */
+    attributeRules?: Array<{
+        attributeName: string;
+        attributeValue?: Array<string | RegExp> | null;
+    }>;
     [key: string]: unknown;
 }

package/es/types/rum-event.d.ts

@@ -10,9 +10,11 @@ export declare enum RumEventType {
 export interface BaseObject {
     [key: string]: BaseObjectValue;
 }
-export interface IViewData {
+export type loading_type = 'initial_load' | 'route_change';
+export interface IViewData extends BaseObject {
     id: string;
     name: string;
+    loading_type?: loading_type;
 }
 export type BaseObjectPrimitiveValue = string | number | boolean | null | undefined;
 export type BaseObjectValue = BaseObjectPrimitiveValue | BaseObject | BaseObjectPrimitiveValue[] | IViewData;
@@ -26,27 +28,64 @@ export interface RumBaseEvent extends BaseObject {
     snapshots?: string;
     properties?: BaseObject;
 }
+/** 事件类型：页面浏览、性能指标、Web Vitals、自定义指标、会话回放 */
+export type view_type = 'pv' | 'perf' | 'webvitals' | 'custom' | 'replay' | 'view-stats';
 export interface RumViewEvent extends RumBaseEvent {
-    loading_type?: 'initial_load' | 'route_change';
-    type: 'pv' | 'perf' | 'webvitals' | 'custom';
+    /** 页面加载类型：初始加载或路由切换 */
+    loading_type?: loading_type;
+    type: view_type;
+    /** 最大内容绘制时间 (LCP) - 页面加载过程中最大文本块或图像元素的渲染时间 */
     largest_contentful_paint?: number;
+    /** 首次输入延迟 (FID) - 用户首次与页面交互到浏览器响应该交互的时间 */
     first_input_delay?: number;
+    /** 累积布局偏移 (CLS) - 页面可见元素意外移动的累积分数 */
     cumulative_layout_shift?: number;
+    /** 首次输入时间 (FIT) - 用户首次与页面交互的时间戳 */
     first_input_time?: number;
+    /** 页面加载时间 - 从开始加载到页面完全加载的时间 */
     loading_time?: number;
+    /** 首次绘制时间 (FP) - 浏览器首次渲染任何内容的时间 */
     first_paint?: number;
+    /** 首次内容绘制时间 (FCP) - 浏览器首次渲染DOM内容的时间 */
     first_contentful_paint?: number;
+    /** DOM 交互时间 - DOM 构建完成且脚本开始执行的时间 */
     dom_interactive?: number;
+    /** DOM 内容加载完成时间 - DOM 和所有子资源加载完成的时间 */
     dom_content_loaded?: number;
+    /** DOM 完成时间 - 页面及其所有资源加载完成的时间 */
     dom_complete?: number;
+    /** 加载事件时间 - load 事件触发的时间 */
     load_event?: number;
+    /** 自定义性能指标 T1 */
     t1?: number;
+    /** 自定义性能指标 T2 */
     t2?: number;
+    /** 自定义性能指标 T3 */
     t3?: number;
+    /** 来源页面 URL */
     referrer?: string;
+    /** 当前页面 URL */
     url?: string;
+    /** 性能时序数据 (JSON 字符串格式) */
     timing_data?: string;
 }
+export interface RumReplayEvent extends RumBaseEvent {
+    type: 'replay';
+    /** 当前Records记录的结束时间 */
+    records_end?: number;
+    /** 会话回放片段索引 */
+    records_index?: number;
+    /** 当前会话包含的record数量 */
+    records_count?: number;
+    /** 创建record原因 */
+    records_reason?: string;
+    /** 包含的replay数据大小 */
+    records_size?: number;
+    /** 是否包含完整的Snapshot */
+    has_full_snapshot?: number;
+    /** 上报的录屏数据 */
+    records_data?: string;
+}
 /**
  * 枚举值，表示资源是否加载成功
  */
@@ -96,10 +135,43 @@ export interface RumLongTaskEvent extends RumBaseEvent {
     snapshots: string;
 }
 export interface RumActionEvent extends RumBaseEvent {
+    event_type: RumEventType.ACTION;
+    /** 行为类型 */
     type?: string;
+    /** 行为名称 */
     name?: string;
+    /** 目标元素名称XPath */
     target_name?: string;
+    /** 操作持续时间（毫秒） */
     duration?: number;
+    /**
+     * Heatmap Analysis - 热力图分析
+     * 当 trackUserInteractions 开启时才会采集以下数据
+     * */
+    /** 点击位置信息 */
+    position?: {
+        /** 点击 X 坐标（相对于文档） */
+        x?: number;
+        /** 点击 Y 坐标（相对于文档） */
+        y?: number;
+        /** 元素内相对 X 坐标 */
+        ex?: number;
+        /** 元素内相对 Y 坐标 */
+        ey?: number;
+    };
+    /** 目标元素信息 */
+    target?: {
+        /** 元素的 selector：#root > div > button:nth-child(15) */
+        selector?: string;
+        /** 元素的宽度（像素） */
+        width?: number;
+        /** 元素的高度（像素） */
+        height?: number;
+        /** 是否为可交互元素（0=不可交互, 1=可交互），用于无效点击分析 */
+        reaction?: number;
+        /** 是否可信的交互（0=不可信, 1=可信），用于错误点击分析 */
+        trust?: number;
+    };
 }
 export interface RumCustomEvent extends RumBaseEvent {
     type: string;

package/es/types/rum-event.js

@@ -8,6 +8,9 @@ export var RumEventType = /*#__PURE__*/function (RumEventType) {
   RumEventType["APPLICATION"] = "application";
   return RumEventType;
 }({});
+
+/** 事件类型：页面浏览、性能指标、Web Vitals、自定义指标、会话回放 */
+
 /**
  * 枚举值，表示资源是否加载成功
  */

package/es/utils/base.d.ts

@@ -41,17 +41,6 @@ export declare function debounce(func: Function, wait: number): () => void;
  * @param wait 延迟执行毫秒数
  */
 export declare function delay(func: Function, wait: number, ...args: any[]): number;
-/**
- * @desc 需要严格区分object和array
- * @param obj 任意对象
- */
-export declare function getType(obj: any): any;
-/**
- * @desc 将字符串转换成正则表达式
- * @param str 任意字符串
- * 注意，这里只支持 /xxx/ 这种格式，不支持修饰符，例如 /xxx/ig
- */
-export declare function transStrToReg(str: string): string | RegExp;
 /**
  * 解析正则表达式字符串，支持 /pattern/flags 格式
  * @param str 正则表达式字符串，如 "/a/ig" 或 "a"

package/es/utils/base.js

@@ -1,8 +1,5 @@
 import { isFunction } from "./is";
 
-// 类型匹配正则
-var TYPE_REG = /^\[object ([a-z]*)\]$/;
-
 /**
  * 劫持函数或原型
  */
@@ -150,30 +147,32 @@ export function delay(func, wait) {
   return setTimeout.apply(void 0, [func, +wait || 0].concat(args));
 }
 
-/**
- * @desc 需要严格区分object和array
- * @param obj 任意对象
- */
-export function getType(obj) {
-  var type = Object.prototype.toString.call(obj);
-  type = type.toLowerCase() || '';
-  var arr = type.match(TYPE_REG);
-  return arr === null || arr === void 0 ? void 0 : arr[1];
-}
-
-/**
- * @desc 将字符串转换成正则表达式
- * @param str 任意字符串
- * 注意，这里只支持 /xxx/ 这种格式，不支持修饰符，例如 /xxx/ig
- */
-export function transStrToReg(str) {
-  if (getType(str) !== 'string') return str;
-  if (str.length > 2 && str[0] === '/' && str[str.length - 1] === '/') {
-    return new RegExp(str.substr(1, str.length - 2));
-  }
-  return str;
-}
-
+// // 类型匹配正则
+// const TYPE_REG = /^\[object ([a-z]*)\]$/;
+// /**
+//  * @desc 需要严格区分object和array
+//  * @param obj 任意对象
+//  */
+// export function getType(obj: any) {
+//   let type = Object.prototype.toString.call(obj);
+//   type = type.toLowerCase() || '';
+//   const arr = type.match(TYPE_REG);
+//   return arr?.[1];
+// }
+//
+// /**
+//  * @desc 将字符串转换成正则表达式
+//  * @param str 任意字符串
+//  * 注意，这里只支持 /xxx/ 这种格式，不支持修饰符，例如 /xxx/ig
+//  */
+// export function transStrToReg(str: string) {
+//   if (getType(str) !== 'string') return str;
+//   if (str.length > 2 && str[0] === '/' && str[str.length - 1] === '/') {
+//     return new RegExp(str.substr(1, str.length - 2));
+//   }
+//   return str;
+// }
+//
 // /**
 //  *
 //  * @param config 配置

package/es/utils/events.d.ts

@@ -1,4 +1,4 @@
-type EventHandler = (...args: any[]) => void;
+export type EventHandler = (...args: any[]) => void;
 export declare class EventEmitter {
     private events;
     /**
@@ -26,4 +26,3 @@ export declare class EventEmitter {
      */
     once(eventName: string, handler: EventHandler): void;
 }
-export {};

package/lib/index.d.ts

@@ -18,4 +18,5 @@ export * from './utils/match';
 export * from './utils/trace';
 export * from './utils/verify';
 export * from './utils/url';
+export * from './utils/events';
 export { Client, Context, Reporter, Shell };

package/lib/index.js

@@ -127,4 +127,11 @@ Object.keys(_url).forEach(function (key) {
   if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
   if (key in exports && exports[key] === _url[key]) return;
   exports[key] = _url[key];
+});
+var _events = require("./utils/events");
+Object.keys(_events).forEach(function (key) {
+  if (key === "default" || key === "__esModule") return;
+  if (Object.prototype.hasOwnProperty.call(_exportNames, key)) return;
+  if (key in exports && exports[key] === _events[key]) return;
+  exports[key] = _events[key];
 });

package/lib/model/configManager.js

@@ -37,38 +37,38 @@ var ConfigManager = exports.ConfigManager = /*#__PURE__*/function () {
     var _init = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee(config) {
       var _this = this;
       var remoteConfig, cacheConfig, asyncConfigPromise;
-      return _regenerator["default"].wrap(function _callee$(_context) {
+      return _regenerator["default"].wrap(function (_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
             if (!this.initialized) {
-              _context.next = 2;
+              _context.next = 1;
               break;
             }
             return _context.abrupt("return");
-          case 2:
+          case 1:
             this.currentConfig = (0, _extends2["default"])({}, config);
             this.initialized = true;
             remoteConfig = parseRemoteConfig(config);
             this.currentConfig.remoteConfig = remoteConfig;
             if (remoteConfig.enable) {
-              _context.next = 8;
+              _context.next = 2;
               break;
             }
             return _context.abrupt("return");
-          case 8:
-            _context.next = 10;
+          case 2:
+            _context.next = 3;
             return this.getCacheConfig();
-          case 10:
+          case 3:
             cacheConfig = _context.sent;
             if (cacheConfig && cacheConfig.content) {
               this.currentConfig = this.mergeRemoteCfg(cacheConfig.content);
             }
             if (!this.isCacheValid(cacheConfig, remoteConfig.cacheTimeout)) {
-              _context.next = 14;
+              _context.next = 4;
               break;
             }
             return _context.abrupt("return");
-          case 14:
+          case 4:
             asyncConfigPromise = this.fetchRemoteCfg(this.currentConfig).then(function (resp) {
               if (!resp) return;
               var asyncRemoteConfig = _this.parseConfig(resp);
@@ -79,12 +79,12 @@ var ConfigManager = exports.ConfigManager = /*#__PURE__*/function () {
               });
             });
             if (!(remoteConfig.mode === 'remote-first')) {
-              _context.next = 18;
+              _context.next = 5;
               break;
             }
-            _context.next = 18;
+            _context.next = 5;
             return asyncConfigPromise;
-          case 18:
+          case 5:
           case "end":
             return _context.stop();
         }
@@ -115,17 +115,17 @@ var ConfigManager = exports.ConfigManager = /*#__PURE__*/function () {
   /*#__PURE__*/
   function () {
     var _setConfig = (0, _asyncToGenerator2["default"])(/*#__PURE__*/_regenerator["default"].mark(function _callee2(config) {
-      return _regenerator["default"].wrap(function _callee2$(_context2) {
+      return _regenerator["default"].wrap(function (_context2) {
         while (1) switch (_context2.prev = _context2.next) {
           case 0:
             if (this.currentConfig) {
-              _context2.next = 2;
+              _context2.next = 1;
               break;
             }
             return _context2.abrupt("return");
-          case 2:
+          case 1:
             this.currentConfig = (0, _extends2["default"])({}, this.currentConfig, config);
-          case 3:
+          case 2:
           case "end":
             return _context2.stop();
         }

package/lib/model/context.d.ts

@@ -1,10 +1,12 @@
 import { IConfiguration, IContext, IRumSession } from "../types/client";
 import { RumEvent, IViewData } from "../types/rum-event";
 import { IConfigManager } from "../types/config";
+import { EventEmitter } from "../utils/events";
 declare class Context implements IContext {
     private config;
     private rumEvent;
     private views;
+    emitter: EventEmitter;
     session: IRumSession;
     configManager: IConfigManager;
     constructor(config: IConfiguration, rumSession?: IRumSession, configManager?: IConfigManager);

package/lib/model/context.js

@@ -2,11 +2,13 @@
 
 exports.__esModule = true;
 exports["default"] = void 0;
+var _events = require("../utils/events");
 var Context = /*#__PURE__*/function () {
   function Context(config, rumSession, configManager) {
     this.config = config;
     this.rumEvent = void 0;
     this.views = [];
+    this.emitter = new _events.EventEmitter();
     this.session = void 0;
     this.configManager = void 0;
     if (rumSession) {

package/lib/model/reporter.js

@@ -198,8 +198,8 @@ var Reporter = exports["default"] = /*#__PURE__*/function () {
         _reportConfig$maxRetr,
         _reportConfig$retryDe,
         _this2 = this;
-      var reportConfig, maxRetryCount, retryDelay;
-      return _regenerator["default"].wrap(function _callee$(_context) {
+      var reportConfig, maxRetryCount, retryDelay, _t;
+      return _regenerator["default"].wrap(function (_context) {
         while (1) switch (_context.prev = _context.next) {
           case 0:
             if (retry === void 0) {
@@ -208,26 +208,26 @@ var Reporter = exports["default"] = /*#__PURE__*/function () {
             reportConfig = (_this$ctx$getConfig = this.ctx.getConfig()) === null || _this$ctx$getConfig === void 0 ? void 0 : _this$ctx$getConfig.reportConfig;
             maxRetryCount = (_reportConfig$maxRetr = reportConfig === null || reportConfig === void 0 ? void 0 : reportConfig.maxRetryCount) !== null && _reportConfig$maxRetr !== void 0 ? _reportConfig$maxRetr : 0;
             retryDelay = (_reportConfig$retryDe = reportConfig === null || reportConfig === void 0 ? void 0 : reportConfig.retryDelay) !== null && _reportConfig$retryDe !== void 0 ? _reportConfig$retryDe : 3000;
-            _context.prev = 4;
+            _context.prev = 1;
             bundle._retry = retry;
-            _context.next = 8;
+            _context.next = 2;
             return this.request(this.ctx, bundle);
-          case 8:
-            _context.next = 13;
+          case 2:
+            _context.next = 4;
             break;
-          case 10:
-            _context.prev = 10;
-            _context.t0 = _context["catch"](4);
+          case 3:
+            _context.prev = 3;
+            _t = _context["catch"](1);
             if (retry < maxRetryCount - 1) {
               setTimeout(function () {
                 return _this2.tryRequest(bundle, retry + 1);
               }, retryDelay);
             }
-          case 13:
+          case 4:
           case "end":
             return _context.stop();
         }
-      }, _callee, this, [[4, 10]]);
+      }, _callee, this, [[1, 3]]);
     }));
     function tryRequest(_x, _x2) {
       return _tryRequest.apply(this, arguments);

package/lib/types/client.d.ts

@@ -2,8 +2,9 @@ import { ICollector } from './collector';
 import { IProcessor } from './processor';
 import { IReporter } from './reporter';
 import { RumEvent, RumEventBundle, IViewData } from './rum-event';
-import { MatchOption } from "../utils/match";
-import { IConfigManager } from "./config";
+import { MatchOption } from '../utils/match';
+import { IConfigManager } from './config';
+import { EventEmitter } from '../utils/events';
 export declare enum EventType {
     /**
      * 收集数据
@@ -12,6 +13,7 @@ export declare enum EventType {
 }
 export interface IContext {
     session: IRumSession;
+    emitter: EventEmitter;
     /**
      * user config
      */
@@ -90,7 +92,7 @@ export interface IRemoteConfig {
     [key: string]: unknown;
 }
 export interface ICollectorConfig {
-    name: string;
+    name?: string;
     enable?: boolean;
     sampling?: number;
     filters?: MatchOption[];
@@ -218,5 +220,12 @@ export interface IConfiguration {
      * 检测正则匹配内容
      */
     regexp?: string;
+    /**
+     * 检测元素是否包含特定属性或者属性值的元素，支持正则匹配
+     */
+    attributeRules?: Array<{
+        attributeName: string;
+        attributeValue?: Array<string | RegExp> | null;
+    }>;
     [key: string]: unknown;
 }

package/lib/types/rum-event.d.ts

@@ -10,9 +10,11 @@ export declare enum RumEventType {
 export interface BaseObject {
     [key: string]: BaseObjectValue;
 }
-export interface IViewData {
+export type loading_type = 'initial_load' | 'route_change';
+export interface IViewData extends BaseObject {
     id: string;
     name: string;
+    loading_type?: loading_type;
 }
 export type BaseObjectPrimitiveValue = string | number | boolean | null | undefined;
 export type BaseObjectValue = BaseObjectPrimitiveValue | BaseObject | BaseObjectPrimitiveValue[] | IViewData;
@@ -26,27 +28,64 @@ export interface RumBaseEvent extends BaseObject {
     snapshots?: string;
     properties?: BaseObject;
 }
+/** 事件类型：页面浏览、性能指标、Web Vitals、自定义指标、会话回放 */
+export type view_type = 'pv' | 'perf' | 'webvitals' | 'custom' | 'replay' | 'view-stats';
 export interface RumViewEvent extends RumBaseEvent {
-    loading_type?: 'initial_load' | 'route_change';
-    type: 'pv' | 'perf' | 'webvitals' | 'custom';
+    /** 页面加载类型：初始加载或路由切换 */
+    loading_type?: loading_type;
+    type: view_type;
+    /** 最大内容绘制时间 (LCP) - 页面加载过程中最大文本块或图像元素的渲染时间 */
     largest_contentful_paint?: number;
+    /** 首次输入延迟 (FID) - 用户首次与页面交互到浏览器响应该交互的时间 */
     first_input_delay?: number;
+    /** 累积布局偏移 (CLS) - 页面可见元素意外移动的累积分数 */
     cumulative_layout_shift?: number;
+    /** 首次输入时间 (FIT) - 用户首次与页面交互的时间戳 */
     first_input_time?: number;
+    /** 页面加载时间 - 从开始加载到页面完全加载的时间 */
     loading_time?: number;
+    /** 首次绘制时间 (FP) - 浏览器首次渲染任何内容的时间 */
     first_paint?: number;
+    /** 首次内容绘制时间 (FCP) - 浏览器首次渲染DOM内容的时间 */
     first_contentful_paint?: number;
+    /** DOM 交互时间 - DOM 构建完成且脚本开始执行的时间 */
     dom_interactive?: number;
+    /** DOM 内容加载完成时间 - DOM 和所有子资源加载完成的时间 */
     dom_content_loaded?: number;
+    /** DOM 完成时间 - 页面及其所有资源加载完成的时间 */
     dom_complete?: number;
+    /** 加载事件时间 - load 事件触发的时间 */
     load_event?: number;
+    /** 自定义性能指标 T1 */
     t1?: number;
+    /** 自定义性能指标 T2 */
     t2?: number;
+    /** 自定义性能指标 T3 */
     t3?: number;
+    /** 来源页面 URL */
     referrer?: string;
+    /** 当前页面 URL */
     url?: string;
+    /** 性能时序数据 (JSON 字符串格式) */
     timing_data?: string;
 }
+export interface RumReplayEvent extends RumBaseEvent {
+    type: 'replay';
+    /** 当前Records记录的结束时间 */
+    records_end?: number;
+    /** 会话回放片段索引 */
+    records_index?: number;
+    /** 当前会话包含的record数量 */
+    records_count?: number;
+    /** 创建record原因 */
+    records_reason?: string;
+    /** 包含的replay数据大小 */
+    records_size?: number;
+    /** 是否包含完整的Snapshot */
+    has_full_snapshot?: number;
+    /** 上报的录屏数据 */
+    records_data?: string;
+}
 /**
  * 枚举值，表示资源是否加载成功
  */
@@ -96,10 +135,43 @@ export interface RumLongTaskEvent extends RumBaseEvent {
     snapshots: string;
 }
 export interface RumActionEvent extends RumBaseEvent {
+    event_type: RumEventType.ACTION;
+    /** 行为类型 */
     type?: string;
+    /** 行为名称 */
     name?: string;
+    /** 目标元素名称XPath */
     target_name?: string;
+    /** 操作持续时间（毫秒） */
     duration?: number;
+    /**
+     * Heatmap Analysis - 热力图分析
+     * 当 trackUserInteractions 开启时才会采集以下数据
+     * */
+    /** 点击位置信息 */
+    position?: {
+        /** 点击 X 坐标（相对于文档） */
+        x?: number;
+        /** 点击 Y 坐标（相对于文档） */
+        y?: number;
+        /** 元素内相对 X 坐标 */
+        ex?: number;
+        /** 元素内相对 Y 坐标 */
+        ey?: number;
+    };
+    /** 目标元素信息 */
+    target?: {
+        /** 元素的 selector：#root > div > button:nth-child(15) */
+        selector?: string;
+        /** 元素的宽度（像素） */
+        width?: number;
+        /** 元素的高度（像素） */
+        height?: number;
+        /** 是否为可交互元素（0=不可交互, 1=可交互），用于无效点击分析 */
+        reaction?: number;
+        /** 是否可信的交互（0=不可信, 1=可信），用于错误点击分析 */
+        trust?: number;
+    };
 }
 export interface RumCustomEvent extends RumBaseEvent {
     type: string;

package/lib/types/rum-event.js

@@ -12,6 +12,7 @@ var RumEventType = exports.RumEventType = /*#__PURE__*/function (RumEventType) {
   RumEventType["APPLICATION"] = "application";
   return RumEventType;
 }({});
+/** 事件类型：页面浏览、性能指标、Web Vitals、自定义指标、会话回放 */
 /**
  * 枚举值，表示资源是否加载成功
  */

package/lib/utils/base.d.ts

@@ -41,17 +41,6 @@ export declare function debounce(func: Function, wait: number): () => void;
  * @param wait 延迟执行毫秒数
  */
 export declare function delay(func: Function, wait: number, ...args: any[]): number;
-/**
- * @desc 需要严格区分object和array
- * @param obj 任意对象
- */
-export declare function getType(obj: any): any;
-/**
- * @desc 将字符串转换成正则表达式
- * @param str 任意字符串
- * 注意，这里只支持 /xxx/ 这种格式，不支持修饰符，例如 /xxx/ig
- */
-export declare function transStrToReg(str: string): string | RegExp;
 /**
  * 解析正则表达式字符串，支持 /pattern/flags 格式
  * @param str 正则表达式字符串，如 "/a/ig" 或 "a"

package/lib/utils/base.js

@@ -7,15 +7,10 @@ exports.generateEventId = generateEventId;
 exports.generateGUID = generateGUID;
 exports.generateSpanId = generateSpanId;
 exports.generateTraceId = generateTraceId;
-exports.getType = getType;
 exports.interceptFunction = interceptFunction;
 exports.parseRegExpString = parseRegExpString;
 exports.restoreFunction = restoreFunction;
-exports.transStrToReg = transStrToReg;
 var _is = require("./is");
-// 类型匹配正则
-var TYPE_REG = /^\[object ([a-z]*)\]$/;
-
 /**
  * 劫持函数或原型
  */
@@ -163,30 +158,32 @@ function delay(func, wait) {
   return setTimeout.apply(void 0, [func, +wait || 0].concat(args));
 }
 
-/**
- * @desc 需要严格区分object和array
- * @param obj 任意对象
- */
-function getType(obj) {
-  var type = Object.prototype.toString.call(obj);
-  type = type.toLowerCase() || '';
-  var arr = type.match(TYPE_REG);
-  return arr === null || arr === void 0 ? void 0 : arr[1];
-}
-
-/**
- * @desc 将字符串转换成正则表达式
- * @param str 任意字符串
- * 注意，这里只支持 /xxx/ 这种格式，不支持修饰符，例如 /xxx/ig
- */
-function transStrToReg(str) {
-  if (getType(str) !== 'string') return str;
-  if (str.length > 2 && str[0] === '/' && str[str.length - 1] === '/') {
-    return new RegExp(str.substr(1, str.length - 2));
-  }
-  return str;
-}
-
+// // 类型匹配正则
+// const TYPE_REG = /^\[object ([a-z]*)\]$/;
+// /**
+//  * @desc 需要严格区分object和array
+//  * @param obj 任意对象
+//  */
+// export function getType(obj: any) {
+//   let type = Object.prototype.toString.call(obj);
+//   type = type.toLowerCase() || '';
+//   const arr = type.match(TYPE_REG);
+//   return arr?.[1];
+// }
+//
+// /**
+//  * @desc 将字符串转换成正则表达式
+//  * @param str 任意字符串
+//  * 注意，这里只支持 /xxx/ 这种格式，不支持修饰符，例如 /xxx/ig
+//  */
+// export function transStrToReg(str: string) {
+//   if (getType(str) !== 'string') return str;
+//   if (str.length > 2 && str[0] === '/' && str[str.length - 1] === '/') {
+//     return new RegExp(str.substr(1, str.length - 2));
+//   }
+//   return str;
+// }
+//
 // /**
 //  *
 //  * @param config 配置

package/lib/utils/events.d.ts

@@ -1,4 +1,4 @@
-type EventHandler = (...args: any[]) => void;
+export type EventHandler = (...args: any[]) => void;
 export declare class EventEmitter {
     private events;
     /**
@@ -26,4 +26,3 @@ export declare class EventEmitter {
      */
     once(eventName: string, handler: EventHandler): void;
 }
-export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@arms/rum-core",
-  "version": "0.1.2",
+  "version": "0.1.3",
   "description": "arms rum javascript sdk core",
   "author": "guangli.fj <guangli.fj@alibaba-inc.com>",
   "license": "ISC",