@smileid/usesmileid 12.0.0-beta01

package/CHANGELOG.md

@@ -0,0 +1,10 @@
+## 12.0.0-beta01
+
+First public beta of the Smile ID React Native (Expo) SDK v12.
+
+- Federated provider architecture: ML detection runs natively (Android ML Kit /
+  Huawei HMS, Apple Vision) behind a VisionCamera frame-processor, surfaced
+  through Expo Modules — pixels never cross into JS.
+- Type-safe Builder DSL for SmartSelfie, Enhanced SmartSelfie, and Document
+  Verification flows.
+- RTL-ready, partner-localisable string table (src/l10n/strings_en.ts).

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Smile ID
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,130 @@
+# `@smileid/usesmileid`
+
+UseSmileID v12 — public-facing React Native (Expo) SDK. ML processing
+lives in the federated provider packages
+(`@smileid/usesmileid_{mlkit,vision,huawei}_{face,document}`); this package
+owns configuration, state observation, and UI.
+
+## Architecture
+
+The SDK is one of nine workspace packages — see
+[`docs/Architecture.md`](../../docs/Architecture.md) for the full
+picture. This package contributes:
+
+- **DSL builder** (`useSmileIDBuilder`) — declarative flow
+  configuration.
+- **Theme tokens** (`UseSmileIDTheme`, `defaultLightTheme`,
+  `defaultDarkTheme`) — colours, typography, spacing, shapes.
+- **Flow types** (`FlowConfiguration`, `JobType`, `FlowStep`,
+  `UseSmileIDResult`) — discriminated unions partner code can exhaust.
+- **Screen surface** (`UseSmileID*Screen`) — public components, one
+  per `FlowStep`. **Currently stubs** — visual implementation rolling
+  out per `docs/Architecture.md § Rollout`.
+
+No ML logic lives in this package. Partners pick the analyzer
+implementation that matches their target platform / device fleet from
+the federated providers and inject it via `analyzers`.
+
+## Installation
+
+```sh
+pnpm add @smileid/usesmileid \
+         @smileid/usesmileid_mlkit_face @smileid/usesmileid_mlkit_document \
+         @smileid/usesmileid_vision_face @smileid/usesmileid_vision_document
+```
+
+(Add `@smileid/usesmileid_huawei_{face,document}` instead of mlkit on
+no-GMS Android targets.)
+
+## Usage
+
+```tsx
+import { Platform } from "react-native";
+import { JobType, UseSmileIDFlow, useSmileIDBuilder } from "@smileid/usesmileid";
+import { useSmileIDMlkitFace } from "@smileid/usesmileid_mlkit_face";
+import { useSmileIDVisionFace } from "@smileid/usesmileid_vision_face";
+
+const config = useSmileIDBuilder((b) => {
+  b.userId("user-123");
+  b.jobId(`job-${Date.now()}`);
+  b.jobType(JobType.smartSelfieEnrollment);
+  b.analyzers({
+    face: Platform.OS === "ios" ? useSmileIDVisionFace : useSmileIDMlkitFace,
+  });
+  b.screens({
+    instructions: { showAttribution: true },
+    capture: { captureType: "selfie" },
+    preview: { allowRetake: true },
+  });
+  b.onResult = (result) => {
+    // `UseSmileIDResult<T>` is a discriminated union; switch on
+    // `status` to narrow each branch — analogous to Kotlin's
+    // exhaustive `when` on a sealed class.
+    switch (result.status) {
+      case "success":
+        // `result.value: JobSubmissionResponse` carries `jobId`,
+        // `userId`, `status`, `message`, and optional `createdAt`.
+        console.log("jobId:", result.value.jobId);
+        console.log("status:", result.value.status);
+        console.log("message:", result.value.message);
+        break;
+      case "failure":
+        console.error("flow failed:", result.error);
+        break;
+    }
+  };
+});
+
+export default () => <UseSmileIDFlow configuration={config} />;
+```
+
+## Handling results
+
+Assign `b.onResult` inside the builder callback. It is called once when the flow finishes.
+
+```ts
+<UseSmileIDBuilder builder={(smile) => {
+  smile.onResult = (result) => {
+    if (result.status === "success") {
+      console.log(`Job ${result.value.jobId} status=${result.value.status}`);
+    } else {
+      console.log(`Failed: ${result.error}`);
+    }
+  };
+  // ... configure flow
+}} />
+```
+
+### Payload
+
+`UseSmileIDResult<JobSubmissionResponse>` is a discriminated union; switch on `status` to narrow each branch. The success branch carries the server's submission acknowledgement:
+
+| Field       | Type                | Description                                             |
+| ----------- | ------------------- | ------------------------------------------------------- |
+| `jobId`     | `string`            | Server-issued job identifier                            |
+| `userId`    | `string`            | Server-issued user identifier                           |
+| `status`    | `string`            | Submission status (e.g. `"submitted"`)                  |
+| `message`   | `string`            | Human-readable status message                           |
+| `createdAt` | `string` (optional) | ISO 8601 timestamp at which the server accepted the job |
+
+The result does not echo back partner-supplied inputs (captured frames, identity fields, consent). Keep references at the call site if you need them after the flow.
+
+## Status
+
+| Area                              | Status                                     |
+| --------------------------------- | ------------------------------------------ |
+| Public DSL surface                | implemented                                |
+| Theme tokens                      | implemented                                |
+| Flow types & discriminated unions | implemented                                |
+| Screen visuals                    | stub (returns placeholder views)           |
+| Orchestrator state machine        | stub (renders job summary, no transitions) |
+| Network / job submission          | not yet wired                              |
+
+See [`docs/Architecture.md § Rollout`](../../docs/Architecture.md) for
+the next milestones.
+
+## Testing
+
+```sh
+pnpm --filter @smileid/usesmileid test
+```

