id-scanner-lib 1.3.3 → 1.5.0

package/src/core/result.ts

@@ -0,0 +1,163 @@
+/**
+ * @file 结果包装类
+ * @description 提供统一的操作结果封装
+ * @module core/result
+ */
+
+/**
+ * 结果类型
+ * 用于封装操作的成功或失败结果
+ */
+export class Result<T = any> {
+  /** 结果数据 */
+  private _data?: T;
+  /** 错误对象 */
+  private _error?: Error;
+  /** 是否成功 */
+  private _success: boolean;
+  /** 额外元数据 */
+  private _meta?: Record<string, any>;
+  
+  /**
+   * 构造函数
+   * @param success 是否成功
+   * @param data 结果数据
+   * @param error 错误对象
+   * @param meta 元数据
+   */
+  constructor(
+    success: boolean,
+    data?: T,
+    error?: Error,
+    meta?: Record<string, any>
+  ) {
+    this._success = success;
+    this._data = data;
+    this._error = error;
+    this._meta = meta;
+  }
+  
+  /**
+   * 创建成功结果
+   * @param data 结果数据
+   * @param meta 元数据
+   */
+  static success<T>(data?: T, meta?: Record<string, any>): Result<T> {
+    return new Result<T>(true, data, undefined, meta);
+  }
+  
+  /**
+   * 创建失败结果
+   * @param error 错误对象
+   * @param meta 元数据
+   */
+  static failure<T>(error: Error, meta?: Record<string, any>): Result<T> {
+    return new Result<T>(false, undefined, error, meta);
+  }
+  
+  /**
+   * 检查结果是否成功
+   */
+  isSuccess(): boolean {
+    return this._success;
+  }
+  
+  /**
+   * 检查结果是否失败
+   */
+  isFailure(): boolean {
+    return !this._success;
+  }
+  
+  /**
+   * 获取结果数据
+   */
+  get data(): T | undefined {
+    return this._data;
+  }
+  
+  /**
+   * 获取错误对象
+   */
+  get error(): Error | undefined {
+    return this._error;
+  }
+  
+  /**
+   * 获取元数据
+   */
+  get meta(): Record<string, any> | undefined {
+    return this._meta;
+  }
+  
+  /**
+   * 映射结果（如果成功）
+   * @param fn 映射函数
+   */
+  map<U>(fn: (data: T) => U): Result<U> {
+    if (this.isSuccess() && this._data !== undefined) {
+      try {
+        const newData = fn(this._data);
+        return Result.success<U>(newData, this._meta);
+      } catch (error) {
+        return Result.failure<U>(error instanceof Error ? error : new Error(String(error)), this._meta);
+      }
+    }
+    
+    return Result.failure<U>(this._error!, this._meta);
+  }
+  
+  /**
+   * 如果成功，则执行函数
+   * @param fn 要执行的函数
+   */
+  onSuccess(fn: (data?: T) => void): Result<T> {
+    if (this.isSuccess()) {
+      try {
+        fn(this._data);
+      } catch (error) {
+        console.error('Error in onSuccess handler:', error);
+      }
+    }
+    return this;
+  }
+  
+  /**
+   * 如果失败，则执行函数
+   * @param fn 要执行的函数
+   */
+  onFailure(fn: (error: Error) => void): Result<T> {
+    if (this.isFailure() && this._error) {
+      try {
+        fn(this._error);
+      } catch (error) {
+        console.error('Error in onFailure handler:', error);
+      }
+    }
+    return this;
+  }
+  
+  /**
+   * 无论成功失败，都执行函数
+   * @param fn 要执行的函数
+   */
+  onFinally(fn: () => void): Result<T> {
+    try {
+      fn();
+    } catch (error) {
+      console.error('Error in onFinally handler:', error);
+    }
+    return this;
+  }
+  
+  /**
+   * 转换为字符串
+   */
+  toString(): string {
+    if (this.isSuccess()) {
+      return `Success: ${JSON.stringify(this._data)}`;
+    } else {
+      return `Failure: ${this._error?.message || 'Unknown error'}`;
+    }
+  }
+} 

package/src/core/scanner-factory.ts

