@jaak.ai/stamps 1.0.0-dev.15 → 1.0.0-dev.16

package/README.md

@@ -264,6 +264,10 @@ El `document-detector` es un componente web que utiliza tecnología de reconocim
 - **Captura de imágenes**: Guarda imágenes del documento, rostro y firma cuando están disponibles.
 - **Interfaz personalizable**: Permite adaptar la apariencia y comportamiento a las necesidades de tu aplicación.
 - **Eventos detallados**: Proporciona eventos para cada etapa del proceso de escaneo.
+- **Modo dinámico**: Optimiza automáticamente el rendimiento según el dispositivo (escritorio o móvil).
+- **Filtros de calidad ajustables**: Controla la rigurosidad de los filtros de desenfoque y brillo.
+- **Traducciones personalizables**: Permite personalizar todos los mensajes mostrados al usuario.
+- **Capacidad de reinicio**: Facilita reiniciar el componente sin necesidad de recargarlo.
 
 ### Ciclo de Vida del Componente
 
@@ -287,9 +291,20 @@ El `document-detector` es un componente web que utiliza tecnología de reconocim
   license-key="TU_CLAVE_DE_LICENCIA">
 </document-detector>
 
-<!-- O usando la propiedad config -->
+<!-- O usando la propiedad config con opciones avanzadas -->
 <document-detector 
