@sekyro/web 0.1.0-rc.17 → 0.1.0-rc.19

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (56) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/README.md +1 -2
  3. package/dist/{capture-session-doc-TATPATSZ.js → capture-session-doc-VXWWQEP4.js} +1 -1
  4. package/dist/{capture-session-v3-Dxus1Se9.d.ts → capture-session-v3-CFSVWYzi.d.ts} +13 -2
  5. package/dist/{capture-session-v3-DyUA2uCL.d.cts → capture-session-v3-Cs4yV3HJ.d.cts} +13 -2
  6. package/dist/chunk-4GJXUVZK.js +1 -0
  7. package/dist/chunk-5Y3UST3W.js +1 -0
  8. package/dist/chunk-64V55KD7.js +1 -0
  9. package/dist/chunk-6K4D3U6Q.js +1 -0
  10. package/dist/chunk-CQ7SKLMC.js +1 -0
  11. package/dist/{chunk-TWB4LTCE.js → chunk-JUEOHNVW.js} +1 -1
  12. package/dist/chunk-L45YTRJJ.js +1 -0
  13. package/dist/chunk-PLH6ZR6J.js +1 -0
  14. package/dist/chunk-RNJA5GDF.js +1 -0
  15. package/dist/chunk-ZO6IHP2I.js +1 -0
  16. package/dist/chunk-ZPXL26BF.js +1 -0
  17. package/dist/client/index.cjs +1 -1
  18. package/dist/client/index.d.cts +4 -4
  19. package/dist/client/index.d.ts +4 -4
  20. package/dist/client/index.js +1 -1
  21. package/dist/core/index.cjs +1 -1
  22. package/dist/core/index.d.cts +3 -3
  23. package/dist/core/index.d.ts +3 -3
  24. package/dist/core/index.js +1 -1
  25. package/dist/create-document-capture-FVSQPUF6.js +1 -0
  26. package/dist/create-portrait-capture-INDCF65X.js +1 -0
  27. package/dist/{create-verification-CIwl0NIg.d.cts → create-verification-1BrMZqPJ.d.cts} +82 -16
  28. package/dist/{create-verification-CNCMU1kK.d.ts → create-verification-CuoYJ3kj.d.ts} +82 -16
  29. package/dist/{icao-gate-5FzqyitT.d.ts → icao-gate-BSbyqLUh.d.ts} +25 -9
  30. package/dist/{icao-gate-C-lfjEpH.d.cts → icao-gate-D-wePfoV.d.cts} +25 -9
  31. package/dist/index.cjs +1 -1
  32. package/dist/index.d.cts +6 -6
  33. package/dist/index.d.ts +6 -6
  34. package/dist/index.js +1 -1
  35. package/dist/internal/index.cjs +1 -1
  36. package/dist/internal/index.d.cts +6 -6
  37. package/dist/internal/index.d.ts +6 -6
  38. package/dist/internal/index.js +1 -1
  39. package/dist/plan-runner-WEUIMCYU.js +1 -0
  40. package/dist/{types-CKgMWVnP.d.cts → types-DPl0hsmI.d.cts} +29 -5
  41. package/dist/{types-CKgMWVnP.d.ts → types-DPl0hsmI.d.ts} +29 -5
  42. package/package.json +1 -1
  43. package/sbom.cdx.json +7 -7
  44. package/dist/chunk-2BFYVMUU.js +0 -1
  45. package/dist/chunk-3SL74TFR.js +0 -1
  46. package/dist/chunk-4RS4LP7D.js +0 -1
  47. package/dist/chunk-G6MU3B5V.js +0 -1
  48. package/dist/chunk-GYNWLJYW.js +0 -1
  49. package/dist/chunk-J4NL62VQ.js +0 -1
  50. package/dist/chunk-MMTOOH32.js +0 -1
  51. package/dist/chunk-QBPD7FRF.js +0 -1
  52. package/dist/chunk-SDWHJJ4W.js +0 -1
  53. package/dist/chunk-ULMH32G5.js +0 -1
  54. package/dist/create-document-capture-5FJI57YI.js +0 -1
  55. package/dist/create-portrait-capture-53XBURNT.js +0 -1
  56. package/dist/plan-runner-WRY4FOWW.js +0 -1
@@ -1,7 +1,7 @@
1
1
  import { b as Detector } from './detect-worker-DclNxkZT.cjs';
2
- import { A as AcceptedDocumentType, a4 as NationalEidOption, as as StepSection, s as HostedBranding, af as PlanSectionView, ac as PlanChoiceKind, m as ContactChannel, k as CheckReason, al as RetakeHint, _ as IdentityMethod, E as EidAfterPass, $ as IdentitySummarySource, G as HostedIcaoPolicy, a8 as PhoneCountryRule, Z as IcaoReportEntry, Y as IcaoCaptureTuning, H as HostedSessionView, V as HostedStepView, ag as PlanStepView, i as CaptureMode, ao as ScreenRampReport, j as CaptureProvenance, S as ScreenRampColour, ap as SessionFailureReason, h as AgeEstimationReason, au as VerificationLevel, at as VerificationAssurance, a3 as MethodChoiceView, b as CameraUnavailableCause, X as HostedVoiceView, am as ScreenRampChallenge, ay as PersonMask, az as AttestationInput, e as CheckType, aj as PortraitIcaoInput } from './types-CKgMWVnP.cjs';
3
- import { i as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1, p as DeviceClass, b as CaptureArtifacts, I as V3GateQuality, O as V3TelemetryEvent } from './capture-session-v3-DyUA2uCL.cjs';
4
- import { c as IcaoGateSummary, d as IcaoGateUpdate, P as Point, e as Box, j as IcaoFrameObservation, N as HostedClient, k as IcaoGate } from './icao-gate-C-lfjEpH.cjs';
2
+ import { A as AcceptedDocumentType, a5 as NationalEidOption, au as StepSection, t as HostedBranding, ag as PlanSectionView, ad as PlanChoiceKind, n as ContactChannel, l as CheckReason, an as RetakeHint, $ as IdentityMethod, E as EidAfterPass, a0 as IdentitySummarySource, J as HostedIcaoPolicy, a9 as PhoneCountryRule, _ as IcaoReportEntry, Z as IcaoCaptureTuning, H as HostedSessionView, W as HostedStepView, ah as PlanStepView, j as CaptureMode, aq as ScreenRampReport, k as CaptureProvenance, S as ScreenRampColour, ar as SessionFailureReason, i as AgeEstimationReason, aw as VerificationLevel, av as VerificationAssurance, a4 as MethodChoiceView, b as CameraUnavailableCause, c as CaptureIssueReport, am as ResolvedCaptureMode, Y as HostedVoiceView, ao as ScreenRampChallenge, aA as PersonMask, aB as AttestationInput, f as CheckType, ak as PortraitIcaoInput } from './types-DPl0hsmI.cjs';
3
+ import { i as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1, p as DeviceClass, b as CaptureArtifacts, a4 as EngineErrorDetail, I as V3GateQuality, O as V3TelemetryEvent } from './capture-session-v3-Cs4yV3HJ.cjs';
4
+ import { c as IcaoGateSummary, d as IcaoGateUpdate, P as Point, e as Box, j as IcaoFrameObservation, N as HostedClient, k as IcaoGate } from './icao-gate-D-wePfoV.cjs';
5
5
 
6
6
  declare const ISSUER_CODES: readonly string[];
7
7
 
@@ -52,6 +52,7 @@ interface DeriveStepEnv {
52
52
  isMobile?: boolean;
53
53
  }
