@jerry_aurora/sky-monitor-sdk 0.2.0

package/dist/plugins/transport.d.cts

@@ -0,0 +1,231 @@
+import { a as MonitorEvent, E as EventPriority, e as PrioritizedEvent, d as ITransport, T as TransportMode, P as Plugin, I as IMonitor } from '../types-BGUJGEpp.cjs';
+
+/**
+ * 优先级队列 - 按优先级排序事件
+ *
+ * 支持三个优先级级别：high > normal > low
+ * 缓冲区满时优先丢弃低优先级事件
+ */
+
+/**
+ * 优先级队列
+ */
+declare class PriorityQueue {
+    private _high;
+    private _normal;
+    private _low;
+    private _maxSize;
+    constructor(maxSize?: number);
+    /**
+     * 添加事件到队列
+     * @param event - 监控事件
+     * @param priority - 优先级
+     * @returns 是否成功添加（缓冲区满且无法丢弃时返回 false）
+     */
+    enqueue(event: MonitorEvent, priority?: EventPriority): boolean;
+    /**
+     * 取出指定数量的事件（按优先级顺序）
+     * @param count - 取出数量
+     * @returns 事件数组
+     */
+    dequeue(count: number): PrioritizedEvent[];
+    /**
+     * 查看队列头部事件（不移除）
+     * @param count - 查看数量
+     */
+    peek(count: number): PrioritizedEvent[];
+    /**
+     * 将事件放回队列头部（用于重试）
+     */
+    unshift(items: PrioritizedEvent[]): void;
+    /**
+     * 清空队列
+     */
+    clear(): void;
+    /**
+     * 队列总大小
+     */
+    get size(): number;
+    /**
+     * 队列是否为空
+     */
+    get isEmpty(): boolean;
+    /**
+     * 各优先级队列大小
+     */
+    get stats(): {
+        high: number;
+        normal: number;
+        low: number;
+    };
+}
+
+/**
+ * 指数退避重试调度器
+ *
+ * 特性：
+ * - 指数退避：每次失败后延迟翻倍
+ * - 延迟上限：不超过 maxDelay
+ * - 抖动：±20% 防止惊群效应
+ * - 成功重置：成功后重置为 baseDelay
+ */
+/** 重试调度器配置 */
+interface RetrySchedulerOptions {
+    /** 基础延迟（毫秒），默认 1000 */
+    baseDelay?: number;
+    /** 最大延迟（毫秒），默认 30000 */
+    maxDelay?: number;
+    /** 抖动比例 0-1，默认 0.2（±20%） */
+    jitter?: number;
+}
+/**
+ * 指数退避重试调度器
+ */
+declare class RetryScheduler {
+    private _baseDelay;
+    private _maxDelay;
+    private _jitter;
+    private _currentDelay;
+    private _retryCount;
+    constructor(options?: RetrySchedulerOptions);
+    /**
+     * 获取下次重试延迟（带抖动）
+     * @returns 延迟时间（毫秒）
+     */
+    getNextDelay(): number;
+    /**
+     * 重置延迟（成功后调用）
+     */
+    reset(): void;
+    /**
+     * 记录失败（不获取延迟，只更新状态）
+     */
+    recordFailure(): void;
+    /**
+     * 获取当前重试次数
+     */
+    get retryCount(): number;
+    /**
+     * 获取当前延迟（不带抖动）
+     */
+    get currentDelay(): number;
+    /**
+     * 添加抖动
+     * @param delay - 原始延迟
+     * @returns 带抖动的延迟
+     */
+    private _addJitter;
+}
+
+/**
+ * Transport 插件 - 事件上报策略
+ *
+ * 支持三种发送模式：
+ * - immediate: 立即发送
+ * - batch: 批量发送（默认）
+ * - throttle: 节流发送
+ *
+ * 特性：
+ * - 优先级队列（high > normal > low）
+ * - 指数退避重试
+ * - 关键事件立即发送
+ * - 页面卸载时用 sendBeacon
+ */
+
+/** 按事件类型配置发送模式 */
+type TypeModeConfig = Record<string, TransportMode>;
+interface TransportPluginOptions {
+    /** 上报地址 */
+    endpoint: string;
+    /** 传输适配器（可选，默认使用 BrowserTransport） */
+    transport?: ITransport;
+    /** 默认发送模式，默认 'batch' */
+    mode?: TransportMode;
+    /** 按事件类型配置发送模式（优先级高于 mode） */
+    typeConfig?: TypeModeConfig;
+    /** 批量大小，默认 10 */
+    batchSize?: number;
+    /** 刷新间隔（毫秒），默认 5000 */
+    flushInterval?: number;
+    /** 节流间隔（毫秒），默认 1000 */
+    throttleInterval?: number;
+    /** 最大重试次数，默认 3 */
+    maxRetries?: number;
+    /** 基础重试延迟（毫秒），默认 1000 */
+    baseRetryDelay?: number;
+    /** 最大重试延迟（毫秒），默认 30000 */
+    maxRetryDelay?: number;
+    /** 最大缓冲区大小，默认 100 */
+    maxBufferSize?: number;
+    /** 关键事件类型（立即发送，兼容旧配置） */
+    criticalTypes?: string[];
+}
+/**
+ * Transport 插件
+ */
+declare class TransportPlugin implements Plugin {
+    name: string;
+    priority: number;
+    private _transport;
+    private _defaultMode;
+    private _typeConfig;
+    private _batchSize;
+    private _flushInterval;
+    private _throttleInterval;
+    private _maxRetries;
+    private _criticalTypes;
+    private _queue;
+    private _throttleQueue;
+    private _retryScheduler;
+    private _platformAdapter;
+    private _retryTimer;
+    private _isRetrying;
+    private _lastThrottleSend;
+    constructor(options: TransportPluginOptions);
+    /**
+     * 插件初始化
+     */
+    setupOnce(_monitor: IMonitor): void;
+    /**
+     * 事件处理：根据事件类型和模式处理
+     */
+    processEvent(event: MonitorEvent): MonitorEvent | null;
+    /**
+     * 获取事件的发送模式
+     */
+    private _getModeForEvent;
+    /**
+     * 插件销毁
+     */
+    teardown(): void;
+    /**
+     * 获取事件优先级
+     */
+    private _getPriority;
+    /**
+     * 立即发送单个事件
+     */
+    private _sendImmediate;
+    /**
+     * 批量发送
+     */
+    private _flush;
+    /**
+     * 节流发送
+     */
+    private _throttleFlush;
+    /**
+     * 页面卸载时发送（sendBeacon）
+     */
+    private _flushBeacon;
+    /**
+     * 调度重试
+     */
+    private _scheduleRetry;
+    /**
+     * 移入离线队列（通过协调器）
+     */
+    private _moveToOffline;
+}
+
+export { PriorityQueue, RetryScheduler, type RetrySchedulerOptions, TransportPlugin, type TransportPluginOptions, type TypeModeConfig };

