@vlian/framework 1.0.0

package/dist/utils/monitoring.cjs

@@ -0,0 +1,311 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", {
+    value: true
+});
+function _export(target, all) {
+    for(var name in all)Object.defineProperty(target, name, {
+        enumerable: true,
+        get: Object.getOwnPropertyDescriptor(all, name).get
+    });
+}
+_export(exports, {
+    get MonitoringService () {
+        return MonitoringService;
+    },
+    get getMonitoring () {
+        return getMonitoring;
+    },
+    get initMonitoring () {
+        return initMonitoring;
+    }
+});
+const _logger = require("./logger");
+const _errors = require("./errors");
+const _performance = require("./performance");
+function _define_property(obj, key, value) {
+    if (key in obj) {
+        Object.defineProperty(obj, key, {
+            value: value,
+            enumerable: true,
+            configurable: true,
+            writable: true
+        });
+    } else {
+        obj[key] = value;
+    }
+    return obj;
+}
+let MonitoringService = class MonitoringService {
+    /**
+   * 初始化错误捕获
+   */ initErrorCapture() {
+        // 捕获未处理的 Promise 错误
+        this.unhandledRejectionHandler = (event)=>{
+            const error = _errors.errorUtils.normalizeError(event.reason);
+            this.captureError(error, {
+                type: 'unhandledrejection',
+                reason: event.reason
+            });
+        };
+        window.addEventListener('unhandledrejection', this.unhandledRejectionHandler);
+        // 捕获全局错误
+        this.errorHandler = (event)=>{
+            const error = _errors.errorUtils.normalizeError(event.error || new Error(event.message));
+            this.captureError(error, {
+                type: 'global',
+                filename: event.filename,
+                lineno: event.lineno,
+                colno: event.colno
+            });
+        };
+        window.addEventListener('error', this.errorHandler);
+    }
+    /**
+   * 清理资源
+   */ destroy() {
+        // 移除事件监听器
+        if (typeof window !== 'undefined') {
+            if (this.unhandledRejectionHandler) {
+                window.removeEventListener('unhandledrejection', this.unhandledRejectionHandler);
+            }
+            if (this.errorHandler) {
+                window.removeEventListener('error', this.errorHandler);
+            }
+        }
+        // 停止聚合定时器
+        if (this.aggregationTimer) {
+            clearInterval(this.aggregationTimer);
+            this.aggregationTimer = undefined;
+        }
+        // 清空错误处理器
+        this.errorHandlers = [];
+        this.errorRecords = [];
+        this.errorAggregations.clear();
+    }
+    /**
+   * 启动错误聚合定时器
+   */ startAggregationTimer() {
+        this.aggregationTimer = setInterval(()=>{
+            this.aggregateErrors();
+        }, this.errorConfig.aggregationWindow);
+    }
+    /**
+   * 聚合错误
+   */ aggregateErrors() {
+        const now = Date.now();
+        const windowStart = now - this.errorConfig.aggregationWindow;
+        // 过滤窗口内的错误
+        const windowErrors = this.errorRecords.filter((record)=>record.timestamp >= windowStart);
+        // 按错误代码聚合
+        const aggregations = new Map();
+        for (const record of windowErrors){
+            const error = record.error;
+            const key = `${error.code}_${error.type}`;
+            if (!aggregations.has(key)) {
+                aggregations.set(key, {
+                    code: error.code,
+                    message: error.message,
+                    type: error.type,
+                    count: 0,
+                    firstOccurrence: record.timestamp,
+                    lastOccurrence: record.timestamp,
+                    stack: error.originalError?.stack,
+                    context: error.context
+                });
+            }
+            const agg = aggregations.get(key);
+            agg.count++;
+            agg.lastOccurrence = Math.max(agg.lastOccurrence, record.timestamp);
+        }
+        // 更新聚合结果
+        this.errorAggregations = aggregations;
+    }
+    /**
+   * 捕获错误
+   */ captureError(error, context) {
+        // 采样检查
+        if (Math.random() > this.errorConfig.sampleRate) {
+            return;
+        }
+        const normalizedError = _errors.errorUtils.normalizeError(error);
+        // 创建带上下文的错误对象（使用 Object.assign 来更新只读属性）
+        const errorWithContext = Object.assign(normalizedError, {
+            context: {
+                ...normalizedError.context,
+                ...context,
+                timestamp: new Date().toISOString(),
+                userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,
+                url: typeof window !== 'undefined' ? window.location.href : undefined
+            }
+        });
+        // 记录错误
+        const timestamp = Date.now();
+        this.errorRecords.push({
+            error: errorWithContext,
+            timestamp
+        });
+        // 限制错误记录数量
+        if (this.errorRecords.length > this.errorConfig.maxErrorRecords) {
+            this.errorRecords.shift();
+        }
+        // 记录日志
+        if (this.errorConfig.showInConsole) {
+            _logger.logger.error('监控服务捕获到错误:', errorWithContext.toJSON());
+        }
+        // 调用错误回调
+        this.errorConfig.onError(errorWithContext, context);
+        // 调用注册的错误处理器
+        this.errorHandlers.forEach((handler)=>{
+            try {
+                handler(errorWithContext);
+            } catch (e) {
+            // 忽略处理器错误
+            }
+        });
+    }
+    /**
+   * 获取错误聚合信息
+   * 
+   * @param code - 错误代码（可选，如果提供则只返回该错误的聚合信息）
+   * @returns 错误聚合信息
+   */ getErrorAggregations(code) {
+        if (code) {
+            const aggregation = this.errorAggregations.get(code);
+            return aggregation ? [
+                aggregation
+            ] : [];
+        }
+        return Array.from(this.errorAggregations.values());
+    }
+    /**
+   * 获取错误记录
+   * 
+   * @param limit - 限制返回的记录数
+   * @param since - 只返回此时间之后的错误
+   * @returns 错误记录
+   */ getErrorRecords(limit, since) {
+        let records = this.errorRecords;
+        if (since) {
+            records = records.filter((record)=>record.timestamp >= since);
+        }
+        if (limit) {
+            records = records.slice(-limit);
+        }
+        return [
+            ...records
+        ];
+    }
+    /**
+   * 清空错误记录
+   */ clearErrorRecords() {
+        this.errorRecords = [];
+        this.errorAggregations.clear();
+    }
+    /**
+   * 注册错误处理器
+   */ onError(handler) {
+        this.errorHandlers.push(handler);
+        return ()=>{
+            const index = this.errorHandlers.indexOf(handler);
+            if (index > -1) {
+                this.errorHandlers.splice(index, 1);
+            }
+        };
+    }
+    /**
+   * 上报性能指标
+   */ reportPerformance(metrics, context) {
+        // 将传入的指标转换为带单位的格式
+        const metricsWithUnits = (0, _performance.convertMetricsToWithUnits)(metrics);
+        // 合并到现有指标中
+        this.performanceMetrics = {
+            ...this.performanceMetrics,
+            ...metricsWithUnits
+        };
+        // 记录性能指标（带上下文）
+        if (context) {
+            _logger.logger.debug('性能指标更新:', {
+                metrics: metricsWithUnits,
+                context
+            });
+        } else {
+            _logger.logger.debug('性能指标更新:', metricsWithUnits);
+        }
+    }
+    /**
+   * 批量上报性能指标
+   */ reportPerformanceBatch(metricsArray) {
+        for (const { metrics, context } of metricsArray){
+            this.reportPerformance(metrics, context);
+        }
+    }
+    /**
+   * 获取性能指标（带单位）
+   */ getPerformanceMetrics() {
+        return {
+            ...this.performanceMetrics
+        };
+    }
+    /**
+   * 获取性能指标（原始数值格式，向后兼容）
+   */ getPerformanceMetricsRaw() {
+        const result = {};
+        for (const [key, metricValue] of Object.entries(this.performanceMetrics)){
+            if (metricValue && typeof metricValue === 'object' && 'value' in metricValue) {
+                result[key] = metricValue.value;
+            }
+        }
+        return result;
+    }
+    /**
+   * 记录用户行为（匿名）
+   */ trackEvent(eventName, properties) {
+        _logger.logger.debug('用户事件:', {
+            eventName,
+            properties
+        });
+    }
+    constructor(errorConfig = {}){
+        _define_property(this, "errorConfig", void 0);
+        _define_property(this, "errorHandlers", []);
+        _define_property(this, "performanceMetrics", {});
+        _define_property(this, "unhandledRejectionHandler", void 0);
+        _define_property(this, "errorHandler", void 0);
+        _define_property(this, "errorRecords", []);
+        _define_property(this, "errorAggregations", new Map());
+        _define_property(this, "aggregationTimer", void 0);
+        this.errorConfig = {
+            autoCapture: errorConfig.autoCapture ?? true,
+            onError: errorConfig.onError ?? (()=>{}),
+            sampleRate: errorConfig.sampleRate ?? 1.0,
+            showInConsole: errorConfig.showInConsole ?? true,
+            enableAggregation: errorConfig.enableAggregation ?? true,
+            aggregationWindow: errorConfig.aggregationWindow ?? 60000,
+            maxErrorRecords: errorConfig.maxErrorRecords ?? 1000
+        };
+        if (this.errorConfig.autoCapture && typeof window !== 'undefined') {
+            this.initErrorCapture();
+        }
+        // 启动错误聚合定时器
+        if (this.errorConfig.enableAggregation) {
+            this.startAggregationTimer();
+        }
+    }
+};
+/**
+ * 默认监控服务实例
+ */ let defaultMonitoringService = null;
+function initMonitoring(config) {
+    if (!defaultMonitoringService) {
+        defaultMonitoringService = new MonitoringService(config);
+    }
+    return defaultMonitoringService;
+}
+function getMonitoring() {
+    if (!defaultMonitoringService) {
+        return initMonitoring();
+    }
+    return defaultMonitoringService;
+}
+
+//# sourceMappingURL=monitoring.js.map

