@smileid/usesmileid 12.1.0 → 12.2.0

package/dist/presentation/components/helpers/document_interior_crop.d.ts

@@ -0,0 +1,54 @@
+import type { SelfieSize } from "./selfie_interior_crop";
+/** Where an image is drawn in its card: top-left corner plus size, in layout units. */
+export type DocumentImageRect = {
+    readonly left: number;
+    readonly top: number;
+    readonly width: number;
+    readonly height: number;
+};
+/**
+ * How a captured document is scaled into its preview card: the outline the user
+ * filled, and as far past it as auto-capture reaches, but none of the rest of
+ * the border, as `SelfieInteriorCrop` hides the selfie's.
+ *
+ * An auto-captured document is saved with a border around the outline the user
+ * filled, of `fullBorderFraction` of its short side on every edge, or less where
+ * the frame had no room (the provider's native `ResizingFrameStorage`, the rule of
+ * the native bridges' `DocumentCropGeometry`). The border is where
+ * presentation-attack cues live, and the backend reads it. Auto-capture accepts a
+ * document whose detected box reaches `guideEdgeSlack` of the outline's size past
+ * each edge, so showing the outline alone could cut a captured document off; the
+ * screens that show the document fit the outline grown by that slack into their
+ * card instead (`shownSize`). A manual-shutter still or a gallery import is saved
+ * without a border, so its border fraction is 0 and it is shown whole.
+ */
+export declare const DocumentInteriorCrop: {
+    /** The full border, as a fraction of the saved document's short side on every edge. */
+    readonly fullBorderFraction: 0.15;
+    /**
+     * How far past each edge of the outline an auto-captured document's detected
+     * box may reach, as a fraction of the outline's size on that axis. The native
+     * document validators the providers run accept a document this far out
+     * (`DocumentCropGeometry.GUIDE_EDGE_SLACK` on Android, `guideEdgeSlack` on
+     * iOS); keep it equal to theirs.
+     */
+    readonly guideEdgeSlack: 0.1;
+    /**
+     * The part of an `imageSize` document the card shows: the interior inside its
+     * `borderFraction`, grown by `guideEdgeSlack` of the interior's size past each
+     * edge, and held to the image. The whole image when `borderFraction` is 0.
+     */
+    readonly shownSize: (imageSize: SelfieSize, borderFraction: number) => SelfieSize;
+    /**
+     * Uniform scale at which an `imageSize` document is drawn in a `boxSize` card,
+     * centred: its `shownSize` part fitted to the card, or, with no border, the
+     * whole image covering it. Returns 1 when either size is degenerate.
+     */
+    readonly cardScale: (imageSize: SelfieSize, boxSize: SelfieSize, borderFraction: number) => number;
+    /**
+     * Where to draw an `imageSize` document in a `boxSize` card at `cardScale`,
+     * centred. The border is uniform on every edge, so the interior sits at the
+     * image's centre and centring the image centres it.
+     */
+    readonly imageRect: (imageSize: SelfieSize, boxSize: SelfieSize, borderFraction: number) => DocumentImageRect;
+};

package/dist/presentation/components/helpers/document_interior_crop.js

@@ -0,0 +1 @@
+"use strict";export const DocumentInteriorCrop={fullBorderFraction:.15,guideEdgeSlack:.1,shownSize(t,h){const n=Math.min(Math.max(h,0),DocumentInteriorCrop.fullBorderFraction)*Math.min(t.width,t.height),c=1+2*DocumentInteriorCrop.guideEdgeSlack;return{width:Math.min(t.width,(t.width-2*n)*c),height:Math.min(t.height,(t.height-2*n)*c)}},cardScale(t,h,r){if(t.width<=0||t.height<=0||h.width<=0||h.height<=0)return 1;if(r<=0)return Math.max(h.width/t.width,h.height/t.height);const n=DocumentInteriorCrop.shownSize(t,r);return Math.min(h.width/n.width,h.height/n.height)},imageRect(t,h,r){const n=DocumentInteriorCrop.cardScale(t,h,r),c=t.width*n,d=t.height*n;return{left:(h.width-c)/2,top:(h.height-d)/2,width:c,height:d}}};

package/dist/presentation/components/helpers/selfie_interior_crop.d.ts

@@ -0,0 +1,60 @@
+/** A width × height in layout units (or image pixels). */
+export type SelfieSize = {
+    readonly width: number;
+    readonly height: number;
+};
+/**
+ * How a captured selfie is scaled into the face oval: only the frame's interior
+ * is ever shown.
+ *
+ * The SDK captures, and uploads, a larger region than it displays. The outer
+ * ring, `borderFraction` of the frame's short side on every edge, is where
+ * presentation-attack cues live (a phone screen's bezels, a print's edge). The
+ * backend reads them, and an attacker who can't see them on screen can't
+ * adjust for them. So every screen that shows the captured selfie covers its
+ * oval box with the interior alone, centred, instead of the whole frame.
+ */
+export declare const SelfieInteriorCrop: {
+    /** Border kept out of view, as a fraction of the frame's short side, trimmed from every edge. */
+    readonly borderFraction: 0.15;
+    /**
+     * Uniform scale at which the interior of an `imageSize` frame covers
+     * `boxSize`: the frame minus the border on every edge, cover-fitted. Returns
+     * 1 when either size is degenerate, so an unmeasured image draws unscaled
+     * rather than collapsing.
+     */
+    readonly coverScale: (imageSize: SelfieSize, boxSize: SelfieSize) => number;
+    /**
+     * Where to slice-cover (`xMidYMid slice`) an image whose size can't be read:
+     * the `boxSize` box, centred, enlarged by 1 / (1 - 2 × `borderFraction`).
+     * For any portrait or square frame that crops at least as much as
+     * `coverScale` does, so the border ring still stays out of view, at the cost
+     * of a slightly tighter crop than the exact one.
+     */
+    readonly unknownSizeRect: (boxSize: SelfieSize) => {
+        readonly x: number;
+        readonly y: number;
+        readonly width: number;
+        readonly height: number;
+    };
+};
+/**
+ * Reads the captured file's upright pixel size — the dimensions React Native
+ * shows on screen — or `null` when the file is missing or not a decodable
+ * image.
+ */
+export declare function decodeUprightImageSize(uri: string): Promise<SelfieSize | null>;
+/** Where a size read stands: still pending, read, or unreadable. */
+export type ImageSizeState = {
+    readonly kind: "pending";
+} | {
+    readonly kind: "read";
+    readonly size: SelfieSize;
+} | {
+    readonly kind: "unreadable";
+};
+/**
+ * The upright size of the image at `uri`: `pending` until it has been read,
+ * then `read` or `unreadable`. A new `uri` starts over from `pending`.
+ */
+export declare function useImageSize(uri: string | undefined): ImageSizeState;

package/dist/presentation/components/helpers/selfie_interior_crop.js

@@ -0,0 +1 @@
+"use strict";import{useEffect as o,useState as d}from"react";import{Image as i}from"react-native";export const SelfieInteriorCrop={borderFraction:.15,coverScale(t,e){if(t.width<=0||t.height<=0||e.width<=0||e.height<=0)return 1;const n=SelfieInteriorCrop.borderFraction*Math.min(t.width,t.height);return Math.max(e.width/(t.width-2*n),e.height/(t.height-2*n))},unknownSizeRect(t){const e=1/(1-2*SelfieInteriorCrop.borderFraction),n=t.width*e,r=t.height*e;return{x:(t.width-n)/2,y:(t.height-r)/2,width:n,height:r}}};export function decodeUprightImageSize(t){return new Promise(e=>{if(typeof i.getSize!="function"){e(null);return}i.getSize(t,(n,r)=>e(n>0&&r>0?{width:n,height:r}:null),()=>e(null))})}export function useImageSize(t){const[e,n]=d({uri:t,result:{kind:"pending"}});return o(()=>{if(!t)return;let r=!0;return decodeUprightImageSize(t).then(h=>{r&&n({uri:t,result:h?{kind:"read",size:h}:{kind:"unreadable"}})}),()=>{r=!1}},[t]),e.uri===t?e.result:{kind:"pending"}}

package/dist/presentation/components/use_smile_id_capture_content.d.ts

@@ -1,3 +1,4 @@
+import { DocumentSide } from "@smileid/usesmileid_bridge";
 import { type ReactNode } from "react";
 import type { ScanHeadTurnDirection } from "@smileid/usesmileid_bridge";
 import { CaptureType } from "../../core/models/ml_config";