-  config='{"key": "TU_CLAVE_DE_LICENCIA"}'>
+  config='{
+    "key": "TU_CLAVE_DE_LICENCIA",
+    "dynamicMode": true,
+    "strictMode": true,
+    "translation": {
+      "front": "Escanea el frente de tu documento",
+      "back": "Ahora escanea el reverso",
+      "changeSide": "Voltea el documento",
+      "cameraFeedbackBlur": "El documento está borroso",
+      "cameraFeedbackGlare": "Evita el reflejo en el documento"
+    }
+  }'>
 </document-detector>
 ```
 
@@ -307,15 +322,30 @@ detector.addEventListener('status', (event) => {
     case 'INITIALIZING':
       console.log('El detector se está inicializando');
       break;
-    case 'READY':
-      console.log('El detector está listo para escanear');
-      break;
     case 'RECORDING':
       console.log('La cámara está activa y grabando');
       break;
+    case 'FRONT_SIDE_DETECTION':
+      console.log('Detectando el frente del documento');
+      break;
+    case 'BACK_SIDE_DETECTION':
+      console.log('Detectando el reverso del documento');
+      break;
+    case 'DOCUMENT_DETECTED':
+      console.log('Documento detectado correctamente');
+      break;
+    case 'CHANGE_SIDE':
+      console.log('Es necesario voltear el documento');
+      break;
     case 'RESULTS_SUCCESS':
       console.log('Se han obtenido resultados exitosamente');
       break;
+    case 'RESULTS_EMPTY':
+      console.log('No se encontraron datos en el documento');
+      break;
+    case 'DETECTION_FAILED':
+      console.log('Falló la detección del documento');
+      break;
     case 'ERROR':
       console.log('Ha ocurrido un error en el detector');
       break;
@@ -356,6 +386,8 @@ function escanearDesdeImagen(archivo) {
 // Reiniciar el componente (útil cuando se necesita resetear el estado)
 function reiniciarEscaneo() {
   detector.restartComponent();
+  // El método restartComponent reinicia internamente el componente y vuelve a iniciar
+  // el escaneo por cámara automáticamente, sin necesidad de llamar a startCameraScan()
 }
 
 // Ejemplo de uso con un input de archivo
@@ -393,7 +425,31 @@ document-detector::part(mb-camera-video) {
 | Propiedad                | Tipo                                      | Descripción                                |
 |--------------------------|-------------------------------------------|--------------------------------------------|
 | `license-key`            | string                                    | Clave de licencia para el SDK              |
-| `config`                 | { key: string }                           | Configuración del componente (incluye la clave de licencia) |
+| `config`                 | object                                    | Configuración del componente (ver detalle abajo) |
+
+#### Objeto de configuración (`config`)
+
+| Propiedad                | Tipo                                      | Descripción                                |
+|--------------------------|-------------------------------------------|--------------------------------------------|
+| `key`                    | string                                    | Clave de licencia para el SDK              |
+| `dynamicMode`            | boolean                                   | Cuando está activado, utiliza la variante completa del SDK en escritorio y la ligera en móviles |
+| `strictMode`             | boolean                                   | Controla los filtros de desenfoque y brillo. Cuando está activado, se aplican filtros más estrictos |
+| `translation`            | object                                    | Configuración de traducciones personalizadas (ver detalle abajo) |
+
+#### Objeto de traducción (`config.translation`)
+
+| Propiedad                      | Tipo                                      | Descripción                                |
+|--------------------------------|-------------------------------------------|--------------------------------------------|
+| `front`                        | string                                    | Mensaje para escanear el frente del documento |
+| `back`                         | string                                    | Mensaje para escanear el reverso del documento |
+| `changeSide`                   | string                                    | Mensaje para voltear el documento |
+| `adjustAngle`                  | string                                    | Mensaje para ajustar el ángulo del documento |
+| `cameraFeedbackBlur`           | string                                    | Mensaje cuando el documento está borroso |
+| `cameraFeedbackFacePhotoCovered`| string                                   | Mensaje cuando la foto de la cara está cubierta |
+| `cameraFeedbackGlare`          | string                                    | Mensaje cuando hay deslumbramiento en el documento |
+| `cameraFeedbackWrongSide`      | string                                    | Mensaje cuando se muestra el lado incorrecto del documento |
+| `moveCloser`                   | string                                    | Mensaje para acercar el documento |
+| `moveFarther`                  | string                                    | Mensaje para alejar el documento |
 
 ### Eventos
 
@@ -426,13 +482,18 @@ document-detector::part(mb-camera-video) {
 
 ```typescript
 enum StatusDocumentDetector {
-  INITIALIZING = "INITIALIZING",
-  READY = "READY",
   RECORDING = "RECORDING",
+  ERROR = "ERROR",
   RUNNING = "RUNNING",
+  INITIALIZING = "INITIALIZING",
+  FRONT_SIDE_DETECTION = "FRONT_SIDE_DETECTION",
+  BACK_SIDE_DETECTION = "BACK_SIDE_DETECTION",
+  DOCUMENT_NOT_FOUND = "DOCUMENT_NOT_FOUND",
+  DOCUMENT_DETECTED = "DOCUMENT_DETECTED",
+  CHANGE_SIDE = "CHANGE_SIDE",
   RESULTS_SUCCESS = "RESULTS_SUCCESS",
-  DETECTION_FAILED = "DETECTION_FAILED",
-  ERROR = "ERROR"
+  RESULTS_EMPTY = "RESULTS_EMPTY",
+  DETECTION_FAILED = "DETECTION_FAILED"
 }
 ```
 

package/dist/cjs/document-detector_19.cjs.entry.js

@@ -6124,7 +6124,7 @@ const DocumentDetector = class {
     };
     this.ready = {
       emit: (data) => {
-        this.status.emit(StatusDocumentDetector.INITIALIZING);
+        this.status.emit(StatusDocumentDetector.RECORDING);
         return undefined;
       }
     };
@@ -6143,13 +6143,12 @@ const DocumentDetector = class {
     };
     this.feedback = {
       emit: (data) => {
-        console.log(data);
         return undefined;
       }
     };
     this.cameraScanStarted = {
       emit: () => {
-        this.status.emit(StatusDocumentDetector.RECORDING);
+        this.status.emit(StatusDocumentDetector.FRONT_SIDE_DETECTION);
         return undefined;
       }
     };
@@ -6217,6 +6216,7 @@ const DocumentDetector = class {
     this.mbComponentEl.setUiState(state);
   }
   async startCameraScan() {
+    this.status.emit(StatusDocumentDetector.INITIALIZING);
     this.mbComponentEl.startCameraScan();
   }
   async startImageScan(file) {
@@ -6340,7 +6340,7 @@ const DocumentDetector = class {
       }, onFeedback: (ev) => {
         this.feedbackEl.show(ev.detail);
         this.feedback.emit(ev.detail);
-      }, onScanSuccess: (ev) => this.scanSuccess.emit(ev.detail), onReady: (ev) => this.ready.emit(ev.detail), onCameraScanStarted: (ev) => this.cameraScanStarted.emit(ev.detail), onImageScanStarted: (ev) => this.imageScanStarted.emit(ev.detail), onScanError: (ev) => this.scanError.emit(ev.detail), onScanAborted: (ev) => this.scanAborted.emit(ev.detail) })), index.h("mb-feedback", { dir: this.hostEl.getAttribute("dir"), visible: !this.hideFeedback, ref: (el) => (this.feedbackEl = el) }))));
+      }, onScanSuccess: (ev) => this.scanSuccess.emit(ev.detail), onReady: (ev) => this.ready.emit(ev.detail), onCameraScanStarted: (ev) => this.cameraScanStarted.emit(ev.detail), onImageScanStarted: (ev) => this.imageScanStarted.emit(ev.detail), onScanError: (ev) => this.scanError.emit(ev.detail), onScanAborted: (ev) => this.scanAborted.emit(ev.detail), onStatus: (ev) => this.status.emit(ev.detail) })), index.h("mb-feedback", { dir: this.hostEl.getAttribute("dir"), visible: !this.hideFeedback, ref: (el) => (this.feedbackEl = el) }))));
   }
   get hostEl() { return index.getElement(this); }
   static get watchers() { return {
@@ -6988,6 +6988,7 @@ const MbComponent = class {
     this.imageScanStarted = index.createEvent(this, "imageScanStarted", 7);
     this.scanAborted = index.createEvent(this, "scanAborted", 7);
     this.setIsCameraActive = index.createEvent(this, "setIsCameraActive", 7);
+    this.status = index.createEvent(this, "status", 7);
     this.screens = {
       action: null,
       error: null,
@@ -7377,9 +7378,11 @@ const MbComponent = class {
           break;
         case RecognitionStatus.DetectionStatusFail:
           this.cameraExperience.setState(CameraExperienceState.Default, this.isBackSide);
+          this.status.emit(StatusDocumentDetector.DOCUMENT_NOT_FOUND);
           break;
         case RecognitionStatus.DetectionStatusSuccess:
           this.detectionSuccessLock = true;
+          this.status.emit(StatusDocumentDetector.DOCUMENT_DETECTED);
           window.setTimeout(() => {
             if (this.detectionSuccessLock) {
               this.cameraExperience.setState(CameraExperienceState.Detection);
@@ -7523,6 +7526,8 @@ const MbComponent = class {
           break;
         // handle flipping of other documents
         case RecognitionStatus.OnFirstSideResult:
+          this.status.emit(StatusDocumentDetector.CHANGE_SIDE);
+          this.status.emit(StatusDocumentDetector.BACK_SIDE_DETECTION);
           this.sdkService.videoRecognizer.pauseRecognition();
           window.setTimeout(async () => {
             if (this.areHelpScreensOpen) {

package/dist/collection/components/document-detector/document-detector.js

@@ -39,7 +39,7 @@ export class DocumentDetector {
     };
     this.ready = {
       emit: (data) => {
-        this.status.emit(StatusDocumentDetector.INITIALIZING);
+        this.status.emit(StatusDocumentDetector.RECORDING);
         return undefined;
       }
     };
@@ -58,13 +58,12 @@ export class DocumentDetector {
     };
     this.feedback = {
       emit: (data) => {
-        console.log(data);
         return undefined;
       }
     };
     this.cameraScanStarted = {
       emit: () => {
-        this.status.emit(StatusDocumentDetector.RECORDING);
+        this.status.emit(StatusDocumentDetector.FRONT_SIDE_DETECTION);
         return undefined;
       }
     };
@@ -132,6 +131,7 @@ export class DocumentDetector {
     this.mbComponentEl.setUiState(state);
   }
   async startCameraScan() {
+    this.status.emit(StatusDocumentDetector.INITIALIZING);
     this.mbComponentEl.startCameraScan();
   }
   async startImageScan(file) {
@@ -255,7 +255,7 @@ export class DocumentDetector {
       }, onFeedback: (ev) => {
         this.feedbackEl.show(ev.detail);
         this.feedback.emit(ev.detail);
-      }, onScanSuccess: (ev) => this.scanSuccess.emit(ev.detail), onReady: (ev) => this.ready.emit(ev.detail), onCameraScanStarted: (ev) => this.cameraScanStarted.emit(ev.detail), onImageScanStarted: (ev) => this.imageScanStarted.emit(ev.detail), onScanError: (ev) => this.scanError.emit(ev.detail), onScanAborted: (ev) => this.scanAborted.emit(ev.detail) })), h("mb-feedback", { dir: this.hostEl.getAttribute("dir"), visible: !this.hideFeedback, ref: (el) => (this.feedbackEl = el) }))));
+      }, onScanSuccess: (ev) => this.scanSuccess.emit(ev.detail), onReady: (ev) => this.ready.emit(ev.detail), onCameraScanStarted: (ev) => this.cameraScanStarted.emit(ev.detail), onImageScanStarted: (ev) => this.imageScanStarted.emit(ev.detail), onScanError: (ev) => this.scanError.emit(ev.detail), onScanAborted: (ev) => this.scanAborted.emit(ev.detail), onStatus: (ev) => this.status.emit(ev.detail) })), h("mb-feedback", { dir: this.hostEl.getAttribute("dir"), visible: !this.hideFeedback, ref: (el) => (this.feedbackEl = el) }))));
   }
   static get is() { return "document-detector"; }
   static get encapsulation() { return "shadow"; }

package/dist/collection/components/shared/mb-component/mb-component.js

@@ -1,10 +1,11 @@
-import { Host, h, } from "@stencil/core";
-import { CameraExperienceState, Code, MultiSideImageType, FeedbackCode, ImageRecognitionType, RecognitionStatus, SDKError, } from "../../../utils/data-structures";
+import { h, Host, } from "@stencil/core";
+import { CameraExperienceState, Code, FeedbackCode, ImageRecognitionType, MultiSideImageType, RecognitionStatus, SDKError, } from "../../../utils/data-structures";
 import * as ErrorTypes from "../../../utils/error-structures";
-import { sdkErrors, ErrorCodes, LicenseErrorType, } from "@microblink/blinkid-in-browser-sdk";
+import { ErrorCodes, LicenseErrorType, sdkErrors, } from "@microblink/blinkid-in-browser-sdk";
 import * as DeviceHelpers from "../../../utils/device.helpers";
 import * as GenericHelpers from "../../../utils/generic.helpers";
 import * as Utils from "./mb-component.utils";
+import { StatusDocumentDetector } from "../../../utils/status.document-detector";
 export class MbComponent {
   constructor() {
     this.screens = {
@@ -396,9 +397,11 @@ export class MbComponent {
           break;
         case RecognitionStatus.DetectionStatusFail:
           this.cameraExperience.setState(CameraExperienceState.Default, this.isBackSide);
+          this.status.emit(StatusDocumentDetector.DOCUMENT_NOT_FOUND);
           break;
         case RecognitionStatus.DetectionStatusSuccess:
           this.detectionSuccessLock = true;
+          this.status.emit(StatusDocumentDetector.DOCUMENT_DETECTED);
           window.setTimeout(() => {
             if (this.detectionSuccessLock) {
               this.cameraExperience.setState(CameraExperienceState.Detection);
@@ -542,6 +545,8 @@ export class MbComponent {
           break;
         // handle flipping of other documents
         case RecognitionStatus.OnFirstSideResult:
+          this.status.emit(StatusDocumentDetector.CHANGE_SIDE);
+          this.status.emit(StatusDocumentDetector.BACK_SIDE_DETECTION);
           this.sdkService.videoRecognizer.pauseRecognition();
           window.setTimeout(async () => {
             if (this.areHelpScreensOpen) {
@@ -2150,6 +2155,26 @@ export class MbComponent {
           "resolved": "boolean",
           "references": {}
         }
+      }, {
+        "method": "status",
+        "name": "status",
+        "bubbles": true,
+        "cancelable": true,
+        "composed": true,
+        "docs": {
+          "tags": [],
+          "text": ""
+        },
+        "complexType": {
+          "original": "StatusDocumentDetector",
+          "resolved": "StatusDocumentDetector.BACK_SIDE_DETECTION | StatusDocumentDetector.CHANGE_SIDE | StatusDocumentDetector.DETECTION_FAILED | StatusDocumentDetector.DOCUMENT_DETECTED | StatusDocumentDetector.DOCUMENT_NOT_FOUND | StatusDocumentDetector.ERROR | StatusDocumentDetector.FRONT_SIDE_DETECTION | StatusDocumentDetector.INITIALIZING | StatusDocumentDetector.RECORDING | StatusDocumentDetector.RESULTS_EMPTY | StatusDocumentDetector.RESULTS_SUCCESS | StatusDocumentDetector.RUNNING",
+          "references": {
+            "StatusDocumentDetector": {
+              "location": "import",
+              "path": "../../../utils/status.document-detector"
+            }
+          }
+        }
       }];
   }
   static get methods() {

package/dist/esm/document-detector_19.entry.js

@@ -6120,7 +6120,7 @@ const DocumentDetector = class {
     };
     this.ready = {
       emit: (data) => {
-        this.status.emit(StatusDocumentDetector.INITIALIZING);
+        this.status.emit(StatusDocumentDetector.RECORDING);
         return undefined;
       }
     };
@@ -6139,13 +6139,12 @@ const DocumentDetector = class {
     };
     this.feedback = {
       emit: (data) => {
-        console.log(data);
         return undefined;
       }
     };
     this.cameraScanStarted = {
       emit: () => {
-        this.status.emit(StatusDocumentDetector.RECORDING);
+        this.status.emit(StatusDocumentDetector.FRONT_SIDE_DETECTION);
         return undefined;
       }
     };
@@ -6213,6 +6212,7 @@ const DocumentDetector = class {
     this.mbComponentEl.setUiState(state);
   }
   async startCameraScan() {
+    this.status.emit(StatusDocumentDetector.INITIALIZING);
     this.mbComponentEl.startCameraScan();
   }
   async startImageScan(file) {
@@ -6336,7 +6336,7 @@ const DocumentDetector = class {
       }, onFeedback: (ev) => {
         this.feedbackEl.show(ev.detail);
         this.feedback.emit(ev.detail);
-      }, onScanSuccess: (ev) => this.scanSuccess.emit(ev.detail), onReady: (ev) => this.ready.emit(ev.detail), onCameraScanStarted: (ev) => this.cameraScanStarted.emit(ev.detail), onImageScanStarted: (ev) => this.imageScanStarted.emit(ev.detail), onScanError: (ev) => this.scanError.emit(ev.detail), onScanAborted: (ev) => this.scanAborted.emit(ev.detail) })), h("mb-feedback", { dir: this.hostEl.getAttribute("dir"), visible: !this.hideFeedback, ref: (el) => (this.feedbackEl = el) }))));
+      }, onScanSuccess: (ev) => this.scanSuccess.emit(ev.detail), onReady: (ev) => this.ready.emit(ev.detail), onCameraScanStarted: (ev) => this.cameraScanStarted.emit(ev.detail), onImageScanStarted: (ev) => this.imageScanStarted.emit(ev.detail), onScanError: (ev) => this.scanError.emit(ev.detail), onScanAborted: (ev) => this.scanAborted.emit(ev.detail), onStatus: (ev) => this.status.emit(ev.detail) })), h("mb-feedback", { dir: this.hostEl.getAttribute("dir"), visible: !this.hideFeedback, ref: (el) => (this.feedbackEl = el) }))));
   }
   get hostEl() { return getElement(this); }
   static get watchers() { return {
@@ -6984,6 +6984,7 @@ const MbComponent = class {
     this.imageScanStarted = createEvent(this, "imageScanStarted", 7);
     this.scanAborted = createEvent(this, "scanAborted", 7);
     this.setIsCameraActive = createEvent(this, "setIsCameraActive", 7);
+    this.status = createEvent(this, "status", 7);
     this.screens = {
       action: null,
       error: null,
@@ -7373,9 +7374,11 @@ const MbComponent = class {
           break;
         case RecognitionStatus.DetectionStatusFail:
           this.cameraExperience.setState(CameraExperienceState.Default, this.isBackSide);
+          this.status.emit(StatusDocumentDetector.DOCUMENT_NOT_FOUND);
           break;
         case RecognitionStatus.DetectionStatusSuccess:
           this.detectionSuccessLock = true;
+          this.status.emit(StatusDocumentDetector.DOCUMENT_DETECTED);
           window.setTimeout(() => {
             if (this.detectionSuccessLock) {
               this.cameraExperience.setState(CameraExperienceState.Detection);
@@ -7519,6 +7522,8 @@ const MbComponent = class {
           break;
         // handle flipping of other documents
         case RecognitionStatus.OnFirstSideResult:
+          this.status.emit(StatusDocumentDetector.CHANGE_SIDE);
+          this.status.emit(StatusDocumentDetector.BACK_SIDE_DETECTION);
           this.sdkService.videoRecognizer.pauseRecognition();
           window.setTimeout(async () => {
             if (this.areHelpScreensOpen) {