@smileid/usesmileid 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

@@ -26,17 +26,13 @@ Sizes are measured on every push to `main` and updated automatically by CI.
 
 ## Requirements
 
-- React Native 0.83+ or Expo SDK 55+
-- Node 20.18+
+- React Native 0.83+ or Expo SDK 56+
+- Node 20.19+
 - React 19.2+
-- Xcode (latest stable) — iOS 15.0+ deployment target
-- Android Gradle Plugin 8.x — `compileSdk` 37, `minSdk` 26 (the
-  `com.usesmileid:*` 12.0.0 AARs are built with compileSdk 37 and
-  enforce it as the consumer minimum — set `android.compileSdkVersion=37` in
-  `gradle.properties` if your project pins a lower level. `minSdk` 26 is
-  required because VisionCamera's `Frame.toArrayBuffer()`, which the SDK's
-  frame streaming depends on, is compiled out below it — set
-  `android.minSdkVersion=26`)
+- Xcode (latest stable) — iOS 16.4 deployment target (set by Expo SDK 56's modules; the Smile ID iOS SDK itself supports iOS 15)
+- Android Gradle Plugin 8.11.1+ — `compileSdk` 36 or newer (React Native's default; nothing to set) and `minSdk` 24, matching the native Smile ID SDK and the kamera engine. The ML Kit config plugins set the Kotlin and KSP versions the AARs were compiled with. The 12.0.0–12.0.2 AARs required compileSdk 37 and `minSdk` 26 instead; on those releases, install platform 37 before Gradle runs (on EAS, an `eas-build-pre-install` script: `yes | sdkmanager --licenses >/dev/null; sdkmanager "platforms;android-37.0"`).
+
+`12.1.0` is built and verified against Expo SDK 57 and React Native 0.86. The floors above are the supported minimum and keep working.
 
 ## Installation
 
@@ -44,16 +40,45 @@ Add the SDK, its native peer dependencies, and the analyzer providers that match
 
 ```sh
 pnpm add @smileid/usesmileid \
-         react-native-quick-crypto react-native-quick-base64 react-native-nitro-modules \
          @smileid/usesmileid_mlkit_face @smileid/usesmileid_mlkit_document \
-         @smileid/usesmileid_vision_face @smileid/usesmileid_vision_document
+         @smileid/usesmileid_vision_face @smileid/usesmileid_vision_document \
+         react-native-quick-crypto react-native-quick-base64 react-native-nitro-modules \
+         react-native-safe-area-context react-native-svg lottie-react-native
+```
+
+Add the Expo modules with `expo install` so their versions match your app's Expo SDK:
+
+```sh
+npx expo install expo-brightness expo-file-system expo-font expo-haptics \
+                 expo-image-manipulator expo-image-picker expo-keep-awake expo-screen-orientation
 ```
 
 (Use `@smileid/usesmileid_huawei_{face,document}` instead of mlkit on no-GMS Android targets.)
 
-`react-native-quick-crypto`, `react-native-quick-base64`, and `react-native-nitro-modules` are **required peer dependencies** — the SDK uses them for native request signing (PBKDF2/HMAC). They must be installed in your app directly: React Native autolinking only links native modules declared in the app's own `package.json`, not a library's transitive ones, so the SDK cannot pull them in for you.
+Everything above except the `@smileid/*` packages is a **required peer dependency**, and must be installed in your app directly: React Native autolinking only links native modules declared in the app's own `package.json`, not a library's transitive ones. `expo`, `expo-modules-core`, `react` and `react-native` are omitted because they ship with your app.
+
+`react-native-quick-crypto`, `react-native-quick-base64` and the `react-native-nitro-modules` runtime it needs handle native request signing. The camera itself is supplied by the bundled kamera engine, so there is no camera package for you to install or pin.
+
+Babel needs nothing beyond `babel-preset-expo` — the SDK ships no Babel plugin. Upgrading from `12.0.2` or earlier, drop `react-native-worklets-core/plugin` from `babel.config.js` together with the `react-native-vision-camera` and `react-native-worklets-core` packages and the VisionCamera config plugin: kamera replaced the frame processors they backed.
 
-The provider packages each have native code (Android AAR / iOS SPM). Expo prebuild picks them up automatically via `expo-module.config.json`. For bare React Native, run `npx pod-install` after adding the packages and let Gradle resolve the AARs on the next Android build.
+`@react-native-async-storage/async-storage`, `expo-battery`, `expo-cellular`, `expo-device`, `expo-location`, `expo-network` and `expo-sensors` are optional: they only add device metadata.
+
+The provider packages each have native code (Android AAR / iOS SPM), and the ML Kit and Vision ones ship an Expo config plugin that applies the build settings that native code needs. Add the ones you installed to `expo.plugins` in `app.json`, then run `npx expo prebuild --clean`:
+
+```json
+{
+  "expo": {
+    "plugins": [
+      ["@smileid/usesmileid_mlkit_face", { "kspVersion": "2.3.6" }],
+      ["@smileid/usesmileid_mlkit_document", { "kspVersion": "2.3.6" }],
+      "@smileid/usesmileid_vision_face",
+      "@smileid/usesmileid_vision_document"
+    ]
+  }
+}
+```
+
+Autolinking finds the native modules through `expo-module.config.json` on its own, but it cannot change settings the root Gradle project and the Podfile own — without these plugins the build does not compile. The Android plugins pin the Kotlin the AARs were compiled with (2.3.20) and the `androidx.core` version that resolves under Expo's Android Gradle Plugin; Expo's own KSP lookup carries no entry for that Kotlin, so pass `kspVersion` as shown. The Huawei providers ship no config plugin — apply those root Gradle settings yourself on a no-GMS target. For bare React Native, run `npx pod-install` after adding the packages and let Gradle resolve the AARs on the next Android build.
 
 ---
 
@@ -129,14 +154,16 @@ b.config((c) => {
   c.enableDebugMode = false;
   c.allowOfflineMode = false;
   c.enableCrashReporting = true;
+  c.showAttribution = true;
 });
 ```
 
-| Property               | Type      | Default | Description                                                                                |
-| ---------------------- | --------- | ------- | ------------------------------------------------------------------------------------------ |
-| `enableDebugMode`      | `boolean` | `false` | Shows a validation error screen on build failure                                           |
-| `allowOfflineMode`     | `boolean` | `false` | Allows the flow to run without a network connection                                        |
-| `enableCrashReporting` | `boolean` | `true`  | Enables Sentry crash reporting for the SDK. Set to `false` if your app runs its own Sentry |
+| Property               | Type      | Default | Description                                                                                                                                                     |
+| ---------------------- | --------- | ------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `enableDebugMode`      | `boolean` | `false` | Shows a validation error screen on build failure                                                                                                                |
+| `allowOfflineMode`     | `boolean` | `false` | Allows the flow to run without a network connection                                                                                                             |
+| `enableCrashReporting` | `boolean` | `true`  | Enables Sentry crash reporting for the SDK. Set to `false` if your app runs its own Sentry                                                                      |
+| `showAttribution`      | `boolean` | `true`  | Shows the "Powered by Smile ID" mark on every screen that carries it. Set to `false` to hide it across the whole journey. Document capture never shows the mark |
 
 ---
 
@@ -345,13 +372,11 @@ b.screens((screens) => {
     c.partnerName = "Acme Corp";
     c.partnerIcon = <Image source={require("./assets/logo.png")} style={{ width: 36, height: 36 }} />;
     c.partnerPrivacyPolicyUrl = "https://acme.com/privacy";
-    c.showAttribution = true;
     c.onConsentGranted = (info) => console.log("Consent:", info);
   });
   screens.instructions((i) => {
     i.title = "Verify your identity";
     i.description = "You will need a selfie and a document.";
-    i.showAttribution = true;
   });
   screens.permission((p) => {
     p.cameraRationale = "Camera access required.";
@@ -385,17 +410,19 @@ b.screens((screens) => {
 
 #### Screen types
 
-| Screen           | How to add                                                                                 | Key properties                                                                                                                                                                         |
-| ---------------- | ------------------------------------------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
-| Consent          | `screens.consent((c) => ...)`                                                              | `partnerName`, `partnerIcon`, `partnerPrivacyPolicyUrl`, `showAttribution`, `onConsentGranted`, `allowButton`, `denyButton` (`partnerIcon` and `partnerPrivacyPolicyUrl` are required) |
-| Instructions     | `screens.instructions((i) => ...)`                                                         | `title`, `description`, `showAttribution`, `continueButton`                                                                                                                            |
-| Permission       | `screens.permission((p) => ...)`                                                           | `cameraRationale`, `continueButton`                                                                                                                                                    |
-| Selfie capture   | `screens.capture((cap) => { cap.captureType = CaptureType.selfie; cap.selfie(...); })`     | `allowAgentMode`, `enableEnhancedLiveness`                                                                                                                                             |
-| Document capture | `screens.capture((cap) => { cap.captureType = CaptureType.document; cap.document(...); })` | `autoCapture`, `allowGalleryUpload`, `captureBothSides`, `allowSkipBack`, `knownIdAspectRatio`                                                                                         |
-| Preview          | `screens.preview((p) => ...)`                                                              | `allowRetake`, `continueButton`, `cancelButton`                                                                                                                                        |
-| Processing       | `screens.processing((p) => ...)`                                                           | `showProgressPercentage`, `continueButton`, `retryButton`, `exitButton`                                                                                                                |
+| Screen           | How to add                                                                                 | Key properties                                                                                                                                                      |
+| ---------------- | ------------------------------------------------------------------------------------------ | ------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| Consent          | `screens.consent((c) => ...)`                                                              | `partnerName`, `partnerIcon`, `partnerPrivacyPolicyUrl`, `onConsentGranted`, `allowButton`, `denyButton` (`partnerIcon` and `partnerPrivacyPolicyUrl` are required) |
+| Instructions     | `screens.instructions((i) => ...)`                                                         | `title`, `description`, `continueButton`                                                                                                                            |
+| Permission       | `screens.permission((p) => ...)`                                                           | `cameraRationale`, `continueButton`                                                                                                                                 |
+| Selfie capture   | `screens.capture((cap) => { cap.captureType = CaptureType.selfie; cap.selfie(...); })`     | `allowAgentMode`, `enableEnhancedLiveness`                                                                                                                          |
+| Document capture | `screens.capture((cap) => { cap.captureType = CaptureType.document; cap.document(...); })` | `autoCapture`, `allowGalleryUpload`, `captureBothSides`, `allowSkipBack`, `knownIdAspectRatio`                                                                      |
+| Preview          | `screens.preview((p) => ...)`                                                              | `allowRetake`, `continueButton`, `cancelButton`                                                                                                                     |
+| Processing       | `screens.processing((p) => ...)`                                                           | `showProgressPercentage`, `continueButton`, `retryButton`, `exitButton`                                                                                             |
 
-Button slots receive `{ onPress: () => void; isEnabled: boolean }` and return any React node, so partners can ship fully custom buttons without losing the orchestrator's wiring.
+Attribution is a journey-wide setting: `config.showAttribution = false` hides the "Powered by Smile ID" mark on every screen that carries it, the selfie capture surface and the back-of-ID interstitial included. There is no per-screen switch. Document capture carries no mark by design. See [../docs/Theming.md](../docs/Theming.md).
+
+Button slots receive `{ onClick: () => void; enabled: boolean }` and return any React node, so partners can ship fully custom buttons without losing the orchestrator's wiring.
 
 #### Custom screens & button slots — `useFlowNavigation()`
 
@@ -417,12 +444,13 @@ function ExitButton() {
 
 The hook returns the active `FlowNavigationManager`:
 
-| Method          | Behaviour                                                                                                       |
-| --------------- | --------------------------------------------------------------------------------------------------------------- |
-| `next()`        | Advance to the next screen. From the last step, calls `onResult({ status: 'success', ... })`.                   |
-| `back()`        | Decrement. From the first step, calls `onResult({ status: 'failure', error: ... })` with `cancelled` semantics. |
-| `exit(reason?)` | Exit immediately — useful for "abort" buttons. Defaults to `cancelled`.                                         |
-| `captured`      | Snapshot of artifacts collected so far (`selfiePath`, `livenessPaths`, `frontDocumentPath`, etc).               |
+| Member              | Behaviour                                                                                                                   |
+| ------------------- | --------------------------------------------------------------------------------------------------------------------------- |
+| `navigateToNext()`  | Advance to the next screen. From the last step, calls `onResult({ status: 'success', ... })`.                               |
+| `navigateBack()`    | Pop the active screen. From the first step, calls `onResult({ status: 'failure', error: ... })` with `cancelled` semantics. |
+| `navigateToStart()` | Reset the path to the first screen — a flow restart after a terminal failure.                                               |
+| `exit(reason?)`     | Exit immediately — useful for "abort" buttons. Defaults to `cancelled`.                                                     |
+| `captured`          | Snapshot of artifacts collected so far (`selfiePath`, `livenessPaths`, `frontDocumentPath`, etc).                           |
 
 Calling `useFlowNavigation()` outside `<UseSmileIDBuilder>` throws — the misuse is loud at first render rather than silently no-op-ing.
 
@@ -569,9 +597,7 @@ import {
 
 <UseSmileIDBuilder
   builder={(b) => {
-    const consentInfo: ConsentInformation = {
-      /* … */
-    };
+    const consentInfo: ConsentInformation = {/* … */};
     b.consentInformation = consentInfo;
     b.screens((screens) => {
       // do not add a consent screen when consentInformation is set —

package/dist/camera/camera_configuration.d.ts

@@ -28,4 +28,3 @@ export type CameraSystemState = {
     readonly currentLens: CameraLens;
     readonly hasPermission: boolean;
 };
-//# sourceMappingURL=camera_configuration.d.ts.map

package/dist/camera/camera_configuration.js

@@ -1,2 +1 @@
-export {};
-//# sourceMappingURL=camera_configuration.js.map
+"use strict";export{};

package/dist/camera/camera_defaults.d.ts

@@ -11,11 +11,13 @@ export declare const CameraDefaults: {
         readonly width: 640;
         readonly height: 480;
     };
-    /** Document analysis resolution (16:9, matched to the visible preview so the guide-rect crop stays aligned). */
+    /** Document analysis resolution (16:9 at 720p for detector detail; the preview is a separate 4:3 stream). */
     readonly documentAnalysisResolution: {
         readonly width: 1280;
         readonly height: 720;
     };
+    /** How long a streaming capture waits for its first analyzed frame before reporting the camera unavailable. */
+    readonly firstFrameTimeoutMs: 10000;
     /** Longest-edge ceiling (px) for an imported document image; downscale-only. */
     readonly documentMaxDimension: 1600;
     /** JPEG quality (0–1) for imported document images. */
@@ -27,4 +29,3 @@ export declare const CameraDefaults: {
     /** Default selfie JPEG height (px); also the `image_height` metadata fallback. */
     readonly selfieJpegTargetHeight: 640;
 };
-//# sourceMappingURL=camera_defaults.d.ts.map

package/dist/camera/camera_defaults.js

@@ -1,24 +1 @@
-/** Static camera tuning defaults. */
-export const CameraDefaults = {
-    /** Focus running indicator visibility duration (ms). */
-    focusRunningDurationMs: 600,
-    /** Focus settled indicator visibility duration (ms). */
-    focusSettledDurationMs: 500,
-    /** Pinned analysis-stream frame rate; 30 fps keeps motion smooth at low ISO. */
-    analysisTargetFps: 30,
-    /** Selfie analysis resolution (4:3 — the face/smile heuristics are calibrated on it). */
-    analysisTargetResolution: { width: 640, height: 480 },
-    /** Document analysis resolution (16:9, matched to the visible preview so the guide-rect crop stays aligned). */
-    documentAnalysisResolution: { width: 1280, height: 720 },
-    /** Longest-edge ceiling (px) for an imported document image; downscale-only. */
-    documentMaxDimension: 1600,
-    /** JPEG quality (0–1) for imported document images. */
-    documentJpegQuality: 0.85,
-    /** Minimum shortest-edge (px) for a gallery document image; smaller is rejected. */
-    minGalleryDocumentDimensionPx: 600,
-    /** Default selfie JPEG width (px); also the `image_width` metadata fallback. */
-    selfieJpegTargetWidth: 480,
-    /** Default selfie JPEG height (px); also the `image_height` metadata fallback. */
-    selfieJpegTargetHeight: 640,
-};
-//# sourceMappingURL=camera_defaults.js.map
+"use strict";export const CameraDefaults={focusRunningDurationMs:600,focusSettledDurationMs:500,analysisTargetFps:30,analysisTargetResolution:{width:640,height:480},documentAnalysisResolution:{width:1280,height:720},firstFrameTimeoutMs:1e4,documentMaxDimension:1600,documentJpegQuality:.85,minGalleryDocumentDimensionPx:600,selfieJpegTargetWidth:480,selfieJpegTargetHeight:640};

package/dist/camera/camera_lens.d.ts

@@ -1,13 +1,9 @@
 /**
  * Camera lens selector — `front` or `back`.
- *
- * The lowercase string values are what `useCameraDevice` from
- * `react-native-vision-camera` accepts as its position argument, so
- * the value passes through without translation.
+ * The values match kamera's lens wire values, so they pass through the config factory untranslated.
  */
 export declare const CameraLens: {
     readonly front: "front";
     readonly back: "back";
 };
 export type CameraLens = (typeof CameraLens)[keyof typeof CameraLens];
-//# sourceMappingURL=camera_lens.d.ts.map

package/dist/camera/camera_lens.js

@@ -1,12 +1 @@
-/**
- * Camera lens selector — `front` or `back`.
- *
- * The lowercase string values are what `useCameraDevice` from
- * `react-native-vision-camera` accepts as its position argument, so
- * the value passes through without translation.
- */
-export const CameraLens = {
-    front: "front",
-    back: "back",
-};
-//# sourceMappingURL=camera_lens.js.map
+"use strict";export const CameraLens={front:"front",back:"back"};

package/dist/camera/camera_permissions.d.ts

@@ -1,10 +1,6 @@
 /**
- * Camera permission helpers.
- *
- * Wraps `react-native-vision-camera`'s permission API in a stable
- * shape the system class consumes. Does NOT auto-request — the caller
- * decides whether to prompt or fall through to a permission-denied
- * screen.
+ * Camera permission helpers. iOS auto-prompts when the kamera session adds its first capture input,
+ * so these report `granted` off-Android and a real denial surfaces via kamera's `permissionDenied` event.
  */
 export type CameraPermissionStatus = "granted" | "denied" | "undetermined";
 /** Snapshot the current camera permission status without prompting. */
@@ -15,4 +11,3 @@ export declare function getCameraPermissionStatus(): Promise<CameraPermissionSta
  * starting the camera.
  */
 export declare function requestCameraPermission(): Promise<CameraPermissionStatus>;
-//# sourceMappingURL=camera_permissions.d.ts.map

package/dist/camera/camera_permissions.js

@@ -1,23 +1 @@
-import { Camera } from "react-native-vision-camera";
-/** Snapshot the current camera permission status without prompting. */
-export async function getCameraPermissionStatus() {
-    const status = Camera.getCameraPermissionStatus();
-    return mapPermissionStatus(status);
-}
-/**
- * Request camera permission, prompting if necessary. Returns the
- * resulting status; the caller should branch on `'granted'` before
- * starting the camera.
- */
-export async function requestCameraPermission() {
-    const status = await Camera.requestCameraPermission();
-    return mapPermissionStatus(status);
-}
-function mapPermissionStatus(status) {
-    if (status === "granted")
-        return "granted";
-    if (status === "not-determined")
-        return "undetermined";
-    return "denied";
-}
-//# sourceMappingURL=camera_permissions.js.map
+"use strict";import{PermissionsAndroid as r,Platform as t}from"react-native";export async function getCameraPermissionStatus(){if(t.OS!=="android")return"granted";try{return await r.check(r.PERMISSIONS.CAMERA)?"granted":"undetermined"}catch{return"undetermined"}}export async function requestCameraPermission(){if(t.OS!=="android")return"granted";try{const e=await r.request(r.PERMISSIONS.CAMERA);return e===r.RESULTS.GRANTED?"granted":(e===r.RESULTS.NEVER_ASK_AGAIN,"denied")}catch{return"denied"}}

package/dist/camera/document_image_pipeline.d.ts

@@ -21,4 +21,3 @@ export type ImportedDocumentSource = {
  * image-type tag and JPEG bytes, not the containing directory.
  */
 export declare function resampleImportedDocument(source: ImportedDocumentSource, side: DocumentSide): Promise<string>;
-//# sourceMappingURL=document_image_pipeline.d.ts.map

package/dist/camera/document_image_pipeline.js

@@ -1,70 +1 @@
-import { Directory, File, Paths } from "expo-file-system";
-import { ImageManipulator, SaveFormat } from "expo-image-manipulator";
-import { DocumentSide, UseSmileIDCrashReporting, } from "@smileid/usesmileid_bridge";
-import { CameraDefaults } from "./camera_defaults";
-import { computeDocumentResizeTarget } from "./document_resize_target";
-export { computeDocumentResizeTarget } from "./document_resize_target";
-/**
- * Imported document image pipeline — brings a manual-shutter still or gallery
- * image onto the SAME byte policy as the native auto-capture artifact: longest
- * edge downscaled to {@link CameraDefaults.documentMaxDimension} at
- * {@link CameraDefaults.documentJpegQuality}, written under the canonical
- * per-side filename. The Smile EXIF `UserComment` tag is stamped downstream by
- * `SmileExifTagger.finalize`, so every upload is byte-policy-identical
- * regardless of capture path.
- */
-/** Subdirectory under the cache directory holding imported document artifacts. */
-const IMPORT_SUBDIRECTORY = "usesmileid_documents";
-/** Canonical per-side artifact basename, matching the auto-capture naming. */
-export function documentArtifactFileName(side) {
-    return side === DocumentSide.Back
-        ? "document_back.jpg"
-        : "document_front.jpg";
-}
-/**
- * Resample an imported document image and write it under the canonical per-side
- * filename. Returns the `file://` URI of the processed artifact.
- *
- * Canonical naming is best-effort: the native auto-capture session directory is
- * not exposed to JS, so the artifact lands in the app cache under the same
- * basename. On rename failure the resampled file's own URI is returned so the
- * byte-correct artifact is never lost — the backend validates the EXIF
- * image-type tag and JPEG bytes, not the containing directory.
- */
-export async function resampleImportedDocument(source, side) {
-    const target = source.width !== undefined && source.height !== undefined
-        ? computeDocumentResizeTarget(source.width, source.height, CameraDefaults.documentMaxDimension)
-        : null;
-    const context = ImageManipulator.manipulate(source.uri);
-    if (target) {
-        context.resize(target);
-    }
-    const rendered = await context.renderAsync();
-    const result = await rendered.saveAsync({
-        compress: CameraDefaults.documentJpegQuality,
-        format: SaveFormat.JPEG,
-    });
-    return persistAsCanonicalArtifact(result.uri, side);
-}
-/** Move the resampled file to `<cache>/usesmileid_documents/document_<side>.jpg` (synchronous `expo-file-system` API). */
-function persistAsCanonicalArtifact(resampledUri, side) {
-    try {
-        const directory = new Directory(Paths.cache, IMPORT_SUBDIRECTORY);
-        if (!directory.exists) {
-            directory.create({ intermediates: true });
-        }
-        const destination = new File(directory, documentArtifactFileName(side));
-        if (destination.exists) {
-            destination.delete();
-        }
-        new File(resampledUri).move(destination);
-        return destination.uri;
-    }
-    catch (error) {
-        // Best-effort rename: a file-system error must not drop the byte-correct
-        // artifact. Surface non-fatal and fall back to the resampled file's URI.
-        UseSmileIDCrashReporting.captureException(error instanceof Error ? error : new Error(String(error)));
-        return resampledUri;
-    }
-}
-//# sourceMappingURL=document_image_pipeline.js.map
+"use strict";import{Directory as c,File as i,Paths as m}from"expo-file-system";import{ImageManipulator as s,SaveFormat as u}from"expo-image-manipulator";import{DocumentSide as d,UseSmileIDCrashReporting as p}from"@smileid/usesmileid_bridge";import{CameraDefaults as o}from"./camera_defaults";import{computeDocumentResizeTarget as f}from"./document_resize_target";export{computeDocumentResizeTarget}from"./document_resize_target";const l="usesmileid_documents";export function documentArtifactFileName(e){return e===d.Back?"document_back.jpg":"document_front.jpg"}export async function resampleImportedDocument(e,n){const t=e.width!==void 0&&e.height!==void 0?f(e.width,e.height,o.documentMaxDimension):null,r=s.manipulate(e.uri);t&&r.resize(t);const a=await(await r.renderAsync()).saveAsync({compress:o.documentJpegQuality,format:u.JPEG});return g(a.uri,n)}function g(e,n){try{const t=new c(m.cache,l);t.exists||t.create({intermediates:!0});const r=new i(t,documentArtifactFileName(n));return r.exists&&r.delete(),new i(e).move(r),r.uri}catch(t){return p.captureException(t instanceof Error?t:new Error(String(t))),e}}

package/dist/camera/document_resize_target.d.ts

@@ -10,4 +10,3 @@ export declare function computeDocumentResizeTarget(width: number, height: numbe
 } | {
     readonly height: number;
 } | null;
-//# sourceMappingURL=document_resize_target.d.ts.map

package/dist/camera/document_resize_target.js

@@ -1,17 +1 @@
-/**
- * Resize target so the LONGEST edge equals `maxDimension`, preserving aspect
- * ratio (`expo-image-manipulator` derives the other edge from one). Returns
- * `null` when the image already fits — downscale-only, never upscale (upscaling
- * adds bytes and blur, diverging from the native auto-capture artifact).
- * Dependency-free so the math is unit-testable without the native image bridge.
- */
-export function computeDocumentResizeTarget(width, height, maxDimension) {
-    const longestEdge = Math.max(width, height);
-    if (!Number.isFinite(longestEdge) ||
-        longestEdge <= 0 ||
-        longestEdge <= maxDimension) {
-        return null;
-    }
-    return width >= height ? { width: maxDimension } : { height: maxDimension };
-}
-//# sourceMappingURL=document_resize_target.js.map
+"use strict";export function computeDocumentResizeTarget(r,u,t){const e=Math.max(r,u);return!Number.isFinite(e)||e<=0||e<=t?null:r>=u?{width:t}:{height:t}}

package/dist/camera/focus_state.d.ts

@@ -28,4 +28,3 @@ export declare const FocusStates: {
     readonly success: (point: FocusPoint) => FocusState;
     readonly failure: (point: FocusPoint) => FocusState;
 };
-//# sourceMappingURL=focus_state.d.ts.map

package/dist/camera/focus_state.js

@@ -1,13 +1 @@
-/**
- * Tap-to-focus state machine — `unspecified` / `running` / `success`
- * / `failure`. The `point` payload (where on the preview the partner
- * tapped) is `undefined` only for the `unspecified` state.
- */
-/** Convenience constructors for the `FocusState` discriminated union. */
-export const FocusStates = {
-    unspecified: () => ({ kind: "unspecified" }),
-    running: (point) => ({ kind: "running", point }),
-    success: (point) => ({ kind: "success", point }),
-    failure: (point) => ({ kind: "failure", point }),
-};
-//# sourceMappingURL=focus_state.js.map
+"use strict";export const FocusStates={unspecified:()=>({kind:"unspecified"}),running:n=>({kind:"running",point:n}),success:n=>({kind:"success",point:n}),failure:n=>({kind:"failure",point:n})};

package/dist/camera/kamera_config_factory.d.ts

@@ -0,0 +1,8 @@
+import type { KameraConfig, Lens } from "@smileid/kamera";
+import { CaptureType } from "../core/models/ml_config";
+import { CameraLens } from "./camera_lens";
+/** Maps the SDK's capture inputs onto a kamera `KameraConfig` via the tuned kamera presets. */
+export declare const KameraConfigFactory: {
+    readonly create: (captureType: CaptureType, lens: CameraLens) => KameraConfig;
+};
+export declare function toKameraLens(lens: CameraLens): Lens;

package/dist/camera/kamera_config_factory.js

@@ -0,0 +1 @@
+"use strict";import{KameraDefaults as t}from"@smileid/kamera";import{CaptureType as a}from"../core/models/ml_config";import{CameraLens as m}from"./camera_lens";export const KameraConfigFactory={create(e,o){const r=toKameraLens(o);return e===a.document?t.document(r):t.selfie(r)}};export function toKameraLens(e){return e===m.back?"back":"front"}

package/dist/camera/kamera_error_mapping.d.ts

@@ -0,0 +1,11 @@
+import { UseSmileIDCameraSurfaceException } from "../core/exception/use_smile_id_camera_surface_exception";
+/**
+ * Maps a kamera error code to a categorised {@link UseSmileIDCameraSurfaceException}.
+ * Unknown codes fall through to the generic camera code so a new engine error still surfaces.
+ */
+export declare function cameraExceptionFromKameraError(code: string, message?: string): UseSmileIDCameraSurfaceException;
+/**
+ * Whether a kamera error code ends the session. `sessionInterrupted` is the only recoverable code (the
+ * engine republishes `running` when the interruption ends); unknown codes are treated as terminal.
+ */
+export declare function isTerminalKameraError(code: string): boolean;

package/dist/camera/kamera_error_mapping.js

@@ -0,0 +1 @@
+"use strict";import{UseSmileIDCameraSurfaceException as o}from"../core/exception/use_smile_id_camera_surface_exception";import{UseSmileIDErrorCode as e}from"../core/exception/use_smile_id_error_code";export function cameraExceptionFromKameraError(r,t){const{errorCode:a,suggestedFix:s}=i[r]??{errorCode:e.Camera.Unknown,suggestedFix:"Retry the capture; if it persists, restart the camera flow."};return new o({errorCode:a,message:t??`Camera session error: ${r}`,suggestedFix:s,errorDetails:{kameraCode:r}})}export function isTerminalKameraError(r){return r!=="sessionInterrupted"}const i={permissionDenied:{errorCode:e.Camera.PermissionDenied,suggestedFix:"Grant camera access in Settings, then start the capture again."},cameraInUse:{errorCode:e.Camera.InitializationFailed,suggestedFix:"Close other apps using the camera, then retry."},configurationUnsupported:{errorCode:e.Camera.UseCaseNotSupported,suggestedFix:"This device does not support the requested capture mode."},captureFailed:{errorCode:e.Camera.CaptureFailed,suggestedFix:"Retry the capture."},sessionInterrupted:{errorCode:e.Camera.Unknown,suggestedFix:"The camera was interrupted; start the capture again."}};

package/dist/camera/use_kamera_camera_permission.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Camera-permission gate for kamera. Android needs an explicit runtime request; iOS auto-prompts on the
+ * session's first capture input, so the hook reports granted and a denial surfaces via `permissionDenied`.
+ */
+export declare function useKameraCameraPermission(): {
+    readonly hasPermission: boolean;
+    readonly requestPermission: () => Promise<boolean>;
+};

package/dist/camera/use_kamera_camera_permission.js

@@ -0,0 +1 @@
+"use strict";import{useCallback as o,useEffect as u,useState as m}from"react";import{PermissionsAndroid as r,Platform as s}from"react-native";export function useKameraCameraPermission(){const[a,n]=m(s.OS!=="android");u(()=>{if(s.OS!=="android")return;let t=!0;return r.check(r.PERMISSIONS.CAMERA).then(e=>{t&&e&&n(!0)}),()=>{t=!1}},[]);const i=o(async()=>{if(s.OS!=="android")return!0;try{const e=await r.request(r.PERMISSIONS.CAMERA)===r.RESULTS.GRANTED;return n(e),e}catch{return!1}},[]);return{hasPermission:a,requestPermission:i}}

package/dist/camera/use_kamera_orientation.d.ts

@@ -0,0 +1,9 @@
+export declare function useDeviceTiltDegrees(options?: {
+    /** Keep the last decisive tilt while the phone is near-flat (a document held over a table). */
+    readonly retainWhenFlat?: boolean;
+}): number;
+/**
+ * Locked interface orientation (0 / 90 / 270) from the screen-orientation API, not gravity: the axis the
+ * preview and guide overlay are drawn against, and the axis iOS uprights the saved document to.
+ */
+export declare function useLockedInterfaceOrientationDegrees(): number;

package/dist/camera/use_kamera_orientation.js

@@ -0,0 +1 @@
+"use strict";import{useEffect as D,useState as h}from"react";import{Platform as S}from"react-native";import*as t from"expo-screen-orientation";import{loadExpoSensors as I}from"../metadata/optional_native_modules";const T=2;export function useDeviceTiltDegrees(c){const n=c?.retainWhenFlat??!1,r=useLockedInterfaceOrientationDegrees(),[o,s]=h(null);return D(()=>{const e=I();if(!e)return;e.Accelerometer.setUpdateInterval(200);let u=null,i=0;const p=e.Accelerometer.addListener(({x:A,y:L})=>{const l=S.OS==="android"?-1:1,f=A*l,g=L*l,d=Math.abs(f),m=Math.abs(g);if(d<.5&&m<.5){u=null,i=0,n||s(null);return}const a=d>m?f>0?270:90:g>0?180:0;i=a===u?i+1:1,u=a,!(i<T)&&s(O=>O===a?O:a)});return()=>p.remove()},[n]),o??r}export function useLockedInterfaceOrientationDegrees(){const[c,n]=h(0);return D(()=>{let r=!0;const o=e=>{switch(e){case t.Orientation.LANDSCAPE_LEFT:return 90;case t.Orientation.LANDSCAPE_RIGHT:return 270;case t.Orientation.PORTRAIT_DOWN:return 180;default:return 0}};t.getOrientationAsync().then(e=>{r&&n(o(e))}).catch(()=>{});const s=t.addOrientationChangeListener(e=>{n(o(e.orientationInfo.orientation))});return()=>{r=!1,t.removeOrientationChangeListener(s)}},[]),c}

package/dist/camera/use_smile_id_frame_stream.d.ts

@@ -67,4 +67,3 @@ export declare function dispatchFrameResult(args: {
     readonly onResult: (result: FaceScanResult | DocumentScanResult) => void;
     readonly onError?: (error: unknown) => void;
 }): void;
-//# sourceMappingURL=use_smile_id_frame_stream.d.ts.map

package/dist/camera/use_smile_id_frame_stream.js

@@ -1,93 +1 @@
-import { useCallback, useEffect, useMemo, useRef } from "react";
-import { documentScanResultSchema, faceScanResultSchema, FrameProcessingException, } from "@smileid/usesmileid_bridge";
-export function useSmileIDFrameStream(analyzer, onResult, options) {
-    const analyzerRef = useRef(analyzer);
-    const onResultRef = useRef(onResult);
-    const onErrorRef = useRef(options?.onError);
-    const busyRef = useRef(false);
-    const mountedRef = useRef(true);
-    useEffect(() => {
-        analyzerRef.current = analyzer;
-    }, [analyzer]);
-    useEffect(() => {
-        onResultRef.current = onResult;
-    }, [onResult]);
-    useEffect(() => {
-        onErrorRef.current = options?.onError;
-    }, [options?.onError]);
-    useEffect(() => {
-        mountedRef.current = true;
-        return () => {
-            mountedRef.current = false;
-        };
-    }, []);
-    const onFrameResult = useCallback((rawResult) => {
-        const onError = onErrorRef.current;
-        dispatchFrameResult({
-            raw: rawResult,
-            analyzer: analyzerRef.current,
-            isBusy: () => busyRef.current,
-            setBusy: (value) => {
-                busyRef.current = value;
-            },
-            isMounted: () => mountedRef.current,
-            // Boundary cast: the overload pairing guarantees the analyzer
-            // shape matches the callback shape (face↔face / document↔document);
-            // the implementation signature widens both.
-            onResult: onResultRef.current,
-            ...(onError !== undefined ? { onError } : {}),
-        });
-    }, []);
-    // Stable handle — an identity change here rebuilds the camera's
-    // frame processor, so memoise.
-    return useMemo(() => ({ onFrameResult }), [onFrameResult]);
-}
-/**
- * Extract the error marker, if present — native plugins signal
- * frame-level failures by returning `{ error: "<reason>" }` instead of
- * a scan-result map.
- */
-function readPluginError(raw) {
-    if (raw === null || typeof raw !== "object")
-        return null;
-    // Boundary cast: `raw` crossed the worklet bridge as `unknown`; the
-    // key's type is verified before use.
-    const reason = raw["error"];
-    return typeof reason === "string" ? reason : null;
-}
-/**
- * Pure dispatch logic extracted from the hook so vitest can exercise
- * the busy-gate, mounted-gate, error-marker, and schema-validation
- * branches without standing up a React renderer.
- *
- * @internal
- */
-export function dispatchFrameResult(args) {
-    const { raw, analyzer, isBusy, setBusy, isMounted, onResult, onError } = args;
-    if (!analyzer)
-        return;
-    if (isBusy())
-        return;
-    setBusy(true);
-    try {
-        const errorReason = readPluginError(raw);
-        if (errorReason !== null) {
-            throw new FrameProcessingException({ reason: errorReason });
-        }
-        const result = analyzer.kind === "face"
-            ? faceScanResultSchema.parse(raw)
-            : documentScanResultSchema.parse(raw);
-        if (!isMounted())
-            return;
-        onResult(result);
-    }
-    catch (error) {
-        if (!isMounted())
-            return;
-        onError?.(error);
-    }
-    finally {
-        setBusy(false);
-    }
-}
-//# sourceMappingURL=use_smile_id_frame_stream.js.map
+"use strict";import{useCallback as E,useEffect as i,useMemo as d,useRef as c}from"react";import{documentScanResultSchema as y,faceScanResultSchema as S,FrameProcessingException as p}from"@smileid/usesmileid_bridge";export function useSmileIDFrameStream(e,r,t){const f=c(e),o=c(r),u=c(t?.onError),a=c(!1),s=c(!0);i(()=>{f.current=e},[e]),i(()=>{o.current=r},[r]),i(()=>{u.current=t?.onError},[t?.onError]),i(()=>(s.current=!0,()=>{s.current=!1}),[]);const n=E(l=>{const m=u.current;dispatchFrameResult({raw:l,analyzer:f.current,isBusy:()=>a.current,setBusy:R=>{a.current=R},isMounted:()=>s.current,onResult:o.current,...m!==void 0?{onError:m}:{}})},[]);return d(()=>({onFrameResult:n}),[n])}function h(e){if(e===null||typeof e!="object")return null;const r=e.error;return typeof r=="string"?r:null}const _=new Set(["no_frame","session_not_configured"]);export function dispatchFrameResult(e){const{raw:r,analyzer:t,isBusy:f,setBusy:o,isMounted:u,onResult:a,onError:s}=e;if(t&&!f()){o(!0);try{const n=h(r);if(n!==null){if(_.has(n))return;throw new p({reason:n})}const l=t.kind==="face"?S.parse(r):y.parse(r);if(!u())return;a(l)}catch(n){if(!u())return;s?.(n)}finally{o(!1)}}}