@smileid/usesmileid_huawei_document

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

Architecture

The native side runs the entire document-scan pipeline. This package contributes a Kotlin Expo Module that constructs UseSmileIDDocumentSession(DocumentDetectorAnalyzer()) against the Huawei HMS-backed analyzer in the com.usesmileid:huawei-document 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_document

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 { useSmileIDHuaweiDocument } from "@smileid/usesmileid_huawei_document";

await useSmileIDHuaweiDocument.configure({ timeoutMs: 15_000 });
const result = await useSmileIDHuaweiDocument.analyze(bytes, rotation);
await useSmileIDHuaweiDocument.close();

Cross-platform peers

| Platform | Provider package | Native dep | | ---------------- | ------------------------------------- | -------------------------------- | | Android (no GMS) | @smileid/usesmileid_huawei_document | com.usesmileid:huawei-document | | Android | @smileid/usesmileid_mlkit_document | com.usesmileid:mlkit-document | | iOS | @smileid/usesmileid_vision_document | UseSmileIDVisionDocument (SPM) |

Testing

pnpm --filter @smileid/usesmileid_huawei_document test