package/dist/plugins/transport.d.ts

@@ -0,0 +1,231 @@
+import { a as MonitorEvent, E as EventPriority, e as PrioritizedEvent, d as ITransport, T as TransportMode, P as Plugin, I as IMonitor } from '../types-BGUJGEpp.js';
+
+/**
+ * 优先级队列 - 按优先级排序事件
+ *
+ * 支持三个优先级级别：high > normal > low
+ * 缓冲区满时优先丢弃低优先级事件
+ */
+
+/**
+ * 优先级队列
+ */
+declare class PriorityQueue {
+    private _high;
+    private _normal;
+    private _low;
+    private _maxSize;
+    constructor(maxSize?: number);
+    /**
+     * 添加事件到队列
+     * @param event - 监控事件
+     * @param priority - 优先级
+     * @returns 是否成功添加（缓冲区满且无法丢弃时返回 false）
+     */
+    enqueue(event: MonitorEvent, priority?: EventPriority): boolean;
+    /**
+     * 取出指定数量的事件（按优先级顺序）
+     * @param count - 取出数量
+     * @returns 事件数组
+     */
+    dequeue(count: number): PrioritizedEvent[];
+    /**
+     * 查看队列头部事件（不移除）
+     * @param count - 查看数量
+     */
+    peek(count: number): PrioritizedEvent[];
+    /**
+     * 将事件放回队列头部（用于重试）
+     */
+    unshift(items: PrioritizedEvent[]): void;
+    /**
+     * 清空队列
+     */
+    clear(): void;
+    /**
+     * 队列总大小
+     */
+    get size(): number;
+    /**
+     * 队列是否为空
+     */
+    get isEmpty(): boolean;
+    /**
+     * 各优先级队列大小
+     */
+    get stats(): {
+        high: number;
+        normal: number;
+        low: number;
+    };
+}
+
+/**
+ * 指数退避重试调度器
+ *
+ * 特性：
+ * - 指数退避：每次失败后延迟翻倍
+ * - 延迟上限：不超过 maxDelay
+ * - 抖动：±20% 防止惊群效应
+ * - 成功重置：成功后重置为 baseDelay
+ */
+/** 重试调度器配置 */
+interface RetrySchedulerOptions {
+    /** 基础延迟（毫秒），默认 1000 */
+    baseDelay?: number;
+    /** 最大延迟（毫秒），默认 30000 */
+    maxDelay?: number;
+    /** 抖动比例 0-1，默认 0.2（±20%） */
+    jitter?: number;
+}
+/**
+ * 指数退避重试调度器
+ */
+declare class RetryScheduler {
+    private _baseDelay;
+    private _maxDelay;
+    private _jitter;
+    private _currentDelay;
+    private _retryCount;
+    constructor(options?: RetrySchedulerOptions);
+    /**
+     * 获取下次重试延迟（带抖动）
+     * @returns 延迟时间（毫秒）
+     */
+    getNextDelay(): number;
+    /**
+     * 重置延迟（成功后调用）
+     */
+    reset(): void;
+    /**
+     * 记录失败（不获取延迟，只更新状态）
+     */
+    recordFailure(): void;
+    /**
+     * 获取当前重试次数
+     */
+    get retryCount(): number;
+    /**
+     * 获取当前延迟（不带抖动）
+     */
+    get currentDelay(): number;
+    /**
+     * 添加抖动
+     * @param delay - 原始延迟
+     * @returns 带抖动的延迟
+     */
+    private _addJitter;
+}
+
+/**
+ * Transport 插件 - 事件上报策略
+ *
+ * 支持三种发送模式：
+ * - immediate: 立即发送
+ * - batch: 批量发送（默认）
+ * - throttle: 节流发送
+ *
+ * 特性：
+ * - 优先级队列（high > normal > low）
+ * - 指数退避重试
+ * - 关键事件立即发送
+ * - 页面卸载时用 sendBeacon
+ */
+
+/** 按事件类型配置发送模式 */
+type TypeModeConfig = Record<string, TransportMode>;
+interface TransportPluginOptions {
+    /** 上报地址 */
+    endpoint: string;
+    /** 传输适配器（可选，默认使用 BrowserTransport） */
+    transport?: ITransport;
+    /** 默认发送模式，默认 'batch' */
+    mode?: TransportMode;
+    /** 按事件类型配置发送模式（优先级高于 mode） */
+    typeConfig?: TypeModeConfig;
+    /** 批量大小，默认 10 */
+    batchSize?: number;
+    /** 刷新间隔（毫秒），默认 5000 */
+    flushInterval?: number;
+    /** 节流间隔（毫秒），默认 1000 */
+    throttleInterval?: number;
+    /** 最大重试次数，默认 3 */
+    maxRetries?: number;
+    /** 基础重试延迟（毫秒），默认 1000 */
+    baseRetryDelay?: number;
+    /** 最大重试延迟（毫秒），默认 30000 */
+    maxRetryDelay?: number;
+    /** 最大缓冲区大小，默认 100 */
+    maxBufferSize?: number;
+    /** 关键事件类型（立即发送，兼容旧配置） */
+    criticalTypes?: string[];
+}
+/**
+ * Transport 插件
+ */
+declare class TransportPlugin implements Plugin {
+    name: string;
+    priority: number;
+    private _transport;
+    private _defaultMode;
+    private _typeConfig;
+    private _batchSize;
+    private _flushInterval;
+    private _throttleInterval;
+    private _maxRetries;
+    private _criticalTypes;
+    private _queue;
+    private _throttleQueue;
+    private _retryScheduler;
+    private _platformAdapter;
+    private _retryTimer;
+    private _isRetrying;
+    private _lastThrottleSend;
+    constructor(options: TransportPluginOptions);
+    /**
+     * 插件初始化
+     */
+    setupOnce(_monitor: IMonitor): void;
+    /**
+     * 事件处理：根据事件类型和模式处理
+     */
+    processEvent(event: MonitorEvent): MonitorEvent | null;
+    /**
+     * 获取事件的发送模式
+     */
+    private _getModeForEvent;
+    /**
+     * 插件销毁
+     */
+    teardown(): void;
+    /**
+     * 获取事件优先级
+     */
+    private _getPriority;
+    /**
+     * 立即发送单个事件
+     */
+    private _sendImmediate;
+    /**
+     * 批量发送
+     */
+    private _flush;
+    /**
+     * 节流发送
+     */
+    private _throttleFlush;
+    /**
+     * 页面卸载时发送（sendBeacon）
+     */
+    private _flushBeacon;
+    /**
+     * 调度重试
+     */
+    private _scheduleRetry;
+    /**
+     * 移入离线队列（通过协调器）
+     */
+    private _moveToOffline;
+}
+
+export { PriorityQueue, RetryScheduler, type RetrySchedulerOptions, TransportPlugin, type TransportPluginOptions, type TypeModeConfig };

