id-scanner-lib 1.5.0 → 1.6.2

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

@@ -1,246 +0,0 @@
-/**
- * @file 资源管理器
- * @description 提供资源加载、缓存和释放功能
- * @module core/resource-manager
- */
-import { EventEmitter } from './event-emitter';
-import { Result } from './result';
-/**
- * 资源类型枚举
- */
-export declare enum ResourceType {
-    MODEL = "model",// 模型文件
-    WASM = "wasm",// WebAssembly文件
-    IMAGE = "image",// 图片文件
-    JSON = "json",// JSON文件
-    TEXT = "text",// 文本文件
-    ARRAYBUFFER = "buffer",// 二进制数据
-    WORKER = "worker",// Web Worker脚本
-    OTHER = "other"
-}
-/**
- * 资源接口
- */
-export interface Resource<T = any> {
-    /** 资源ID */
-    id: string;
-    /** 资源类型 */
-    type: ResourceType;
-    /** 资源URL或数据 */
-    url: string;
-    /** 是否已加载 */
-    loaded: boolean;
-    /** 加载的数据 */
-    data?: T;
-    /** 上次使用时间戳 */
-    lastUsed: number;
-    /** 是否为永久资源（不自动释放） */
-    permanent: boolean;
-    /** 获取资源大小（如果可计算） */
-    getSize(): number;
-}
-/**
- * 资源加载选项
- */
-export interface ResourceLoadOptions {
-    /** 是否缓存 */
-    cache?: boolean;
-    /** 是否为永久资源（不自动释放） */
-    permanent?: boolean;
-    /** 资源类型（自动推断） */
-    type?: ResourceType;
-    /** 加载超时(ms) */
-    timeout?: number;
-    /** 是否替换现有资源 */
-    forceReload?: boolean;
-    /** 是否使用凭证 */
-    credentials?: RequestCredentials;
-    /** 自定义请求头 */
-    headers?: Record<string, string>;
-}
-/**
- * 资源统计信息
- */
-export interface ResourceStats {
-    /** 总资源数 */
-    totalCount: number;
-    /** 总内存使用(字节) */
-    totalSize: number;
-    /** 各类型资源数 */
-    byType: Record<ResourceType, number>;
-    /** 各类型资源大小(字节) */
-    sizeByType: Record<ResourceType, number>;
-}
-/**
- * 资源管理器事件
- */
-export declare enum ResourceManagerEvent {
-    /** 资源加载开始 */
-    LOAD_START = "resource:load:start",
-    /** 资源加载成功 */
-    LOAD_SUCCESS = "resource:load:success",
-    /** 资源加载失败 */
-    LOAD_ERROR = "resource:load:error",
-    /** 资源加载进度 */
-    LOAD_PROGRESS = "resource:load:progress",
-    /** 资源被释放 */
-    RESOURCE_RELEASED = "resource:released",
-    /** 资源统计更新 */
-    STATS_UPDATED = "resource:stats:updated"
-}
-/**
- * 资源管理器
- * 提供统一的资源加载、缓存和管理功能
- */
-export declare class ResourceManager extends EventEmitter {
-    /** 单例实例 */
-    private static instance;
-    /** 资源映射表 */
-    private resources;
-    /** 配置管理器 */
-    private config;
-    /** 日志记录器 */
-    private logger;
-    /** 缓存清理计时器ID */
-    private cleanupTimerId;
-    /** 默认基础路径 */
-    private basePath;
-    /** 加载中的资源请求 */
-    private pendingRequests;
-    private initialized;
-    /**
-     * 私有构造函数
-     */
-    private constructor();
-    /**
-     * 获取单例实例
-     */
-    static getInstance(): ResourceManager;
-    /**
-     * 设置基础路径
-     * @param path 基础路径
-     */
-    setBasePath(path: string): void;
-    /**
-     * 获取资源完整URL
-     */
-    private getFullUrl;
-    /**
-     * 从URL推断资源类型
-     */
-    private inferResourceType;
-    /**
-     * 加载资源
-     * @param id 资源ID
-     * @param url 资源URL
-     * @param options 加载选项
-     */
-    load<T = any>(id: string, url: string, options?: ResourceLoadOptions): Promise<Result<T>>;
-    /**
-     * 加载图片资源
-     */
-    private loadImage;
-    /**
-     * 加载JSON资源
-     */
-    private loadJson;
-    /**
-     * 加载文本资源
-     */
-    private loadText;
-    /**
-     * 加载二进制数据
-     */
-    private loadArrayBuffer;
-    /**
-     * 加载WebAssembly模块
-     */
-    private loadWasm;
-    /**
-     * 加载通用资源
-     */
-    private loadGeneric;
-    /**
-     * 预加载多个资源
-     * @param resources 资源配置数组，每项包含id和url
-     */
-    preload(resources: Array<{
-        id: string;
-        url: string;
-        options?: ResourceLoadOptions;
-    }>): Promise<Result<Record<string, any>>>;
-    /**
-     * 获取资源
-     * @param id 资源ID
-     */
-    get<T = any>(id: string): T | undefined;
-    /**
-     * 检查资源是否存在
-     * @param id 资源ID
-     */
-    has(id: string): boolean;
-    /**
-     * 获取资源
-     * 如果不存在，则使用工厂函数创建并缓存
-     *
-     * @param id 资源ID
-     * @param factory 资源工厂函数
-     * @param type 资源类型
-     * @param permanent 是否永久保留
-     */
-    getOrCreate<T = any>(id: string, factory: () => T | Promise<T>, type?: ResourceType, permanent?: boolean): Promise<T>;
-    /**
-     * 释放资源
-     * @param id 资源ID
-     */
-    release(id: string): boolean;
-    /**
-     * 释放资源组
-     * @param pattern 资源ID匹配模式，可以是字符串前缀或正则表达式
-     */
-    releaseGroup(pattern: string | RegExp): number;
-    /**
-     * 释放所有非永久资源
-     */
-    releaseAll(): number;
-    /**
-     * 释放过期资源
-     * @param maxAge 最大闲置时间(毫秒)
-     */
-    releaseExpired(maxAge: number): number;
-    /**
-     * 计算资源大小
-     * @param data 资源数据
-     * @param type 资源类型
-     */
-    private calculateResourceSize;
-    /**
-     * 清理特定资源
-     * @param resource 资源对象
-     */
-    private cleanupResource;
-    /**
-     * 设置资源清理定时器
-     */
-    private setupCleanupTimer;
-    /**
-     * 获取资源统计信息
-     */
-    getStats(): ResourceStats;
-    /**
-     * 更新并发布资源统计信息
-     */
-    private updateStats;
-    /**
-     * 初始化资源管理器
-     * @param options 初始化选项
-     */
-    initialize(options?: {
-        basePath?: string;
-        preloadResources?: Array<{
-            id: string;
-            url: string;
-            type?: ResourceType;
-        }>;
-    }): Promise<void>;
-}

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

