id-scanner-lib 1.3.2 → 1.5.0

package/dist/types/core/logger.d.ts

@@ -0,0 +1,277 @@
+/**
+ * @file 日志系统
+ * @description 提供统一的日志记录与管理功能
+ * @module core/logger
+ */
+/**
+ * 日志级别枚举
+ */
+export declare enum LogLevel {
+    DEBUG = "debug",
+    INFO = "info",
+    WARN = "warn",
+    ERROR = "error"
+}
+/**
+ * 日志条目接口
+ */
+export interface LogEntry {
+    /** 日志级别 */
+    level: LogLevel;
+    /** 日志标签 */
+    tag: string;
+    /** 日志消息 */
+    message: string;
+    /** 时间戳 */
+    timestamp: number;
+    /** 额外数据 */
+    data?: any;
+    /** 错误 */
+    error?: Error;
+}
+/**
+ * 日志处理器接口
+ */
+export interface LogHandler {
+    /**
+     * 处理日志条目
+     * @param entry 日志条目
+     */
+    handle(entry: LogEntry): void;
+}
+/**
+ * 控制台日志处理器
+ * 将日志输出到浏览器控制台
+ */
+export declare class ConsoleLogHandler implements LogHandler {
+    /**
+     * 处理日志条目
+     * @param entry 日志条目
+     */
+    handle(entry: LogEntry): void;
+}
+/**
+ * 内存日志处理器
+ * 将日志保存在内存中，用于后续分析或显示
+ */
+export declare class MemoryLogHandler implements LogHandler {
+    /** 日志条目数组 */
+    private entries;
+    /** 最大日志条目数 */
+    private maxEntries;
+    /**
+     * 构造函数
+     * @param maxEntries 最大日志条目数，默认为1000
+     */
+    constructor(maxEntries?: number);
+    /**
+     * 处理日志条目
+     * @param entry 日志条目
+     */
+    handle(entry: LogEntry): void;
+    /**
+     * 获取所有日志条目
+     */
+    getEntries(): LogEntry[];
+    /**
+     * 根据级别过滤日志条目
+     * @param level 日志级别
+     */
+    getEntriesByLevel(level: LogLevel): LogEntry[];
+    /**
+     * 根据标签过滤日志条目
+     * @param tag 日志标签
+     */
+    getEntriesByTag(tag: string): LogEntry[];
+    /**
+     * 清空日志
+     */
+    clear(): void;
+}
+/**
+ * 远程日志处理器
+ * 将日志发送到远程服务器
+ */
+export declare class RemoteLogHandler implements LogHandler {
+    /** 远程服务器URL */
+    private endpoint;
+    /** 批量发送的队列 */
+    private queue;
+    /** 最大队列长度 */
+    private maxQueueSize;
+    /** 发送间隔(毫秒) */
+    private flushInterval;
+    /** 定时发送的计时器ID */
+    private timerId;
+    /**
+     * 构造函数
+     * @param endpoint 远程服务器URL
+     * @param maxQueueSize 最大队列长度，默认为100
+     * @param flushInterval 发送间隔(毫秒)，默认为5000
+     */
+    constructor(endpoint: string, maxQueueSize?: number, flushInterval?: number);
+    /**
+     * 处理日志条目
+     * @param entry 日志条目
+     */
+    handle(entry: LogEntry): void;
+    /**
+     * 发送队列中的日志
+     */
+    flush(): void;
+    /**
+     * 开始定时发送
+     */
+    startTimer(): void;
+    /**
+     * 停止定时发送
+     */
+    stopTimer(): void;
+}
+/**
+ * 日志管理类
+ * 中央日志管理器，提供统一的日志记录接口
+ */
+export declare class Logger {
+    /** 单例实例 */
+    private static instance;
+    /** 配置管理器 */
+    private config;
+    /** 日志处理器 */
+    private handlers;
+    /** 默认标签 */
+    private defaultTag;
+    /** 日志级别 */
+    private logLevel;
+    /**
+     * 私有构造函数，防止直接实例化
+     */
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): Logger;
+    /**
+     * 添加日志处理器
+     * @param handler 日志处理器
+     */
+    addHandler(handler: LogHandler): void;
+    /**
+     * 移除日志处理器
+     * @param handler 要移除的处理器
+     */
+    removeHandler(handler: LogHandler): void;
+    /**
+     * 移除所有处理器
+     */
+    clearHandlers(): void;
+    /**
+     * 设置默认标签
+     * @param tag 默认标签
+     */
+    setDefaultTag(tag: string): void;
+    /**
+     * 记录调试级别日志
+     * @param tag 标签
+     * @param message 消息
+     * @param error 错误
+     */
+    debug(tag: string, message: string, error?: Error): void;
+    /**
+     * 记录信息级别日志
+     * @param tag 标签
+     * @param message 消息
+     * @param error 错误
+     */
+    info(tag: string, message: string, error?: Error): void;
+    /**
+     * 记录警告级别日志
+     * @param tag 标签
+     * @param message 消息
+     * @param error 错误
+     */
+    warn(tag: string, message: string, error?: Error): void;
+    /**
+     * 记录错误级别日志
+     * @param tag 标签
+     * @param message 消息
+     * @param error 错误
+     */
+    error(tag: string, message: string, error?: Error): void;
+    /**
+     * 创建标记了特定标签的日志记录器
+     * @param tag 标签
+     */
+    getTaggedLogger(tag: string): TaggedLogger;
+    /**
+     * 记录日志
+     * @param level 日志级别
+     * @param tag 标签
+     * @param message 消息
+     * @param error 错误
+     */
+    private log;
+    /**
+     * 控制台输出
+     * @param entry 日志条目
+     */
+    private consoleOutput;
+    /**
+     * 获取日志级别值
+     * @param level 日志级别
+     */
+    private getLevelValue;
+    /**
+     * 设置日志级别
+     * @param level 日志级别
+     */
+    setLevel(level: LogLevel | string): void;
+    /**
+     * 获取当前日志级别
+     * @returns 当前日志级别
+     */
+    getLevel(): LogLevel;
+}
+/**
+ * 带标签的日志记录器
+ * 提供特定标签的简易日志接口
+ */
+export declare class TaggedLogger {
+    /** 所属的主日志记录器 */
+    private logger;
+    /** 标签 */
+    private tag;
+    /**
+     * 构造函数
+     * @param logger 所属的主日志记录器
+     * @param tag 标签
+     */
+    constructor(logger: Logger, tag: string);
+    /**
+     * 记录调试级别日志
+     * @param message 消息
+     * @param error 错误
+     */
+    debug(message: string, error?: Error): void;
+    /**
+     * 记录信息级别日志
+     * @param message 消息
+     * @param error 错误
+     */
+    info(message: string, error?: Error): void;
+    /**
+     * 记录警告级别日志
+     * @param message 消息
+     * @param error 错误
+     */
+    warn(message: string, error?: Error): void;
+    /**
+     * 记录错误级别日志
+     * @param message 消息
+     * @param error 错误
+     */
+    error(message: string, error?: Error): void;
+}
+/**
+ * 日志级别枚举
+ */

