@aws-amplify/ui-react-liveness 3.6.5 → 3.6.7

package/dist/esm/components/FaceLivenessDetector/FaceLivenessDetectorCore.mjs

@@ -1,13 +1,13 @@
 import * as React from 'react';
 import { useInterpret } from '@xstate/react';
 import { livenessMachine } from './service/machine/machine.mjs';
+import './service/utils/constants.mjs';
 import './service/types/liveness.mjs';
 import '@tensorflow/tfjs-core';
 import '../../packages/react-liveness/node_modules/@tensorflow-models/face-detection/dist/face-detection.esm.mjs';
 import '@tensorflow/tfjs-backend-wasm';
 import '@tensorflow/tfjs-backend-cpu';
 import '@aws-amplify/core/internals/utils';
-import './service/utils/constants.mjs';
 import './service/utils/ColorSequenceDisplay/ColorSequenceDisplay.mjs';
 import '@aws-amplify/ui';
 import './service/utils/createStreamingClient/createStreamingClient.mjs';

package/dist/esm/components/FaceLivenessDetector/LivenessCheck/LivenessCameraModule.mjs

@@ -3,6 +3,7 @@ import { classNames } from '@aws-amplify/ui';
 import { View, Flex, Loader, Text, Button } from '@aws-amplify/ui-react';
 import { useColorMode } from '@aws-amplify/ui-react/internal';
 import '../service/machine/machine.mjs';
+import { FACE_MOVEMENT_CHALLENGE } from '../service/utils/constants.mjs';
 import { FaceMatchState } from '../service/types/liveness.mjs';
 import '@tensorflow/tfjs-core';
 import '../../../packages/react-liveness/node_modules/@tensorflow-models/face-detection/dist/face-detection.esm.mjs';
@@ -10,7 +11,6 @@ import '@tensorflow/tfjs-backend-wasm';
 import '@tensorflow/tfjs-backend-cpu';
 import '@aws-amplify/core/internals/utils';
 import { drawStaticOval, clearOvalCanvas } from '../service/utils/liveness.mjs';
-import { FACE_MOVEMENT_CHALLENGE } from '../service/utils/constants.mjs';
 import '../service/utils/ColorSequenceDisplay/ColorSequenceDisplay.mjs';
 import '../service/utils/createStreamingClient/createStreamingClient.mjs';
 import '../service/utils/StreamRecorder/StreamRecorder.mjs';

package/dist/esm/components/FaceLivenessDetector/LivenessCheck/LivenessCheck.mjs

@@ -1,6 +1,7 @@
 import * as React from 'react';
 import { Flex, Text, Button, View } from '@aws-amplify/ui-react';
 import '../service/machine/machine.mjs';
+import '../service/utils/constants.mjs';
 import '../service/types/liveness.mjs';
 import { LivenessErrorState } from '../service/types/error.mjs';
 import '@tensorflow/tfjs-core';
@@ -8,7 +9,6 @@ import '../../../packages/react-liveness/node_modules/@tensorflow-models/face-de
 import '@tensorflow/tfjs-backend-wasm';
 import '@tensorflow/tfjs-backend-cpu';
 import '@aws-amplify/core/internals/utils';
-import '../service/utils/constants.mjs';
 import '../service/utils/ColorSequenceDisplay/ColorSequenceDisplay.mjs';
 import '@aws-amplify/ui';
 import '../service/utils/createStreamingClient/createStreamingClient.mjs';

package/dist/esm/components/FaceLivenessDetector/service/machine/machine.mjs

@@ -1,12 +1,12 @@
 import { v4 } from 'uuid';
 import { createMachine, assign, actions, spawn } from 'xstate';
 import { fillOverlayCanvasFractional, generateBboxFromLandmarks, getOvalBoundingBox, getIntersectionOverUnion, estimateIllumination, getOvalDetailsFromSessionInformation, drawLivenessOvalInCanvas, getStaticLivenessOvalDetails, isFaceDistanceBelowThreshold, getFaceMatchState, isCameraDeviceVirtual, getColorsSequencesFromSessionInformation } from '../utils/liveness.mjs';
