@neofaceid/web-sdk 1.40.3 → 1.41.1

package/README.md

@@ -192,7 +192,7 @@ startBiometricRegistration(
   'seu-token-de-aplicacao',
   {
     onSuccess: result => console.log('Cadastro concluído:', result.person_id),
-    onError: (code, message) => console.error(code, message),
+    onError: err => console.error(err.type, err.message),
   },
   { appName: 'Minha Aplicação' }
 );
@@ -210,7 +210,7 @@ startLivenessCapture(
   'seu-token-de-aplicacao',
   {
     onSuccess: (photos: Blob[]) => console.log(`${photos.length} fotos capturadas`),
-    onError: (code, message) => console.error(code, message),
+    onError: err => console.error(err.type, err.message),
     onCancel: () => console.log('Usuário fechou o modal'),
   },
   { appName: 'Minha Aplicação' }
@@ -347,14 +347,14 @@ function onError(err: NeoFaceError) {
 }
 ```
 
-> Os fluxos legados `start`, `startBiometricRegistration` e
-> `startLivenessCapture` ainda usam `onError(code: string, message: string)`
-> em vez de `onError(err: NeoFaceError)` — consulte o `CHANGELOG.md` antes de
-> migrar código que dependa dessa assinatura.
+> Desde a 1.41.0, `start`, `startBiometricRegistration` e
+> `startLivenessCapture` também usam `onError(err: NeoFaceError)` — antes
+> usavam `onError(code: string, message: string)`. Veja o `CHANGELOG.md`
+> (breaking change) se seu código ainda depende da assinatura antiga.
 
 | `ErrorType`             | Quando ocorre                                                  |
 | ----------------------- | --------------------------------------------------------------- |
-| `NETWORK`               | Erro de conexão com o servidor (alias `@deprecated`: `NETWORK_ERROR`) |
+| `NETWORK`               | Erro de conexão com o servidor                                  |
 | `INVALID_TOKEN`         | `applicationToken` inválido ou expirado                         |
 | `RECOGNITION_FAILED`    | Falha no reconhecimento facial                                  |
 | `LOGIN_FAILED`          | Falha no login biométrico                                       |

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import { default as default_2 } from 'react';
 import { JSX as JSX_2 } from 'react/jsx-runtime';
 import { z } from 'zod';
 
@@ -223,7 +224,7 @@ declare const BiometricLoginResultSchema: z.ZodObject<{
 
 declare interface BiometricRegistrationCallbacks {
     onSuccess(result: BiometricRegistrationResult): void;
-    onError(code: string, message: string): void;
+    onError(err: NeoFaceError): void;
 }
 
 export declare function BiometricRegistrationModal({ personData, applicationToken, onClose, onSuccess, onPhotosCaptured, onError, onCannotGesture, autoLighting, }: BiometricRegistrationModalProps): JSX_2.Element;
@@ -297,7 +298,40 @@ declare interface Callbacks {
         email: string;
         documentId: string;
     }): void;
-    onError(code: string, message: string): void;
+    onError(err: NeoFaceError): void;
+}
+
+/**
+ * Componente de guia oval para captura facial.
+ *
+ * Renderiza o preview da câmera com um oval SVG sobreposto e um halo colorido
+ * que indica o estado de posicionamento do rosto em tempo real.
+ *
+ * @example
+ * ```tsx
+ * <CameraOvalGuide
+ *   stream={mediaStream}
+ *   faceState="centered"
+ *   instruction="Mantenha o rosto no oval"
+ * />
+ * ```
+ */
+export declare function CameraOvalGuide({ stream, faceState, instruction, className, style, }: CameraOvalGuideProps): JSX_2.Element;
+
+/**
+ * Props do componente CameraOvalGuide.
+ */
+export declare interface CameraOvalGuideProps {
+    /** Stream de vídeo da câmera. Null enquanto aguarda permissão. */
+    stream: MediaStream | null;
+    /** Estado de posicionamento do rosto — controla a cor do halo. */
+    faceState: FaceState;
+    /** Instrução textual exibida abaixo do oval (ex: "Aproxime o rosto"). */
+    instruction: string;
+    /** Classe CSS adicional aplicada ao container externo. */
+    className?: string;
+    /** Estilos inline adicionais aplicados ao container externo. */
+    style?: default_2.CSSProperties;
 }
 
 /**
@@ -593,8 +627,6 @@ export declare const ENVIRONMENT_URLS: Record<Environment, string>;
  */
 export declare enum ErrorType {
     NETWORK = "NetworkError",
-    /** @deprecated Use `ErrorType.NETWORK`. Mantido para compatibilidade com consumidores existentes do SDK. */
-    NETWORK_ERROR = "NetworkError",
     INVALID_TOKEN = "InvalidTokenError",
     RECOGNITION_FAILED = "RecognitionFailedError",
     LOGIN_FAILED = "LoginFailedError",
@@ -629,6 +661,16 @@ declare interface FaceCaptureModalProps {
     autoLighting?: boolean;
 }
 
+/**
+ * Estado de posicionamento do rosto detectado.
+ * - `searching` — nenhum rosto detectado ainda
+ * - `too-far` — rosto muito distante da câmera
+ * - `too-close` — rosto muito próximo da câmera
+ * - `off-center` — rosto fora do centro do oval
+ * - `centered` — rosto corretamente posicionado
+ */
+export declare type FaceState = 'searching' | 'too-far' | 'too-close' | 'off-center' | 'centered';
+
 /**
  * Classe para gerenciar o prompt de fallback
  */
@@ -1632,7 +1674,7 @@ export declare function startHandLogin(options: BiometricLoginOptions): Promise<
  */
 export declare function startLivenessCapture(applicationToken: string, callbacks: {
     onSuccess(photos: Blob[]): void;
-    onError(code: string, message: string): void;
+    onError(err: NeoFaceError): void;
     onCancel?(): void;
 }, options?: {
     appName?: string;
@@ -1739,7 +1781,7 @@ export declare const validateToken: (applicationToken: string) => Promise<boolea
  * MINOR: Incrementado quando adicionamos funcionalidades mantendo compatibilidade
  * PATCH: Incrementado quando corrigimos bugs mantendo compatibilidade
  */
-export declare const VERSION = "1.40.3";
+export declare const VERSION = "1.41.1";
 
 /**
  * Executa `fn(sessionId)`. Se o servidor devolver 410 (sessão consumida/expirada),

package/dist/neoface-id-sdk.es.js

@@ -148,7 +148,6 @@ const useCamera = () => {
 };
 var ErrorType = /* @__PURE__ */ ((ErrorType2) => {
   ErrorType2["NETWORK"] = "NetworkError";
-  ErrorType2["NETWORK_ERROR"] = "NetworkError";
   ErrorType2["INVALID_TOKEN"] = "InvalidTokenError";
   ErrorType2["RECOGNITION_FAILED"] = "RecognitionFailedError";
   ErrorType2["LOGIN_FAILED"] = "LoginFailedError";
@@ -4804,11 +4803,14 @@ const validateToken = async (applicationToken) => {
   } catch (error) {
     if (error instanceof Error) {
       if (error.name === "AbortError") {
-        throw new NeoFaceError("Request timeout", ErrorType.NETWORK_ERROR);
+        throw new NeoFaceError("Request timeout", ErrorType.NETWORK);
       }
-      throw new NeoFaceError(error.message, ErrorType.NETWORK_ERROR);
+      if (error instanceof NeoFaceError) {
+        throw error;
+      }
+      throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error", ErrorType.NETWORK);
   }
 };
 const getOnboardingDetails = async (applicationToken, onboardingToken) => {
@@ -4846,7 +4848,7 @@ const getOnboardingDetails = async (applicationToken, onboardingToken) => {
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Erro desconhecido", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Erro desconhecido", ErrorType.NETWORK);
   }
 };
 const validateOnboardingToken = async (applicationToken, onboardingToken) => {
@@ -4884,7 +4886,7 @@ const validateOnboardingToken = async (applicationToken, onboardingToken) => {
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Erro desconhecido", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Erro desconhecido", ErrorType.NETWORK);
   }
 };
 const completeOnboarding = async (applicationToken, onboardingToken, faceImage, documentImage) => {
@@ -4951,7 +4953,7 @@ const completeOnboarding = async (applicationToken, onboardingToken, faceImage,
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Erro desconhecido", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Erro desconhecido", ErrorType.NETWORK);
   }
 };
 const completeOnboardingWithData = async (applicationToken, onboardingToken, personData, personImages, documentImage) => {
@@ -5037,7 +5039,7 @@ const completeOnboardingWithData = async (applicationToken, onboardingToken, per
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Erro desconhecido", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Erro desconhecido", ErrorType.NETWORK);
   }
 };
 const recognize = async (image, applicationToken) => {
@@ -5089,7 +5091,7 @@ const recognize = async (image, applicationToken) => {
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const loginWithBiometric = async (image, applicationToken) => {
@@ -5156,7 +5158,7 @@ const loginWithBiometric = async (image, applicationToken) => {
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const recognizeBiometric = async (image, applicationToken, livenessCheck = true, confidenceThreshold = 0.8) => {
@@ -5210,7 +5212,7 @@ const recognizeBiometric = async (image, applicationToken, livenessCheck = true,
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const simpleIdentification = async (documentType, documentNumber, applicationToken, purpose = "LOGIN") => {
@@ -5256,7 +5258,7 @@ const simpleIdentification = async (documentType, documentNumber, applicationTok
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const recognizeByPurpose = async (image, applicationToken, purpose, confidenceThreshold = 0.8, signature, sessionData) => {
@@ -5322,7 +5324,7 @@ const recognizeByPurpose = async (image, applicationToken, purpose, confidenceTh
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const registerPersonWithoutFace = async (personData, applicationToken, options) => {
@@ -5590,7 +5592,7 @@ const registerPersonWithBiometric = async (personData, facePhotos, applicationTo
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const loginWithEmail = async (email2, password, applicationToken) => {
@@ -5635,7 +5637,7 @@ const loginWithEmail = async (email2, password, applicationToken) => {
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const identifyPerson = async (image, applicationToken) => {
@@ -5703,7 +5705,7 @@ const identifyPerson = async (image, applicationToken) => {
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const registerBiometric = async (personId, faceImage, applicationToken) => {
@@ -5779,7 +5781,7 @@ const registerBiometric = async (personId, faceImage, applicationToken) => {
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const registerApplication = async (jwtToken, consumerId, applicationData) => {
@@ -5848,7 +5850,7 @@ const registerApplication = async (jwtToken, consumerId, applicationData) => {
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const recordFaceVideo = async (options = {}) => {
@@ -6048,7 +6050,7 @@ const startProofOfLife = async (videoBase64, applicationToken) => {
       }
       throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const videoToBase64 = async (videoBlob) => new Promise((resolve, reject) => {
@@ -6101,10 +6103,7 @@ const registerDocumentByImage = async (personId, jwtToken, images) => {
     });
     const data = await response.json();
     if (!response.ok) {
-      throw new NeoFaceError(
-        (data == null ? void 0 : data.message) || `API Error ${response.status}`,
-        ErrorType.NETWORK_ERROR
-      );
+      throw new NeoFaceError((data == null ? void 0 : data.message) || `API Error ${response.status}`, ErrorType.NETWORK);
     }
     return {
       success: true,
@@ -6116,11 +6115,11 @@ const registerDocumentByImage = async (personId, jwtToken, images) => {
     if (error instanceof NeoFaceError) throw error;
     if (error instanceof Error) {
       if (error.name === "AbortError") {
-        throw new NeoFaceError("Request timeout", ErrorType.NETWORK_ERROR);
+        throw new NeoFaceError("Request timeout", ErrorType.NETWORK);
       }
-      throw new NeoFaceError(error.message, ErrorType.NETWORK_ERROR);
+      throw new NeoFaceError(error.message, ErrorType.NETWORK);
     }
-    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Unknown error occurred", ErrorType.NETWORK);
   }
 };
 const getTaskStatus = async (taskId, applicationToken) => {
@@ -6141,10 +6140,7 @@ const getTaskStatus = async (taskId, applicationToken) => {
     });
     const data = await response.json();
     if (!response.ok) {
-      throw new NeoFaceError(
-        (data == null ? void 0 : data.message) || `API Error ${response.status}`,
-        ErrorType.NETWORK_ERROR
-      );
+      throw new NeoFaceError((data == null ? void 0 : data.message) || `API Error ${response.status}`, ErrorType.NETWORK);
     }
     return {
       success: data.success,
@@ -6154,7 +6150,7 @@ const getTaskStatus = async (taskId, applicationToken) => {
     };
   } catch (error) {
     if (error instanceof NeoFaceError) throw error;
-    throw new NeoFaceError("Failed to fetch task status", ErrorType.NETWORK_ERROR);
+    throw new NeoFaceError("Failed to fetch task status", ErrorType.NETWORK);
   }
 };
 const identifyPersonAsync = async (image, applicationToken, options = {}) => {
@@ -6190,7 +6186,7 @@ const identifyPersonAsync = async (image, applicationToken, options = {}) => {
     }
     await new Promise((resolve) => setTimeout(resolve, interval));
   }
-  throw new NeoFaceError("Timed out waiting for identification", ErrorType.NETWORK_ERROR);
+  throw new NeoFaceError("Timed out waiting for identification", ErrorType.NETWORK);
 };
 async function requestPasswordReset(email2, applicationToken) {
   const baseUrl = getBaseUrl();
@@ -8736,7 +8732,7 @@ function BiometricRegistrationModal({
     /* @__PURE__ */ jsx("canvas", { ref: canvasRef })
   ] });
 }
-const VERSION = "1.40.3";
+const VERSION = "1.41.1";
 const RELEASE_DATE = "2026-09-10";
 const CONSENT_TRAIL_STORAGE_KEY = "neoface_consent_trail_v1";
 const CONSENT_TRAIL_MAX_LIMIT = 100;
@@ -9182,6 +9178,193 @@ const DEFAULT_CONSENT_INFO = {
   privacyPolicyUrl: DEFAULT_PRIVACY_URL,
   retentionDays: DEFAULT_RETENTION_DAYS
 };
+function getHaloStyles(state) {
+  switch (state) {
+    case "centered":
+      return {
+        borderColor: "#0E9F6E",
+        boxShadow: "0 0 0 4px rgba(14, 159, 110, 0.8), 0 0 45px rgba(14, 159, 110, 0.45)",
+        svgStroke: "#0E9F6E",
+        badgeBg: "rgba(14, 159, 110, 0.95)",
+        badgeColor: "#FFFFFF"
+      };
+    case "too-far":
+    case "too-close":
+    case "off-center":
+      return {
+        borderColor: "#F59E0B",
+        boxShadow: "0 0 0 4px rgba(245, 158, 11, 0.7), 0 0 35px rgba(245, 158, 11, 0.35)",
+        svgStroke: "#F59E0B",
+        badgeBg: "rgba(245, 158, 11, 0.95)",
+        badgeColor: "#1F2937"
+      };
+    case "searching":
+    default:
+      return {
+        borderColor: "rgba(156, 163, 175, 0.5)",
+        boxShadow: "0 0 0 4px rgba(156, 163, 175, 0.3), 0 0 20px rgba(156, 163, 175, 0.15)",
+        svgStroke: "#9CA3AF",
+        badgeBg: "rgba(55, 65, 81, 0.9)",
+        badgeColor: "#FFFFFF"
+      };
+  }
+}
+function CameraOvalGuide({
+  stream,
+  faceState,
+  instruction,
+  className = "",
+  style = {}
+}) {
+  const videoRef = useRef(null);
+  useEffect(() => {
+    const videoEl = videoRef.current;
+    if (!videoEl) return;
+    if (stream) {
+      videoEl.srcObject = stream;
+      videoEl.play().catch(() => {
+      });
+    } else {
+      videoEl.srcObject = null;
+    }
+    return () => {
+      if (stream) {
+        stream.getTracks().forEach((track) => track.stop());
+      }
+      if (videoEl) {
+        videoEl.srcObject = null;
+      }
+    };
+  }, [stream]);
+  const halo = getHaloStyles(faceState);
+  return /* @__PURE__ */ jsxs(
+    "div",
+    {
+      className: `neofaceid-camera-oval-guide-container ${className}`,
+      style: {
+        display: "flex",
+        flexDirection: "column",
+        alignItems: "center",
+        justifyContent: "center",
+        position: "relative",
+        width: "100%",
+        maxHeight: "100%",
+        padding: "16px",
+        boxSizing: "border-box",
+        ...style
+      },
+      children: [
+        /* @__PURE__ */ jsx("style", { children: `
+        .neofaceid-oval-frame {
+          width: 320px;
+          height: 400px;
+          border-radius: 50%;
+          overflow: hidden;
+          position: relative;
+          background: #000000;
+          transition: box-shadow 0.3s ease, border-color 0.3s ease;
+        }
+
+        .neofaceid-oval-video {
+          width: 100%;
+          height: 100%;
+          object-fit: cover;
+          transform: scaleX(-1);
+          display: block;
+        }
+
+        .neofaceid-oval-svg-overlay {
+          position: absolute;
+          inset: 0;
+          width: 100%;
+          height: 100%;
+          pointer-events: none;
+          z-index: 2;
+        }
+
+        .neofaceid-oval-instruction-badge {
+          margin-top: 20px;
+          padding: 10px 20px;
+          border-radius: 20px;
+          font-size: 15px;
+          font-weight: 600;
+          text-align: center;
+          max-width: 320px;
+          box-shadow: 0 4px 14px rgba(0, 0, 0, 0.25);
+          backdrop-filter: blur(8px);
+          transition: background-color 0.3s ease, color 0.3s ease;
+          z-index: 5;
+        }
+
+        @media (max-width: 640px) {
+          .neofaceid-oval-frame {
+            width: 280px;
+            height: 350px;
+          }
+        }
+      ` }),
+        /* @__PURE__ */ jsxs(
+          "div",
+          {
+            className: "neofaceid-oval-frame",
+            style: {
+              boxShadow: halo.boxShadow,
+              borderColor: halo.borderColor
+            },
+            children: [
+              /* @__PURE__ */ jsx(
+                "video",
+                {
+                  ref: videoRef,
+                  className: "neofaceid-oval-video",
+                  autoPlay: true,
+                  playsInline: true,
+                  muted: true,
+                  "data-testid": "camera-oval-video"
+                }
+              ),
+              /* @__PURE__ */ jsx(
+                "svg",
+                {
+                  className: "neofaceid-oval-svg-overlay",
+                  viewBox: "0 0 320 400",
+                  fill: "none",
+                  xmlns: "http://www.w3.org/2000/svg",
+                  children: /* @__PURE__ */ jsx(
+                    "ellipse",
+                    {
+                      cx: "160",
+                      cy: "200",
+                      rx: "140",
+                      ry: "180",
+                      stroke: halo.svgStroke,
+                      strokeWidth: "3",
+                      strokeDasharray: faceState === "searching" ? "8 8" : "none",
+                      style: { transition: "stroke 0.3s ease" }
+                    }
+                  )
+                }
+              )
+            ]
+          }
+        ),
+        instruction && /* @__PURE__ */ jsx(
+          "div",
+          {
+            className: "neofaceid-oval-instruction-badge",
+            "aria-live": "assertive",
+            style: {
+              backgroundColor: halo.badgeBg,
+              color: halo.badgeColor
+            },
+            "data-testid": "camera-oval-instruction",
+            children: instruction
+          }
+        )
+      ]
+    }
+  );
+}
 const DARK_THRESHOLD = 0.235;
 const IMPROVEMENT_TARGET = 0.12;
 const SAMPLE_INTERVAL_MS = 600;
@@ -14313,7 +14496,7 @@ const CONSENT_DENIED_MESSAGE = "Consentimento recusado pelo usuário.";
 function start(applicationToken, callbacks, options) {
   requestConsent({ appName: options == null ? void 0 : options.appName, flow: "verification" }).then((accepted) => {
     if (!accepted) {
-      callbacks.onError("CONSENT_DENIED", CONSENT_DENIED_MESSAGE);
+      callbacks.onError(new NeoFaceError(CONSENT_DENIED_MESSAGE, ErrorType.CONSENT_DENIED));
       return;
     }
     const container = document.createElement("div");
@@ -14342,14 +14525,16 @@ function start(applicationToken, callbacks, options) {
       root.render(modalElement);
     }).catch((error) => {
       cleanup();
-      callbacks.onError("TOKEN_VALIDATION_ERROR", error.message || "Failed to validate token");
+      callbacks.onError(
+        error instanceof NeoFaceError ? error : new NeoFaceError(error.message || "Failed to validate token", ErrorType.INVALID_TOKEN)
+      );
     });
   });
 }
 function startBiometricRegistration(personData, applicationToken, callbacks, options) {
   requestConsent({ appName: options == null ? void 0 : options.appName, flow: "registration" }).then((accepted) => {
     if (!accepted) {
-      callbacks.onError("CONSENT_DENIED", CONSENT_DENIED_MESSAGE);
+      callbacks.onError(new NeoFaceError(CONSENT_DENIED_MESSAGE, ErrorType.CONSENT_DENIED));
       return;
     }
     const container = document.createElement("div");
@@ -14377,7 +14562,7 @@ function startBiometricRegistration(personData, applicationToken, callbacks, opt
         },
         onError: (error) => {
           cleanup();
-          callbacks.onError("BIOMETRIC_REGISTRATION_ERROR", error);
+          callbacks.onError(new NeoFaceError(error, ErrorType.UNKNOWN));
         },
         onCannotGesture: options == null ? void 0 : options.onCannotGesture
       });
@@ -14385,14 +14570,16 @@ function startBiometricRegistration(personData, applicationToken, callbacks, opt
       rootRef.render(modalElement);
     }).catch((error) => {
       cleanup();
-      callbacks.onError("TOKEN_VALIDATION_ERROR", error.message || "Failed to validate token");
+      callbacks.onError(
+        error instanceof NeoFaceError ? error : new NeoFaceError(error.message || "Failed to validate token", ErrorType.INVALID_TOKEN)
+      );
     });
   });
 }
 function startLivenessCapture(applicationToken, callbacks, options) {
   requestConsent({ appName: options == null ? void 0 : options.appName, flow: "verification" }).then((accepted) => {
     if (!accepted) {
-      callbacks.onError("CONSENT_DENIED", CONSENT_DENIED_MESSAGE);
+      callbacks.onError(new NeoFaceError(CONSENT_DENIED_MESSAGE, ErrorType.CONSENT_DENIED));
       return;
     }
     const container = document.createElement("div");
@@ -14425,7 +14612,7 @@ function startLivenessCapture(applicationToken, callbacks, options) {
         },
         onError: (error) => {
           cleanup();
-          callbacks.onError("LIVENESS_CAPTURE_ERROR", error);
+          callbacks.onError(new NeoFaceError(error, ErrorType.UNKNOWN));
         },
         onCannotGesture: options == null ? void 0 : options.onCannotGesture
       });
@@ -14433,7 +14620,9 @@ function startLivenessCapture(applicationToken, callbacks, options) {
       rootRef.render(modalElement);
     }).catch((error) => {
       cleanup();
-      callbacks.onError("TOKEN_VALIDATION_ERROR", error.message || "Failed to validate token");
+      callbacks.onError(
+        error instanceof NeoFaceError ? error : new NeoFaceError(error.message || "Failed to validate token", ErrorType.INVALID_TOKEN)
+      );
     });
   });
 }
@@ -14441,6 +14630,7 @@ export {
   BiometricCaptureModal,
   BiometricRegistrationModal,
   BiometricStatusOverlay,
+  CameraOvalGuide,
   ConsentModal,
   DEFAULT_CONSENT_INFO,
   DocumentCaptureModal,