sobey-monitor-sdk 1.0.7 → 1.0.9

package/README.md

@@ -115,14 +115,29 @@ ReactDOM.render(
 |--------|------|--------|------|
 | `appId` | string | 必填 | 应用唯一标识 |
 | `dsn` | string | 必填 | 数据上报地址 |
-| `debug` | boolean | false | 调试模式 |
+| `enabled` | boolean | true | **全局开关**，设为 false 则完全禁用所有监控上报 |
+| `debug` | boolean | false | 调试模式，开启后会在控制台输出日志 |
 | `sampling.error` | number | 1 | 错误采样率 (0-1) |
 | `sampling.performance` | number | 1 | 性能采样率 (0-1) |
 | `sampling.behavior` | number | 1 | 行为采样率 (0-1) |
-| `behavior.maxBreadcrumbs` | number | 20 | 行为回溯最大记录数 |
-| `behavior.recordRequestBreadcrumb` | 'all' \| 'error' \| 'none' | 'error' | 网络请求记录模式：'all' 记录所有、'error' 记录非 2xx 响应（重定向、4xx、5xx、网络错误）、'none' 不记录 |
-| `report.maxBufferSize` | number | 10 | 缓冲区最大数量 |
+| `report.maxBufferSize` | number | 10 | 缓冲区最大数量，达到后立即上报 |
 | `report.flushInterval` | number | 5000 | 上报间隔 (ms) |
+| `report.timeout` | number | 10000 | 请求超时 (ms) |
+| `error.enabled` | boolean | true | 是否启用错误监控 |
+| `error.jsError` | boolean | true | 是否捕获 JS 运行时错误 |
+| `error.promiseError` | boolean | true | 是否捕获 Promise 异常 |
+| `error.resourceError` | boolean | true | 是否捕获资源加载错误 |
+| `error.httpError` | boolean | true | 是否捕获 HTTP 请求错误 |
+| `performance.enabled` | boolean | true | 是否启用性能监控 |
+| `performance.webVitals` | boolean | true | 是否采集 Web Vitals 指标 |
+| `performance.resource` | boolean | true | 是否采集资源加载性能 |
+| `performance.api` | boolean | true | 是否采集接口性能 |
+| `behavior.enabled` | boolean | true | 是否启用行为监控 |
+| `behavior.pv` | boolean | true | 是否采集页面访问 (PV) |
+| `behavior.click` | boolean | true | 是否采集点击事件 |
+| `behavior.route` | boolean | true | 是否采集路由变化 |
+| `behavior.maxBreadcrumbs` | number | 20 | 行为回溯最大记录数 |
+| `behavior.recordRequestBreadcrumb` | 'all' \| 'error' \| 'none' | 'error' | 网络请求记录模式：'all' 记录所有、'error' 记录失败请求、'none' 不记录 |
 
 ## 产物清单
 

package/dist/core/config.d.ts

@@ -9,8 +9,9 @@ declare class ConfigManager {
     private config;
     /**
      * 初始化配置
+     * @param skipValidation 是否跳过必填校验（用于远程配置已获取 appId/dsn 的场景）
      */
-    init(userConfig: MonitorConfig): void;
+    init(userConfig: MonitorConfig, skipValidation?: boolean): void;
     /**
      * 获取配置
      */

package/dist/index.cjs.js

@@ -49,13 +49,28 @@ class ConfigManager {
     }
     /**
      * 初始化配置
+     * @param skipValidation 是否跳过必填校验（用于远程配置已获取 appId/dsn 的场景）
      */
-    init(userConfig) {
-        if (!userConfig.appId) {
-            throw new Error('[Monitor] appId is required');
+    init(userConfig, skipValidation = false) {
+        if (!skipValidation) {
+            // 如果没有 configUrl，则 appId 和 dsn 是必填的
+            if (!userConfig.configUrl) {
+                if (!userConfig.appId) {
+                    throw new Error('[Monitor] appId is required when configUrl is not provided');
+                }
+                if (!userConfig.dsn) {
+                    throw new Error('[Monitor] dsn is required when configUrl is not provided');
+                }
+            }
         }
-        if (!userConfig.dsn) {
-            throw new Error('[Monitor] dsn is required');
+        else {
+            // 远程配置模式下，校验合并后的配置
+            if (!userConfig.appId) {
+                throw new Error('[Monitor] appId is required (not found in remote config)');
+            }
+            if (!userConfig.dsn) {
+                throw new Error('[Monitor] dsn is required (not found in remote config)');
+            }
         }
         this.config = this.mergeConfig(DEFAULT_CONFIG, userConfig);
     }
@@ -1635,17 +1650,34 @@ class MonitorSDK {
     }
     /**
      * 初始化 SDK
+     * 如果配置了 configUrl，将先从远程获取配置（仅获取一次）
      */
-    init(userConfig) {
+    async init(userConfig) {
         if (this.initialized) {
             console.warn('[Monitor] SDK already initialized');
             return;
         }
-        // 初始化配置
+        let finalConfig = { ...userConfig };
+        // 如果配置了 configUrl，从远程获取配置
+        if (userConfig.configUrl) {
+            try {
+                const remoteConfig = await this.fetchRemoteConfig(userConfig.configUrl);
+                // 远程配置作为基础，用户本地配置覆盖远程配置
+                finalConfig = this.mergeUserConfig(remoteConfig, userConfig);
+                if (userConfig.debug) {
+                    console.log('[Monitor] Remote config loaded:', remoteConfig);
+                }
+            }
+            catch (error) {
+                console.error('[Monitor] Failed to fetch remote config:', error);
+                throw new Error('[Monitor] Failed to fetch remote config. Please check configUrl.');
+            }
+        }
+        // 初始化配置（远程配置模式下跳过初始校验，因为已经合并了远程配置）
         config.init({
-            ...userConfig,
-            version: userConfig.version || SDK_VERSION,
-        });
+            ...finalConfig,
+            version: finalConfig.version || SDK_VERSION,
+        }, !!userConfig.configUrl);
         // 初始化上下文
         const maxBreadcrumbs = config.get().behavior?.maxBreadcrumbs || 20;
         context.init(maxBreadcrumbs);
@@ -1658,6 +1690,50 @@ class MonitorSDK {
         installPerformanceMonitor();
         installBehaviorMonitor();
     }
+    /**
+     * 从远程获取配置
+     */
+    async fetchRemoteConfig(configUrl) {
+        const response = await fetch(configUrl, {
+            method: 'GET',
+            headers: {
+                'Content-Type': 'application/json',
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+        }
+        return response.json();
+    }
+    /**
+     * 合并配置：远程配置为基础，用户本地配置优先
+     */
+    mergeUserConfig(remote, local) {
+        const result = { ...remote };
+        for (const key in local) {
+            if (Object.prototype.hasOwnProperty.call(local, key)) {
+                const localValue = local[key];
+                const remoteValue = remote[key];
+                // 跳过 configUrl，不需要传递给最终配置
+                if (key === 'configUrl')
+                    continue;
+                if (localValue !== null &&
+                    localValue !== undefined &&
+                    typeof localValue === 'object' &&
+                    !Array.isArray(localValue) &&
+                    remoteValue !== null &&
+                    remoteValue !== undefined &&
+                    typeof remoteValue === 'object' &&
+                    !Array.isArray(remoteValue)) {
+                    result[key] = { ...remoteValue, ...localValue };
+                }
+                else if (localValue !== undefined) {
+                    result[key] = localValue;
+                }
+            }
+        }
+        return result;
+    }
     /**
      * 设置用户信息
      */