@@ -0,0 +1,237 @@
+/**
+ * @file 扫描器工厂
+ * @description 提供统一的组件创建和访问接口
+ * @module core/scanner-factory
+ */
+
+import { ConfigManager } from './config';
+import { Logger } from './logger';
+import { ResourceManager } from './resource-manager';
+import { EventEmitter } from './event-emitter';
+import { InitializationError } from './errors';
+import { VERSION } from '../version';
+
+/**
+ * 扫描器初始化选项
+ */
+export interface ScannerFactoryOptions {
+  /** 配置选项 */
+  config?: Record<string, any>;
+  /** 资源基础路径 */
+  resourceBasePath?: string;
+  /** 调试模式 */
+  debug?: boolean;
+  /** 自动初始化模块 */
+  autoInitModules?: boolean;
+}
+
+/**
+ * 扫描器工厂
+ * 作为整个库的核心入口点，管理组件生命周期并提供统一接口
+ */
+export class ScannerFactory extends EventEmitter {
+  /** 单例实例 */
+  private static instance: ScannerFactory;
+  /** 配置管理器 */
+  private readonly config: ConfigManager;
+  /** 日志记录器 */
+  private readonly logger: Logger;
+  /** 资源管理器 */
+  private readonly resources: ResourceManager;
+  /** 是否已初始化 */
+  private initialized: boolean = false;
+  /** 初始化锁，防止多次调用 */
+  private initializing: boolean = false;
+  
+  /**
+   * 私有构造函数
+   */
+  private constructor() {
+    super();
+    this.config = ConfigManager.getInstance();
+    this.logger = Logger.getInstance();
+    this.resources = ResourceManager.getInstance();
+  }
+  
+  /**
+   * 获取单例实例
+   */
+  public static getInstance(): ScannerFactory {
+    if (!ScannerFactory.instance) {
+      ScannerFactory.instance = new ScannerFactory();
+    }
+    return ScannerFactory.instance;
+  }
+  
+  /**
+   * 初始化扫描器工厂
+   * @param options 初始化选项
+   */
+  async initialize(options: ScannerFactoryOptions = {}): Promise<boolean> {
+    // 防止重复初始化
+    if (this.initialized) {
+      this.logger.warn('ScannerFactory', 'Already initialized');
+      return true;
+    }
+    
+    if (this.initializing) {
+      this.logger.warn('ScannerFactory', 'Initialization already in progress');
+      return false;
+    }
+    
+    this.initializing = true;
+    
+    try {
+      const { 
+        config = {}, 
+        resourceBasePath = '', 
+        debug = false,
+        autoInitModules = true
+      } = options;
+      
+      // 应用配置
+      if (debug) {
+        config.debug = true;
+      }
+      
+      this.config.updateConfig(config);
+      
+      // 设置资源基础路径
+      if (resourceBasePath) {
+        this.resources.setBasePath(resourceBasePath);
+      }
+      
+      // 记录初始化日志
+      this.logger.info('ScannerFactory', `Initializing ID Scanner Library v${VERSION}`);
+      
+      // 如果启用了自动初始化模块，则加载相应模块
+      if (autoInitModules) {
+        await this.initEnabledModules();
+      }
+      
+      this.initialized = true;
+      this.initializing = false;
+      
+      this.emit('initialized', { success: true });
+      this.logger.info('ScannerFactory', 'ID Scanner Library initialized successfully');
+      
+      return true;
+    } catch (error) {
+      this.initializing = false;
+      
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.logger.error('ScannerFactory', `Initialization failed: ${errorMessage}`, error instanceof Error ? error : new Error(errorMessage));
+      
+      this.emit('initialized', { success: false, error });
+      
+      throw new InitializationError(
+        '扫描器初始化失败', 
+        errorMessage
+      );
+    }
+  }
+  
+  /**
+   * 初始化已启用的模块
+   */
+  private async initEnabledModules(): Promise<void> {
+    const enabledModules = [];
+    
+    // 检查每个模块的启用状态
+    if (this.config.get('modules.face.enabled', false)) {
+      enabledModules.push(this.initFaceModule());
+    }
+    
+    if (this.config.get('modules.qr.enabled', false)) {
+      enabledModules.push(this.initQRModule());
+    }
+    
+    if (this.config.get('modules.idcard.enabled', false)) {
+      enabledModules.push(this.initIDCardModule());
+    }
+    
+    if (this.config.get('modules.ocr.enabled', false)) {
+      enabledModules.push(this.initOCRModule());
+    }
+    
+    // 并行初始化所有启用的模块
+    if (enabledModules.length > 0) {
+      await Promise.all(enabledModules);
+    }
+  }
+  
+  /**
+   * 初始化人脸识别模块
+   */
+  private async initFaceModule(): Promise<void> {
+    this.logger.info('ScannerFactory', 'Initializing Face module');
+    // 实际初始化代码将在模块实现中完成
+  }
+  
+  /**
+   * 初始化二维码扫描模块
+   */
+  private async initQRModule(): Promise<void> {
+    this.logger.info('ScannerFactory', 'Initializing QR Code module');
+    // 实际初始化代码将在模块实现中完成
+  }
+  
+  /**
+   * 初始化身份证扫描模块
+   */
+  private async initIDCardModule(): Promise<void> {
+    this.logger.info('ScannerFactory', 'Initializing ID Card module');
+    // 实际初始化代码将在模块实现中完成
+  }
+  
+  /**
+   * 初始化OCR模块
+   */
+  private async initOCRModule(): Promise<void> {
+    this.logger.info('ScannerFactory', 'Initializing OCR module');
+    // 实际初始化代码将在模块实现中完成
+  }
+  
+  /**
+   * 销毁实例，释放资源
+   */
+  destroy(): void {
+    if (!this.initialized) return;
+    
+    this.logger.info('ScannerFactory', 'Destroying ID Scanner Library');
+    
+    // 释放所有资源
+    this.resources.releaseAll();
+    
+    this.initialized = false;
+    this.emit('destroyed');
+  }
+  
+  /**
+   * 获取配置管理器
+   */
+  getConfig(): ConfigManager {
+    return this.config;
+  }
+  
+  /**
+   * 获取日志记录器
+   */
+  getLogger(): Logger {
+    return this.logger;
+  }
+  
+  /**
+   * 获取资源管理器
+   */
+  getResources(): ResourceManager {
+    return this.resources;
+  }
+  
+  /**
+   * 检查是否已初始化
+   */
+  isInitialized(): boolean {
+    return this.initialized;
+  }
+}