@smileid/usesmileid_mlkit_face 12.0.1 → 12.1.0

package/CHANGELOG.md

@@ -1,3 +1,14 @@
+Full release notes: [Smile ID docs](https://docs.usesmileid.com/developer-resources/sdks/mobile/release-notes/react-native-expo).
+
+## 12.1.0
+
+See the repository CHANGELOG for the 12.1.0 release notes.
+
+
+## 12.0.2
+
+See the repository CHANGELOG for the 12.0.2 release notes.
+
 ## 12.0.1
 
 See the repository CHANGELOG for the 12.0.1 release notes.

package/README.md

@@ -20,8 +20,36 @@ No ML logic is reimplemented in this package — it's a pure passthrough.
 pnpm add @smileid/usesmileid_mlkit_face
 ```
 
-Expo's autolinking picks up `expo-module.config.json` at app build time;
-no manual native registration required.
+Expo's autolinking picks up `expo-module.config.json` at app build time, but the
+build settings the AAR needs belong to the root Gradle project, so add the
+package to `expo.plugins` in `app.json` and run `npx expo prebuild --clean`:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      [
+        "@smileid/usesmileid_mlkit_face",
+        { "kspVersion": "2.3.6", "additionalModelDependencies": ["barcode_ui"] }
+      ]
+    ]
+  }
+}
+```
+
+The plugin pins the Kotlin the AAR was compiled with (2.3.20) and the
+`androidx.core` version that resolves under Expo's Android Gradle Plugin.
+It also claims the `com.google.mlkit.vision.DEPENDENCIES` meta-data on your
+`<application>` with `tools:replace`: this AAR declares that key as `face`, so
+without the override a second ML Kit consumer declaring its own value (for
+instance `expo-camera`'s barcode scanner, which declares `barcode_ui`) fails the
+Android manifest merger. `additionalModelDependencies` is optional — name the
+hints your other consumers declare so their models are prefetched at install
+time rather than downloaded on first use.
+
+Expo's own KSP lookup carries no entry for that Kotlin and falls back to a KSP
+the compiler cannot load, so pass `kspVersion` as shown — the samples use
+`2.3.6`. `kotlinVersion` overrides the Kotlin pin.
 
 ## Usage
 

package/android/build.gradle

@@ -17,7 +17,7 @@ plugins {
 }
 
 group = 'com.usesmileid.mlkit.face'
-version = '12.0.1'
+version = '12.1.0'
 
 android {
   namespace 'com.usesmileid.mlkit.face'
@@ -29,7 +29,7 @@ android {
   // android/build.gradle and the rest of the @expo/* modules.
   defaultConfig {
     versionCode 1
-    versionName '12.0.1'
+    versionName '12.1.0'
     // R8 keep-rules to bundle into partner apps that depend on this
     // module. Without these, R8 may rename the Expo module entry
     // point and the JS-bridged member functions, breaking autolinking.
@@ -38,21 +38,26 @@ android {
 }
 
 dependencies {
+  // kamera native core: the analyzer executor takes analysis frames from
+  // kamera's KameraFrameHub so pixels never cross the JS bridge. Resolves from
+  // Maven Central; a local publishToMavenLocal build wins (see kamera.md).
+  implementation 'com.usesmileid:kamera:1.0.5'
+
   // Existing Smile ID native AAR — the entire ML pipeline lives here.
   // This Expo Module is a thin Kotlin shim that constructs the
   // session and bridges its four methods to JS via Expo Modules.
-  implementation 'com.usesmileid:mlkit-face:12.0.1'
-
-  // VisionCamera frame-processor plugin classes. The host app provides
-  // this dependency via RN autolinking — react-native-vision-camera >= 4.7.3
-  // must be present in the partner app's package.json.
-  implementation project(':react-native-vision-camera')
-
-  // CameraX types (`ImageProxy`, `ExperimentalGetImage`) referenced by the
-  // frame processor plugin. VisionCamera declares camera-core as
-  // `implementation`, so it is NOT on this module's compile classpath
-  // transitively — compileOnly pins the compile-time API while the host
-  // app's VisionCamera provides the runtime classes (its camera-core is
-  // 1.5.0-alpha03; the `ImageProxy` surface used here is stable since 1.0).
-  compileOnly 'androidx.camera:camera-core:1.5.0-alpha03'
+  implementation 'com.usesmileid:mlkit-face:12.1.0'
+
+
+}
+
+// kamera resolves from Maven Central. mavenLocal stays injected — content-filtered to
+// com.usesmileid — the same way kamera's own glue does it, so a locally published kamera
+// build takes precedence during the kamera dev loop without host apps editing repos.
+rootProject.allprojects {
+  repositories {
+    mavenLocal {
+      content { includeGroup 'com.usesmileid' }
+    }
+  }
 }

package/android/src/main/java/com/usesmileid/mlkit/face/UseSmileIDMlkitFaceKameraAnalysisTick.kt

@@ -0,0 +1,42 @@
+package com.usesmileid.mlkit.face
+
+import com.usesmileid.bridge.model.YuvFrame as NativeYuvFrame
+import com.usesmileid.kamera.integration.KameraFrameHub
+import com.usesmileid.rn.analyzer.mlkitface.toNativeYuvFrame
+import kotlin.coroutines.cancellation.CancellationException
+import kotlinx.coroutines.runBlocking
+import kotlinx.coroutines.withContext
+
+/**
+ * Scans the latest [KameraFrameHub] frame natively; no pending frame returns the `no_frame` wire error.
+ * The frame's rotationDegrees already uprights the buffer to the locked interface axis.
+ */
+internal fun analyzeKameraFrameTick(arguments: Map<String, Any?>?): Any {
+    val frame = KameraFrameHub.take() ?: return mapOf("error" to "no_frame")
+    val yuvFrame = try {
+        frame.toNativeYuvFrame()
+    } finally {
+        // Closing releases the frame to the pipeline; the converted copy owns its own bytes.
+        frame.close()
+    }
+
+    // Device-tilt context (0 = upright portrait) for the validators.
+    val jsRotation = (arguments?.get("rotation") as? Number)?.toInt() ?: 0
+
+    return runBlocking {
+        withContext(UseSmileIDMlkitFaceSessionHolder.sessionDispatcher) {
+            val activeSession = UseSmileIDMlkitFaceSessionHolder.session
+                ?: return@withContext mapOf("error" to "session_not_configured")
+
+            try {
+                val scanResult = activeSession.scan(yuvFrame, jsRotation)
+                val events = activeSession.drainCaptureReadyEvents()
+                UseSmileIDMlkitFaceModule.buildWireResult(scanResult, events)
+            } catch (cancellation: CancellationException) {
+                throw cancellation
+            } catch (e: Exception) {
+                mapOf("error" to ("scan_failed: " + (e.message ?: e.javaClass.simpleName)))
+            }
+        }
+    }
+}

package/android/src/main/java/com/usesmileid/mlkit/face/UseSmileIDMlkitFaceModule.kt

@@ -14,7 +14,6 @@ import com.usesmileid.bridge.session.UseSmileIDFaceSession
 import com.usesmileid.bridge.session.UseSmileIDScanState
 import com.usesmileid.bridge.session.UseSmileIDScanStateType
 import com.usesmileid.bridge.storage.FrameStorage
-import com.mrousavy.camera.frameprocessors.FrameProcessorPluginRegistry
 import com.usesmileid.rn.analyzer.mlkitface.UseSmileIDAnalyzerExecutor
 import expo.modules.kotlin.Promise
 import expo.modules.kotlin.modules.Module
@@ -31,10 +30,7 @@ import expo.modules.kotlin.modules.ModuleDefinition
  * subclass hooks (session construction, wire conversion) and forwards
  * the async functions through it.
  *
- * Per-frame work is handled by [UseSmileIDMlkitFaceFrameProcessorPlugin],
- * which is registered with VisionCamera's frame-processor runtime in
- * [OnCreate]. Partners call `VisionCameraProxy.initFrameProcessorPlugin`
- * from their JS worklet instead of the old `AsyncFunction("analyze")`.
+ * Frames reach `analyzeKameraFrame` through kamera's native hub; pixels never cross the JS bridge.
  *
  * Lifecycle: Expo instantiates exactly one `Module` per app process;
  * the executor is owned for the module's lifetime.
@@ -118,20 +114,17 @@ class UseSmileIDMlkitFaceModule : Module() {
                 ?: throw IllegalStateException("Module not attached to a React context")
             executor.onAttach(ctx)
 
-            // Guard against duplicate registration on dev-client hot reloads
-            // where OnCreate can fire more than once in the same process.
-            if (!pluginRegistered) {
-                pluginRegistered = true
-                FrameProcessorPluginRegistry.addFrameProcessorPlugin(
-                    FRAME_PROCESSOR_PLUGIN_NAME,
-                ) { _, _ -> UseSmileIDMlkitFaceFrameProcessorPlugin() }
-            }
         }
 
         AsyncFunction("configure") { config: Map<String, Any?> ->
             executor.handleConfigure(config)
         }
 
+        AsyncFunction("analyzeKameraFrame") { arguments: Map<String, Any?>? ->
+            // Blocks this module's async queue so only one scan is in flight at a time.
+            analyzeKameraFrameTick(arguments)
+        }
+
         AsyncFunction("reset") {
             executor.handleReset()
         }
@@ -158,21 +151,6 @@ class UseSmileIDMlkitFaceModule : Module() {
         /** Wire-format key partners pass via `FaceConfig.analyzerFactoryKey`. */
         const val KEY: String = "mlkit-face"
 
-        /**
-         * Must match the JS worklet's `VisionCameraProxy.initFrameProcessorPlugin(...)`
-         * call exactly — drift is a runtime "plugin not found" error.
-         */
-        const val FRAME_PROCESSOR_PLUGIN_NAME: String = "UseSmileIDMlkitFaceFrameProcessor"
-
-        /**
-         * [FrameProcessorPluginRegistry.addFrameProcessorPlugin] asserts uniqueness
-         * and crashes on duplicate registration; this guard prevents that on dev-client
-         * hot reloads where [OnCreate] fires more than once per process.
-         */
-        @Volatile
-        private var pluginRegistered: Boolean = false
-
-        /** Wire-result builder shared with [UseSmileIDMlkitFaceFrameProcessorPlugin]. */
         internal fun buildWireResult(
             scanResult: UseSmileIDFaceScanResult,
             events: List<NativeCaptureReadyEvent>,

package/android/src/main/java/com/usesmileid/mlkit/face/UseSmileIDMlkitFaceSessionHolder.kt

@@ -10,9 +10,8 @@ import kotlinx.coroutines.asCoroutineDispatcher
  *
  * The session's state machine is not thread-safe; all operations —
  * scan+drain as one atomic unit, flush, reset, close — are serialized
- * through [sessionDispatcher] (a single-thread executor). The FP plugin
- * blocks its thread via [runBlocking]; VisionCamera drops frames that
- * arrive while a scan is in flight rather than queuing them.
+ * through [sessionDispatcher] (a single-thread executor). The analysis tick blocks its
+ * caller via [runBlocking]; kamera's hub keeps only the latest frame, so frames never queue.
  */
 internal object UseSmileIDMlkitFaceSessionHolder {
 

package/android/src/main/java/com/usesmileid/rn/analyzer/mlkitface/UseSmileIDAnalyzerExecutor.kt

@@ -12,6 +12,8 @@ import com.usesmileid.bridge.model.CaptureType
 import com.usesmileid.bridge.model.YuvFrame as NativeYuvFrame
 import com.usesmileid.bridge.storage.DocumentSide
 import com.usesmileid.bridge.storage.FrameStorage
+import com.usesmileid.kamera.frame.KameraFrame
+import com.usesmileid.kamera.integration.KameraFrameHub
 import java.io.File
 import kotlinx.coroutines.CoroutineDispatcher
 import kotlinx.coroutines.CoroutineScope
@@ -171,6 +173,7 @@ abstract class UseSmileIDAnalyzerExecutor<
 
     // Shared implementation behind the Expo Module's async functions -----
 
+
     /**
      * Implementation behind `configure`. Closes any prior session,
      * allocates a fresh on-disk session directory, and delegates session
@@ -281,3 +284,28 @@ abstract class UseSmileIDAnalyzerExecutor<
         return dir
     }
 }
+
+/** Copies the YUV planes so the frame can close at once; rotation stays metadata for the detector. */
+internal fun KameraFrame.toNativeYuvFrame(): NativeYuvFrame {
+    val yPlane = planes[0]
+    val uPlane = planes[1]
+    val vPlane = planes[2]
+    fun copyBytes(buffer: java.nio.ByteBuffer): ByteArray {
+        val source = buffer.duplicate()
+        source.rewind()
+        return ByteArray(source.remaining()).also { source.get(it) }
+    }
+    return NativeYuvFrame(
+        planeY = copyBytes(yPlane.buffer),
+        planeU = copyBytes(uPlane.buffer),
+        planeV = copyBytes(vPlane.buffer),
+        yRowStride = yPlane.rowStride,
+        uRowStride = uPlane.rowStride,
+        vRowStride = vPlane.rowStride,
+        uPixelStride = uPlane.pixelStride,
+        vPixelStride = vPlane.pixelStride,
+        width = width,
+        height = height,
+        rotation = rotationDegrees,
+    )
+}

package/app.plugin.js

@@ -0,0 +1,3 @@
+// Entry point Expo discovers when an app references this package in
+// `expo.plugins`. The compiled plugin lives at `plugin/build/index.js`.
+module.exports = require("./plugin/build");

package/dist/index.d.ts

@@ -20,9 +20,10 @@ import type { FaceConfig, FaceScanResult } from "@smileid/usesmileid_bridge";
  * `FaceAnalyzer` for the canonical contract.
  */
 /**
- * Must match the Kotlin Expo Module's `Name("UseSmileIDMlkitFace")` and its
- * VisionCamera frame-processor-plugin registration — drift is a runtime
- * "module/plugin not found" error, not a compile error.
+ * Must match the Kotlin Expo Module's `Name("UseSmileIDMlkitFace")` — drift is a runtime
+ * "module not found" error, not a compile error.
+ *
+ * `frameProcessorPluginName` is inert; kept only for API compatibility.
  */
 export declare const UseSmileIDMlkitFaceIdentifiers: {
     readonly nativeModuleName: "UseSmileIDMlkitFace";
@@ -30,4 +31,3 @@ export declare const UseSmileIDMlkitFaceIdentifiers: {
 };
 export declare const useSmileIDMlkitFace: import("@smileid/usesmileid_platform_interface").FaceAnalyzer;
 export type { FaceConfig, FaceScanResult };
-//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,38 +1 @@
-import { AnalyzerFactoryKey } from "@smileid/usesmileid_bridge";
-import { useSmileIDAnalyzerExecutor } from "@smileid/usesmileid_platform_interface";
-/**
- * Google ML Kit face analyzer (Android-only).
- *
- * Thin shim around the existing native session
- * `com.usesmileid.bridge.session.UseSmileIDFaceSession(FaceDetectorAnalyzer())`
- * shipped in the `com.smileidentity:mlkit-face` AAR. The native side
- * runs the entire pipeline (analyzer + validator + transitioner +
- * state machine); this TS layer only routes calls and validates wire
- * payloads at the channel boundary.
- *
- * The canonical wiring lives in [useSmileIDAnalyzerExecutor] in
- * `usesmileid_platform_interface`. This file only supplies the
- * provider-specific identity so all six provider modules share one set
- * of correctness properties by construction.
- *
- * Lifecycle: `configure()` → per-frame analysis via the native frame
- * processor plugin → `reset()`? → `close()`. Calling
- * `close()` twice is idempotent. See `usesmileid_platform_interface`
- * `FaceAnalyzer` for the canonical contract.
- */
-/**
- * Must match the Kotlin Expo Module's `Name("UseSmileIDMlkitFace")` and its
- * VisionCamera frame-processor-plugin registration — drift is a runtime
- * "module/plugin not found" error, not a compile error.
- */
-export const UseSmileIDMlkitFaceIdentifiers = {
-    nativeModuleName: "UseSmileIDMlkitFace",
-    frameProcessorPluginName: "UseSmileIDMlkitFaceFrameProcessor",
-};
-export const useSmileIDMlkitFace = useSmileIDAnalyzerExecutor({
-    nativeModuleName: UseSmileIDMlkitFaceIdentifiers.nativeModuleName,
-    frameProcessorPluginName: UseSmileIDMlkitFaceIdentifiers.frameProcessorPluginName,
-    kind: "face",
-    key: AnalyzerFactoryKey.MLKitFace,
-});
-//# sourceMappingURL=index.js.map
+"use strict";import{AnalyzerFactoryKey as e}from"@smileid/usesmileid_bridge";import{useSmileIDAnalyzerExecutor as r}from"@smileid/usesmileid_platform_interface";export const UseSmileIDMlkitFaceIdentifiers={nativeModuleName:"UseSmileIDMlkitFace",frameProcessorPluginName:"UseSmileIDMlkitFaceFrameProcessor"},useSmileIDMlkitFace=r({nativeModuleName:UseSmileIDMlkitFaceIdentifiers.nativeModuleName,frameProcessorPluginName:UseSmileIDMlkitFaceIdentifiers.frameProcessorPluginName,kind:"face",key:e.MLKitFace});

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@smileid/usesmileid_mlkit_face",
-  "version": "12.0.1",
+  "version": "12.1.0",
   "description": "Android MLKit face detection implementation for the UseSmileID React Native (Expo) SDK.",
   "homepage": "https://usesmileid.com",
   "repository": {
@@ -31,20 +31,24 @@
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js",
       "require": "./dist/index.js"
-    }
+    },
+    "./app.plugin.js": "./app.plugin.js"
   },
   "files": [
     "dist",
-    "src",
-    "android",
+    "android/build.gradle",
+    "android/consumer-rules.pro",
+    "android/src/main",
+    "plugin/build",
+    "app.plugin.js",
     "expo-module.config.json",
     "README.md",
     "LICENSE",
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@smileid/usesmileid_bridge": "12.0.1",
-    "@smileid/usesmileid_platform_interface": "12.0.1"
+    "@smileid/usesmileid_platform_interface": "12.1.0",
+    "@smileid/usesmileid_bridge": "12.1.0"
   },
   "peerDependencies": {
     "expo": ">=56.0.0",
@@ -52,18 +56,22 @@
     "react-native": ">=0.83.0"
   },
   "devDependencies": {
-    "expo-modules-core": "^56.0.15",
-    "react-native": "^0.85.3",
+    "@types/node": "^26.4.1",
+    "expo": "~57.0.20",
+    "expo-modules-core": "^57.0.16",
+    "react-native": "^0.86.3",
     "typescript": "^6.0.3"
   },
   "publishConfig": {
     "access": "public"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json",
-    "typecheck": "tsc -b",
+    "build": "pnpm run build:lib && pnpm run build:plugin && node ../Scripts/copy-assets.mjs",
+    "build:lib": "tsc -p tsconfig.json",
+    "build:plugin": "tsc -p plugin/tsconfig.json",
+    "typecheck": "tsc -b && tsc -p plugin/tsconfig.json --noEmit",
     "test": "vitest run",
     "test:watch": "vitest",
-    "clean": "rm -rf dist .turbo coverage"
+    "clean": "rm -rf dist plugin/build .turbo coverage tsconfig.tsbuildinfo"
   }
 }

package/plugin/build/index.d.ts

@@ -0,0 +1,11 @@
+import { type ConfigPlugin } from "expo/config-plugins";
+import { type MlkitManifestMergeOptions } from "./lib/mlkit_manifest";
+export interface MlkitFaceOptions extends MlkitManifestMergeOptions {
+    /** Overrides the default Kotlin pin (must read the AARs' metadata). */
+    kotlinVersion?: string;
+    /** Opt-in: only when Expo's lookup table lacks the pinned Kotlin. */
+    kspVersion?: string;
+}
+declare const withMlkitFace: ConfigPlugin<MlkitFaceOptions | void>;
+export default withMlkitFace;
+export type { MlkitManifestMergeOptions };

package/plugin/build/index.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0});const root_project_1=require("./lib/root_project"),mlkit_manifest_1=require("./lib/mlkit_manifest"),DEFAULT_KOTLIN_VERSION="2.3.20",FORCED_DEPENDENCIES=["androidx.core:core:1.18.0","androidx.core:core-ktx:1.18.0"],withMlkitFace=(t,o)=>{const{kotlinVersion:i,kspVersion:e,...r}=o??{};return(0,mlkit_manifest_1.withMlkitManifestMerge)((0,root_project_1.withAndroidRootProjectPins)(t,{kotlinVersion:i??DEFAULT_KOTLIN_VERSION,...e!==void 0?{kspVersion:e}:{},forcedDependencies:FORCED_DEPENDENCIES}),r)};exports.default=withMlkitFace;

package/plugin/build/lib/mlkit_manifest.d.ts

@@ -0,0 +1,13 @@
+import { AndroidConfig, type ConfigPlugin } from "expo/config-plugins";
+type AndroidManifest = AndroidConfig.Manifest.AndroidManifest;
+export interface MlkitManifestMergeOptions {
+    /** Hints your app's other ML Kit consumers declare, so their models prefetch at install time rather than on first use. */
+    readonly additionalModelDependencies?: readonly string[];
+}
+/** Provider hint first, then the caller's, deduplicated and order-stable. */
+export declare function mergedModelDependencies(additional: readonly string[]): string;
+/** Declares the merged `com.google.mlkit.vision.DEPENDENCIES` on the host `<application>` with `tools:replace`. */
+export declare const withMlkitManifestMerge: ConfigPlugin<MlkitManifestMergeOptions | void>;
+/** Pure form of the edit. Idempotent; a re-run replaces a stale value. */
+export declare function applyMlkitManifestMerge(manifest: AndroidManifest, value: string): AndroidManifest;
+export {};

package/plugin/build/lib/mlkit_manifest.js

@@ -0,0 +1 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.withMlkitManifestMerge=void 0,exports.mergedModelDependencies=mergedModelDependencies,exports.applyMlkitManifestMerge=applyMlkitManifestMerge;const config_plugins_1=require("expo/config-plugins"),META_DATA_NAME="com.google.mlkit.vision.DEPENDENCIES",TOOLS_NAMESPACE="http://schemas.android.com/tools",PROVIDER_MODEL_DEPENDENCY="face",MODEL_DEPENDENCY=/^[a-z0-9_]+$/;function mergedModelDependencies(e){for(const t of e)if(!MODEL_DEPENDENCY.test(t))throw new Error(`[smileid-android] '${t}' is not a valid ML Kit model dependency. Expected a lowercase hint such as 'barcode_ui', as printed in the manifest-merger error.`);return[...new Set([PROVIDER_MODEL_DEPENDENCY,...e])].join(",")}const withMlkitManifestMerge=(e,t)=>(0,config_plugins_1.withAndroidManifest)(e,n=>(n.modResults=applyMlkitManifestMerge(n.modResults,mergedModelDependencies(t?.additionalModelDependencies??[])),n));exports.withMlkitManifestMerge=withMlkitManifestMerge;function applyMlkitManifestMerge(e,t){const n=config_plugins_1.AndroidConfig.Manifest.getMainApplicationOrThrow(e);n["meta-data"]??=[];const i=n["meta-data"],o=i.find(s=>s?.$?.["android:name"]===META_DATA_NAME);return o?(o.$["android:value"]=t,o.$["tools:replace"]="android:value"):i.push({$:{"android:name":META_DATA_NAME,"android:value":t,"tools:replace":"android:value"}}),e.manifest.$??={},e.manifest.$["xmlns:tools"]??=TOOLS_NAMESPACE,e}

package/plugin/build/lib/root_project.d.ts

@@ -0,0 +1,27 @@
+import { type AndroidConfig, type ConfigPlugin } from "expo/config-plugins";
+type PropertiesItem = AndroidConfig.Properties.PropertiesItem;
+export interface AndroidRootProjectPins {
+    /**
+     * Opt-in: only for hosts whose Kotlin predates the AARs' compiler. Current
+     * Expo defaults read the metadata, and forcing a Kotlin that Expo ships no
+     * compiler-plugin artifacts for breaks expo-modules-core.
+     */
+    kotlinVersion?: string;
+    /** Only alongside `kotlinVersion` — Expo's own lookup table may carry no entry for it. */
+    kspVersion?: string;
+    /** Opt-in: only for a host that must compile above React Native's default. The AARs declare their own consumer floor. */
+    compileSdkVersion?: number;
+    /** `group:name:version` coordinates forced everywhere, for deps whose newest release the host toolchain cannot consume. */
+    forcedDependencies: readonly string[];
+}
+/**
+ * AGP matches this against the resolved platform, which may or may not carry a minor
+ * (`android-37` vs `android-37.0`), so both forms are listed.
+ */
+export declare function suppressUnsupportedCompileSdkValue(compileSdkVersion: number): string;
+export declare function suppressAdvisoryProperties(items: PropertiesItem[], compileSdkVersion: number | undefined): PropertiesItem[];
+/** Declares the pins ahead of `apply plugin: "expo-root-project"`. */
+export declare const withAndroidRootProjectPins: ConfigPlugin<AndroidRootProjectPins>;
+/** Pure form of the edit. Idempotent; a re-run replaces stale values rather than appending. */
+export declare function applyAndroidRootProjectPins(contents: string, pins: AndroidRootProjectPins): string;
+export {};

package/plugin/build/lib/root_project.js

@@ -0,0 +1,4 @@
+"use strict";Object.defineProperty(exports,"__esModule",{value:!0}),exports.withAndroidRootProjectPins=void 0,exports.suppressUnsupportedCompileSdkValue=suppressUnsupportedCompileSdkValue,exports.suppressAdvisoryProperties=suppressAdvisoryProperties,exports.applyAndroidRootProjectPins=applyAndroidRootProjectPins;const config_plugins_1=require("expo/config-plugins"),SUPPRESS_KEY="android.suppressUnsupportedCompileSdk",BEGIN_MARKER="// === BEGIN smileid root-project pins ===",END_MARKER="// === END smileid root-project pins ===",APPLY_ROOT_PROJECT=/^apply\s+plugin:\s*["']expo-root-project["']/m,KGP_CLASSPATH=/classpath\s*(?:\(\s*)?['"]org\.jetbrains\.kotlin:kotlin-gradle-plugin(?::[^'"]*)?['"](?:\s*\))?/;function suppressUnsupportedCompileSdkValue(e){return`${e},${e}.0`}function suppressAdvisoryProperties(e,o){if(o===void 0)return e;const r={type:"property",key:SUPPRESS_KEY,value:suppressUnsupportedCompileSdkValue(o)},n=e.findIndex(t=>t.type==="property"&&t.key===SUPPRESS_KEY);return n===-1?[...e,r]:e.map((t,i)=>i===n?r:t)}const withSuppressedCompileSdkAdvisory=(e,o)=>(0,config_plugins_1.withGradleProperties)(e,r=>(r.modResults=suppressAdvisoryProperties(r.modResults,o),r)),withAndroidRootProjectPins=(e,o)=>withSuppressedCompileSdkAdvisory((0,config_plugins_1.withProjectBuildGradle)(e,r=>{if(r.modResults.language!=="groovy")throw new Error(`[smileid-android] Expected android/build.gradle to be Groovy DSL; refusing to edit a ${r.modResults.language} build script.`);return r.modResults.contents=applyAndroidRootProjectPins(r.modResults.contents,o),r}),o.compileSdkVersion);exports.withAndroidRootProjectPins=withAndroidRootProjectPins;function applyAndroidRootProjectPins(e,o){if(o.kspVersion!==void 0&&o.kotlinVersion===void 0)throw new Error("[smileid-android] `kspVersion` only makes sense alongside `kotlinVersion`.");validateGroovySafe(o);const r=o.kotlinVersion===void 0?e:pinKotlinGradlePlugin(e,o.kotlinVersion);return upsertPinBlock(r,renderPinBlock(o))}function validateGroovySafe(e){const o=[e.kotlinVersion,e.kspVersion,...e.forcedDependencies].filter(r=>r!==void 0);for(const r of o)if(/['\\\n\r\t$]/.test(r))throw new Error(`[smileid-android] Refusing to edit android/build.gradle: '${r}' contains an unsafe character.`)}function pinKotlinGradlePlugin(e,o){const r=`classpath('org.jetbrains.kotlin:kotlin-gradle-plugin:${o}')`;if(!KGP_CLASSPATH.test(e))throw new Error(`[smileid-android] Could not locate the kotlin-gradle-plugin classpath line in android/build.gradle. Refusing to silently no-op \u2014 the Smile ID analyzer modules do not compile unless the Kotlin compiler is pinned to ${o}.`);return e.replace(KGP_CLASSPATH,r)}function renderPinBlock(e){const o=[];e.kotlinVersion!==void 0&&o.push(["kotlinVersion",`'${e.kotlinVersion}'`]),e.kspVersion!==void 0&&o.push(["kspVersion",`'${e.kspVersion}'`]),e.compileSdkVersion!==void 0&&o.push(["compileSdkVersion",String(e.compileSdkVersion)]);const r=o.map(([n,t])=>`ext.${n} = ${t}`);return[BEGIN_MARKER,...r,...renderForcedDependencies(e.forcedDependencies),END_MARKER].join(`
+`)}function renderForcedDependencies(e){return e.length===0?[]:["","// Forced to the newest release that resolves under the AGP Expo generates.","allprojects {","  configurations.all {","    resolutionStrategy {",...e.map(o=>`      force '${o}'`),"    }","  }","}"]}function upsertPinBlock(e,o){const r=new RegExp(`${escapeRegExp(BEGIN_MARKER)}[\\s\\S]*?${escapeRegExp(END_MARKER)}`,"m");if(r.test(e))return e.replace(r,o);if(!APPLY_ROOT_PROJECT.test(e))throw new Error('[smileid-android] Could not locate `apply plugin: "expo-root-project"` in android/build.gradle. Refusing to silently no-op \u2014 these pins only take effect when declared before that plugin applies.');return e.replace(APPLY_ROOT_PROJECT,n=>`${o}
+
+${n}`)}function escapeRegExp(e){return e.replace(/[.*+?^${}()|[\]\\]/g,"\\$&")}

package/android/src/main/java/com/usesmileid/mlkit/face/UseSmileIDMlkitFaceFrameProcessorPlugin.kt

@@ -1,79 +0,0 @@
-package com.usesmileid.mlkit.face
-
-import androidx.camera.core.ExperimentalGetImage
-import com.mrousavy.camera.core.FrameInvalidError
-import com.mrousavy.camera.frameprocessors.Frame
-import com.mrousavy.camera.frameprocessors.FrameProcessorPlugin
-import com.usesmileid.bridge.model.YuvFrame as NativeYuvFrame
-import kotlin.coroutines.cancellation.CancellationException
-import kotlinx.coroutines.runBlocking
-import kotlinx.coroutines.withContext
-
-/**
- * VisionCamera Frame Processor Plugin for the ML Kit face backend.
- * Registered under [UseSmileIDMlkitFaceModule.FRAME_PROCESSOR_PLUGIN_NAME].
- * Reads raw [ImageProxy] planes directly (no JPEG encoding) and runs the
- * native session pipeline. Blocks the FP thread via [runBlocking] —
- * VisionCamera drops frames that arrive while a scan is in flight.
- */
-@OptIn(ExperimentalGetImage::class)
-internal class UseSmileIDMlkitFaceFrameProcessorPlugin : FrameProcessorPlugin() {
-
-    override fun callback(frame: Frame, arguments: Map<String, Any>?): Any? {
-        val imageProxy = try {
-            frame.imageProxy
-        } catch (e: FrameInvalidError) {
-            return mapOf("error" to "frame_conversion_failed")
-        }
-
-        val image = imageProxy.image
-            ?: return mapOf("error" to "frame_conversion_failed")
-
-        // Pixel-orientation for ML Kit — always from ImageProxy metadata, never from JS.
-        val sensorRotation = imageProxy.imageInfo.rotationDegrees
-
-        // Device-tilt context (0 = upright portrait) for head-pose math.
-        // Must not fall back to sensorRotation — sensor angle != device tilt.
-        val jsRotation = (arguments?.get("rotation") as? Number)?.toInt() ?: 0
-
-        val planes = image.planes
-        if (planes.size < 3) return mapOf("error" to "frame_conversion_failed")
-
-        fun extractPlane(index: Int): ByteArray {
-            val buffer = planes[index].buffer
-            buffer.rewind()
-            return ByteArray(buffer.remaining()).also { buffer.get(it) }
-        }
-
-        val yuvFrame = NativeYuvFrame(
-            planeY = extractPlane(0),
-            planeU = extractPlane(1),
-            planeV = extractPlane(2),
-            yRowStride = planes[0].rowStride,
-            uRowStride = planes[1].rowStride,
-            vRowStride = planes[2].rowStride,
-            uPixelStride = planes[1].pixelStride,
-            vPixelStride = planes[2].pixelStride,
-            width = image.width,
-            height = image.height,
-            rotation = sensorRotation,
-        )
-
-        return runBlocking {
-            withContext(UseSmileIDMlkitFaceSessionHolder.sessionDispatcher) {
-                val activeSession = UseSmileIDMlkitFaceSessionHolder.session
-                    ?: return@withContext mapOf("error" to "session_not_configured")
-
-                try {
-                    val scanResult = activeSession.scan(yuvFrame, jsRotation)
-                    val events = activeSession.drainCaptureReadyEvents()
-                    UseSmileIDMlkitFaceModule.buildWireResult(scanResult, events)
-                } catch (cancellation: CancellationException) {
-                    throw cancellation
-                } catch (e: Exception) {
-                    mapOf("error" to ("scan_failed: " + (e.message ?: e.javaClass.simpleName)))
-                }
-            }
-        }
-    }
-}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAG7E;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;;GAIG;AACH,eAAO,MAAM,8BAA8B;;;CAGjC,CAAC;AAEX,eAAO,MAAM,mBAAmB,+DAM9B,CAAC;AAKH,YAAY,EAAE,UAAU,EAAE,cAAc,EAAE,CAAC"}

package/dist/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAEhE,OAAO,EAAE,0BAA0B,EAAE,MAAM,wCAAwC,CAAC;AAEpF;;;;;;;;;;;;;;;;;;;GAmBG;AACH;;;;GAIG;AACH,MAAM,CAAC,MAAM,8BAA8B,GAAG;IAC5C,gBAAgB,EAAE,qBAAqB;IACvC,wBAAwB,EAAE,mCAAmC;CACrD,CAAC;AAEX,MAAM,CAAC,MAAM,mBAAmB,GAAG,0BAA0B,CAAC;IAC5D,gBAAgB,EAAE,8BAA8B,CAAC,gBAAgB;IACjE,wBAAwB,EACtB,8BAA8B,CAAC,wBAAwB;IACzD,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,kBAAkB,CAAC,SAAS;CAClC,CAAC,CAAC"}

package/src/__tests__/use_smile_id_mlkit_face.test.ts

@@ -1,101 +0,0 @@
-import { describe, expect, it, vi, beforeEach, type Mock } from "vitest";
-
-// Hoist the mock so `requireNativeModule` resolves to a stub before
-// the index module's top-level `requireNativeModule(...)` call runs.
-// Without `vi.hoisted(...)`, Vitest evaluates the import statement
-// before the mock is in scope and the wrapper grabs the real native
-// module — which doesn't exist in a Node test environment.
-const native = vi.hoisted(() => ({
-  configure: vi.fn(),
-  reset: vi.fn(),
-  close: vi.fn(),
-}));
-
-vi.mock("expo-modules-core", () => ({
-  requireNativeModule: vi.fn(() => native),
-}));
-
-// Imports happen *after* the mock is registered.
-import { requireNativeModule } from "expo-modules-core";
-import { useSmileIDMlkitFace, UseSmileIDMlkitFaceIdentifiers } from "../index";
-
-describe("useSmileIDMlkitFace — TS wrapper", () => {
-  beforeEach(() => {
-    Object.values(native).forEach((m) => (m as Mock).mockReset());
-  });
-
-  it("looks up the native module under the contract-stable name", () => {
-    // The Kotlin Expo Module declares `Name("UseSmileIDMlkitFace")`.
-    // If the JS wrapper passes a different string, partner apps fail
-    // at runtime with "Cannot find native module 'X'".
-    expect(requireNativeModule).toHaveBeenCalledWith("UseSmileIDMlkitFace");
-  });
-
-  it("exposes the lifecycle surface — no per-frame analyze method", () => {
-    expect(typeof useSmileIDMlkitFace.configure).toBe("function");
-    expect(typeof useSmileIDMlkitFace.reset).toBe("function");
-    expect(typeof useSmileIDMlkitFace.close).toBe("function");
-    // Per-frame analysis lives in the native VisionCamera frame
-    // processor plugin — raw pixels never cross the JS bridge.
-    expect("analyze" in useSmileIDMlkitFace).toBe(false);
-  });
-
-  it("exposes the kind discriminator and frame processor plugin name", () => {
-    expect(useSmileIDMlkitFace.kind).toBe("face");
-    expect(useSmileIDMlkitFace.frameProcessorPluginName).toBe(
-      UseSmileIDMlkitFaceIdentifiers.frameProcessorPluginName,
-    );
-  });
-
-  describe("configure", () => {
-    it("passes the validated config through to native", async () => {
-      native.configure.mockResolvedValueOnce(undefined);
-      await useSmileIDMlkitFace.configure({ selfieCaptureTimeout: 60_000 });
-      expect(native.configure).toHaveBeenCalledTimes(1);
-      expect(native.configure).toHaveBeenCalledWith({
-        selfieCaptureTimeout: 60_000,
-      });
-    });
-
-    it("rejects malformed config at the JS boundary before crossing the bridge", async () => {
-      // Concrete scenario: a partner builds a config from float math
-      // and passes `selfieCaptureTimeout: 60_000.5`. Without the
-      // boundary parse, the value would marshal to a Kotlin `Int`
-      // with silent truncation. With it, the JS layer throws here
-      // and `native.configure` is never called.
-      await expect(
-        useSmileIDMlkitFace.configure({
-          // @ts-expect-error — deliberately wrong: int field with float value
-          selfieCaptureTimeout: 60_000.5,
-        }),
-      ).rejects.toThrow();
-      expect(native.configure).not.toHaveBeenCalled();
-    });
-  });
-
-  describe("reset", () => {
-    it("routes to native reset", async () => {
-      native.reset.mockResolvedValueOnce(undefined);
-      await useSmileIDMlkitFace.reset();
-      expect(native.reset).toHaveBeenCalledTimes(1);
-    });
-  });
-
-  describe("close", () => {
-    it("routes to native close", async () => {
-      native.close.mockResolvedValueOnce(undefined);
-      await useSmileIDMlkitFace.close();
-      expect(native.close).toHaveBeenCalledTimes(1);
-    });
-
-    it("is idempotent — partner can call it twice safely", async () => {
-      // Idempotency contract from FaceAnalyzer doc-comment. The native
-      // side handles the second close as a no-op; the wrapper just
-      // needs to not throw on re-entry.
-      native.close.mockResolvedValue(undefined);
-      await useSmileIDMlkitFace.close();
-      await useSmileIDMlkitFace.close();
-      expect(native.close).toHaveBeenCalledTimes(2);
-    });
-  });
-});

package/src/index.ts

@@ -1,46 +0,0 @@
-import { AnalyzerFactoryKey } from "@smileid/usesmileid_bridge";
-import type { FaceConfig, FaceScanResult } from "@smileid/usesmileid_bridge";
-import { useSmileIDAnalyzerExecutor } from "@smileid/usesmileid_platform_interface";
-
-/**
- * Google ML Kit face analyzer (Android-only).
- *
- * Thin shim around the existing native session
- * `com.usesmileid.bridge.session.UseSmileIDFaceSession(FaceDetectorAnalyzer())`
- * shipped in the `com.smileidentity:mlkit-face` AAR. The native side
- * runs the entire pipeline (analyzer + validator + transitioner +
- * state machine); this TS layer only routes calls and validates wire
- * payloads at the channel boundary.
- *
- * The canonical wiring lives in [useSmileIDAnalyzerExecutor] in
- * `usesmileid_platform_interface`. This file only supplies the
- * provider-specific identity so all six provider modules share one set
- * of correctness properties by construction.
- *
- * Lifecycle: `configure()` → per-frame analysis via the native frame
- * processor plugin → `reset()`? → `close()`. Calling
- * `close()` twice is idempotent. See `usesmileid_platform_interface`
- * `FaceAnalyzer` for the canonical contract.
- */
-/**
- * Must match the Kotlin Expo Module's `Name("UseSmileIDMlkitFace")` and its
- * VisionCamera frame-processor-plugin registration — drift is a runtime
- * "module/plugin not found" error, not a compile error.
- */
-export const UseSmileIDMlkitFaceIdentifiers = {
-  nativeModuleName: "UseSmileIDMlkitFace",
-  frameProcessorPluginName: "UseSmileIDMlkitFaceFrameProcessor",
-} as const;
-
-export const useSmileIDMlkitFace = useSmileIDAnalyzerExecutor({
-  nativeModuleName: UseSmileIDMlkitFaceIdentifiers.nativeModuleName,
-  frameProcessorPluginName:
-    UseSmileIDMlkitFaceIdentifiers.frameProcessorPluginName,
-  kind: "face",
-  key: AnalyzerFactoryKey.MLKitFace,
-});
-
-// Re-export the contract types so consumers don't need a separate
-// import line for `FaceConfig` / `FaceScanResult` when they're using
-// this provider.
-export type { FaceConfig, FaceScanResult };