package/dist/plugins/transport.js

@@ -0,0 +1,2 @@
+export{b as PriorityQueue,c as RetryScheduler,d as TransportPlugin}from'../chunk-O32X45L3.js';import'../chunk-4DK7RV2K.js';//# sourceMappingURL=transport.js.map
+//# sourceMappingURL=transport.js.map

package/dist/plugins/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"transport.js"}

package/dist/plugins/xhr.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkLAATIQ3Y_cjs=require('../chunk-LAATIQ3Y.cjs');Object.defineProperty(exports,"XHRPlugin",{enumerable:true,get:function(){return chunkLAATIQ3Y_cjs.a}});//# sourceMappingURL=xhr.cjs.map
+//# sourceMappingURL=xhr.cjs.map

package/dist/plugins/xhr.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"xhr.cjs"}

package/dist/plugins/xhr.d.cts

@@ -0,0 +1,35 @@
+import { P as Plugin, I as IMonitor } from '../types-BGUJGEpp.cjs';
+
+/**
+ * XHR 插件 - 拦截 XMLHttpRequest
+ */
+
+interface XHRPluginOptions {
+    /** 包含的 URL 正则（白名单） */
+    includeUrls?: RegExp[];
+    /** 排除的 URL 正则（黑名单） */
+    excludeUrls?: RegExp[];
+}
+/**
+ * XHR 插件
+ * 基于 Proxy 代理 XMLHttpRequest 实例
+ */
+declare class XHRPlugin implements Plugin {
+    name: string;
+    priority: number;
+    private _monitor;
+    private _options;
+    private _platformAdapter;
+    constructor(options?: XHRPluginOptions);
+    /**
+     * 插件初始化
+     */
+    setupOnce(monitor: IMonitor): void;
+    /**
+     * 插件销毁
+     */
+    teardown(): void;
+    private _shouldIgnore;
+}
+
+export { XHRPlugin, type XHRPluginOptions };