package/dist/types/core/module-manager.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @file 模块管理器
+ * @description 统一管理库的各功能模块，提供模块的注册、初始化和卸载功能
+ * @module core/module-manager
+ */
+import { EventEmitter } from './event-emitter';
+/**
+ * 模块接口
+ * 所有功能模块必须实现此接口
+ */
+export interface Module {
+    /** 模块名称 */
+    name: string;
+    /** 模块版本 */
+    version: string;
+    /** 模块是否已初始化 */
+    isInitialized: boolean;
+    /** 初始化模块 */
+    initialize(): Promise<void>;
+    /** 释放模块资源 */
+    dispose(): Promise<void>;
+}
+/**
+ * 模块配置接口
+ */
+export interface ModuleOptions {
+    /** 是否启用该模块 */
+    enabled?: boolean;
+    /** 模块特定配置 */
+    [key: string]: any;
+}
+/**
+ * 模块管理器类
+ * 负责管理所有功能模块的生命周期
+ */
+export declare class ModuleManager extends EventEmitter {
+    private static instance;
+    private modules;
+    private logger;
+    private initialized;
+    /**
+     * 获取模块管理器单例
+     */
+    static getInstance(): ModuleManager;
+    /**
+     * 私有构造函数，确保单例模式
+     */
+    private constructor();
+    /**
+     * 注册模块
+     * @param module 要注册的模块
+     * @returns 模块管理器实例，支持链式调用
+     */
+    register(module: Module): ModuleManager;
+    /**
+     * 获取模块
+     * @param name 模块名称
+     * @returns 模块实例
+     */
+    getModule<T extends Module>(name: string): T | undefined;
+    /**
+     * 初始化所有注册的模块
+     */
+    initialize(): Promise<void>;
+    /**
+     * 卸载所有模块并释放资源
+     */
+    dispose(): Promise<void>;
+    /**
+     * 获取所有已注册的模块名称
+     */
+    getRegisteredModules(): string[];
+    /**
+     * 检查模块是否已注册
+     * @param name 模块名称
+     */
+    hasModule(name: string): boolean;
+}