54
54
  interface StepContext {
55
+ /** The session id as partners read it (`ses_...`): the reference shown on the result screen. */
55
56
  sessionId: string;
56
57
  orgName: string;
57
58
  returning: boolean;
@@ -320,6 +321,12 @@ interface DocumentSnapshot extends StepAttempts {
320
321
  side: "recto" | "verso";
321
322
  acceptedSides: ("recto" | "verso")[];
322
323
  documents: AcceptedDocumentsLike;
324
+ /**
325
+ * Age check (selfie): `true` when the session reached this document because the selfie could not settle the
326
+ * person's age (`age_estimation` failed with `age_uncertain` or `age_unavailable`); show the step-up line
327
+ * (`doc.ageStepUp`). Absent otherwise.
328
+ */
329
+ ageStepUp?: true;
323
330
  }
324
331
  interface LivenessSnapshot extends StepAttempts {
325
332
  /**
@@ -665,7 +672,7 @@ interface PortraitCaptureHandle {
665
672
  on<K extends keyof PortraitCaptureEvents>(event: K, handler: (payload: PortraitCaptureEvents[K]) => void): () => void;
666
673
  /**
667
674
  * Who films the face: a portrait step's handle follows the session (`HostedSessionView.capture.mode`); a standalone
668
- * {@link createPortraitCapture} is always `self` (the front camera, no switch).
675
+ * {@link createPortraitCapture} is always `self` (the front camera, no switch). Never `choice`.
669
676
  */
670
677
  readonly captureMode: CaptureMode;
671
678
  /** The camera of the live stream (as its track reports it, else as requested); `'user'` before the first start. */
@@ -768,7 +775,10 @@ interface CapturedArtifacts {
768
775
  * The upright requirement applies to phones only. Always set by the SDK.
769
776
  */
770
777
  formFactor?: "phone" | "tablet" | "desktop";
771
- /** The capture mode the attempt ran in ({@link LivenessCaptureHandle.captureMode}). Always set by the SDK. */
778
+ /**
779
+ * The capture mode the attempt ran in ({@link LivenessCaptureHandle.captureMode}): `self` or `assisted`, never
780
+ * `choice`. Always set by the SDK.
781
+ */
772
782
  mode?: CaptureMode;
773
783
  /**
774
784
  * Liveness v7 §4.4: the screen ramp rendered against the session's issued challenge, stamped on the clip's own
@@ -783,6 +793,23 @@ interface CapturedArtifacts {
783
793
  type CaptureEngineId = "v1" | "v3";
784
794
  /** Camera / engine failure kinds — collapsed to the public six. */
785
795
  type CaptureErrorKind = "permission" | "notfound" | "inuse" | "insecure" | "unsupported" | "generic";
796
+ /** The capture step that was running when a capture failed. */
797
+ type CaptureErrorPhase = "preflight" | "acquiring" | "models" | "recording" | "keyframes" | "upload";
798
+ /**
799
+ * What the public {@link CaptureErrorKind} leaves out, for diagnostics. Never personal data: `name` is the thrown
800
+ * error's `name` only (a class or DOMException name such as `NotReadableError`, never its message), letters only and
801
+ * at most 40 characters.
802
+ */
803
+ interface CaptureErrorDetail {
804
+ /** The thrown error's `name`, when the failure threw one. */
805
+ name?: string;
806
+ phase: CaptureErrorPhase;
807
+ /**
808
+ * The engine's own kind before the public collapse (`models`, `recorder`, `cliptoolarge`, `overconstrained`,
809
+ * `generic`, or a public kind unchanged).
810
+ */
811
+ engineKind?: string;
812
+ }
786
813
  /** Camera / engine failure payload (`on('error')`). */
787
814
  interface CaptureError {
788
815
  kind: CaptureErrorKind;
@@ -791,6 +818,8 @@ interface CaptureError {
791
818
  * HTTPS) and `unsupported` (the browser cannot capture at all).
792
819
  */
793
820
  retryable: boolean;
821
+ /** Where and how the capture failed, when the engine knows. */
822
+ detail?: CaptureErrorDetail;
794
823
  }
795
824
 
796
825
  /**
@@ -856,9 +885,10 @@ interface LivenessCaptureHandle {
856
885
  /**
857
886
  * Who films the face. A handle from {@link Verification.liveness} follows the
858
887
  * session (`HostedSessionView.capture.mode`, set in the flow; `self` until
859
- * the view is known); a standalone {@link createLivenessCapture} is always
888
+ * the view is known; under `choice` the person's pick, `self` until
889
+ * {@link Verification.chooseCaptureMode}); a standalone {@link createLivenessCapture} is always
860
890
  * `self`. In `self` the front camera is forced and {@link LivenessCaptureHandle.switchCamera}
861
- * does nothing; `assisted` opens the back camera by default and may switch.
891
+ * does nothing; `assisted` opens the back camera by default and may switch. Never `choice`.
862
892
  */
863
893
  readonly captureMode: CaptureMode;
864
894
  /**
@@ -950,6 +980,10 @@ type ReasonCode = CheckReason | SessionFailureReason | SdkFailureReason | AgeEst
950
980
  type VerificationStatus = "approved" | "rejected" | "review" | "retry" | "unavailable";
951
981
  /** The verdict for this session / capture (`on('result')`). */
952
982
  interface VerificationResult {
983
+ /**
984
+ * The session id in the form `sessions.create` returns and webhooks name
985
+ * (`ses_...`), so your server can match the result to its session.
986
+ */
953
987
  sessionId: string;
954
988
  status: VerificationStatus;
955
989
  /** Backend check or session-policy reason, or SDK-side reason for `unavailable`. */
@@ -978,7 +1012,16 @@ interface VerificationResult {
978
1012
  level?: VerificationLevel;
979
1013
  /** How the level was proved, when the API reports it. */
980
1014
  assurance?: VerificationAssurance;
981
- /** The subject (person) the session is linked to, once that subject has passed a verification (absent before that). */
1015
+ /**
1016
+ * The person the session is linked to, `per_` form (`per_<24 hex>`, as the
1017
+ * API's `personId` and the `/people` routes name it), once that person has
1018
+ * passed a verification (absent before that).
1019
+ */
1020
+ personId?: string;
1021
+ /**
1022
+ * The same person as {@link VerificationResult.personId}, bare (24
1023
+ * hexadecimal characters, no prefix), as the result token's `sub` names it.
1024
+ */
982
1025
  subjectId?: string;
983
1026
  }
984
1027
  /**
@@ -1074,6 +1117,13 @@ interface Verification {
1074
1117
  * records it under the same reason. Omit it when unknown.
1075
1118
  */
1076
1119
  reportCameraUnavailable?(cause?: CameraUnavailableCause): Promise<void>;
1120
+ /**
1121
+ * 2026-11-04: record a capture failure the page showed on the session (`POST /hosted/capture-issue`), for
1122
+ * diagnosis. Fire-and-forget: never throws, never changes the session, never bills, never counts as an attempt.
1123
+ * Sends at most one report per distinct (check, attempt, kind, name, phase); `formFactor` is filled in when absent.
1124
+ * Optional so custom / older `Verification` implementations stay valid.
1125
+ */
1126
+ reportCaptureIssue?(issue: CaptureIssueReport): void;
1077
1127
  /**
1078
1128
  * The session's pending liveness step must be captured on a phone
1079
1129
  * (`HostedStepView.requiresMobile`, profile v2 step 4 automatic decisions)
@@ -1086,13 +1136,26 @@ interface Verification {
1086
1136
  mobileRequired?(): Promise<boolean>;
1087
1137
  /**
1088
1138
  * Who films the face in this session (`HostedSessionView.capture.mode`, a
1089
- * flow setting): `self` (the person, front camera) or `assisted` (an agent,
1090
- * back camera). Bootstraps the hosted view when needed; `self` when the
1091
- * bootstrap fails or the verification was destroyed. Never rejects.
1139
+ * flow setting): `self` (the person, front camera), `assisted` (an agent,
1140
+ * back camera) or `choice` (the person picks; show a picker before the first
1141
+ * camera step and call {@link Verification.chooseCaptureMode}). Once picked,
1142
+ * resolves to the pick for the rest of the session. Bootstraps the hosted
1143
+ * view when needed; `self` when the bootstrap fails or the verification was
1144
+ * destroyed. Never rejects.
1092
1145
  * Optional so custom / older `Verification` implementations stay valid:
1093
1146
  * treat an absent member as `self`.
1094
1147
  */
1095
1148
  captureMode?(): Promise<CaptureMode>;
1149
+ /**
1150
+ * Under `choice`: record the person's pick. It holds for the whole session (in
1151
+ * memory, for this `Verification`), so the portrait camera does not ask again;
1152
+ * the liveness and portrait cameras run in it and `input.capture.mode` sends it.
1153
+ * Ignored when the session's mode is not `choice`.
1154
+ * Optional so custom / older `Verification` implementations stay valid.
1155
+ */
1156
+ chooseCaptureMode?(mode: ResolvedCaptureMode): void;
1157
+ /** The pick made with {@link Verification.chooseCaptureMode}, `null` before it. */
1158
+ readonly captureChoice?: ResolvedCaptureMode | null;
1096
1159
  /**
1097
1160
  * The session is a returning-user session (`HostedSessionView.returning`,
1098
1161
  * profile v2 step 5): the person verified before and only confirms it is
@@ -1380,9 +1443,10 @@ declare function createLivenessCaptureInternal(options: LivenessCaptureOptions,
1380
1443
  rankKeyframes?: () => boolean,
1381
1444
  /**
1382
1445
  * Who films the face (spec 2026-10-28 §4.3): createVerification reads the session's `capture.mode`, read at every
1383
- * start and switch. Absent (a capture bound to no session) → `self`.
1446
+ * start and switch, resolved through the person's pick under `choice` (never `choice` itself). Absent (a capture
1447
+ * bound to no session) → `self`.
1384
1448
  */
1385
- captureMode?: () => CaptureMode,
1449
+ captureMode?: () => ResolvedCaptureMode,
1386
1450
  /**
1387
1451
  * Liveness v7 §4.4: the session's screen-ramp challenge (`capture.liveness.screenRamp`), read when the recording
1388
1452
  * starts. The engine gets it only for a `self` capture with a `ramp` listener bound (the host paints); absent (a
@@ -2313,9 +2377,11 @@ interface CaptureSessionDocEvents {
2313
2377
  * the stage's message + reticle channel. Deduped on state key. */
2314
2378
  feedback: DocFeedbackState;
2315
2379
  artifacts: DocArtifacts;
2380
+ /** `detail`: where the attempt failed and the thrown error's name (never its message). */
2316
2381
  error: {
2317
2382
  kind: CaptureErrorKind$1;
2318
2383
  retryable: boolean;
2384
+ detail?: EngineErrorDetail;
2319
2385
  };
2320
2386
  /**
2321
2387
  * Offer the manual shutter ({@link CaptureSessionDoc.captureNow}) — the safety
@@ -2891,14 +2957,14 @@ declare function createPortraitCaptureInternal(options: PortraitCaptureOptions,
2891
2957
  * Who films the face (spec 2026-10-28 §4.3): the portrait step reads the session's `capture.mode` at every start
2892
2958
  * and switch, as the liveness capture does. Absent (a standalone capture) → `self`: the front camera only.
2893
2959
  */
2894
- captureMode?: () => CaptureMode): PortraitCaptureController;
2960
+ captureMode?: () => ResolvedCaptureMode): PortraitCaptureController;
2895
2961
 
2896
2962
  /**
2897
2963
  * The client surface the flow needs — `HostedClient` or a test fake. D8: the
2898
2964
  * live-camera capture proof methods are optional (a fake / an older bridge
2899
2965
  * without them presigns without a proof).
2900
2966
  */
2901
- type HostedClientLike = Pick<HostedClient, "getSession" | "recordConsent" | "choose" | "presign" | "uploadToSpaces" | "completeMedia" | "submitCheck"> & Partial<Pick<HostedClient, "presignCapture" | "armCapture">> & Partial<Pick<HostedClient, "confirmIdentity" | "identityPortrait">> & Partial<Pick<HostedClient, "reportCameraUnavailable">>;
2967
+ type HostedClientLike = Pick<HostedClient, "getSession" | "recordConsent" | "choose" | "presign" | "uploadToSpaces" | "completeMedia" | "submitCheck"> & Partial<Pick<HostedClient, "presignCapture" | "armCapture">> & Partial<Pick<HostedClient, "confirmIdentity" | "identityPortrait">> & Partial<Pick<HostedClient, "reportCameraUnavailable">> & Partial<Pick<HostedClient, "reportCaptureIssue">>;
2902
2968
  /** The presign policy allowlist for `kind: 'clip'` (media.policy.ts mirror). */
2903
2969
  declare const CLIP_MIME_ALLOWLIST: readonly string[];
2904
2970
  /** Same-key transport replays AFTER the first try, and the pause between them. */
@@ -3114,4 +3180,4 @@ declare function createVerification(options: VerificationOptions): Verification;
3114
3180
  /** {@link createVerification} with construction seams (tests / Sekyro AI-internal hosts). */
3115
3181
  declare function createVerificationInternal(options: VerificationOptions, internals: VerificationInternals): Verification;
3116
3182
 
3117
- export { type LivenessCaptureEvents as $, type AcceptedDocumentsLike as A, type DocumentMrzUpdate as B, type CameraFacing as C, type DocumentCaptureOptions as D, type DocumentPoint as E, type DocumentQuad as F, type DocumentReticle as G, type DocumentScanPhase as H, type DocumentScanUpdate as I, type DocumentSide as J, type DocumentSnapshot as K, type DocumentStepHandle as L, type EidSnapshot as M, type EidStepHandle as N, type EmailOtpSnapshot as O, type PortraitCaptureOptions as P, type EmailOtpStepHandle as Q, type EmailSource as R, type GateHint as S, type GateUpdate as T, ISSUER_CODES as U, type IdentitySummarySnapshot as V, type IdentitySummaryStepHandle as W, type InLaneSwitch as X, type LivePhotoGateUpdate as Y, type LivePhotoPlan as Z, type LivenessAssetsStatus as _, type DocumentCaptureHandle as a, type LiveMrzTuning as a$, type LivenessCaptureHandle as a0, type LivenessCaptureOptions as a1, type LivenessSnapshot as a2, type LivenessStartOptions as a3, type LivenessStepHandle as a4, type MethodSnapshot as a5, type MethodStepHandle as a6, type MobileRequiredSnapshot as a7, type MobileRequiredStepHandle as a8, type OtpChannel as a9, type UnsupportedSnapshot as aA, type UnsupportedStepHandle as aB, type Verification as aC, type VerificationBusy as aD, type VerificationEvents as aE, type VerificationLocale as aF, type VerificationOptions as aG, type VerificationResult as aH, type VerificationStatus as aI, type VerificationStep as aJ, WEB_IDENTITY_METHODS as aK, acceptedIssuers as aL, acceptedTypesFor as aM, cameraUnavailableCauseOf as aN, createLivenessCapture as aO, createVerification as aP, deriveStep as aQ, flagOf as aR, getLivenessAssetsStatus as aS, laneOf as aT, otherOptions as aU, preloadLivenessAssets as aV, releaseLivenessAssets as aW, resolveAcceptedDocuments as aX, sectionOf as aY, subscribeLivenessAssets as aZ, type DocCatalogEntry as a_, type OtpNumberSource as aa, PLATFORM_UNSUPPORTED as ab, type PhoneOtpSnapshot as ac, type PhoneOtpStepHandle as ad, type PlanChoiceSnapshot as ae, type PortraitCaptureEvents as af, type PortraitCaptureState as ag, type PortraitGateUpdate as ah, type PortraitSnapshot as ai, type PortraitStartOptions as aj, type PortraitStepHandle as ak, type PreloadLivenessAssetsOptions as al, type ProcessingSnapshot as am, type ProcessingStepHandle as an, type ReasonCode as ao, type RegistrySnapshot as ap, type RegistrySource as aq, type RegistryStepHandle as ar, type ResultDisplay as as, type ResultSnapshot as at, type ResultStepHandle as au, type SdkFailureReason as av, type StepAttempts as aw, type StepContext as ax, type StepSnapshot as ay, type UnsupportedReason as az, type PortraitCaptureHandle as b, FLIP_TIMEOUT_MS as b$, type TextLockTuning as b0, type OcrEngineClient as b1, type DocAssistReport as b2, type ReadyInfo as b3, type LoadFailure as b4, type OcrEngineOptions as b5, type SubmitRuntime as b6, type HostedClientLike as b7, ANALYSIS_LONG_EDGE as b8, ASPECT_BANDS as b9, type DocCameraTuning as bA, type DocCaptureReport as bB, type DocCaptureVia as bC, type DocChecksPayload as bD, type DocEngineLike as bE, DocFeedbackAggregator as bF, type DocFeedbackKey as bG, type DocFeedbackState as bH, type DocFormat as bI, type DocFrameAnalysis as bJ, type DocFrameMeasures as bK, type DocGateQuality as bL, type DocGateThresholds as bM, type DocGateTick as bN, type DocGateTickInput as bO, DocGateV1 as bP, type DocQuad as bQ, type DocQuadPoint as bR, type DocShutterReason as bS, type DocShutterTuning as bT, type DocSide as bU, type DocumentCaptureController as bV, type DocumentCaptureInternals as bW, EMPTY_GUIDE_METRICS as bX, type EncodedDocument as bY, FLIP_FILL_MIN as bZ, FLIP_GAP_MS as b_, AttestationError as ba, BLUR_REFUSE_SHARPNESS_MAX as bb, type BlurStatus as bc, CAPTURE_CANDIDATE_SPACING_MS as bd, CAPTURE_EXTRA_CANDIDATES as be, CLIP_MIME_ALLOWLIST as bf, type CaptureEngine as bg, CaptureSessionDoc as bh, type CaptureSessionDocEvents as bi, type CaptureSessionDocOptions as bj, DOC_ANALYSIS_DEFAULTS as bk, DOC_BLACK_FRAME_LUMA as bl, DOC_BLACK_FRAME_TICKS as bm, DOC_CADENCE_HZ as bn, DOC_CAMERA_TUNING_DEFAULTS as bo, DOC_CATALOG as bp, DOC_DETECT_WIDTH as bq, DOC_FEEDBACK_STATES as br, DOC_FIRST_FRAME_MS as bs, DOC_GATE_V1_DEFAULTS as bt, DOC_SHUTTER_DEFAULTS as bu, type DeviceReadHint as bv, type DocArtifacts as bw, DocAssist as bx, type DocAssistEngine as by, type DocAssistTick as bz, type CaptureChannel as c, aspectBand as c$, type FocusCaps as c0, type FramingStatus as c1, GUIDE_LOCK_DEFAULTS as c2, type GlareStatus as c3, type GrabbedFrame as c4, type GuideBlocker as c5, GuideLock as c6, type GuideLockTick as c7, type GuideLockTuning as c8, type GuideMetrics as c9, MR_DOC_CATALOG as cA, NO_REPORT_MS as cB, type OpenDocCameraDeps as cC, PORTRAIT_JPEG_QUALITY as cD, PRELOAD_BLAZE_INIT_TIMEOUT_MS as cE, PRELOAD_BUDGET_MS as cF, PROCESSING_POLL_DELAY_MS as cG, PROCESSING_POLL_MAX as cH, type PortraitCaptureController as cI, type PortraitCaptureInternals as cJ, REGISTRY_RETRY_DELAY_MS as cK, type ReticleType as cL, SAME_FACE_MAX_DROPS as cM, type ScanEvent as cN, type ScanLayout as cO, type ScanNotice as cP, type ScanPhase as cQ, type ScanReport as cR, type ScanSide as cS, type ScanState as cT, type SubmitExecutor as cU, TEXT_LOCK_DEFAULTS as cV, TRANSPORT_REPLAY_ATTEMPTS as cW, TRANSPORT_REPLAY_DELAY_MS as cX, type VerificationInternals as cY, analyzeDocFrame as cZ, analyzeGuide as c_, type GuideRect as ca, INFERENCE_RETRY_ATTEMPTS as cb, INFERENCE_RETRY_DEFAULT_S as cc, LANDMARKER_MODEL as cd, LENS_STORAGE_KEY as ce, LENS_TRY_MAX as cf, LIVE_MRZ_DEFAULTS as cg, LIVE_PHOTO_IDLE_MS as ch, LIVE_PHOTO_MAX_HZ as ci, type LandmarkedFace as cj, type LandmarkerLike as ck, type LensKind as cl, type LensSource as cm, type LightingStatus as cn, type LiveMrzCapture as co, type LiveMrzState as cp, type LivePhotoGate as cq, type LivePhotoKit as cr, type LivePhotoKitInternals as cs, type LivePhotoKitOptions as ct, type LivePhotoStill as cu, type LivenessCaptureInternalHandle as cv, type LivenessCaptureInternals as cw, type LivenessFlowDeps as cx, type LivenessFlowOutcome as cy, MANUAL_SHUTTER_MS as cz, type CaptureEngineId as d, aspectFits as d0, buildDeviceReadHint as d1, coverPointToVideo as d2, createDocumentCaptureInternal as d3, createFaceLandmarker as d4, createLivePhotoKit as d5, createLivenessCaptureInternal as d6, createPortraitCaptureInternal as d7, createVerificationInternal as d8, docZoomFor as d9, resolveDocCameraTuning as dA, resolveDocShutterTuning as dB, resolveGuideLockTuning as dC, runLivenessFlow as dD, runSubmission as dE, scannerFormatFor as dF, setPreloadLoaderForTests as dG, settledHint as dH, singleShotFocusAt as dI, specularFraction as dJ, supportsFocusMode as dK, warmDocDetector as dL, writeStoredLens as dM, encodeDocumentImage as da, facesOf as db, feedbackVoteOf as dc, focusOk as dd, guideQuad as de, guideRegionInFrame as df, initialScanState as dg, lensKindOf as dh, mapEngineState as di, mapErrorKind as dj, mapGuidanceHint as dk, nextScanState as dl, observe as dm, openDocCamera as dn, passportBandOf as dp, portraitMatchStep as dq, preloadedDetectorFactory as dr, quadAreaFrac as ds, quadBounds as dt, quadIou as du, quadTiltRatio as dv, randomUuid as dw, rankBackCameras as dx, readStoredLens as dy, resetLivenessAssetsForTests as dz, type CaptureError as e, type CaptureErrorKind as f, type CaptureState as g, type CapturedArtifacts as h, type CapturedDocument as i, type CapturedPortrait as j, type ChoiceOptionSnapshot as k, type ChoiceSnapshot as l, type ChoiceStepHandle as m, type ContactChoiceSnapshot as n, type ContactChoiceStepHandle as o, DEFAULT_API_ORIGIN as p, DOCUMENT_TYPE_ORDER as q, type DeriveStepEnv as r, type DocumentCaptureEvents as s, type DocumentCaptureState as t, type DocumentFeedback as u, type DocumentFeedbackKey as v, type DocumentGateUpdate as w, type DocumentGuide as x, type DocumentGuideMeasure as y, type DocumentLiveMrzOptions as z };
3183
+ export { type LivePhotoPlan as $, type AcceptedDocumentsLike as A, type DocumentGuideMeasure as B, type CameraFacing as C, type DocumentCaptureOptions as D, type DocumentLiveMrzOptions as E, type DocumentMrzUpdate as F, type DocumentPoint as G, type DocumentQuad as H, type DocumentReticle as I, type DocumentScanPhase as J, type DocumentScanUpdate as K, type DocumentSide as L, type DocumentSnapshot as M, type DocumentStepHandle as N, type EidSnapshot as O, type PortraitCaptureOptions as P, type EidStepHandle as Q, type EmailOtpSnapshot as R, type EmailOtpStepHandle as S, type EmailSource as T, type GateHint as U, type GateUpdate as V, ISSUER_CODES as W, type IdentitySummarySnapshot as X, type IdentitySummaryStepHandle as Y, type InLaneSwitch as Z, type LivePhotoGateUpdate as _, type DocumentCaptureHandle as a, subscribeLivenessAssets as a$, type LivenessAssetsStatus as a0, type LivenessCaptureEvents as a1, type LivenessCaptureHandle as a2, type LivenessCaptureOptions as a3, type LivenessSnapshot as a4, type LivenessStartOptions as a5, type LivenessStepHandle as a6, type MethodSnapshot as a7, type MethodStepHandle as a8, type MobileRequiredSnapshot as a9, type StepSnapshot as aA, type UnsupportedReason as aB, type UnsupportedSnapshot as aC, type UnsupportedStepHandle as aD, type Verification as aE, type VerificationBusy as aF, type VerificationEvents as aG, type VerificationLocale as aH, type VerificationOptions as aI, type VerificationResult as aJ, type VerificationStatus as aK, type VerificationStep as aL, WEB_IDENTITY_METHODS as aM, acceptedIssuers as aN, acceptedTypesFor as aO, cameraUnavailableCauseOf as aP, createLivenessCapture as aQ, createVerification as aR, deriveStep as aS, flagOf as aT, getLivenessAssetsStatus as aU, laneOf as aV, otherOptions as aW, preloadLivenessAssets as aX, releaseLivenessAssets as aY, resolveAcceptedDocuments as aZ, sectionOf as a_, type MobileRequiredStepHandle as aa, type OtpChannel as ab, type OtpNumberSource as ac, PLATFORM_UNSUPPORTED as ad, type PhoneOtpSnapshot as ae, type PhoneOtpStepHandle as af, type PlanChoiceSnapshot as ag, type PortraitCaptureEvents as ah, type PortraitCaptureState as ai, type PortraitGateUpdate as aj, type PortraitSnapshot as ak, type PortraitStartOptions as al, type PortraitStepHandle as am, type PreloadLivenessAssetsOptions as an, type ProcessingSnapshot as ao, type ProcessingStepHandle as ap, type ReasonCode as aq, type RegistrySnapshot as ar, type RegistrySource as as, type RegistryStepHandle as at, type ResultDisplay as au, type ResultSnapshot as av, type ResultStepHandle as aw, type SdkFailureReason as ax, type StepAttempts as ay, type StepContext as az, type PortraitCaptureHandle as b, FLIP_FILL_MIN as b$, type DocCatalogEntry as b0, type LiveMrzTuning as b1, type TextLockTuning as b2, type OcrEngineClient as b3, type DocAssistReport as b4, type ReadyInfo as b5, type LoadFailure as b6, type OcrEngineOptions as b7, type SubmitRuntime as b8, type HostedClientLike as b9, type DocAssistEngine as bA, type DocAssistTick as bB, type DocCameraTuning as bC, type DocCaptureReport as bD, type DocCaptureVia as bE, type DocChecksPayload as bF, type DocEngineLike as bG, DocFeedbackAggregator as bH, type DocFeedbackKey as bI, type DocFeedbackState as bJ, type DocFormat as bK, type DocFrameAnalysis as bL, type DocFrameMeasures as bM, type DocGateQuality as bN, type DocGateThresholds as bO, type DocGateTick as bP, type DocGateTickInput as bQ, DocGateV1 as bR, type DocQuad as bS, type DocQuadPoint as bT, type DocShutterReason as bU, type DocShutterTuning as bV, type DocSide as bW, type DocumentCaptureController as bX, type DocumentCaptureInternals as bY, EMPTY_GUIDE_METRICS as bZ, type EncodedDocument as b_, ANALYSIS_LONG_EDGE as ba, ASPECT_BANDS as bb, AttestationError as bc, BLUR_REFUSE_SHARPNESS_MAX as bd, type BlurStatus as be, CAPTURE_CANDIDATE_SPACING_MS as bf, CAPTURE_EXTRA_CANDIDATES as bg, CLIP_MIME_ALLOWLIST as bh, type CaptureEngine as bi, CaptureSessionDoc as bj, type CaptureSessionDocEvents as bk, type CaptureSessionDocOptions as bl, DOC_ANALYSIS_DEFAULTS as bm, DOC_BLACK_FRAME_LUMA as bn, DOC_BLACK_FRAME_TICKS as bo, DOC_CADENCE_HZ as bp, DOC_CAMERA_TUNING_DEFAULTS as bq, DOC_CATALOG as br, DOC_DETECT_WIDTH as bs, DOC_FEEDBACK_STATES as bt, DOC_FIRST_FRAME_MS as bu, DOC_GATE_V1_DEFAULTS as bv, DOC_SHUTTER_DEFAULTS as bw, type DeviceReadHint as bx, type DocArtifacts as by, DocAssist as bz, type CaptureChannel as c, analyzeDocFrame as c$, FLIP_GAP_MS as c0, FLIP_TIMEOUT_MS as c1, type FocusCaps as c2, type FramingStatus as c3, GUIDE_LOCK_DEFAULTS as c4, type GlareStatus as c5, type GrabbedFrame as c6, type GuideBlocker as c7, GuideLock as c8, type GuideLockTick as c9, type LivenessFlowOutcome as cA, MANUAL_SHUTTER_MS as cB, MR_DOC_CATALOG as cC, NO_REPORT_MS as cD, type OpenDocCameraDeps as cE, PORTRAIT_JPEG_QUALITY as cF, PRELOAD_BLAZE_INIT_TIMEOUT_MS as cG, PRELOAD_BUDGET_MS as cH, PROCESSING_POLL_DELAY_MS as cI, PROCESSING_POLL_MAX as cJ, type PortraitCaptureController as cK, type PortraitCaptureInternals as cL, REGISTRY_RETRY_DELAY_MS as cM, type ReticleType as cN, SAME_FACE_MAX_DROPS as cO, type ScanEvent as cP, type ScanLayout as cQ, type ScanNotice as cR, type ScanPhase as cS, type ScanReport as cT, type ScanSide as cU, type ScanState as cV, type SubmitExecutor as cW, TEXT_LOCK_DEFAULTS as cX, TRANSPORT_REPLAY_ATTEMPTS as cY, TRANSPORT_REPLAY_DELAY_MS as cZ, type VerificationInternals as c_, type GuideLockTuning as ca, type GuideMetrics as cb, type GuideRect as cc, INFERENCE_RETRY_ATTEMPTS as cd, INFERENCE_RETRY_DEFAULT_S as ce, LANDMARKER_MODEL as cf, LENS_STORAGE_KEY as cg, LENS_TRY_MAX as ch, LIVE_MRZ_DEFAULTS as ci, LIVE_PHOTO_IDLE_MS as cj, LIVE_PHOTO_MAX_HZ as ck, type LandmarkedFace as cl, type LandmarkerLike as cm, type LensKind as cn, type LensSource as co, type LightingStatus as cp, type LiveMrzCapture as cq, type LiveMrzState as cr, type LivePhotoGate as cs, type LivePhotoKit as ct, type LivePhotoKitInternals as cu, type LivePhotoKitOptions as cv, type LivePhotoStill as cw, type LivenessCaptureInternalHandle as cx, type LivenessCaptureInternals as cy, type LivenessFlowDeps as cz, type CaptureEngineId as d, analyzeGuide as d0, aspectBand as d1, aspectFits as d2, buildDeviceReadHint as d3, coverPointToVideo as d4, createDocumentCaptureInternal as d5, createFaceLandmarker as d6, createLivePhotoKit as d7, createLivenessCaptureInternal as d8, createPortraitCaptureInternal as d9, readStoredLens as dA, resetLivenessAssetsForTests as dB, resolveDocCameraTuning as dC, resolveDocShutterTuning as dD, resolveGuideLockTuning as dE, runLivenessFlow as dF, runSubmission as dG, scannerFormatFor as dH, setPreloadLoaderForTests as dI, settledHint as dJ, singleShotFocusAt as dK, specularFraction as dL, supportsFocusMode as dM, warmDocDetector as dN, writeStoredLens as dO, createVerificationInternal as da, docZoomFor as db, encodeDocumentImage as dc, facesOf as dd, feedbackVoteOf as de, focusOk as df, guideQuad as dg, guideRegionInFrame as dh, initialScanState as di, lensKindOf as dj, mapEngineState as dk, mapErrorKind as dl, mapGuidanceHint as dm, nextScanState as dn, observe as dp, openDocCamera as dq, passportBandOf as dr, portraitMatchStep as ds, preloadedDetectorFactory as dt, quadAreaFrac as du, quadBounds as dv, quadIou as dw, quadTiltRatio as dx, randomUuid as dy, rankBackCameras as dz, type CaptureError as e, type CaptureErrorDetail as f, type CaptureErrorKind as g, type CaptureErrorPhase as h, type CaptureState as i, type CapturedArtifacts as j, type CapturedDocument as k, type CapturedPortrait as l, type ChoiceOptionSnapshot as m, type ChoiceSnapshot as n, type ChoiceStepHandle as o, type ContactChoiceSnapshot as p, type ContactChoiceStepHandle as q, DEFAULT_API_ORIGIN as r, DOCUMENT_TYPE_ORDER as s, type DeriveStepEnv as t, type DocumentCaptureEvents as u, type DocumentCaptureState as v, type DocumentFeedback as w, type DocumentFeedbackKey as x, type DocumentGateUpdate as y, type DocumentGuide as z };
@@ -1,7 +1,7 @@
1
1
  import { b as Detector } from './detect-worker-DclNxkZT.js';
2
- import { A as AcceptedDocumentType, a4 as NationalEidOption, as as StepSection, s as HostedBranding, af as PlanSectionView, ac as PlanChoiceKind, m as ContactChannel, k as CheckReason, al as RetakeHint, _ as IdentityMethod, E as EidAfterPass, $ as IdentitySummarySource, G as HostedIcaoPolicy, a8 as PhoneCountryRule, Z as IcaoReportEntry, Y as IcaoCaptureTuning, H as HostedSessionView, V as HostedStepView, ag as PlanStepView, i as CaptureMode, ao as ScreenRampReport, j as CaptureProvenance, S as ScreenRampColour, ap as SessionFailureReason, h as AgeEstimationReason, au as VerificationLevel, at as VerificationAssurance, a3 as MethodChoiceView, b as CameraUnavailableCause, X as HostedVoiceView, am as ScreenRampChallenge, ay as PersonMask, az as AttestationInput, e as CheckType, aj as PortraitIcaoInput } from './types-CKgMWVnP.js';
3
- import { i as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1, p as DeviceClass, b as CaptureArtifacts, I as V3GateQuality, O as V3TelemetryEvent } from './capture-session-v3-Dxus1Se9.js';
4
- import { c as IcaoGateSummary, d as IcaoGateUpdate, P as Point, e as Box, j as IcaoFrameObservation, N as HostedClient, k as IcaoGate } from './icao-gate-5FzqyitT.js';
2
+ import { A as AcceptedDocumentType, a5 as NationalEidOption, au as StepSection, t as HostedBranding, ag as PlanSectionView, ad as PlanChoiceKind, n as ContactChannel, l as CheckReason, an as RetakeHint, $ as IdentityMethod, E as EidAfterPass, a0 as IdentitySummarySource, J as HostedIcaoPolicy, a9 as PhoneCountryRule, _ as IcaoReportEntry, Z as IcaoCaptureTuning, H as HostedSessionView, W as HostedStepView, ah as PlanStepView, j as CaptureMode, aq as ScreenRampReport, k as CaptureProvenance, S as ScreenRampColour, ar as SessionFailureReason, i as AgeEstimationReason, aw as VerificationLevel, av as VerificationAssurance, a4 as MethodChoiceView, b as CameraUnavailableCause, c as CaptureIssueReport, am as ResolvedCaptureMode, Y as HostedVoiceView, ao as ScreenRampChallenge, aA as PersonMask, aB as AttestationInput, f as CheckType, ak as PortraitIcaoInput } from './types-DPl0hsmI.js';
3
+ import { i as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1, p as DeviceClass, b as CaptureArtifacts, a4 as EngineErrorDetail, I as V3GateQuality, O as V3TelemetryEvent } from './capture-session-v3-CFSVWYzi.js';
4
+ import { c as IcaoGateSummary, d as IcaoGateUpdate, P as Point, e as Box, j as IcaoFrameObservation, N as HostedClient, k as IcaoGate } from './icao-gate-BSbyqLUh.js';
5
5
 
6
6
  declare const ISSUER_CODES: readonly string[];
7
7
 
@@ -52,6 +52,7 @@ interface DeriveStepEnv {
52
52
  isMobile?: boolean;
53
53
  }
54
54
  interface StepContext {
55
+ /** The session id as partners read it (`ses_...`): the reference shown on the result screen. */
55
56
  sessionId: string;
56
57
  orgName: string;
57
58
  returning: boolean;
@@ -320,6 +321,12 @@ interface DocumentSnapshot extends StepAttempts {
320
321
  side: "recto" | "verso";
321
322
  acceptedSides: ("recto" | "verso")[];
322
323
  documents: AcceptedDocumentsLike;
324
+ /**
325
+ * Age check (selfie): `true` when the session reached this document because the selfie could not settle the
326
+ * person's age (`age_estimation` failed with `age_uncertain` or `age_unavailable`); show the step-up line
327
+ * (`doc.ageStepUp`). Absent otherwise.
328
+ */
329
+ ageStepUp?: true;
323
330
  }
324
331
  interface LivenessSnapshot extends StepAttempts {
325
332
  /**
@@ -665,7 +672,7 @@ interface PortraitCaptureHandle {
665
672
  on<K extends keyof PortraitCaptureEvents>(event: K, handler: (payload: PortraitCaptureEvents[K]) => void): () => void;
666
673
  /**
667
674
  * Who films the face: a portrait step's handle follows the session (`HostedSessionView.capture.mode`); a standalone
668
- * {@link createPortraitCapture} is always `self` (the front camera, no switch).
675
+ * {@link createPortraitCapture} is always `self` (the front camera, no switch). Never `choice`.
669
676
  */
670
677
  readonly captureMode: CaptureMode;
671
678
  /** The camera of the live stream (as its track reports it, else as requested); `'user'` before the first start. */
@@ -768,7 +775,10 @@ interface CapturedArtifacts {
768
775
  * The upright requirement applies to phones only. Always set by the SDK.
769
776
  */
770
777
  formFactor?: "phone" | "tablet" | "desktop";
771
- /** The capture mode the attempt ran in ({@link LivenessCaptureHandle.captureMode}). Always set by the SDK. */
778
+ /**
779
+ * The capture mode the attempt ran in ({@link LivenessCaptureHandle.captureMode}): `self` or `assisted`, never
780
+ * `choice`. Always set by the SDK.
781
+ */
772
782
  mode?: CaptureMode;
773
783
  /**
774
784
  * Liveness v7 §4.4: the screen ramp rendered against the session's issued challenge, stamped on the clip's own
@@ -783,6 +793,23 @@ interface CapturedArtifacts {
783
793
  type CaptureEngineId = "v1" | "v3";
784
794
  /** Camera / engine failure kinds — collapsed to the public six. */
785
795
  type CaptureErrorKind = "permission" | "notfound" | "inuse" | "insecure" | "unsupported" | "generic";
796
+ /** The capture step that was running when a capture failed. */
797
+ type CaptureErrorPhase = "preflight" | "acquiring" | "models" | "recording" | "keyframes" | "upload";
798
+ /**
799
+ * What the public {@link CaptureErrorKind} leaves out, for diagnostics. Never personal data: `name` is the thrown
800
+ * error's `name` only (a class or DOMException name such as `NotReadableError`, never its message), letters only and
801
+ * at most 40 characters.
802
+ */
803
+ interface CaptureErrorDetail {
804
+ /** The thrown error's `name`, when the failure threw one. */
805
+ name?: string;
806
+ phase: CaptureErrorPhase;
807
+ /**
808
+ * The engine's own kind before the public collapse (`models`, `recorder`, `cliptoolarge`, `overconstrained`,
809
+ * `generic`, or a public kind unchanged).
810
+ */
811
+ engineKind?: string;
812
+ }
786
813
  /** Camera / engine failure payload (`on('error')`). */
787
814
  interface CaptureError {
788
815
  kind: CaptureErrorKind;
@@ -791,6 +818,8 @@ interface CaptureError {
791
818
  * HTTPS) and `unsupported` (the browser cannot capture at all).
792
819
  */
793
820
  retryable: boolean;
821
+ /** Where and how the capture failed, when the engine knows. */
822
+ detail?: CaptureErrorDetail;
794
823
  }
795
824
 
796
825
  /**
@@ -856,9 +885,10 @@ interface LivenessCaptureHandle {
856
885
  /**
857
886
  * Who films the face. A handle from {@link Verification.liveness} follows the
858
887
  * session (`HostedSessionView.capture.mode`, set in the flow; `self` until
859
- * the view is known); a standalone {@link createLivenessCapture} is always
888
+ * the view is known; under `choice` the person's pick, `self` until
889
+ * {@link Verification.chooseCaptureMode}); a standalone {@link createLivenessCapture} is always
860
890
  * `self`. In `self` the front camera is forced and {@link LivenessCaptureHandle.switchCamera}
861
- * does nothing; `assisted` opens the back camera by default and may switch.
891
+ * does nothing; `assisted` opens the back camera by default and may switch. Never `choice`.
862
892
  */
863
893
  readonly captureMode: CaptureMode;
864
894
  /**
@@ -950,6 +980,10 @@ type ReasonCode = CheckReason | SessionFailureReason | SdkFailureReason | AgeEst
950
980
  type VerificationStatus = "approved" | "rejected" | "review" | "retry" | "unavailable";
951
981
  /** The verdict for this session / capture (`on('result')`). */
952
982
  interface VerificationResult {
983
+ /**
984
+ * The session id in the form `sessions.create` returns and webhooks name
985
+ * (`ses_...`), so your server can match the result to its session.
986
+ */
953
987
  sessionId: string;
954
988
  status: VerificationStatus;
955
989
  /** Backend check or session-policy reason, or SDK-side reason for `unavailable`. */
@@ -978,7 +1012,16 @@ interface VerificationResult {
978
1012
  level?: VerificationLevel;
979
1013
  /** How the level was proved, when the API reports it. */
980
1014
  assurance?: VerificationAssurance;
981
- /** The subject (person) the session is linked to, once that subject has passed a verification (absent before that). */
1015
+ /**
1016
+ * The person the session is linked to, `per_` form (`per_<24 hex>`, as the
1017
+ * API's `personId` and the `/people` routes name it), once that person has
1018
+ * passed a verification (absent before that).
1019
+ */
1020
+ personId?: string;
1021
+ /**
1022
+ * The same person as {@link VerificationResult.personId}, bare (24
1023
+ * hexadecimal characters, no prefix), as the result token's `sub` names it.
1024
+ */
982
1025
  subjectId?: string;
983
1026
  }
984
1027
  /**
@@ -1074,6 +1117,13 @@ interface Verification {
1074
1117
  * records it under the same reason. Omit it when unknown.
1075
1118
  */
1076
1119
  reportCameraUnavailable?(cause?: CameraUnavailableCause): Promise<void>;
1120
+ /**
1121
+ * 2026-11-04: record a capture failure the page showed on the session (`POST /hosted/capture-issue`), for
1122
+ * diagnosis. Fire-and-forget: never throws, never changes the session, never bills, never counts as an attempt.
1123
+ * Sends at most one report per distinct (check, attempt, kind, name, phase); `formFactor` is filled in when absent.
1124
+ * Optional so custom / older `Verification` implementations stay valid.
1125
+ */
1126
+ reportCaptureIssue?(issue: CaptureIssueReport): void;
1077
1127
  /**
1078
1128
  * The session's pending liveness step must be captured on a phone
1079
1129
  * (`HostedStepView.requiresMobile`, profile v2 step 4 automatic decisions)
@@ -1086,13 +1136,26 @@ interface Verification {
1086
1136
  mobileRequired?(): Promise<boolean>;
1087
1137
  /**
1088
1138
  * Who films the face in this session (`HostedSessionView.capture.mode`, a
1089
- * flow setting): `self` (the person, front camera) or `assisted` (an agent,
1090
- * back camera). Bootstraps the hosted view when needed; `self` when the
1091
- * bootstrap fails or the verification was destroyed. Never rejects.
1139
+ * flow setting): `self` (the person, front camera), `assisted` (an agent,
1140
+ * back camera) or `choice` (the person picks; show a picker before the first
1141
+ * camera step and call {@link Verification.chooseCaptureMode}). Once picked,
1142
+ * resolves to the pick for the rest of the session. Bootstraps the hosted
1143
+ * view when needed; `self` when the bootstrap fails or the verification was
1144
+ * destroyed. Never rejects.
1092
1145
  * Optional so custom / older `Verification` implementations stay valid:
1093
1146
  * treat an absent member as `self`.
1094
1147
  */
1095
1148
  captureMode?(): Promise<CaptureMode>;
1149
+ /**
1150
+ * Under `choice`: record the person's pick. It holds for the whole session (in
1151
+ * memory, for this `Verification`), so the portrait camera does not ask again;
1152
+ * the liveness and portrait cameras run in it and `input.capture.mode` sends it.
1153
+ * Ignored when the session's mode is not `choice`.
1154
+ * Optional so custom / older `Verification` implementations stay valid.
1155
+ */
1156
+ chooseCaptureMode?(mode: ResolvedCaptureMode): void;
1157
+ /** The pick made with {@link Verification.chooseCaptureMode}, `null` before it. */
1158
+ readonly captureChoice?: ResolvedCaptureMode | null;
1096
1159
  /**
1097
1160
  * The session is a returning-user session (`HostedSessionView.returning`,
1098
1161
  * profile v2 step 5): the person verified before and only confirms it is
@@ -1380,9 +1443,10 @@ declare function createLivenessCaptureInternal(options: LivenessCaptureOptions,
1380
1443
  rankKeyframes?: () => boolean,
1381
1444
  /**
1382
1445
  * Who films the face (spec 2026-10-28 §4.3): createVerification reads the session's `capture.mode`, read at every
1383
- * start and switch. Absent (a capture bound to no session) → `self`.
1446
+ * start and switch, resolved through the person's pick under `choice` (never `choice` itself). Absent (a capture
1447
+ * bound to no session) → `self`.
1384
1448
  */
1385
- captureMode?: () => CaptureMode,
1449
+ captureMode?: () => ResolvedCaptureMode,
1386
1450
  /**
1387
1451
  * Liveness v7 §4.4: the session's screen-ramp challenge (`capture.liveness.screenRamp`), read when the recording
1388
1452
  * starts. The engine gets it only for a `self` capture with a `ramp` listener bound (the host paints); absent (a
@@ -2313,9 +2377,11 @@ interface CaptureSessionDocEvents {
2313
2377
  * the stage's message + reticle channel. Deduped on state key. */
2314
2378
  feedback: DocFeedbackState;
2315
2379
  artifacts: DocArtifacts;
2380
+ /** `detail`: where the attempt failed and the thrown error's name (never its message). */
2316
2381
  error: {
2317
2382
  kind: CaptureErrorKind$1;
2318
2383
  retryable: boolean;
2384
+ detail?: EngineErrorDetail;
2319
2385
  };
2320
2386
  /**
2321
2387
  * Offer the manual shutter ({@link CaptureSessionDoc.captureNow}) — the safety
@@ -2891,14 +2957,14 @@ declare function createPortraitCaptureInternal(options: PortraitCaptureOptions,
2891
2957
  * Who films the face (spec 2026-10-28 §4.3): the portrait step reads the session's `capture.mode` at every start
2892
2958
  * and switch, as the liveness capture does. Absent (a standalone capture) → `self`: the front camera only.
2893
2959
  */
2894
- captureMode?: () => CaptureMode): PortraitCaptureController;
2960
+ captureMode?: () => ResolvedCaptureMode): PortraitCaptureController;
2895
2961
 
2896
2962
  /**
2897
2963
  * The client surface the flow needs — `HostedClient` or a test fake. D8: the
2898
2964
  * live-camera capture proof methods are optional (a fake / an older bridge
2899
2965
  * without them presigns without a proof).
2900
2966
  */
2901
- type HostedClientLike = Pick<HostedClient, "getSession" | "recordConsent" | "choose" | "presign" | "uploadToSpaces" | "completeMedia" | "submitCheck"> & Partial<Pick<HostedClient, "presignCapture" | "armCapture">> & Partial<Pick<HostedClient, "confirmIdentity" | "identityPortrait">> & Partial<Pick<HostedClient, "reportCameraUnavailable">>;
2967
+ type HostedClientLike = Pick<HostedClient, "getSession" | "recordConsent" | "choose" | "presign" | "uploadToSpaces" | "completeMedia" | "submitCheck"> & Partial<Pick<HostedClient, "presignCapture" | "armCapture">> & Partial<Pick<HostedClient, "confirmIdentity" | "identityPortrait">> & Partial<Pick<HostedClient, "reportCameraUnavailable">> & Partial<Pick<HostedClient, "reportCaptureIssue">>;
2902
2968
  /** The presign policy allowlist for `kind: 'clip'` (media.policy.ts mirror). */
2903
2969
  declare const CLIP_MIME_ALLOWLIST: readonly string[];
2904
2970
  /** Same-key transport replays AFTER the first try, and the pause between them. */
@@ -3114,4 +3180,4 @@ declare function createVerification(options: VerificationOptions): Verification;
3114
3180
  /** {@link createVerification} with construction seams (tests / Sekyro AI-internal hosts). */
3115
3181
  declare function createVerificationInternal(options: VerificationOptions, internals: VerificationInternals): Verification;
3116
3182
 
3117
- export { type LivenessCaptureEvents as $, type AcceptedDocumentsLike as A, type DocumentMrzUpdate as B, type CameraFacing as C, type DocumentCaptureOptions as D, type DocumentPoint as E, type DocumentQuad as F, type DocumentReticle as G, type DocumentScanPhase as H, type DocumentScanUpdate as I, type DocumentSide as J, type DocumentSnapshot as K, type DocumentStepHandle as L, type EidSnapshot as M, type EidStepHandle as N, type EmailOtpSnapshot as O, type PortraitCaptureOptions as P, type EmailOtpStepHandle as Q, type EmailSource as R, type GateHint as S, type GateUpdate as T, ISSUER_CODES as U, type IdentitySummarySnapshot as V, type IdentitySummaryStepHandle as W, type InLaneSwitch as X, type LivePhotoGateUpdate as Y, type LivePhotoPlan as Z, type LivenessAssetsStatus as _, type DocumentCaptureHandle as a, type LiveMrzTuning as a$, type LivenessCaptureHandle as a0, type LivenessCaptureOptions as a1, type LivenessSnapshot as a2, type LivenessStartOptions as a3, type LivenessStepHandle as a4, type MethodSnapshot as a5, type MethodStepHandle as a6, type MobileRequiredSnapshot as a7, type MobileRequiredStepHandle as a8, type OtpChannel as a9, type UnsupportedSnapshot as aA, type UnsupportedStepHandle as aB, type Verification as aC, type VerificationBusy as aD, type VerificationEvents as aE, type VerificationLocale as aF, type VerificationOptions as aG, type VerificationResult as aH, type VerificationStatus as aI, type VerificationStep as aJ, WEB_IDENTITY_METHODS as aK, acceptedIssuers as aL, acceptedTypesFor as aM, cameraUnavailableCauseOf as aN, createLivenessCapture as aO, createVerification as aP, deriveStep as aQ, flagOf as aR, getLivenessAssetsStatus as aS, laneOf as aT, otherOptions as aU, preloadLivenessAssets as aV, releaseLivenessAssets as aW, resolveAcceptedDocuments as aX, sectionOf as aY, subscribeLivenessAssets as aZ, type DocCatalogEntry as a_, type OtpNumberSource as aa, PLATFORM_UNSUPPORTED as ab, type PhoneOtpSnapshot as ac, type PhoneOtpStepHandle as ad, type PlanChoiceSnapshot as ae, type PortraitCaptureEvents as af, type PortraitCaptureState as ag, type PortraitGateUpdate as ah, type PortraitSnapshot as ai, type PortraitStartOptions as aj, type PortraitStepHandle as ak, type PreloadLivenessAssetsOptions as al, type ProcessingSnapshot as am, type ProcessingStepHandle as an, type ReasonCode as ao, type RegistrySnapshot as ap, type RegistrySource as aq, type RegistryStepHandle as ar, type ResultDisplay as as, type ResultSnapshot as at, type ResultStepHandle as au, type SdkFailureReason as av, type StepAttempts as aw, type StepContext as ax, type StepSnapshot as ay, type UnsupportedReason as az, type PortraitCaptureHandle as b, FLIP_TIMEOUT_MS as b$, type TextLockTuning as b0, type OcrEngineClient as b1, type DocAssistReport as b2, type ReadyInfo as b3, type LoadFailure as b4, type OcrEngineOptions as b5, type SubmitRuntime as b6, type HostedClientLike as b7, ANALYSIS_LONG_EDGE as b8, ASPECT_BANDS as b9, type DocCameraTuning as bA, type DocCaptureReport as bB, type DocCaptureVia as bC, type DocChecksPayload as bD, type DocEngineLike as bE, DocFeedbackAggregator as bF, type DocFeedbackKey as bG, type DocFeedbackState as bH, type DocFormat as bI, type DocFrameAnalysis as bJ, type DocFrameMeasures as bK, type DocGateQuality as bL, type DocGateThresholds as bM, type DocGateTick as bN, type DocGateTickInput as bO, DocGateV1 as bP, type DocQuad as bQ, type DocQuadPoint as bR, type DocShutterReason as bS, type DocShutterTuning as bT, type DocSide as bU, type DocumentCaptureController as bV, type DocumentCaptureInternals as bW, EMPTY_GUIDE_METRICS as bX, type EncodedDocument as bY, FLIP_FILL_MIN as bZ, FLIP_GAP_MS as b_, AttestationError as ba, BLUR_REFUSE_SHARPNESS_MAX as bb, type BlurStatus as bc, CAPTURE_CANDIDATE_SPACING_MS as bd, CAPTURE_EXTRA_CANDIDATES as be, CLIP_MIME_ALLOWLIST as bf, type CaptureEngine as bg, CaptureSessionDoc as bh, type CaptureSessionDocEvents as bi, type CaptureSessionDocOptions as bj, DOC_ANALYSIS_DEFAULTS as bk, DOC_BLACK_FRAME_LUMA as bl, DOC_BLACK_FRAME_TICKS as bm, DOC_CADENCE_HZ as bn, DOC_CAMERA_TUNING_DEFAULTS as bo, DOC_CATALOG as bp, DOC_DETECT_WIDTH as bq, DOC_FEEDBACK_STATES as br, DOC_FIRST_FRAME_MS as bs, DOC_GATE_V1_DEFAULTS as bt, DOC_SHUTTER_DEFAULTS as bu, type DeviceReadHint as bv, type DocArtifacts as bw, DocAssist as bx, type DocAssistEngine as by, type DocAssistTick as bz, type CaptureChannel as c, aspectBand as c$, type FocusCaps as c0, type FramingStatus as c1, GUIDE_LOCK_DEFAULTS as c2, type GlareStatus as c3, type GrabbedFrame as c4, type GuideBlocker as c5, GuideLock as c6, type GuideLockTick as c7, type GuideLockTuning as c8, type GuideMetrics as c9, MR_DOC_CATALOG as cA, NO_REPORT_MS as cB, type OpenDocCameraDeps as cC, PORTRAIT_JPEG_QUALITY as cD, PRELOAD_BLAZE_INIT_TIMEOUT_MS as cE, PRELOAD_BUDGET_MS as cF, PROCESSING_POLL_DELAY_MS as cG, PROCESSING_POLL_MAX as cH, type PortraitCaptureController as cI, type PortraitCaptureInternals as cJ, REGISTRY_RETRY_DELAY_MS as cK, type ReticleType as cL, SAME_FACE_MAX_DROPS as cM, type ScanEvent as cN, type ScanLayout as cO, type ScanNotice as cP, type ScanPhase as cQ, type ScanReport as cR, type ScanSide as cS, type ScanState as cT, type SubmitExecutor as cU, TEXT_LOCK_DEFAULTS as cV, TRANSPORT_REPLAY_ATTEMPTS as cW, TRANSPORT_REPLAY_DELAY_MS as cX, type VerificationInternals as cY, analyzeDocFrame as cZ, analyzeGuide as c_, type GuideRect as ca, INFERENCE_RETRY_ATTEMPTS as cb, INFERENCE_RETRY_DEFAULT_S as cc, LANDMARKER_MODEL as cd, LENS_STORAGE_KEY as ce, LENS_TRY_MAX as cf, LIVE_MRZ_DEFAULTS as cg, LIVE_PHOTO_IDLE_MS as ch, LIVE_PHOTO_MAX_HZ as ci, type LandmarkedFace as cj, type LandmarkerLike as ck, type LensKind as cl, type LensSource as cm, type LightingStatus as cn, type LiveMrzCapture as co, type LiveMrzState as cp, type LivePhotoGate as cq, type LivePhotoKit as cr, type LivePhotoKitInternals as cs, type LivePhotoKitOptions as ct, type LivePhotoStill as cu, type LivenessCaptureInternalHandle as cv, type LivenessCaptureInternals as cw, type LivenessFlowDeps as cx, type LivenessFlowOutcome as cy, MANUAL_SHUTTER_MS as cz, type CaptureEngineId as d, aspectFits as d0, buildDeviceReadHint as d1, coverPointToVideo as d2, createDocumentCaptureInternal as d3, createFaceLandmarker as d4, createLivePhotoKit as d5, createLivenessCaptureInternal as d6, createPortraitCaptureInternal as d7, createVerificationInternal as d8, docZoomFor as d9, resolveDocCameraTuning as dA, resolveDocShutterTuning as dB, resolveGuideLockTuning as dC, runLivenessFlow as dD, runSubmission as dE, scannerFormatFor as dF, setPreloadLoaderForTests as dG, settledHint as dH, singleShotFocusAt as dI, specularFraction as dJ, supportsFocusMode as dK, warmDocDetector as dL, writeStoredLens as dM, encodeDocumentImage as da, facesOf as db, feedbackVoteOf as dc, focusOk as dd, guideQuad as de, guideRegionInFrame as df, initialScanState as dg, lensKindOf as dh, mapEngineState as di, mapErrorKind as dj, mapGuidanceHint as dk, nextScanState as dl, observe as dm, openDocCamera as dn, passportBandOf as dp, portraitMatchStep as dq, preloadedDetectorFactory as dr, quadAreaFrac as ds, quadBounds as dt, quadIou as du, quadTiltRatio as dv, randomUuid as dw, rankBackCameras as dx, readStoredLens as dy, resetLivenessAssetsForTests as dz, type CaptureError as e, type CaptureErrorKind as f, type CaptureState as g, type CapturedArtifacts as h, type CapturedDocument as i, type CapturedPortrait as j, type ChoiceOptionSnapshot as k, type ChoiceSnapshot as l, type ChoiceStepHandle as m, type ContactChoiceSnapshot as n, type ContactChoiceStepHandle as o, DEFAULT_API_ORIGIN as p, DOCUMENT_TYPE_ORDER as q, type DeriveStepEnv as r, type DocumentCaptureEvents as s, type DocumentCaptureState as t, type DocumentFeedback as u, type DocumentFeedbackKey as v, type DocumentGateUpdate as w, type DocumentGuide as x, type DocumentGuideMeasure as y, type DocumentLiveMrzOptions as z };
3183
+ export { type LivePhotoPlan as $, type AcceptedDocumentsLike as A, type DocumentGuideMeasure as B, type CameraFacing as C, type DocumentCaptureOptions as D, type DocumentLiveMrzOptions as E, type DocumentMrzUpdate as F, type DocumentPoint as G, type DocumentQuad as H, type DocumentReticle as I, type DocumentScanPhase as J, type DocumentScanUpdate as K, type DocumentSide as L, type DocumentSnapshot as M, type DocumentStepHandle as N, type EidSnapshot as O, type PortraitCaptureOptions as P, type EidStepHandle as Q, type EmailOtpSnapshot as R, type EmailOtpStepHandle as S, type EmailSource as T, type GateHint as U, type GateUpdate as V, ISSUER_CODES as W, type IdentitySummarySnapshot as X, type IdentitySummaryStepHandle as Y, type InLaneSwitch as Z, type LivePhotoGateUpdate as _, type DocumentCaptureHandle as a, subscribeLivenessAssets as a$, type LivenessAssetsStatus as a0, type LivenessCaptureEvents as a1, type LivenessCaptureHandle as a2, type LivenessCaptureOptions as a3, type LivenessSnapshot as a4, type LivenessStartOptions as a5, type LivenessStepHandle as a6, type MethodSnapshot as a7, type MethodStepHandle as a8, type MobileRequiredSnapshot as a9, type StepSnapshot as aA, type UnsupportedReason as aB, type UnsupportedSnapshot as aC, type UnsupportedStepHandle as aD, type Verification as aE, type VerificationBusy as aF, type VerificationEvents as aG, type VerificationLocale as aH, type VerificationOptions as aI, type VerificationResult as aJ, type VerificationStatus as aK, type VerificationStep as aL, WEB_IDENTITY_METHODS as aM, acceptedIssuers as aN, acceptedTypesFor as aO, cameraUnavailableCauseOf as aP, createLivenessCapture as aQ, createVerification as aR, deriveStep as aS, flagOf as aT, getLivenessAssetsStatus as aU, laneOf as aV, otherOptions as aW, preloadLivenessAssets as aX, releaseLivenessAssets as aY, resolveAcceptedDocuments as aZ, sectionOf as a_, type MobileRequiredStepHandle as aa, type OtpChannel as ab, type OtpNumberSource as ac, PLATFORM_UNSUPPORTED as ad, type PhoneOtpSnapshot as ae, type PhoneOtpStepHandle as af, type PlanChoiceSnapshot as ag, type PortraitCaptureEvents as ah, type PortraitCaptureState as ai, type PortraitGateUpdate as aj, type PortraitSnapshot as ak, type PortraitStartOptions as al, type PortraitStepHandle as am, type PreloadLivenessAssetsOptions as an, type ProcessingSnapshot as ao, type ProcessingStepHandle as ap, type ReasonCode as aq, type RegistrySnapshot as ar, type RegistrySource as as, type RegistryStepHandle as at, type ResultDisplay as au, type ResultSnapshot as av, type ResultStepHandle as aw, type SdkFailureReason as ax, type StepAttempts as ay, type StepContext as az, type PortraitCaptureHandle as b, FLIP_FILL_MIN as b$, type DocCatalogEntry as b0, type LiveMrzTuning as b1, type TextLockTuning as b2, type OcrEngineClient as b3, type DocAssistReport as b4, type ReadyInfo as b5, type LoadFailure as b6, type OcrEngineOptions as b7, type SubmitRuntime as b8, type HostedClientLike as b9, type DocAssistEngine as bA, type DocAssistTick as bB, type DocCameraTuning as bC, type DocCaptureReport as bD, type DocCaptureVia as bE, type DocChecksPayload as bF, type DocEngineLike as bG, DocFeedbackAggregator as bH, type DocFeedbackKey as bI, type DocFeedbackState as bJ, type DocFormat as bK, type DocFrameAnalysis as bL, type DocFrameMeasures as bM, type DocGateQuality as bN, type DocGateThresholds as bO, type DocGateTick as bP, type DocGateTickInput as bQ, DocGateV1 as bR, type DocQuad as bS, type DocQuadPoint as bT, type DocShutterReason as bU, type DocShutterTuning as bV, type DocSide as bW, type DocumentCaptureController as bX, type DocumentCaptureInternals as bY, EMPTY_GUIDE_METRICS as bZ, type EncodedDocument as b_, ANALYSIS_LONG_EDGE as ba, ASPECT_BANDS as bb, AttestationError as bc, BLUR_REFUSE_SHARPNESS_MAX as bd, type BlurStatus as be, CAPTURE_CANDIDATE_SPACING_MS as bf, CAPTURE_EXTRA_CANDIDATES as bg, CLIP_MIME_ALLOWLIST as bh, type CaptureEngine as bi, CaptureSessionDoc as bj, type CaptureSessionDocEvents as bk, type CaptureSessionDocOptions as bl, DOC_ANALYSIS_DEFAULTS as bm, DOC_BLACK_FRAME_LUMA as bn, DOC_BLACK_FRAME_TICKS as bo, DOC_CADENCE_HZ as bp, DOC_CAMERA_TUNING_DEFAULTS as bq, DOC_CATALOG as br, DOC_DETECT_WIDTH as bs, DOC_FEEDBACK_STATES as bt, DOC_FIRST_FRAME_MS as bu, DOC_GATE_V1_DEFAULTS as bv, DOC_SHUTTER_DEFAULTS as bw, type DeviceReadHint as bx, type DocArtifacts as by, DocAssist as bz, type CaptureChannel as c, analyzeDocFrame as c$, FLIP_GAP_MS as c0, FLIP_TIMEOUT_MS as c1, type FocusCaps as c2, type FramingStatus as c3, GUIDE_LOCK_DEFAULTS as c4, type GlareStatus as c5, type GrabbedFrame as c6, type GuideBlocker as c7, GuideLock as c8, type GuideLockTick as c9, type LivenessFlowOutcome as cA, MANUAL_SHUTTER_MS as cB, MR_DOC_CATALOG as cC, NO_REPORT_MS as cD, type OpenDocCameraDeps as cE, PORTRAIT_JPEG_QUALITY as cF, PRELOAD_BLAZE_INIT_TIMEOUT_MS as cG, PRELOAD_BUDGET_MS as cH, PROCESSING_POLL_DELAY_MS as cI, PROCESSING_POLL_MAX as cJ, type PortraitCaptureController as cK, type PortraitCaptureInternals as cL, REGISTRY_RETRY_DELAY_MS as cM, type ReticleType as cN, SAME_FACE_MAX_DROPS as cO, type ScanEvent as cP, type ScanLayout as cQ, type ScanNotice as cR, type ScanPhase as cS, type ScanReport as cT, type ScanSide as cU, type ScanState as cV, type SubmitExecutor as cW, TEXT_LOCK_DEFAULTS as cX, TRANSPORT_REPLAY_ATTEMPTS as cY, TRANSPORT_REPLAY_DELAY_MS as cZ, type VerificationInternals as c_, type GuideLockTuning as ca, type GuideMetrics as cb, type GuideRect as cc, INFERENCE_RETRY_ATTEMPTS as cd, INFERENCE_RETRY_DEFAULT_S as ce, LANDMARKER_MODEL as cf, LENS_STORAGE_KEY as cg, LENS_TRY_MAX as ch, LIVE_MRZ_DEFAULTS as ci, LIVE_PHOTO_IDLE_MS as cj, LIVE_PHOTO_MAX_HZ as ck, type LandmarkedFace as cl, type LandmarkerLike as cm, type LensKind as cn, type LensSource as co, type LightingStatus as cp, type LiveMrzCapture as cq, type LiveMrzState as cr, type LivePhotoGate as cs, type LivePhotoKit as ct, type LivePhotoKitInternals as cu, type LivePhotoKitOptions as cv, type LivePhotoStill as cw, type LivenessCaptureInternalHandle as cx, type LivenessCaptureInternals as cy, type LivenessFlowDeps as cz, type CaptureEngineId as d, analyzeGuide as d0, aspectBand as d1, aspectFits as d2, buildDeviceReadHint as d3, coverPointToVideo as d4, createDocumentCaptureInternal as d5, createFaceLandmarker as d6, createLivePhotoKit as d7, createLivenessCaptureInternal as d8, createPortraitCaptureInternal as d9, readStoredLens as dA, resetLivenessAssetsForTests as dB, resolveDocCameraTuning as dC, resolveDocShutterTuning as dD, resolveGuideLockTuning as dE, runLivenessFlow as dF, runSubmission as dG, scannerFormatFor as dH, setPreloadLoaderForTests as dI, settledHint as dJ, singleShotFocusAt as dK, specularFraction as dL, supportsFocusMode as dM, warmDocDetector as dN, writeStoredLens as dO, createVerificationInternal as da, docZoomFor as db, encodeDocumentImage as dc, facesOf as dd, feedbackVoteOf as de, focusOk as df, guideQuad as dg, guideRegionInFrame as dh, initialScanState as di, lensKindOf as dj, mapEngineState as dk, mapErrorKind as dl, mapGuidanceHint as dm, nextScanState as dn, observe as dp, openDocCamera as dq, passportBandOf as dr, portraitMatchStep as ds, preloadedDetectorFactory as dt, quadAreaFrac as du, quadBounds as dv, quadIou as dw, quadTiltRatio as dx, randomUuid as dy, rankBackCameras as dz, type CaptureError as e, type CaptureErrorDetail as f, type CaptureErrorKind as g, type CaptureErrorPhase as h, type CaptureState as i, type CapturedArtifacts as j, type CapturedDocument as k, type CapturedPortrait as l, type ChoiceOptionSnapshot as m, type ChoiceSnapshot as n, type ChoiceStepHandle as o, type ContactChoiceSnapshot as p, type ContactChoiceStepHandle as q, DEFAULT_API_ORIGIN as r, DOCUMENT_TYPE_ORDER as s, type DeriveStepEnv as t, type DocumentCaptureEvents as u, type DocumentCaptureState as v, type DocumentFeedback as w, type DocumentFeedbackKey as x, type DocumentGateUpdate as y, type DocumentGuide as z };
@@ -1,4 +1,4 @@
1
- import { H as HostedSessionView, C as ConsentLocale, a as HostedConsentView, b as CameraUnavailableCause, I as IdentityConfirmDecision, M as MediaKind, P as PresignUploadResult, c as CaptureContext, d as CompleteMediaResult, e as CheckType, f as CheckInputByType, g as IcaoCriterion, B as BackgroundUniformity, R as ResolvedIcaoTuning } from './types-CKgMWVnP.js';
1
+ import { H as HostedSessionView, C as ConsentLocale, a as HostedConsentView, b as CameraUnavailableCause, c as CaptureIssueReport, I as IdentityConfirmDecision, M as MediaKind, P as PresignUploadResult, d as CaptureContext, e as CompleteMediaResult, f as CheckType, g as CheckInputByType, h as IcaoCriterion, B as BackgroundUniformity, R as ResolvedIcaoTuning } from './types-DPl0hsmI.js';
2
2
 
3
3
  interface Point {
4
4
  x: number;
@@ -122,10 +122,11 @@ interface HostedClientOptions {
122
122
  /** Per-request timeout for API calls (NOT the Spaces PUT). Default 30 000 ms. */
123
123
  requestTimeoutMs?: number;
124
124
  /**
125
- * Tuning for the ONLY automatic retry the client performs: 409
126
- * `idempotency_in_progress` (a concurrent identical request is mid-flight
127
- * server-side; the real response lands once it finishes). `attempts` counts
128
- * retries AFTER the first try. Defaults: 5 × 400 ms.
125
+ * Tuning for the automatic retry on 409 `idempotency_in_progress` (a
126
+ * concurrent identical request is mid-flight server-side; the real response
127
+ * lands once it finishes). `attempts` counts retries AFTER the first try.
128
+ * Defaults: 5 × 400 ms. (The other automatic retry, once on a 503
129
+ * `server_busy` / `request_timeout`, is not tunable.)
129
130
  */
130
131
  inProgressRetry?: {
131
132
  attempts?: number;
@@ -156,8 +157,12 @@ interface HostedClientOptions {
156
157
  * `GET /hosted/session` (token-addressed) and lazily bootstraps it when a
157
158
  * `:id` route is called first.
158
159
  *
159
- * No automatic retry EXCEPT bounded short-delay retry on 409
160
- * `idempotency_in_progress`. Everything else — including 429 with its parsed
160
+ * Two automatic retries only: bounded short-delay retry on 409
161
+ * `idempotency_in_progress`, and ONE retry after `Retry-After` (capped at 3 s)
162
+ * on a 503 `server_busy` / `request_timeout` for the calls that are safe to
163
+ * repeat: the reads (`getSession`, `identityPortrait`), the naturally
164
+ * idempotent writes (`recordConsent`, `choose`) and `submitCheck` with an
165
+ * idempotency key. Everything else — including 429 with its parsed
161
166
  * `retryAfterSeconds` — is surfaced to the page to handle.
162
167
  */
163
168
  /**
@@ -177,6 +182,8 @@ declare class HostedClient {
177
182
  /** D8: prefetched capture nonces (`armCapture`), each with its local expiry. */
178
183
  private captureNonces;
179
184
  private captureFetch;
185
+ /** Capture issues already reported (see reportCaptureIssue). */
186
+ private readonly reportedIssues;
180
187
  constructor(opts: HostedClientOptions);
181
188
  /** Token-addressed bootstrap — the hosted page's first call. Caches the sessionId. */
182
189
  getSession(): Promise<HostedSessionView>;
@@ -193,6 +200,13 @@ declare class HostedClient {
193
200
  * `cause` (2026-10-30) says why (`denied` | `no_camera`); omitted, the body stays `{}` and nothing is recorded.
194
201
  */
195
202
  reportCameraUnavailable(cause?: CameraUnavailableCause): Promise<HostedSessionView>;
203
+ /**
204
+ * 2026-11-04: record a capture failure the page showed (`POST /hosted/capture-issue`, 204) so it can be diagnosed
205
+ * later. Fire-and-forget: never rejects, and every failure is swallowed. At most one report per distinct
206
+ * (check, attempt, kind, name, phase); a repeat resolves without a call. `name` is re-sanitised (letters only, at most
207
+ * 40 characters) and `engineKind` kept only when it is a lower-case code of at most 32 characters.
208
+ */
209
+ reportCaptureIssue(issue: CaptureIssueReport): Promise<void>;
196
210
  /**
197
211
  * Pick an option of the current choice (Sekyro flows §7.4): `plan.choice`'s
198
212
  * `nodeId` and one of its option ids. Returns the updated hosted view —
@@ -288,8 +302,10 @@ declare class HostedClient {
288
302
  * `{code, message}` → {@link HostedApiError} on non-2xx. EVERY failure is
289
303
  * typed: a rejected fetch → `network_error`, the timeout → `timeout`, an
290
304
  * unparseable 2xx body → `unknown_error` — the page never sees a raw
291
- * TypeError/DOMException. The ONLY automatic retry is 409
292
- * `idempotency_in_progress` (bounded, short delay).
305
+ * TypeError/DOMException. Automatic retries: 409 `idempotency_in_progress`
306
+ * (bounded, short delay), and ONE retry of a 503 `server_busy` /
307
+ * `request_timeout` after its `Retry-After` (capped at 3 s) when the call is
308
+ * safe to repeat: every GET, and a POST that sets `busyRetry`.
293
309
  */
294
310
  private api;
295
311
  }