package/dist/camera/camera_configuration.d.ts

@@ -0,0 +1,31 @@
+import type { CameraLens } from "./camera_lens";
+import type { CaptureType } from "../core/models/ml_config";
+/**
+ * Camera-system configuration applied when the orchestrator starts.
+ * All fields optional — see `CameraDefaults` for the values applied
+ * when omitted.
+ */
+export type CameraConfiguration = {
+    /** Front (default for selfie) or back. */
+    readonly lens?: CameraLens;
+    /** Hint to enable low-light boost on supported devices. */
+    readonly enableLowLightBoost?: boolean;
+    /** What we're capturing — drives default lens + still-capture mode. */
+    readonly captureType?: CaptureType;
+    /**
+     * Override the pinned frame rate. Partners normally accept the
+     * `CameraDefaults.analysisTargetFps` default (30 fps).
+     */
+    readonly fps?: number;
+};
+/**
+ * Public-facing snapshot of the camera system's runtime state.
+ * `subscribe()` on `UseSmileIDCameraSystem` notifies on every change.
+ */
+export type CameraSystemState = {
+    readonly isCameraRunning: boolean;
+    readonly isStreaming: boolean;
+    readonly currentLens: CameraLens;
+    readonly hasPermission: boolean;
+};
+//# sourceMappingURL=camera_configuration.d.ts.map

package/dist/camera/camera_configuration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_configuration.d.ts","sourceRoot":"","sources":["../../src/camera/camera_configuration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAE5D;;;;GAIG;AACH,MAAM,MAAM,mBAAmB,GAAG;IAChC,0CAA0C;IAC1C,QAAQ,CAAC,IAAI,CAAC,EAAE,UAAU,CAAC;IAC3B,2DAA2D;IAC3D,QAAQ,CAAC,mBAAmB,CAAC,EAAE,OAAO,CAAC;IACvC,uEAAuE;IACvE,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;CACjC,CAAC"}

package/dist/camera/camera_configuration.js

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

