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

package/dist/src/core/platform-adapter.js

@@ -0,0 +1,244 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BasePlatformAdapter = void 0;
+const errors_1 = require("../types/errors");
+/**
+ * 平台适配器抽象基类
+ *
+ * 为不同操作系统提供统一的接口，子类需要实现具体的平台相关逻辑
+ */
+class BasePlatformAdapter {
+    constructor(platformName) {
+        this.platformName = platformName;
+        this.supportedFeatures = this.initializeSupportedFeatures();
+    }
+    /**
+     * 获取平台名称
+     */
+    getPlatform() {
+        return this.platformName;
+    }
+    /**
+     * 检查是否支持特定功能
+     */
+    isSupported(feature) {
+        const parts = feature.split('.');
+        if (parts.length !== 2) {
+            return false;
+        }
+        const [category, featureName] = parts;
+        const categoryFeatures = this.supportedFeatures[category];
+        if (!categoryFeatures) {
+            return false;
+        }
+        return categoryFeatures[featureName] === true;
+    }
+    /**
+     * 获取支持的功能列表
+     */
+    getSupportedFeatures() {
+        return { ...this.supportedFeatures };
+    }
+    // 受保护的辅助方法
+    /**
+     * 安全执行命令
+     */
+    async safeExecute(command, options) {
+        try {
+            return await this.executeCommand(command, options);
+        }
+        catch (error) {
+            // 返回失败的结果而不是抛出异常
+            return {
+                stdout: '',
+                stderr: error instanceof Error ? error.message : String(error),
+                exitCode: 1,
+                platform: this.platformName,
+                executionTime: 0,
+                command
+            };
+        }
+    }
+    /**
+     * 创建不支持功能的错误
+     */
+    createUnsupportedError(feature) {
+        return errors_1.MonitorError.createPlatformNotSupported(this.platformName, feature);
+    }
+    /**
+     * 创建命令执行失败错误
+     */
+    createCommandError(command, details) {
+        return errors_1.MonitorError.createCommandFailed(this.platformName, command, details);
+    }
+    /**
+     * 创建解析错误
+     */
+    createParseError(data, reason) {
+        return errors_1.MonitorError.createParseError(this.platformName, data, reason);
+    }
+    /**
+     * 验证命令执行结果
+     */
+    validateCommandResult(result, command) {
+        if (result.exitCode !== 0) {
+            throw this.createCommandError(command, {
+                exitCode: result.exitCode,
+                stderr: result.stderr,
+                stdout: result.stdout
+            });
+        }
+        if (!result.stdout || result.stdout.trim().length === 0) {
+            throw this.createCommandError(command, {
+                reason: 'Empty output',
+                stderr: result.stderr
+            });
+        }
+    }
+    /**
+     * 安全解析 JSON
+     */
+    safeParseJSON(data, fallback = null) {
+        try {
+            return JSON.parse(data);
+        }
+        catch (error) {
+            return fallback;
+        }
+    }
+    /**
+     * 安全解析数字
+     */
+    safeParseNumber(value, fallback = 0) {
+        if (typeof value === 'number') {
+            return isNaN(value) ? fallback : value;
+        }
+        const parsed = parseFloat(value);
+        return isNaN(parsed) ? fallback : parsed;
+    }
+    /**
+     * 安全解析整数
+     */
+    safeParseInt(value, fallback = 0, radix = 10) {
+        if (typeof value === 'number') {
+            return isNaN(value) ? fallback : Math.floor(value);
+        }
+        const parsed = parseInt(value, radix);
+        return isNaN(parsed) ? fallback : parsed;
+    }
+    /**
+     * 解析键值对格式的输出
+     */
+    parseKeyValueOutput(output, separator = ':') {
+        const result = {};
+        const lines = output.split('\n');
+        for (const line of lines) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            const separatorIndex = trimmed.indexOf(separator);
+            if (separatorIndex === -1)
+                continue;
+            const key = trimmed.substring(0, separatorIndex).trim();
+            const value = trimmed.substring(separatorIndex + separator.length).trim();
+            if (key && value) {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    /**
+     * 解析表格格式的输出
+     */
+    parseTableOutput(output, hasHeader = true) {
+        const lines = output.split('\n').map(line => line.trim()).filter(line => line);
+        if (lines.length === 0)
+            return [];
+        let dataLines = lines;
+        let headers = [];
+        if (hasHeader && lines.length > 0) {
+            headers = this.splitTableRow(lines[0]);
+            dataLines = lines.slice(1);
+        }
+        const result = [];
+        for (const line of dataLines) {
+            const values = this.splitTableRow(line);
+            if (values.length === 0)
+                continue;
+            const row = {};
+            if (headers.length > 0) {
+                // 使用表头作为键
+                for (let i = 0; i < Math.min(headers.length, values.length); i++) {
+                    row[headers[i]] = values[i];
+                }
+            }
+            else {
+                // 使用索引作为键
+                for (let i = 0; i < values.length; i++) {
+                    row[i.toString()] = values[i];
+                }
+            }
+            result.push(row);
+        }
+        return result;
+    }
+    /**
+     * 分割表格行
+     */
+    splitTableRow(row) {
+        // 支持多种分隔符：空格、制表符等
+        return row.split(/\s+/).filter(cell => cell.length > 0);
+    }
+    /**
+     * 字节单位转换
+     */
+    /**
+     * 将带单位的容量统一换算为字节，支持 SI 与二进制后缀
+     */
+    convertToBytes(value, unit) {
+        const num = typeof value === 'string' ? this.safeParseNumber(value) : value;
+        if (!unit) {
+            // 尝试从值中提取单位
+            if (typeof value === 'string') {
+                const match = value.match(/^([\d.]+)\s*([a-zA-Z]+)$/);
+                if (match) {
+                    return this.convertToBytes(match[1], match[2]);
+                }
+            }
+            return num;
+        }
+        const multipliers = {
+            'b': 1,
+            'byte': 1,
+            'bytes': 1,
+            'k': 1024,
+            'kb': 1024,
+            'kib': 1024,
+            'ki': 1024,
+            'kilobyte': 1024,
+            'kilobytes': 1024,
+            'm': 1024 * 1024,
+            'mb': 1024 * 1024,
+            'mib': 1024 * 1024,
+            'mi': 1024 * 1024,
+            'megabyte': 1024 * 1024,
+            'megabytes': 1024 * 1024,
+            'g': 1024 * 1024 * 1024,
+            'gb': 1024 * 1024 * 1024,
+            'gib': 1024 * 1024 * 1024,
+            'gi': 1024 * 1024 * 1024,
+            'gigabyte': 1024 * 1024 * 1024,
+            'gigabytes': 1024 * 1024 * 1024,
+            't': 1024 * 1024 * 1024 * 1024,
+            'tb': 1024 * 1024 * 1024 * 1024,
+            'tib': 1024 * 1024 * 1024 * 1024,
+            'ti': 1024 * 1024 * 1024 * 1024,
+            'terabyte': 1024 * 1024 * 1024 * 1024,
+            'terabytes': 1024 * 1024 * 1024 * 1024
+        };
+        const multiplier = multipliers[unit.toLowerCase()] || 1;
+        return num * multiplier;
+    }
+}
+exports.BasePlatformAdapter = BasePlatformAdapter;
+//# sourceMappingURL=platform-adapter.js.map

package/dist/src/core/platform-adapter.js.map

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

package/dist/src/index.d.ts

@@ -0,0 +1,205 @@
+/**
+ * node-os-utils v2.0.0
+ *
+ * 现代化的跨平台操作系统监控工具库
+ * TypeScript 重构版本，提供全面的系统监控功能
+ */
+import { AdapterFactory } from './adapters/adapter-factory';
+import { CacheManager } from './core/cache-manager';
+import { CPUMonitor } from './monitors/cpu-monitor';
+import { MemoryMonitor } from './monitors/memory-monitor';
+import { DiskMonitor } from './monitors/disk-monitor';
+import { NetworkMonitor } from './monitors/network-monitor';
+import { ProcessMonitor } from './monitors/process-monitor';
+import { SystemMonitor } from './monitors/system-monitor';
+import { GlobalConfig } from './types';
+/**
+ * OSUtils 主类
+ *
+ * 提供统一的系统监控 API，自动处理平台适配和缓存管理
+ */
+export declare class OSUtils {
+    private adapter;
+    private cache;
+    private config;
+    private _cpu?;
+    private _memory?;
+    private _disk?;
+    private _network?;
+    private _process?;
+    private _system?;
+    constructor(config?: Partial<GlobalConfig>);
+    /**
+     * CPU 监控器
+     */
+    get cpu(): CPUMonitor;
+    /**
+     * 内存监控器
+     */
+    get memory(): MemoryMonitor;
+    /**
+     * 磁盘监控器
+     */
+    get disk(): DiskMonitor;
+    /**
+     * 网络监控器
+     */
+    get network(): NetworkMonitor;
+    /**
+     * 进程监控器
+     */
+    get process(): ProcessMonitor;
+    /**
+     * 系统监控器
+     */
+    get system(): SystemMonitor;
+    /**
+     * 获取平台信息
+     */
+    getPlatformInfo(): {
+        platform: string;
+        arch: string;
+        version: string;
+        supported: boolean;
+    };
+    /**
+     * 获取支持的平台列表
+     */
+    getSupportedPlatforms(): string[];
+    /**
+     * 检查平台能力
+     */
+    checkPlatformCapabilities(): Promise<{
+        platform: string;
+        supported: boolean;
+        capabilities: {
+            commands: string[];
+            files: string[];
+            features: string[];
+        };
+        issues: string[];
+    }>;
+    /**
+     * 获取缓存统计信息
+     */
+    getCacheStats(): import("./core/cache-manager").CacheStats;
+    /**
+     * 清理缓存
+     */
+    clearCache(): this;
+    /**
+     * 配置缓存
+     */
+    configureCache(options: {
+        enabled?: boolean;
+        maxSize?: number;
+        defaultTTL?: number;
+    }): this;
+    /**
+     * 配置调试模式
+     */
+    setDebug(enabled: boolean): this;
+    /**
+     * 获取系统总览信息
+     */
+    overview(): Promise<{
+        platform: string;
+        timestamp: number;
+        system: import("./types").SystemInfo | null;
+        cpu: {
+            usage: number | null;
+        };
+        memory: {
+            total: string;
+            used: string;
+            available: string;
+            usagePercentage: number;
+            swap: {
+                total: string;
+                used: string;
+                usagePercentage: number;
+            };
+        } | null;
+        disk: {
+            total: import("./types").DataSize;
+            used: import("./types").DataSize;
+            available: import("./types").DataSize;
+            usagePercentage: number;
+            disks: number;
+        } | null;
+        network: {
+            interfaces: number;
+            activeInterfaces: number;
+            totalRxBytes: import("./types").DataSize;
+            totalTxBytes: import("./types").DataSize;
+            totalPackets: number;
+            totalErrors: number;
+        } | null;
+        processes: {
+            total: number;
+            running: number;
+            sleeping: number;
+            waiting: number;
+            zombie: number;
+            stopped: number;
+            unknown: number;
+            totalCpuUsage: number;
+            totalMemoryUsage: import("./types").DataSize;
+        } | null;
+    }>;
+    /**
+     * 健康检查
+     */
+    healthCheck(): Promise<{
+        status: "healthy";
+        issues: string[];
+        timestamp: number;
+        details: {
+            system: {
+                status: "critical" | "warning" | "healthy";
+                checks: {
+                    load: boolean;
+                    uptime: boolean;
+                    services: boolean;
+                    resources: boolean;
+                };
+                issues: string[];
+                score: number;
+            } | null;
+            disk: {
+                status: "critical" | "warning" | "healthy";
+                issues: string[];
+                checks: {
+                    spaceUsage: boolean;
+                    mountStatus: boolean;
+                    ioErrors: boolean;
+                };
+            } | null;
+            network: {
+                status: "critical" | "warning" | "healthy";
+                issues: string[];
+                checks: {
+                    interfaceStatus: boolean;
+                    connectivity: boolean;
+                    performance: boolean;
+                };
+            } | null;
+        };
+    }>;
+    /**
+     * 销毁实例，清理资源
+     */
+    destroy(): void;
+    private resetMonitors;
+}
+/**
+ * 创建 OSUtils 实例的工厂函数
+ */
+export declare function createOSUtils(config?: Partial<GlobalConfig>): OSUtils;
+export * from './types';
+export { CPUMonitor, MemoryMonitor, DiskMonitor, NetworkMonitor, ProcessMonitor, SystemMonitor };
+export { AdapterFactory, CacheManager };
+export default OSUtils;
+export declare const version: string;
+export declare const name: string;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAC1D,OAAO,EAAE,WAAW,EAAE,MAAM,yBAAyB,CAAC;AACtD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAG1D,OAAO,EACL,YAAY,EAEb,MAAM,SAAS,CAAC;AAEjB;;;;GAIG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,OAAO,CAAkB;IACjC,OAAO,CAAC,KAAK,CAAe;IAC5B,OAAO,CAAC,MAAM,CAAe;IAG7B,OAAO,CAAC,IAAI,CAAC,CAAa;IAC1B,OAAO,CAAC,OAAO,CAAC,CAAgB;IAChC,OAAO,CAAC,KAAK,CAAC,CAAc;IAC5B,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,QAAQ,CAAC,CAAiB;IAClC,OAAO,CAAC,OAAO,CAAC,CAAgB;gBAEpB,MAAM,GAAE,OAAO,CAAC,YAAY,CAAM;IA2B9C;;OAEG;IACH,IAAI,GAAG,IAAI,UAAU,CAKpB;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,aAAa,CAK1B;IAED;;OAEG;IACH,IAAI,IAAI,IAAI,WAAW,CAKtB;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,cAAc,CAK5B;IAED;;OAEG;IACH,IAAI,OAAO,IAAI,cAAc,CAK5B;IAED;;OAEG;IACH,IAAI,MAAM,IAAI,aAAa,CAK1B;IAED;;OAEG;IACH,eAAe;;;;;;IAIf;;OAEG;IACH,qBAAqB;IAIrB;;OAEG;IACG,yBAAyB;;;;;;;;;;IAI/B;;OAEG;IACH,aAAa;IAIb;;OAEG;IACH,UAAU;IAKV;;OAEG;IACH,cAAc,CAAC,OAAO,EAAE;QACtB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,MAAM,CAAC;QACjB,UAAU,CAAC,EAAE,MAAM,CAAC;KACrB;IAiCD;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO;IAKzB;;OAEG;IACG,QAAQ;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqCd;;OAEG;IACG,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2CjB;;OAEG;IACH,OAAO;IASP,OAAO,CAAC,aAAa;CA0BtB;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,GAAG,OAAO,CAErE;AAGD,cAAc,SAAS,CAAC;AAGxB,OAAO,EACL,UAAU,EACV,aAAa,EACb,WAAW,EACX,cAAc,EACd,cAAc,EACd,aAAa,EACd,CAAC;AAGF,OAAO,EACL,cAAc,EACd,YAAY,EACb,CAAC;AAGF,eAAe,OAAO,CAAC;AAGvB,eAAO,MAAM,OAAO,QAAsB,CAAC;AAC3C,eAAO,MAAM,IAAI,QAAmB,CAAC"}