@rick427/react-native-liveness 0.1.0

package/lib/typescript/src/types.d.ts

@@ -0,0 +1,61 @@
+import type { ViewStyle } from 'react-native';
+import type { PhotoFile } from 'react-native-vision-camera';
+export type FaceData = {
+    detected: boolean;
+    bounds: {
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+    };
+    yawAngle: number;
+    pitchAngle: number;
+    rollAngle: number;
+    leftEyeOpenProbability: number;
+    rightEyeOpenProbability: number;
+    smilingProbability: number;
+};
+export type LivenessState = 'idle' | 'scanning' | 'confirmed' | 'countdown' | 'capturing' | 'done' | 'error';
+export type FeedbackMessage = 'Position your face in the oval' | 'Move closer' | 'Move farther away' | 'Look straight ahead' | 'Hold still...' | 'Stay still' | 'Open your eyes' | 'Liveness confirmed' | '';
+export type CaptureResult = {
+    photo: PhotoFile;
+    livenessScore: number;
+    timestamp: number;
+};
+export type LivenessCameraProps = {
+    /**
+     * Called when liveness is confirmed and photo is captured.
+     */
+    onCapture: (result: CaptureResult) => void;
+    /**
+     * Called the moment liveness is confirmed, before the countdown starts.
+     */
+    onLivenessConfirmed?: () => void;
+    /**
+     * Called on any unrecoverable error.
+     */
+    onError?: (error: Error) => void;
+    /**
+     * Countdown start value. Defaults to 3.
+     */
+    countdownFrom?: number;
+    /**
+     * Score (0–1) required to confirm liveness. Defaults to 0.75.
+     */
+    livenessThreshold?: number;
+    /**
+     * Number of consecutive high-score frames required before liveness is
+     * confirmed. Defaults to 15 (~500ms at 30fps).
+     */
+    confirmFrames?: number;
+    /**
+     * Style applied to the root container.
+     */
+    style?: ViewStyle;
+    /**
+     * Whether to play a shutter sound on capture. Requires react-native-sound
+     * to be installed. Defaults to true.
+     */
+    soundEnabled?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

package/lib/typescript/src/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAC9C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,4BAA4B,CAAC;AAE5D,MAAM,MAAM,QAAQ,GAAG;IACrB,QAAQ,EAAE,OAAO,CAAC;IAClB,MAAM,EAAE;QACN,CAAC,EAAE,MAAM,CAAC;QACV,CAAC,EAAE,MAAM,CAAC;QACV,KAAK,EAAE,MAAM,CAAC;QACd,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IACF,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,sBAAsB,EAAE,MAAM,CAAC;IAC/B,uBAAuB,EAAE,MAAM,CAAC;IAChC,kBAAkB,EAAE,MAAM,CAAC;CAC5B,CAAC;AAEF,MAAM,MAAM,aAAa,GACrB,MAAM,GACN,UAAU,GACV,WAAW,GACX,WAAW,GACX,WAAW,GACX,MAAM,GACN,OAAO,CAAC;AAEZ,MAAM,MAAM,eAAe,GACvB,gCAAgC,GAChC,aAAa,GACb,mBAAmB,GACnB,qBAAqB,GACrB,eAAe,GACf,YAAY,GACZ,gBAAgB,GAChB,oBAAoB,GACpB,EAAE,CAAC;AAEP,MAAM,MAAM,aAAa,GAAG;IAC1B,KAAK,EAAE,SAAS,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAAG;IAChC;;OAEG;IACH,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAE3C;;OAEG;IACH,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IAEjC;;OAEG;IACH,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;IAEjC;;OAEG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;OAGG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IAEvB;;OAEG;IACH,KAAK,CAAC,EAAE,SAAS,CAAC;IAElB;;;OAGG;IACH,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB,CAAC"}

package/lib/typescript/src/useLivenessCamera.d.ts

@@ -0,0 +1,21 @@
+import type { Camera } from 'react-native-vision-camera';
+import type { CaptureResult, FeedbackMessage, LivenessState } from './types';
+type Options = {
+    livenessThreshold: number;
+    confirmFrames: number;
+    countdownFrom: number;
+    soundEnabled: boolean;
+    cameraRef: React.RefObject<Camera | null>;
+    onCapture: (result: CaptureResult) => void;
+    onLivenessConfirmed?: () => void;
+    onError?: (error: Error) => void;
+};
+export declare function useLivenessCamera(options: Options): {
+    frameProcessor: import("react-native-vision-camera").ReadonlyFrameProcessor;
+    livenessState: LivenessState;
+    livenessScore: number;
+    countdown: number | null;
+    feedback: FeedbackMessage;
+};
+export {};
+//# sourceMappingURL=useLivenessCamera.d.ts.map

package/lib/typescript/src/useLivenessCamera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useLivenessCamera.d.ts","sourceRoot":"","sources":["../../../src/useLivenessCamera.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAS,MAAM,4BAA4B,CAAC;AAKhE,OAAO,KAAK,EACV,aAAa,EAEb,eAAe,EACf,aAAa,EACd,MAAM,SAAS,CAAC;AAIjB,KAAK,OAAO,GAAG;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,SAAS,EAAE,KAAK,CAAC,SAAS,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC1C,SAAS,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,CAAC;IAC3C,mBAAmB,CAAC,EAAE,MAAM,IAAI,CAAC;IACjC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CAClC,CAAC;AASF,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,OAAO;;;;;;EA4KjD"}

package/package.json

@@ -0,0 +1,120 @@
+{
+  "name": "@rick427/react-native-liveness",
+  "version": "0.1.0",
+  "description": "Liveness detection library for React Native using Vision Camera v4 and ML Kit",
+  "main": "./lib/module/index.js",
+  "types": "./lib/typescript/src/index.d.ts",
+  "exports": {
+    ".": {
+      "source": "./src/index.ts",
+      "types": "./lib/typescript/src/index.d.ts",
+      "default": "./lib/module/index.js"
+    },
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "src",
+    "lib",
+    "android",
+    "ios",
+    "*.podspec",
+    "react-native.config.js",
+    "!ios/build",
+    "!android/build",
+    "!android/gradle",
+    "!android/gradlew",
+    "!android/gradlew.bat",
+    "!android/local.properties",
+    "!**/__tests__",
+    "!**/__fixtures__",
+    "!**/__mocks__",
+    "!**/.*"
+  ],
+  "scripts": {
+    "example": "yarn workspace react-native-liveness-example",
+    "clean": "del-cli lib",
+    "prepare": "bob build",
+    "typecheck": "tsc",
+    "lint": "eslint \"**/*.{js,ts,tsx}\""
+  },
+  "keywords": [
+    "react-native",
+    "ios",
+    "android",
+    "liveness",
+    "face-detection",
+    "vision-camera",
+    "mlkit",
+    "biometrics"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/rick427/react-native-liveness.git"
+  },
+  "author": "Richard <rchardnjoku@yahoo.com>",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/rick427/react-native-liveness/issues"
+  },
+  "homepage": "https://github.com/rick427/react-native-liveness#readme",
+  "publishConfig": {
+    "registry": "https://registry.npmjs.org/"
+  },
+  "devDependencies": {
+    "@eslint/compat": "^2.0.3",
+    "@eslint/eslintrc": "^3.3.5",
+    "@eslint/js": "^10.0.1",
+    "@react-native/babel-preset": "0.85.0",
+    "@react-native/eslint-config": "0.85.0",
+    "@types/react": "^19.2.0",
+    "del-cli": "^7.0.0",
+    "eslint": "^9.39.4",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-prettier": "^5.5.5",
+    "prettier": "^3.8.1",
+    "react": "19.2.0",
+    "react-native": "0.83.6",
+    "react-native-builder-bob": "^0.41.0",
+    "react-native-svg": "^15.0.0",
+    "react-native-vision-camera": "^4.0.0",
+    "react-native-worklets-core": "^1.3.3",
+    "turbo": "^2.8.21",
+    "typescript": "^6.0.2"
+  },
+  "peerDependencies": {
+    "react": "*",
+    "react-native": "*",
+    "react-native-svg": ">=13.0.0",
+    "react-native-vision-camera": ">=4.0.0",
+    "react-native-worklets-core": ">=1.0.0"
+  },
+  "workspaces": [
+    "example"
+  ],
+  "packageManager": "yarn@4.11.0",
+  "react-native-builder-bob": {
+    "source": "src",
+    "output": "lib",
+    "targets": [
+      [
+        "module",
+        {
+          "esm": true
+        }
+      ],
+      [
+        "typescript",
+        {
+          "project": "tsconfig.build.json"
+        }
+      ]
+    ]
+  },
+  "prettier": {
+    "quoteProps": "consistent",
+    "singleQuote": true,
+    "tabWidth": 2,
+    "trailingComma": "es5",
+    "useTabs": false
+  }
+}