@@ -1,83 +0,0 @@
-/**
- * @file 结果包装类
- * @description 提供统一的操作结果封装
- * @module core/result
- */
-/**
- * 结果类型
- * 用于封装操作的成功或失败结果
- */
-export declare class Result<T = any> {
-    /** 结果数据 */
-    private _data?;
-    /** 错误对象 */
-    private _error?;
-    /** 是否成功 */
-    private _success;
-    /** 额外元数据 */
-    private _meta?;
-    /**
-     * 构造函数
-     * @param success 是否成功
-     * @param data 结果数据
-     * @param error 错误对象
-     * @param meta 元数据
-     */
-    constructor(success: boolean, data?: T, error?: Error, meta?: Record<string, any>);
-    /**
-     * 创建成功结果
-     * @param data 结果数据
-     * @param meta 元数据
-     */
-    static success<T>(data?: T, meta?: Record<string, any>): Result<T>;
-    /**
-     * 创建失败结果
-     * @param error 错误对象
-     * @param meta 元数据
-     */
-    static failure<T>(error: Error, meta?: Record<string, any>): Result<T>;
-    /**
-     * 检查结果是否成功
-     */
-    isSuccess(): boolean;
-    /**
-     * 检查结果是否失败
-     */
-    isFailure(): boolean;
-    /**
-     * 获取结果数据
-     */
-    get data(): T | undefined;
-    /**
-     * 获取错误对象
-     */
-    get error(): Error | undefined;
-    /**
-     * 获取元数据
-     */
-    get meta(): Record<string, any> | undefined;
-    /**
-     * 映射结果（如果成功）
-     * @param fn 映射函数
-     */
-    map<U>(fn: (data: T) => U): Result<U>;
-    /**
-     * 如果成功，则执行函数
-     * @param fn 要执行的函数
-     */
-    onSuccess(fn: (data?: T) => void): Result<T>;
-    /**
-     * 如果失败，则执行函数
-     * @param fn 要执行的函数
-     */
-    onFailure(fn: (error: Error) => void): Result<T>;
-    /**
-     * 无论成功失败，都执行函数
-     * @param fn 要执行的函数
-     */
-    onFinally(fn: () => void): Result<T>;
-    /**
-     * 转换为字符串
-     */
-    toString(): string;
-}

