id-scanner-lib 1.6.5 → 1.6.7

package/dist/id-scanner-lib.js

@@ -261,13 +261,17 @@
   /**
    * 日志级别枚举
    */
-  exports.LogLevel = void 0;
-  (function (LogLevel) {
-      LogLevel["DEBUG"] = "debug";
-      LogLevel["INFO"] = "info";
-      LogLevel["WARN"] = "warn";
-      LogLevel["ERROR"] = "error";
-  })(exports.LogLevel || (exports.LogLevel = {}));
+  exports.LoggerLevel = void 0;
+  (function (LoggerLevel) {
+      LoggerLevel["DEBUG"] = "debug";
+      LoggerLevel["INFO"] = "info";
+      LoggerLevel["WARN"] = "warn";
+      LoggerLevel["ERROR"] = "error";
+  })(exports.LoggerLevel || (exports.LoggerLevel = {}));
+  /**
+   * @deprecated 使用 LoggerLevel 代替
+   */
+  const LogLevel = exports.LoggerLevel;
   /**
    * 控制台日志处理器
    * 将日志输出到浏览器控制台
@@ -281,16 +285,16 @@
           const timestamp = new Date(entry.timestamp).toISOString();
           const prefix = `[${timestamp}] [${entry.level.toUpperCase()}] [${entry.tag}]`;
           switch (entry.level) {
-              case exports.LogLevel.DEBUG:
+              case exports.LoggerLevel.DEBUG:
                   console.debug(prefix, entry.message, entry.error || '');
                   break;
-              case exports.LogLevel.INFO:
+              case exports.LoggerLevel.INFO:
                   console.info(prefix, entry.message, entry.error || '');
                   break;
-              case exports.LogLevel.WARN:
+              case exports.LoggerLevel.WARN:
                   console.warn(prefix, entry.message, entry.error || '');
                   break;
-              case exports.LogLevel.ERROR:
+              case exports.LoggerLevel.ERROR:
                   console.error(prefix, entry.message, entry.error || '');
                   break;
               // 输出什么也不做
@@ -368,12 +372,15 @@
           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();
+              });
+          }
       }
       /**
        * 处理日志条目
@@ -381,7 +388,7 @@
        */
       handle(entry) {
           // 只处理INFO以上级别的日志
-          if (entry.level >= exports.LogLevel.INFO) {
+          if (entry.level >= exports.LoggerLevel.INFO) {
               this.queue.push(entry);
               // 如果队列满了，立即发送
               if (this.queue.length >= this.maxQueueSize) {
@@ -441,6 +448,8 @@
        * 开始定时发送
        */
       startTimer() {
+          if (!this.isBrowser)
+              return;
           if (this.timerId !== null)
               return;
           this.timerId = window.setInterval(() => {
@@ -471,7 +480,7 @@
           /** 默认标签 */
           this.defaultTag = 'IDScanner';
           /** 日志级别 */
-          this.logLevel = exports.LogLevel.INFO;
+          this.logLevel = exports.LoggerLevel.INFO;
           this.config = ConfigManager.getInstance();
           // 默认添加控制台处理器
           this.addHandler(new ConsoleLogHandler());
@@ -489,6 +498,12 @@
           }
           return Logger.instance;
       }
+      /**
+       * 重置单例实例（主要用于测试）
+       */
+      static resetInstance() {
+          Logger.instance = undefined;
+      }
       /**
        * 添加日志处理器
        * @param handler 日志处理器
@@ -526,7 +541,7 @@
        * @param error 错误
        */
       debug(tag, message, error) {
-          this.log(exports.LogLevel.DEBUG, tag, message, error);
+          this.log(exports.LoggerLevel.DEBUG, tag, message, error);
       }
       /**
        * 记录信息级别日志
@@ -535,7 +550,7 @@
        * @param error 错误
        */
       info(tag, message, error) {
-          this.log(exports.LogLevel.INFO, tag, message, error);
+          this.log(exports.LoggerLevel.INFO, tag, message, error);
       }
       /**
        * 记录警告级别日志
@@ -544,7 +559,7 @@
        * @param error 错误
        */
       warn(tag, message, error) {
-          this.log(exports.LogLevel.WARN, tag, message, error);
+          this.log(exports.LoggerLevel.WARN, tag, message, error);
       }
       /**
        * 记录错误级别日志
@@ -553,7 +568,7 @@
        * @param error 错误
        */
       error(tag, message, error) {
-          this.log(exports.LogLevel.ERROR, tag, message, error);
+          this.log(exports.LoggerLevel.ERROR, tag, message, error);
       }
       /**
        * 创建标记了特定标签的日志记录器
@@ -606,16 +621,16 @@
           const timestamp = new Date(entry.timestamp).toISOString();
           const prefix = `[${timestamp}] [${entry.level.toUpperCase()}] [${entry.tag}]`;
           switch (entry.level) {
-              case exports.LogLevel.DEBUG:
+              case exports.LoggerLevel.DEBUG:
                   console.debug(`${prefix} ${entry.message}`, entry.error || '');
                   break;
-              case exports.LogLevel.INFO:
+              case exports.LoggerLevel.INFO:
                   console.info(`${prefix} ${entry.message}`, entry.error || '');
                   break;
-              case exports.LogLevel.WARN:
+              case exports.LoggerLevel.WARN:
                   console.warn(`${prefix} ${entry.message}`, entry.error || '');
                   break;
-              case exports.LogLevel.ERROR:
+              case exports.LoggerLevel.ERROR:
                   console.error(`${prefix} ${entry.message}`, entry.error || '');
                   break;
           }
@@ -626,13 +641,13 @@
        */
       getLevelValue(level) {
           switch (level) {
-              case exports.LogLevel.DEBUG:
+              case exports.LoggerLevel.DEBUG:
                   return 0;
-              case exports.LogLevel.INFO:
+              case exports.LoggerLevel.INFO:
                   return 1;
-              case exports.LogLevel.WARN:
+              case exports.LoggerLevel.WARN:
                   return 2;
-              case exports.LogLevel.ERROR:
+              case exports.LoggerLevel.ERROR:
                   return 3;
               default:
                   return 1; // 默认INFO级别
@@ -646,19 +661,19 @@
           if (typeof level === 'string') {
               switch (level) {
                   case 'debug':
-                      this.logLevel = exports.LogLevel.DEBUG;
+                      this.logLevel = exports.LoggerLevel.DEBUG;
                       break;
                   case 'info':
-                      this.logLevel = exports.LogLevel.INFO;
+                      this.logLevel = exports.LoggerLevel.INFO;
                       break;
                   case 'warn':
-                      this.logLevel = exports.LogLevel.WARN;
+                      this.logLevel = exports.LoggerLevel.WARN;
                       break;
                   case 'error':
-                      this.logLevel = exports.LogLevel.ERROR;
+                      this.logLevel = exports.LoggerLevel.ERROR;
                       break;
                   default:
-                      this.logLevel = exports.LogLevel.INFO;
+                      this.logLevel = exports.LoggerLevel.INFO;
               }
           }
           else {
@@ -771,6 +786,14 @@
               this.eventHandlers.delete(eventName);
           }
       }
+      /**
+       * 取消订阅事件 (off的别名)
+       * @param eventName 事件名称
+       * @param handler 事件处理器
+       */
+      removeListener(eventName, handler) {
+          this.off(eventName, handler);
+      }
       /**
        * 订阅事件，但只触发一次
        * @param eventName 事件名称
@@ -1058,19 +1081,19 @@
       /**
        * 获取结果数据
        */
-      get data() {
+      getData() {
           return this._data;
       }
       /**
        * 获取错误对象
        */
-      get error() {
+      getError() {
           return this._error;
       }
       /**
        * 获取元数据
        */
-      get meta() {
+      getMeta() {
           return this._meta;
       }
       /**
@@ -1701,17 +1724,32 @@
                   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);
@@ -1724,11 +1762,10 @@
        * @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;
@@ -1742,8 +1779,8 @@
        * @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);
@@ -1756,8 +1793,9 @@
        */
       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]]++;
           }
@@ -3776,18 +3814,19 @@
           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 || exports.IDCardType.FRONT,
-                  confidence: detectionResult.data.confidence
+                  type: detectionData.type || exports.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结果
@@ -3969,14 +4008,15 @@
           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) {
@@ -4851,13 +4891,13 @@
           }
           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));
           }
       }
@@ -4940,6 +4980,7 @@
   exports.InvalidArgumentError = InvalidArgumentError;
   exports.LivenessDetectionError = LivenessDetectionError;
   exports.LoadingStateManager = LoadingStateManager;
+  exports.LogLevel = LogLevel;
   exports.Logger = Logger;
   exports.MemoryLogHandler = MemoryLogHandler;
   exports.ModuleManager = ModuleManager;