package/dist/camera/camera_configuration.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_configuration.js","sourceRoot":"","sources":["../../src/camera/camera_configuration.ts"],"names":[],"mappings":""}

package/dist/camera/camera_defaults.d.ts

@@ -0,0 +1,25 @@
+/** Static camera tuning defaults. */
+export declare const CameraDefaults: {
+    /** Focus running indicator visibility duration in ms. */
+    readonly focusRunningDurationMs: 600;
+    /** Focus settled indicator visibility duration in ms. */
+    readonly focusSettledDurationMs: 500;
+    /** Pinned analysis-stream frame rate. 30 fps keeps head motion smooth and per-frame exposure low-ISO. */
+    readonly analysisTargetFps: 30;
+    /** Analysis-stream resolution (landscape). Matches the scan sessions' tuned input; higher stutters the frame-processor thread without improving detection. */
+    readonly analysisTargetResolution: {
+        readonly width: 640;
+        readonly height: 480;
+    };
+    /** Longest-edge ceiling (px) for an imported document image; downscale-only, never upscale. Matches the native auto-capture resample target so every upload shares one byte policy. */
+    readonly documentMaxDimension: 1600;
+    /** JPEG compression quality (0.0–1.0, `expo-image-manipulator`'s `compress`) for imported document images; matches the auto-capture artifact quality. */
+    readonly documentJpegQuality: 0.85;
+    /** Minimum shortest-edge (px) for a gallery document image; smaller is rejected pre-resample since upscaling yields unreadable artifacts. */
+    readonly minGalleryDocumentDimensionPx: 600;
+    /** Default selfie JPEG width (px) when no `sdk_config` override is present; also the `image_width` metadata fallback. */
+    readonly selfieJpegTargetWidth: 480;
+    /** Default selfie JPEG height (px) when no `sdk_config` override is present; also the `image_height` metadata fallback. */
+    readonly selfieJpegTargetHeight: 640;
+};
+//# sourceMappingURL=camera_defaults.d.ts.map

package/dist/camera/camera_defaults.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_defaults.d.ts","sourceRoot":"","sources":["../../src/camera/camera_defaults.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,eAAO,MAAM,cAAc;IACzB,yDAAyD;;IAEzD,yDAAyD;;IAGzD,yGAAyG;;IAEzG,8JAA8J;;;;;IAG9J,uLAAuL;;IAEvL,yJAAyJ;;IAEzJ,6IAA6I;;IAE7I,yHAAyH;;IAEzH,2HAA2H;;CAEnH,CAAC"}

package/dist/camera/camera_defaults.js

@@ -0,0 +1,22 @@
+/** Static camera tuning defaults. */
+export const CameraDefaults = {
+    /** Focus running indicator visibility duration in ms. */
+    focusRunningDurationMs: 600,
+    /** Focus settled indicator visibility duration in ms. */
+    focusSettledDurationMs: 500,
+    /** Pinned analysis-stream frame rate. 30 fps keeps head motion smooth and per-frame exposure low-ISO. */
+    analysisTargetFps: 30,
+    /** Analysis-stream resolution (landscape). Matches the scan sessions' tuned input; higher stutters the frame-processor thread without improving detection. */
+    analysisTargetResolution: { width: 640, height: 480 },
+    /** Longest-edge ceiling (px) for an imported document image; downscale-only, never upscale. Matches the native auto-capture resample target so every upload shares one byte policy. */
+    documentMaxDimension: 1600,
+    /** JPEG compression quality (0.0–1.0, `expo-image-manipulator`'s `compress`) for imported document images; matches the auto-capture artifact quality. */
+    documentJpegQuality: 0.85,
+    /** Minimum shortest-edge (px) for a gallery document image; smaller is rejected pre-resample since upscaling yields unreadable artifacts. */
+    minGalleryDocumentDimensionPx: 600,
+    /** Default selfie JPEG width (px) when no `sdk_config` override is present; also the `image_width` metadata fallback. */
+    selfieJpegTargetWidth: 480,
+    /** Default selfie JPEG height (px) when no `sdk_config` override is present; also the `image_height` metadata fallback. */
+    selfieJpegTargetHeight: 640,
+};
+//# sourceMappingURL=camera_defaults.js.map

