@smileid/usesmileid_mlkit_face

UseSmileID v12 — Google ML Kit face provider for React Native (Expo Modules). Android-only. Thin shim around the existing native AAR com.usesmileid:mlkit-face.

Architecture

The native side runs the entire face-scan pipeline (analyzer + validator + transitioner + state machine). This package contributes a Kotlin Expo Module that constructs UseSmileIDFaceSession(FaceDetectorAnalyzer()) and a TypeScript wrapper that bridges the four contract methods (configure / analyze / reset / close) with Zod-validated wire payloads.

No ML logic is reimplemented in this package — it's a pure passthrough.

Installation

pnpm add @smileid/usesmileid_mlkit_face

Expo's autolinking picks up expo-module.config.json at app build time; no manual native registration required.

Usage

import { useSmileIDMlkitFace } from "@smileid/usesmileid_mlkit_face";

await useSmileIDMlkitFace.configure({
  selfieCaptureTimeoutMs: 60_000,
});

const result = await useSmileIDMlkitFace.analyze(bytes, rotation);
// result.state.type === 'found' | 'satisfied' | 'unsatisfied' | …
// result.output.faces[0].score === 0.9

await useSmileIDMlkitFace.close();

Cross-platform peers

| Platform | Provider package | Native dep | | ---------------- | --------------------------------- | ---------------------------- | | Android | @smileid/usesmileid_mlkit_face | com.usesmileid:mlkit-face | | Android (no GMS) | @smileid/usesmileid_huawei_face | com.usesmileid:huawei-face | | iOS | @smileid/usesmileid_vision_face | UseSmileIDVisionFace (SPM) |

Testing

pnpm --filter @smileid/usesmileid_mlkit_face test