package/src/LivenessCamera.tsx

@@ -0,0 +1,284 @@
+import { useCallback, useEffect, useRef, useState } from 'react';
+import { Animated, StyleSheet, Text, View } from 'react-native';
+import {
+  Camera,
+  useCameraDevice,
+  useCameraPermission,
+} from 'react-native-vision-camera';
+import { Circle, Ellipse, Path, Svg } from 'react-native-svg';
+import { useLivenessCamera } from './useLivenessCamera';
+import type { LivenessCameraProps, LivenessState } from './types';
+
+const OVAL_H_RATIO = 0.55;
+const OVAL_V_RATIO = 0.72;
+const STROKE_WIDTH = 3;
+// Cubic bezier approximation constant for a smooth ellipse
+const K = 0.5523;
+
+function getOvalColor(state: LivenessState): string {
+  switch (state) {
+    case 'confirmed':
+    case 'countdown':
+    case 'capturing':
+    case 'done':
+      return '#4CAF50';
+    default:
+      return '#FFFFFF';
+  }
+}
+
+/**
+ * Returns an SVG path string tracing an ellipse (cx, cy, rx, ry) using
+ * cubic bezier curves. Used inside a compound path with fillRule="evenodd"
+ * to punch a transparent hole through the dark scrim.
+ */
+function ellipsePath(cx: number, cy: number, rx: number, ry: number): string {
+  return [
+    `M ${cx + rx} ${cy}`,
+    `C ${cx + rx} ${cy - ry * K} ${cx + rx * K} ${cy - ry} ${cx} ${cy - ry}`,
+    `C ${cx - rx * K} ${cy - ry} ${cx - rx} ${cy - ry * K} ${cx - rx} ${cy}`,
+    `C ${cx - rx} ${cy + ry * K} ${cx - rx * K} ${cy + ry} ${cx} ${cy + ry}`,
+    `C ${cx + rx * K} ${cy + ry} ${cx + rx} ${cy + ry * K} ${cx + rx} ${cy}`,
+    'Z',
+  ].join(' ');
+}
+
+function OvalOverlay({
+  width,
+  height,
+  state,
+}: {
+  width: number;
+  height: number;
+  state: LivenessState;
+}) {
+  if (width === 0 || height === 0) return null;
+
+  const cx = width / 2;
+  const cy = height / 2;
+  const rx = (width * OVAL_H_RATIO) / 2;
+  const ry = (height * OVAL_V_RATIO) / 2;
+  const color = getOvalColor(state);
+
+  // Compound path: outer rect + oval. evenodd fill rule makes the oval transparent.
+  const scrimD = `M0 0H${width}V${height}H0Z ${ellipsePath(cx, cy, rx, ry)}`;
+
+  const showDot =
+    state === 'confirmed' || state === 'countdown' || state === 'capturing';
+
+  return (
+    <Svg style={StyleSheet.absoluteFill} width={width} height={height}>
+      <Path d={scrimD} fill="rgba(0,0,0,0.55)" fillRule="evenodd" />
+      <Ellipse
+        cx={cx}
+        cy={cy}
+        rx={rx}
+        ry={ry}
+        fill="none"
+        stroke={color}
+        strokeWidth={STROKE_WIDTH}
+      />
+      {showDot && <Circle cx={cx} cy={cy - ry - 8} r={5} fill={color} />}
+    </Svg>
+  );
+}
+
+function CountdownBubble({ value }: { value: number }) {
+  // key={countdown} in the parent remounts this component on every tick,
+  // so [] deps are correct — each mount runs a fresh animation.
+  const scale = useRef(new Animated.Value(0)).current;
+  const opacity = useRef(new Animated.Value(0)).current;
+
+  useEffect(() => {
+    Animated.parallel([
+      Animated.sequence([
+        Animated.spring(scale, {
+          toValue: 1.2,
+          stiffness: 200,
+          damping: 6,
+          useNativeDriver: true,
+        }),
+        Animated.spring(scale, {
+          toValue: 1.0,
+          stiffness: 150,
+          damping: 8,
+          useNativeDriver: true,
+        }),
+      ]),
+      Animated.timing(opacity, {
+        toValue: 1,
+        duration: 150,
+        useNativeDriver: true,
+      }),
+    ]).start();
+
+    return () => {
+      Animated.timing(opacity, {
+        toValue: 0,
+        duration: 200,
+        useNativeDriver: true,
+      }).start();
+    };
+  }, []); // eslint-disable-line react-hooks/exhaustive-deps
+
+  return (
+    <Animated.View
+      style={[styles.countdownBubble, { opacity, transform: [{ scale }] }]}
+    >
+      <Text style={styles.countdownText}>{value}</Text>
+    </Animated.View>
+  );
+}
+
+export function LivenessCamera({
+  onCapture,
+  onLivenessConfirmed,
+  onError,
+  countdownFrom = 3,
+  livenessThreshold = 0.75,
+  confirmFrames = 15,
+  soundEnabled = true,
+  style,
+}: LivenessCameraProps) {
+  const { hasPermission, requestPermission } = useCameraPermission();
+  const device = useCameraDevice('front');
+  const cameraRef = useRef<Camera>(null);
+  const [containerSize, setContainerSize] = useState({ width: 0, height: 0 });
+
+  const { frameProcessor, livenessState, countdown, feedback } =
+    useLivenessCamera({
+      livenessThreshold,
+      confirmFrames,
+      countdownFrom,
+      soundEnabled,
+      cameraRef,
+      onCapture,
+      onLivenessConfirmed,
+      onError,
+    });
+
+  const handleLayout = useCallback(
+    (e: { nativeEvent: { layout: { width: number; height: number } } }) => {
+      const { width, height } = e.nativeEvent.layout;
+      setContainerSize({ width, height });
+    },
+    []
+  );
+
+  useEffect(() => {
+    if (!hasPermission) {
+      requestPermission().catch(() => {
+        onError?.(new Error('Camera permission denied'));
+      });
+    }
+  }, [hasPermission, requestPermission, onError]);
+
+  if (!hasPermission) {
+    return (
+      <View style={[styles.root, style, styles.centered]}>
+        <Text style={styles.permissionText}>Camera permission required</Text>
+      </View>
+    );
+  }
+
+  if (!device) {
+    return (
+      <View style={[styles.root, style, styles.centered]}>
+        <Text style={styles.permissionText}>No front camera found</Text>
+      </View>
+    );
+  }
+
+  return (
+    <View style={[styles.root, style]} onLayout={handleLayout}>
+      <Camera
+        ref={cameraRef}
+        style={StyleSheet.absoluteFill}
+        device={device}
+        isActive={livenessState !== 'done' && livenessState !== 'error'}
+        frameProcessor={frameProcessor}
+        photo
+        pixelFormat="yuv"
+      />
+      <OvalOverlay
+        width={containerSize.width}
+        height={containerSize.height}
+        state={livenessState}
+      />
+      {livenessState !== 'done' && (
+        <View style={styles.feedbackContainer}>
+          <Text style={styles.feedbackText}>{feedback}</Text>
+        </View>
+      )}
+      {livenessState === 'countdown' && countdown !== null && (
+        <View style={styles.countdownContainer}>
+          <CountdownBubble key={countdown} value={countdown} />
+        </View>
+      )}
+      {livenessState === 'capturing' && (
+        <View style={styles.captureFlash} pointerEvents="none" />
+      )}
+    </View>
+  );
+}
+
+const styles = StyleSheet.create({
+  root: {
+    flex: 1,
+    backgroundColor: '#000',
+    overflow: 'hidden',
+  },
+  centered: {
+    justifyContent: 'center',
+    alignItems: 'center',
+  },
+  permissionText: {
+    color: '#fff',
+    fontSize: 16,
+    textAlign: 'center',
+    paddingHorizontal: 24,
+  },
+  feedbackContainer: {
+    position: 'absolute',
+    bottom: '14%',
+    left: 0,
+    right: 0,
+    alignItems: 'center',
+    paddingHorizontal: 16,
+  },
+  feedbackText: {
+    color: '#fff',
+    fontSize: 16,
+    fontWeight: '600',
+    textAlign: 'center',
+    textShadowColor: 'rgba(0,0,0,0.8)',
+    textShadowOffset: { width: 0, height: 1 },
+    textShadowRadius: 4,
+  },
+  countdownContainer: {
+    ...StyleSheet.absoluteFillObject,
+    justifyContent: 'center',
+    alignItems: 'center',
+  },
+  countdownBubble: {
+    width: 96,
+    height: 96,
+    borderRadius: 48,
+    backgroundColor: 'rgba(255,255,255,0.15)',
+    borderWidth: 2,
+    borderColor: '#fff',
+    justifyContent: 'center',
+    alignItems: 'center',
+  },
+  countdownText: {
+    color: '#fff',
+    fontSize: 52,
+    fontWeight: '700',
+    lineHeight: 60,
+  },
+  captureFlash: {
+    ...StyleSheet.absoluteFillObject,
+    backgroundColor: '#fff',
+    opacity: 0.4,
+  },
+});

