@neofaceid/web-sdk 2.0.1 → 2.1.1

package/dist/index.d.ts

@@ -729,7 +729,9 @@ export declare enum ErrorType {
     UNKNOWN = "UnknownError",
     CONSENT_DENIED = "ConsentDeniedError",
     /** NEO-224 · piscada real (EAR) não detectada dentro da janela de liveness. */
-    LIVENESS_BLINK_MISSING = "LivenessBlinkMissingError"
+    LIVENESS_BLINK_MISSING = "LivenessBlinkMissingError",
+    /** NEO-230 · polegar para cima não detectado na janela de authorizeOperation. */
+    GESTURE_NOT_DETECTED = "GestureNotDetectedError"
 }
 
 export declare function FaceCaptureModal({ accessToken, onClose, onSuccess, onCannotGesture, autoLighting, }: FaceCaptureModalProps): JSX_2.Element;
@@ -1391,7 +1393,7 @@ export declare const registerPersonWithoutFace: (personData: {
 /**
  * Data de lançamento da versão atual
  */
-export declare const RELEASE_DATE = "2026-09-20";
+export declare const RELEASE_DATE = "2026-09-23";
 
 declare interface RequestChallengeWithSessionParams {
     applicationToken: string;
@@ -1864,7 +1866,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 = "2.0.1";
+export declare const VERSION = "2.1.1";
 
 /**
  * Executa `fn(sessionId)`. Se o servidor devolver 410 (sessão consumida/expirada),

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

@@ -162,6 +162,7 @@ var ErrorType = /* @__PURE__ */ ((ErrorType2) => {
   ErrorType2["UNKNOWN"] = "UnknownError";
   ErrorType2["CONSENT_DENIED"] = "ConsentDeniedError";
   ErrorType2["LIVENESS_BLINK_MISSING"] = "LivenessBlinkMissingError";
+  ErrorType2["GESTURE_NOT_DETECTED"] = "GestureNotDetectedError";
   return ErrorType2;
 })(ErrorType || {});
 class NeoFaceError extends Error {
@@ -201,6 +202,8 @@ class NeoFaceError extends Error {
         return "É necessário aceitar o uso do seu rosto para continuar.";
       case "LivenessBlinkMissingError":
         return "Não detectamos uma piscada. Pisque os olhos naturalmente e tente novamente.";
+      case "GestureNotDetectedError":
+        return "Não detectamos o polegar para cima. Mostre o gesto claramente para a câmera e tente novamente.";
       case "ApiError":
         if (this.message.includes("400")) return "Requisição inválida. Tente novamente.";
         if (this.message.includes("500"))
@@ -6095,7 +6098,7 @@ const recordFaceVideo = async (options = {}) => {
 const pollTaskStatus = async (taskId, applicationToken, options = {}) => {
   var _a2, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   const { maxAttempts = 60, intervalMs = 1e3, onStatusChange } = options;
-  const wait = (ms = intervalMs) => new Promise((resolve) => {
+  const wait2 = (ms = intervalMs) => new Promise((resolve) => {
     setTimeout(resolve, ms);
   });
   const retryAfterMs = (response) => {
@@ -6131,12 +6134,12 @@ const pollTaskStatus = async (taskId, applicationToken, options = {}) => {
       }
       if (response.status >= 500) {
         lastTransient = `HTTP ${response.status}`;
-        await wait();
+        await wait2();
         continue;
       }
       if (response.status === 429) {
         lastTransient = "HTTP 429";
-        await wait(retryAfterMs(response));
+        await wait2(retryAfterMs(response));
         continue;
       }
       if (response.status === 401 || response.status === 403) {
@@ -6165,13 +6168,13 @@ const pollTaskStatus = async (taskId, applicationToken, options = {}) => {
         const reason = ((_h = (_g = data.data) == null ? void 0 : _g.result) == null ? void 0 : _h.message) || ((_i = data.data) == null ? void 0 : _i.error) || ((_j = data.data) == null ? void 0 : _j.message) || data.message || "Task failed";
         throw new NeoFaceError(reason, ErrorType.RECOGNITION_FAILED);
       }
-      await wait();
+      await wait2();
     } catch (error) {
       if (error instanceof NeoFaceError) {
         throw error;
       }
       lastTransient = error instanceof Error ? error.message : "erro desconhecido";
-      await wait();
+      await wait2();
     }
   }
   throw new NeoFaceError(
@@ -6633,9 +6636,9 @@ function ScreenFlashOverlay({
     ] })
   ] });
 }
-const POLL_INTERVAL_MS = 50;
+const POLL_INTERVAL_MS$1 = 50;
 const MIN_HORIZONTAL_DISTANCE = 1e-6;
-function distance(a, b) {
+function distance$1(a, b) {
   return Math.hypot(a.x - b.x, a.y - b.y);
 }
 function calculateEAR(eyePoints) {
@@ -6643,9 +6646,9 @@ function calculateEAR(eyePoints) {
     throw new Error(`calculateEAR espera exatamente 6 pontos do olho, recebeu ${eyePoints.length}`);
   }
   const [p1, p2, p3, p4, p5, p6] = eyePoints;
-  const verticalA = distance(p2, p6);
-  const verticalB = distance(p3, p5);
-  const horizontal = distance(p1, p4);
+  const verticalA = distance$1(p2, p6);
+  const verticalB = distance$1(p3, p5);
+  const horizontal = distance$1(p1, p4);
   if (horizontal < MIN_HORIZONTAL_DISTANCE) return 0;
   return (verticalA + verticalB) / (2 * horizontal);
 }
@@ -6682,9 +6685,9 @@ function detectBlinkInWindow(faceapi2, videoEl, windowMs = 3e3, threshold = 0.2,
             return;
           }
         }
-        setTimeout(checkFrame, POLL_INTERVAL_MS);
+        setTimeout(checkFrame, POLL_INTERVAL_MS$1);
       }).catch(() => {
-        setTimeout(checkFrame, POLL_INTERVAL_MS);
+        setTimeout(checkFrame, POLL_INTERVAL_MS$1);
       });
     };
     checkFrame();
@@ -8916,8 +8919,8 @@ function BiometricRegistrationModal({
     /* @__PURE__ */ jsx("canvas", { ref: canvasRef })
   ] });
 }
