@smileid/usesmileid 12.1.0 → 12.2.0

package/dist/data/model/token_payload.d.ts

@@ -9,6 +9,9 @@ export declare const tokenPayloadSchema: z.ZodObject<{
     last_name: z.ZodCatch<z.ZodOptional<z.ZodString>>;
     email: z.ZodCatch<z.ZodOptional<z.ZodString>>;
     phone_number: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    country: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    id_type: z.ZodCatch<z.ZodOptional<z.ZodString>>;
+    id_number: z.ZodCatch<z.ZodOptional<z.ZodString>>;
     consent: z.ZodCatch<z.ZodOptional<z.ZodObject<{
         granted: z.ZodCatch<z.ZodOptional<z.ZodLiteral<true>>>;
         granted_at: z.ZodCatch<z.ZodOptional<z.ZodString>>;
@@ -37,7 +40,8 @@ export type TokenConsent = {
  * Presence flags for the identity fields the token binds, parsed from
  * the `payload` claim. A flag is `true` iff the claim carries the key
  * with a non-empty string value (the value itself is an opaque vault
- * reference — the server injects the real value at submission).
+ * reference — the server injects the real value at submission, and
+ * rejects a request whose body contradicts it).
  */
 export type TokenPayload = {
     readonly hasGivenNames: boolean;
@@ -45,6 +49,10 @@ export type TokenPayload = {
     readonly hasEmail: boolean;
     readonly hasPhoneNumber: boolean;
     readonly consent?: TokenConsent;
+    /** Absent reads as not bound, as does `false`. */
+    readonly hasCountry?: boolean;
+    readonly hasIdType?: boolean;
+    readonly hasIdNumber?: boolean;
 };
 /**
  * Parse a raw `payload` claim value into a `TokenPayload`, or
@@ -53,6 +61,14 @@ export type TokenPayload = {
  * unknown keys, and degrades wrong-typed fields to absent.
  */
 export declare function parseTokenPayload(rawClaim: unknown): TokenPayload | undefined;
+/** The params key of an ID field a token can bind. */
+export type TokenBoundIdField = "country" | "idType" | "idNumber";
+/**
+ * Whether the token binds the ID field named by its params key. The one
+ * rule both validation (a bound field may be blank) and request assembly
+ * (a bound field is never sent) read, so the two cannot disagree.
+ */
+export declare function isIdFieldBoundByToken(payload: TokenPayload | undefined, field: TokenBoundIdField): boolean;
 /**
  * Token consent is COMPLETE when `granted` is `true` and every other
  * subfield is non-blank. A complete binding — granted with every

package/dist/data/model/token_payload.js

@@ -1 +1 @@
-"use strict";import{z as t}from"zod";const u=t.object({granted:t.literal(!0).optional().catch(void 0),granted_at:t.string().optional().catch(void 0),notice_language:t.string().optional().catch(void 0),notice_privacy_policy_url:t.string().optional().catch(void 0)});export const tokenPayloadSchema=t.object({given_names:t.string().optional().catch(void 0),last_name:t.string().optional().catch(void 0),email:t.string().optional().catch(void 0),phone_number:t.string().optional().catch(void 0),consent:u.optional().catch(void 0)});export function parseTokenPayload(n){if(n===null||typeof n!="object"||Array.isArray(n))return;const e=tokenPayloadSchema.safeParse(n);if(!e.success)return;const i=e.data,a=s(i.consent);return{hasGivenNames:r(i.given_names),hasLastName:r(i.last_name),hasEmail:r(i.email),hasPhoneNumber:r(i.phone_number),...a!==void 0?{consent:a}:{}}}export function isTokenConsentComplete(n){return n!==void 0&&tokenConsentMissingSubfields(n).length===0}export function tokenConsentMissingSubfields(n){const e=[];return n.granted!==!0&&e.push("granted"),o(n.grantedAt)||e.push("granted_at"),o(n.noticeLanguage)||e.push("notice_language"),o(n.noticePrivacyPolicyUrl)||e.push("notice_privacy_policy_url"),e}export function bindsRequiredUserDetails(n){return n===void 0?!1:n.hasGivenNames&&n.hasLastName&&(n.hasEmail||n.hasPhoneNumber)}function s(n){if(n===void 0)return;const e={...n.granted===!0?{granted:!0}:{},...n.granted_at!==void 0?{grantedAt:n.granted_at}:{},...n.notice_language!==void 0?{noticeLanguage:n.notice_language}:{},...n.notice_privacy_policy_url!==void 0?{noticePrivacyPolicyUrl:n.notice_privacy_policy_url}:{}};return Object.keys(e).length>0?e:void 0}function r(n){return n!==void 0&&n.length>0}function o(n){return n!==void 0&&n.trim().length>0}
+"use strict";import{z as t}from"zod";const a=t.object({granted:t.literal(!0).optional().catch(void 0),granted_at:t.string().optional().catch(void 0),notice_language:t.string().optional().catch(void 0),notice_privacy_policy_url:t.string().optional().catch(void 0)});export const tokenPayloadSchema=t.object({given_names:t.string().optional().catch(void 0),last_name:t.string().optional().catch(void 0),email:t.string().optional().catch(void 0),phone_number:t.string().optional().catch(void 0),country:t.string().optional().catch(void 0),id_type:t.string().optional().catch(void 0),id_number:t.string().optional().catch(void 0),consent:a.optional().catch(void 0)});export function parseTokenPayload(n){if(n===null||typeof n!="object"||Array.isArray(n))return;const e=tokenPayloadSchema.safeParse(n);if(!e.success)return;const i=e.data,u=s(i.consent);return{hasGivenNames:r(i.given_names),hasLastName:r(i.last_name),hasEmail:r(i.email),hasPhoneNumber:r(i.phone_number),...u!==void 0?{consent:u}:{},hasCountry:r(i.country),hasIdType:r(i.id_type),hasIdNumber:r(i.id_number)}}export function isIdFieldBoundByToken(n,e){switch(e){case"country":return n?.hasCountry===!0;case"idType":return n?.hasIdType===!0;case"idNumber":return n?.hasIdNumber===!0}}export function isTokenConsentComplete(n){return n!==void 0&&tokenConsentMissingSubfields(n).length===0}export function tokenConsentMissingSubfields(n){const e=[];return n.granted!==!0&&e.push("granted"),o(n.grantedAt)||e.push("granted_at"),o(n.noticeLanguage)||e.push("notice_language"),o(n.noticePrivacyPolicyUrl)||e.push("notice_privacy_policy_url"),e}export function bindsRequiredUserDetails(n){return n===void 0?!1:n.hasGivenNames&&n.hasLastName&&(n.hasEmail||n.hasPhoneNumber)}function s(n){if(n===void 0)return;const e={...n.granted===!0?{granted:!0}:{},...n.granted_at!==void 0?{grantedAt:n.granted_at}:{},...n.notice_language!==void 0?{noticeLanguage:n.notice_language}:{},...n.notice_privacy_policy_url!==void 0?{noticePrivacyPolicyUrl:n.notice_privacy_policy_url}:{}};return Object.keys(e).length>0?e:void 0}function r(n){return n!==void 0&&n.length>0}function o(n){return n!==void 0&&n.trim().length>0}

package/dist/data/repository/use_smile_id_repository_impl.js

@@ -1 +1 @@
-"use strict";import{failure as s,success as m}from"../../core/models/result";import{JobType as a}from"../../core/models/job_type";import{withRetry as l}from"../util/retry_util";import{InvalidFieldValueException as f}from"../../core/exception/job_validation_exceptions";import{UseSmileIDValidationException as p}from"../../core/exception/use_smile_id_validation_exception";import{mapAxiosError as d}from"../../core/exception/use_smile_id_network_exception";import{PayloadCompressionRunner as c}from"../compression/payload_compression_runner";function _(r){const e=[],i=(t,n)=>{n!==void 0&&n>0&&e.push({name:t,value:String(n)})};return i("selfie_original_size",r.selfieOriginalMb),i("selfie_final_compressed_size",r.selfieFinalMb),i("document_front_original_size",r.frontOriginalMb),i("document_front_final_compressed_size",r.frontFinalMb),i("document_back_original_size",r.backOriginalMb),i("document_back_final_compressed_size",r.backFinalMb),e}export class UseSmileIDRepositoryImpl{_api;_retry;constructor(e,i){this._api=e,this._retry=i}async submit(e,i){if(e.jobType===a.bvn)return s(new f({fieldName:"jobType",reason:"BVN submission is not yet supported"}));let t=e;try{const n=await this._compressPayload(e,i),o=n?_(n):[];o.length>0&&(t={...e,metadata:e.metadata.withAdditionalEntries(o)})}catch{}try{const n=await l(this._retry,o=>this._dispatch(t,o));return m(n)}catch(n){return n instanceof p?s(n):s(this._mapError(n))}}async _compressPayload(e,i){const t=JSON.stringify(e.metadata.toEntries()).length;switch(e.jobType){case a.smartSelfieEnrollment:case a.smartSelfieAuthentication:case a.biometricKyc:return c.compress({selfieImage:e.selfieImage,livenessImages:e.livenessImages,metadataBytes:t,sdkConfig:i});case a.documentVerification:case a.enhancedDocumentVerification:return c.compress({selfieImage:e.selfieImage,livenessImages:e.livenessImages,frontDocument:e.frontDocument,backDocument:e.backDocument,metadataBytes:t,sdkConfig:i});default:return}}_dispatch(e,i){const t=i>0?{...e,metadata:e.metadata.withAdditionalEntries([{name:"network_retries",value:String(i)}])}:e;switch(t.jobType){case a.smartSelfieEnrollment:return this._api.smartSelfieEnrollment(t);case a.smartSelfieAuthentication:return this._api.smartSelfieAuthentication(t);case a.enhancedKyc:return this._api.enhancedKyc(t);case a.biometricKyc:return this._api.biometricKyc(t);case a.documentVerification:return this._api.documentVerification(t);case a.enhancedDocumentVerification:return this._api.enhancedDocumentVerification(t)}}_mapError(e){return d(e)}}
+"use strict";import{failure as s,success as m}from"../../core/models/result";import{JobType as t}from"../../core/models/job_type";import{withRetry as l}from"../util/retry_util";import{InvalidFieldValueException as f}from"../../core/exception/job_validation_exceptions";import{UseSmileIDValidationException as p}from"../../core/exception/use_smile_id_validation_exception";import{mapAxiosError as d}from"../../core/exception/use_smile_id_network_exception";import{PayloadCompressionRunner as c}from"../compression/payload_compression_runner";function _(r){const e=[],i=(n,a)=>{a!==void 0&&a>0&&e.push({name:n,value:String(a)})};return i("selfie_original_size",r.selfieOriginalMb),i("selfie_final_compressed_size",r.selfieFinalMb),i("document_front_original_size",r.frontOriginalMb),i("document_front_final_compressed_size",r.frontFinalMb),i("document_back_original_size",r.backOriginalMb),i("document_back_final_compressed_size",r.backFinalMb),i("document_visa_original_size",r.visaOriginalMb),i("document_visa_final_compressed_size",r.visaFinalMb),e}export class UseSmileIDRepositoryImpl{_api;_retry;constructor(e,i){this._api=e,this._retry=i}async submit(e,i){if(e.jobType===t.bvn)return s(new f({fieldName:"jobType",reason:"BVN submission is not yet supported"}));let n=e;try{const a=await this._compressPayload(e,i),o=a?_(a):[];o.length>0&&(n={...e,metadata:e.metadata.withAdditionalEntries(o)})}catch{}try{const a=await l(this._retry,o=>this._dispatch(n,o));return m(a)}catch(a){return a instanceof p?s(a):s(this._mapError(a))}}async _compressPayload(e,i){const n=JSON.stringify(e.metadata.toEntries()).length;switch(e.jobType){case t.smartSelfieEnrollment:case t.smartSelfieAuthentication:case t.biometricKyc:return c.compress({selfieImage:e.selfieImage,livenessImages:e.livenessImages,metadataBytes:n,sdkConfig:i});case t.documentVerification:case t.enhancedDocumentVerification:return c.compress({selfieImage:e.selfieImage,livenessImages:e.livenessImages,frontDocument:e.frontDocument,backDocument:e.backDocument,metadataBytes:n,sdkConfig:i});case t.residencyDocumentVerification:return c.compress({selfieImage:e.selfieImage,livenessImages:e.livenessImages,frontDocument:e.frontDocument,visaDocument:e.visaDocument,metadataBytes:n,sdkConfig:i});default:return}}_dispatch(e,i){const n=i>0?{...e,metadata:e.metadata.withAdditionalEntries([{name:"network_retries",value:String(i)}])}:e;switch(n.jobType){case t.smartSelfieEnrollment:return this._api.smartSelfieEnrollment(n);case t.smartSelfieAuthentication:return this._api.smartSelfieAuthentication(n);case t.enhancedKyc:return this._api.enhancedKyc(n);case t.biometricKyc:return this._api.biometricKyc(n);case t.documentVerification:return this._api.documentVerification(n);case t.enhancedDocumentVerification:return this._api.enhancedDocumentVerification(n);case t.residencyDocumentVerification:return this._api.residencyDocumentVerification(n)}}_mapError(e){return d(e)}}

package/dist/debug/capture_debug_geometry.d.ts

@@ -0,0 +1,29 @@
+import type { BoundingBox } from "@smileid/usesmileid_bridge";
+import type { DebugRect, DebugSize } from "./selfie_preview_debug_geometry";
+/**
+ * Where the capture debug overlay draws a detected box. The detector normalises
+ * each box against the upright analysis frame, and the preview covers its view
+ * with that frame, centred, so a box lands where the same cover fit puts it.
+ *
+ * `frameAspect` is the upright frame's width over its height: kamera binds the
+ * analysis stream to the preview's aspect ratio, so the preview's ratio is the
+ * frame's. `mirrored` flips the box across the view's vertical centre, for a
+ * preview mirrored against the analysed frame. `null` when either size is
+ * degenerate.
+ */
+export declare function captureDebugViewRect(box: Pick<BoundingBox, "left" | "top" | "width" | "height">, frameAspect: number, viewSize: DebugSize, mirrored: boolean): DebugRect | null;
+/**
+ * Whether the front lens's boxes must be flipped to land on the preview. The
+ * preview shows the front lens mirrored on both platforms. On iOS the Vision
+ * plugin analyses the frame in its mirrored orientation, so the boxes are
+ * already in the preview's space; on Android the detector sees the unmirrored
+ * frame, as the Android SDK's overlay assumes, so its boxes are flipped.
+ */
+export declare function captureDebugBoxesMirrored(frontLens: boolean, isAndroid: boolean): boolean;
+/**
+ * The upright analysis frame's width over its height on the document capture
+ * screen, whose `streamAspect` is the camera stream's ratio (either way up).
+ * The frame is upright in the orientation the screen is locked to, so its long
+ * side runs along the view's long side. `null` when either is degenerate.
+ */
+export declare function documentDebugFrameAspect(streamAspect: number, viewSize: DebugSize): number | null;

package/dist/debug/capture_debug_geometry.js

@@ -0,0 +1 @@
+"use strict";export function captureDebugViewRect(t,n,h,d){if(n<=0||h.width<=0||h.height<=0)return null;const u=Math.max(h.width/n,h.height),o=n*u,r=u,i=(h.width-o)/2,l=(h.height-r)/2,g=i+t.left*o,c=t.width*o;return{left:d?h.width-(g+c):g,top:l+t.top*r,width:c,height:t.height*r}}export function captureDebugBoxesMirrored(t,n){return t&&n}export function documentDebugFrameAspect(t,n){if(t<=0||n.width<=0||n.height<=0)return null;const h=Math.max(t,1/t);return n.width>=n.height?h:1/h}

package/dist/debug/document_preview_debug_geometry.d.ts

@@ -0,0 +1,36 @@
+import type { DebugRect, DebugSize } from "./selfie_preview_debug_geometry";
+/** The saved image and its interior, in the card's coordinate space. */
+export type DocumentPreviewInPlaceGeometry = {
+    readonly frameRect: DebugRect;
+    readonly plannedInteriorRect: DebugRect;
+};
+/** The saved image, its interior and the card window the user sees, in panel coordinates. */
+export type DocumentPreviewPanelGeometry = DocumentPreviewInPlaceGeometry & {
+    readonly visibleCardRect: DebugRect;
+};
+/**
+ * Pure geometry for the document preview screen's debug overlay, the document's
+ * twin of `SelfiePreviewDebugGeometry`.
+ *
+ * The preview draws a document at `DocumentInteriorCrop.cardScale` into its
+ * rounded card: the interior inside the border it was saved with, grown by the
+ * auto-capture slack, fits the card, so the rest of the border never reaches
+ * the user. A document saved with no border covers the card whole. These helpers compute where the saved image, the card
+ * the user sees and the interior land: in the card's own coordinates for the
+ * in-place marking (`inPlace`), and in a fit-scaled thumbnail's for the
+ * full-image panel (`panel`).
+ */
+export declare const DocumentPreviewDebugGeometry: {
+    /**
+     * Maps the saved image onto a `cardSize` card the way the production layout
+     * does, at `DocumentInteriorCrop.cardScale`, centred. `null` when either size
+     * is degenerate.
+     */
+    readonly inPlace: (imageSize: DebugSize, cardSize: DebugSize, borderFraction: number) => DocumentPreviewInPlaceGeometry | null;
+    /**
+     * Lays the whole saved image out inside a `panelSize` panel the way `contain`
+     * would, and maps the interior and the card window the preview shows into the
+     * same panel coordinates. `null` when any size is degenerate.
+     */
+    readonly panel: (imageSize: DebugSize, cardSize: DebugSize, panelSize: DebugSize, borderFraction: number) => DocumentPreviewPanelGeometry | null;
+};

package/dist/debug/document_preview_debug_geometry.js

@@ -0,0 +1 @@
+"use strict";import{DocumentInteriorCrop as u}from"../presentation/components/helpers/document_interior_crop";export const DocumentPreviewDebugGeometry={inPlace(t,h,n){if(c(t)||c(h))return null;const r=u.cardScale(t,h,n),o=f(h.width/2,h.height/2,t.width*r,t.height*r);return{frameRect:o,plannedInteriorRect:d(o,w(t,n)*r)}},panel(t,h,n,r){if(c(t)||c(h)||c(n))return null;const o=Math.min(n.width/t.width,n.height/t.height),e=f(n.width/2,n.height/2,t.width*o,t.height*o),l=u.cardScale(t,h,r);return{frameRect:e,plannedInteriorRect:d(e,w(t,r)*o),visibleCardRect:f(n.width/2,n.height/2,h.width/l*o,h.height/l*o)}}};function w(t,h){return Math.min(Math.max(h,0),u.fullBorderFraction)*Math.min(t.width,t.height)}function f(t,h,n,r){return{left:t-n/2,top:h-r/2,width:n,height:r}}function d(t,h){return{left:t.left+h,top:t.top+h,width:t.width-2*h,height:t.height-2*h}}function c(t){return t.width<=0||t.height<=0}

package/dist/debug/preview_debug_drawing.d.ts

@@ -0,0 +1,51 @@
+import type { DebugRect } from "./selfie_preview_debug_geometry";
+/** Dashed outline of the planned interior. */
+export declare function PlannedBoundary(props: {
+    readonly rect: DebugRect;
+}): import("react").JSX.Element;
+export declare function rectPath(rect: DebugRect): string;
+/** The border ring: the frame with the planned interior punched out (even-odd). */
+export declare function ringPath(frameRect: DebugRect, plannedInteriorRect: DebugRect): string;
+export declare const PANEL_WIDTH = 120;
+export declare const BOUNDARY_STROKE = 1.5;
+/** Red A400 at ~35%: captured pixels the planned interior crop would hide. */
+export declare const BORDER_RING_FILL = "rgba(255, 23, 68, 0.35)";
+export declare const PLANNED_BOUNDARY_COLOR = "#FF1744";
+/** Green A400: the boundary of what the user can see. */
+export declare const VISIBLE_BOUNDARY_COLOR = "#00E676";
+/** Pixels the preview screen never shows (outside the visible region / crop off-cuts). */
+export declare const HIDDEN_TODAY_DIM = "rgba(0, 0, 0, 0.4)";
+export declare const debugPreviewStyles: {
+    hudAnchor: {
+        position: "absolute";
+        start: number;
+    };
+    hud: {
+        backgroundColor: string;
+        borderRadius: number;
+        paddingHorizontal: number;
+        paddingVertical: number;
+        gap: number;
+        alignItems: "flex-start";
+    };
+    hudHeader: {
+        flexDirection: "row";
+        alignItems: "center";
+        gap: number;
+    };
+    hudChevron: {
+        paddingHorizontal: number;
+        paddingVertical: number;
+        borderRadius: number;
+    };
+    hudText: {
+        color: string;
+        fontSize: number;
+        fontFamily: string;
+    };
+    panel: {
+        borderWidth: number;
+        borderColor: string;
+        overflow: "hidden";
+    };
+};

package/dist/debug/preview_debug_drawing.js

@@ -0,0 +1 @@
+"use strict";import{jsx as i}from"react/jsx-runtime";import{Platform as d,StyleSheet as c}from"react-native";import{Rect as l}from"react-native-svg";export function PlannedBoundary(t){return i(l,{x:t.rect.left,y:t.rect.top,width:t.rect.width,height:t.rect.height,fill:"none",stroke:PLANNED_BOUNDARY_COLOR,strokeWidth:BOUNDARY_STROKE,strokeDasharray:`${r},${r}`})}export function rectPath(t){const{left:e,top:n,width:o,height:a}=t;return`M${e},${n} h${o} v${a} h${-o} Z`}export function ringPath(t,e){return`${rectPath(t)} ${rectPath(e)}`}export const PANEL_WIDTH=120,BOUNDARY_STROKE=1.5;const r=5;export const BORDER_RING_FILL="rgba(255, 23, 68, 0.35)",PLANNED_BOUNDARY_COLOR="#FF1744",VISIBLE_BOUNDARY_COLOR="#00E676",HIDDEN_TODAY_DIM="rgba(0, 0, 0, 0.4)",debugPreviewStyles=c.create({hudAnchor:{position:"absolute",start:8},hud:{backgroundColor:"rgba(0, 0, 0, 0.55)",borderRadius:6,paddingHorizontal:8,paddingVertical:4,gap:6,alignItems:"flex-start"},hudHeader:{flexDirection:"row",alignItems:"center",gap:8},hudChevron:{paddingHorizontal:6,paddingVertical:2,borderRadius:4},hudText:{color:"#FFFFFF",fontSize:11,fontFamily:d.select({ios:"Menlo",default:"monospace"})},panel:{borderWidth:1,borderColor:"rgba(255, 255, 255, 0.7)",overflow:"hidden"}});

package/dist/debug/selfie_preview_debug_geometry.d.ts

@@ -0,0 +1,55 @@
+/** A width × height in layout units (or image pixels). */
+export type DebugSize = {
+    readonly width: number;
+    readonly height: number;
+};
+/** An axis-aligned rect: top-left corner plus size. */
+export type DebugRect = {
+    readonly left: number;
+    readonly top: number;
+    readonly width: number;
+    readonly height: number;
+};
+/** Frame and planned-interior rects in the oval box's coordinate space. */
+export type SelfiePreviewInPlaceGeometry = {
+    readonly frameRect: DebugRect;
+    readonly plannedInteriorRect: DebugRect;
+};
+/** Frame, planned-interior, and user-visible ellipse bounds in panel coordinates. */
+export type SelfiePreviewPanelGeometry = {
+    readonly frameRect: DebugRect;
+    readonly plannedInteriorRect: DebugRect;
+    readonly visibleOvalRect: DebugRect;
+};
+/**
+ * Pure geometry for the selfie preview-screen debug overlay.
+ *
+ * The preview screen draws the captured selfie at
+ * `SelfieInteriorCrop.coverScale` into an oval-sized box and clips it to an
+ * ellipse: the frame's interior covers the box, so the border ring never
+ * reaches the user. These helpers compute where the full frame, the ellipse
+ * the user actually sees, and the interior crop land — in the oval box's
+ * coordinate space for the in-place marking (`inPlace`) and in a fit-scaled
+ * thumbnail's coordinate space for the full-frame panel (`panel`).
+ *
+ * Only the debug overlay uses it; it never shapes what users see.
+ */
+export declare const SelfiePreviewDebugGeometry: {
+    readonly plannedBorderFraction: 0.15;
+    /**
+     * Maps the captured frame onto the preview screen the way the production
+     * layout does — `SelfieInteriorCrop.coverScale` centred in the oval box: the
+     * uniform scale at which the interior covers the box, centred. Returns `null`
+     * when either size is degenerate.
+     */
+    readonly inPlace: (imageSize: DebugSize, ovalRect: DebugRect) => SelfiePreviewInPlaceGeometry | null;
+    /**
+     * Lays the full frame out inside a panel the way contain scaling would
+     * (uniform contain scale, centred) and maps the planned interior plus the
+     * ellipse the preview screen shows — the centre window, shaped like the oval
+     * box, that the interior crop leaves visible — into the same panel
+     * coordinates.
+     * Returns `null` when any size is degenerate.
+     */
+    readonly panel: (imageSize: DebugSize, ovalSize: DebugSize, panelSize: DebugSize) => SelfiePreviewPanelGeometry | null;
+};

package/dist/debug/selfie_preview_debug_geometry.js

@@ -0,0 +1 @@
+"use strict";import{SelfieInteriorCrop as d}from"../presentation/components/helpers/selfie_interior_crop";const f=d.borderFraction;export const SelfiePreviewDebugGeometry={plannedBorderFraction:f,inPlace(t,h){if(e(t)||e(h))return null;const n=d.coverScale(t,h),r=c(u(h),{width:t.width*n,height:t.height*n});return{frameRect:r,plannedInteriorRect:l(r,w(t)*n)}},panel(t,h,n){if(e(t)||e(h)||e(n))return null;const r=Math.min(n.width/t.width,n.height/t.height),o=c({x:n.width/2,y:n.height/2},{width:t.width*r,height:t.height*r}),i=d.coverScale(t,h);return{frameRect:o,plannedInteriorRect:l(o,w(t)*r),visibleOvalRect:c(u(o),{width:h.width/i*r,height:h.height/i*r})}}};function w(t){return f*Math.min(t.width,t.height)}function u(t){return{x:t.left+t.width/2,y:t.top+t.height/2}}function c(t,h){return{left:t.x-h.width/2,top:t.y-h.height/2,width:h.width,height:h.height}}function l(t,h){return{left:t.left+h,top:t.top+h,width:t.width-2*h,height:t.height-2*h}}function e(t){return t.width<=0||t.height<=0}

package/dist/debug/use_smile_id_debug.d.ts

@@ -0,0 +1,61 @@
+type Listener = () => void;
+/**
+ * Debug hook state the SDK's screens subscribe to, so toggling a switch
+ * redraws a screen that is already on display. Not part of the public API.
+ */
+export declare const UseSmileIDDebugHooks: {
+    /** Whether the selfie capture and preview screens draw their debug overlays. */
+    readonly isSelfiePreviewOverlayEnabled: () => boolean;
+    /** Sets the flag and notifies subscribers; ungated, for tests and the public setter. */
+    readonly setSelfiePreviewOverlayEnabled: (enabled: boolean) => void;
+    /** Whether the document capture and preview screens draw their debug overlays. */
+    readonly isDocumentPreviewOverlayEnabled: () => boolean;
+    /** Sets the flag and notifies subscribers; ungated, for tests and the public setter. */
+    readonly setDocumentPreviewOverlayEnabled: (enabled: boolean) => void;
+    readonly subscribe: (listener: Listener) => () => void;
+};
+/**
+ * Developer-only switches for the SDK's debug visualisations.
+ *
+ * Inert in release builds: the setter returns early unless the bundler's
+ * `__DEV__` is true, so the overlays can never be switched on in a shipped app.
+ */
+export declare const UseSmileIDDebug: {
+    /**
+     * Installs or clears the selfie debug overlays. When enabled, the selfie
+     * capture screen draws the detector's face boxes over the preview with a
+     * detection HUD (the detector's frame rate, face count, brightness), as on
+     * Android, and the post-capture selfie preview screen marks which parts of
+     * the captured frame the user cannot see, plus the planned interior-crop
+     * boundary, in red.
+     *
+     * Safe to call at any time (e.g. from a switch); the change applies to the
+     * next — and any currently shown — selfie capture or preview screen.
+     */
+    readonly setSelfieDebugOverlaysEnabled: (enabled: boolean) => void;
+    /** Whether the selfie debug overlays are currently installed. */
+    readonly isSelfieDebugOverlaysEnabled: () => boolean;
+    /**
+     * Installs or clears the document debug overlays. When enabled, the document
+     * capture screen draws the detected document boxes over the preview (the one
+     * the capture gate judges in green) with a detection HUD (detections per
+     * second, document count, the gated box's score and brightness), as on
+     * Android, and the document preview screen marks the saved document's hidden
+     * border in red, the interior the card shows as a dashed outline and the
+     * card in green, with a full-image panel behind the chevron. The card shows
+     * the interior alone, so no red should appear inside it.
+     *
+     * Safe to call at any time; the change applies to the next, and any
+     * currently shown, document capture or preview screen.
+     */
+    readonly setDocumentDebugOverlaysEnabled: (enabled: boolean) => void;
+    /** Whether the document debug overlays are currently installed. */
+    readonly isDocumentDebugOverlaysEnabled: () => boolean;
+};
+/** Subscribes a component to the selfie preview overlay flag. */
+export declare function useSelfiePreviewOverlayEnabled(): boolean;
+/** Subscribes a component to the document overlays flag. */
+export declare function useDocumentPreviewOverlayEnabled(): boolean;
+/** Whether this is a dev build, where the debug overlays can switch on. @internal */
+export declare function isDevBuild(): boolean;
+export {};

package/dist/debug/use_smile_id_debug.js

@@ -0,0 +1 @@
+"use strict";import{useSyncExternalStore as t}from"react";let n=!1,i=!1;const r=new Set;export const UseSmileIDDebugHooks={isSelfiePreviewOverlayEnabled(){return n},setSelfiePreviewOverlayEnabled(e){n!==e&&(n=e,r.forEach(l=>l()))},isDocumentPreviewOverlayEnabled(){return i},setDocumentPreviewOverlayEnabled(e){i!==e&&(i=e,r.forEach(l=>l()))},subscribe(e){return r.add(e),()=>r.delete(e)}},UseSmileIDDebug={setSelfieDebugOverlaysEnabled(e){isDevBuild()&&UseSmileIDDebugHooks.setSelfiePreviewOverlayEnabled(e)},isSelfieDebugOverlaysEnabled(){return UseSmileIDDebugHooks.isSelfiePreviewOverlayEnabled()},setDocumentDebugOverlaysEnabled(e){isDevBuild()&&UseSmileIDDebugHooks.setDocumentPreviewOverlayEnabled(e)},isDocumentDebugOverlaysEnabled(){return UseSmileIDDebugHooks.isDocumentPreviewOverlayEnabled()}};export function useSelfiePreviewOverlayEnabled(){return t(UseSmileIDDebugHooks.subscribe,UseSmileIDDebugHooks.isSelfiePreviewOverlayEnabled,UseSmileIDDebugHooks.isSelfiePreviewOverlayEnabled)}export function useDocumentPreviewOverlayEnabled(){return t(UseSmileIDDebugHooks.subscribe,UseSmileIDDebugHooks.isDocumentPreviewOverlayEnabled,UseSmileIDDebugHooks.isDocumentPreviewOverlayEnabled)}export function isDevBuild(){return typeof __DEV__<"u"&&__DEV__}

package/dist/debug/use_smile_id_debug_tap.d.ts

@@ -0,0 +1,25 @@
+import type { DocumentDetectorOutput, FaceDetectorOutput } from "@smileid/usesmileid_bridge";
+type FaceListener = (output: FaceDetectorOutput) => void;
+type DocumentListener = (output: DocumentDetectorOutput) => void;
+/**
+ * What the capture debug overlays read off the capture loop in a dev build:
+ * the detector output of each analysed frame. Android's counterpart is
+ * `UseSmileIDDebugHooks.sink`. Not part of the public API.
+ *
+ * The frame stream calls `analyzedFace` and `analyzedDocument` only in a dev
+ * build; with nothing listening each costs a null check.
+ */
+export declare const UseSmileIDDebugTap: {
+    /**
+     * Installs `listener`, replacing any earlier one, and returns the function
+     * that stops it. An overlay leaving the screen can then only clear its own
+     * listener, never one a newer overlay installed before the old one's cleanup
+     * ran.
+     */
+    readonly listenToFaces: (listener: FaceListener) => () => void;
+    /** The document twin of `listenToFaces`, for the document capture overlay. */
+    readonly listenToDocuments: (listener: DocumentListener) => () => void;
+    readonly analyzedFace: (output: FaceDetectorOutput) => void;
+    readonly analyzedDocument: (output: DocumentDetectorOutput) => void;
+};
+export {};

package/dist/debug/use_smile_id_debug_tap.js

@@ -0,0 +1 @@
+"use strict";let n=null,l=null;export const UseSmileIDDebugTap={listenToFaces(e){return n=e,()=>{n===e&&(n=null)}},listenToDocuments(e){return l=e,()=>{l===e&&(l=null)}},analyzedFace(e){n?.(e)},analyzedDocument(e){l?.(e)}};

package/dist/debug/use_smile_id_document_capture_debug_overlay.d.ts

@@ -0,0 +1,56 @@
+import type { DocumentDetectorOutput } from "@smileid/usesmileid_bridge";
+export type DocumentCaptureDebugOverlayProps = {
+    /** The camera stream's ratio, either way up; see `documentDebugFrameAspect`. */
+    readonly streamAspect: number;
+    /** Whether each box is flipped to land on the preview; see `captureDebugBoxesMirrored`. */
+    readonly mirrorBoxes: boolean;
+    /** The overlay's clock, in milliseconds, read at mount; `Date.now` when omitted. */
+    readonly now?: () => number;
+};
+/** One detection the overlay shows, and when it arrived on the overlay's clock. */
+export type DocumentCaptureDebugFrame = {
+    readonly output: DocumentDetectorOutput;
+    readonly detectedAtMs: number;
+};
+/** How often the detection rate is sampled, as on Android. */
+export declare const DOCUMENT_CAPTURE_DEBUG_SAMPLE_INTERVAL_MS = 500;
+/**
+ * How long a detection stays up without a new one: longer than the native
+ * document analyzers' 350 ms detection interval, between which they report
+ * empty outputs.
+ */
+export declare const DOCUMENT_CAPTURE_DEBUG_HOLD_MS = 500;
+/**
+ * The frame the overlay shows after `output` arrives at `nowMs`. A detection
+ * replaces it; an empty output, which the analyzer reports between its
+ * detection runs, clears it only once the shown detection is older than
+ * `DOCUMENT_CAPTURE_DEBUG_HOLD_MS`, so the box stays up between runs and goes
+ * once the document is lost.
+ */
+export declare function nextDocumentCaptureDebugFrame(previous: DocumentCaptureDebugFrame | null, output: DocumentDetectorOutput, nowMs: number): DocumentCaptureDebugFrame | null;
+/**
+ * `frame` while it is younger than `DOCUMENT_CAPTURE_DEBUG_HOLD_MS` at
+ * `nowMs`, else `null`. The sampler applies it too, so a detection expires
+ * when the analyzer stops reporting, as when the capture finishes.
+ */
+export declare function documentCaptureDebugFrameStillShown(frame: DocumentCaptureDebugFrame | null, nowMs: number): DocumentCaptureDebugFrame | null;
+/**
+ * Draws `UseSmileIDDocumentCaptureDebugOverlay` over the document capture
+ * screen while `UseSmileIDDebug.setDocumentDebugOverlaysEnabled(true)` is in
+ * effect, and nothing otherwise. Subscribes to the hook state, so the switch
+ * applies to a screen already on display.
+ */
+export declare function DocumentCaptureDebugOverlayHost(props: DocumentCaptureDebugOverlayProps): import("react").JSX.Element | null;
+/**
+ * Developer overlay over the document capture screen, the document's twin of
+ * `UseSmileIDSelfieCaptureDebugOverlay`, as on Android: the detected document
+ * boxes drawn where the preview shows them (the first, the one the capture
+ * gate judges, in green; any others in yellow), and a HUD with the detections
+ * per second, the document count, the gated box's score and its brightness.
+ * Display-only: it reads the capture loop's own output through
+ * `UseSmileIDDebugTap`.
+ *
+ * Android's HUD also shows the camera's frame rate. kamera keeps every frame
+ * native, so JavaScript never sees one to count.
+ */
+export declare function UseSmileIDDocumentCaptureDebugOverlay(props: DocumentCaptureDebugOverlayProps): import("react").JSX.Element;

package/dist/debug/use_smile_id_document_capture_debug_overlay.js

@@ -0,0 +1 @@
+"use strict";import{jsx as t,jsxs as y}from"react/jsx-runtime";import{useEffect as P,useRef as E,useState as b}from"react";import{Platform as R,Pressable as L,StyleSheet as w,Text as u,View as h}from"react-native";import{useSafeAreaInsets as U}from"react-native-safe-area-context";import{captureDebugViewRect as M,documentDebugFrameAspect as H}from"./capture_debug_geometry";import{useDocumentPreviewOverlayEnabled as N}from"./use_smile_id_debug";import{UseSmileIDDebugTap as V}from"./use_smile_id_debug_tap";import{SelfiePreviewDebugHud as j}from"./use_smile_id_selfie_preview_debug_overlay";export const DOCUMENT_CAPTURE_DEBUG_SAMPLE_INTERVAL_MS=500,DOCUMENT_CAPTURE_DEBUG_HOLD_MS=500;export function nextDocumentCaptureDebugFrame(e,n,i){return n.documents.length>0?{output:n,detectedAtMs:i}:documentCaptureDebugFrameStillShown(e,i)}export function documentCaptureDebugFrameStillShown(e,n){return e!==null&&n-e.detectedAtMs<DOCUMENT_CAPTURE_DEBUG_HOLD_MS?e:null}export function DocumentCaptureDebugOverlayHost(e){return N()?t(UseSmileIDDocumentCaptureDebugOverlay,{...e}):null}export function UseSmileIDDocumentCaptureDebugOverlay(e){const n=U(),[i,g]=b(null),[v,A]=b(0),[x,O]=b(!0),[a,B]=b(null),p=E(0),S=E(e.now??Date.now);P(()=>{const s=V.listenToDocuments(l=>{l.documents.length>0&&(p.current+=1);const m=S.current();g(_=>nextDocumentCaptureDebugFrame(_,l,m))});let r=Date.now();const c=setInterval(()=>{const l=Date.now(),m=(l-r)/1e3;r=l;const _=p.current;p.current=0,A(m>0?_/m:0);const I=S.current();g(T=>documentCaptureDebugFrameStillShown(T,I))},DOCUMENT_CAPTURE_DEBUG_SAMPLE_INTERVAL_MS);return()=>{s(),clearInterval(c)}},[]);const C=s=>{const{width:r,height:c}=s.nativeEvent.layout;B({width:r,height:c})},D=i?.output??null,d=D?.documents??[],f=a?H(e.streamAspect,a):null;return y(h,{pointerEvents:"box-none",style:w.absoluteFill,onLayout:C,testID:"si_debug_document_capture_overlay",children:[x&&a&&f!==null?d.map((s,r)=>{const c=M(s,f,a,e.mirrorBoxes);return c?t(h,{pointerEvents:"none",testID:"si_debug_document_capture_box",style:[o.box,r===0?o.gatedBox:o.otherBox,c]},r):null}):null,t(h,{style:[o.hudAnchor,{bottom:n.bottom+8}],testID:"si_debug_document_capture_hud",children:t(j,{title:"DETECTION",children:y(h,{children:[t(u,{style:o.stat,children:`Detections/s: ${v.toFixed(1)}`}),t(u,{style:o.stat,children:`Documents: ${d.length}`}),t(u,{style:o.stat,children:`Score: ${d[0]?d[0].score.toFixed(2):"\u2014"}`}),t(u,{style:o.stat,children:`Brightness: ${D?D.brightness.toFixed(0):"\u2014"}`}),t(L,{accessibilityRole:"button",testID:"si_debug_document_capture_box_toggle",onPress:()=>O(s=>!s),hitSlop:8,children:t(u,{style:[o.stat,o.toggle],children:x?"Hide box":"Show box"})})]})})})]})}const F="#00E676",$="#FFEA00",o=w.create({hudAnchor:{position:"absolute",start:8},box:{position:"absolute",borderWidth:2},gatedBox:{borderColor:F},otherBox:{borderColor:$},stat:{color:"#FFFFFF",fontSize:11,fontFamily:R.select({ios:"Menlo",default:"monospace"})},toggle:{color:F,marginTop:4}});

package/dist/debug/use_smile_id_document_preview_debug_overlay.d.ts

@@ -0,0 +1,32 @@
+import type { DebugSize } from "./selfie_preview_debug_geometry";
+export type UseSmileIDDocumentPreviewDebugOverlayProps = {
+    /** Local file URI of the captured document the preview screen shows. */
+    readonly uri: string;
+    /** The saved document's upright pixel size; the panel waits for it. */
+    readonly imageSize: DebugSize | null;
+    /** The card's laid-out size, in the preview screen's layout units. */
+    readonly cardSize: DebugSize;
+    /** The hidden border the document was saved with, as a fraction of its short side. */
+    readonly borderFraction: number;
+};
+/**
+ * Developer overlay for the document preview screen: the saved document's
+ * hidden border, the interior the card shows and the card itself, over a
+ * full-image panel behind the chevron (top start). Drawn by the preview screen
+ * while `UseSmileIDDebug.setDocumentDebugOverlaysEnabled(true)` is in effect;
+ * the card draws the in-place marking (`DocumentPreviewHiddenRegionsInPlace`).
+ *
+ * Display-only: it reads the already-captured file and the card's laid-out
+ * size; it never alters what the preview shows or what is uploaded.
+ */
+export declare function UseSmileIDDocumentPreviewDebugOverlay(props: UseSmileIDDocumentPreviewDebugOverlayProps): import("react").JSX.Element;
+/**
+ * In-place marking over the card: red on any visible pixel the hidden border
+ * covers (there should be none), the planned interior dashed and the card, the
+ * boundary of what the user sees, in green.
+ */
+export declare function DocumentPreviewHiddenRegionsInPlace(props: {
+    readonly imageSize: DebugSize;
+    readonly cardSize: DebugSize;
+    readonly borderFraction: number;
+}): import("react").JSX.Element | null;

package/dist/debug/use_smile_id_document_preview_debug_overlay.js

@@ -0,0 +1 @@
+"use strict";import{jsx as i,jsxs as d}from"react/jsx-runtime";import{useId as v}from"react";import{Image as I,StyleSheet as n,View as o}from"react-native";import{useSafeAreaInsets as b}from"react-native-safe-area-context";import h,{ClipPath as S,Defs as y,Path as c,Rect as a}from"react-native-svg";import{DocumentPreviewDebugGeometry as s}from"./document_preview_debug_geometry";import{BORDER_RING_FILL as u,BOUNDARY_STROKE as m,HIDDEN_TODAY_DIM as P,PANEL_WIDTH as g,PlannedBoundary as _,VISIBLE_BOUNDARY_COLOR as f,debugPreviewStyles as w,rectPath as R,ringPath as D}from"./preview_debug_drawing";import{SelfiePreviewDebugHud as p}from"./use_smile_id_selfie_preview_debug_overlay";export function UseSmileIDDocumentPreviewDebugOverlay(t){const r=b();return i(o,{pointerEvents:"box-none",style:n.absoluteFill,testID:"si_debug_document_preview_overlay",children:i(o,{style:[w.hudAnchor,{top:r.top+8}],children:i(p,{title:"DOCUMENT",children:i(z,{...t})})})})}export function DocumentPreviewHiddenRegionsInPlace(t){const r=`si_debug_card_clip_${v().replace(/:/g,"")}`,l=s.inPlace(t.imageSize,t.cardSize,t.borderFraction);if(!l)return null;const e={left:0,top:0,width:t.cardSize.width,height:t.cardSize.height};return d(h,{width:"100%",height:"100%",style:n.absoluteFill,testID:"si_debug_document_preview_in_place",children:[i(y,{children:i(S,{id:r,children:i(a,{x:0,y:0,width:e.width,height:e.height})})}),i(c,{d:D(l.frameRect,l.plannedInteriorRect),fill:u,fillRule:"evenodd",clipPath:`url(#${r})`}),i(_,{rect:l.plannedInteriorRect}),i(a,{x:e.left,y:e.top,width:e.width,height:e.height,fill:"none",stroke:f,strokeWidth:m})]})}function z(t){const r=t.imageSize?t.imageSize.width/t.imageSize.height:x,l={width:g,height:g/r},e=t.imageSize?s.panel(t.imageSize,t.cardSize,l,t.borderFraction):null;return d(o,{style:[w.panel,l],testID:"si_debug_document_preview_panel",children:[i(I,{source:{uri:t.uri},resizeMode:"contain",style:n.absoluteFill}),e?d(h,{width:l.width,height:l.height,style:n.absoluteFill,testID:"si_debug_document_preview_panel_markings",children:[i(c,{d:`${R(e.frameRect)} ${R(e.visibleCardRect)}`,fill:P,fillRule:"evenodd"}),i(c,{d:D(e.frameRect,e.plannedInteriorRect),fill:u,fillRule:"evenodd"}),i(_,{rect:e.plannedInteriorRect}),i(a,{x:e.visibleCardRect.left,y:e.visibleCardRect.top,width:e.visibleCardRect.width,height:e.visibleCardRect.height,fill:"none",stroke:f,strokeWidth:m})]}):null]})}const x=1.586;

package/dist/debug/use_smile_id_selfie_capture_debug_overlay.d.ts

@@ -0,0 +1,27 @@
+export type SelfieCaptureDebugOverlayProps = {
+    /** The upright analysis frame's width over its height. */
+    readonly frameAspect: number;
+    /** Whether each box is flipped to land on the mirrored preview; see `captureDebugBoxesMirrored`. */
+    readonly mirrorBoxes: boolean;
+};
+/** How often the frame rate is sampled, as on Android. */
+export declare const SELFIE_CAPTURE_DEBUG_SAMPLE_INTERVAL_MS = 500;
+/**
+ * Draws `UseSmileIDSelfieCaptureDebugOverlay` over the selfie capture screen
+ * while `UseSmileIDDebug.setSelfieDebugOverlaysEnabled(true)` is in effect, and
+ * nothing otherwise. Subscribes to the hook state, so the switch applies to a
+ * screen already on display.
+ */
+export declare function SelfieCaptureDebugOverlayHost(props: SelfieCaptureDebugOverlayProps): import("react").JSX.Element | null;
+/**
+ * Developer overlay over the selfie capture screen, as on Android: the
+ * detector's face boxes drawn where the preview shows those faces, and a HUD
+ * with the detector's frame rate, the face count and the largest face's
+ * brightness. Display-only: it reads the capture loop's own output through
+ * `UseSmileIDDebugTap`.
+ *
+ * Android's HUD also shows the camera's frame rate. kamera keeps every frame
+ * native, so JavaScript never sees one to count; the detector rate is the rate
+ * the capture loop analyses at.
+ */
+export declare function UseSmileIDSelfieCaptureDebugOverlay(props: SelfieCaptureDebugOverlayProps): import("react").JSX.Element;

package/dist/debug/use_smile_id_selfie_capture_debug_overlay.js

@@ -0,0 +1 @@
+"use strict";import{jsx as e,jsxs as _}from"react/jsx-runtime";import{useEffect as w,useRef as L,useState as i}from"react";import{Platform as A,Pressable as P,StyleSheet as g,Text as c,View as a}from"react-native";import{useSafeAreaInsets as T}from"react-native-safe-area-context";import{captureDebugViewRect as B}from"./capture_debug_geometry";import{useSelfiePreviewOverlayEnabled as O}from"./use_smile_id_debug";import{UseSmileIDDebugTap as R}from"./use_smile_id_debug_tap";import{SelfiePreviewDebugHud as C}from"./use_smile_id_selfie_preview_debug_overlay";export const SELFIE_CAPTURE_DEBUG_SAMPLE_INTERVAL_MS=500;export function SelfieCaptureDebugOverlayHost(r){return O()?e(UseSmileIDSelfieCaptureDebugOverlay,{...r}):null}export function UseSmileIDSelfieCaptureDebugOverlay(r){const f=T(),[u,x]=i(null),[y,D]=i(0),[b,F]=i(!0),[h,E]=i(null),d=L(0);w(()=>{const t=R.listenToFaces(l=>{d.current+=1,x(l)});let o=Date.now();const n=setInterval(()=>{const l=Date.now(),m=(l-o)/1e3;o=l;const I=d.current;d.current=0,D(m>0?I/m:0)},SELFIE_CAPTURE_DEBUG_SAMPLE_INTERVAL_MS);return()=>{t(),clearInterval(n)}},[]);const v=t=>{const{width:o,height:n}=t.nativeEvent.layout;E({width:o,height:n})},p=u?.faces??[];return _(a,{pointerEvents:"box-none",style:g.absoluteFill,onLayout:v,testID:"si_debug_selfie_capture_overlay",children:[b&&h?p.map((t,o)=>{const n=B(t,r.frameAspect,h,r.mirrorBoxes);return n?e(a,{pointerEvents:"none",testID:"si_debug_selfie_capture_box",style:[s.box,n]},o):null}):null,e(a,{style:[s.hudAnchor,{top:f.top+8}],testID:"si_debug_selfie_capture_hud",children:e(C,{title:"DETECTION",children:_(a,{children:[e(c,{style:s.stat,children:`Detector FPS: ${y.toFixed(1)}`}),e(c,{style:s.stat,children:`Faces: ${p.length}`}),e(c,{style:s.stat,children:`Brightness: ${u&&p.length>0?u.brightness.toFixed(0):"\u2014"}`}),e(P,{accessibilityRole:"button",testID:"si_debug_selfie_capture_box_toggle",onPress:()=>F(t=>!t),hitSlop:8,children:e(c,{style:[s.stat,s.toggle],children:b?"Hide box":"Show box"})})]})})})]})}const S="#00E676",s=g.create({hudAnchor:{position:"absolute",end:8},box:{position:"absolute",borderWidth:2,borderColor:S},stat:{color:"#FFFFFF",fontSize:11,fontFamily:A.select({ios:"Menlo",default:"monospace"})},toggle:{color:S,marginTop:4}});

package/dist/debug/use_smile_id_selfie_preview_debug_overlay.d.ts

@@ -0,0 +1,60 @@
+import { type ReactNode } from "react";
+import { type DebugRect, type DebugSize } from "./selfie_preview_debug_geometry";
+export type UseSmileIDSelfiePreviewDebugOverlayProps = {
+    /** Local file URI of the captured selfie the preview screen shows. */
+    readonly uri: string;
+    /** The laid-out oval box, in this overlay's coordinate space. */
+    readonly ovalRect: DebugRect;
+};
+/**
+ * Developer overlay for the post-capture selfie preview screen: shows which
+ * parts of the captured frame the user cannot see, and where the interior crop
+ * lands. The preview shows the interior alone, so no red should appear inside
+ * the oval. Drawn by the preview screen while
+ * `UseSmileIDDebug.setSelfieDebugOverlaysEnabled(true)` is in effect.
+ *
+ * Two synchronised views share `SelfiePreviewDebugGeometry`:
+ * - In place, over the production preview: red tint on every visible pixel
+ *   that falls inside the planned border ring, a dashed outline where the
+ *   planned interior crop lands (drawn unclipped so its full extent shows
+ *   against the surrounding wash), and a green stroke on the oval — the
+ *   boundary of what the user can see.
+ * - A full-frame panel (top start, collapsible behind the chevron): the whole
+ *   captured file fit-scaled, with the regions the preview never shows dimmed,
+ *   the planned border ring tinted red, and the same dashed / green
+ *   boundaries.
+ *
+ * Display-only: it reads the already-captured file and the screen's laid-out
+ * oval geometry; it never alters what the production preview shows or what is
+ * uploaded. The frame's pixel size is read once from the file, so the in-place
+ * marking stays correct while the panel is collapsed.
+ */
+export declare function UseSmileIDSelfiePreviewDebugOverlay(props: UseSmileIDSelfiePreviewDebugOverlayProps): import("react").JSX.Element;
+/**
+ * In-place marking drawn over the production preview image: red on the
+ * visible pixels the planned crop would remove, dashed planned-crop boundary,
+ * green visible-boundary stroke. Coordinates match the preview's oval box.
+ */
+export declare function SelfiePreviewHiddenRegionsInPlace(props: {
+    readonly imageSize: DebugSize;
+    readonly ovalRect: DebugRect;
+}): import("react").JSX.Element | null;
+/**
+ * Markings over the full-frame panel: everything outside the user-visible
+ * ellipse dimmed, the planned border ring tinted red, and the two boundary
+ * strokes.
+ */
+export declare function SelfiePreviewPanelMarkings(props: {
+    readonly imageSize: DebugSize;
+    readonly ovalSize: DebugSize;
+    readonly panelSize: DebugSize;
+}): import("react").JSX.Element | null;
+/**
+ * Collapsible heads-up display chrome: dark rounded background, the title
+ * header and an expand/collapse chevron. `children` render only while
+ * expanded.
+ */
+export declare function SelfiePreviewDebugHud(props: {
+    readonly title: string;
+    readonly children: ReactNode;
+}): import("react").JSX.Element;

package/dist/debug/use_smile_id_selfie_preview_debug_overlay.js

@@ -0,0 +1 @@
+"use strict";import{jsx as i,jsxs as a}from"react/jsx-runtime";import{useEffect as b,useId as w,useState as f}from"react";import{Image as D,Pressable as x,StyleSheet as d,Text as g,View as o}from"react-native";import{useSafeAreaInsets as p}from"react-native-safe-area-context";import m,{ClipPath as E,Defs as $,Ellipse as c,Path as h}from"react-native-svg";import{decodeUprightImageSize as A}from"../presentation/components/helpers/selfie_interior_crop";import{SelfiePreviewDebugGeometry as S}from"./selfie_preview_debug_geometry";import{BORDER_RING_FILL as _,BOUNDARY_STROKE as v,HIDDEN_TODAY_DIM as F,PANEL_WIDTH as R,PlannedBoundary as y,VISIBLE_BOUNDARY_COLOR as I,debugPreviewStyles as O,rectPath as T,ringPath as P}from"./preview_debug_drawing";export function UseSmileIDSelfiePreviewDebugOverlay(e){const t=p(),[l,n]=f(null);return b(()=>{let s=!0;return A(e.uri).then(z=>{s&&n(z)}),()=>{s=!1}},[e.uri]),a(o,{pointerEvents:"box-none",style:d.absoluteFill,testID:"si_debug_selfie_preview_overlay",children:[l?i(o,{pointerEvents:"none",style:d.absoluteFill,children:i(SelfiePreviewHiddenRegionsInPlace,{imageSize:l,ovalRect:e.ovalRect})}):null,i(o,{style:[r.hudAnchor,{top:t.top+8}],children:i(SelfiePreviewDebugHud,{title:"FRAME",children:i(L,{uri:e.uri,imageSize:l,ovalSize:e.ovalRect})})})]})}export function SelfiePreviewHiddenRegionsInPlace(e){const t=`si_debug_oval_clip_${w().replace(/:/g,"")}`,l=S.inPlace(e.imageSize,e.ovalRect);if(!l)return null;const n=e.ovalRect;return a(m,{width:"100%",height:"100%",testID:"si_debug_selfie_preview_in_place",children:[i($,{children:i(E,{id:t,children:i(c,{...u(n)})})}),i(h,{d:P(l.frameRect,l.plannedInteriorRect),fill:_,fillRule:"evenodd",clipPath:`url(#${t})`}),i(y,{rect:l.plannedInteriorRect}),i(c,{...u(n),fill:"none",stroke:I,strokeWidth:v})]})}export function SelfiePreviewPanelMarkings(e){const t=S.panel(e.imageSize,e.ovalSize,e.panelSize);if(!t)return null;const l=t.visibleOvalRect;return a(m,{width:e.panelSize.width,height:e.panelSize.height,style:d.absoluteFill,testID:"si_debug_selfie_preview_panel_markings",children:[i(h,{d:`${T(t.frameRect)} ${k(l)}`,fill:F,fillRule:"evenodd"}),i(h,{d:P(t.frameRect,t.plannedInteriorRect),fill:_,fillRule:"evenodd"}),i(y,{rect:t.plannedInteriorRect}),i(c,{...u(l),fill:"none",stroke:I,strokeWidth:v})]})}export function SelfiePreviewDebugHud(e){const[t,l]=f(!0);return a(o,{style:r.hud,children:[a(o,{style:r.hudHeader,children:[t?i(g,{style:r.hudText,children:e.title}):null,i(x,{accessibilityRole:"button",testID:"si_debug_hud_toggle",onPress:()=>l(n=>!n),hitSlop:8,style:r.hudChevron,children:i(g,{style:r.hudText,children:t?"\u25B2":"\u25BC"})})]}),t?e.children:null]})}function L(e){const t=e.imageSize?e.imageSize.width/e.imageSize.height:N,l={width:R,height:R/t};return a(o,{style:[r.panel,l],testID:"si_debug_selfie_preview_panel",children:[i(D,{source:{uri:e.uri},resizeMode:"contain",style:d.absoluteFill}),e.imageSize?i(SelfiePreviewPanelMarkings,{imageSize:e.imageSize,ovalSize:e.ovalSize,panelSize:l}):null]})}function u(e){return{cx:e.left+e.width/2,cy:e.top+e.height/2,rx:e.width/2,ry:e.height/2}}function k(e){const{cx:t,cy:l,rx:n,ry:s}=u(e);return`M${t-n},${l} a${n},${s} 0 1,0 ${2*n},0 a${n},${s} 0 1,0 ${-2*n},0 Z`}const N=3/4,r=O;

package/dist/index.d.ts

@@ -8,6 +8,7 @@
  */
 export { UseSmileIDBuilder } from "./presentation/flow/dsl/use_smile_id_builder";
 export { UseSmileIDFlowBuilder } from "./presentation/flow/dsl/use_smile_id_flow_builder";
+export type { FlowBuildResult, FlowBuildResultInvalid, FlowBuildResultSuccess, } from "./presentation/flow/dsl/flow_build_result";
 export { ValidationState, type ValidationIssue, type ValidationStateInvalid, } from "./presentation/flow/validation/validation_state";
 export { AgentModeWithEnhancedLivenessException, BuilderValidationException, isNetworkErrorCode, isRetryableErrorCode, ConsentDeniedException, DuplicateScreenTypeException, EmptyScreensBlockException, InvalidConsentConfigException, InvalidConsentInformationException, InvalidDocumentCaptureConfigException, InvalidFieldValueException, InvalidJobTypeScreenConfigException, InvalidMissingCaptureTypeException, InvalidScreenOrderException, InvalidSelfieCaptureConfigException, LivenessFrameCountException, IssueSeverity, MissingCaptureForPreviewException, MissingJobTypeException, MissingMLConfigurationBlockException, MissingNetworkConfigurationBlockException, MissingPartnerConfigException, MissingRequiredFieldException, ProcessingCancelledException, UseSmileIDAttestationException, UseSmileIDBuilderException, UseSmileIDCameraException, UseSmileIDCameraSurfaceException, UseSmileIDErrorCode, UseSmileIDException, UseSmileIDGeneralException, UnusedJobParamsException, UseSmileIDNetworkException, type UseSmileIDNetworkErrorCode, UseSmileIDValidationException, } from "./core/exception";
 export { UseSmileIDConfigBuilder } from "./presentation/flow/dsl/builder/config_builder";
@@ -30,6 +31,7 @@ export { OrchestratedCaptureScreen, type OrchestratedCaptureScreenProps, } from
 export { OrchestratedPreviewScreen, type OrchestratedPreviewScreenProps, } from "./presentation/flow/screen/orchestrated_preview_screen";
 export { OrchestratedProcessingScreen, type OrchestratedProcessingScreenProps, } from "./presentation/flow/screen/orchestrated_processing_screen";
 export { UseSmileIDCrashReporting } from "@smileid/usesmileid_bridge";
+export { DocumentSide } from "@smileid/usesmileid_bridge";
 export { UseSmileIDLocalizations } from "./l10n/use_smile_id_localizations";
 export { UseSmileIDLocalizationsProvider, useStableLocalizations, useUseSmileIDLocalizations, type UseSmileIDLocalizationsProviderProps, } from "./l10n/use_smile_id_localizations_provider";
 export { enStrings, type SiKey } from "./l10n/strings_en";
@@ -51,8 +53,12 @@ export { GlobalPrivacyControl, GLOBAL_PRIVACY_CONTROL_WIRE_KEY, globalPrivacyCon
 export { LogLevel } from "./core/models/network_config";
 export type { CacheConfig, Interceptor, NetworkConfig, NetworkInnerConfig, NetworkLoggingConfig, PartnerConfig, RetryConfig, TimeoutConfig, } from "./core/models/network_config";
 export type { AnalyzerRegistry, MLConfig } from "./core/models/ml_config";
-export type { BiometricKYCParams, ConsentInformation, DocumentVerificationParams, EnhancedDocumentVerificationParams, EnhancedKYCParams, Timestamp, UserDetails, } from "./core/models/params";
+export type { BiometricKYCParams, ConsentInformation, DocumentVerificationParams, EnhancedDocumentVerificationParams, ResidencyDocumentVerificationParams, EnhancedKYCParams, Timestamp, UserDetails, } from "./core/models/params";
+export { RESIDENCY_ID_TYPE } from "./core/models/params";
 export type { UseSmileIDAnalyticsEvent, UseSmileIDAnalyticsEventType, } from "./presentation/flow/analytics/use_smile_id_analytics_event";
+export { UseSmileIDAnalyticsEventTypes, UseSmileIDAnalyticsParamKeys, UseSmileIDAnalyticsReasons, UseSmileIDAnalyticsScreenNames, } from "./presentation/flow/analytics/use_smile_id_analytics_event";
+export { analyticsEventKind } from "./presentation/flow/analytics/use_smile_id_analytics_event_kind";
+export type { UseSmileIDAnalyticsEventKind, UseSmileIDAnalyticsScreenName, } from "./presentation/flow/analytics/use_smile_id_analytics_event_kind";
 export type { JobSubmissionResponse } from "./data/model/job_submission_response";
 export { type DecodedToken, decodeSmileIDToken, } from "./data/util/use_smile_id_token_decoder";
 export { type SdkConfig, numSamplesOverride } from "./data/model/sdk_config";
@@ -111,3 +117,4 @@ export { UseSmileIDPreviewScreen, type UseSmileIDPreviewScreenProps, } from "./p
 export { UseSmileIDProcessingScreen, type ProcessingState, type UseSmileIDProcessingScreenProps, } from "./presentation/screen/use_smile_id_processing_screen";
 export { ForceMaxBrightness } from "./presentation/utils/force_max_brightness";
 export type { ForceMaxBrightnessProps } from "./presentation/utils/force_max_brightness";
+export { UseSmileIDDebug } from "./debug/use_smile_id_debug";