@smileid/usesmileid_vision_face

UseSmileID v12 — Apple Vision face provider for React Native (Expo Modules). iOS-only. Thin shim around the existing Swift Package UseSmileIDVisionFace.

Architecture

The native side runs the entire face-scan pipeline (analyzer + validator + transitioner + state machine). This package contributes a Swift Expo Module that constructs UseSmileIDFaceSession(FaceDetectorAnalyzer()) and a TS 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_vision_face

Run npx pod-install (or let Expo's prebuild handle it) so the iOS project picks up the SPM dependency declared in UseSmileIDVisionFace.podspec.

Usage

import { useSmileIDVisionFace } from "@smileid/usesmileid_vision_face";

await useSmileIDVisionFace.configure({ selfieCaptureTimeoutMs: 60_000 });
const result = await useSmileIDVisionFace.analyze(bytes, rotation);
await useSmileIDVisionFace.close();

Cross-platform peers

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

Testing

pnpm --filter @smileid/usesmileid_vision_face test