node-os-utils 1.3.7 → 2.0.1-beta.2

package/dist/src/core/base-monitor.d.ts

@@ -0,0 +1,107 @@
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { MonitorResult, MonitorConfig, MonitorSubscription } from '../types';
+import { PlatformAdapter } from '../types/platform';
+import { CacheManager } from './cache-manager';
+import { MonitorError } from '../types/errors';
+/**
+ * 基础监控器抽象类
+ *
+ * 提供所有监控器的通用功能，包括缓存、事件、配置管理等
+ */
+export declare abstract class BaseMonitor<T> extends EventEmitter {
+    protected config: MonitorConfig;
+    protected adapter: PlatformAdapter;
+    protected cache: CacheManager;
+    protected subscriptions: Set<MonitorSubscription>;
+    constructor(adapter: PlatformAdapter, config?: MonitorConfig, cache?: CacheManager);
+    /**
+     * 获取监控信息
+     */
+    abstract info(): Promise<MonitorResult<T>>;
+    /**
+     * 获取默认配置
+     */
+    protected abstract getDefaultConfig(): MonitorConfig;
+    /**
+     * 配置监控器
+     */
+    withConfig(config: Partial<MonitorConfig>): this;
+    /**
+     * 配置缓存
+     */
+    withCaching(enabled: boolean, ttl?: number): this;
+    /**
+     * 实时监控
+     */
+    monitor(interval: number, callback: (data: T) => void): MonitorSubscription;
+    /**
+     * 获取配置
+     */
+    getConfig(): MonitorConfig;
+    /**
+     * 获取缓存统计
+     */
+    getCacheStats(): import("./cache-manager").CacheStats | null;
+    /**
+     * 清空缓存
+     */
+    clearCache(): void;
+    /**
+     * 停止所有监控订阅
+     */
+    stopAllMonitoring(): void;
+    /**
+     * 获取活跃订阅数量
+     */
+    getActiveSubscriptions(): number;
+    /**
+     * 销毁监控器
+     */
+    destroy(): void;
+    /**
+     * 获取缓存结果
+     */
+    protected getCachedResult<R>(key: string): R | undefined;
+    /**
+     * 设置缓存结果
+     */
+    protected setCachedResult<R>(key: string, result: R, ttl?: number): void;
+    /**
+     * 创建成功结果
+     */
+    protected createSuccessResult<R>(data: R, cached?: boolean): MonitorResult<R>;
+    /**
+     * 创建失败结果
+     */
+    protected createErrorResult<R>(error: MonitorError): MonitorResult<R>;
+    /**
+     * 处理错误并转换为 MonitorResult
+     */
+    protected handleError<R>(error: any): MonitorResult<R>;
+    /**
+     * 执行带缓存的操作
+     */
+    protected executeWithCache<R>(cacheKey: string, operation: () => Promise<R>, ttl?: number): Promise<MonitorResult<R>>;
+    /**
+     * 验证平台支持
+     */
+    protected validatePlatformSupport(feature: string): void;
+    /**
+     * 创建不支持功能的错误
+     */
+    protected createUnsupportedError(feature: string): MonitorError;
+    /**
+     * 安全执行异步操作
+     */
+    protected safeExecute<R>(operation: () => Promise<R>, fallback?: R): Promise<R>;
+    /**
+     * 创建超时 Promise
+     */
+    protected createTimeoutPromise<R>(timeoutMs: number, errorMessage?: string): Promise<R>;
+    /**
+     * 带超时执行操作
+     */
+    protected executeWithTimeout<R>(operation: () => Promise<R>, timeoutMs?: number): Promise<R>;
+}
+//# sourceMappingURL=base-monitor.d.ts.map

package/dist/src/core/base-monitor.d.ts.map

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

package/dist/src/core/base-monitor.js

