@smileid/usesmileid_huawei_face

UseSmileID v12 — Huawei HMS face provider for React Native (Expo Modules). Android-only. Thin shim around the existing native AAR com.usesmileid:huawei-face. Use this provider on devices without Google Mobile Services (Huawei post-2019 hardware, etc.); use @smileid/usesmileid_mlkit_face everywhere else.

Architecture

The native side runs the entire face-scan pipeline. This package contributes a Kotlin Expo Module that constructs UseSmileIDFaceSession(FaceDetectorAnalyzer()) against the Huawei HMS-backed analyzer in the com.usesmileid:huawei-face AAR, and a TS wrapper that bridges 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_huawei_face

Expo's autolinking picks up expo-module.config.json at app build time. Partner apps shipping to Huawei AppGallery will additionally need the Huawei HMS Maven mirror in their root build.gradle.kts — see the Huawei HMS developer guides.

Usage

import { useSmileIDHuaweiFace } from "@smileid/usesmileid_huawei_face";

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

Cross-platform peers

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

Testing

pnpm --filter @smileid/usesmileid_huawei_face test