@simprints/simface-sdk 0.4.1 → 0.6.1

package/dist/services/face-detection.js

@@ -0,0 +1,69 @@
+import { FaceDetector, FilesetResolver } from '@mediapipe/tasks-vision';
+import { evaluateFaceQuality } from './face-quality.js';
+const WASM_CDN = 'https://cdn.jsdelivr.net/npm/@mediapipe/tasks-vision/wasm';
+const MODEL_URL = 'https://storage.googleapis.com/mediapipe-models/face_detector/blaze_face_short_range/float16/1/blaze_face_short_range.tflite';
+// Minimum confidence to consider a face detected
+const MIN_CONFIDENCE = 0.7;
+let visionInstance = null;
+let imageDetectorInstance = null;
+let videoDetectorInstance = null;
+function getVision() {
+    visionInstance ?? (visionInstance = FilesetResolver.forVisionTasks(WASM_CDN));
+    return visionInstance;
+}
+function getImageDetector() {
+    imageDetectorInstance ?? (imageDetectorInstance = createDetector('IMAGE'));
+    return imageDetectorInstance;
+}
+export function getVideoDetector() {
+    videoDetectorInstance ?? (videoDetectorInstance = createDetector('VIDEO'));
+    return videoDetectorInstance;
+}
+async function createDetector(runningMode) {
+    const vision = await getVision();
+    return FaceDetector.createFromOptions(vision, {
+        baseOptions: { modelAssetPath: MODEL_URL },
+        runningMode,
+        minDetectionConfidence: MIN_CONFIDENCE,
+    });
+}
+/**
+ * Assess face quality from a captured image.
+ * Checks: face present, single face, face centered, sufficient size.
+ */
+export async function assessFaceQuality(imageElement) {
+    const detector = await getImageDetector();
+    const result = detector.detect(imageElement);
+    return evaluateFaceQuality({
+        detections: mapDetections(result.detections),
+        width: imageElement.naturalWidth,
+        height: imageElement.naturalHeight,
+    });
+}
+export async function assessFaceQualityForVideo(videoElement, timestamp) {
+    const detector = await getVideoDetector();
+    const result = detector.detectForVideo(videoElement, timestamp);
+    return evaluateFaceQuality({
+        detections: mapDetections(result.detections),
+        width: videoElement.videoWidth,
+        height: videoElement.videoHeight,
+    });
+}
+function mapDetections(detections) {
+    return detections.map((detection) => ({
+        boundingBox: detection.boundingBox
+            ? {
+                originX: detection.boundingBox.originX,
+                originY: detection.boundingBox.originY,
+                width: detection.boundingBox.width,
+                height: detection.boundingBox.height,
+            }
+            : undefined,
+        confidence: detection.categories[0]?.score ?? 0,
+        keypoints: detection.keypoints.map((keypoint) => ({
+            x: keypoint.x,
+            y: keypoint.y,
+        })),
+    }));
+}
+//# sourceMappingURL=face-detection.js.map

package/dist/services/face-detection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"face-detection.js","sourceRoot":"","sources":["../../src/services/face-detection.ts"],"names":[],"mappings":"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"}

package/dist/services/face-quality.d.ts

@@ -0,0 +1,23 @@
+import type { FaceQualityResult } from '../types/index.js';
+export interface FaceBoundingBox {
+    originX: number;
+    originY: number;
+    width: number;
+    height: number;
+}
+export interface FaceKeypoint {
+    x: number;
+    y: number;
+}
+export interface FaceDetectionSnapshot {
+    boundingBox?: FaceBoundingBox;
+    confidence: number;
+    keypoints: FaceKeypoint[];
+}
+interface FaceQualityInput {
+    width: number;
+    height: number;
+    detections: FaceDetectionSnapshot[];
+}
+export declare function evaluateFaceQuality(input: FaceQualityInput): FaceQualityResult;
+export {};

package/dist/services/face-quality.js

