@neofaceid/web-sdk 1.39.1 → 1.40.1

package/dist/index.d.ts

@@ -345,6 +345,11 @@ export declare const checkUserExistence: (params: {
     cpf?: string;
 }) => Promise<UserExistenceResult>;
 
+/**
+ * Limpa o histórico de consentimentos no localStorage.
+ */
+export declare function clearConsentTrail(): void;
+
 /**
  * Conclui o processo de onboarding enviando imagens de face e documento
  * @param applicationToken Token da aplicação (header `X-App-Token`)
@@ -448,6 +453,14 @@ export declare interface ConsentModalProps {
     onDecline: () => void;
 }
 
+export declare interface ConsentRecord {
+    hash: string;
+    timestamp: string;
+    purpose: string;
+    legalBasis: string;
+    sdkVersion: string;
+}
+
 /**
  * Compatibilidade com callers antigos que passavam `{ purpose, legalBasis }`.
  * Deprecated — remover quando US14.4 unificar tokens.
@@ -483,6 +496,7 @@ export declare class DocumentCaptureModal {
     private flashController;
     private frontBlob;
     private backBlob;
+    private _previewObjectUrl;
     constructor(options?: DocumentCaptureOptions);
     open(): Promise<DocumentCaptureResult>;
     private render;
@@ -593,7 +607,9 @@ export declare enum ErrorType {
     CAPTURE_ERROR = "CaptureError",
     NOT_FOUND = "NotFoundError",
     UNKNOWN = "UnknownError",
-    CONSENT_DENIED = "ConsentDeniedError"
+    CONSENT_DENIED = "ConsentDeniedError",
+    /** NEO-224 · piscada real (EAR) não detectada dentro da janela de liveness. */
+    LIVENESS_BLINK_MISSING = "LivenessBlinkMissingError"
 }
 
 export declare function FaceCaptureModal({ accessToken, onClose, onSuccess, onCannotGesture, autoLighting, }: FaceCaptureModalProps): JSX_2.Element;
@@ -689,6 +705,12 @@ export declare function getConfig(): Readonly<SDKConfig>;
 /** Retorna os dados de consentimento configurados (ou os defaults conservadores). */
 export declare function getConsent(): Consent;
 
+/**
+ * Retorna o histórico (trail) de consentimentos gravados no localStorage.
+ * Falha silenciosamente retornando array vazio caso o localStorage esteja inacessível.
+ */
+export declare function getConsentTrail(): ConsentRecord[];
+
 /**
  * Retorna o ambiente atual configurado.
  */
@@ -1235,6 +1257,17 @@ export declare const recognizeByPurpose: (image: Blob, applicationToken: string,
     sessionId?: string;
 }>;
 
+/**
+ * Grava um novo aceite de consentimento no localStorage do titular.
+ * Zero PII: grava apenas hash (SHA-256 de userAgent+purpose+timestamp), timestamp, finalidade, base legal e versão do SDK.
+ * Mantém até no máximo 100 registros (FIFO).
+ * Falha silenciosamente em caso de erro no localStorage (ex: Safari modo privado ou QuotaExceededError).
+ */
+export declare function recordConsent(customConsent?: Partial<{
+    purpose: string;
+    legalBasis: string;
+}>): Promise<ConsentRecord | null>;
+
 /**
  * NEO-101: Register biometric data for an existing person
  *
@@ -1339,7 +1372,7 @@ export declare const registerPersonWithoutFace: (personData: {
 /**
  * Data de lançamento da versão atual
  */
-export declare const RELEASE_DATE = "2026-09-08";
+export declare const RELEASE_DATE = "2026-09-09";
 
 declare interface RequestChallengeWithSessionParams {
     applicationToken: string;
@@ -1706,7 +1739,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.39.1";
+export declare const VERSION = "1.40.1";
 
 /**
  * Executa `fn(sessionId)`. Se o servidor devolver 410 (sessão consumida/expirada),