@arms/rum-core 0.0.39 → 0.1.1

package/lib/model/shell.js

@@ -7,9 +7,7 @@ var _extends2 = _interopRequireDefault(require("@babel/runtime/helpers/extends")
 var _rumEvent = require("../types/rum-event");
 var _client = _interopRequireDefault(require("../model/client"));
 var _is = require("../utils/is");
-var _combineConfig = _interopRequireWildcard(require("../utils/combineConfig"));
-function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function _getRequireWildcardCache(e) { return e ? t : r; })(e); }
-function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { "default": e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n["default"] = e, t && t.set(e, n), n; }
+// import combineConfig, { isRemoteConfigEnable, getRemoteConfigUrl } from "../utils/combineConfig";
 var Shell = exports["default"] = /*#__PURE__*/function () {
   function Shell(config) {
     this.client = void 0;
@@ -17,60 +15,55 @@ var Shell = exports["default"] = /*#__PURE__*/function () {
     if (config && this.init) {
       this.init(config);
     }
-    // if (config && this.init) {
-    //   this.init(this.getCombinedConfig(config));
-
-    //   // 拉取远程配置进行更新
-    //   this.updateFromRemoteConfig(config);
-    // }
   }
-  var _proto = Shell.prototype;
-  _proto.getCombinedConfig = function getCombinedConfig(config) {
-    var combinedConf;
-    if ((0, _combineConfig.isRemoteConfigEnable)(config) && (0, _is.isFunction)(this.getLocalConfig)) {
-      var localConfig = this.getLocalConfig(0, config.pid);
-      combinedConf = (0, _combineConfig["default"])(config, localConfig);
-    }
-    return combinedConf || config;
-  };
-  _proto.updateFromRemoteConfig = function updateFromRemoteConfig(config, reSetup) {
-    if (reSetup === void 0) {
-      reSetup = true;
-    }
-    // 请求动态配置
-    if (config.pid && (0, _combineConfig.isRemoteConfigEnable)(config) && (0, _is.isFunction)(this.getRemoteConfig)) {
-      var that = this;
-      var proms = this.getRemoteConfig((0, _combineConfig.getRemoteConfigUrl)(config), config);
-      proms === null || proms === void 0 ? void 0 : proms.then(function (remoteConfig) {
-        if (!remoteConfig || remoteConfig.errorStatus !== undefined) return;
-        var combinedConf = (0, _combineConfig["default"])(config, remoteConfig);
-
-        // 无有效的新配置，无需更新
-        if (!combinedConf) return;
 
-        // 存储到本地
-        if ((0, _is.isFunction)(that.storeRemoteConfig)) {
-          that.storeRemoteConfig(remoteConfig, config.pid);
-        }
-        if (reSetup === false || config.remoteConfig.reSetup === false) return;
-        var context = that.client.getContext();
-        // 更新配置
-        context.setConfig(combinedConf);
-        // 逐个更新collector
-        var collectors = that.client.getCollectors();
-        collectors.forEach(function (collector) {
-          if ((0, _is.isFunction)(collector.destroy)) {
-            collector.destroy();
-            collector.setup(context, that.client.sendEvent);
-          }
-        });
-      });
-    }
-  }
+  // getCombinedConfig(config?: IConfiguration) {
+  //   let combinedConf;
+  //   if(isRemoteConfigEnable(config) && isFunction(this.getLocalConfig)) {
+  //     const localConfig = this.getLocalConfig(0, config.pid);
+  //     combinedConf = combineConfig(config, localConfig);
+  //   }
+  //   return combinedConf || config;
+  // }
+  //
+  // updateFromRemoteConfig(config: any, reSetup: boolean = true) {
+  //   // 请求动态配置
+  //   if( config.pid && isRemoteConfigEnable(config) && isFunction(this.getRemoteConfig) ){
+  //     const that = this;
+  //     const proms = this.getRemoteConfig(getRemoteConfigUrl(config), config);
+  //     proms?.then(remoteConfig => {
+  //       if(!remoteConfig || remoteConfig.errorStatus !== undefined) return;
+  //       const combinedConf = combineConfig(config, remoteConfig);
+  //
+  //       // 无有效的新配置，无需更新
+  //       if(!combinedConf) return;
+  //
+  //       // 存储到本地
+  //       if(isFunction(that.storeRemoteConfig)) {
+  //         that.storeRemoteConfig(remoteConfig, config.pid);
+  //       }
+  //
+  //       if(reSetup === false || config.remoteConfig.reSetup === false) return;
+  //
+  //       const context = that.client.getContext();
+  //       // 更新配置
+  //       context.setConfig(combinedConf);
+  //       // 逐个更新collector
+  //       const collectors = that.client.getCollectors();
+  //       collectors.forEach(collector => {
+  //         if(isFunction(collector.destroy)) {
+  //           collector.destroy();
+  //           collector.setup(context, that.client.sendEvent);
+  //         }
+  //       });
+  //     });
+  //   }
+  // }
 
   /**
    * 初始化
-   */;
+   */
+  var _proto = Shell.prototype;
   _proto.sendEvent = function sendEvent(payload) {
     if (this.client) {
       this.client.sendEvent(payload);
@@ -86,8 +79,23 @@ var Shell = exports["default"] = /*#__PURE__*/function () {
     }
   }
 
+  // /**
+  //  * 获取远程配置
+  //  */
+  // abstract getRemoteConfig(url: string, config: any): object;
+  //
+  // /**
+  //  * 存储远程配置到本地
+  //  */
+  // abstract storeRemoteConfig(config: any, pid: string): boolean;
+  //
+  // /**
+  //  * 提取本地存储的配置
+  //  */
+  // abstract getLocalConfig(duration: number, pid: string): any;
+
   /**
-   * 获取远程配置
+   * set config
    */;
   /**
    * 自定义事件上报

package/lib/types/client.d.ts

@@ -3,6 +3,7 @@ import { IProcessor } from './processor';
 import { IReporter } from './reporter';
 import { RumEvent, RumEventBundle, IViewData } from './rum-event';
 import { MatchOption } from "../utils/match";
+import { IConfigManager } from "./config";
 export declare enum EventType {
     /**
      * 收集数据
@@ -35,6 +36,12 @@ export interface SessionConfig {
     overtime?: number;
     storage?: string;
 }
+export interface IReportConfig {
+    flushTime?: number;
+    maxEventCount?: number;
+    maxRetryCount?: number;
+    retryDelay?: number;
+}
 export interface IRumSession {
     init(ctx: IContext): void;
     sessionConfig: SessionConfig;
@@ -46,11 +53,54 @@ export interface IRumSession {
     getUserId: () => string;
     getBaseEvent: () => any;
 }
+/**
+ * 远端监控配置接口
+ * @remarks 用于控制RUM数据采集的远程配置策略
+ */
+export interface IRemoteConfig {
+    /**
+     * 是否启用远端配置 (default: false)
+     * @example true - 开启云端配置动态管控
+     */
+    enable?: boolean;
+    /**
+     * 配置服务器URL (required when enable=true)
+     * @format URL
+     */
+    url?: string;
+    /**
+     * 配置获取策略模式 (default: 'launch-first')
+     * @enum
+     *   - 'launch-first': 启动优先模式，先使用本地配置快速启动，异步获取最新配置
+     *   - 'remote-first': 云端优先模式，阻塞等待云端配置，超时后降级到本地
+     */
+    mode?: 'launch-first' | 'remote-first';
+    /**
+     * 配置缓存有效期（单位：毫秒，默认：3600000/1小时）
+     * @remarks 控制本地配置缓存刷新频率，超时后重新请求云端配置
+     * @example 1800000 - 30分钟更新一次配置
+     */
+    cacheTimeout?: number;
+    /**
+     * 配置远程配置拉取Region，兼容 0.0.x 版本远端配置
+     * @remarks 拉取远端配置地域
+     * @example cn-hangzhou 国内主要地区
+     */
+    region?: string;
+    [key: string]: unknown;
+}
+export interface ICollectorConfig {
+    name: string;
+    enable?: boolean;
+    sampling?: number;
+    filters?: MatchOption[];
+    [key: string]: unknown;
+}
 export interface IClient {
     /**
      * 初始化
      */
-    init: (configuration: IConfiguration, rumSession?: IRumSession) => void;
+    init: (configuration: IConfiguration, rumSession?: IRumSession, configManager?: IConfigManager) => void;
     /**
      * 业务自定义上传数据
      */
@@ -81,10 +131,15 @@ export interface IClient {
     useReporter(reporter: IReporter): void;
 }
 export interface IConfiguration {
+    /**
+     * 是否开启SDK
+     */
+    enable?: boolean;
     /**
      * 项目 id
+     * v0.0.40开始，不强依赖该参数，通过Endpoint获取 service_id 确定应用
      */
-    pid: string;
+    pid?: string;
     /**
      * 应用环境
      */
@@ -125,15 +180,12 @@ export interface IConfiguration {
     /**
      * reporter 发送节奏配置
      */
-    reportConfig?: {
-        flushTime?: number;
-        maxEventCount?: number;
-    };
+    reportConfig?: IReportConfig;
     /**
      *  配置下发
      *  - 运行时动态配置更新，根据端侧特点来做定制化配置
      */
-    remoteConfig?: Boolean;
+    remoteConfig?: IRemoteConfig | Boolean;
     /**
      * session config
      */
@@ -142,7 +194,7 @@ export interface IConfiguration {
      * 各个 collector config
      */
     collectors?: {
-        [key: string]: boolean;
+        [key: string]: boolean | ICollectorConfig;
     };
     /**
      * 事件过滤器配置

package/lib/types/client.js

@@ -8,4 +8,8 @@ var EventType = exports.EventType = /*#__PURE__*/function (EventType) {
    */
   EventType["collect"] = "collect";
   return EventType;
-}({});
+}({});
+/**
+ * 远端监控配置接口
+ * @remarks 用于控制RUM数据采集的远程配置策略
+ */

package/lib/types/config.d.ts

@@ -0,0 +1,49 @@
+import { IConfiguration } from './client';
+export interface ICacheConfiguration {
+    /**
+     * 时间戳
+     */
+    timestamp: number;
+    /**
+     * 内容
+     */
+    content: any;
+}
+/**
+ * 配置管理器接口
+ * 统一管理配置的获取、存储、合并等操作
+ */
+export interface IConfigManager {
+    /**
+     * 初始化配置管理器
+     * @param config 初始配置
+     */
+    init(config: IConfiguration): Promise<void> | void;
+    /**
+     * 获取配置
+     * @returns 配置数据
+     */
+    getConfig(): Promise<IConfiguration> | any;
+    /**
+     * 更新配置
+     * @param config 新配置
+     */
+    setConfig(config: Partial<IConfiguration>): Promise<void> | void;
+    /**
+     * 抽象方法：获取远程配置
+     * 各平台需要实现此方法来适配不同的网络请求方式
+     * @param config 当前配置
+     */
+    fetchRemoteCfg(config: IConfiguration): Promise<any>;
+    /**
+     * 合并配置
+     * @param baseConfig 基础配置
+     * @param remoteConfig 远程配置
+     * @returns 合并后的配置
+     */
+    mergeRemoteCfg(baseConfig: IConfiguration, remoteConfig: any): IConfiguration | null;
+    /**
+     * 销毁配置管理器
+     */
+    destroy(): void;
+}

package/lib/types/config.js

@@ -0,0 +1,3 @@
+"use strict";
+
+exports.__esModule = true;

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

@@ -176,4 +176,6 @@ export interface RumEventBundle {
     events: Array<RumEvent>;
     properties?: BaseObject;
     _v?: string;
+    _retry?: number;
+    [key: string]: unknown;
 }

package/lib/utils/base.d.ts

@@ -53,8 +53,8 @@ export declare function getType(obj: any): any;
  */
 export declare function transStrToReg(str: string): string | RegExp;
 /**
- *
- * @param config 配置
- * @param keys 需要转换的字段
+ * 解析正则表达式字符串，支持 /pattern/flags 格式
+ * @param str 正则表达式字符串，如 "/a/ig" 或 "a"
+ * @returns RegExp 对象
  */
-export declare function toRegFormat(config: any, keys: any[]): void;
+export declare function parseRegExpString(str: string): RegExp;

package/lib/utils/base.js

@@ -9,12 +9,10 @@ exports.generateSpanId = generateSpanId;
 exports.generateTraceId = generateTraceId;
 exports.getType = getType;
 exports.interceptFunction = interceptFunction;
+exports.parseRegExpString = parseRegExpString;
 exports.restoreFunction = restoreFunction;
-exports.toRegFormat = toRegFormat;
 exports.transStrToReg = transStrToReg;
 var _is = require("./is");
-// 插值前缀
-var PRE_SUF_FIX = '__';
 // 类型匹配正则
 var TYPE_REG = /^\[object ([a-z]*)\]$/;
 
@@ -26,8 +24,7 @@ function interceptFunction(target, name, callback, isPrototype) {
     isPrototype = false;
   }
   var registeredMethod = target[name];
-  target["" + PRE_SUF_FIX + name + PRE_SUF_FIX] = registeredMethod;
-  target[name] = function () {
+  var proxyMethod = function proxyMethod() {
     var ctx = isPrototype ? this : target;
     for (var _len = arguments.length, args = new Array(_len), _key = 0; _key < _len; _key++) {
       args[_key] = arguments[_key];
@@ -37,17 +34,19 @@ function interceptFunction(target, name, callback, isPrototype) {
       return registeredMethod.apply(ctx, args);
     }
   };
+  proxyMethod._rum_intercepted = registeredMethod;
+  target[name] = proxyMethod;
 }
 
 /**
  * 还原函数
  */
 function restoreFunction(target, name) {
-  var key = "" + PRE_SUF_FIX + name + PRE_SUF_FIX;
-  if (typeof target[key] == 'function') {
-    target[name] = target[key];
-    delete target[key];
-  }
+  var proxyMethod = target[name];
+  if ((0, _is.isFunction)(proxyMethod)) return;
+  var originalMethod = proxyMethod._rum_intercepted;
+  if ((0, _is.isFunction)(originalMethod)) return;
+  target[name] = originalMethod;
 }
 
 /**
@@ -188,42 +187,71 @@ function transStrToReg(str) {
   return str;
 }
 
+// /**
+//  *
+//  * @param config 配置
+//  * @param keys 需要转换的字段
+//  */
+// export function toRegFormat(config: any, keys: any[]) {
+//   if (getType(keys) === 'string') {
+//     keys = [keys];
+//   }
+//   for (let i = 0, len = keys.length; i < len; i++) {
+//     const paths = keys[i].split('.');
+//     const lastIndex = paths.length - 1;
+//     if (!config) break;
+//     let tmp = config;
+//     for (let j = 0, jlen = paths.length; j < jlen; j++) {
+//       if (paths[j] === '[]') {
+//         if (getType(tmp) === 'array') {
+//           let lastPath = paths.splice(j + 1);
+//           lastPath = lastPath.join('.');
+//           for (let x = 0, xlen = tmp.length; x < xlen; x++) {
+//             toRegFormat(tmp[x], lastPath);
+//           }
+//         }
+//         break;
+//       }
+//       // 最后一层了，需要往前一层才能修改对象
+//       if (lastIndex === j && getType(tmp[paths[j]]) === 'string') {
+//         tmp[paths[j]] = transStrToReg(tmp[paths[j]]);
+//         break;
+//       }
+//       tmp = tmp[paths[j]];
+//       if (!tmp) break;
+//     }
+//     if (!tmp || getType(tmp) !== 'array') continue;
+//     for (let j = 0, jlen = tmp.length; j < jlen; j++) {
+//       tmp[j] = transStrToReg(tmp[j]);
+//     }
+//   }
+// }
+
 /**
- *
- * @param config 配置
- * @param keys 需要转换的字段
+ * 解析正则表达式字符串，支持 /pattern/flags 格式
+ * @param str 正则表达式字符串，如 "/a/ig" 或 "a"
+ * @returns RegExp 对象
  */
-function toRegFormat(config, keys) {
-  if (getType(keys) === 'string') {
-    keys = [keys];
+function parseRegExpString(str) {
+  if (typeof str !== 'string') {
+    throw new TypeError('input must be a string');
   }
-  for (var i = 0, len = keys.length; i < len; i++) {
-    var paths = keys[i].split('.');
-    var lastIndex = paths.length - 1;
-    if (!config) break;
-    var tmp = config;
-    for (var j = 0, jlen = paths.length; j < jlen; j++) {
-      if (paths[j] === '[]') {
-        if (getType(tmp) === 'array') {
-          var lastPath = paths.splice(j + 1);
-          lastPath = lastPath.join('.');
-          for (var x = 0, xlen = tmp.length; x < xlen; x++) {
-            toRegFormat(tmp[x], lastPath);
-          }
-        }
-        break;
-      }
-      // 最后一层了，需要往前一层才能修改对象
-      if (lastIndex === j && getType(tmp[paths[j]]) === 'string') {
-        tmp[paths[j]] = transStrToReg(tmp[paths[j]]);
-        break;
-      }
-      tmp = tmp[paths[j]];
-      if (!tmp) break;
-    }
-    if (!tmp || getType(tmp) !== 'array') continue;
-    for (var _j = 0, _jlen = tmp.length; _j < _jlen; _j++) {
-      tmp[_j] = transStrToReg(tmp[_j]);
+
+  // 检查是否是 /pattern/flags 格式
+  if (str.length > 2 && str[0] === '/') {
+    // 从后往前找最后一个 /，作为分隔符
+    var lastSlashIndex = str.lastIndexOf('/');
+    if (lastSlashIndex > 0) {
+      // 提取 pattern（第一个 / 和最后一个 / 之间的内容）
+      var pattern = str.substring(1, lastSlashIndex);
+      // 提取 flags（最后一个 / 之后的内容）
+      var flags = str.substring(lastSlashIndex + 1);
+      return new RegExp(pattern, flags);
     }
+    // 如果只有一个 /，当作 /pattern/ 格式处理（无 flags）
+    return new RegExp(str.substring(1, str.length - 1));
   }
+
+  // 如果不是 /pattern/flags 格式，直接作为 pattern 使用
+  return new RegExp(str);
 }