@@ -0,0 +1,136 @@
+const MIN_FACE_AREA_RATIO = 0.1;
+const MAX_FACE_AREA_RATIO = 0.42;
+const IDEAL_FACE_AREA_RATIO = 0.24;
+const CENTER_TOLERANCE_X = 0.14;
+const CENTER_TOLERANCE_Y = 0.18;
+const MAX_NOSE_OFFSET_RATIO = 0.12;
+const KEYPOINT_RIGHT_EYE = 0;
+const KEYPOINT_LEFT_EYE = 1;
+const KEYPOINT_NOSE = 2;
+export function evaluateFaceQuality(input) {
+    const { detections, width, height } = input;
+    if (detections.length === 0) {
+        return createQualityResult({
+            hasFace: false,
+            faceCount: 0,
+            confidence: 0,
+            captureScore: 0,
+            isCentered: false,
+            passesQualityChecks: false,
+            feedback: 'no-face',
+            message: 'No face detected. Center your face in the oval and look at the camera.',
+        });
+    }
+    if (detections.length > 1) {
+        return createQualityResult({
+            hasFace: true,
+            faceCount: detections.length,
+            confidence: detections[0]?.confidence ?? 0,
+            captureScore: 0,
+            isCentered: false,
+            passesQualityChecks: false,
+            feedback: 'multiple-faces',
+            message: 'Multiple faces detected. Make sure only one person is in view.',
+        });
+    }
+    const detection = detections[0];
+    const bbox = detection.boundingBox;
+    if (!bbox) {
+        return createQualityResult({
+            hasFace: true,
+            faceCount: 1,
+            confidence: detection.confidence,
+            captureScore: 0,
+            isCentered: false,
+            passesQualityChecks: false,
+            feedback: 'face-unclear',
+            message: 'Face detected, but the frame is unclear. Hold still and try again.',
+        });
+    }
+    const faceAreaRatio = (bbox.width * bbox.height) / (width * height);
+    if (faceAreaRatio < MIN_FACE_AREA_RATIO) {
+        return createFrameAdjustmentResult(detection.confidence, 'too-far', 'Move closer to the camera.');
+    }
+    if (faceAreaRatio > MAX_FACE_AREA_RATIO) {
+        return createFrameAdjustmentResult(detection.confidence, 'too-close', 'Move slightly farther away.');
+    }
+    const faceCenterX = (bbox.originX + bbox.width / 2) / width;
+    const faceCenterY = (bbox.originY + bbox.height / 2) / height;
+    if (faceCenterX < 0.5 - CENTER_TOLERANCE_X) {
+        return createFrameAdjustmentResult(detection.confidence, 'move-right', 'Move your face a little to the right.');
+    }
+    if (faceCenterX > 0.5 + CENTER_TOLERANCE_X) {
+        return createFrameAdjustmentResult(detection.confidence, 'move-left', 'Move your face a little to the left.');
+    }
+    if (faceCenterY < 0.5 - CENTER_TOLERANCE_Y) {
+        return createFrameAdjustmentResult(detection.confidence, 'move-down', 'Move your face slightly down.');
+    }
+    if (faceCenterY > 0.5 + CENTER_TOLERANCE_Y) {
+        return createFrameAdjustmentResult(detection.confidence, 'move-up', 'Move your face slightly up.');
+    }
+    const turnFeedback = detectTurnFeedback(detection.keypoints);
+    if (turnFeedback) {
+        return createFrameAdjustmentResult(detection.confidence, turnFeedback.feedback, turnFeedback.message);
+    }
+    return createQualityResult({
+        hasFace: true,
+        faceCount: 1,
+        confidence: detection.confidence,
+        captureScore: calculateCaptureScore(detection.confidence, faceCenterX, faceCenterY, faceAreaRatio),
+        isCentered: true,
+        passesQualityChecks: true,
+        feedback: 'good',
+        message: 'Hold still. Capturing automatically...',
+    });
+}
+function detectTurnFeedback(keypoints) {
+    const rightEye = keypoints[KEYPOINT_RIGHT_EYE];
+    const leftEye = keypoints[KEYPOINT_LEFT_EYE];
+    const nose = keypoints[KEYPOINT_NOSE];
+    if (!rightEye || !leftEye || !nose) {
+        return null;
+    }
+    const eyeMidpointX = (rightEye.x + leftEye.x) / 2;
+    const eyeDistance = Math.abs(leftEye.x - rightEye.x);
+    if (eyeDistance === 0) {
+        return null;
+    }
+    const noseOffsetRatio = (nose.x - eyeMidpointX) / eyeDistance;
+    if (noseOffsetRatio <= -MAX_NOSE_OFFSET_RATIO) {
+        return {
+            feedback: 'turn-right',
+            message: 'Turn slightly right so your face points at the camera.',
+        };
+    }
+    if (noseOffsetRatio >= MAX_NOSE_OFFSET_RATIO) {
+        return {
+            feedback: 'turn-left',
+            message: 'Turn slightly left so your face points at the camera.',
+        };
+    }
+    return null;
+}
+function createFrameAdjustmentResult(confidence, feedback, message) {
+    return createQualityResult({
+        hasFace: true,
+        faceCount: 1,
+        confidence,
+        captureScore: 0,
+        isCentered: false,
+        passesQualityChecks: false,
+        feedback,
+        message,
+    });
+}
+function createQualityResult(result) {
+    return result;
+}
+function calculateCaptureScore(confidence, faceCenterX, faceCenterY, faceAreaRatio) {
+    const xPenalty = Math.abs(faceCenterX - 0.5) / CENTER_TOLERANCE_X;
+    const yPenalty = Math.abs(faceCenterY - 0.5) / CENTER_TOLERANCE_Y;
+    const centerScore = 1 - Math.min((xPenalty + yPenalty) / 2, 1);
+    const maxAreaDistance = Math.max(Math.abs(IDEAL_FACE_AREA_RATIO - MIN_FACE_AREA_RATIO), Math.abs(MAX_FACE_AREA_RATIO - IDEAL_FACE_AREA_RATIO));
+    const sizeScore = 1 - Math.min(Math.abs(faceAreaRatio - IDEAL_FACE_AREA_RATIO) / maxAreaDistance, 1);
+    return Number((confidence * 0.55 + centerScore * 0.3 + sizeScore * 0.15).toFixed(4));
+}
+//# sourceMappingURL=face-quality.js.map