@@ -0,0 +1,312 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseMonitor = void 0;
+const events_1 = require("events");
+const cache_manager_1 = require("./cache-manager");
+const errors_1 = require("../types/errors");
+/**
+ * 监控订阅实现
+ */
+class MonitorSubscriptionImpl {
+    constructor(callback, interval, monitorFn, errorHandler) {
+        this.callback = callback;
+        this.interval = interval;
+        this.monitorFn = monitorFn;
+        this.errorHandler = errorHandler;
+        this.active = true;
+        this.paused = false;
+        this.start();
+    }
+    unsubscribe() {
+        this.stop();
+        this.active = false;
+    }
+    isActive() {
+        return this.active;
+    }
+    pause() {
+        if (this.active && !this.paused) {
+            this.stop();
+            this.paused = true;
+        }
+    }
+    resume() {
+        if (this.active && this.paused) {
+            this.start();
+            this.paused = false;
+        }
+    }
+    getStatus() {
+        if (!this.active)
+            return 'stopped';
+        return this.paused ? 'paused' : 'active';
+    }
+    start() {
+        if (this.timer) {
+            clearInterval(this.timer);
+        }
+        this.timer = setInterval(async () => {
+            try {
+                const result = await this.monitorFn();
+                this.callback(result);
+            }
+            catch (error) {
+                if (this.errorHandler) {
+                    this.errorHandler(error);
+                }
+            }
+        }, this.interval);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = undefined;
+        }
+    }
+}
+/**
+ * 基础监控器抽象类
+ *
+ * 提供所有监控器的通用功能，包括缓存、事件、配置管理等
+ */
+class BaseMonitor extends events_1.EventEmitter {
+    constructor(adapter, config = {}, cache) {
+        super();
+        this.subscriptions = new Set();
+        this.adapter = adapter;
+        this.config = { ...this.getDefaultConfig(), ...config };
+        this.cache = cache || new cache_manager_1.CacheManager({
+            defaultTTL: this.config.cacheTTL || 5000,
+            enabled: this.config.cacheEnabled !== false
+        });
+        // 设置最大监听器数量
+        this.setMaxListeners(100);
+    }
+    // 通用方法
+    /**
+     * 配置监控器
+     */
+    withConfig(config) {
+        this.config = { ...this.config, ...config };
+        // 如果缓存配置发生变化，更新缓存管理器
+        if (config.cacheTTL && this.cache) {
+            this.cache.setDefaultTTL(config.cacheTTL);
+        }
+        return this;
+    }
+    /**
+     * 配置缓存
+     */
+    withCaching(enabled, ttl) {
+        this.config.cacheEnabled = enabled;
+        if (ttl !== undefined) {
+            this.config.cacheTTL = ttl;
+            if (this.cache) {
+                this.cache.setDefaultTTL(ttl);
+            }
+        }
+        return this;
+    }
+    /**
+     * 实时监控
+     */
+    monitor(interval, callback) {
+        const monitorFn = async () => {
+            const result = await this.info();
+            if (result.success) {
+                return result.data;
+            }
+            else {
+                throw result.error;
+            }
+        };
+        const errorHandler = (error) => {
+            this.emit('error', error);
+        };
+        const subscription = new MonitorSubscriptionImpl(callback, interval, monitorFn, errorHandler);
+        this.subscriptions.add(subscription);
+        // 当订阅被取消时，从集合中移除
+        const originalUnsubscribe = subscription.unsubscribe.bind(subscription);
+        subscription.unsubscribe = () => {
+            originalUnsubscribe();
+            this.subscriptions.delete(subscription);
+        };
+        return subscription;
+    }
+    /**
+     * 获取配置
+     */
+    getConfig() {
+        return { ...this.config };
+    }
+    /**
+     * 获取缓存统计
+     */
+    getCacheStats() {
+        return this.cache ? this.cache.getStats() : null;
+    }
+    /**
+     * 清空缓存
+     */
+    clearCache() {
+        if (this.cache) {
+            this.cache.clear();
+        }
+    }
+    /**
+     * 停止所有监控订阅
+     */
+    stopAllMonitoring() {
+        for (const subscription of this.subscriptions) {
+            subscription.unsubscribe();
+        }
+        this.subscriptions.clear();
+    }
+    /**
+     * 获取活跃订阅数量
+     */
+    getActiveSubscriptions() {
+        return Array.from(this.subscriptions).filter(sub => sub.isActive()).length;
+    }
+    /**
+     * 销毁监控器
+     */
+    destroy() {
+        this.stopAllMonitoring();
+        if (this.cache) {
+            this.cache.destroy();
+        }
+        this.removeAllListeners();
+    }
+    // 受保护的辅助方法
+    /**
+     * 获取缓存结果
+     */
+    getCachedResult(key) {
+        if (!this.config.cacheEnabled || !this.cache) {
+            return undefined;
+        }
+        return this.cache.get(key);
+    }
+    /**
+     * 设置缓存结果
+     */
+    setCachedResult(key, result, ttl) {
+        if (!this.config.cacheEnabled || !this.cache) {
+            return;
+        }
+        this.cache.set(key, result, ttl);
+    }
+    /**
+     * 创建成功结果
+     */
+    createSuccessResult(data, cached = false) {
+        return {
+            success: true,
+            data,
+            timestamp: Date.now(),
+            cached,
+            platform: this.adapter.getPlatform()
+        };
+    }
+    /**
+     * 创建失败结果
+     */
+    createErrorResult(error) {
+        return {
+            success: false,
+            error,
+            platform: this.adapter.getPlatform(),
+            timestamp: Date.now()
+        };
+    }
+    /**
+     * 处理错误并转换为 MonitorResult
+     */
+    handleError(error) {
+        let monitorError;
+        if (error instanceof errors_1.MonitorError) {
+            monitorError = error;
+        }
+        else if (error instanceof Error) {
+            monitorError = new errors_1.MonitorError(error.message, errors_1.ErrorCode.COMMAND_FAILED, this.adapter.getPlatform(), { originalError: error });
+        }
+        else {
+            monitorError = new errors_1.MonitorError('Unknown error occurred', errors_1.ErrorCode.COMMAND_FAILED, this.adapter.getPlatform(), { error });
+        }
+        // 发射错误事件
+        this.emit('error', monitorError);
+        return this.createErrorResult(monitorError);
+    }
+    /**
+     * 执行带缓存的操作
+     */
+    async executeWithCache(cacheKey, operation, ttl) {
+        try {
+            // 尝试从缓存获取
+            const cached = this.getCachedResult(cacheKey);
+            if (cached !== undefined) {
+                return this.createSuccessResult(cached, true);
+            }
+            // 执行操作
+            const result = await operation();
+            // 缓存结果
+            this.setCachedResult(cacheKey, result, ttl);
+            return this.createSuccessResult(result, false);
+        }
+        catch (error) {
+            return this.handleError(error);
+        }
+    }
+    /**
+     * 验证平台支持
+     */
+    validatePlatformSupport(feature) {
+        if (!this.adapter.isSupported(feature)) {
+            throw errors_1.MonitorError.createPlatformNotSupported(this.adapter.getPlatform(), feature);
+        }
+    }
+    /**
+     * 创建不支持功能的错误
+     */
+    createUnsupportedError(feature) {
+        return errors_1.MonitorError.createPlatformNotSupported(this.adapter.getPlatform(), feature);
+    }
+    /**
+     * 安全执行异步操作
+     */
+    async safeExecute(operation, fallback) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            if (fallback !== undefined) {
+                return fallback;
+            }
+            throw error;
+        }
+    }
+    /**
+     * 创建超时 Promise
+     */
+    createTimeoutPromise(timeoutMs, errorMessage) {
+        return new Promise((_, reject) => {
+            setTimeout(() => {
+                const error = new errors_1.MonitorError(errorMessage || `Operation timed out after ${timeoutMs}ms`, errors_1.ErrorCode.TIMEOUT, this.adapter.getPlatform(), { timeout: timeoutMs });
+                reject(error);
+            }, timeoutMs);
+        });
+    }
+    /**
+     * 带超时执行操作
+     */
+    async executeWithTimeout(operation, timeoutMs) {
+        const timeout = timeoutMs || this.config.timeout || 10000;
+        return Promise.race([
+            operation(),
+            this.createTimeoutPromise(timeout)
+        ]);
+    }
+}
+exports.BaseMonitor = BaseMonitor;
+//# sourceMappingURL=base-monitor.js.map