package/src/LivenessDetector.ts

@@ -0,0 +1,34 @@
+import { useMemo } from 'react';
+import { VisionCameraProxy, type Frame } from 'react-native-vision-camera';
+import type { FaceData } from './types';
+
+type LivenessPlugin = {
+  detectLiveness: (frame: Frame) => FaceData | null;
+};
+
+function createPlugin(): LivenessPlugin {
+  const plugin = VisionCameraProxy.initFrameProcessorPlugin(
+    'detectLiveness',
+    {}
+  );
+
+  if (!plugin) {
+    throw new Error(
+      '[LivenessCamera] Frame Processor Plugin "detectLiveness" not found. ' +
+        'Make sure the native module is linked correctly.'
+    );
+  }
+
+  return {
+    detectLiveness: (frame: Frame): FaceData | null => {
+      'worklet';
+      const result = plugin.call(frame);
+      // plugin.call returns a loosely-typed BasicParameterType — cast via unknown
+      return result as unknown as FaceData | null;
+    },
+  };
+}
+
+export function useLivenessPlugin(): LivenessPlugin {
+  return useMemo(() => createPlugin(), []);
+}

package/src/index.ts

@@ -0,0 +1,9 @@
+export { LivenessCamera } from './LivenessCamera';
+export { useLivenessCamera } from './useLivenessCamera';
+export type {
+  CaptureResult,
+  FaceData,
+  FeedbackMessage,
+  LivenessCameraProps,
+  LivenessState,
+} from './types';

