id-scanner-lib 1.6.5 → 1.6.7

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) {
@@ -439,6 +446,8 @@ class RemoteLogHandler {
      * 开始定时发送
      */
     startTimer() {
+        if (!this.isBrowser)
+            return;
         if (this.timerId !== null)
             return;
         this.timerId = window.setInterval(() => {
@@ -469,7 +478,7 @@ class Logger {
         /** 默认标签 */
         this.defaultTag = 'IDScanner';
         /** 日志级别 */
-        this.logLevel = LogLevel.INFO;
+        this.logLevel = LoggerLevel.INFO;
         this.config = ConfigManager.getInstance();
         // 默认添加控制台处理器
         this.addHandler(new ConsoleLogHandler());
@@ -487,6 +496,12 @@ class Logger {
         }
         return Logger.instance;
     }
+    /**
+     * 重置单例实例（主要用于测试）
+     */
+    static resetInstance() {
+        Logger.instance = undefined;
+    }
     /**
      * 添加日志处理器
      * @param handler 日志处理器
@@ -524,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);
     }
     /**
      * 记录信息级别日志
@@ -533,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);
     }
     /**
      * 记录警告级别日志
@@ -542,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);
     }
     /**
      * 记录错误级别日志
@@ -551,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);
     }
     /**
      * 创建标记了特定标签的日志记录器
@@ -604,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;
         }
@@ -624,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级别
@@ -644,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 {
@@ -769,6 +784,14 @@ class EventEmitter {
             this.eventHandlers.delete(eventName);
         }
     }
+    /**
+     * 取消订阅事件 (off的别名)
+     * @param eventName 事件名称
+     * @param handler 事件处理器
+     */
+    removeListener(eventName, handler) {
+        this.off(eventName, handler);
+    }
     /**
      * 订阅事件，但只触发一次
      * @param eventName 事件名称
@@ -1056,19 +1079,19 @@ class Result {
     /**
      * 获取结果数据
      */
-    get data() {
+    getData() {
         return this._data;
     }
     /**
      * 获取错误对象
      */
-    get error() {
+    getError() {
         return this._error;
     }
     /**
      * 获取元数据
      */
-    get meta() {
+    getMeta() {
         return this._meta;
     }
     /**
@@ -1699,17 +1722,32 @@ class ImageProcessor {
                 outputData[pos + 3] = data[pos + 3]; // 保持透明度不变
             }
         }
-        // 处理边缘像素
-        for (let y = 0; y < height; y++) {
-            for (let x = 0; x < width; x++) {
-                if (y === 0 || y === height - 1 || x === 0 || x === width - 1) {
-                    const pos = (y * width + x) * 4;
-                    outputData[pos] = data[pos];
-                    outputData[pos + 1] = data[pos + 1];
-                    outputData[pos + 2] = data[pos + 2];
-                    outputData[pos + 3] = data[pos + 3];
-                }
-            }
+        // 处理边缘像素（仅遍历四条边，而非全图 O(width×height) → O(width+height)）
+        // 上边 + 下边
+        for (let x = 0; x < width; x++) {
+            const topPos = x * 4;
+            const bottomPos = ((height - 1) * width + x) * 4;
+            outputData[topPos] = data[topPos];
+            outputData[topPos + 1] = data[topPos + 1];
+            outputData[topPos + 2] = data[topPos + 2];
+            outputData[topPos + 3] = data[topPos + 3];
+            outputData[bottomPos] = data[bottomPos];
+            outputData[bottomPos + 1] = data[bottomPos + 1];
+            outputData[bottomPos + 2] = data[bottomPos + 2];
+            outputData[bottomPos + 3] = data[bottomPos + 3];
+        }
+        // 左边 + 右边（排除四角，它们已在上下一行处理）
+        for (let y = 1; y < height - 1; y++) {
+            const leftPos = y * width * 4;
+            const rightPos = (y * width + width - 1) * 4;
+            outputData[leftPos] = data[leftPos];
+            outputData[leftPos + 1] = data[leftPos + 1];
+            outputData[leftPos + 2] = data[leftPos + 2];
+            outputData[leftPos + 3] = data[leftPos + 3];
+            outputData[rightPos] = data[rightPos];
+            outputData[rightPos + 1] = data[rightPos + 1];
+            outputData[rightPos + 2] = data[rightPos + 2];
+            outputData[rightPos + 3] = data[rightPos + 3];
         }
         // 创建新的ImageData对象
         return new ImageData(outputData, width, height);
@@ -1722,11 +1760,10 @@ class ImageProcessor {
      * @returns 处理后的图像数据
      */
     static threshold(imageData, threshold = 128) {
-        // 先转换为灰度图
-        const grayscaleImage = this.toGrayscale(new ImageData(new Uint8ClampedArray(imageData.data), imageData.width, imageData.height));
+        // 先转换为灰度图（toGrayscale 内部已创建新 ImageData，无需外部拷贝）
+        const grayscaleImage = this.toGrayscale(imageData);
         const data = grayscaleImage.data;
-        const length = data.length;
-        for (let i = 0; i < length; i += 4) {
+        for (let i = 0; i < data.length; i += 4) {
             // 二值化处理
             const value = data[i] < threshold ? 0 : 255;
             data[i] = data[i + 1] = data[i + 2] = value;
@@ -1740,8 +1777,8 @@ class ImageProcessor {
      * @returns 二值化后的图像数据
      */
     static toBinaryImage(imageData) {
-        // 先转换为灰度图
-        const grayscaleImage = this.toGrayscale(new ImageData(new Uint8ClampedArray(imageData.data), imageData.width, imageData.height));
+        // 先转换为灰度图（toGrayscale 内部已创建新 ImageData，无需外部拷贝）
+        const grayscaleImage = this.toGrayscale(imageData);
         // 使用OTSU算法自动确定阈值
         const threshold = this.getOtsuThreshold(grayscaleImage);
         return this.threshold(grayscaleImage, threshold);
@@ -1754,8 +1791,9 @@ class ImageProcessor {
      */
     static getOtsuThreshold(imageData) {
         const data = imageData.data;
-        const histogram = new Array(256).fill(0);
-        // 统计灰度直方图
+        // 使用 Uint8Array 替代 Array<number>，避免 boxing 开销，提升直方图统计性能
+        const histogram = new Uint32Array(256);
+        // 统计灰度直方图（每4字节取R通道，即灰度值）
         for (let i = 0; i < data.length; i += 4) {
             histogram[data[i]]++;
         }
@@ -3774,18 +3812,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结果
@@ -3967,14 +4006,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) {
@@ -4849,13 +4889,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));
         }
     }
@@ -4923,5 +4963,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