package/dist/utils/monitoring.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/monitoring.ts"],"sourcesContent":["import { logger } from './logger';\nimport { errorUtils, type FrameworkError } from './errors';\nimport type { PerformanceMetrics, PerformanceMetricsWithUnits, PerformanceMetricValue } from './performance';\nimport { convertMetricsToWithUnits } from './performance';\n\n/**\n * 错误监控配置\n */\nexport interface ErrorMonitorConfig {\n  /**\n   * 是否自动捕获未处理的错误\n   */\n  autoCapture?: boolean;\n  /**\n   * 错误上报回调\n   */\n  onError?: (error: FrameworkError, context?: Record<string, unknown>) => void;\n  /**\n   * 采样率 (0-1)\n   */\n  sampleRate?: number;\n  /**\n   * 是否在控制台显示错误\n   */\n  showInConsole?: boolean;\n  /**\n   * 是否启用错误聚合\n   */\n  enableAggregation?: boolean;\n  /**\n   * 错误聚合窗口大小（毫秒）\n   */\n  aggregationWindow?: number;\n  /**\n   * 最大错误记录数\n   */\n  maxErrorRecords?: number;\n}\n\n/**\n * 错误聚合信息\n */\nexport interface ErrorAggregation {\n  /**\n   * 错误代码\n   */\n  code: string;\n  /**\n   * 错误消息\n   */\n  message: string;\n  /**\n   * 错误类型\n   */\n  type: string;\n  /**\n   * 错误数量\n   */\n  count: number;\n  /**\n   * 首次出现时间\n   */\n  firstOccurrence: number;\n  /**\n   * 最后出现时间\n   */\n  lastOccurrence: number;\n  /**\n   * 错误堆栈（示例）\n   */\n  stack?: string;\n  /**\n   * 错误上下文（示例）\n   */\n  context?: Record<string, unknown>;\n}\n\n/**\n * 监控服务类\n */\nexport class MonitoringService {\n  private errorConfig: Required<ErrorMonitorConfig>;\n  private errorHandlers: Array<(error: FrameworkError) => void> = [];\n  private performanceMetrics: PerformanceMetricsWithUnits = {};\n  private unhandledRejectionHandler?: (event: PromiseRejectionEvent) => void;\n  private errorHandler?: (event: ErrorEvent) => void;\n  private errorRecords: Array<{ error: FrameworkError; timestamp: number }> = [];\n  private errorAggregations: Map<string, ErrorAggregation> = new Map();\n  private aggregationTimer?: ReturnType<typeof setInterval>;\n\n  constructor(errorConfig: ErrorMonitorConfig = {}) {\n    this.errorConfig = {\n      autoCapture: errorConfig.autoCapture ?? true,\n      onError: errorConfig.onError ?? (() => {}),\n      sampleRate: errorConfig.sampleRate ?? 1.0,\n      showInConsole: errorConfig.showInConsole ?? true,\n      enableAggregation: errorConfig.enableAggregation ?? true,\n      aggregationWindow: errorConfig.aggregationWindow ?? 60000, // 1分钟\n      maxErrorRecords: errorConfig.maxErrorRecords ?? 1000,\n    };\n\n    if (this.errorConfig.autoCapture && typeof window !== 'undefined') {\n      this.initErrorCapture();\n    }\n\n    // 启动错误聚合定时器\n    if (this.errorConfig.enableAggregation) {\n      this.startAggregationTimer();\n    }\n  }\n\n  /**\n   * 初始化错误捕获\n   */\n  private initErrorCapture(): void {\n    // 捕获未处理的 Promise 错误\n    this.unhandledRejectionHandler = (event: PromiseRejectionEvent) => {\n      const error = errorUtils.normalizeError(event.reason);\n      this.captureError(error, {\n        type: 'unhandledrejection',\n        reason: event.reason,\n      });\n    };\n    window.addEventListener('unhandledrejection', this.unhandledRejectionHandler);\n\n    // 捕获全局错误\n    this.errorHandler = (event: ErrorEvent) => {\n      const error = errorUtils.normalizeError(event.error || new Error(event.message));\n      this.captureError(error, {\n        type: 'global',\n        filename: event.filename,\n        lineno: event.lineno,\n        colno: event.colno,\n      });\n    };\n    window.addEventListener('error', this.errorHandler);\n  }\n\n  /**\n   * 清理资源\n   */\n  destroy(): void {\n    // 移除事件监听器\n    if (typeof window !== 'undefined') {\n      if (this.unhandledRejectionHandler) {\n        window.removeEventListener('unhandledrejection', this.unhandledRejectionHandler);\n      }\n      if (this.errorHandler) {\n        window.removeEventListener('error', this.errorHandler);\n      }\n    }\n\n    // 停止聚合定时器\n    if (this.aggregationTimer) {\n      clearInterval(this.aggregationTimer);\n      this.aggregationTimer = undefined;\n    }\n\n    // 清空错误处理器\n    this.errorHandlers = [];\n    this.errorRecords = [];\n    this.errorAggregations.clear();\n  }\n\n  /**\n   * 启动错误聚合定时器\n   */\n  private startAggregationTimer(): void {\n    this.aggregationTimer = setInterval(() => {\n      this.aggregateErrors();\n    }, this.errorConfig.aggregationWindow!);\n  }\n\n  /**\n   * 聚合错误\n   */\n  private aggregateErrors(): void {\n    const now = Date.now();\n    const windowStart = now - this.errorConfig.aggregationWindow!;\n\n    // 过滤窗口内的错误\n    const windowErrors = this.errorRecords.filter(\n      (record) => record.timestamp >= windowStart\n    );\n\n    // 按错误代码聚合\n    const aggregations = new Map<string, ErrorAggregation>();\n\n    for (const record of windowErrors) {\n      const error = record.error;\n      const key = `${error.code}_${error.type}`;\n\n      if (!aggregations.has(key)) {\n        aggregations.set(key, {\n          code: error.code,\n          message: error.message,\n          type: error.type,\n          count: 0,\n          firstOccurrence: record.timestamp,\n          lastOccurrence: record.timestamp,\n          stack: error.originalError?.stack,\n          context: error.context,\n        });\n      }\n\n      const agg = aggregations.get(key)!;\n      agg.count++;\n      agg.lastOccurrence = Math.max(agg.lastOccurrence, record.timestamp);\n    }\n\n    // 更新聚合结果\n    this.errorAggregations = aggregations;\n  }\n\n  /**\n   * 捕获错误\n   */\n  captureError(error: unknown, context?: Record<string, unknown>): void {\n    // 采样检查\n    if (Math.random() > this.errorConfig.sampleRate) {\n      return;\n    }\n\n    const normalizedError = errorUtils.normalizeError(error);\n    // 创建带上下文的错误对象（使用 Object.assign 来更新只读属性）\n    const errorWithContext = Object.assign(normalizedError, {\n      context: {\n        ...normalizedError.context,\n        ...context,\n        timestamp: new Date().toISOString(),\n        userAgent: typeof navigator !== 'undefined' ? navigator.userAgent : undefined,\n        url: typeof window !== 'undefined' ? window.location.href : undefined,\n      },\n    });\n\n    // 记录错误\n    const timestamp = Date.now();\n    this.errorRecords.push({\n      error: errorWithContext,\n      timestamp,\n    });\n\n    // 限制错误记录数量\n    if (this.errorRecords.length > this.errorConfig.maxErrorRecords!) {\n      this.errorRecords.shift();\n    }\n\n    // 记录日志\n    if (this.errorConfig.showInConsole) {\n      logger.error('监控服务捕获到错误:', errorWithContext.toJSON());\n    }\n\n    // 调用错误回调\n    this.errorConfig.onError(errorWithContext, context);\n\n    // 调用注册的错误处理器\n    this.errorHandlers.forEach((handler) => {\n      try {\n        handler(errorWithContext);\n      } catch (e) {\n        // 忽略处理器错误\n      }\n    });\n  }\n\n  /**\n   * 获取错误聚合信息\n   * \n   * @param code - 错误代码（可选，如果提供则只返回该错误的聚合信息）\n   * @returns 错误聚合信息\n   */\n  getErrorAggregations(code?: string): ErrorAggregation[] {\n    if (code) {\n      const aggregation = this.errorAggregations.get(code);\n      return aggregation ? [aggregation] : [];\n    }\n    return Array.from(this.errorAggregations.values());\n  }\n\n  /**\n   * 获取错误记录\n   * \n   * @param limit - 限制返回的记录数\n   * @param since - 只返回此时间之后的错误\n   * @returns 错误记录\n   */\n  getErrorRecords(limit?: number, since?: number): Array<{ error: FrameworkError; timestamp: number }> {\n    let records = this.errorRecords;\n\n    if (since) {\n      records = records.filter((record) => record.timestamp >= since);\n    }\n\n    if (limit) {\n      records = records.slice(-limit);\n    }\n\n    return [...records];\n  }\n\n  /**\n   * 清空错误记录\n   */\n  clearErrorRecords(): void {\n    this.errorRecords = [];\n    this.errorAggregations.clear();\n  }\n\n  /**\n   * 注册错误处理器\n   */\n  onError(handler: (error: FrameworkError) => void): () => void {\n    this.errorHandlers.push(handler);\n    return () => {\n      const index = this.errorHandlers.indexOf(handler);\n      if (index > -1) {\n        this.errorHandlers.splice(index, 1);\n      }\n    };\n  }\n\n  /**\n   * 上报性能指标\n   */\n  reportPerformance(metrics: PerformanceMetrics, context?: Record<string, unknown>): void {\n    // 将传入的指标转换为带单位的格式\n    const metricsWithUnits = convertMetricsToWithUnits(metrics);\n    \n    // 合并到现有指标中\n    this.performanceMetrics = { ...this.performanceMetrics, ...metricsWithUnits };\n    \n    // 记录性能指标（带上下文）\n    if (context) {\n      logger.debug('性能指标更新:', { metrics: metricsWithUnits, context });\n    } else {\n      logger.debug('性能指标更新:', metricsWithUnits);\n    }\n  }\n\n  /**\n   * 批量上报性能指标\n   */\n  reportPerformanceBatch(metricsArray: Array<{ metrics: PerformanceMetrics; context?: Record<string, unknown> }>): void {\n    for (const { metrics, context } of metricsArray) {\n      this.reportPerformance(metrics, context);\n    }\n  }\n\n  /**\n   * 获取性能指标（带单位）\n   */\n  getPerformanceMetrics(): PerformanceMetricsWithUnits {\n    return { ...this.performanceMetrics };\n  }\n\n  /**\n   * 获取性能指标（原始数值格式，向后兼容）\n   */\n  getPerformanceMetricsRaw(): PerformanceMetrics {\n    const result: PerformanceMetrics = {};\n    \n    for (const [key, metricValue] of Object.entries(this.performanceMetrics)) {\n      if (metricValue && typeof metricValue === 'object' && 'value' in metricValue) {\n        (result as Record<string, number>)[key] = (metricValue as PerformanceMetricValue).value;\n      }\n    }\n    \n    return result;\n  }\n\n  /**\n   * 记录用户行为（匿名）\n   */\n  trackEvent(eventName: string, properties?: Record<string, unknown>): void {\n    logger.debug('用户事件:', { eventName, properties });\n  }\n}\n\n/**\n * 默认监控服务实例\n */\nlet defaultMonitoringService: MonitoringService | null = null;\n\n/**\n * 初始化默认监控服务\n */\nexport function initMonitoring(config?: ErrorMonitorConfig): MonitoringService {\n  if (!defaultMonitoringService) {\n    defaultMonitoringService = new MonitoringService(config);\n  }\n  return defaultMonitoringService;\n}\n\n/**\n * 获取默认监控服务\n */\nexport function getMonitoring(): MonitoringService {\n  if (!defaultMonitoringService) {\n    return initMonitoring();\n  }\n  return defaultMonitoringService;\n}\n"],"names":["MonitoringService","getMonitoring","initMonitoring","initErrorCapture","unhandledRejectionHandler","event","error","errorUtils","normalizeError","reason","captureError","type","window","addEventListener","errorHandler","Error","message","filename","lineno","colno","destroy","removeEventListener","aggregationTimer","clearInterval","undefined","errorHandlers","errorRecords","errorAggregations","clear","startAggregationTimer","setInterval","aggregateErrors","errorConfig","aggregationWindow","now","Date","windowStart","windowErrors","filter","record","timestamp","aggregations","Map","key","code","has","set","count","firstOccurrence","lastOccurrence","stack","originalError","context","agg","get","Math","max","random","sampleRate","normalizedError","errorWithContext","Object","assign","toISOString","userAgent","navigator","url","location","href","push","length","maxErrorRecords","shift","showInConsole","logger","toJSON","onError","forEach","handler","e","getErrorAggregations","aggregation","Array","from","values","getErrorRecords","limit","since","records","slice","clearErrorRecords","index","indexOf","splice","reportPerformance","metrics","metricsWithUnits","convertMetricsToWithUnits","performanceMetrics","debug","reportPerformanceBatch","metricsArray","getPerformanceMetrics","getPerformanceMetricsRaw","result","metricValue","entries","value","trackEvent","eventName","properties","autoCapture","enableAggregation","defaultMonitoringService","config"],"mappings":"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"}

package/dist/utils/monitoring.d.ts

@@ -0,0 +1,164 @@
+import { type FrameworkError } from './errors';
+import type { PerformanceMetrics, PerformanceMetricsWithUnits } from './performance';
+/**
+ * 错误监控配置
+ */
+export interface ErrorMonitorConfig {
+    /**
+     * 是否自动捕获未处理的错误
+     */
+    autoCapture?: boolean;
+    /**
+     * 错误上报回调
+     */
+    onError?: (error: FrameworkError, context?: Record<string, unknown>) => void;
+    /**
+     * 采样率 (0-1)
+     */
+    sampleRate?: number;
+    /**
+     * 是否在控制台显示错误
+     */
+    showInConsole?: boolean;
+    /**
+     * 是否启用错误聚合
+     */
+    enableAggregation?: boolean;
+    /**
+     * 错误聚合窗口大小（毫秒）
+     */
+    aggregationWindow?: number;
+    /**
+     * 最大错误记录数
+     */
+    maxErrorRecords?: number;
+}
+/**
+ * 错误聚合信息
+ */
+export interface ErrorAggregation {
+    /**
+     * 错误代码
+     */
+    code: string;
+    /**
+     * 错误消息
+     */
+    message: string;
+    /**
+     * 错误类型
+     */
+    type: string;
+    /**
+     * 错误数量
+     */
+    count: number;
+    /**
+     * 首次出现时间
+     */
+    firstOccurrence: number;
+    /**
+     * 最后出现时间
+     */
+    lastOccurrence: number;
+    /**
+     * 错误堆栈（示例）
+     */
+    stack?: string;
+    /**
+     * 错误上下文（示例）
+     */
+    context?: Record<string, unknown>;
+}
+/**
+ * 监控服务类
+ */
+export declare class MonitoringService {
+    private errorConfig;
+    private errorHandlers;
+    private performanceMetrics;
+    private unhandledRejectionHandler?;
+    private errorHandler?;
+    private errorRecords;
+    private errorAggregations;
+    private aggregationTimer?;
+    constructor(errorConfig?: ErrorMonitorConfig);
+    /**
+     * 初始化错误捕获
+     */
+    private initErrorCapture;
+    /**
+     * 清理资源
+     */
+    destroy(): void;
+    /**
+     * 启动错误聚合定时器
+     */
+    private startAggregationTimer;
+    /**
+     * 聚合错误
+     */
+    private aggregateErrors;
+    /**
+     * 捕获错误
+     */
+    captureError(error: unknown, context?: Record<string, unknown>): void;
+    /**
+     * 获取错误聚合信息
+     *
+     * @param code - 错误代码（可选，如果提供则只返回该错误的聚合信息）
+     * @returns 错误聚合信息
+     */
+    getErrorAggregations(code?: string): ErrorAggregation[];
+    /**
+     * 获取错误记录
+     *
+     * @param limit - 限制返回的记录数
+     * @param since - 只返回此时间之后的错误
+     * @returns 错误记录
+     */
+    getErrorRecords(limit?: number, since?: number): Array<{
+        error: FrameworkError;
+        timestamp: number;
+    }>;
+    /**
+     * 清空错误记录
+     */
+    clearErrorRecords(): void;
+    /**
+     * 注册错误处理器
+     */
+    onError(handler: (error: FrameworkError) => void): () => void;
+    /**
+     * 上报性能指标
+     */
+    reportPerformance(metrics: PerformanceMetrics, context?: Record<string, unknown>): void;
+    /**
+     * 批量上报性能指标
+     */
+    reportPerformanceBatch(metricsArray: Array<{
+        metrics: PerformanceMetrics;
+        context?: Record<string, unknown>;
+    }>): void;
+    /**
+     * 获取性能指标（带单位）
+     */
+    getPerformanceMetrics(): PerformanceMetricsWithUnits;
+    /**
+     * 获取性能指标（原始数值格式，向后兼容）
+     */
+    getPerformanceMetricsRaw(): PerformanceMetrics;
+    /**
+     * 记录用户行为（匿名）
+     */
+    trackEvent(eventName: string, properties?: Record<string, unknown>): void;
+}
+/**
+ * 初始化默认监控服务
+ */
+export declare function initMonitoring(config?: ErrorMonitorConfig): MonitoringService;
+/**
+ * 获取默认监控服务
+ */
+export declare function getMonitoring(): MonitoringService;
+//# sourceMappingURL=monitoring.d.ts.map

package/dist/utils/monitoring.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitoring.d.ts","sourceRoot":"","sources":["../../src/utils/monitoring.ts"],"names":[],"mappings":"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"}