package/dist/camera/camera_defaults.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_defaults.js","sourceRoot":"","sources":["../../src/camera/camera_defaults.ts"],"names":[],"mappings":"AAAA,qCAAqC;AACrC,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,yDAAyD;IACzD,sBAAsB,EAAE,GAAG;IAC3B,yDAAyD;IACzD,sBAAsB,EAAE,GAAG;IAE3B,yGAAyG;IACzG,iBAAiB,EAAE,EAAE;IACrB,8JAA8J;IAC9J,wBAAwB,EAAE,EAAE,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAW;IAE9D,uLAAuL;IACvL,oBAAoB,EAAE,IAAI;IAC1B,yJAAyJ;IACzJ,mBAAmB,EAAE,IAAI;IACzB,6IAA6I;IAC7I,6BAA6B,EAAE,GAAG;IAClC,yHAAyH;IACzH,qBAAqB,EAAE,GAAG;IAC1B,2HAA2H;IAC3H,sBAAsB,EAAE,GAAG;CACnB,CAAC"}

package/dist/camera/camera_lens.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 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.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_lens.d.ts","sourceRoot":"","sources":["../../src/camera/camera_lens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,eAAO,MAAM,UAAU;;;CAGb,CAAC;AAEX,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,UAAU,CAAC,CAAC,MAAM,OAAO,UAAU,CAAC,CAAC"}

package/dist/camera/camera_lens.js

@@ -0,0 +1,12 @@
+/**
+ * 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

package/dist/camera/camera_lens.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_lens.js","sourceRoot":"","sources":["../../src/camera/camera_lens.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACJ,CAAC"}

package/dist/camera/camera_permissions.d.ts

@@ -0,0 +1,18 @@
+/**
+ * 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.
+ */
+export type CameraPermissionStatus = "granted" | "denied" | "undetermined";
+/** Snapshot the current camera permission status without prompting. */
+export declare function getCameraPermissionStatus(): Promise<CameraPermissionStatus>;
+/**
+ * Request camera permission, prompting if necessary. Returns the
+ * resulting status; the caller should branch on `'granted'` before
+ * starting the camera.
+ */
+export declare function requestCameraPermission(): Promise<CameraPermissionStatus>;
+//# sourceMappingURL=camera_permissions.d.ts.map

package/dist/camera/camera_permissions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_permissions.d.ts","sourceRoot":"","sources":["../../src/camera/camera_permissions.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AAEH,MAAM,MAAM,sBAAsB,GAAG,SAAS,GAAG,QAAQ,GAAG,cAAc,CAAC;AAE3E,uEAAuE;AACvE,wBAAsB,yBAAyB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAGjF;AAED;;;;GAIG;AACH,wBAAsB,uBAAuB,IAAI,OAAO,CAAC,sBAAsB,CAAC,CAG/E"}

package/dist/camera/camera_permissions.js

@@ -0,0 +1,23 @@
+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

package/dist/camera/camera_permissions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_permissions.js","sourceRoot":"","sources":["../../src/camera/camera_permissions.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,4BAA4B,CAAC;AAapD,uEAAuE;AACvE,MAAM,CAAC,KAAK,UAAU,yBAAyB;IAC7C,MAAM,MAAM,GAAG,MAAM,CAAC,yBAAyB,EAAE,CAAC;IAClD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,KAAK,UAAU,uBAAuB;IAC3C,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,uBAAuB,EAAE,CAAC;IACtD,OAAO,mBAAmB,CAAC,MAAM,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,mBAAmB,CAC1B,MAA8D;IAE9D,IAAI,MAAM,KAAK,SAAS;QAAE,OAAO,SAAS,CAAC;IAC3C,IAAI,MAAM,KAAK,gBAAgB;QAAE,OAAO,cAAc,CAAC;IACvD,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/camera/camera_preview_image.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Frame envelope. The frame-processor pipeline streams raw RGBA
+ * pixel buffers (`ArrayBuffer`) per frame; partners who want to
+ * thread additional metadata alongside the bytes can use this type
+ * to keep their call sites symmetric.
+ */
+export type ViewBounds = {
+    readonly width: number;
+    readonly height: number;
+};
+export type CameraPreviewImage<T> = {
+    readonly image: T;
+    /** Preview surface size at the moment the frame was sampled. */
+    readonly viewBounds?: ViewBounds;
+    /** Device orientation in degrees (0/90/180/270) at sample time. */
+    readonly rotationDegrees: number;
+};
+//# sourceMappingURL=camera_preview_image.d.ts.map