package/dist/plugins/xhr.d.ts

@@ -0,0 +1,35 @@
+import { P as Plugin, I as IMonitor } from '../types-BGUJGEpp.js';
+
+/**
+ * XHR 插件 - 拦截 XMLHttpRequest
+ */
+
+interface XHRPluginOptions {
+    /** 包含的 URL 正则（白名单） */
+    includeUrls?: RegExp[];
+    /** 排除的 URL 正则（黑名单） */
+    excludeUrls?: RegExp[];
+}
+/**
+ * XHR 插件
+ * 基于 Proxy 代理 XMLHttpRequest 实例
+ */
+declare class XHRPlugin implements Plugin {
+    name: string;
+    priority: number;
+    private _monitor;
+    private _options;
+    private _platformAdapter;
+    constructor(options?: XHRPluginOptions);
+    /**
+     * 插件初始化
+     */
+    setupOnce(monitor: IMonitor): void;
+    /**
+     * 插件销毁
+     */
+    teardown(): void;
+    private _shouldIgnore;
+}
+
+export { XHRPlugin, type XHRPluginOptions };

package/dist/plugins/xhr.js

@@ -0,0 +1,2 @@
+export{a as XHRPlugin}from'../chunk-LKBNR7RI.js';//# sourceMappingURL=xhr.js.map
+//# sourceMappingURL=xhr.js.map

package/dist/plugins/xhr.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"xhr.js"}

package/dist/presets.cjs