@@ -21,7 +22,12 @@ export type UseSmileIDCaptureContentState = {
     readonly knownIdAspectRatio?: number;
     /** Document type — selects the in-frame shimmer skeleton. Ignored for selfie. */
     readonly documentTypeKind?: DocumentType["kind"];
-    /** Active side is the back — swaps the generic shimmer front→back. Ignored for selfie. */
+    /** Which document image is being framed (front, back or visa). Ignored for selfie. */
+    readonly documentSide?: DocumentSide;
+    /**
+     * @deprecated Use `documentSide`, which also covers the visa page. Read only when
+     * `documentSide` is absent; `true` selects the back skeleton. Ignored for selfie.
+     */
     readonly isBackSide?: boolean;
     /** Document manual shutter availability (capture-mode + fallback-timer driven). Ignored for selfie. */
     readonly showManualShutter?: boolean;

package/dist/presentation/components/use_smile_id_capture_content.js

@@ -1 +1 @@
-"use strict";import{jsx as i,Fragment as v,jsxs as c}from"react/jsx-runtime";import{memo as B,useState as A}from"react";import{Pressable as L,StyleSheet as T,Text as _,View as f}from"react-native";import{SafeAreaView as g}from"react-native-safe-area-context";import{CaptureType as U}from"../../core/models/ml_config";import{AttributionResolver as x}from"../flow/config/attribution_resolver";import{defaultLightTheme as b}from"../theme/theme";import{useUseSmileIDTheme as E}from"../theme/theme_context";import{isDocumentCaptureActive as y,UseSmileIDOverlayState as M}from"../state/use_smile_id_overlay_state";import{SiOutlineClose as K}from"./icons";import{useUseSmileIDLocalizations as F}from"../../l10n/use_smile_id_localizations_provider";import{resolveFeedbackCopy as H}from"../screen/helpers/capture_screen_helpers";import{ATTRIBUTION_TEST_ID as R,UseSmileIDAttribution as W}from"./use_smile_id_attribution";import{UseSmileIDBackButton as j}from"./use_smile_id_back_button";import{UseSmileIDButton as G}from"./use_smile_id_button";import{UseSmileIDDocumentOverlay as O}from"./use_smile_id_document_overlay";import{UseSmileIDDocumentCaptureControls as z}from"./use_smile_id_document_capture_controls";import{UseSmileIDFaceOverlay as P}from"./use_smile_id_face_overlay";import{UseSmileIDCaptureInstructionAnimation as V}from"./use_smile_id_capture_instruction_animation";import{enhancedSmartSelfieInstructionAnimationKey as N}from"./helpers/capture_instruction_animation_spec";import{UseSmileIDEnhancedSmartSelfieDirectionAnimation as $}from"./use_smile_id_enhanced_smart_selfie_direction_animation";import{UseSmileIDEnhancedSmartSelfieFullAnimation as q}from"./use_smile_id_enhanced_smart_selfie_full_animation";import{FaceOvalDefaults as J}from"./face_oval_defaults";const S=()=>{};function Q(t){const C=E(),n=t.theme??C,a=F(),{state:e}=t,[o,D]=A({width:0,height:0}),I=m=>{const{width:d,height:u}=m.nativeEvent.layout;D(h=>h.width===d&&h.height===u?h:{width:d,height:u}),t.onViewportLayout?.({width:d,height:u})},r=e.captureType===U.selfie,w=x.resolveForCapture({captureType:e.captureType,showAttribution:t.showAttribution}),k=!r&&o.width>o.height,s=e.feedbackKey?H(e.feedbackKey,a):null,p=t.startButton;return c(f,{style:[l.root,{backgroundColor:n.colors.offBlack}],testID:"si_capture_screen",onLayout:I,children:[t.cameraPreview,o.width>0&&o.height>0?c(v,{children:[r?i(P,{state:e.overlayState,progress:t.captureProgress,containerWidth:o.width,containerHeight:o.height,enableEnhancedLiveness:e.enableEnhancedLiveness,theme:n}):i(O,{state:e.overlayState,containerWidth:o.width,containerHeight:o.height,theme:n,isBackSide:e.isBackSide??!1,...e.documentTypeKind!==void 0?{documentTypeKind:e.documentTypeKind}:{},...e.knownIdAspectRatio!==void 0?{knownIdAspectRatio:e.knownIdAspectRatio}:{},...s!==null?{feedbackText:s}:{}}),r?i(V,{feedbackKey:e.enableEnhancedLiveness?N(e.feedbackKey):e.feedbackKey,containerWidth:o.width,containerHeight:o.height}):null,r&&e.enableEnhancedLiveness?e.animationDirection!==null?i($,{direction:e.animationDirection,poseMatched:e.poseMatched,containerWidth:o.width,containerHeight:o.height}):e.overlayState===M.IDLE?i(q,{containerWidth:o.width,containerHeight:o.height}):null:null,r?null:i(z,{showManualShutter:(e.showManualShutter??!1)&&t.onManualShutter!==void 0&&!y(e.overlayState),showGallery:(e.showGalleryUpload??!1)&&t.onGalleryUpload!==void 0&&!y(e.overlayState),isLandscape:o.width>o.height,enabled:t.documentControlsEnabled??!0,onManualShutter:t.onManualShutter??S,onGallery:t.onGalleryUpload??S,shutterAccessibilityLabel:a.siCdDocumentCaptureShutter,galleryAccessibilityLabel:a.siCdDocumentGallery,closeAccessibilityLabel:a.siCdClose,onClose:t.onClose})]}):null,c(g,{edges:["top","left","right"],style:[l.topBar,{paddingHorizontal:n.spacing.medium,paddingTop:n.spacing.medium}],pointerEvents:"box-none",children:[t.onBack?i(j,{onClick:t.onBack,forceLightMode:!0,theme:n,testID:"si_capture_back_button"}):i(f,{style:l.chromeSpacer}),t.onClose&&!k?i(L,{onPress:t.onClose,accessibilityRole:"button",accessibilityLabel:a.siCdClose,testID:"si_capture_close_button",style:({pressed:m})=>[l.closeButton,{backgroundColor:b.colors.offBlack,borderColor:b.colors.backButtonBorder,opacity:m?.7:1}],children:i(K,{size:20,color:b.colors.offWhite})}):null]}),s!==null&&r?i(f,{style:[l.feedbackBubble,{paddingHorizontal:n.spacing.medium,paddingVertical:n.spacing.small}],pointerEvents:"none",children:i(_,{style:{...n.typography.cardTitle,color:n.colors.primary,textAlign:"center"},testID:"si_capture_feedback_text",children:s})}):null,c(g,{edges:["bottom","left","right"],style:[l.bottom,{paddingHorizontal:n.spacing.medium,paddingBottom:n.spacing.large,gap:n.spacing.small}],pointerEvents:"box-none",children:[e.showCaptureButton?p?p({onClick:t.onStartCapture,enabled:t.startCaptureEnabled}):i(G,{label:a.siCaptureStartButton,onClick:t.onStartCapture,variant:"primary",enabled:t.startCaptureEnabled,forceLightMode:!0,theme:n,testID:"si_capture_start_button"}):null,w?i(W,{forceLightMode:!0,theme:n,testID:R}):null]})]})}export const UseSmileIDCaptureContent=B(Q);const l=T.create({root:{flex:1},topBar:{position:"absolute",top:0,start:0,end:0,flexDirection:"row",justifyContent:"space-between",alignItems:"flex-start"},closeButton:{width:40,height:40,borderRadius:20,borderWidth:1,alignItems:"center",justifyContent:"center"},chromeSpacer:{width:40,height:40},feedbackBubble:{position:"absolute",top:`${Math.round(J.feedbackTopRatio*100)}%`,alignSelf:"center",maxWidth:"85%"},bottom:{position:"absolute",bottom:0,start:0,end:0,alignItems:"center"}});
+"use strict";import{jsx as i,Fragment as v,jsxs as c}from"react/jsx-runtime";import{memo as B,useState as A}from"react";import{Pressable as L,StyleSheet as T,Text as _,View as f}from"react-native";import{SafeAreaView as g}from"react-native-safe-area-context";import{CaptureType as U}from"../../core/models/ml_config";import{AttributionResolver as x}from"../flow/config/attribution_resolver";import{defaultLightTheme as b}from"../theme/theme";import{useUseSmileIDTheme as E}from"../theme/theme_context";import{isDocumentCaptureActive as y,UseSmileIDOverlayState as M}from"../state/use_smile_id_overlay_state";import{SiOutlineClose as K}from"./icons";import{useUseSmileIDLocalizations as F}from"../../l10n/use_smile_id_localizations_provider";import{resolveFeedbackCopy as H}from"../screen/helpers/capture_screen_helpers";import{ATTRIBUTION_TEST_ID as R,UseSmileIDAttribution as W}from"./use_smile_id_attribution";import{UseSmileIDBackButton as j}from"./use_smile_id_back_button";import{UseSmileIDButton as G}from"./use_smile_id_button";import{UseSmileIDDocumentOverlay as O,resolveDocumentSide as z}from"./use_smile_id_document_overlay";import{UseSmileIDDocumentCaptureControls as P}from"./use_smile_id_document_capture_controls";import{UseSmileIDFaceOverlay as V}from"./use_smile_id_face_overlay";import{UseSmileIDCaptureInstructionAnimation as N}from"./use_smile_id_capture_instruction_animation";import{enhancedSmartSelfieInstructionAnimationKey as $}from"./helpers/capture_instruction_animation_spec";import{UseSmileIDEnhancedSmartSelfieDirectionAnimation as q}from"./use_smile_id_enhanced_smart_selfie_direction_animation";import{UseSmileIDEnhancedSmartSelfieFullAnimation as J}from"./use_smile_id_enhanced_smart_selfie_full_animation";import{FaceOvalDefaults as Q}from"./face_oval_defaults";const S=()=>{};function X(t){const C=E(),n=t.theme??C,a=F(),{state:e}=t,[o,D]=A({width:0,height:0}),I=m=>{const{width:d,height:u}=m.nativeEvent.layout;D(h=>h.width===d&&h.height===u?h:{width:d,height:u}),t.onViewportLayout?.({width:d,height:u})},r=e.captureType===U.selfie,w=x.resolveForCapture({captureType:e.captureType,showAttribution:t.showAttribution}),k=!r&&o.width>o.height,s=e.feedbackKey?H(e.feedbackKey,a):null,p=t.startButton;return c(f,{style:[l.root,{backgroundColor:n.colors.offBlack}],testID:"si_capture_screen",onLayout:I,children:[t.cameraPreview,o.width>0&&o.height>0?c(v,{children:[r?i(V,{state:e.overlayState,progress:t.captureProgress,containerWidth:o.width,containerHeight:o.height,enableEnhancedLiveness:e.enableEnhancedLiveness,theme:n}):i(O,{state:e.overlayState,containerWidth:o.width,containerHeight:o.height,theme:n,documentSide:z(e.documentSide,e.isBackSide),...e.documentTypeKind!==void 0?{documentTypeKind:e.documentTypeKind}:{},...e.knownIdAspectRatio!==void 0?{knownIdAspectRatio:e.knownIdAspectRatio}:{},...s!==null?{feedbackText:s}:{}}),r?i(N,{feedbackKey:e.enableEnhancedLiveness?$(e.feedbackKey):e.feedbackKey,containerWidth:o.width,containerHeight:o.height}):null,r&&e.enableEnhancedLiveness?e.animationDirection!==null?i(q,{direction:e.animationDirection,poseMatched:e.poseMatched,containerWidth:o.width,containerHeight:o.height}):e.overlayState===M.IDLE?i(J,{containerWidth:o.width,containerHeight:o.height}):null:null,r?null:i(P,{showManualShutter:(e.showManualShutter??!1)&&t.onManualShutter!==void 0&&!y(e.overlayState),showGallery:(e.showGalleryUpload??!1)&&t.onGalleryUpload!==void 0&&!y(e.overlayState),isLandscape:o.width>o.height,enabled:t.documentControlsEnabled??!0,onManualShutter:t.onManualShutter??S,onGallery:t.onGalleryUpload??S,shutterAccessibilityLabel:a.siCdDocumentCaptureShutter,galleryAccessibilityLabel:a.siCdDocumentGallery,closeAccessibilityLabel:a.siCdClose,onClose:t.onClose})]}):null,c(g,{edges:["top","left","right"],style:[l.topBar,{paddingHorizontal:n.spacing.medium,paddingTop:n.spacing.medium}],pointerEvents:"box-none",children:[t.onBack?i(j,{onClick:t.onBack,forceLightMode:!0,theme:n,testID:"si_capture_back_button"}):i(f,{style:l.chromeSpacer}),t.onClose&&!k?i(L,{onPress:t.onClose,accessibilityRole:"button",accessibilityLabel:a.siCdClose,testID:"si_capture_close_button",style:({pressed:m})=>[l.closeButton,{backgroundColor:b.colors.offBlack,borderColor:b.colors.backButtonBorder,opacity:m?.7:1}],children:i(K,{size:20,color:b.colors.offWhite})}):null]}),s!==null&&r?i(f,{style:[l.feedbackBubble,{paddingHorizontal:n.spacing.medium,paddingVertical:n.spacing.small}],pointerEvents:"none",children:i(_,{style:{...n.typography.cardTitle,color:n.colors.primary,textAlign:"center"},testID:"si_capture_feedback_text",children:s})}):null,c(g,{edges:["bottom","left","right"],style:[l.bottom,{paddingHorizontal:n.spacing.medium,paddingBottom:n.spacing.large,gap:n.spacing.small}],pointerEvents:"box-none",children:[e.showCaptureButton?p?p({onClick:t.onStartCapture,enabled:t.startCaptureEnabled}):i(G,{label:a.siCaptureStartButton,onClick:t.onStartCapture,variant:"primary",enabled:t.startCaptureEnabled,forceLightMode:!0,theme:n,testID:"si_capture_start_button"}):null,w?i(W,{forceLightMode:!0,theme:n,testID:R}):null]})]})}export const UseSmileIDCaptureContent=B(X);const l=T.create({root:{flex:1},topBar:{position:"absolute",top:0,start:0,end:0,flexDirection:"row",justifyContent:"space-between",alignItems:"flex-start"},closeButton:{width:40,height:40,borderRadius:20,borderWidth:1,alignItems:"center",justifyContent:"center"},chromeSpacer:{width:40,height:40},feedbackBubble:{position:"absolute",top:`${Math.round(Q.feedbackTopRatio*100)}%`,alignSelf:"center",maxWidth:"85%"},bottom:{position:"absolute",bottom:0,start:0,end:0,alignItems:"center"}});

package/dist/presentation/components/use_smile_id_captured_document_image.d.ts

@@ -5,6 +5,22 @@ export type UseSmileIDCapturedDocumentImageProps = {
     readonly uri?: string;
     /** Capture-frame aspect ratio (width / height) the box keeps while fitting the region. */
     readonly aspectRatio: number;
+    /**
+     * The hidden border `uri` was saved with, as a fraction of its short side on every edge. The
+     * card shows the interior alone and hides exactly this much; 0, the default, shows the image
+     * whole. See `DocumentInteriorCrop`.
+     */
+    readonly borderFraction?: number;
+    /**
+     * Whether a dev build may mark the hidden border over the card while
+     * `UseSmileIDDebug.setDocumentDebugOverlaysEnabled(true)` is on. Only the preview screen sets it.
+     */
+    readonly showDebugOverlay?: boolean;
+    /** Reports the card's laid-out size, for the preview screen's debug overlay. */
+    readonly onCardLayout?: (size: {
+        width: number;
+        height: number;
+    }) => void;
     /** Content centered over the document rect — e.g. the processing-screen status badge. */
     readonly overlayChild?: ReactNode;
     /** Accessible name for the image; when unset the image stays decorative. */

package/dist/presentation/components/use_smile_id_captured_document_image.js

@@ -1 +1 @@
-"use strict";import{jsx as o,jsxs as f}from"react/jsx-runtime";import{useState as I}from"react";import{Image as x,StyleSheet as R,View as n}from"react-native";import{useUseSmileIDTheme as D}from"../theme/theme_context";import{fitCapturedDocumentImage as C}from"./helpers/captured_document_image_fit";const m=8;export function UseSmileIDCapturedDocumentImage(e){const h=D(),g=e.theme??h,s=e.aspectRatio,a=g.spacing.large,[l,d]=I({width:0,height:0}),u=b=>{const{width:c,height:r}=b.nativeEvent.layout;d(i=>i.width===c&&i.height===r?i:{width:c,height:r})},y=C(s,l.width-2*a,l.height)??{...t.fillWidth,aspectRatio:s};return o(n,{style:[t.region,{paddingHorizontal:a}],onLayout:u,testID:e.testID,children:f(n,{style:[t.imageBox,y],children:[e.uri?o(x,{source:{uri:e.uri},resizeMode:"cover",style:t.image,testID:e.imageTestID,...e.imageAccessibilityLabel?{accessible:!0,accessibilityRole:"image",accessibilityLabel:e.imageAccessibilityLabel}:{}}):null,e.overlayChild?o(n,{pointerEvents:"box-none",style:t.overlay,children:e.overlayChild}):null]})})}const t=R.create({region:{flex:1,alignItems:"center",justifyContent:"center"},imageBox:{borderRadius:m},fillWidth:{width:"100%"},image:{width:"100%",height:"100%",borderRadius:m},overlay:{position:"absolute",top:0,bottom:0,start:0,end:0,alignItems:"center",justifyContent:"center"}});
+"use strict";import{jsx as l,jsxs as L}from"react/jsx-runtime";import{useState as b}from"react";import{Image as j,StyleSheet as f,View as c}from"react-native";import{useUseSmileIDTheme as E}from"../theme/theme_context";import{fitCapturedDocumentImage as F}from"./helpers/captured_document_image_fit";import{DocumentInteriorCrop as B}from"./helpers/document_interior_crop";import{useImageSize as O}from"./helpers/selfie_interior_crop";import{useDocumentPreviewOverlayEnabled as k}from"../../debug/use_smile_id_debug";import{DocumentPreviewHiddenRegionsInPlace as A}from"../../debug/use_smile_id_document_preview_debug_overlay";const I=8;export function UseSmileIDCapturedDocumentImage(e){const w=E(),x=e.theme??w,u=e.aspectRatio,g=x.spacing.large,[h,v]=b({width:0,height:0}),D=d=>{const{width:i,height:o}=d.nativeEvent.layout;v(t=>t.width===i&&t.height===o?t:{width:i,height:o})},R=F(u,h.width-2*g,h.height)??{...n.fillWidth,aspectRatio:u},a=e.borderFraction??0,y=k()&&e.showDebugOverlay===!0,r=O(a>0||y?e.uri:void 0),[s,S]=b(null),C=d=>{const{width:i,height:o}=d.nativeEvent.layout;S(t=>t?.width===i&&t.height===o?t:{width:i,height:o}),e.onCardLayout?.({width:i,height:o})},m=a>0&&s!==null&&r.kind==="read"?B.imageRect(r.size,s,a):null,z=!!e.uri&&(a<=0||m!==null||r.kind==="unreadable");return l(c,{style:[n.region,{paddingHorizontal:g}],onLayout:D,testID:e.testID,children:L(c,{style:[n.imageBox,R],onLayout:C,children:[z?l(j,{source:{uri:e.uri},resizeMode:"cover",style:m?[n.interiorImage,m]:n.image,testID:e.imageTestID,...e.imageAccessibilityLabel?{accessible:!0,accessibilityRole:"image",accessibilityLabel:e.imageAccessibilityLabel}:{}}):null,y&&s!==null&&r.kind==="read"?l(c,{pointerEvents:"none",style:f.absoluteFill,children:l(A,{imageSize:r.size,cardSize:s,borderFraction:a})}):null,e.overlayChild?l(c,{pointerEvents:"box-none",style:n.overlay,children:e.overlayChild}):null]})})}const n=f.create({region:{flex:1,alignItems:"center",justifyContent:"center"},imageBox:{borderRadius:I,overflow:"hidden"},fillWidth:{width:"100%"},image:{width:"100%",height:"100%",borderRadius:I},interiorImage:{position:"absolute"},overlay:{position:"absolute",top:0,bottom:0,start:0,end:0,alignItems:"center",justifyContent:"center"}});

package/dist/presentation/components/use_smile_id_captured_image_oval.d.ts

@@ -23,6 +23,12 @@ export type UseSmileIDCapturedImageOvalProps = {
      * status badge. Positioned once the region has measured.
      */
     readonly overlayChild?: ReactNode;
+    /**
+     * Whether a debug build may draw the selfie preview's hidden-region overlay
+     * here while `UseSmileIDDebug.setSelfieDebugOverlaysEnabled(true)` is on.
+     * Only the preview screen sets it; inert in release builds.
+     */
+    readonly showDebugOverlay?: boolean;
     readonly testID?: string;
     readonly theme?: UseSmileIDTheme;
 };
@@ -32,9 +38,11 @@ export type UseSmileIDCapturedImageOvalProps = {
  * card (`flex: 1`) and measures its own height; the oval is then
  * scaled to fit so the card below it is never overlapped.
  *
- * The image is drawn through `react-native-svg` (`<Image>` constrained
- * to the oval bounds, clipped by an `<Ellipse>`) — RN's `borderRadius`
- * can't express the ~1:1.26 ellipse on Android. Outside the oval is
- * the uniform page background; no scrim is painted.
+ * The image is drawn through `react-native-svg` (`<Image>` sized so the
+ * frame's interior covers the oval bounds, clipped by an `<Ellipse>`) —
+ * RN's `borderRadius` can't express the ~1:1.26 ellipse on Android. Only
+ * the interior shows (`SelfieInteriorCrop`); the captured border ring stays
+ * out of view. Outside the oval is the uniform page background; no scrim
+ * is painted.
  */
 export declare function UseSmileIDCapturedImageOval(props: UseSmileIDCapturedImageOvalProps): import("react").JSX.Element;

package/dist/presentation/components/use_smile_id_captured_image_oval.js

@@ -1 +1 @@
-"use strict";import{jsx as i,jsxs as h}from"react/jsx-runtime";import{useId as u,useState as y}from"react";import{StyleSheet as f,View as l}from"react-native";import x,{ClipPath as b,Defs as I,Ellipse as H,Image as S}from"react-native-svg";import{useUseSmileIDTheme as D}from"../theme/theme_context";import{computeScaledOvalGeometry as W}from"./helpers/scaled_oval_geometry";export function UseSmileIDCapturedImageOval(t){const r=D(),m=t.theme??r,[a,g]=y(0),n=`si_oval_clip_${u().replace(/:/g,"")}`,v=d=>{g(d.nativeEvent.layout.height)},e=t.screenWidth>0&&t.screenHeight>0&&a>0?W(t.screenWidth,t.screenHeight,a,m.spacing.medium):null,s=e!==null&&e.scale>0,c=e?{width:e.ovalWidth,height:e.ovalHeight,left:e.ovalLeft,top:e.ovalTop}:{width:0,height:0,left:0,top:0};return h(l,{style:o.region,onLayout:v,testID:t.testID,children:[t.uri?i(l,{pointerEvents:"none",style:[o.oval,c],testID:t.imageTestID,...t.imageAccessibilityLabel?{accessible:!0,accessibilityRole:"image",accessibilityLabel:t.imageAccessibilityLabel}:{},children:s&&e?h(x,{width:"100%",height:"100%",viewBox:`0 0 ${e.ovalWidth} ${e.ovalHeight}`,children:[i(I,{children:i(b,{id:n,children:i(H,{cx:e.ovalWidth/2,cy:e.ovalHeight/2,rx:e.ovalWidth/2,ry:e.ovalHeight/2})})}),i(S,{href:{uri:t.uri},x:0,y:0,width:e.ovalWidth,height:e.ovalHeight,preserveAspectRatio:"xMidYMid slice",clipPath:`url(#${n})`})]}):null}):null,t.overlayChild&&s?i(l,{pointerEvents:"box-none",style:[o.overlay,c],children:t.overlayChild}):null]})}const o=f.create({region:{flex:1},oval:{position:"absolute"},overlay:{position:"absolute",alignItems:"center",justifyContent:"center"}});
+"use strict";import{jsx as i,jsxs as v}from"react/jsx-runtime";import{useId as I,useState as D}from"react";import{StyleSheet as H,View as s}from"react-native";import C,{ClipPath as R,Defs as W,Ellipse as z,Image as E}from"react-native-svg";import{useSelfiePreviewOverlayEnabled as L}from"../../debug/use_smile_id_debug";import{UseSmileIDSelfiePreviewDebugOverlay as O}from"../../debug/use_smile_id_selfie_preview_debug_overlay";import{useUseSmileIDTheme as j}from"../theme/theme_context";import{computeScaledOvalGeometry as _}from"./helpers/scaled_oval_geometry";import{SelfieInteriorCrop as y,useImageSize as P}from"./helpers/selfie_interior_crop";export function UseSmileIDCapturedImageOval(e){const f=j(),b=e.theme??f,[c,x]=D(0),g=`si_oval_clip_${I().replace(/:/g,"")}`,S=L(),o=P(e.uri),w=l=>{x(l.nativeEvent.layout.height)},t=e.screenWidth>0&&e.screenHeight>0&&c>0?_(e.screenWidth,e.screenHeight,c,b.spacing.medium):null,a=t!==null&&t.scale>0,n=(()=>{if(!t||o.kind==="pending")return null;const l={width:t.ovalWidth,height:t.ovalHeight};if(o.kind==="unreadable")return y.unknownSizeRect(l);const m=y.coverScale(o.size,l),d=o.size.width*m,u=o.size.height*m;return{x:(l.width-d)/2,y:(l.height-u)/2,width:d,height:u}})(),r=t?{width:t.ovalWidth,height:t.ovalHeight,left:t.ovalLeft,top:t.ovalTop}:{width:0,height:0,left:0,top:0};return v(s,{style:h.region,onLayout:w,testID:e.testID,children:[e.uri?i(s,{pointerEvents:"none",style:[h.oval,r],testID:e.imageTestID,...e.imageAccessibilityLabel?{accessible:!0,accessibilityRole:"image",accessibilityLabel:e.imageAccessibilityLabel}:{},children:a&&t&&n?v(C,{width:"100%",height:"100%",viewBox:`0 0 ${t.ovalWidth} ${t.ovalHeight}`,children:[i(W,{children:i(R,{id:g,children:i(z,{cx:t.ovalWidth/2,cy:t.ovalHeight/2,rx:t.ovalWidth/2,ry:t.ovalHeight/2})})}),i(E,{href:{uri:e.uri},x:n.x,y:n.y,width:n.width,height:n.height,preserveAspectRatio:"xMidYMid slice",clipPath:`url(#${g})`})]}):null}):null,e.overlayChild&&a?i(s,{pointerEvents:"box-none",style:[h.overlay,r],children:e.overlayChild}):null,e.showDebugOverlay&&S&&e.uri&&a?i(O,{uri:e.uri,ovalRect:r}):null]})}const h=H.create({region:{flex:1},oval:{position:"absolute"},overlay:{position:"absolute",alignItems:"center",justifyContent:"center"}});

package/dist/presentation/components/use_smile_id_document_overlay.d.ts

@@ -1,3 +1,4 @@
+import { DocumentSide } from "@smileid/usesmileid_bridge";
 import type { UseSmileIDTheme } from "../theme/theme";
 import { type UseSmileIDOverlayState as OverlayState } from "../state/use_smile_id_overlay_state";
 import type { DocumentType } from "../../core/models/document_type";
@@ -9,7 +10,12 @@ export type UseSmileIDDocumentOverlayProps = {
     readonly knownIdAspectRatio?: number;
     /** Document type — selects the in-frame shimmer skeleton. */
     readonly documentTypeKind?: DocumentType["kind"];
-    /** Generic-document back side — swaps the front skeleton for the back. */
+    /** Which document image is being framed — selects the front, back or visa skeleton. */
+    readonly documentSide?: DocumentSide;
+    /**
+     * @deprecated Use `documentSide`, which also covers the visa page. Read only when
+     * `documentSide` is absent; `true` selects the back skeleton.
+     */
     readonly isBackSide?: boolean;
     /**
      * Coaching copy shown in the dark pill below the frame. Rendered here so it
@@ -19,6 +25,11 @@ export type UseSmileIDDocumentOverlayProps = {
     readonly testID?: string;
     readonly theme?: UseSmileIDTheme;
 };
+/**
+ * The image an overlay is framing. `isBackSide` is the pre-visa boolean and is
+ * consulted only when `documentSide` is absent.
+ */
+export declare function resolveDocumentSide(documentSide: DocumentSide | undefined, isBackSide: boolean | undefined): DocumentSide;
 /** Default document aspect (CR-80 ID-1 card) when no known ratio is supplied. */
 export declare const DEFAULT_DOCUMENT_ASPECT = 1.586;
 /**

package/dist/presentation/components/use_smile_id_document_overlay.js

@@ -1 +1 @@
-"use strict";import{jsx as n,jsxs as I}from"react/jsx-runtime";import{memo as R}from"react";import{StyleSheet as T,Text as D,View as m}from"react-native";import{useSafeAreaInsets as S}from"react-native-safe-area-context";import E,{Path as b}from"react-native-svg";import{useUseSmileIDTheme as p}from"../theme/theme_context";import{isDocumentCaptureActive as v}from"../state/use_smile_id_overlay_state";import{UseSmileIDOvalBorderPalette as H}from"./use_smile_id_oval_border_palette";import{UseSmileIDDocumentShimmer as F}from"./use_smile_id_document_shimmer";import{UseSmileIDCaptureSpinner as $}from"./use_smile_id_capture_spinner";const C=16,M=.71,O=.61,g=16,u=4,f=48,y=24;export const DEFAULT_DOCUMENT_ASPECT=1.586;export function documentGuideRect(e,i,o){let r=i*M,t=r/e;const s=o*O;return t>s&&(t=s,r=t*e),{left:(i-r)/2,top:(o-t)/2,width:r,height:t}}const P="#00000026",x="#00000066";export function UseSmileIDDocumentOverlay(e){const i=p(),o=e.theme??i,r=S(),t=e.knownIdAspectRatio??DEFAULT_DOCUMENT_ASPECT,s=t<1,{left:c,top:d,width:l,height:a}=documentGuideRect(t,e.containerWidth,e.containerHeight),h=v(e.state),_=o.colors[H.tokenFor(e.state,!1)],A=o.colors.documentOverlayScrim??x;return e.containerWidth<=0||e.containerHeight<=0?null:I(m,{testID:e.testID,style:T.absoluteFill,pointerEvents:"none",children:[n(m,{style:[T.absoluteFill,{backgroundColor:P}]}),n(W,{containerWidth:e.containerWidth,containerHeight:e.containerHeight,frameLeft:c,frameTop:d,frameWidth:l,frameHeight:a,cornerRadius:g,color:A}),h?null:n(m,{style:{position:"absolute",left:c+l*.1,top:d+a*.1,width:l*.8,height:a*.8},pointerEvents:"none",children:n(F,{width:l*.8,height:a*.8,isBackSide:e.isBackSide??!1,...e.documentTypeKind!==void 0?{documentTypeKind:e.documentTypeKind}:{}})}),n(m,{style:{position:"absolute",left:c-u/2,top:d-u/2,width:l+u,height:a+u,borderWidth:u,borderRadius:g+u/2,borderColor:_}}),h?s?n(m,{style:{position:"absolute",left:0,right:0,bottom:r.bottom+y,alignItems:"center"},pointerEvents:"none",children:n($,{size:f,color:o.colors.ovalActive,testID:"si_document_capture_spinner"})}):n(m,{style:{position:"absolute",left:c+l+(e.containerWidth-(c+l)-f)/2,top:d+(a-f)/2},pointerEvents:"none",children:n($,{size:f,color:o.colors.ovalActive,testID:"si_document_capture_spinner"})}):null,e.feedbackText?n(m,{style:{position:"absolute",top:d+a+C,start:0,end:0,alignItems:"center"},pointerEvents:"none",children:n(m,{style:{maxWidth:"85%",borderRadius:8,backgroundColor:o.colors.offBlack,paddingHorizontal:o.spacing.medium,paddingVertical:o.spacing.small},children:n(D,{style:{...o.typography.cardTitle,color:"#FFFFFF",textAlign:"center"},testID:"si_document_feedback_text",children:e.feedbackText})})}):null]})}const W=R(function(i){const{containerWidth:o,containerHeight:r,frameLeft:t,frameTop:s,frameWidth:c,frameHeight:d,cornerRadius:l,color:a}=i,h=Math.min(l,c/2,d/2),_=`M0 0H${o}V${r}H0Z`,A=U(t,s,c,d,h);return n(E,{width:"100%",height:"100%",viewBox:`0 0 ${o} ${r}`,preserveAspectRatio:"none",style:T.absoluteFill,children:n(b,{d:`${_} ${A}`,fill:a,fillRule:"evenodd"})})});function U(e,i,o,r,t){const s=e+o,c=i+r;return`M${e+t} ${i}H${s-t}A${t} ${t} 0 0 1 ${s} ${i+t}V${c-t}A${t} ${t} 0 0 1 ${s-t} ${c}H${e+t}A${t} ${t} 0 0 1 ${e} ${c-t}V${i+t}A${t} ${t} 0 0 1 ${e+t} ${i}Z`}
+"use strict";import{jsx as i,jsxs as R}from"react/jsx-runtime";import{DocumentSide as $}from"@smileid/usesmileid_bridge";import{memo as D}from"react";import{StyleSheet as T,Text as S,View as m}from"react-native";import{useSafeAreaInsets as E}from"react-native-safe-area-context";import b,{Path as p}from"react-native-svg";import{useUseSmileIDTheme as v}from"../theme/theme_context";import{isDocumentCaptureActive as F}from"../state/use_smile_id_overlay_state";import{UseSmileIDOvalBorderPalette as H}from"./use_smile_id_oval_border_palette";import{UseSmileIDDocumentShimmer as C}from"./use_smile_id_document_shimmer";import{UseSmileIDCaptureSpinner as g}from"./use_smile_id_capture_spinner";export function resolveDocumentSide(t,n){return t!==void 0?t:n===!0?$.Back:$.Front}const M=16,O=.71,y=.61,I=16,u=4,f=48,P=24;export const DEFAULT_DOCUMENT_ASPECT=1.586;export function documentGuideRect(t,n,o){let c=n*O,e=c/t;const s=o*y;return e>s&&(e=s,c=e*t),{left:(n-c)/2,top:(o-e)/2,width:c,height:e}}const x="#00000026",W="#00000066";export function UseSmileIDDocumentOverlay(t){const n=v(),o=t.theme??n,c=E(),e=t.knownIdAspectRatio??DEFAULT_DOCUMENT_ASPECT,s=e<1,{left:r,top:d,width:l,height:a}=documentGuideRect(e,t.containerWidth,t.containerHeight),h=F(t.state),_=o.colors[H.tokenFor(t.state,!1)],A=o.colors.documentOverlayScrim??W;return t.containerWidth<=0||t.containerHeight<=0?null:R(m,{testID:t.testID,style:T.absoluteFill,pointerEvents:"none",children:[i(m,{style:[T.absoluteFill,{backgroundColor:x}]}),i(U,{containerWidth:t.containerWidth,containerHeight:t.containerHeight,frameLeft:r,frameTop:d,frameWidth:l,frameHeight:a,cornerRadius:I,color:A}),h?null:i(m,{style:{position:"absolute",left:r+l*.1,top:d+a*.1,width:l*.8,height:a*.8},pointerEvents:"none",children:i(C,{width:l*.8,height:a*.8,documentSide:resolveDocumentSide(t.documentSide,t.isBackSide),...t.documentTypeKind!==void 0?{documentTypeKind:t.documentTypeKind}:{}})}),i(m,{style:{position:"absolute",left:r-u/2,top:d-u/2,width:l+u,height:a+u,borderWidth:u,borderRadius:I+u/2,borderColor:_}}),h?s?i(m,{style:{position:"absolute",left:0,right:0,bottom:c.bottom+P,alignItems:"center"},pointerEvents:"none",children:i(g,{size:f,color:o.colors.ovalActive,testID:"si_document_capture_spinner"})}):i(m,{style:{position:"absolute",left:r+l+(t.containerWidth-(r+l)-f)/2,top:d+(a-f)/2},pointerEvents:"none",children:i(g,{size:f,color:o.colors.ovalActive,testID:"si_document_capture_spinner"})}):null,t.feedbackText?i(m,{style:{position:"absolute",top:d+a+M,start:0,end:0,alignItems:"center"},pointerEvents:"none",children:i(m,{style:{maxWidth:"85%",borderRadius:8,backgroundColor:o.colors.offBlack,paddingHorizontal:o.spacing.medium,paddingVertical:o.spacing.small},children:i(S,{style:{...o.typography.cardTitle,color:"#FFFFFF",textAlign:"center"},testID:"si_document_feedback_text",children:t.feedbackText})})}):null]})}const U=D(function(n){const{containerWidth:o,containerHeight:c,frameLeft:e,frameTop:s,frameWidth:r,frameHeight:d,cornerRadius:l,color:a}=n,h=Math.min(l,r/2,d/2),_=`M0 0H${o}V${c}H0Z`,A=k(e,s,r,d,h);return i(b,{width:"100%",height:"100%",viewBox:`0 0 ${o} ${c}`,preserveAspectRatio:"none",style:T.absoluteFill,children:i(p,{d:`${_} ${A}`,fill:a,fillRule:"evenodd"})})});function k(t,n,o,c,e){const s=t+o,r=n+c;return`M${t+e} ${n}H${s-e}A${e} ${e} 0 0 1 ${s} ${n+e}V${r-e}A${e} ${e} 0 0 1 ${s-e} ${r}H${t+e}A${e} ${e} 0 0 1 ${t} ${r-e}V${n+e}A${e} ${e} 0 0 1 ${t+e} ${n}Z`}

package/dist/presentation/components/use_smile_id_document_shimmer.d.ts

@@ -1,14 +1,19 @@
+import { DocumentSide } from "@smileid/usesmileid_bridge";
 import type { DocumentType } from "../../core/models/document_type";
 /** Translucent in-frame document shimmer — the per-type "align here" skeleton, scaled to fit the capture frame. */
 export type UseSmileIDDocumentShimmerProps = {
     readonly width: number;
     readonly height: number;
-    /** Selects the skeleton; the green book and passport ignore `isBackSide`. */
+    /** Selects the skeleton; the green book and passport ignore `documentSide`. */
     readonly documentTypeKind?: DocumentType["kind"];
-    /** Generic documents only: show the back-side skeleton instead of the front. */
-    readonly isBackSide?: boolean;
+    /** Which document image is being captured. The visa page has no skeleton. */
+    readonly documentSide?: DocumentSide;
     readonly testID?: string;
 };
-/** Shimmer skeleton for a document type + side. Only generic documents have front/back; passport and green book ignore the side. */
-export declare function documentShimmerXml(documentTypeKind: DocumentType["kind"] | undefined, isBackSide: boolean): string;
+/**
+ * Shimmer skeleton for a document type + image, or null for the visa page,
+ * which shows the bare frame. Otherwise only generic documents have
+ * front/back, and passport and green book ignore the side.
+ */
+export declare function documentShimmerXml(documentTypeKind: DocumentType["kind"] | undefined, documentSide: DocumentSide): string | null;
 export declare const UseSmileIDDocumentShimmer: import("react").MemoExoticComponent<(props: UseSmileIDDocumentShimmerProps) => import("react").JSX.Element | null>;

package/dist/presentation/components/use_smile_id_document_shimmer.js

@@ -1 +1 @@
-"use strict";import{jsx as n}from"react/jsx-runtime";import{memo as S}from"react";import{SvgXml as s}from"react-native-svg";import{SI_DOCUMENT_BACK_SHIMMER as u,SI_DOCUMENT_FRONT_SHIMMER as _,SI_DOCUMENT_GREEN_BOOK_SHIMMER as c,SI_DOCUMENT_PASSPORT_SHIMMER as I}from"../assets/svg/document_shimmer_strings";export function documentShimmerXml(t,e){switch(t){case"passport":return I;case"southAfricaGreenBook":return c;default:return e?u:_}}export const UseSmileIDDocumentShimmer=S(function(e){const{width:m,height:r,documentTypeKind:i,isBackSide:o=!1}=e;return m<=0||r<=0?null:n(s,{xml:documentShimmerXml(i,o),width:m,height:r,...e.testID!==void 0?{testID:e.testID}:{}})});
+"use strict";import{jsx as S}from"react/jsx-runtime";import{memo as s}from"react";import{SvgXml as c}from"react-native-svg";import{DocumentSide as e}from"@smileid/usesmileid_bridge";import{SI_DOCUMENT_BACK_SHIMMER as _,SI_DOCUMENT_FRONT_SHIMMER as l,SI_DOCUMENT_GREEN_BOOK_SHIMMER as I,SI_DOCUMENT_PASSPORT_SHIMMER as f}from"../assets/svg/document_shimmer_strings";export function documentShimmerXml(m,t){if(t===e.Visa)return null;switch(m){case"passport":return f;case"southAfricaGreenBook":return I;default:return t===e.Back?_:l}}export const UseSmileIDDocumentShimmer=s(function(t){const{width:r,height:n,documentTypeKind:i,documentSide:u=e.Front}=t,o=documentShimmerXml(i,u);return r<=0||n<=0||o===null?null:S(c,{xml:o,width:r,height:n,...t.testID!==void 0?{testID:t.testID}:{}})});

package/dist/presentation/flow/analytics/use_smile_id_analytics_event.d.ts

@@ -31,7 +31,10 @@ export declare const UseSmileIDAnalyticsEventTypes: {
 export type UseSmileIDAnalyticsEventType = (typeof UseSmileIDAnalyticsEventTypes)[keyof typeof UseSmileIDAnalyticsEventTypes];
 /** Extra parameter key constants for `UseSmileIDAnalyticsEvent.extras`. */
 export declare const UseSmileIDAnalyticsParamKeys: {
+    /** This SDK's job type label, frozen per SDK; group across platforms on `jobTypeId`. */
     readonly jobType: "job_type";
+    /** The numeric job type id, the same on every SDK. */
+    readonly jobTypeId: "job_type_id";
     readonly screenName: "screen_name";
     readonly sessionId: "session_id";
     readonly timestamp: "timestamp";
@@ -65,10 +68,10 @@ export declare const UseSmileIDAnalyticsReasons: {
     readonly outOfFrame: "out_of_frame";
     readonly timeout: "timeout";
     readonly qualityDropTimeout: "quality_drop_timeout";
-    readonly multipleFacesLost: "multiple_faces_lost";
     readonly motionBlur: "motion_blur";
     readonly notSmiling: "not_smiling";
 };
+/** Read an event back as a typed `UseSmileIDAnalyticsEventKind` with `analyticsEventKind(event)`. */
 export type UseSmileIDAnalyticsEvent = {
     readonly type: UseSmileIDAnalyticsEventType;
     /** Flat string→string map. Always includes `session_id` and `timestamp`. */

package/dist/presentation/flow/analytics/use_smile_id_analytics_event.js

@@ -1 +1 @@
-"use strict";export const UseSmileIDAnalyticsEventTypes={flowStarted:"flow_started",screenViewed:"screen_viewed",consentCaptured:"consent_captured",selfieCaptured:"selfie_captured",documentCaptured:"document_captured",retakeRequested:"retake_requested",jobSubmitted:"job_submitted",flowCompleted:"flow_completed",selfieSessionRestarted:"selfie_session_restarted",selfieFrameRejected:"selfie_frame_rejected"},UseSmileIDAnalyticsParamKeys={jobType:"job_type",screenName:"screen_name",sessionId:"session_id",timestamp:"timestamp",documentSide:"document_side",decision:"decision",livenessImageCount:"liveness_image_count",attempt:"attempt",jobId:"job_id",result:"result",errorMessage:"error_message",reason:"reason",framesDiscarded:"frames_discarded",durationMs:"duration_ms",iou:"iou",probability:"probability"},UseSmileIDAnalyticsScreenNames={consent:"consent",instructions:"instructions",capture:"capture",preview:"preview",processing:"processing"},UseSmileIDAnalyticsReasons={outOfFrame:"out_of_frame",timeout:"timeout",qualityDropTimeout:"quality_drop_timeout",multipleFacesLost:"multiple_faces_lost",motionBlur:"motion_blur",notSmiling:"not_smiling"};
+"use strict";export const UseSmileIDAnalyticsEventTypes={flowStarted:"flow_started",screenViewed:"screen_viewed",consentCaptured:"consent_captured",selfieCaptured:"selfie_captured",documentCaptured:"document_captured",retakeRequested:"retake_requested",jobSubmitted:"job_submitted",flowCompleted:"flow_completed",selfieSessionRestarted:"selfie_session_restarted",selfieFrameRejected:"selfie_frame_rejected"},UseSmileIDAnalyticsParamKeys={jobType:"job_type",jobTypeId:"job_type_id",screenName:"screen_name",sessionId:"session_id",timestamp:"timestamp",documentSide:"document_side",decision:"decision",livenessImageCount:"liveness_image_count",attempt:"attempt",jobId:"job_id",result:"result",errorMessage:"error_message",reason:"reason",framesDiscarded:"frames_discarded",durationMs:"duration_ms",iou:"iou",probability:"probability"},UseSmileIDAnalyticsScreenNames={consent:"consent",instructions:"instructions",capture:"capture",preview:"preview",processing:"processing"},UseSmileIDAnalyticsReasons={outOfFrame:"out_of_frame",timeout:"timeout",qualityDropTimeout:"quality_drop_timeout",motionBlur:"motion_blur",notSmiling:"not_smiling"};

package/dist/presentation/flow/analytics/use_smile_id_analytics_event_kind.d.ts

@@ -0,0 +1,89 @@
+/**
+ * The typed form of a `UseSmileIDAnalyticsEvent`: one case per event
+ * type, discriminated by `kind`, carrying that event's fields.
+ * `analyticsEventKind(event)` reads a delivered event back into it, so a
+ * `switch` matches typed cases instead of `type` strings. A minor release
+ * can add a case for a new event, so keep a `default` branch.
+ *
+ * The wire form is the cross-SDK contract in `analytics-contract.json`,
+ * identical in the Android, iOS, Flutter and React Native repos; the
+ * `kind` values are that contract's case names.
+ */
+import { DocumentSide } from "@smileid/usesmileid_bridge";
+import { JobType } from "../../../core/models/job_type";
+import { UseSmileIDAnalyticsScreenNames, type UseSmileIDAnalyticsEventType } from "./use_smile_id_analytics_event";
+/** A `screen_name` value. */
+export type UseSmileIDAnalyticsScreenName = (typeof UseSmileIDAnalyticsScreenNames)[keyof typeof UseSmileIDAnalyticsScreenNames];
+export type UseSmileIDAnalyticsEventKind = 
+/** The flow started. */
+{
+    readonly kind: "flowStarted";
+    readonly jobType: JobType;
+}
+/** A screen became active. */
+ | {
+    readonly kind: "screenViewed";
+    readonly screen: UseSmileIDAnalyticsScreenName;
+}
+/** The user granted consent on the consent screen. */
+ | {
+    readonly kind: "consentCaptured";
+}
+/** The selfie and its liveness frames were captured. */
+ | {
+    readonly kind: "selfieCaptured";
+    readonly livenessImageCount: number;
+}
+/** One document image was captured: one event per image. */
+ | {
+    readonly kind: "documentCaptured";
+    readonly side: DocumentSide;
+}
+/** The user went back to redo a step. */
+ | {
+    readonly kind: "retakeRequested";
+}
+/** A submission started; `attempt` counts from 1 across retries. */
+ | {
+    readonly kind: "jobSubmitted";
+    readonly jobType: JobType;
+    readonly attempt: number;
+}
+/** Smile ID accepted the submission; `jobId` is sent when it is known. */
+ | {
+    readonly kind: "flowCompletedSuccess";
+    readonly jobId?: string;
+}
+/** The flow failed. `errorMessage` is free-form developer text, never a stable identifier. */
+ | {
+    readonly kind: "flowCompletedFailure";
+    readonly errorMessage: string;
+}
+/** The selfie session restarted after its requirements stopped being met. */
+ | {
+    readonly kind: "selfieSessionRestarted";
+    readonly reason: string;
+    readonly framesDiscarded: number;
+    readonly durationMs: number;
+}
+/** A liveness frame was rejected. */
+ | {
+    readonly kind: "selfieFrameRejected";
+    readonly reason: string;
+};
+/** The wire form of a kind: its event `type` and its own `extras`, before `session_id` and `timestamp`. */
+export interface UseSmileIDAnalyticsWireEvent {
+    readonly type: UseSmileIDAnalyticsEventType;
+    readonly extras: Readonly<Record<string, string>>;
+}
+/** Encodes a kind to its wire `type` and `extras`. */
+export declare function encodeAnalyticsEventKind(event: UseSmileIDAnalyticsEventKind): UseSmileIDAnalyticsWireEvent;
+/**
+ * Reads a delivered event back into its kind, or `undefined` when its
+ * `type` is not an event this SDK emits or its `extras` lack a field the
+ * event carries. Extra keys, such as `session_id`, are ignored.
+ */
+export declare function analyticsEventKind(event: {
+    readonly type: string;
+    readonly extras: Readonly<Record<string, string>>;
+}): UseSmileIDAnalyticsEventKind | undefined;

package/dist/presentation/flow/analytics/use_smile_id_analytics_event_kind.js

@@ -0,0 +1 @@
+"use strict";import{DocumentSide as l}from"@smileid/usesmileid_bridge";import{JobType as m}from"../../../core/models/job_type";import{UseSmileIDAnalyticsEventTypes as s,UseSmileIDAnalyticsParamKeys as n,UseSmileIDAnalyticsScreenNames as S}from"./use_smile_id_analytics_event";const o="granted",u="success",a="failure";function c(e){return{[n.jobType]:String(e),[n.jobTypeId]:String(e)}}export function encodeAnalyticsEventKind(e){const t=s;switch(e.kind){case"flowStarted":return{type:t.flowStarted,extras:c(e.jobType)};case"screenViewed":return{type:t.screenViewed,extras:{[n.screenName]:e.screen}};case"consentCaptured":return{type:t.consentCaptured,extras:{[n.decision]:o}};case"selfieCaptured":return{type:t.selfieCaptured,extras:{[n.livenessImageCount]:String(e.livenessImageCount)}};case"documentCaptured":return{type:t.documentCaptured,extras:{[n.documentSide]:e.side}};case"retakeRequested":return{type:t.retakeRequested,extras:{}};case"jobSubmitted":return{type:t.jobSubmitted,extras:{...c(e.jobType),[n.attempt]:String(e.attempt)}};case"flowCompletedSuccess":return{type:t.flowCompleted,extras:{[n.result]:u,...e.jobId?{[n.jobId]:e.jobId}:{}}};case"flowCompletedFailure":return{type:t.flowCompleted,extras:{[n.result]:a,[n.errorMessage]:e.errorMessage}};case"selfieSessionRestarted":return{type:t.selfieSessionRestarted,extras:{[n.reason]:e.reason,[n.framesDiscarded]:String(e.framesDiscarded),[n.durationMs]:String(e.durationMs)}};case"selfieFrameRejected":return{type:t.selfieFrameRejected,extras:{[n.reason]:e.reason}}}}function d(e){if(!(e===void 0||!/^-?\d+$/.test(e)))return Number(e)}function f(e){const t=d(e[n.jobTypeId])??d(e[n.jobType]);return Object.values(m).find(r=>r===t)}const y=Object.values(S),b=Object.values(l),p={[s.flowStarted]:e=>{const t=f(e);return t===void 0?void 0:{kind:"flowStarted",jobType:t}},[s.screenViewed]:e=>{const t=e[n.screenName];return t!==void 0&&y.includes(t)?{kind:"screenViewed",screen:t}:void 0},[s.consentCaptured]:e=>e[n.decision]===o?{kind:"consentCaptured"}:void 0,[s.selfieCaptured]:e=>{const t=d(e[n.livenessImageCount]);return t===void 0?void 0:{kind:"selfieCaptured",livenessImageCount:t}},[s.documentCaptured]:e=>{const t=e[n.documentSide];return t!==void 0&&b.includes(t)?{kind:"documentCaptured",side:t}:void 0},[s.retakeRequested]:()=>({kind:"retakeRequested"}),[s.jobSubmitted]:e=>{const t=f(e),r=d(e[n.attempt]);return t===void 0||r===void 0?void 0:{kind:"jobSubmitted",jobType:t,attempt:r}},[s.flowCompleted]:e=>{switch(e[n.result]){case u:{const t=e[n.jobId];return t?{kind:"flowCompletedSuccess",jobId:t}:{kind:"flowCompletedSuccess"}}case a:{const t=e[n.errorMessage];return t===void 0?void 0:{kind:"flowCompletedFailure",errorMessage:t}}default:return}},[s.selfieSessionRestarted]:e=>{const t=e[n.reason],r=d(e[n.framesDiscarded]),i=d(e[n.durationMs]);return t===void 0||r===void 0||i===void 0?void 0:{kind:"selfieSessionRestarted",reason:t,framesDiscarded:r,durationMs:i}},[s.selfieFrameRejected]:e=>{const t=e[n.reason];return t===void 0?void 0:{kind:"selfieFrameRejected",reason:t}}};export function analyticsEventKind(e){return Object.prototype.hasOwnProperty.call(p,e.type)?p[e.type]?.(e.extras):void 0}

package/dist/presentation/flow/dsl/builder/screens_builder.d.ts

@@ -96,8 +96,6 @@ export declare class DocumentCaptureConfigBuilder {
      * gallery. Defaults to false.
      */
     allowGalleryUpload: boolean;
-    /** When true, captures both the front and back of the document. Defaults to true. */
-    captureBothSides: boolean;
     /** When true, lets the user skip capturing the back side. Defaults to false. */
     allowSkipBack: boolean;
     /**
@@ -105,6 +103,10 @@ export declare class DocumentCaptureConfigBuilder {
      * dimensions are known in advance — e.g. CR-80 ID card = 1.586.
      */
     knownIdAspectRatio?: number;
+    private _captureBothSides?;
+    /** Captures the back too; defaults to false for a passport, else true. */
+    get captureBothSides(): boolean;
+    set captureBothSides(value: boolean);
     /** The `documentType`'s aspect ratio when present, otherwise `knownIdAspectRatio`. */
     get resolvedAspectRatio(): number | undefined;
 }

package/dist/presentation/flow/dsl/builder/screens_builder.js

@@ -1 +1 @@
-"use strict";import{CaptureType as n}from"../../../../core/models/ml_config";import{DocumentCaptureMode as i}from"../../../../core/models/document_capture_mode";export{n as CaptureType};export class ConsentConfigBuilder{partnerName="";partnerIcon;partnerPrivacyPolicyUrl;onConsentGranted;allowButton;denyButton}export class InstructionsConfigBuilder{titlePrefix;titleEmphasis;heroAnimation;guidelinesSectionTitle;guidelines=[];showHeroOval=!0;continueButton}export class SelfieCaptureConfigBuilder{allowAgentMode=!1;enableEnhancedLiveness=!1}export class DocumentCaptureConfigBuilder{documentType;captureMode=i.AutoCaptureWithManualFallback();allowGalleryUpload=!1;captureBothSides=!0;allowSkipBack=!1;knownIdAspectRatio;get resolvedAspectRatio(){return this.documentType?.knownAspectRatio??this.knownIdAspectRatio}}export class CaptureConfigBuilder{captureType;startButton;_selfie;_document;selfie(t){this._selfie||(this._selfie=new SelfieCaptureConfigBuilder),t(this._selfie)}document(t){this._document||(this._document=new DocumentCaptureConfigBuilder),t(this._document)}get selfieConfig(){return this._selfie}get documentConfig(){return this._document}}export class PreviewConfigBuilder{allowRetake=!0}export class ProcessingConfigBuilder{showProgressPercentage=!0;continueButton;retryButton;exitButton}export class ScreensBuilder{_steps=[];consent(t){const e=new ConsentConfigBuilder;t?.(e),this._steps.push({kind:"consent",config:e})}instructions(t){const e=new InstructionsConfigBuilder;t?.(e),this._steps.push({kind:"instructions",config:e})}capture(t){const e=new CaptureConfigBuilder;t(e),this._steps.push({kind:"capture",config:e})}preview(t){const e=new PreviewConfigBuilder;t?.(e),this._steps.push({kind:"preview",config:e})}processing(t){const e=new ProcessingConfigBuilder;t?.(e),this._steps.push({kind:"processing",config:e})}build(){return Object.freeze({steps:Object.freeze([...this._steps])})}}
+"use strict";import{CaptureType as n}from"../../../../core/models/ml_config";import{DocumentCaptureMode as i}from"../../../../core/models/document_capture_mode";export{n as CaptureType};export class ConsentConfigBuilder{partnerName="";partnerIcon;partnerPrivacyPolicyUrl;onConsentGranted;allowButton;denyButton}export class InstructionsConfigBuilder{titlePrefix;titleEmphasis;heroAnimation;guidelinesSectionTitle;guidelines=[];showHeroOval=!0;continueButton}export class SelfieCaptureConfigBuilder{allowAgentMode=!1;enableEnhancedLiveness=!1}export class DocumentCaptureConfigBuilder{documentType;captureMode=i.AutoCaptureWithManualFallback();allowGalleryUpload=!1;allowSkipBack=!1;knownIdAspectRatio;_captureBothSides;get captureBothSides(){return this._captureBothSides??this.documentType?.kind!=="passport"}set captureBothSides(e){this._captureBothSides=e}get resolvedAspectRatio(){return this.documentType?.knownAspectRatio??this.knownIdAspectRatio}}export class CaptureConfigBuilder{captureType;startButton;_selfie;_document;selfie(e){this._selfie||(this._selfie=new SelfieCaptureConfigBuilder),e(this._selfie)}document(e){this._document||(this._document=new DocumentCaptureConfigBuilder),e(this._document)}get selfieConfig(){return this._selfie}get documentConfig(){return this._document}}export class PreviewConfigBuilder{allowRetake=!0}export class ProcessingConfigBuilder{showProgressPercentage=!0;continueButton;retryButton;exitButton}export class ScreensBuilder{_steps=[];consent(e){const t=new ConsentConfigBuilder;e?.(t),this._steps.push({kind:"consent",config:t})}instructions(e){const t=new InstructionsConfigBuilder;e?.(t),this._steps.push({kind:"instructions",config:t})}capture(e){const t=new CaptureConfigBuilder;e(t),this._steps.push({kind:"capture",config:t})}preview(e){const t=new PreviewConfigBuilder;e?.(t),this._steps.push({kind:"preview",config:t})}processing(e){const t=new ProcessingConfigBuilder;e?.(t),this._steps.push({kind:"processing",config:t})}build(){return Object.freeze({steps:Object.freeze([...this._steps])})}}

package/dist/presentation/flow/dsl/use_smile_id_flow_builder.d.ts

@@ -2,7 +2,7 @@ import type { ConfigOptions } from "../../../core/models/config";
 import type { ThemeConfiguration } from "./builder/theme_builder";
 import type { NetworkConfig } from "../../../core/models/network_config";
 import type { MLConfig } from "../../../core/models/ml_config";
-import type { ConsentInformation, EnhancedKYCParams, BiometricKYCParams, DocumentVerificationParams, EnhancedDocumentVerificationParams, UserDetails } from "../../../core/models/params";
+import type { ConsentInformation, EnhancedKYCParams, BiometricKYCParams, DocumentVerificationParams, EnhancedDocumentVerificationParams, ResidencyDocumentVerificationParams, UserDetails } from "../../../core/models/params";
 import type { UseSmileIDAnalyticsEvent } from "../analytics/use_smile_id_analytics_event";
 import type { JobSubmissionResponse } from "../../../data/model/job_submission_response";
 import type { UseSmileIDResult } from "../../../core/models/result";
@@ -39,6 +39,11 @@ export declare class UseSmileIDFlowBuilder {
     documentVerificationParams?: DocumentVerificationParams;
     /** Optional. Required only for `JobType.enhancedDocumentVerification`. */
     enhancedDocumentVerificationParams?: EnhancedDocumentVerificationParams;
+    /**
+     * Identity fields required for a Residency Document Verification job. Must be
+     * set when the network config specifies `JobType.residencyDocumentVerification`.
+     */
+    residencyDocumentVerificationParams?: ResidencyDocumentVerificationParams;
     /**
      * Required for any job that submits the `user_details` multipart
      * part — `JobType.enhancedKyc`, `JobType.biometricKyc`,
@@ -143,18 +148,8 @@ export declare class UseSmileIDFlowBuilder {
     /**
      * Runs a pre-flight check of the current builder configuration and
      * returns a `ValidationState` describing any blocking issues, without
-     * throwing. Today the only rule it surfaces is the empty-screens-block
-     * error — `b.screens` must register at least one screen before the
-     * builder can produce a flow.
-     *
-     * The full rule set (screen ordering, dependency rules, KYC and
-     * consent payload validation, etc.) runs inside `build()` and is
-     * reflected in the [FlowBuildResult] surface; partners that want
-     * the full picture during configuration should call
-     * `useSmileIDBuilder(...)` and pattern-match on the returned
-     * `result.kind`.
-     *
-     * @returns a `ValidationState` describing any blocking issues.
+     * throwing. Checks the screens and their own settings; job-level rules
+     * run only in `build()`.
      */
     validate(): ValidationState;
     /**
@@ -188,6 +183,14 @@ export declare class UseSmileIDFlowBuilder {
      * `country` and `idType` are required.
      */
     validateEnhancedDocumentVerificationParams(params: EnhancedDocumentVerificationParams): ValidationState;
+    /**
+     * Validates a `ResidencyDocumentVerificationParams` payload in
+     * isolation and returns a `ValidationState`, without throwing. Both
+     * `country` and `idType` are required, and `idType` must be `"PASSPORT"`,
+     * the one value the backend accepts, so this pre-check agrees with
+     * `build()`.
+     */
+    validateResidencyDocumentVerificationParams(params: ResidencyDocumentVerificationParams): ValidationState;
     /**
      * Validates a `UserDetails` payload in isolation and returns a
      * `ValidationState`, without throwing. Useful when the partner pulls
@@ -253,6 +256,7 @@ export type FlowConfigurationSnapshot = {
     readonly biometricKYCParams?: BiometricKYCParams;
     readonly documentVerificationParams?: DocumentVerificationParams;
     readonly enhancedDocumentVerificationParams?: EnhancedDocumentVerificationParams;
+    readonly residencyDocumentVerificationParams?: ResidencyDocumentVerificationParams;
     readonly userDetails?: UserDetails;
     readonly userId?: string;
     readonly config?: ConfigOptions;

package/dist/presentation/flow/dsl/use_smile_id_flow_builder.js

@@ -1 +1 @@
-"use strict";import{UseSmileIDConfigBuilder as l}from"./builder/config_builder";import{ThemeConfigBuilder as d}from"./builder/theme_builder";import{UseSmileIDNetworkBuilder as u}from"../../../data/dsl/use_smile_id_network_builder";import{UseSmileIDMLBuilder as h}from"./builder/ml_builder";import{ScreensBuilder as f}from"./builder/screens_builder";import{IssueSeverity as P}from"../../../core/exception/issue_severity";import{runBiometricKYCParamsValidation as v,runBuilderValidation as D,runConsentValidation as V,runDocumentVerificationParamsValidation as _,runEnhancedDocumentVerificationParamsValidation as g,runEnhancedKYCParamsValidation as w,runFlowValidation as C,runUserDetailsValidation as I}from"../validation/flow_validator";import{ValidationState as n}from"../validation/validation_state";import{decodeSmileIDToken as K}from"../../../data/util/use_smile_id_token_decoder";export class UseSmileIDFlowBuilder{consentInformation;enhancedKYCParams;biometricKYCParams;documentVerificationParams;enhancedDocumentVerificationParams;userDetails;userId;localizations;onResult=()=>{};onAnalyticsEvent;_config;_theme;_network;_ml;_screens;config(i){this._config||(this._config=new l),i(this._config)}theme(i){this._theme=new d,i(this._theme)}network(i){this._network=new u,i(this._network)}ml(i){this._ml||(this._ml=new h),i(this._ml)}screens(i){this._screens||(this._screens=new f),i(this._screens)}validate(){return n.invalid(D(this._screens?.build().steps??[]))}validateConsent(i){return n.invalid(V(i))}validateEnhancedKYCParams(i){return n.invalid(w(i))}validateBiometricKYCParams(i){return n.invalid(v(i))}validateDocumentVerificationParams(i){return n.invalid(_(i))}validateEnhancedDocumentVerificationParams(i){return n.invalid(g(i))}validateUserDetails(i){return n.invalid(I(i))}build(){const i=this._screens?.build(),e=this._network?.build(),a=this._ml?.build(),s=this._config?.build(),m=Y(s?.allowOfflineMode,e),o=C({steps:i?.steps??[],network:e,ml:a,consentInformation:this.consentInformation,enhancedKYCParams:this.enhancedKYCParams,biometricKYCParams:this.biometricKYCParams,documentVerificationParams:this.documentVerificationParams,enhancedDocumentVerificationParams:this.enhancedDocumentVerificationParams,userDetails:this.userDetails,userId:this.userId,tokenPayload:m}),c=n.invalid(o);if(!c.valid)return{kind:"invalid",validation:c};for(const t of o)t.severity===P.warning&&(console.warn(`[UseSmileIDFlowBuilder] ${t.message}`),t.suggestedFix&&console.warn(`[UseSmileIDFlowBuilder] Suggested fix: ${t.suggestedFix}`));if(!i)throw new Error("UseSmileIDFlowBuilder: internal invariant violated \u2014 screens missing after validation passed.");return{kind:"success",configuration:Object.freeze({...this.consentInformation?{consentInformation:this.consentInformation}:{},...this.enhancedKYCParams?{enhancedKYCParams:this.enhancedKYCParams}:{},...this.biometricKYCParams?{biometricKYCParams:this.biometricKYCParams}:{},...this.documentVerificationParams?{documentVerificationParams:this.documentVerificationParams}:{},...this.enhancedDocumentVerificationParams?{enhancedDocumentVerificationParams:this.enhancedDocumentVerificationParams}:{},...this.userDetails?{userDetails:this.userDetails}:{},...this.userId?{userId:this.userId}:{},...s?{config:s}:{},...this._theme?{theme:this._theme.build()}:{},...e?{network:e}:{},...a?{ml:a}:{},screens:i,...this.localizations?{localizations:this.localizations}:{},onResult:this.onResult,...this.onAnalyticsEvent?{onAnalyticsEvent:this.onAnalyticsEvent}:{}})}}}function Y(r,i){if(r)return;const e=i?.config?.token;if(!(!e||e.length===0))return K(e)?.tokenPayload}
+"use strict";import{RESIDENCY_ID_TYPE as d}from"../../../core/models/params";import{UseSmileIDConfigBuilder as l}from"./builder/config_builder";import{ThemeConfigBuilder as u}from"./builder/theme_builder";import{UseSmileIDNetworkBuilder as h}from"../../../data/dsl/use_smile_id_network_builder";import{UseSmileIDMLBuilder as f}from"./builder/ml_builder";import{ScreensBuilder as P}from"./builder/screens_builder";import{IssueSeverity as D}from"../../../core/exception/issue_severity";import{runBiometricKYCParamsValidation as V,runBuilderValidation as v,runConsentValidation as _,runDocumentVerificationParamsValidation as I,runEnhancedDocumentVerificationParamsValidation as g,runEnhancedKYCParamsValidation as w,runFlowValidation as y,runResidencyDocumentVerificationParamsValidation as C,runUserDetailsValidation as p}from"../validation/flow_validator";import{ValidationState as n}from"../validation/validation_state";import{residencyIdTypeIssue as Y}from"../validation/job_type_validator";import{decodeSmileIDToken as K}from"../../../data/util/use_smile_id_token_decoder";export class UseSmileIDFlowBuilder{consentInformation;enhancedKYCParams;biometricKYCParams;documentVerificationParams;enhancedDocumentVerificationParams;residencyDocumentVerificationParams;userDetails;userId;localizations;onResult=()=>{};onAnalyticsEvent;_config;_theme;_network;_ml;_screens;config(i){this._config||(this._config=new l),i(this._config)}theme(i){this._theme=new u,i(this._theme)}network(i){this._network=new h,i(this._network)}ml(i){this._ml||(this._ml=new f),i(this._ml)}screens(i){this._screens||(this._screens=new P),i(this._screens)}validate(){return n.invalid(v(this._screens?.build().steps??[]))}validateConsent(i){return n.invalid(_(i))}validateEnhancedKYCParams(i){return n.invalid(w(i))}validateBiometricKYCParams(i){return n.invalid(V(i))}validateDocumentVerificationParams(i){return n.invalid(I(i))}validateEnhancedDocumentVerificationParams(i){return n.invalid(g(i))}validateResidencyDocumentVerificationParams(i){const e=i.idType.trim()!==""&&i.idType!==d?[Y()]:[];return n.invalid([...C(i),...e])}validateUserDetails(i){return n.invalid(p(i))}build(){const i=this._screens?.build(),e=this._network?.build(),a=this._ml?.build(),s=this._config?.build(),m=k(s?.allowOfflineMode,e),o=y({steps:i?.steps??[],network:e,ml:a,consentInformation:this.consentInformation,enhancedKYCParams:this.enhancedKYCParams,biometricKYCParams:this.biometricKYCParams,documentVerificationParams:this.documentVerificationParams,enhancedDocumentVerificationParams:this.enhancedDocumentVerificationParams,residencyDocumentVerificationParams:this.residencyDocumentVerificationParams,userDetails:this.userDetails,userId:this.userId,tokenPayload:m}),c=n.invalid(o);if(!c.valid)return{kind:"invalid",validation:c};for(const t of o)t.severity===D.warning&&(console.warn(`[UseSmileIDFlowBuilder] ${t.message}`),t.suggestedFix&&console.warn(`[UseSmileIDFlowBuilder] Suggested fix: ${t.suggestedFix}`));if(!i)throw new Error("UseSmileIDFlowBuilder: internal invariant violated \u2014 screens missing after validation passed.");return{kind:"success",configuration:Object.freeze({...this.consentInformation?{consentInformation:this.consentInformation}:{},...this.enhancedKYCParams?{enhancedKYCParams:this.enhancedKYCParams}:{},...this.biometricKYCParams?{biometricKYCParams:this.biometricKYCParams}:{},...this.documentVerificationParams?{documentVerificationParams:this.documentVerificationParams}:{},...this.enhancedDocumentVerificationParams?{enhancedDocumentVerificationParams:this.enhancedDocumentVerificationParams}:{},...this.residencyDocumentVerificationParams?{residencyDocumentVerificationParams:this.residencyDocumentVerificationParams}:{},...this.userDetails?{userDetails:this.userDetails}:{},...this.userId?{userId:this.userId}:{},...s?{config:s}:{},...this._theme?{theme:this._theme.build()}:{},...e?{network:e}:{},...a?{ml:a}:{},screens:i,...this.localizations?{localizations:this.localizations}:{},onResult:this.onResult,...this.onAnalyticsEvent?{onAnalyticsEvent:this.onAnalyticsEvent}:{}})}}}function k(r,i){if(r)return;const e=i?.config?.token;if(!(!e||e.length===0))return K(e)?.tokenPayload}