+import { FACE_MOVEMENT_AND_LIGHT_CHALLENGE, FACE_MOVEMENT_CHALLENGE, WS_CLOSURE_CODE } from '../utils/constants.mjs';
 import { FaceMatchState } from '../types/liveness.mjs';
 import { LivenessErrorState } from '../types/error.mjs';
 import { BlazeFaceFaceDetection } from '../utils/blazefaceFaceDetection.mjs';
 import { getFaceMatchStateInLivenessOval } from '../utils/getFaceMatchStateInLivenessOval.mjs';
 import { ColorSequenceDisplay } from '../utils/ColorSequenceDisplay/ColorSequenceDisplay.mjs';
-import { FACE_MOVEMENT_AND_LIGHT_CHALLENGE, FACE_MOVEMENT_CHALLENGE, WS_CLOSURE_CODE } from '../utils/constants.mjs';
 import { createRequestStreamGenerator } from '../utils/createRequestStreamGenerator/createRequestStreamGenerator.mjs';
 import { createSessionEndEvent, getTrackDimensions, createColorDisplayEvent, createSessionStartEvent } from '../utils/createRequestStreamGenerator/utils.mjs';
 import { createStreamingClient } from '../utils/createStreamingClient/createStreamingClient.mjs';
@@ -203,6 +203,10 @@ const livenessMachine = createMachine({
                                 'spawnResponseStreamActor',
                             ],
                         },