package/dist/types/core/scanner-factory.d.ts

@@ -1,93 +0,0 @@
-/**
- * @file 扫描器工厂
- * @description 提供统一的组件创建和访问接口
- * @module core/scanner-factory
- */
-import { ConfigManager } from './config';
-import { Logger } from './logger';
-import { ResourceManager } from './resource-manager';
-import { EventEmitter } from './event-emitter';
-/**
- * 扫描器初始化选项
- */
-export interface ScannerFactoryOptions {
-    /** 配置选项 */
-    config?: Record<string, any>;
-    /** 资源基础路径 */
-    resourceBasePath?: string;
-    /** 调试模式 */
-    debug?: boolean;
-    /** 自动初始化模块 */
-    autoInitModules?: boolean;
-}
-/**
- * 扫描器工厂
- * 作为整个库的核心入口点，管理组件生命周期并提供统一接口
- */
-export declare class ScannerFactory extends EventEmitter {
-    /** 单例实例 */
-    private static instance;
-    /** 配置管理器 */
-    private readonly config;
-    /** 日志记录器 */
-    private readonly logger;
-    /** 资源管理器 */
-    private readonly resources;
-    /** 是否已初始化 */
-    private initialized;
-    /** 初始化锁，防止多次调用 */
-    private initializing;
-    /**
-     * 私有构造函数
-     */
-    private constructor();
-    /**
-     * 获取单例实例
-     */
-    static getInstance(): ScannerFactory;
-    /**
-     * 初始化扫描器工厂
-     * @param options 初始化选项
-     */
-    initialize(options?: ScannerFactoryOptions): Promise<boolean>;
-    /**
-     * 初始化已启用的模块
-     */
-    private initEnabledModules;
-    /**
-     * 初始化人脸识别模块
-     */
-    private initFaceModule;
-    /**
-     * 初始化二维码扫描模块
-     */
-    private initQRModule;
-    /**
-     * 初始化身份证扫描模块
-     */
-    private initIDCardModule;
-    /**
-     * 初始化OCR模块
-     */
-    private initOCRModule;
-    /**
-     * 销毁实例，释放资源
-     */
-    destroy(): void;
-    /**
-     * 获取配置管理器
-     */
-    getConfig(): ConfigManager;
-    /**
-     * 获取日志记录器
-     */
-    getLogger(): Logger;
-    /**
-     * 获取资源管理器
-     */
-    getResources(): ResourceManager;
-    /**
-     * 检查是否已初始化
-     */
-    isInitialized(): boolean;
-}