@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.
- package/CHANGELOG.md +20 -0
- package/README.md +1 -2
- package/dist/{capture-session-doc-TATPATSZ.js → capture-session-doc-VXWWQEP4.js} +1 -1
- package/dist/{capture-session-v3-Dxus1Se9.d.ts → capture-session-v3-CFSVWYzi.d.ts} +13 -2
- package/dist/{capture-session-v3-DyUA2uCL.d.cts → capture-session-v3-Cs4yV3HJ.d.cts} +13 -2
- package/dist/chunk-4GJXUVZK.js +1 -0
- package/dist/chunk-5Y3UST3W.js +1 -0
- package/dist/chunk-64V55KD7.js +1 -0
- package/dist/chunk-6K4D3U6Q.js +1 -0
- package/dist/chunk-CQ7SKLMC.js +1 -0
- package/dist/{chunk-TWB4LTCE.js → chunk-JUEOHNVW.js} +1 -1
- package/dist/chunk-L45YTRJJ.js +1 -0
- package/dist/chunk-PLH6ZR6J.js +1 -0
- package/dist/chunk-RNJA5GDF.js +1 -0
- package/dist/chunk-ZO6IHP2I.js +1 -0
- package/dist/chunk-ZPXL26BF.js +1 -0
- package/dist/client/index.cjs +1 -1
- package/dist/client/index.d.cts +4 -4
- package/dist/client/index.d.ts +4 -4
- package/dist/client/index.js +1 -1
- package/dist/core/index.cjs +1 -1
- package/dist/core/index.d.cts +3 -3
- package/dist/core/index.d.ts +3 -3
- package/dist/core/index.js +1 -1
- package/dist/create-document-capture-FVSQPUF6.js +1 -0
- package/dist/create-portrait-capture-INDCF65X.js +1 -0
- package/dist/{create-verification-CIwl0NIg.d.cts → create-verification-1BrMZqPJ.d.cts} +82 -16
- package/dist/{create-verification-CNCMU1kK.d.ts → create-verification-CuoYJ3kj.d.ts} +82 -16
- package/dist/{icao-gate-5FzqyitT.d.ts → icao-gate-BSbyqLUh.d.ts} +25 -9
- package/dist/{icao-gate-C-lfjEpH.d.cts → icao-gate-D-wePfoV.d.cts} +25 -9
- package/dist/index.cjs +1 -1
- package/dist/index.d.cts +6 -6
- package/dist/index.d.ts +6 -6
- package/dist/index.js +1 -1
- package/dist/internal/index.cjs +1 -1
- package/dist/internal/index.d.cts +6 -6
- package/dist/internal/index.d.ts +6 -6
- package/dist/internal/index.js +1 -1
- package/dist/plan-runner-WEUIMCYU.js +1 -0
- package/dist/{types-CKgMWVnP.d.cts → types-DPl0hsmI.d.cts} +29 -5
- package/dist/{types-CKgMWVnP.d.ts → types-DPl0hsmI.d.ts} +29 -5
- package/package.json +1 -1
- package/sbom.cdx.json +7 -7
- package/dist/chunk-2BFYVMUU.js +0 -1
- package/dist/chunk-3SL74TFR.js +0 -1
- package/dist/chunk-4RS4LP7D.js +0 -1
- package/dist/chunk-G6MU3B5V.js +0 -1
- package/dist/chunk-GYNWLJYW.js +0 -1
- package/dist/chunk-J4NL62VQ.js +0 -1
- package/dist/chunk-MMTOOH32.js +0 -1
- package/dist/chunk-QBPD7FRF.js +0 -1
- package/dist/chunk-SDWHJJ4W.js +0 -1
- package/dist/chunk-ULMH32G5.js +0 -1
- package/dist/create-document-capture-5FJI57YI.js +0 -1
- package/dist/create-portrait-capture-53XBURNT.js +0 -1
- 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,
|
|
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-
|
|
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-
|
|
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
|
-
/**
|
|
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
|
|
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
|
-
/**
|
|
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)
|
|
1090
|
-
* back camera)
|
|
1091
|
-
*
|
|
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
|
|
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?: () =>
|
|
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?: () =>
|
|
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
|
|
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,
|
|
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-
|
|
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-
|
|
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
|
-
/**
|
|
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
|
|
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
|
-
/**
|
|
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)
|
|
1090
|
-
* back camera)
|
|
1091
|
-
*
|
|
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
|
|
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?: () =>
|
|
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?: () =>
|
|
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
|
|
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,
|
|
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
|
|
126
|
-
*
|
|
127
|
-
*
|
|
128
|
-
*
|
|
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
|
-
*
|
|
160
|
-
* `idempotency_in_progress
|
|
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.
|
|
292
|
-
*
|
|
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
|
}
|