@@ -0,0 +1,2 @@
+'use strict';var chunkZIKPTR2L_cjs=require('./chunk-ZIKPTR2L.cjs');Object.defineProperty(exports,"PRESETS",{enumerable:true,get:function(){return chunkZIKPTR2L_cjs.a}});Object.defineProperty(exports,"getPreset",{enumerable:true,get:function(){return chunkZIKPTR2L_cjs.b}});Object.defineProperty(exports,"mergePreset",{enumerable:true,get:function(){return chunkZIKPTR2L_cjs.c}});//# sourceMappingURL=presets.cjs.map
+//# sourceMappingURL=presets.cjs.map

package/dist/presets.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"presets.cjs"}

package/dist/presets.d.cts

@@ -0,0 +1,45 @@
+import { SamplingPluginOptions } from './plugins/sampling.cjs';
+import { TransportPluginOptions } from './plugins/transport.cjs';
+import './types-BGUJGEpp.cjs';
+
+/**
+ * 预设配置
+ *
+ * 提供三种预设：
+ * - development: 开发环境，即时发送，详细日志
+ * - production: 生产环境，批量发送，采样
+ * - minimal: 最小化，只采集错误
+ */
+
+/** 预设名称 */
+type MonitorPreset = 'development' | 'production' | 'minimal';
+/** 插件名称 */
+type PluginName = 'error' | 'performance' | 'fetch' | 'xhr' | 'session' | 'trace' | 'dedupe' | 'sampling';
+/** 预设配置内容 */
+interface PresetConfig {
+    /** 调试模式 */
+    debug: boolean;
+    /** 传输配置 */
+    transport: Partial<TransportPluginOptions>;
+    /** 采样配置 */
+    sampling: Partial<SamplingPluginOptions>;
+    /** 启用的插件 */
+    plugins: PluginName[];
+}
+/** 预设配置定义 */
+declare const PRESETS: Record<MonitorPreset, PresetConfig>;
+/**
+ * 获取预设配置
+ * @param preset - 预设名称
+ * @returns 预设配置
+ */
+declare function getPreset(preset: MonitorPreset): PresetConfig;
+/**
+ * 合并预设配置和用户配置
+ * @param preset - 预设配置
+ * @param overrides - 用户覆盖配置
+ * @returns 合并后的配置
+ */
+declare function mergePreset(preset: PresetConfig, overrides: Partial<PresetConfig>): PresetConfig;
+
+export { type MonitorPreset, PRESETS, type PluginName, type PresetConfig, getPreset, mergePreset };

package/dist/presets.d.ts

@@ -0,0 +1,45 @@
+import { SamplingPluginOptions } from './plugins/sampling.js';
+import { TransportPluginOptions } from './plugins/transport.js';
+import './types-BGUJGEpp.js';
+
+/**
+ * 预设配置
+ *
+ * 提供三种预设：
+ * - development: 开发环境，即时发送，详细日志
+ * - production: 生产环境，批量发送，采样
+ * - minimal: 最小化，只采集错误
+ */
+
+/** 预设名称 */
+type MonitorPreset = 'development' | 'production' | 'minimal';
+/** 插件名称 */
+type PluginName = 'error' | 'performance' | 'fetch' | 'xhr' | 'session' | 'trace' | 'dedupe' | 'sampling';
+/** 预设配置内容 */
+interface PresetConfig {
+    /** 调试模式 */
+    debug: boolean;
+    /** 传输配置 */
+    transport: Partial<TransportPluginOptions>;
+    /** 采样配置 */
+    sampling: Partial<SamplingPluginOptions>;
+    /** 启用的插件 */
+    plugins: PluginName[];
+}
+/** 预设配置定义 */
+declare const PRESETS: Record<MonitorPreset, PresetConfig>;
+/**
+ * 获取预设配置
+ * @param preset - 预设名称
+ * @returns 预设配置
+ */
+declare function getPreset(preset: MonitorPreset): PresetConfig;
+/**
+ * 合并预设配置和用户配置
+ * @param preset - 预设配置
+ * @param overrides - 用户覆盖配置
+ * @returns 合并后的配置
+ */
+declare function mergePreset(preset: PresetConfig, overrides: Partial<PresetConfig>): PresetConfig;
+
+export { type MonitorPreset, PRESETS, type PluginName, type PresetConfig, getPreset, mergePreset };

package/dist/presets.js

@@ -0,0 +1,2 @@
+export{a as PRESETS,b as getPreset,c as mergePreset}from'./chunk-GBREIA45.js';//# sourceMappingURL=presets.js.map
+//# sourceMappingURL=presets.js.map

package/dist/presets.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"names":[],"mappings":"","file":"presets.js"}