package/dist/services/face-quality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"face-quality.js","sourceRoot":"","sources":["../../src/services/face-quality.ts"],"names":[],"mappings":"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"}

package/dist/shared/auto-capture.d.ts

@@ -0,0 +1,7 @@
+import type { FaceQualityResult } from '../types/index.js';
+export declare const AUTO_CAPTURE_ANALYSIS_INTERVAL_MS = 180;
+export declare const AUTO_CAPTURE_COUNTDOWN_MS = 5000;
+export declare const CAPTURE_GUIDE_PATH = "M 50 17 C 60 17 68 19.5 74 25 C 79 29.5 81.5 36.5 81.5 46.5 V 54.5 C 81.5 63.5 78.5 71 71.5 76.5 C 65 81.5 57.5 84 50 84 C 42.5 84 35 81.5 28.5 76.5 C 21.5 71 18.5 63.5 18.5 54.5 V 46.5 C 18.5 36.5 21 29.5 26 25 C 32 19.5 40 17 50 17 Z";
+export declare const CAPTURE_GUIDE_MASK_PATH = "M 0 0 H 100 V 100 H 0 Z M 50 17 C 60 17 68 19.5 74 25 C 79 29.5 81.5 36.5 81.5 46.5 V 54.5 C 81.5 63.5 78.5 71 71.5 76.5 C 65 81.5 57.5 84 50 84 C 42.5 84 35 81.5 28.5 76.5 C 21.5 71 18.5 63.5 18.5 54.5 V 46.5 C 18.5 36.5 21 29.5 26 25 C 32 19.5 40 17 50 17 Z";
+export declare function autoCaptureCountdownMessage(timestamp: number, countdownStartedAt: number | null, qualityResult: FaceQualityResult): string;
+export declare function autoCaptureCompleteMessage(bestQualityResult: FaceQualityResult | null): "Best frame captured. Review and confirm this photo." | "Capture complete. Review and confirm this photo.";