package/src/livenessScoring.ts

@@ -0,0 +1,81 @@
+import type { FaceData, FeedbackMessage } from './types';
+
+const WEIGHTS = {
+  faceDetected: 0.2,
+  faceSize: 0.2,
+  headPose: 0.3,
+  eyesOpen: 0.3,
+} as const;
+
+const FACE_SIZE_MIN = 0.2;
+const FACE_SIZE_MAX = 0.65;
+const MAX_YAW_DEG = 20;
+const MAX_PITCH_DEG = 20;
+
+export type FrameScore = {
+  total: number;
+  faceSize: number;
+  headPose: number;
+  eyesOpen: number;
+};
+
+export function scoreFrame(face: FaceData, frameWidth: number): FrameScore {
+  if (!face.detected || frameWidth === 0) {
+    return { total: 0, faceSize: 0, headPose: 0, eyesOpen: 0 };
+  }
+
+  const faceWidthRatio = face.bounds.width / frameWidth;
+  const faceSize =
+    faceWidthRatio >= FACE_SIZE_MIN && faceWidthRatio <= FACE_SIZE_MAX
+      ? 1.0
+      : 0.0;
+
+  const yawOK = Math.abs(face.yawAngle) < MAX_YAW_DEG;
+  const pitchOK = Math.abs(face.pitchAngle) < MAX_PITCH_DEG;
+  const headPose = (yawOK ? 0.5 : 0) + (pitchOK ? 0.5 : 0);
+
+  // ML Kit returns -1 when classification is disabled or unavailable
+  const leftEye =
+    face.leftEyeOpenProbability >= 0 ? face.leftEyeOpenProbability : 0.5;
+  const rightEye =
+    face.rightEyeOpenProbability >= 0 ? face.rightEyeOpenProbability : 0.5;
+  const eyesOpen = (leftEye + rightEye) / 2;
+
+  const total =
+    WEIGHTS.faceDetected * 1.0 +
+    WEIGHTS.faceSize * faceSize +
+    WEIGHTS.headPose * headPose +
+    WEIGHTS.eyesOpen * eyesOpen;
+
+  return { total, faceSize, headPose, eyesOpen };
+}
+
+export function rollingAverage(scores: number[]): number {
+  if (scores.length === 0) return 0;
+  return scores.reduce((a, b) => a + b, 0) / scores.length;
+}
+
+export function getFeedback(
+  face: FaceData,
+  frameWidth: number,
+  livenessConfirmed: boolean
+): FeedbackMessage {
+  if (livenessConfirmed) return 'Liveness confirmed';
+  if (!face.detected) return 'Position your face in the oval';
+
+  const faceWidthRatio = face.bounds.width / frameWidth;
+  if (faceWidthRatio < FACE_SIZE_MIN) return 'Move closer';
+  if (faceWidthRatio > FACE_SIZE_MAX) return 'Move farther away';
+
+  const yawBad = Math.abs(face.yawAngle) >= MAX_YAW_DEG;
+  const pitchBad = Math.abs(face.pitchAngle) >= MAX_PITCH_DEG;
+  if (yawBad || pitchBad) return 'Look straight ahead';
+
+  const leftEye =
+    face.leftEyeOpenProbability >= 0 ? face.leftEyeOpenProbability : 1;
+  const rightEye =
+    face.rightEyeOpenProbability >= 0 ? face.rightEyeOpenProbability : 1;
+  if (leftEye < 0.4 || rightEye < 0.4) return 'Open your eyes';
+
+  return 'Hold still...';
+}