id-scanner-lib 1.6.4 → 1.6.6

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 agions
+Copyright (c) 2025-2026 agions
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/dist/id-scanner-lib.esm.js

@@ -259,13 +259,17 @@ class ConfigManager {
 /**
  * 日志级别枚举
  */
-var LogLevel;
-(function (LogLevel) {
-    LogLevel["DEBUG"] = "debug";
-    LogLevel["INFO"] = "info";
-    LogLevel["WARN"] = "warn";
-    LogLevel["ERROR"] = "error";
-})(LogLevel || (LogLevel = {}));
+var LoggerLevel;
+(function (LoggerLevel) {
+    LoggerLevel["DEBUG"] = "debug";
+    LoggerLevel["INFO"] = "info";
+    LoggerLevel["WARN"] = "warn";
+    LoggerLevel["ERROR"] = "error";
+})(LoggerLevel || (LoggerLevel = {}));
+/**
+ * @deprecated 使用 LoggerLevel 代替
+ */
+const LogLevel = LoggerLevel;
 /**
  * 控制台日志处理器
  * 将日志输出到浏览器控制台
@@ -279,16 +283,16 @@ class ConsoleLogHandler {
         const timestamp = new Date(entry.timestamp).toISOString();
         const prefix = `[${timestamp}] [${entry.level.toUpperCase()}] [${entry.tag}]`;
         switch (entry.level) {
-            case LogLevel.DEBUG:
+            case LoggerLevel.DEBUG:
                 console.debug(prefix, entry.message, entry.error || '');
                 break;
-            case LogLevel.INFO:
+            case LoggerLevel.INFO:
                 console.info(prefix, entry.message, entry.error || '');
                 break;
-            case LogLevel.WARN:
+            case LoggerLevel.WARN:
                 console.warn(prefix, entry.message, entry.error || '');
                 break;
-            case LogLevel.ERROR:
+            case LoggerLevel.ERROR:
                 console.error(prefix, entry.message, entry.error || '');
                 break;
             // 输出什么也不做
@@ -366,12 +370,15 @@ class RemoteLogHandler {
         this.endpoint = endpoint;
         this.maxQueueSize = maxQueueSize;
         this.flushInterval = flushInterval;
+        this.isBrowser = typeof window !== 'undefined' && typeof window.addEventListener === 'function';
         // 设置定时发送
         this.startTimer();
         // 页面卸载前尝试发送剩余日志
-        window.addEventListener('beforeunload', () => {
-            this.flush();
-        });
+        if (this.isBrowser) {
+            window.addEventListener('beforeunload', () => {
+                this.flush();
+            });
+        }
     }
     /**
      * 处理日志条目
@@ -379,7 +386,7 @@ class RemoteLogHandler {
      */
     handle(entry) {
         // 只处理INFO以上级别的日志
-        if (entry.level >= LogLevel.INFO) {
+        if (entry.level >= LoggerLevel.INFO) {
             this.queue.push(entry);
             // 如果队列满了，立即发送
             if (this.queue.length >= this.maxQueueSize) {
@@ -412,18 +419,22 @@ class RemoteLogHandler {
                     'Content-Type': 'application/json'
                 },
                 body: JSON.stringify(entriesToSend),
-                // 不等待响应，避免阻塞
                 keepalive: true
             }).catch((err) => {
                 console.error('Failed to send logs to remote server:', err);
+                // 防止无限重试 - 如果失败次数过多，丢弃日志
+                if (this._sendCount > 10) {
+                    console.warn('RemoteLogHandler: Max retry exceeded, discarding logs');
+                    this.queue = []; // 清空队列，避免内存泄漏
+                    this._sendCount = 0;
+                    return;
+                }
                 // 失败时把日志放回队列，但防止无限增长
                 if (this.queue.length < this.maxQueueSize) {
-                    // 限制放回的数量，防止内存溢出
                     const maxReturn = Math.min(entriesToSend.length, this.maxQueueSize - this.queue.length);
                     const returnedEntries = entriesToSend.slice(0, maxReturn);
                     this.queue = [...returnedEntries, ...this.queue];
                 }
-                // 重置发送计数，允许后续重试
                 this._sendCount = 0;
             });
         }
@@ -435,6 +446,8 @@ class RemoteLogHandler {
      * 开始定时发送
      */
     startTimer() {
+        if (!this.isBrowser)
+            return;
         if (this.timerId !== null)
             return;
         this.timerId = window.setInterval(() => {
@@ -465,7 +478,7 @@ class Logger {
         /** 默认标签 */
         this.defaultTag = 'IDScanner';
         /** 日志级别 */
-        this.logLevel = LogLevel.INFO;
+        this.logLevel = LoggerLevel.INFO;
         this.config = ConfigManager.getInstance();
         // 默认添加控制台处理器
         this.addHandler(new ConsoleLogHandler());
@@ -483,6 +496,12 @@ class Logger {
         }
         return Logger.instance;
     }
+    /**
+     * 重置单例实例（主要用于测试）
+     */
+    static resetInstance() {
+        Logger.instance = undefined;
+    }
     /**
      * 添加日志处理器
      * @param handler 日志处理器
@@ -520,7 +539,7 @@ class Logger {
      * @param error 错误
      */
     debug(tag, message, error) {
-        this.log(LogLevel.DEBUG, tag, message, error);
+        this.log(LoggerLevel.DEBUG, tag, message, error);
     }
     /**
      * 记录信息级别日志
@@ -529,7 +548,7 @@ class Logger {
      * @param error 错误
      */
     info(tag, message, error) {
-        this.log(LogLevel.INFO, tag, message, error);
+        this.log(LoggerLevel.INFO, tag, message, error);
     }
     /**
      * 记录警告级别日志
@@ -538,7 +557,7 @@ class Logger {
      * @param error 错误
      */
     warn(tag, message, error) {
-        this.log(LogLevel.WARN, tag, message, error);
+        this.log(LoggerLevel.WARN, tag, message, error);
     }
     /**
      * 记录错误级别日志
@@ -547,7 +566,7 @@ class Logger {
      * @param error 错误
      */
     error(tag, message, error) {
-        this.log(LogLevel.ERROR, tag, message, error);
+        this.log(LoggerLevel.ERROR, tag, message, error);
     }
     /**
      * 创建标记了特定标签的日志记录器
@@ -600,16 +619,16 @@ class Logger {
         const timestamp = new Date(entry.timestamp).toISOString();
         const prefix = `[${timestamp}] [${entry.level.toUpperCase()}] [${entry.tag}]`;
         switch (entry.level) {
-            case LogLevel.DEBUG:
+            case LoggerLevel.DEBUG:
                 console.debug(`${prefix} ${entry.message}`, entry.error || '');
                 break;
-            case LogLevel.INFO:
+            case LoggerLevel.INFO:
                 console.info(`${prefix} ${entry.message}`, entry.error || '');
                 break;
-            case LogLevel.WARN:
+            case LoggerLevel.WARN:
                 console.warn(`${prefix} ${entry.message}`, entry.error || '');
                 break;
-            case LogLevel.ERROR:
+            case LoggerLevel.ERROR:
                 console.error(`${prefix} ${entry.message}`, entry.error || '');
                 break;
         }
@@ -620,13 +639,13 @@ class Logger {
      */
     getLevelValue(level) {
         switch (level) {
-            case LogLevel.DEBUG:
+            case LoggerLevel.DEBUG:
                 return 0;
-            case LogLevel.INFO:
+            case LoggerLevel.INFO:
                 return 1;
-            case LogLevel.WARN:
+            case LoggerLevel.WARN:
                 return 2;
-            case LogLevel.ERROR:
+            case LoggerLevel.ERROR:
                 return 3;
             default:
                 return 1; // 默认INFO级别
@@ -640,19 +659,19 @@ class Logger {
         if (typeof level === 'string') {
             switch (level) {
                 case 'debug':
-                    this.logLevel = LogLevel.DEBUG;
+                    this.logLevel = LoggerLevel.DEBUG;
                     break;
                 case 'info':
-                    this.logLevel = LogLevel.INFO;
+                    this.logLevel = LoggerLevel.INFO;
                     break;
                 case 'warn':
-                    this.logLevel = LogLevel.WARN;
+                    this.logLevel = LoggerLevel.WARN;
                     break;
                 case 'error':
-                    this.logLevel = LogLevel.ERROR;
+                    this.logLevel = LoggerLevel.ERROR;
                     break;
                 default:
-                    this.logLevel = LogLevel.INFO;
+                    this.logLevel = LoggerLevel.INFO;
             }
         }
         else {
@@ -765,6 +784,14 @@ class EventEmitter {
             this.eventHandlers.delete(eventName);
         }
     }
+    /**
+     * 取消订阅事件 (off的别名)
+     * @param eventName 事件名称
+     * @param handler 事件处理器
+     */
+    removeListener(eventName, handler) {
+        this.off(eventName, handler);
+    }
     /**
      * 订阅事件，但只触发一次
      * @param eventName 事件名称
@@ -1052,19 +1079,19 @@ class Result {
     /**
      * 获取结果数据
      */
-    get data() {
+    getData() {
         return this._data;
     }
     /**
      * 获取错误对象
      */
-    get error() {
+    getError() {
         return this._error;
     }
     /**
      * 获取元数据
      */
-    get meta() {
+    getMeta() {
         return this._meta;
     }
     /**
@@ -2890,8 +2917,8 @@ class OCRProcessor {
                     ? JSON.stringify(error)
                     : String(error);
             this.options.logger?.(`OCR识别错误: ${errorMessage}`);
-            // 返回空对象，避免完全失败
-            return {};
+            // 返回 null，让调用方知道识别失败
+            return null;
         }
     }
     /**
@@ -3770,18 +3797,19 @@ class IDCardModule extends BaseModule {
         try {
             // 检测身份证
             const detectionResult = await this.detector.processImage(image);
-            if (!detectionResult.isSuccess() || !detectionResult.data) {
+            const detectionData = detectionResult.getData();
+            if (!detectionResult.isSuccess() || !detectionData) {
                 throw new Error('未检测到身份证');
             }
             // 创建结果对象
             const idCardInfo = {
-                type: detectionResult.data.type || IDCardType.FRONT,
-                confidence: detectionResult.data.confidence
+                type: detectionData.type || IDCardType.FRONT,
+                confidence: detectionData.confidence
             };
             // 如果启用OCR且OCR处理器已初始化
             if (this.options.detector?.enableOCR && this.ocrProcessor) {
                 // 裁剪并处理图像
-                const processedImage = detectionResult.data.image || this.convertToImageData(image);
+                const processedImage = detectionData.image || this.convertToImageData(image);
                 // 识别文本信息
                 const ocrResult = await this.ocrProcessor.processIDCard(processedImage);
                 // 合并OCR结果
@@ -3963,14 +3991,15 @@ class IDCardModule extends BaseModule {
         try {
             // 调用检测器处理图像
             const result = await this.detector.processImage(image);
-            if (!result.isSuccess() || !result.data) {
+            if (!result.isSuccess() || !result.getData()) {
                 return { success: false, confidence: 0 };
             }
+            const data = result.getData();
             return {
                 success: true,
-                type: result.data.type,
-                confidence: result.data.confidence || 0,
-                croppedImage: result.data.image
+                type: data.type,
+                confidence: data.confidence || 0,
+                croppedImage: data.image
             };
         }
         catch (error) {
@@ -4845,13 +4874,13 @@ class IDScanner {
         }
         this.moduleManager = ModuleManager.getInstance();
         // 注册模块
-        if (options.enableIDCard !== false) {
+        if (options.enableIDCard === true) {
             this.moduleManager.register(new IDCardModule(options.idCard));
         }
-        if (options.enableQRCode !== false) {
+        if (options.enableQRCode === true) {
             this.moduleManager.register(new QRCodeModule(options.qrCode));
         }
-        if (options.enableFace !== false) {
+        if (options.enableFace === true) {
             this.moduleManager.register(new FaceModule(options.face));
         }
     }
@@ -4919,5 +4948,5 @@ IDScanner.VERSION = VERSION;
 /** 构建日期 */
 IDScanner.BUILD_DATE = BUILD_DATE;
 
-export { BarcodeFormat, CameraAccessError, ConsoleLogHandler, DEFAULT_FORMATS, DeviceError, FaceComparisonError, FaceDetectionError, FaceModule, IDCardDetectionError, IDCardModule, IDCardType, IDScanner, IDScannerError, InitializationError, InvalidArgumentError, LivenessDetectionError, LoadingState, LoadingStateManager, LogLevel, Logger, MemoryLogHandler, ModuleManager, NotSupportedError, OCRProcessingError, QRCodeModule, QRScanError, RemoteLogHandler, ResourceLoadError, TaggedLogger, createLoadingStateManager, IDScanner as default };
+export { BarcodeFormat, CameraAccessError, ConsoleLogHandler, DEFAULT_FORMATS, DeviceError, FaceComparisonError, FaceDetectionError, FaceModule, IDCardDetectionError, IDCardModule, IDCardType, IDScanner, IDScannerError, InitializationError, InvalidArgumentError, LivenessDetectionError, LoadingState, LoadingStateManager, LogLevel, Logger, LoggerLevel, MemoryLogHandler, ModuleManager, NotSupportedError, OCRProcessingError, QRCodeModule, QRScanError, RemoteLogHandler, ResourceLoadError, TaggedLogger, createLoadingStateManager, IDScanner as default };
 //# sourceMappingURL=id-scanner-lib.esm.js.map