-const VERSION = "2.0.1";
-const RELEASE_DATE = "2026-09-20";
+const VERSION = "2.1.1";
+const RELEASE_DATE = "2026-09-23";
 const CONSENT_TRAIL_STORAGE_KEY = "neoface_consent_trail_v1";
 const CONSENT_TRAIL_MAX_LIMIT = 100;
 async function hashString(inputStr) {
@@ -13325,6 +13328,73 @@ async function registerDocumentByImage(personId, jwtToken, options = {}) {
   if (captured.backImage) images.push(captured.backImage);
   return registerDocumentByImage$1(personId, jwtToken, images);
 }
+const WRIST = 0;
+const THUMB_MCP = 2;
+const THUMB_TIP = 4;
+const OTHER_FINGERS = [
+  { tip: 8, pip: 6 },
+  // indicador
+  { tip: 12, pip: 10 },
+  // médio
+  { tip: 16, pip: 14 },
+  // anelar
+  { tip: 20, pip: 18 }
+  // mindinho
+];
+const distance = (a, b) => Math.hypot(a.x - b.x, a.y - b.y);
+function isThumbsUp(keypoints) {
+  if (keypoints.length < 21) return false;
+  const wrist = keypoints[WRIST];
+  const thumbMcp = keypoints[THUMB_MCP];
+  const thumbTip = keypoints[THUMB_TIP];
+  const thumbExtended = distance(thumbTip, wrist) > distance(thumbMcp, wrist) * 1.3;
+  if (!thumbExtended) return false;
+  return OTHER_FINGERS.every(({ tip, pip }) => {
+    const tipPoint = keypoints[tip];
+    const pipPoint = keypoints[pip];
+    return distance(tipPoint, wrist) < distance(pipPoint, wrist);
+  });
+}
+const POLL_INTERVAL_MS = 150;
+let detectorPromise = null;
+const MEDIAPIPE_HANDS_VERSION = "0.4.1675469240";
+async function createDetector() {
+  const handPoseDetection = await import("@tensorflow-models/hand-pose-detection");
+  return handPoseDetection.createDetector(handPoseDetection.SupportedModels.MediaPipeHands, {
+    runtime: "mediapipe",
+    modelType: "lite",
+    maxHands: 1,
+    solutionPath: `https://cdn.jsdelivr.net/npm/@mediapipe/hands@${MEDIAPIPE_HANDS_VERSION}`
+  });
+}
+function getDetector() {
+  if (!detectorPromise) {
+    detectorPromise = createDetector();
+  }
+  return detectorPromise;
+}
+const wait = (ms) => new Promise((resolve) => {
+  setTimeout(resolve, ms);
+});
+async function preloadGestureDetector(videoEl) {
+  const detector = await getDetector();
+  try {
+    await detector.estimateHands(videoEl, {});
+  } catch {
+  }
+}
+async function detectThumbsUp(videoEl, timeoutMs) {
+  const detector = await getDetector();
+  const deadline = Date.now() + timeoutMs;
+  while (Date.now() < deadline) {
+    const hands = await detector.estimateHands(videoEl, { flipHorizontal: true });
+    if (hands.length > 0 && isThumbsUp(hands[0].keypoints)) {
+      return true;
+    }
+    await wait(POLL_INTERVAL_MS);
+  }
+  return false;
+}
 const PHOTO_INSTRUCTIONS = [
   "Olhe diretamente para a câmera",
   "Vire levemente a cabeça para a esquerda",
@@ -13332,6 +13402,7 @@ const PHOTO_INSTRUCTIONS = [
   "Mostre o polegar para cima (👍) e olhe para a câmera"
 ];
 const TOTAL_PHOTOS = 4;
+const GESTURE_TIMEOUT_MS = 5e3;
 const authorizeOperation = async (applicationToken, cpf, options) => {
   if (!applicationToken) {
     throw new NeoFaceError("Application token is required", ErrorType.VALIDATION_ERROR);
@@ -13373,6 +13444,8 @@ const authorizeOperation = async (applicationToken, cpf, options) => {
         resolve();
       };
     });
+    preloadGestureDetector(video).catch(() => {
+    });
     const guideModal = showCameraOvalGuideModal({
       stream,
       faceState: "centered",
@@ -13393,7 +13466,19 @@ const authorizeOperation = async (applicationToken, cpf, options) => {
       if (options == null ? void 0 : options.onProgress) {
         options.onProgress(i + 1, TOTAL_PHOTOS, instruction);
       }
-      if (i > 0) {
+      const isGesturePhoto = i === TOTAL_PHOTOS - 1;
+      if (isGesturePhoto) {
+        const detected = await detectThumbsUp(video, GESTURE_TIMEOUT_MS);
+        if (!detected) {
+          guideModal.close();
+          stream.getTracks().forEach((track) => track.stop());
+          capturedPhotos.length = 0;
+          throw new NeoFaceError(
+            "Polegar para cima não detectado dentro do tempo limite.",
+            ErrorType.GESTURE_NOT_DETECTED
+          );
+        }
+      } else if (i > 0) {
         await new Promise((resolve) => setTimeout(resolve, captureDelay));
       }
       ctx.drawImage(video, 0, 0, canvas.width, canvas.height);