package/dist/camera/camera_preview_image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_preview_image.d.ts","sourceRoot":"","sources":["../../src/camera/camera_preview_image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,kBAAkB,CAAC,CAAC,IAAI;IAClC,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAC;IAClB,gEAAgE;IAChE,QAAQ,CAAC,UAAU,CAAC,EAAE,UAAU,CAAC;IACjC,mEAAmE;IACnE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;CAClC,CAAC"}

package/dist/camera/camera_preview_image.js

@@ -0,0 +1,8 @@
+/**
+ * Frame envelope. The frame-processor pipeline streams raw RGBA
+ * pixel buffers (`ArrayBuffer`) per frame; partners who want to
+ * thread additional metadata alongside the bytes can use this type
+ * to keep their call sites symmetric.
+ */
+export {};
+//# sourceMappingURL=camera_preview_image.js.map

package/dist/camera/camera_preview_image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"camera_preview_image.js","sourceRoot":"","sources":["../../src/camera/camera_preview_image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG"}

package/dist/camera/document_image_pipeline.d.ts

@@ -0,0 +1,24 @@
+import { DocumentSide } from "@smileid/usesmileid_bridge";
+export { computeDocumentResizeTarget } from "./document_resize_target";
+/** Canonical per-side artifact basename, matching the auto-capture naming. */
+export declare function documentArtifactFileName(side: DocumentSide): string;
+/** Source image for an imported document capture (manual shutter or gallery). */
+export type ImportedDocumentSource = {
+    /** `file://` URI (or bare path) of the still / picked image. */
+    readonly uri: string;
+    /** Pixel dimensions when known. Omitted ⇒ re-encode at document quality without a resize (never upscaled). */
+    readonly width?: number;
+    readonly height?: number;
+};
+/**
+ * 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 declare function resampleImportedDocument(source: ImportedDocumentSource, side: DocumentSide): Promise<string>;
+//# sourceMappingURL=document_image_pipeline.d.ts.map

package/dist/camera/document_image_pipeline.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_image_pipeline.d.ts","sourceRoot":"","sources":["../../src/camera/document_image_pipeline.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EAEb,MAAM,4BAA4B,CAAC;AAIpC,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAevE,8EAA8E;AAC9E,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAInE;AAED,iFAAiF;AACjF,MAAM,MAAM,sBAAsB,GAAG;IACnC,gEAAgE;IAChE,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,8GAA8G;IAC9G,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF;;;;;;;;;GASG;AACH,wBAAsB,wBAAwB,CAC5C,MAAM,EAAE,sBAAsB,EAC9B,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,MAAM,CAAC,CAqBjB"}

package/dist/camera/document_image_pipeline.js

@@ -0,0 +1,70 @@
+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

package/dist/camera/document_image_pipeline.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_image_pipeline.js","sourceRoot":"","sources":["../../src/camera/document_image_pipeline.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC1D,OAAO,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACtE,OAAO,EACL,YAAY,EACZ,wBAAwB,GACzB,MAAM,4BAA4B,CAAC;AACpC,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE,OAAO,EAAE,2BAA2B,EAAE,MAAM,0BAA0B,CAAC;AAEvE;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,MAAM,mBAAmB,GAAG,sBAAsB,CAAC;AAEnD,8EAA8E;AAC9E,MAAM,UAAU,wBAAwB,CAAC,IAAkB;IACzD,OAAO,IAAI,KAAK,YAAY,CAAC,IAAI;QAC/B,CAAC,CAAC,mBAAmB;QACrB,CAAC,CAAC,oBAAoB,CAAC;AAC3B,CAAC;AAWD;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,MAA8B,EAC9B,IAAkB;IAElB,MAAM,MAAM,GACV,MAAM,CAAC,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,MAAM,KAAK,SAAS;QACvD,CAAC,CAAC,2BAA2B,CACzB,MAAM,CAAC,KAAK,EACZ,MAAM,CAAC,MAAM,EACb,cAAc,CAAC,oBAAoB,CACpC;QACH,CAAC,CAAC,IAAI,CAAC;IAEX,MAAM,OAAO,GAAG,gBAAgB,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACxD,IAAI,MAAM,EAAE,CAAC;QACX,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IACzB,CAAC;IACD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,WAAW,EAAE,CAAC;IAC7C,MAAM,MAAM,GAAG,MAAM,QAAQ,CAAC,SAAS,CAAC;QACtC,QAAQ,EAAE,cAAc,CAAC,mBAAmB;QAC5C,MAAM,EAAE,UAAU,CAAC,IAAI;KACxB,CAAC,CAAC;IAEH,OAAO,0BAA0B,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;AACtD,CAAC;AAED,0HAA0H;AAC1H,SAAS,0BAA0B,CACjC,YAAoB,EACpB,IAAkB;IAElB,IAAI,CAAC;QACH,MAAM,SAAS,GAAG,IAAI,SAAS,CAAC,KAAK,CAAC,KAAK,EAAE,mBAAmB,CAAC,CAAC;QAClE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,CAAC;YACtB,SAAS,CAAC,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,IAAI,CAAC,SAAS,EAAE,wBAAwB,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,IAAI,WAAW,CAAC,MAAM,EAAE,CAAC;YACvB,WAAW,CAAC,MAAM,EAAE,CAAC;QACvB,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QACzC,OAAO,WAAW,CAAC,GAAG,CAAC;IACzB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,yEAAyE;QACzE,yEAAyE;QACzE,wBAAwB,CAAC,gBAAgB,CACvC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAC1D,CAAC;QACF,OAAO,YAAY,CAAC;IACtB,CAAC;AACH,CAAC"}

package/dist/camera/document_resize_target.d.ts

@@ -0,0 +1,13 @@
+/**
+ * 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 declare function computeDocumentResizeTarget(width: number, height: number, maxDimension: number): {
+    readonly width: number;
+} | {
+    readonly height: number;
+} | null;
+//# sourceMappingURL=document_resize_target.d.ts.map

package/dist/camera/document_resize_target.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_resize_target.d.ts","sourceRoot":"","sources":["../../src/camera/document_resize_target.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,YAAY,EAAE,MAAM,GACnB;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAUjE"}

package/dist/camera/document_resize_target.js

@@ -0,0 +1,17 @@
+/**
+ * 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

package/dist/camera/document_resize_target.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document_resize_target.js","sourceRoot":"","sources":["../../src/camera/document_resize_target.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,UAAU,2BAA2B,CACzC,KAAa,EACb,MAAc,EACd,YAAoB;IAEpB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAC5C,IACE,CAAC,MAAM,CAAC,QAAQ,CAAC,WAAW,CAAC;QAC7B,WAAW,IAAI,CAAC;QAChB,WAAW,IAAI,YAAY,EAC3B,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,KAAK,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC;AAC9E,CAAC"}

package/dist/camera/focus_state.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ */
+export type FocusPoint = {
+    /** Surface-coordinate X (0..1, normalized to preview width). */
+    readonly x: number;
+    /** Surface-coordinate Y (0..1, normalized to preview height). */
+    readonly y: number;
+};
+export type FocusState = {
+    readonly kind: "unspecified";
+} | {
+    readonly kind: "running";
+    readonly point: FocusPoint;
+} | {
+    readonly kind: "success";
+    readonly point: FocusPoint;
+} | {
+    readonly kind: "failure";
+    readonly point: FocusPoint;
+};
+/** Convenience constructors for the `FocusState` discriminated union. */
+export declare const FocusStates: {
+    readonly unspecified: () => FocusState;
+    readonly running: (point: FocusPoint) => FocusState;
+    readonly success: (point: FocusPoint) => FocusState;
+    readonly failure: (point: FocusPoint) => FocusState;
+};
+//# sourceMappingURL=focus_state.d.ts.map

