@myazahq/kyc-sdk-react-native 2.6.0 → 3.0.0

package/app.plugin.js

@@ -27,8 +27,12 @@ const pkg = require('./package.json');
 // unconditionally would break code-signing for every consumer who does not read
 // chips and has not enabled it.
 //
-// Camera preview/capture itself comes from react-native-vision-camera; add its
-// config plugin too. This one is intentionally minimal and idempotent.
+// Camera preview/capture itself comes from react-native-vision-camera, but v5
+// ships NO config plugin (v4 did), so it must NOT be listed in the host app's
+// `plugins`. Expo then loads the package's main entry as a plugin and prebuild
+// dies on `Cannot find module '.../lib/VisionCamera'`. That is why the camera
+// permission and usage string are declared HERE. This plugin is intentionally
+// minimal and idempotent.
 // ---------------------------------------------------------------------------
 
 const CAMERA_USAGE =
@@ -170,6 +174,52 @@ function withAndroidPermissions(config, opts) {
   });
 }
 
+/**
+ * Declares `android.hardware.nfc` as NOT required, on the host's manifest.
+ *
+ * This is not decoration, and it must never be separated from the NFC
+ * permission. Android INFERS `<uses-feature android:name="android.hardware.nfc"
+ * android:required="true">` from `android.permission.NFC` whenever the feature
+ * is not declared explicitly — and Play then hides the app from every device
+ * without an NFC radio. For a KYC SDK that is most of the catalogue in the
+ * markets we serve.
+ *
+ * So: the permission (androidPermissionsFor) and this declaration are written
+ * under the same `nfc: true` opt-in in withMyazaKyc, and nothing else writes
+ * either. plugin.test.ts pins that pairing with a source scan, because two
+ * separate functions are otherwise free to drift apart.
+ *
+ * Pure and exported so the pairing can be pinned by a test. The failure it
+ * guards has no runtime symptom in development — the app builds, installs and
+ * runs perfectly on the NFC-capable phone the developer is holding, and is
+ * simply absent from the store listing for everyone else.
+ *
+ * @param {Record<string, any>} manifest the `modResults.manifest` object
+ */
+function ensureNfcFeatureOptional(manifest) {
+  const list = Array.isArray(manifest['uses-feature']) ? manifest['uses-feature'] : [];
+  const existing = list.find((f) => f && f.$ && f.$['android:name'] === 'android.hardware.nfc');
+  if (existing) {
+    // An explicit `required="true"` from the host or another library would
+    // reintroduce exactly the store-visibility problem above, so it is
+    // overwritten rather than respected.
+    existing.$['android:required'] = 'false';
+  } else {
+    list.push({
+      $: { 'android:name': 'android.hardware.nfc', 'android:required': 'false' },
+    });
+  }
+  manifest['uses-feature'] = list;
+  return manifest;
+}
+
+function withAndroidNfcFeature(config) {
+  return withAndroidManifest(config, (cfg) => {
+    ensureNfcFeatureOptional(cfg.modResults.manifest);
+    return cfg;
+  });
+}
+
 /** iOS side of the always-on tier: the Always usage string plus the location
  *  background mode, without which a geofence wake is refused. */
 function withIosBackgroundLocation(config, customMessage) {
@@ -211,6 +261,10 @@ function withMyazaKyc(config, props = {}) {
     config = withIosBackgroundLocation(config, props.locationPermission);
   }
   if (props.nfc === true) {
+    // Android: the permission comes from androidPermissionsFor above; this adds
+    // the uses-feature that must accompany it. Never write one without the
+    // other — see ensureNfcFeatureOptional.
+    config = withAndroidNfcFeature(config);
     config = withIosNfc(config, props.nfcPermission);
   }
   return config;
@@ -222,4 +276,5 @@ module.exports = createRunOncePlugin(withMyazaKyc, pkg.name, pkg.version);
 module.exports.applyNfcInfoPlist = applyNfcInfoPlist;
 module.exports.applyNfcEntitlements = applyNfcEntitlements;
 module.exports.androidPermissionsFor = androidPermissionsFor;
+module.exports.ensureNfcFeatureOptional = ensureNfcFeatureOptional;
 module.exports.EMRTD_AID = EMRTD_AID;

package/ios/HybridMyazaTextRecognizer.swift

@@ -27,6 +27,14 @@ import NitroModules
 // ---------------------------------------------------------------------------
 
 final class HybridMyazaTextRecognizer: HybridMyazaTextRecognizerSpec {
+  // Apple Vision ships with the OS — there is no model to fetch, no Play
+  // Services equivalent, and no window in which recognition is unavailable.
+  // These exist only because Android fetches ML Kit's models on demand; iOS
+  // answers "ready" unconditionally so the shared TS flow needs no platform
+  // branch.
+  func isModelReady() throws -> Bool { true }
+
+  func prepareModel() throws -> Promise<Bool> { Promise.resolved(withResult: true) }
 
   func recognizeText(frame: any HybridFrameSpec, bottomFraction: Double) throws -> TextResult {
     guard

package/nitrogen/generated/android/c++/JHybridMyazaTextRecognizerSpec.cpp

@@ -76,5 +76,26 @@ namespace margelo::nitro::myazakyc {
       return __promise;
     }();
   }
+  bool JHybridMyazaTextRecognizerSpec::isModelReady() {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jboolean()>("isModelReady");
+    auto __result = method(_javaPart);
+    return static_cast<bool>(__result);
+  }
+  std::shared_ptr<Promise<bool>> JHybridMyazaTextRecognizerSpec::prepareModel() {
+    static const auto method = _javaPart->javaClassStatic()->getMethod<jni::local_ref<JPromise::javaobject>()>("prepareModel");
+    auto __result = method(_javaPart);
+    return [&]() {
+      auto __promise = Promise<bool>::create();
+      __result->cthis()->addOnResolvedListener([=](const jni::alias_ref<jni::JObject>& __boxedResult) {
+        auto __result = jni::static_ref_cast<jni::JBoolean>(__boxedResult);
+        __promise->resolve(static_cast<bool>(__result->value()));
+      });
+      __result->cthis()->addOnRejectedListener([=](const jni::alias_ref<jni::JThrowable>& __throwable) {
+        jni::JniException __jniError(__throwable);
+        __promise->reject(std::make_exception_ptr(__jniError));
+      });
+      return __promise;
+    }();
+  }
 
 } // namespace margelo::nitro::myazakyc

package/nitrogen/generated/android/c++/JHybridMyazaTextRecognizerSpec.hpp

@@ -56,6 +56,8 @@ namespace margelo::nitro::myazakyc {
     // Methods
     TextResult recognizeText(const std::shared_ptr<margelo::nitro::camera::HybridFrameSpec>& frame, double bottomFraction) override;
     std::shared_ptr<Promise<TextResult>> recognizeTextInImage(const std::string& uri, double bottomFraction) override;
+    bool isModelReady() override;
+    std::shared_ptr<Promise<bool>> prepareModel() override;
 
   private:
     jni::global_ref<JHybridMyazaTextRecognizerSpec::JavaPart> _javaPart;

package/nitrogen/generated/android/kotlin/com/margelo/nitro/myazakyc/HybridMyazaTextRecognizerSpec.kt

@@ -37,6 +37,14 @@ abstract class HybridMyazaTextRecognizerSpec: HybridObject() {
   @DoNotStrip
   @Keep
   abstract fun recognizeTextInImage(uri: String, bottomFraction: Double): Promise<TextResult>
+  
+  @DoNotStrip
+  @Keep
+  abstract fun isModelReady(): Boolean
+  
+  @DoNotStrip
+  @Keep
+  abstract fun prepareModel(): Promise<Boolean>
 
   // Default implementation of `HybridObject.toString()`
   override fun toString(): String {

package/nitrogen/generated/ios/c++/HybridMyazaTextRecognizerSpecSwift.hpp

@@ -90,6 +90,22 @@ namespace margelo::nitro::myazakyc {
       auto __value = std::move(__result.value());
       return __value;
     }
+    inline bool isModelReady() override {
+      auto __result = _swiftPart.isModelReady();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
+    inline std::shared_ptr<Promise<bool>> prepareModel() override {
+      auto __result = _swiftPart.prepareModel();
+      if (__result.hasError()) [[unlikely]] {
+        std::rethrow_exception(__result.error());
+      }
+      auto __value = std::move(__result.value());
+      return __value;
+    }
 
   private:
     KycSdkReactNative::HybridMyazaTextRecognizerSpec_cxx _swiftPart;

package/nitrogen/generated/ios/swift/HybridMyazaTextRecognizerSpec.swift

@@ -16,6 +16,8 @@ public protocol HybridMyazaTextRecognizerSpec_protocol: HybridObject {
   // Methods
   func recognizeText(frame: (any HybridFrameSpec), bottomFraction: Double) throws -> TextResult
   func recognizeTextInImage(uri: String, bottomFraction: Double) throws -> Promise<TextResult>
+  func isModelReady() throws -> Bool
+  func prepareModel() throws -> Promise<Bool>
 }
 
 public extension HybridMyazaTextRecognizerSpec_protocol {

package/nitrogen/generated/ios/swift/HybridMyazaTextRecognizerSpec_cxx.swift

@@ -159,4 +159,35 @@ open class HybridMyazaTextRecognizerSpec_cxx {
       return bridge.create_Result_std__shared_ptr_Promise_TextResult___(__exceptionPtr)
     }
   }
+  
+  @inline(__always)
+  public final func isModelReady() -> bridge.Result_bool_ {
+    do {
+      let __result = try self.__implementation.isModelReady()
+      let __resultCpp = __result
+      return bridge.create_Result_bool_(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_bool_(__exceptionPtr)
+    }
+  }
+  
+  @inline(__always)
+  public final func prepareModel() -> bridge.Result_std__shared_ptr_Promise_bool___ {
+    do {
+      let __result = try self.__implementation.prepareModel()
+      let __resultCpp = { () -> bridge.std__shared_ptr_Promise_bool__ in
+        let __promise = bridge.create_std__shared_ptr_Promise_bool__()
+        let __promiseHolder = bridge.wrap_std__shared_ptr_Promise_bool__(__promise)
+        __result
+          .then({ __result in __promiseHolder.resolve(__result) })
+          .catch({ __error in __promiseHolder.reject(__error.toCpp()) })
+        return __promise
+      }()
+      return bridge.create_Result_std__shared_ptr_Promise_bool___(__resultCpp)
+    } catch (let __error) {
+      let __exceptionPtr = __error.toCpp()
+      return bridge.create_Result_std__shared_ptr_Promise_bool___(__exceptionPtr)
+    }
+  }
 }

package/nitrogen/generated/shared/c++/HybridMyazaTextRecognizerSpec.cpp

@@ -16,6 +16,8 @@ namespace margelo::nitro::myazakyc {
     registerHybrids(this, [](Prototype& prototype) {
       prototype.registerHybridMethod("recognizeText", &HybridMyazaTextRecognizerSpec::recognizeText);
       prototype.registerHybridMethod("recognizeTextInImage", &HybridMyazaTextRecognizerSpec::recognizeTextInImage);
+      prototype.registerHybridMethod("isModelReady", &HybridMyazaTextRecognizerSpec::isModelReady);
+      prototype.registerHybridMethod("prepareModel", &HybridMyazaTextRecognizerSpec::prepareModel);
     });
   }
 

package/nitrogen/generated/shared/c++/HybridMyazaTextRecognizerSpec.hpp

@@ -57,6 +57,8 @@ namespace margelo::nitro::myazakyc {
       // Methods
       virtual TextResult recognizeText(const std::shared_ptr<margelo::nitro::camera::HybridFrameSpec>& frame, double bottomFraction) = 0;
       virtual std::shared_ptr<Promise<TextResult>> recognizeTextInImage(const std::string& uri, double bottomFraction) = 0;
+      virtual bool isModelReady() = 0;
+      virtual std::shared_ptr<Promise<bool>> prepareModel() = 0;
 
     protected:
       // Hybrid Setup

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myazahq/kyc-sdk-react-native",
-  "version": "2.6.0",
+  "version": "3.0.0",
   "description": "Myaza KYC SDK for React Native (Expo) — ID verification, liveness detection, and document capture",
   "author": "Flitstack Technologies Inc.",
   "repository": {
@@ -49,6 +49,10 @@
   "license": "MIT",
   "peerDependencies": {
     "expo": ">=56",
+    "expo-application": ">=56",
+    "expo-device": ">=56",
+    "expo-document-picker": ">=56",
+    "expo-localization": ">=56",
     "expo-task-manager": ">=14",
     "react-native-webview": ">=13",
     "react": ">=19",
@@ -61,6 +65,18 @@
     "react-native-worklets": ">=0.8"
   },
   "peerDependenciesMeta": {
+    "expo-application": {
+      "optional": true
+    },
+    "expo-device": {
+      "optional": true
+    },
+    "expo-document-picker": {
+      "optional": true
+    },
+    "expo-localization": {
+      "optional": true
+    },
     "expo-task-manager": {
       "optional": true
     },
@@ -69,21 +85,14 @@
     }
   },
   "dependencies": {
-    "@expo-google-fonts/karla": "^0.4.2",
-    "@expo-google-fonts/space-grotesk": "^0.4.1",
-    "@expo/vector-icons": "^14.0.4",
     "country-flag-icons": "^1.6.17",
-    "expo-application": "~56.0.3",
     "libphonenumber-js": "^1.13.8",
     "expo-crypto": "~56.0.4",
     "expo-clipboard": "~56.0.0",
-    "expo-device": "~56.0.4",
-    "expo-document-picker": "~56.0.4",
     "expo-font": "~56.0.5",
     "expo-glass-effect": "~56.0.4",
     "expo-image-manipulator": "~56.0.17",
     "expo-image-picker": "~56.0.16",
-    "expo-localization": "~56.0.6",
     "expo-location": "~56.0.24",
     "expo-speech": "~56.0.3",
     "lucide-react-native": "^1.17.0",

package/src/MyazaKYC.tsx

@@ -15,8 +15,8 @@ import type { KYCStep, MyazaKYCConfig, SupportedCountry } from './types/config';
 import { KycRuntimeProvider, MyazaThemeProvider } from './components/runtime';
 import { WorkflowGate } from './components/WorkflowGate';
 import { useWorkflowMount } from './components/useWorkflowMount';
+import { usePrimeModels } from './lib/prime-models';
 import { safeReportError } from './services/errors';
-import { primeFaceModel } from './liveness/visionCameraFaceDetector';
 import { KycFlow, type BackResult } from './components/KycFlow';
 import { MyazaButton } from './components/MyazaButton';
 
@@ -99,16 +99,7 @@ function MyazaKYCTrigger({
   const settled = state.status !== 'resolving';
   const open = wantOpen && settled;
 
-  // Start fetching the face model the moment the user opens the flow, so the
-  // download overlaps consent and ID-type selection rather than stalling in
-  // front of the camera. Mirrors the web SDK's primeFaceMesh() on mount; the
-  // liveness step still gates on isFaceModelReady(), so this is best-effort.
-  const primedRef = useRef(false);
-  useEffect(() => {
-    if (!wantOpen || primedRef.current) return;
-    primedRef.current = true;
-    primeFaceModel();
-  }, [wantOpen]);
+  usePrimeModels(wantOpen, config.apiKey, config.devUrl);
 
   // Reported only once the user has actually tried to start. Prefetching must
   // not fire a consumer's error handler for a flow they never opened.
@@ -229,6 +220,8 @@ export function useMyazaKYC<C extends SupportedCountry = SupportedCountry>(
   configRef.current = config;
   const backRef = useRef<(() => BackResult) | null>(null);
 
+  usePrimeModels(wantOpen, config.apiKey, config.devUrl);
+
   // `refresh` is defined further down (it needs `wrappedConfig`), so it is
   // reached through a ref rather than reordering the component around it.
   const refreshRef = useRef<() => void>(() => undefined);

package/src/assets/fonts/OFL-Karla.txt

@@ -0,0 +1,93 @@
+Copyright 2019 The Karla Project Authors (https://github.com/googlefonts/karla)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+https://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/src/assets/fonts/OFL-SpaceGrotesk.txt

@@ -0,0 +1,93 @@
+Copyright 2020 The Space Grotesk Project Authors (https://github.com/floriankarsten/space-grotesk)
+
+This Font Software is licensed under the SIL Open Font License, Version 1.1.
+This license is copied below, and is also available with a FAQ at:
+http://scripts.sil.org/OFL
+
+
+-----------------------------------------------------------
+SIL OPEN FONT LICENSE Version 1.1 - 26 February 2007
+-----------------------------------------------------------
+
+PREAMBLE
+The goals of the Open Font License (OFL) are to stimulate worldwide
+development of collaborative font projects, to support the font creation
+efforts of academic and linguistic communities, and to provide a free and
+open framework in which fonts may be shared and improved in partnership
+with others.
+
+The OFL allows the licensed fonts to be used, studied, modified and
+redistributed freely as long as they are not sold by themselves. The
+fonts, including any derivative works, can be bundled, embedded, 
+redistributed and/or sold with any software provided that any reserved
+names are not used by derivative works. The fonts and derivatives,
+however, cannot be released under any other type of license. The
+requirement for fonts to remain under this license does not apply
+to any document created using the fonts or their derivatives.
+
+DEFINITIONS
+"Font Software" refers to the set of files released by the Copyright
+Holder(s) under this license and clearly marked as such. This may
+include source files, build scripts and documentation.
+
+"Reserved Font Name" refers to any names specified as such after the
+copyright statement(s).
+
+"Original Version" refers to the collection of Font Software components as
+distributed by the Copyright Holder(s).
+
+"Modified Version" refers to any derivative made by adding to, deleting,
+or substituting -- in part or in whole -- any of the components of the
+Original Version, by changing formats or by porting the Font Software to a
+new environment.
+
+"Author" refers to any designer, engineer, programmer, technical
+writer or other person who contributed to the Font Software.
+
+PERMISSION & CONDITIONS
+Permission is hereby granted, free of charge, to any person obtaining
+a copy of the Font Software, to use, study, copy, merge, embed, modify,
+redistribute, and sell modified and unmodified copies of the Font
+Software, subject to the following conditions:
+
+1) Neither the Font Software nor any of its individual components,
+in Original or Modified Versions, may be sold by itself.
+
+2) Original or Modified Versions of the Font Software may be bundled,
+redistributed and/or sold with any software, provided that each copy
+contains the above copyright notice and this license. These can be
+included either as stand-alone text files, human-readable headers or
+in the appropriate machine-readable metadata fields within text or
+binary files as long as those fields can be easily viewed by the user.
+
+3) No Modified Version of the Font Software may use the Reserved Font
+Name(s) unless explicit written permission is granted by the corresponding
+Copyright Holder. This restriction only applies to the primary font name as
+presented to the users.
+
+4) The name(s) of the Copyright Holder(s) or the Author(s) of the Font
+Software shall not be used to promote, endorse or advertise any
+Modified Version, except to acknowledge the contribution(s) of the
+Copyright Holder(s) and the Author(s) or with their explicit written
+permission.
+
+5) The Font Software, modified or unmodified, in part or in whole,
+must be distributed entirely under this license, and must not be
+distributed under any other license. The requirement for fonts to
+remain under this license does not apply to any document created
+using the Font Software.
+
+TERMINATION
+This license becomes null and void if any of the above conditions are
+not met.
+
+DISCLAIMER
+THE FONT SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
+EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO ANY WARRANTIES OF
+MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT
+OF COPYRIGHT, PATENT, TRADEMARK, OR OTHER RIGHT. IN NO EVENT SHALL THE
+COPYRIGHT HOLDER BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
+INCLUDING ANY GENERAL, SPECIAL, INDIRECT, INCIDENTAL, OR CONSEQUENTIAL
+DAMAGES, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
+FROM, OUT OF THE USE OR INABILITY TO USE THE FONT SOFTWARE OR FROM
+OTHER DEALINGS IN THE FONT SOFTWARE.

package/src/assets/fonts/README.md

@@ -0,0 +1,12 @@
+# Bundled typefaces
+
+The seven faces the SDK draws with, and nothing else: Karla 400/500/600/700
+(body) and Space Grotesk 500/600/700 (headings). Both families are Google
+Fonts under the SIL Open Font License 1.1; the licence for each sits beside
+the files (`OFL-Karla.txt`, `OFL-SpaceGrotesk.txt`).
+
+They are vendored rather than imported from the `@expo-google-fonts` packages
+because Metro bundles every `require` in a package index whether or not the
+export is used, so those two packages put all 19 of their font files (1.85 MB)
+into every integrator's app for the seven faces the SDK uses. Add a weight here
+only when `config/font-resolve.ts` resolves to it.

package/src/capture/useAutoCapture.ts

@@ -2,7 +2,7 @@ import { useCallback, useEffect, useMemo, useRef, useState } from 'react';
 import { useFrameOutput } from 'react-native-vision-camera';
 import { runOnJS } from 'react-native-worklets';
 
-import { hasTextRecognizer, recognizeAllLines } from '../mrz/textRecognizer';
+import { hasTextRecognizer, primeTextModel, recognizeAllLines } from '../mrz/textRecognizer';
 import { extractMrz } from '../mrz/extract';
 import type { MrzScan } from '../mrz/parse';
 import { DocumentTextGate } from './documentTextGate';
@@ -97,6 +97,13 @@ export function useAutoCapture({
   // body is the one place that is both.
   hasTextRecognizer();
   hasRectDetector();
+  // Android fetches the text model through Play Services, so start it here too.
+  // The flow primes at open and this is normally a no-op, but the document step
+  // can be reached directly in a resumed session. Auto-capture deliberately does
+  // NOT gate on readiness: it is an accelerator, the manual shutter is live
+  // throughout, so a model that never arrives costs convenience rather than
+  // leaving the user stuck.
+  primeTextModel();
 
   const gate = useMemo(() => new DocumentTextGate(), []);
   const [guidance, setGuidance] = useState<DocumentGuidance>(INITIAL);