package/dist/src/core/base-monitor.js.map

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

package/dist/src/core/cache-manager.d.ts

@@ -0,0 +1,157 @@
+/**
+ * 缓存统计信息
+ */
+export interface CacheStats {
+    /**
+     * 缓存项数量
+     */
+    size: number;
+    /**
+     * 缓存命中次数
+     */
+    hits: number;
+    /**
+     * 缓存未命中次数
+     */
+    misses: number;
+    /**
+     * 命中率
+     */
+    hitRate: number;
+    /**
+     * 总内存使用（估算）
+     */
+    memoryUsage: number;
+    /**
+     * 过期清理次数
+     */
+    evictions: number;
+    /**
+     * 最大缓存大小
+     */
+    maxSize: number;
+}
+/**
+ * 缓存管理器配置
+ */
+export interface CacheManagerConfig {
+    defaultTTL?: number;
+    maxSize?: number;
+    cleanupInterval?: number;
+    enabled?: boolean;
+}
+/**
+ * 缓存管理器
+ *
+ * 负责管理监控数据的缓存，提高性能并减少系统调用
+ */
+export declare class CacheManager {
+    private cache;
+    private defaultTTL;
+    private maxSize;
+    private stats;
+    private cleanupTimer?;
+    private cleanupInterval;
+    private enabled;
+    constructor(config?: CacheManagerConfig);
+    /**
+     * 获取缓存值
+     */
+    get<T>(key: string): T | undefined;
+    /**
+     * 设置缓存值
+     */
+    set<T>(key: string, value: T, ttl?: number): void;
+    /**
+     * 删除缓存项
+     */
+    delete(key: string): boolean;
+    /**
+     * 清空所有缓存
+     */
+    clear(): void;
+    /**
+     * 检查是否存在缓存项
+     */
+    has(key: string): boolean;
+    /**
+     * 获取缓存大小
+     */
+    size(): number;
+    /**
+     * 获取缓存统计信息
+     */
+    getStats(): CacheStats;
+    /**
+     * 重置统计信息
+     */
+    resetStats(): void;
+    /**
+     * 获取所有缓存键
+     */
+    keys(): string[];
+    /**
+     * 获取缓存项的详细信息
+     */
+    getItemInfo(key: string): {
+        exists: boolean;
+        created?: number;
+        expiry?: number;
+        accessCount?: number;
+        lastAccessed?: number;
+        ttl?: number;
+    };
+    /**
+     * 设置默认 TTL
+     */
+    setDefaultTTL(ttl: number): void;
+    /**
+     * 获取默认 TTL
+     */
+    getDefaultTTL(): number;
+    /**
+     * 启用缓存
+     */
+    enable(): void;
+    /**
+     * 禁用缓存
+     */
+    disable(): void;
+    /**
+     * 检查缓存是否启用
+     */
+    isEnabled(): boolean;
+    /**
+     * 关闭缓存管理器
+     */
+    destroy(): void;
+    /**
+     * 启动定期清理
+     */
+    private startCleanup;
+    /**
+     * 停止定期清理
+     */
+    private stopCleanup;
+    /**
+     * 清理过期项
+     */
+    private cleanup;
+    /**
+     * LRU 淘汰策略
+     */
+    private evictLRU;
+    /**
+     * 更新统计信息
+     */
+    private updateStats;
+    /**
+     * 更新命中率
+     */
+    private updateHitRate;
+    /**
+     * 估算内存使用量
+     */
+    private estimateMemoryUsage;
+}
+//# sourceMappingURL=cache-manager.d.ts.map