+                        onError: {
+                            target: '#livenessMachine.error',
+                            actions: 'updateErrorStateForRuntime',
+                        },
                     },
                 },
                 waitForSessionInfo: {
@@ -231,6 +235,10 @@ const livenessMachine = createMachine({
                     target: 'checkFaceDetectedBeforeStart',
                     actions: 'updateFaceMatchBeforeStartDetails',
                 },
+                onError: {
+                    target: 'error',
+                    actions: 'updateErrorStateForRuntime',
+                },
             },
         },
         checkFaceDetectedBeforeStart: {
@@ -249,6 +257,10 @@ const livenessMachine = createMachine({
                     target: 'checkFaceDistanceBeforeRecording',
                     actions: 'updateFaceDistanceBeforeRecording',
                 },
+                onError: {
+                    target: 'error',
+                    actions: 'updateErrorStateForRuntime',
+                },
             },
         },
         checkFaceDistanceBeforeRecording: {
@@ -926,13 +938,7 @@ const livenessMachine = createMachine({
             const { videoEl } = context.videoAssociatedParams;
             const { faceDetector } = context.ovalAssociatedParams;
             // initialize models
-            try {
-                await faceDetector.modelLoadingPromise;
-            }
-            catch (err) {
-                // eslint-disable-next-line no-console
-                console.log({ err });
-            }
+            await faceDetector.modelLoadingPromise;
             // detect face
             const faceMatchState = await getFaceMatchState(faceDetector, videoEl);
             return { faceMatchState };
@@ -964,13 +970,7 @@ const livenessMachine = createMachine({
             const { videoEl, canvasEl, isMobile } = context.videoAssociatedParams;
             const { faceDetector } = context.ovalAssociatedParams;
             // initialize models
-            try {
-                await faceDetector.modelLoadingPromise;
-            }
-            catch (err) {
-                // eslint-disable-next-line no-console
-                console.log({ err });
-            }
+            await faceDetector.modelLoadingPromise;
             // detect face
             const detectedFaces = await faceDetector.detectFaces(videoEl);
             let initialFace;

package/dist/esm/components/FaceLivenessDetector/service/types/faceDetection.mjs

@@ -1,14 +1,40 @@
+import { CONNECTION_TIMEOUT } from '../utils/constants.mjs';
+
 /**
  * The abstract class representing FaceDetection
  * to be implemented for different libraries.
  */
 class FaceDetection {
+    constructor() {
+        this._modelLoadTriggered = false;
+    }
     /**
      * Triggers the `loadModels` method and stores
      * the corresponding promise to be awaited later.
+     * Applies a timeout to prevent indefinite hangs if the
+     * network request for model assets stalls.
      */
     triggerModelLoading() {
-        this.modelLoadingPromise = this.loadModels();
+        if (this._modelLoadTriggered) {
+            return;
+        }
+        this._modelLoadTriggered = true;
+        let timeoutId;
+        this.modelLoadingPromise = Promise.race([
+            // `finally` ensures the timeout is cleared whether loadModels
+            // resolves or rejects, preventing a leaked timer on fast failures.
+            this.loadModels().finally(() => {
+                clearTimeout(timeoutId);
+            }),
+            new Promise((_, reject) => {
+                timeoutId = setTimeout(() => reject(new Error('Face detection model loading timed out. Check your network connection and try again.')), 
+                // Uses the same 10s timeout as the WebSocket connection phase.
+                // The WASM binary (~425KB) + model (~100KB) should load well
+                // within 10s on any reasonable connection. If it hasn't loaded
+                // by then, the request is likely stalled (not just slow).
+                CONNECTION_TIMEOUT);
+            }),
+        ]);
     }
 }
 

package/dist/esm/components/FaceLivenessDetector/service/utils/createStreamingClient/CustomWebSocketFetchHandler.mjs

@@ -142,40 +142,97 @@ class CustomWebSocketFetchHandler {
         let streamError = undefined;
         // To notify onclose event that error has occurred.
         let socketErrorOccurred = false;
-        // initialize as no-op.
-        let reject = () => { };
-        let resolve = () => { };
+        // Buffer for messages that arrive before the consumer calls .next().
+        // This prevents dropped messages when the server responds faster than
+        // the client sets up its async iterator (race condition).
+        const messageQueue = [];
+        let waitingResolve = null;
+        let waitingReject = null;
+        let done = false;
+        let endError = undefined;
         socket.onmessage = (event) => {
-            resolve({
-                done: false,
-                value: new Uint8Array(event.data),
-            });
+            const chunk = new Uint8Array(event.data);
+            if (waitingResolve) {
+                // Consumer is waiting for data — deliver immediately
+                const resolve = waitingResolve;
+                waitingResolve = null;
+                waitingReject = null;
+                resolve({ done: false, value: chunk });
+            }
+            else {
+                // Consumer hasn't called .next() yet — buffer the message
+                messageQueue.push(chunk);
+            }
         };
         socket.onerror = (error) => {
             socketErrorOccurred = true;
             socket.close();
-            reject(error);
+            done = true;
+            endError = error;
+            if (waitingReject) {
+                const reject = waitingReject;
+                waitingResolve = null;
+                waitingReject = null;
+                reject(error);
+            }
         };
-        socket.onclose = () => {
+        socket.onclose = (event) => {
             this.removeNotUsableSockets(socket.url);
             if (socketErrorOccurred)
                 return;
+            done = true;
             if (streamError) {
-                reject(streamError);
+                endError = streamError;
             }
-            else {
-                resolve({
-                    done: true,
-                    value: undefined,
-                });
+            else if (event.code !== WS_CLOSURE_CODE.SUCCESS_CODE &&
+                event.code !== 1001) {
+                // Server closed the connection with an abnormal code (e.g. 4001
+                // StreamIdleTimeout, 4003 SessionExpired, 1006 abnormal closure).
+                endError = new Error(`Server ended the connection unexpectedly (code ${event.code}` +
+                    (event.reason ? `: ${event.reason}` : '') +
+                    ')');
+            }
+            if (waitingResolve) {
+                if (endError) {
+                    const reject = waitingReject;
+                    waitingResolve = null;
+                    waitingReject = null;
+                    reject(endError);
+                }
+                else {
+                    const resolve = waitingResolve;
+                    waitingResolve = null;
+                    waitingReject = null;
+                    resolve({ done: true, value: undefined });
+                }
             }
         };
         const outputStream = {
             [Symbol.asyncIterator]: () => ({
                 next: () => {
+                    // If there are buffered messages, deliver the next one immediately
+                    if (messageQueue.length > 0) {
+                        return Promise.resolve({
+                            done: false,
+                            value: messageQueue.shift(),
+                        });
+                    }
+                    // If the stream has ended, resolve/reject accordingly
+                    if (done) {
+                        if (endError) {
+                            return Promise.reject(endError instanceof Error
+                                ? endError
+                                : new Error('Stream ended with an error'));
+                        }
+                        return Promise.resolve({
+                            done: true,
+                            value: undefined,
+                        });
+                    }
+                    // Otherwise wait for the next message or close event
                     return new Promise((_resolve, _reject) => {
-                        resolve = _resolve;
-                        reject = _reject;
+                        waitingResolve = _resolve;
+                        waitingReject = _reject;
                     });
                 },
             }),
@@ -198,8 +255,7 @@ class CustomWebSocketFetchHandler {
             catch (err) {
                 // We don't throw the error here because the send()'s returned
                 // would already be settled by the time sending chunk throws error.
-                // Instead, the notify the output stream to throw if there's
-                // exceptions
+                // Instead, notify the output stream to throw if there's exceptions
                 if (err instanceof Error) {
                     streamError = err;
                 }

package/dist/esm/components/FaceLivenessDetector/service/utils/getFaceMatchStateInLivenessOval.mjs

@@ -1,6 +1,6 @@
+import { FACE_MATCH_RANGE_MAX, FACE_MATCH_WEIGHT_MAX, FACE_MATCH_WEIGHT_MIN, FACE_MATCH_RANGE_MIN } from './constants.mjs';
 import { FaceMatchState } from '../types/liveness.mjs';
 import { generateBboxFromLandmarks, getOvalBoundingBox, getIntersectionOverUnion } from './liveness.mjs';
-import { FACE_MATCH_RANGE_MAX, FACE_MATCH_WEIGHT_MAX, FACE_MATCH_WEIGHT_MIN, FACE_MATCH_RANGE_MIN } from './constants.mjs';
 
 /**
  * Returns the state of the provided face with respect to the provided liveness oval.

package/dist/esm/components/FaceLivenessDetector/service/utils/liveness.mjs

@@ -1,6 +1,6 @@
+import { OVAL_HEIGHT_WIDTH_RATIO, PUPIL_DISTANCE_WEIGHT, FACE_HEIGHT_WEIGHT } from './constants.mjs';
 import { IlluminationState, FaceMatchState } from '../types/liveness.mjs';
 import { LivenessErrorState } from '../types/error.mjs';
-import { OVAL_HEIGHT_WIDTH_RATIO, PUPIL_DISTANCE_WEIGHT, FACE_HEIGHT_WEIGHT } from './constants.mjs';
 
 /**
  * Returns the random number between min and max

package/dist/esm/components/FaceLivenessDetector/shared/DefaultStartScreenComponents.mjs

@@ -3,13 +3,13 @@ import { ComponentClassName } from '@aws-amplify/ui';
 import { Flex, View } from '@aws-amplify/ui-react';
 import { CancelButton } from './CancelButton.mjs';
 import '../service/machine/machine.mjs';
+import '../service/utils/constants.mjs';
 import '../service/types/liveness.mjs';
 import '@tensorflow/tfjs-core';
 import '../../../packages/react-liveness/node_modules/@tensorflow-models/face-detection/dist/face-detection.esm.mjs';
 import '@tensorflow/tfjs-backend-wasm';
 import '@tensorflow/tfjs-backend-cpu';
 import '@aws-amplify/core/internals/utils';
-import '../service/utils/constants.mjs';
 import '../service/utils/ColorSequenceDisplay/ColorSequenceDisplay.mjs';
 import '../service/utils/createStreamingClient/createStreamingClient.mjs';
 import '../service/utils/StreamRecorder/StreamRecorder.mjs';

package/dist/esm/components/FaceLivenessDetector/shared/FaceLivenessErrorModal.mjs

@@ -2,6 +2,7 @@ import React__default from 'react';
 import { Flex, Button, Text } from '@aws-amplify/ui-react';
 import { AlertIcon } from '@aws-amplify/ui-react/internal';
 import '../service/machine/machine.mjs';
+import '../service/utils/constants.mjs';
 import '../service/types/liveness.mjs';
 import { LivenessErrorState } from '../service/types/error.mjs';
 import '@tensorflow/tfjs-core';
@@ -9,7 +10,6 @@ import '../../../packages/react-liveness/node_modules/@tensorflow-models/face-de
 import '@tensorflow/tfjs-backend-wasm';
 import '@tensorflow/tfjs-backend-cpu';
 import '@aws-amplify/core/internals/utils';
-import '../service/utils/constants.mjs';
 import '../service/utils/ColorSequenceDisplay/ColorSequenceDisplay.mjs';
 import '@aws-amplify/ui';
 import '../service/utils/createStreamingClient/createStreamingClient.mjs';

package/dist/esm/components/FaceLivenessDetector/shared/Hint.mjs

@@ -1,13 +1,13 @@
 import * as React from 'react';
 import { VisuallyHidden, View } from '@aws-amplify/ui-react';
 import '../service/machine/machine.mjs';
+import '../service/utils/constants.mjs';
 import { FaceMatchState, IlluminationState } from '../service/types/liveness.mjs';
 import '@tensorflow/tfjs-core';
 import '../../../packages/react-liveness/node_modules/@tensorflow-models/face-detection/dist/face-detection.esm.mjs';
 import '@tensorflow/tfjs-backend-wasm';
 import '@tensorflow/tfjs-backend-cpu';
 import '@aws-amplify/core/internals/utils';
-import '../service/utils/constants.mjs';
 import '../service/utils/ColorSequenceDisplay/ColorSequenceDisplay.mjs';
 import '@aws-amplify/ui';
 import '../service/utils/createStreamingClient/createStreamingClient.mjs';

package/dist/esm/index.mjs

@@ -1,13 +1,13 @@
 export { default as FaceLivenessDetector } from './components/FaceLivenessDetector/FaceLivenessDetector.mjs';
 export { default as FaceLivenessDetectorCore } from './components/FaceLivenessDetector/FaceLivenessDetectorCore.mjs';
 import './components/FaceLivenessDetector/service/machine/machine.mjs';
+import './components/FaceLivenessDetector/service/utils/constants.mjs';
 import './components/FaceLivenessDetector/service/types/liveness.mjs';
 import '@tensorflow/tfjs-core';
 import './packages/react-liveness/node_modules/@tensorflow-models/face-detection/dist/face-detection.esm.mjs';
 import '@tensorflow/tfjs-backend-wasm';
 import '@tensorflow/tfjs-backend-cpu';
 import '@aws-amplify/core/internals/utils';
-import './components/FaceLivenessDetector/service/utils/constants.mjs';
 import './components/FaceLivenessDetector/service/utils/ColorSequenceDisplay/ColorSequenceDisplay.mjs';
 import '@aws-amplify/ui';
 import './components/FaceLivenessDetector/service/utils/createStreamingClient/createStreamingClient.mjs';

package/dist/esm/version.mjs

@@ -1,3 +1,3 @@
-const VERSION = '3.6.5';
+const VERSION = '3.6.7';
 
 export { VERSION };

package/dist/index.js

@@ -43,17 +43,89 @@ function _interopNamespace(e) {
 
 var React__namespace = /*#__PURE__*/_interopNamespace(React);
 
+// Face distance is calculated as pupilDistance / ovalWidth.
+// The further away you are from the camera the distance between your pupils will decrease, thus lowering the threshold values.
+// Constants from science team to determine ocular distance (space between eyes)
+const PUPIL_DISTANCE_WEIGHT = 2.0;
+const FACE_HEIGHT_WEIGHT = 1.8;
+// Constants from science team to find face match percentage
+const FACE_MATCH_RANGE_MIN = 0;
+const FACE_MATCH_RANGE_MAX = 1;
+const FACE_MATCH_WEIGHT_MIN = 0.25;
+const FACE_MATCH_WEIGHT_MAX = 0.75;
+const OVAL_HEIGHT_WIDTH_RATIO = 1.618;
+const WS_CLOSURE_CODE = {
+    SUCCESS_CODE: 1000,
+    DEFAULT_ERROR_CODE: 4000,
+    FACE_FIT_TIMEOUT: 4001,
+    USER_CANCEL: 4003,
+    RUNTIME_ERROR: 4005,
+    USER_ERROR_DURING_CONNECTION: 4007,
+};
+// number in milliseconds to record into each video chunk.
+// see https://developer.mozilla.org/en-US/docs/Web/API/MediaRecorder/start#timeslice
+const TIME_SLICE = 1000;
+// in MS, the rate at which colors are rendered/checked
+const TICK_RATE = 10;
+/**
+ * The number of seconds before the presigned URL expires.
+ * Used to override aws sdk default value of 60
+ */
+const REQUEST_EXPIRY = 299;
+/**
+ * The maximum time in milliseconds that the connection phase of a request
+ * may take before the connection attempt is abandoned.
+ */
+const CONNECTION_TIMEOUT = 10000;
+const FACE_MOVEMENT_AND_LIGHT_CHALLENGE = {
+    type: 'FaceMovementAndLightChallenge',
+    version: '2.0.0',
+};
+const FACE_MOVEMENT_CHALLENGE = {
+    type: 'FaceMovementChallenge',
+    version: '1.0.0',
+};
+const SUPPORTED_CHALLENGES = [
+    FACE_MOVEMENT_AND_LIGHT_CHALLENGE,
+    FACE_MOVEMENT_CHALLENGE,
+];
+const queryParameterString = SUPPORTED_CHALLENGES.map((challenge) => `${challenge.type}_${challenge.version}`).join(',');
+
 /**
  * The abstract class representing FaceDetection
  * to be implemented for different libraries.
  */
 let FaceDetection$1 = class FaceDetection {
+    constructor() {
+        this._modelLoadTriggered = false;
+    }
     /**
      * Triggers the `loadModels` method and stores
      * the corresponding promise to be awaited later.
+     * Applies a timeout to prevent indefinite hangs if the
+     * network request for model assets stalls.
      */
     triggerModelLoading() {
-        this.modelLoadingPromise = this.loadModels();
+        if (this._modelLoadTriggered) {
+            return;
+        }
+        this._modelLoadTriggered = true;
+        let timeoutId;
+        this.modelLoadingPromise = Promise.race([
+            // `finally` ensures the timeout is cleared whether loadModels
+            // resolves or rejects, preventing a leaked timer on fast failures.
+            this.loadModels().finally(() => {
+                clearTimeout(timeoutId);
+            }),
+            new Promise((_, reject) => {
+                timeoutId = setTimeout(() => reject(new Error('Face detection model loading timed out. Check your network connection and try again.')), 
+                // Uses the same 10s timeout as the WebSocket connection phase.
+                // The WASM binary (~425KB) + model (~100KB) should load well
+                // within 10s on any reasonable connection. If it hasn't loaded
+                // by then, the request is likely stalled (not just slow).
+                CONNECTION_TIMEOUT);
+            }),
+        ]);
     }
 };
 
@@ -95,54 +167,6 @@ const LivenessErrorState = {
     DEFAULT_CAMERA_NOT_FOUND_ERROR: 'DEFAULT_CAMERA_NOT_FOUND_ERROR',
 };
 
-// Face distance is calculated as pupilDistance / ovalWidth.
-// The further away you are from the camera the distance between your pupils will decrease, thus lowering the threshold values.
-// Constants from science team to determine ocular distance (space between eyes)
-const PUPIL_DISTANCE_WEIGHT = 2.0;
-const FACE_HEIGHT_WEIGHT = 1.8;
-// Constants from science team to find face match percentage
-const FACE_MATCH_RANGE_MIN = 0;
-const FACE_MATCH_RANGE_MAX = 1;
-const FACE_MATCH_WEIGHT_MIN = 0.25;
-const FACE_MATCH_WEIGHT_MAX = 0.75;
-const OVAL_HEIGHT_WIDTH_RATIO = 1.618;
-const WS_CLOSURE_CODE = {
-    SUCCESS_CODE: 1000,
-    DEFAULT_ERROR_CODE: 4000,
-    FACE_FIT_TIMEOUT: 4001,
-    USER_CANCEL: 4003,
-    RUNTIME_ERROR: 4005,
-    USER_ERROR_DURING_CONNECTION: 4007,
-};
-// number in milliseconds to record into each video chunk.
-// see https://developer.mozilla.org/en-US/docs/Web/API/MediaRecorder/start#timeslice
-const TIME_SLICE = 1000;
-// in MS, the rate at which colors are rendered/checked
-const TICK_RATE = 10;
-/**
- * The number of seconds before the presigned URL expires.
- * Used to override aws sdk default value of 60
- */
-const REQUEST_EXPIRY = 299;
-/**
- * The maximum time in milliseconds that the connection phase of a request
- * may take before the connection attempt is abandoned.
- */
-const CONNECTION_TIMEOUT = 10000;
-const FACE_MOVEMENT_AND_LIGHT_CHALLENGE = {
-    type: 'FaceMovementAndLightChallenge',
-    version: '2.0.0',
-};
-const FACE_MOVEMENT_CHALLENGE = {
-    type: 'FaceMovementChallenge',
-    version: '1.0.0',
-};
-const SUPPORTED_CHALLENGES = [
-    FACE_MOVEMENT_AND_LIGHT_CHALLENGE,
-    FACE_MOVEMENT_CHALLENGE,
-];
-const queryParameterString = SUPPORTED_CHALLENGES.map((challenge) => `${challenge.type}_${challenge.version}`).join(',');
-
 /**
  * Returns the random number between min and max
  * seeded with the provided random seed.
@@ -1227,7 +1251,7 @@ function createRequestStreamGenerator(stream) {
     };
 }
 
-const VERSION = '3.6.5';
+const VERSION = '3.6.7';
 
 const BASE_USER_AGENT = `ui-react-liveness/${VERSION}`;
 const getLivenessUserAgent = () => {
@@ -1372,40 +1396,97 @@ class CustomWebSocketFetchHandler {
         let streamError = undefined;
         // To notify onclose event that error has occurred.
         let socketErrorOccurred = false;
-        // initialize as no-op.
-        let reject = () => { };
-        let resolve = () => { };
+        // Buffer for messages that arrive before the consumer calls .next().
+        // This prevents dropped messages when the server responds faster than
+        // the client sets up its async iterator (race condition).
+        const messageQueue = [];
+        let waitingResolve = null;
+        let waitingReject = null;
+        let done = false;
+        let endError = undefined;
         socket.onmessage = (event) => {
-            resolve({
-                done: false,
-                value: new Uint8Array(event.data),
-            });
+            const chunk = new Uint8Array(event.data);
+            if (waitingResolve) {
+                // Consumer is waiting for data — deliver immediately
+                const resolve = waitingResolve;
+                waitingResolve = null;
+                waitingReject = null;
+                resolve({ done: false, value: chunk });
+            }
+            else {
+                // Consumer hasn't called .next() yet — buffer the message
+                messageQueue.push(chunk);
+            }
         };
         socket.onerror = (error) => {
             socketErrorOccurred = true;
             socket.close();
-            reject(error);
+            done = true;
+            endError = error;
+            if (waitingReject) {
+                const reject = waitingReject;
+                waitingResolve = null;
+                waitingReject = null;
+                reject(error);
+            }
         };
-        socket.onclose = () => {
+        socket.onclose = (event) => {
             this.removeNotUsableSockets(socket.url);
             if (socketErrorOccurred)
                 return;
+            done = true;
             if (streamError) {
-                reject(streamError);
+                endError = streamError;
             }
-            else {
-                resolve({
-                    done: true,
-                    value: undefined,
-                });
+            else if (event.code !== WS_CLOSURE_CODE.SUCCESS_CODE &&
+                event.code !== 1001) {
+                // Server closed the connection with an abnormal code (e.g. 4001
+                // StreamIdleTimeout, 4003 SessionExpired, 1006 abnormal closure).
+                endError = new Error(`Server ended the connection unexpectedly (code ${event.code}` +
+                    (event.reason ? `: ${event.reason}` : '') +
+                    ')');
+            }
+            if (waitingResolve) {
+                if (endError) {
+                    const reject = waitingReject;
+                    waitingResolve = null;
+                    waitingReject = null;
+                    reject(endError);
+                }
+                else {
+                    const resolve = waitingResolve;
+                    waitingResolve = null;
+                    waitingReject = null;
+                    resolve({ done: true, value: undefined });
+                }
             }
         };
         const outputStream = {
             [Symbol.asyncIterator]: () => ({
                 next: () => {
+                    // If there are buffered messages, deliver the next one immediately
+                    if (messageQueue.length > 0) {
+                        return Promise.resolve({
+                            done: false,
+                            value: messageQueue.shift(),
+                        });
+                    }
+                    // If the stream has ended, resolve/reject accordingly
+                    if (done) {
+                        if (endError) {
+                            return Promise.reject(endError instanceof Error
+                                ? endError
+                                : new Error('Stream ended with an error'));
+                        }
+                        return Promise.resolve({
+                            done: true,
+                            value: undefined,
+                        });
+                    }
+                    // Otherwise wait for the next message or close event
                     return new Promise((_resolve, _reject) => {
-                        resolve = _resolve;
-                        reject = _reject;
+                        waitingResolve = _resolve;
+                        waitingReject = _reject;
                     });
                 },
             }),
@@ -1428,8 +1509,7 @@ class CustomWebSocketFetchHandler {
             catch (err) {
                 // We don't throw the error here because the send()'s returned
                 // would already be settled by the time sending chunk throws error.
-                // Instead, the notify the output stream to throw if there's
-                // exceptions
+                // Instead, notify the output stream to throw if there's exceptions
                 if (err instanceof Error) {
                     streamError = err;
                 }
@@ -1965,6 +2045,10 @@ const livenessMachine = xstate.createMachine({
                                 'spawnResponseStreamActor',
                             ],
                         },
+                        onError: {
+                            target: '#livenessMachine.error',
+                            actions: 'updateErrorStateForRuntime',
+                        },
                     },
                 },
                 waitForSessionInfo: {
@@ -1993,6 +2077,10 @@ const livenessMachine = xstate.createMachine({
                     target: 'checkFaceDetectedBeforeStart',
                     actions: 'updateFaceMatchBeforeStartDetails',
                 },
+                onError: {
+                    target: 'error',
+                    actions: 'updateErrorStateForRuntime',
+                },
             },
         },
         checkFaceDetectedBeforeStart: {
@@ -2011,6 +2099,10 @@ const livenessMachine = xstate.createMachine({
                     target: 'checkFaceDistanceBeforeRecording',
                     actions: 'updateFaceDistanceBeforeRecording',
                 },
+                onError: {
+                    target: 'error',
+                    actions: 'updateErrorStateForRuntime',
+                },
             },
         },
         checkFaceDistanceBeforeRecording: {
@@ -2688,13 +2780,7 @@ const livenessMachine = xstate.createMachine({
             const { videoEl } = context.videoAssociatedParams;
             const { faceDetector } = context.ovalAssociatedParams;
             // initialize models
-            try {
-                await faceDetector.modelLoadingPromise;
-            }
-            catch (err) {
-                // eslint-disable-next-line no-console
-                console.log({ err });
-            }
+            await faceDetector.modelLoadingPromise;
             // detect face
             const faceMatchState = await getFaceMatchState(faceDetector, videoEl);
             return { faceMatchState };
@@ -2726,13 +2812,7 @@ const livenessMachine = xstate.createMachine({
             const { videoEl, canvasEl, isMobile } = context.videoAssociatedParams;
             const { faceDetector } = context.ovalAssociatedParams;
             // initialize models
-            try {
-                await faceDetector.modelLoadingPromise;
-            }
-            catch (err) {
-                // eslint-disable-next-line no-console
-                console.log({ err });
-            }
+            await faceDetector.modelLoadingPromise;
             // detect face
             const detectedFaces = await faceDetector.detectFaces(videoEl);
             let initialFace;

package/dist/types/components/FaceLivenessDetector/service/types/faceDetection.d.ts

@@ -22,9 +22,12 @@ export type Coordinate = [number, number];
  */
 export declare abstract class FaceDetection {
     modelLoadingPromise: Promise<void>;
+    private _modelLoadTriggered;
     /**
      * Triggers the `loadModels` method and stores
      * the corresponding promise to be awaited later.
+     * Applies a timeout to prevent indefinite hangs if the
+     * network request for model assets stalls.
      */
     triggerModelLoading(): void;
     /**

package/dist/types/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "3.6.5";
+export declare const VERSION = "3.6.7";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aws-amplify/ui-react-liveness",
-  "version": "3.6.5",
+  "version": "3.6.7",
   "main": "dist/index.js",
   "module": "dist/esm/index.mjs",
   "exports": {
@@ -65,7 +65,7 @@
     "@tensorflow/tfjs-core": "4.11.0",
     "@xstate/react": "^3.2.2",
     "tslib": "^2.5.2",
-    "uuid": "^11.1.0",
+    "uuid": "^11.1.1",
     "xstate": "^4.33.6"
   },
   "devDependencies": {