package/dist/camera/focus_state.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus_state.d.ts","sourceRoot":"","sources":["../../src/camera/focus_state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,UAAU,GAAG;IACvB,gEAAgE;IAChE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAA;CAAE,GAChC;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC;AAE7D,yEAAyE;AACzE,eAAO,MAAM,WAAW;gCACL,UAAU;8BACV,UAAU,KAAG,UAAU;8BACvB,UAAU,KAAG,UAAU;8BACvB,UAAU,KAAG,UAAU;CAChC,CAAC"}

package/dist/camera/focus_state.js

@@ -0,0 +1,13 @@
+/**
+ * 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

package/dist/camera/focus_state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus_state.js","sourceRoot":"","sources":["../../src/camera/focus_state.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAeH,yEAAyE;AACzE,MAAM,CAAC,MAAM,WAAW,GAAG;IACzB,WAAW,EAAE,GAAe,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE,CAAC;IACxD,OAAO,EAAE,CAAC,KAAiB,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACxE,OAAO,EAAE,CAAC,KAAiB,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;IACxE,OAAO,EAAE,CAAC,KAAiB,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,CAAC;CAChE,CAAC"}

package/dist/camera/frame_processor_plugin.d.ts

@@ -0,0 +1,28 @@
+import type { HybridObject } from "react-native-nitro-modules";
+import type { Frame } from "react-native-vision-camera";
+/**
+ * A provider's frame-processor Nitro HybridObject. Each provider module
+ * registers a platform-native implementation (Swift on iOS, Kotlin on
+ * Android) under its `frameProcessorPluginName`; the SDK resolves it by
+ * that key with {@link resolveFrameProcessorPlugin}.
+ *
+ * `call` runs the provider's scan session on the frame and returns the
+ * scan-result map serialised as a JSON string — pixels never enter JS.
+ * Frame-level failures return `{"error":"<reason>"}`; absent optional
+ * keys are omitted (never `null`). The worklet must `dispose()` the
+ * frame after the call.
+ */
+export interface UseSmileIDFrameProcessorPlugin extends HybridObject<{}> {
+    call(frame: Frame, rotation: number): string;
+}
+/**
+ * Resolve a provider's frame-processor HybridObject by name, or `null`
+ * if it isn't registered natively.
+ *
+ * VisionCamera v5's `NitroModules.createHybridObject(...)` throws when the
+ * key is missing (v4's `VisionCameraProxy.initFrameProcessorPlugin`
+ * returned `null`). The throw is mapped back to `null` here so callers
+ * keep the v4 report-once-then-no-op behaviour for a missing plugin.
+ */
+export declare function resolveFrameProcessorPlugin(name: string): UseSmileIDFrameProcessorPlugin | null;
+//# sourceMappingURL=frame_processor_plugin.d.ts.map

package/dist/camera/frame_processor_plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame_processor_plugin.d.ts","sourceRoot":"","sources":["../../src/camera/frame_processor_plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,4BAA4B,CAAC;AAExD;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,8BAA+B,SAAQ,YAAY,CAAC,EAAE,CAAC;IACtE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,MAAM,GACX,8BAA8B,GAAG,IAAI,CAUvC"}