feat: enhance liveness session handling with new checks for completion and pass status

Author: tn3w

demo/app.js

@@ -5,6 +5,7 @@ import {
     createLivenessSession,
     processFrame,
     isLivenessComplete,
+    isLivenessPassed,
     currentInstruction,
     currentTaskId,
     progress,
@@ -200,7 +201,15 @@ function startLivenessLoop() {
         }
 
         if (isLivenessComplete(livenessSession)) {
-            transition(State.ESTIMATING);
+            if (isLivenessPassed(livenessSession)) {
+                transition(State.ESTIMATING);
+            } else {
+                livenessSession.failed = true;
+                livenessSession.failReason =
+                    `Liveness incomplete. Completed ${livenessSession.completedTasks} of ` +
+                    `${livenessSession.requiredTaskPasses} required checks.`;
+                handleLivenessFail();
+            }
             return;
         }
 
@@ -223,8 +232,9 @@ function updateChallengeUI() {
         `<div class="bar" ` + `style="width:${prog * 100}%"></div>`;
 
     setVideoStatus(
-        `Complete ${livenessSession.completedTasks + 1} of ` +
-            `${livenessSession.requiredTaskPasses} required checks`
+        `Round ${Math.min(livenessSession.currentIndex + 1, livenessSession.tasks.length)} of ` +
+            `${livenessSession.tasks.length} — ` +
+            `${livenessSession.completedTasks}/${livenessSession.requiredTaskPasses} checks passed`
     );
 }
 

demo/liveness.js

@@ -107,24 +107,26 @@ export function processFrame(session, video, timestampMs) {
 }
 
 export function isLivenessComplete(session) {
+    return session.currentIndex >= session.tasks.length;
+}
+
+export function isLivenessPassed(session) {
     return session.completedTasks >= session.requiredTaskPasses;
 }
 
 export function currentInstruction(session) {
-    if (isLivenessComplete(session)) return null;
     if (session.currentIndex >= session.tasks.length) return null;
     return session.tasks[session.currentIndex].instruction;
 }
 
 export function currentTaskId(session) {
-    if (isLivenessComplete(session)) return null;
     if (session.currentIndex >= session.tasks.length) return null;
     return session.tasks[session.currentIndex].id;
 }
 
 export function progress(session) {
-    if (session.requiredTaskPasses === 0) return 1;
-    return Math.min(session.completedTasks / session.requiredTaskPasses, 1);
+    if (session.tasks.length === 0) return 1;
+    return Math.min(session.currentIndex / session.tasks.length, 1);
 }
 
 function advanceTask(session) {