package/dist/src/core/cache-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cache-manager.d.ts","sourceRoot":"","sources":["../../../src/core/cache-manager.ts"],"names":[],"mappings":"AA8BA;;GAEG;AACH,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IAEb;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IAEf;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;IAEhB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IAEpB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;;;GAIG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,KAAK,CAAqC;IAClD,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,YAAY,CAAC,CAAiB;IACtC,OAAO,CAAC,eAAe,CAAS;IAChC,OAAO,CAAC,OAAO,CAAiB;gBAEpB,MAAM,GAAE,kBAAuB;IAqB3C;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC,GAAG,SAAS;IAiClC;;OAEG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,GAAG,CAAC,EAAE,MAAM,GAAG,IAAI;IAyBjD;;OAEG;IACH,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAQ5B;;OAEG;IACH,KAAK,IAAI,IAAI;IAOb;;OAEG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAqBzB;;OAEG;IACH,IAAI,IAAI,MAAM;IAId;;OAEG;IACH,QAAQ,IAAI,UAAU;IAItB;;OAEG;IACH,UAAU,IAAI,IAAI;IAYlB;;OAEG;IACH,IAAI,IAAI,MAAM,EAAE;IAIhB;;OAEG;IACH,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG;QACxB,MAAM,EAAE,OAAO,CAAC;QAChB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,GAAG,CAAC,EAAE,MAAM,CAAC;KACd;IAiBD;;OAEG;IACH,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAIhC;;OAEG;IACH,aAAa,IAAI,MAAM;IAIvB;;OAEG;IACH,MAAM,IAAI,IAAI;IAKd;;OAEG;IACH,OAAO,IAAI,IAAI;IAMf;;OAEG;IACH,SAAS,IAAI,OAAO;IAIpB;;OAEG;IACH,OAAO,IAAI,IAAI;IAKf;;OAEG;IACH,OAAO,CAAC,YAAY;IAepB;;OAEG;IACH,OAAO,CAAC,WAAW;IAOnB;;OAEG;IACH,OAAO,CAAC,OAAO;IAuBf;;OAEG;IACH,OAAO,CAAC,QAAQ;IAkBhB;;OAEG;IACH,OAAO,CAAC,WAAW;IAMnB;;OAEG;IACH,OAAO,CAAC,aAAa;IAKrB;;OAEG;IACH,OAAO,CAAC,mBAAmB;CAiB5B"}