package/dist/types/core/plugin-manager.d.ts

@@ -0,0 +1,158 @@
+/**
+ * @file 插件管理器
+ * @description 提供插件的注册、初始化和管理功能
+ * @module core/plugin-manager
+ */
+/// <reference types="node" />
+import { EventEmitter } from 'events';
+import { Logger } from './logger';
+import { ConfigManager } from './config';
+/**
+ * 插件优先级枚举
+ */
+export declare enum PluginPriority {
+    /** 高优先级，最先初始化和激活 */
+    HIGH = "high",
+    /** 中等优先级 */
+    NORMAL = "normal",
+    /** 低优先级，最后初始化和激活 */
+    LOW = "low"
+}
+/**
+ * 插件状态枚举
+ */
+export declare enum PluginStatus {
+    /** 已注册 */
+    REGISTERED = "registered",
+    /** 初始化中 */
+    INITIALIZING = "initializing",
+    /** 已初始化 */
+    INITIALIZED = "initialized",
+    /** 激活中 */
+    ACTIVATING = "activating",
+    /** 已激活 */
+    ACTIVE = "active",
+    /** 已停用 */
+    INACTIVE = "inactive",
+    /** 错误状态 */
+    ERROR = "error"
+}
+/**
+ * 插件接口
+ */
+export interface Plugin {
+    /** 插件ID */
+    id: string;
+    /** 插件名称 */
+    name: string;
+    /** 插件版本 */
+    version: string;
+    /** 插件描述 */
+    description?: string;
+    /** 插件优先级 */
+    priority?: PluginPriority;
+    /** 依赖的插件ID列表 */
+    dependencies?: string[];
+    /** 初始化方法 */
+    initialize?: (api: PluginAPI) => Promise<void>;
+    /** 激活方法 */
+    activate?: (api: PluginAPI) => Promise<void>;
+    /** 停用方法 */
+    deactivate?: (api: PluginAPI) => Promise<void>;
+}
+/**
+ * 插件API接口
+ * 提供给插件使用的API
+ */
+export interface PluginAPI {
+    /** 日志记录器 */
+    logger: Logger;
+    /** 配置管理器 */
+    config: ConfigManager;
+    /** 事件发射器 */
+    eventBus: EventEmitter;
+    /** 获取插件 */
+    getPlugin: (id: string) => Plugin | undefined;
+    /** 获取所有插件 */
+    getAllPlugins: () => Map<string, Plugin>;
+}
+/**
+ * 插件管理器
+ * 提供插件的注册、初始化和管理功能
+ */
+export declare class PluginManager extends EventEmitter {
+    /** 单例实例 */
+    private static instance;
+    /** 日志记录器 */
+    private logger;
+    /** 配置管理器 */
+    private config;
+    /** 插件映射表 */
+    private plugins;
+    /** 插件状态 */
+    private pluginStatus;
+    /** 插件API */
+    private pluginAPI;
+    /** 初始化状态 */
+    private initialized;
+    /**
+     * 私有构造函数
+     */
+    private constructor();
+    /**
+     * 获取单例实例
+     */
+    static getInstance(): PluginManager;
+    /**
+     * 初始化插件管理器
+     */
+    initialize(): Promise<void>;
+    /**
+     * 注册插件
+     * @param plugin 插件
+     */
+    registerPlugin(plugin: Plugin): void;
+    /**
+     * 卸载插件
+     * @param id 插件ID
+     */
+    unregisterPlugin(id: string): boolean;
+    /**
+     * 初始化插件
+     * @param id 插件ID
+     */
+    initializePlugin(id: string): Promise<boolean>;
+    /**
+     * 激活插件
+     * @param id 插件ID
+     */
+    activatePlugin(id: string): Promise<boolean>;
+    /**
+     * 停用插件
+     * @param id 插件ID
+     */
+    deactivatePlugin(id: string): Promise<boolean>;
+    /**
+     * 获取插件
+     * @param id 插件ID
+     */
+    getPlugin(id: string): Plugin | undefined;
+    /**
+     * 获取所有插件
+     */
+    getAllPlugins(): Map<string, Plugin>;
+    /**
+     * 获取插件状态
+     * @param id 插件ID
+     */
+    getPluginStatus(id: string): PluginStatus | undefined;
+    /**
+     * 按优先级获取插件
+     * @param priority 优先级
+     */
+    getPluginsByPriority(priority: PluginPriority): Plugin[];
+    /**
+     * 获取按优先级排序的所有插件
+     */
+    getSortedPlugins(): Plugin[];
+}