package/dist/shared/auto-capture.js

@@ -0,0 +1,23 @@
+export const AUTO_CAPTURE_ANALYSIS_INTERVAL_MS = 180;
+export const AUTO_CAPTURE_COUNTDOWN_MS = 5000;
+export const CAPTURE_GUIDE_PATH = 'M 50 17 C 60 17 68 19.5 74 25 C 79 29.5 81.5 36.5 81.5 46.5 V 54.5 C 81.5 63.5 78.5 71 71.5 76.5 C 65 81.5 57.5 84 50 84 C 42.5 84 35 81.5 28.5 76.5 C 21.5 71 18.5 63.5 18.5 54.5 V 46.5 C 18.5 36.5 21 29.5 26 25 C 32 19.5 40 17 50 17 Z';
+export const CAPTURE_GUIDE_MASK_PATH = `M 0 0 H 100 V 100 H 0 Z ${CAPTURE_GUIDE_PATH}`;
+export function autoCaptureCountdownMessage(timestamp, countdownStartedAt, qualityResult) {
+    if (countdownStartedAt === null) {
+        return 'Center your face in the oval. We will capture automatically when framing looks good.';
+    }
+    const remainingMs = Math.max(AUTO_CAPTURE_COUNTDOWN_MS - (timestamp - countdownStartedAt), 0);
+    const remainingSeconds = Math.max(Math.ceil(remainingMs / 1000), 0);
+    if (qualityResult.passesQualityChecks) {
+        return `Hold steady. Capturing the best frame in ${remainingSeconds}s.`;
+    }
+    return `${qualityResult.message} Best frame selection finishes in ${remainingSeconds}s.`;
+}
+export function autoCaptureCompleteMessage(bestQualityResult) {
+    const score = bestQualityResult?.captureScore;
+    if (typeof score === 'number' && score > 0) {
+        return 'Best frame captured. Review and confirm this photo.';
+    }
+    return 'Capture complete. Review and confirm this photo.';
+}
+//# sourceMappingURL=auto-capture.js.map

package/dist/shared/auto-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auto-capture.js","sourceRoot":"","sources":["../../src/shared/auto-capture.ts"],"names":[],"mappings":"AAEA,MAAM,CAAC,MAAM,iCAAiC,GAAG,GAAG,CAAC;AACrD,MAAM,CAAC,MAAM,yBAAyB,GAAG,IAAI,CAAC;AAE9C,MAAM,CAAC,MAAM,kBAAkB,GAAG,6OAA6O,CAAC;AAChR,MAAM,CAAC,MAAM,uBAAuB,GAAG,2BAA2B,kBAAkB,EAAE,CAAC;AAEvF,MAAM,UAAU,2BAA2B,CACzC,SAAiB,EACjB,kBAAiC,EACjC,aAAgC;IAEhC,IAAI,kBAAkB,KAAK,IAAI,EAAE,CAAC;QAChC,OAAO,sFAAsF,CAAC;IAChG,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,yBAAyB,GAAG,CAAC,SAAS,GAAG,kBAAkB,CAAC,EAAE,CAAC,CAAC,CAAC;IAC9F,MAAM,gBAAgB,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC;IACpE,IAAI,aAAa,CAAC,mBAAmB,EAAE,CAAC;QACtC,OAAO,4CAA4C,gBAAgB,IAAI,CAAC;IAC1E,CAAC;IAED,OAAO,GAAG,aAAa,CAAC,OAAO,qCAAqC,gBAAgB,IAAI,CAAC;AAC3F,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,iBAA2C;IACpF,MAAM,KAAK,GAAG,iBAAiB,EAAE,YAAY,CAAC;IAC9C,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QAC3C,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IAED,OAAO,kDAAkD,CAAC;AAC5D,CAAC"}