@sekyro/web 0.1.0-rc.28 → 0.1.0-rc.29

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 (60) hide show
  1. package/CHANGELOG.md +20 -0
  2. package/dist/barcode-detect-C5IOXMKI.js +1 -0
  3. package/dist/{capture-session-doc-LUA4Y7PZ.js → capture-session-doc-YC4CT2EQ.js} +1 -1
  4. package/dist/{capture-session-v3-ClByT4KN.d.cts → capture-session-v3-CTQL6eFd.d.cts} +1 -1
  5. package/dist/{capture-session-v3-IjQwKfLS.d.ts → capture-session-v3-DHlOE6cS.d.ts} +1 -1
  6. package/dist/{challenge-frame-NUGPTWFP.js → challenge-frame-5GG4NDF5.js} +1 -1
  7. package/dist/{chunk-QP23DM4Z.js → chunk-34IITQFB.js} +1 -1
  8. package/dist/chunk-6AH7FXVC.js +1 -0
  9. package/dist/{chunk-MOOWUPOZ.js → chunk-AL6LIOLW.js} +1 -1
  10. package/dist/chunk-BF7CLNFA.js +1 -0
  11. package/dist/chunk-CKHBGAUA.js +1 -0
  12. package/dist/chunk-EVIGRYOX.js +3 -0
  13. package/dist/chunk-FVWFAO45.js +1 -0
  14. package/dist/{chunk-FSXWIMSG.js → chunk-IA5M34P7.js} +1 -1
  15. package/dist/chunk-JLVZ35QK.js +2 -0
  16. package/dist/{chunk-4DEPREJ3.js → chunk-KXFHVAYQ.js} +1 -1
  17. package/dist/chunk-VVUQ4PFU.js +1 -0
  18. package/dist/{chunk-KLEARRAD.js → chunk-WOVWAJD4.js} +1 -1
  19. package/dist/chunk-XIKMTHHH.js +1 -0
  20. package/dist/chunk-ZKF2XMNX.js +1 -0
  21. package/dist/client/index.cjs +1 -1
  22. package/dist/client/index.d.cts +3 -3
  23. package/dist/client/index.d.ts +3 -3
  24. package/dist/client/index.js +1 -1
  25. package/dist/core/index.cjs +1 -1
  26. package/dist/core/index.d.cts +3 -3
  27. package/dist/core/index.d.ts +3 -3
  28. package/dist/core/index.js +1 -1
  29. package/dist/core/ocr/worker.js +1 -1
  30. package/dist/create-document-capture-O64FR2DA.js +1 -0
  31. package/dist/{create-verification-C4FMWIix.d.ts → create-verification-BvldYuLZ.d.ts} +126 -16
  32. package/dist/{create-verification-BN7ebjC2.d.cts → create-verification-DzPluhA3.d.cts} +126 -16
  33. package/dist/{detector-scanic-23DAYT3H.js → detector-scanic-SE3CL55N.js} +1 -1
  34. package/dist/{icao-gate-CjbKCatx.d.cts → icao-gate-DveU9Cr8.d.ts} +1 -1
  35. package/dist/{icao-gate-CYb-35iH.d.ts → icao-gate-xyWB7dz2.d.cts} +1 -1
  36. package/dist/{icao-policy-D4AZivI8.d.ts → icao-policy-BWu1JLgi.d.cts} +12 -3
  37. package/dist/{icao-policy-CAZZYEJ6.d.cts → icao-policy-OOEQDG9_.d.ts} +12 -3
  38. package/dist/index.cjs +2 -2
  39. package/dist/index.d.cts +40 -8
  40. package/dist/index.d.ts +40 -8
  41. package/dist/index.js +1 -1
  42. package/dist/internal/index.cjs +2 -2
  43. package/dist/internal/index.d.cts +6 -6
  44. package/dist/internal/index.d.ts +6 -6
  45. package/dist/internal/index.js +1 -1
  46. package/dist/plan-runner-WGMNUBWJ.js +1 -0
  47. package/dist/{types-CgHWIEZj.d.ts → types-CezFEXzl.d.cts} +148 -8
  48. package/dist/{types-CgHWIEZj.d.cts → types-CezFEXzl.d.ts} +148 -8
  49. package/package.json +6 -3
  50. package/sbom.cdx.json +125 -10
  51. package/dist/chunk-A3FUGHAH.js +0 -2
  52. package/dist/chunk-CUBNJXZN.js +0 -1
  53. package/dist/chunk-HVW2AB35.js +0 -1
  54. package/dist/chunk-J7D3S5ZJ.js +0 -1
  55. package/dist/chunk-MJUOZH3U.js +0 -1
  56. package/dist/chunk-NFHLJOHW.js +0 -1
  57. package/dist/chunk-R4IQTGF5.js +0 -3
  58. package/dist/chunk-THQWX6EH.js +0 -1
  59. package/dist/create-document-capture-ZTJKSEJB.js +0 -1
  60. package/dist/plan-runner-INQLWFGS.js +0 -1
@@ -1,14 +1,18 @@
1
1
  import { b as Detector } from './detect-worker-CHqsPJoM.cjs';
2
- import { A as AcceptedDocumentType, ac as NationalEidOption, aV as StepSection, b4 as HostedBranding, aq as PlanSectionView, an as PlanChoiceKind, X as HostedSimulationView, l as ContactChannel, f as CheckReason, b8 as RetakeHint, ak as PhotoSource, al as PhotoSourcePick, a3 as IdentityMethod, E as EidAfterPass, a4 as IdentitySummarySource, K as HostedIcaoPolicy, ag as PhoneCountryRule, a1 as IcaoReportEntry, b7 as IcaoCaptureTuning, T as HostedPortraitPendingFix, b as CaptureMode, S as HostedPoaRuleView, aw as PoaNameMatchMode, aP as SessionReason, aN as SessionDecidingStep, W as HostedSessionView, Y as HostedStepView, ar as PlanStepView, aK as ResolvedCaptureMode, bc as ScreenRampReport, b3 as CaptureProvenance, ba as ScreenRampPaint, aO as SessionFailureReason, b0 as AgeEstimationReason, a_ as VerificationLevel, aZ as VerificationAssurance, aM as SandboxSimulation, ab as MethodChoiceView, b1 as CameraUnavailableCause, b2 as CaptureIssueReport, $ as HostedVoiceView, b9 as ScreenRampChallenge, a as AttestationInput, h as CheckType, bh as PersonMask, aE as PortraitIcaoInput, w as HostedChallengeView } from './types-CgHWIEZj.cjs';
3
- import { i as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1, q as DeviceClass, b as CaptureArtifacts, ad as EngineErrorDetail, W as V3GateQuality, _ as V3TelemetryEvent } from './capture-session-v3-ClByT4KN.cjs';
4
- import { f as IcaoGateSummary, g as IcaoGateUpdate, H as HostedClient, P as Point, p as IcaoGateScores, h as Box, m as IcaoFrameObservation, n as IcaoGate } from './icao-gate-CjbKCatx.cjs';
2
+ import { A as AcceptedDocumentType, ar as NationalEidOption, b8 as StepSection, bj as HostedBranding, aF as PlanSectionView, aC as PlanChoiceKind, aa as HostedSimulationView, l as ContactChannel, f as CheckReason, bn as RetakeHint, az as PhotoSource, aA as PhotoSourcePick, ai as IdentityMethod, E as EidAfterPass, X as HostedFormView, aj as IdentitySummarySource, Y as HostedIcaoPolicy, $ as HostedNativeAppView, av as PhoneCountryRule, ag as IcaoReportEntry, bm as IcaoCaptureTuning, a6 as HostedPortraitPendingFix, b as CaptureMode, a5 as HostedPoaRuleView, aL as PoaNameMatchMode, b2 as SessionReason, b0 as SessionDecidingStep, a9 as HostedSessionView, ab as HostedStepView, aG as PlanStepView, aZ as ResolvedCaptureMode, I as FormIssueCode, br as ScreenRampReport, bi as CaptureProvenance, H as FormInput, bp as ScreenRampPaint, b1 as SessionFailureReason, bf as AgeEstimationReason, bd as VerificationLevel, bc as VerificationAssurance, a$ as SandboxSimulation, aq as MethodChoiceView, bg as CameraUnavailableCause, bh as CaptureIssueReport, ae as HostedVoiceView, bo as ScreenRampChallenge, a as AttestationInput, h as CheckType, bw as PersonMask, aT as PortraitIcaoInput, P as HostedChallengeView } from './types-CezFEXzl.cjs';
3
+ import { i as CaptureState$1, f as CaptureSessionV3Events, g as CaptureSessionV3Options, c as CaptureErrorKind$1, q as DeviceClass, b as CaptureArtifacts, ad as EngineErrorDetail, W as V3GateQuality, _ as V3TelemetryEvent } from './capture-session-v3-CTQL6eFd.cjs';
4
+ import { f as IcaoGateSummary, g as IcaoGateUpdate, H as HostedClient, P as Point, p as IcaoGateScores, h as Box, m as IcaoFrameObservation, n as IcaoGate } from './icao-gate-xyWB7dz2.cjs';
5
5
 
6
6
  /** Why a challenge produced no token (spec §4.5). */
7
7
  type ChallengeErrorCode = "challenge_frame_blocked" | "challenge_script_blocked" | "site_key_rejected" | "challenge_failed" | "timeout" | "embedder_opaque" | "aborted";
8
- /** A challenge that produced no token. `detail` is Cloudflare's numeric error code when there is one. */
8
+ /**
9
+ * A challenge that produced no token. `detail` is Cloudflare's numeric error code when there is one; `readyMs` is
10
+ * how long the last frame took to answer `ready` (absent when it never did), for the capture issue (incident 2026-11-13).
11
+ */
9
12
  declare class ChallengeError extends Error {
10
13
  readonly code: ChallengeErrorCode;
11
14
  readonly detail?: string;
15
+ readyMs?: number;
12
16
  constructor(code: ChallengeErrorCode, detail?: string);
13
17
  }
14
18
  /** Bound on the frame's `ready` message after it is inserted (a blocked frame never sends it). */
@@ -463,6 +467,20 @@ interface ProofOfAddressSnapshot extends StepAttempts {
463
467
  */
464
468
  licenceAddressAccepted: boolean;
465
469
  }
470
+ /**
471
+ * The Form step (spec 2026-11-14 §14): one screen, the questions in the client's order, then the consents, one
472
+ * "Continue". `form` holds the client's text in `form.locale` (render it with that `lang` and `dir`, whatever the page
473
+ * language); ready-made field labels, buttons and errors are the SDK's own copy. Prefilled answers are editable.
474
+ */
475
+ interface FormSnapshot extends StepAttempts {
476
+ section: StepSection | null;
477
+ kind: "form";
478
+ key: string;
479
+ context: StepContext;
480
+ form: HostedFormView;
481
+ /** The direction of `form.locale` (`rtl` for Arabic). */
482
+ dir: "rtl" | "ltr";
483
+ }
466
484
  interface LivenessSnapshot extends StepAttempts {
467
485
  /**
468
486
  * Flow model 2026-10-23: the section of the flow (`contact`, `identity`,
@@ -567,6 +585,21 @@ interface MobileRequiredSnapshot {
567
585
  /** The camera step to continue on a phone (spec 2026-11-06 §3.1: every live camera capture, in every decision mode). */
568
586
  checkType: "liveness" | "face_match" | "doc_ocr" | "portrait_icao" | "poa";
569
587
  }
588
+ /**
589
+ * Native-only capture (spec 2026-11-15): the flow takes this camera step in a native app only (`requiresNativeApp`),
590
+ * so a browser, phone or desktop alike, shows the way to the partner's app or the Sekyro AI app instead of the camera.
591
+ */
592
+ interface NativeAppRequiredSnapshot {
593
+ /** The section of the flow (see {@link MobileRequiredSnapshot.section}). */
594
+ section: StepSection | null;
595
+ kind: "native_app_required";
596
+ key: string;
597
+ context: StepContext;
598
+ /** The camera step to continue in the app. */
599
+ checkType: string;
600
+ /** Where to continue (`view.nativeApp`); `{ sekyroApp: false }` when the server sent none. */
601
+ nativeApp: HostedNativeAppView;
602
+ }
570
603
  interface ProcessingSnapshot {
571
604
  /**
572
605
  * Flow model 2026-10-23: the section of the flow (`contact`, `identity`,
@@ -627,7 +660,7 @@ interface ResultSnapshot {
627
660
  step?: SessionDecidingStep;
628
661
  retryAfter?: string;
629
662
  }
630
- type StepSnapshot = PhoneOtpSnapshot | EmailOtpSnapshot | ContactChoiceSnapshot | IdentitySummarySnapshot | MethodSnapshot | ChoiceSnapshot | EidSnapshot | RegistrySnapshot | DocumentSnapshot | LivenessSnapshot | PortraitSnapshot | ProofOfAddressSnapshot | MobileRequiredSnapshot | ProcessingSnapshot | UnsupportedSnapshot | ResultSnapshot;
663
+ type StepSnapshot = PhoneOtpSnapshot | EmailOtpSnapshot | ContactChoiceSnapshot | IdentitySummarySnapshot | MethodSnapshot | ChoiceSnapshot | EidSnapshot | RegistrySnapshot | DocumentSnapshot | LivenessSnapshot | PortraitSnapshot | ProofOfAddressSnapshot | FormSnapshot | MobileRequiredSnapshot | NativeAppRequiredSnapshot | ProcessingSnapshot | UnsupportedSnapshot | ResultSnapshot;
631
664
  /**
632
665
  * ID mode: `face_match` is due right after an ACCEPTED portrait (passed, or
633
666
  * review after the cap) that it has not been tried with yet — the server picks
@@ -746,7 +779,10 @@ interface DocumentCaptureOptions {
746
779
  documentType: AcceptedDocumentType;
747
780
  /** Expected face; omit for a card's first face (either face). Passports are always `"single"`. */
748
781
  side?: DocumentSide;
749
- /** Display/telemetry only; capture is identical for every issuer. */
782
+ /**
783
+ * The issuing country (ISO alpha-2). A standalone capture is identical for every issuer; in a verification's document
784
+ * step the session may have capture follow the document catalog's series for this country (sides, shape, MRZ).
785
+ */
750
786
  issuer?: string;
751
787
  /** Default `true` (best-effort Screen Wake Lock while the camera is live). */
752
788
  keepScreenAwake?: boolean;
@@ -754,6 +790,14 @@ interface DocumentCaptureOptions {
754
790
  haptics?: boolean;
755
791
  /** Web live MRZ (on-device MRZ read that decides the shot on MRZ faces); server-controlled, additive. */
756
792
  liveMrz?: DocumentLiveMrzOptions;
793
+ /**
794
+ * Where the barcode decoder binary is served, for a document whose faces are told apart by a
795
+ * barcode. Self-host `zxing_reader.wasm` of the `zxing-wasm` version this SDK pins as
796
+ * `<base>/<sha12>/zxing_reader.wasm` (`<sha12>`: the first 12 hex characters of its sha256); the
797
+ * SDK checks the bytes before it runs them. Absent in a standalone capture: the order of capture
798
+ * decides the face.
799
+ */
800
+ barcodeAssetBaseUrl?: string;
757
801
  }
758
802
  interface DocumentCaptureHandle {
759
803
  readonly state: DocumentCaptureState;
@@ -881,6 +925,30 @@ interface PortraitStartOptions {
881
925
  facing?: CameraFacing;
882
926
  }
883
927
 
928
+ /** One refused answer: the question (or consent) id, why, and the values its message names. */
929
+ interface FormIssue {
930
+ id: string;
931
+ code: FormIssueCode | (string & {});
932
+ /** `too_long` / `too_short`: `max` / `min` characters; `number_too_*`: `min` / `max`; `date_too_*`: `date`. */
933
+ params?: {
934
+ min?: number | string;
935
+ max?: number | string;
936
+ date?: string;
937
+ };
938
+ }
939
+ /** The code of the 422 a refused Form submit answers (spec 2026-11-14 §14). */
940
+ declare const FORM_ANSWERS_INVALID = "form_answers_invalid";
941
+ /**
942
+ * A Form submit was refused: before any network call (the client's own check) or by the server (422
943
+ * `form_answers_invalid`). Nothing was stored and no attempt was used; show each issue under its question.
944
+ */
945
+ declare class FormAnswersError extends Error {
946
+ readonly issues: FormIssue[];
947
+ /** `client`: refused before sending; `server`: the server's 422. */
948
+ readonly source: "client" | "server";
949
+ constructor(issues: FormIssue[], source: "client" | "server");
950
+ }
951
+
884
952
  /**
885
953
  * Gate guidance code. `'hold'` is emitted while the clip records. `'upright'`:
886
954
  * the phone is held sideways (a landscape camera frame on a phone); the gate
@@ -1573,6 +1641,8 @@ interface DocumentStepHandle extends DocumentSnapshot {
1573
1641
  keepScreenAwake?: boolean;
1574
1642
  /** Web live MRZ (on-device MRZ read on MRZ faces; obeys the session's server tuning). */
1575
1643
  liveMrz?: DocumentLiveMrzOptions;
1644
+ /** Where the barcode decoder binary is served (default: Sekyro AI's asset host). */
1645
+ barcodeAssetBaseUrl?: string;
1576
1646
  }): DocumentCaptureHandle;
1577
1647
  /**
1578
1648
  * Design 2026-11-04 §5.2: submit a photo of the document picked from the device, for the face the step asks for
@@ -1739,6 +1809,20 @@ interface ProofOfAddressStepHandle extends ProofOfAddressSnapshot {
1739
1809
  */
1740
1810
  skipCapture?(): Promise<void>;
1741
1811
  }
1812
+ /** The Form step (spec 2026-11-14 §14). */
1813
+ interface FormStepHandle extends FormSnapshot {
1814
+ /** Switch to another option of the open choice (`context.switchable`; `POST /hosted/choice`). Present only with it. */
1815
+ chooseOption?(option: string): Promise<void>;
1816
+ /** The refused answers of `input` by this client's own check (empty: send it). Shows errors without a round trip. */
1817
+ validate(input: FormInput): FormIssue[];
1818
+ /**
1819
+ * Check `input`, then submit `form` with it. Rejects with {@link FormAnswersError} (each issue names its question
1820
+ * id) when the client's check or the server (422 `form_answers_invalid`, e.g. a card number typed into a text
1821
+ * answer) refuses it: nothing is stored and no attempt is used. Answers are final once accepted; the step then moves
1822
+ * on. Other failures reject with the typed `HostedApiError`.
1823
+ */
1824
+ submit(input: FormInput): Promise<void>;
1825
+ }
1742
1826
  /** The biometric step needs a phone (desktop browser). */
1743
1827
  interface MobileRequiredStepHandle extends MobileRequiredSnapshot {
1744
1828
  /** Switch to another option of the open choice (`context.switchable`; `POST /hosted/choice`). Present only with it. */
@@ -1752,6 +1836,15 @@ interface MobileRequiredStepHandle extends MobileRequiredSnapshot {
1752
1836
  */
1753
1837
  skipCapture?(): Promise<void>;
1754
1838
  }
1839
+ /** Spec 2026-11-15: the camera step runs in a native app only (the partner's app or the Sekyro AI app). */
1840
+ interface NativeAppRequiredStepHandle extends NativeAppRequiredSnapshot {
1841
+ /** Switch to another option of the open choice (`context.switchable`; `POST /hosted/choice`). Present only with it. */
1842
+ chooseOption?(option: string): Promise<void>;
1843
+ /** Re-read the session (the person continues in the app; the page follows). */
1844
+ refresh(): Promise<void>;
1845
+ /** Sandbox DX spec 2026-11-06 §8: see {@link MobileRequiredStepHandle.skipCapture}. */
1846
+ skipCapture?(): Promise<void>;
1847
+ }
1755
1848
  /** The server is still deciding. */
1756
1849
  interface ProcessingStepHandle extends ProcessingSnapshot {
1757
1850
  /** Switch to another option of the open choice (`context.switchable`; `POST /hosted/choice`). Present only with it. */
@@ -1767,7 +1860,7 @@ type UnsupportedStepHandle = UnsupportedSnapshot & {
1767
1860
  /** The session's outcome — display only (the SDK never decides it). */
1768
1861
  type ResultStepHandle = ResultSnapshot;
1769
1862
  /** What `on('step')` delivers: the step's data plus its actions. */
1770
- type VerificationStep = PhoneOtpStepHandle | EmailOtpStepHandle | ContactChoiceStepHandle | IdentitySummaryStepHandle | MethodStepHandle | ChoiceStepHandle | EidStepHandle | RegistryStepHandle | DocumentStepHandle | LivenessStepHandle | PortraitStepHandle | ProofOfAddressStepHandle | MobileRequiredStepHandle | ProcessingStepHandle | UnsupportedStepHandle | ResultStepHandle;
1863
+ type VerificationStep = PhoneOtpStepHandle | EmailOtpStepHandle | ContactChoiceStepHandle | IdentitySummaryStepHandle | MethodStepHandle | ChoiceStepHandle | EidStepHandle | RegistryStepHandle | DocumentStepHandle | LivenessStepHandle | PortraitStepHandle | ProofOfAddressStepHandle | FormStepHandle | MobileRequiredStepHandle | NativeAppRequiredStepHandle | ProcessingStepHandle | UnsupportedStepHandle | ResultStepHandle;
1771
1864
 
1772
1865
  /** The engine surface the handle binds — CaptureSessionV3 or a test double. */
1773
1866
  interface CaptureEngine {
@@ -1930,7 +2023,7 @@ declare const TRANSPORT_REPLAY_DELAY_MS = 1000;
1930
2023
  */
1931
2024
  declare const INFERENCE_RETRY_ATTEMPTS = 3;
1932
2025
  declare const INFERENCE_RETRY_DEFAULT_S = 10;
1933
- /** `getAttestation` threw (a host's own seam): the submission is not sent. The challenge frame never throws here. */
2026
+ /** `getAttestation` threw (a host's own seam): the submission is not sent; it is retried once. */
1934
2027
  declare class AttestationError extends Error {
1935
2028
  constructor(message: string);
1936
2029
  }
@@ -1957,9 +2050,10 @@ interface SubmitRuntime {
1957
2050
  * response instead of burning another attempt;
1958
2051
  * - ONE `consent_required` recovery: force-record consent and re-run under a
1959
2052
  * FRESH key (the 409 envelope is idempotency-cached under the old one);
1960
- * - ONE attestation retry (client-side Turnstile failure or a server
2053
+ * - ONE attestation retry (a host seam's throw or a server
1961
2054
  * `attestation_invalid`): `onAttestationInvalid` drops the cached token and
1962
- * the executor re-runs under a fresh key;
2055
+ * the executor re-runs under a fresh key; an {@link AttestationUnavailableError}
2056
+ * (no token within the SDK's bound) is final;
1963
2057
  * - up to {@link INFERENCE_RETRY_ATTEMPTS} `inference_unavailable` retries
1964
2058
  * after `retryAfterSeconds`, each under a FRESH key and with a fresh
1965
2059
  * attestation (`onAttestationInvalid` — the Turnstile token was spent).
@@ -2045,8 +2139,8 @@ interface DocCatalogEntry {
2045
2139
  format: DocFormat;
2046
2140
  /** Capture sequence the hosted doc step walks, in order. */
2047
2141
  sides: readonly DocSide[];
2048
- /** MRZ geometry: td1 = 3×30 (ID-1 verso), td3 = 2×44 (passport data page). */
2049
- mrz: "none" | "td1" | "td3";
2142
+ /** MRZ geometry: td1 = 3×30 (ID-1 verso), td2 = 2×36 (ID-2), td3 = 2×44 (passport data page). */
2143
+ mrz: "none" | "td1" | "td2" | "td3";
2050
2144
  /** Which side carries the holder photo (drives portrait expectations). */
2051
2145
  portraitSide: DocSide;
2052
2146
  /** Physical width/height ratio of the framed page. */
@@ -2071,10 +2165,10 @@ declare function aspectBand(format: DocFormat): {
2071
2165
  };
2072
2166
  /** The quad aspect is plausible for the format (any of its physical bands). */
2073
2167
  declare function aspectFits(format: DocFormat, aspect: number): boolean;
2074
- /** The MR docTypes facet (findings §4). Order = the hosted picker's display order. */
2075
- declare const MR_DOC_CATALOG: readonly DocCatalogEntry[];
2076
- /** Every document type (profile v2 §5.3a), picker order: identity card, passport, residence permit, driving licence. */
2168
+ /** Every document type (profile v2 §5.3a), picker order. */
2077
2169
  declare const DOC_CATALOG: readonly DocCatalogEntry[];
2170
+ /** The two types the legacy MR picker offers. Order = the hosted picker's display order. */
2171
+ declare const MR_DOC_CATALOG: readonly DocCatalogEntry[];
2078
2172
  /**
2079
2173
  * Scanner format per document type for ANY issuer (profile v2 §5.3a): identity
2080
2174
  * cards and residence permits are ID-1 or ID-2 (the issuer decides), passports
@@ -3328,6 +3422,16 @@ interface DocumentCaptureInternals {
3328
3422
  encode?: (still: Blob) => Promise<EncodedDocument>;
3329
3423
  /** Face of a card still (default: MRZ band on a 480 px copy). */
3330
3424
  classify?: (still: Blob) => Promise<ScanSide>;
3425
+ /**
3426
+ * Spec 2026-11-11 D10, D12, seams: `side` overrides the capture plan's barcode face,
3427
+ * `assetBaseUrl` is the runner's default base of the decoder binary, `seen` replaces the decoder
3428
+ * (does this still show a barcode).
3429
+ */
3430
+ barcode?: {
3431
+ side?: ScanSide;
3432
+ assetBaseUrl?: string;
3433
+ seen?: (still: Blob) => Promise<boolean>;
3434
+ };
3331
3435
  /**
3332
3436
  * Photo sharpness for the blur gate (default: blur-gate.ts on the card region
3333
3437
  * of the decoded still — the last gate quad, padded — at ≤ 1000 px; `-1` =
@@ -3345,6 +3449,12 @@ interface DocumentCaptureInternals {
3345
3449
  tickMs?: number;
3346
3450
  /** Web live MRZ (plan Task 6): session-bound OCR (the step runner passes the view). */
3347
3451
  webOcr?: DocumentWebOcr;
3452
+ /**
3453
+ * Spec 2026-11-11 D12: sides, shape and the MRZ expectation come from the catalog's series for the picked country
3454
+ * (`issuer`). The step runner sets it from the session's `capture.document.catalog`; absent (a standalone capture, an
3455
+ * older backend, the catalog flag off) = the type's generic plan, today's capture.
3456
+ */
3457
+ catalogCapture?: boolean;
3348
3458
  /**
3349
3459
  * One engine report per document face, whether or not web OCR is on: `captured` when the face is
3350
3460
  * delivered, `abandoned` when the capture is destroyed mid-face after the engine ticked. A throwing
@@ -3601,4 +3711,4 @@ declare function createVerification(options: VerificationOptions): Verification;
3601
3711
  /** {@link createVerification} with construction seams (tests / Sekyro AI-internal hosts). */
3602
3712
  declare function createVerificationInternal(options: VerificationOptions, internals: VerificationInternals): Verification;
3603
3713
 
3604
- export { type LivePhotoGateUpdate as $, type AcceptedDocumentsLike as A, type DocumentGuide as B, type CameraFacing as C, type DocumentCaptureOptions as D, type DocumentGuideMeasure as E, type DocumentLiveMrzOptions as F, type DocumentMrzUpdate as G, type DocumentPoint as H, type DocumentQuad as I, type DocumentReticle as J, type DocumentScanPhase as K, type DocumentScanUpdate as L, type DocumentSide as M, type DocumentSnapshot as N, type DocumentStepHandle as O, type PortraitCaptureOptions as P, type EidSnapshot as Q, type EidStepHandle as R, type EmailOtpSnapshot as S, type EmailOtpStepHandle as T, type EmailSource as U, type GateHint as V, type GateUpdate as W, ISSUER_CODES as X, type IdentitySummarySnapshot as Y, type IdentitySummaryStepHandle as Z, type InLaneSwitch as _, type DocumentCaptureHandle as a, otherOptions as a$, type LivePhotoPlan as a0, type LivenessAssetsStatus as a1, type LivenessCaptureEvents as a2, type LivenessCaptureHandle as a3, type LivenessCaptureOptions as a4, type LivenessSnapshot as a5, type LivenessStartOptions as a6, type LivenessStepHandle as a7, type MethodSnapshot as a8, type MethodStepHandle as a9, type ResultSnapshot as aA, type ResultStepHandle as aB, type SdkFailureReason as aC, type StepAttempts as aD, type StepContext as aE, type StepSnapshot as aF, type UnsupportedReason as aG, type UnsupportedSnapshot as aH, type UnsupportedStepHandle as aI, type Verification as aJ, type VerificationBusy as aK, type VerificationEvents as aL, type VerificationLocale as aM, type VerificationOptions as aN, type VerificationResult as aO, type VerificationStatus as aP, type VerificationStep as aQ, WEB_IDENTITY_METHODS as aR, acceptedIssuers as aS, acceptedTypesFor as aT, cameraUnavailableCauseOf as aU, createLivenessCapture as aV, createVerification as aW, deriveStep as aX, flagOf as aY, getLivenessAssetsStatus as aZ, laneOf as a_, type MobileRequiredSnapshot as aa, type MobileRequiredStepHandle as ab, type OtpChannel as ac, type OtpNumberSource as ad, PLATFORM_UNSUPPORTED as ae, type PageCaptureHandle as af, type PhoneOtpSnapshot as ag, type PhoneOtpStepHandle as ah, type PhotoSourceState as ai, type PlanChoiceSnapshot as aj, type PortraitCaptureEvents as ak, type PortraitCaptureState as al, type PortraitGateUpdate as am, type PortraitSnapshot as an, type PortraitStartOptions as ao, type PortraitStepHandle as ap, type PreloadLivenessAssetsOptions as aq, type ProcessingSnapshot as ar, type ProcessingStepHandle as as, type ProofOfAddressSnapshot as at, type ProofOfAddressStepHandle as au, type ReasonCode as av, type RegistrySnapshot as aw, type RegistrySource as ax, type RegistryStepHandle as ay, type ResultDisplay as az, type PortraitCaptureHandle as b, type DocQuad as b$, preloadLivenessAssets as b0, releaseLivenessAssets as b1, resolveAcceptedDocuments as b2, sectionOf as b3, subscribeLivenessAssets as b4, type SubmitRuntime as b5, type HostedClientLike as b6, type DocCatalogEntry as b7, type LiveMrzTuning as b8, type TextLockTuning as b9, DOC_CATALOG as bA, DOC_DETECT_WIDTH as bB, DOC_FEEDBACK_STATES as bC, DOC_FIRST_FRAME_MS as bD, DOC_GATE_V1_DEFAULTS as bE, DOC_SHUTTER_DEFAULTS as bF, type DeviceReadHint as bG, type DocArtifacts as bH, DocAssist as bI, type DocAssistEngine as bJ, type DocAssistTick as bK, type DocCameraTuning as bL, type DocCaptureReport as bM, type DocCaptureVia as bN, type DocChecksPayload as bO, type DocEngineLike as bP, DocFeedbackAggregator as bQ, type DocFeedbackKey as bR, type DocFeedbackState as bS, type DocFormat as bT, type DocFrameAnalysis as bU, type DocFrameMeasures as bV, type DocGateQuality as bW, type DocGateThresholds as bX, type DocGateTick as bY, type DocGateTickInput as bZ, DocGateV1 as b_, type OcrEngineClient as ba, type DocAssistReport as bb, type ReadyInfo as bc, type LoadFailure as bd, type OcrEngineOptions as be, ANALYSIS_LONG_EDGE as bf, ASPECT_BANDS as bg, AttestationError as bh, BLUR_REFUSE_SHARPNESS_MAX as bi, type BlurStatus as bj, CAPTURE_CANDIDATE_SPACING_MS as bk, CAPTURE_EXTRA_CANDIDATES as bl, CHALLENGE_EXECUTE_TIMEOUT_MS as bm, CHALLENGE_READY_TIMEOUT_MS as bn, CLIP_MIME_ALLOWLIST as bo, type CaptureEngine as bp, CaptureSessionDoc as bq, type CaptureSessionDocEvents as br, type CaptureSessionDocOptions as bs, type ChallengeAction as bt, ChallengeError as bu, DOC_ANALYSIS_DEFAULTS as bv, DOC_BLACK_FRAME_LUMA as bw, DOC_BLACK_FRAME_TICKS as bx, DOC_CADENCE_HZ as by, DOC_CAMERA_TUNING_DEFAULTS as bz, type CaptureChannel as c, type ScanReport as c$, type DocQuadPoint as c0, type DocShutterReason as c1, type DocShutterTuning as c2, type DocSide as c3, type DocumentCaptureController as c4, type DocumentCaptureInternals as c5, EMPTY_GUIDE_METRICS as c6, type EncodedDocument as c7, type ExecuteChallengeOptions as c8, FLIP_FILL_MIN as c9, type LivePhotoGate as cA, type LivePhotoKit as cB, type LivePhotoKitInternals as cC, type LivePhotoKitOptions as cD, type LivePhotoStill as cE, type LivenessCaptureInternalHandle as cF, type LivenessCaptureInternals as cG, type LivenessFlowDeps as cH, type LivenessFlowOutcome as cI, MANUAL_SHUTTER_MS as cJ, MR_DOC_CATALOG as cK, NO_REPORT_MS as cL, type OpenDocCameraDeps as cM, PORTRAIT_JPEG_QUALITY as cN, PRELOAD_BLAZE_INIT_TIMEOUT_MS as cO, PRELOAD_BUDGET_MS as cP, PROCESSING_POLL_DELAY_MS as cQ, PROCESSING_POLL_MAX as cR, type PortraitCaptureController as cS, type PortraitCaptureInternals as cT, REGISTRY_RETRY_DELAY_MS as cU, type ReticleType as cV, SAME_FACE_MAX_DROPS as cW, type ScanEvent as cX, type ScanLayout as cY, type ScanNotice as cZ, type ScanPhase as c_, FLIP_GAP_MS as ca, FLIP_TIMEOUT_MS as cb, type FocusCaps as cc, type FramingStatus as cd, GUIDE_LOCK_DEFAULTS as ce, type GlareStatus as cf, type GrabbedFrame as cg, type GuideBlocker as ch, GuideLock as ci, type GuideLockTick as cj, type GuideLockTuning as ck, type GuideMetrics as cl, type GuideRect as cm, INFERENCE_RETRY_ATTEMPTS as cn, INFERENCE_RETRY_DEFAULT_S as co, LANDMARKER_MODEL as cp, LENS_STORAGE_KEY as cq, LIVE_MRZ_DEFAULTS as cr, LIVE_PHOTO_IDLE_MS as cs, LIVE_PHOTO_MAX_HZ as ct, type LandmarkedFace as cu, type LandmarkerLike as cv, type LensSource as cw, type LightingStatus as cx, type LiveMrzCapture as cy, type LiveMrzState as cz, type CaptureEngineId as d, type ScanSide as d0, type ScanState as d1, type SubmitExecutor as d2, TEXT_LOCK_DEFAULTS as d3, TRANSPORT_REPLAY_ATTEMPTS as d4, TRANSPORT_REPLAY_DELAY_MS as d5, type VerificationInternals as d6, analyzeDocFrame as d7, analyzeGuide as d8, aspectBand as d9, portraitMatchStep as dA, preloadedDetectorFactory as dB, quadAreaFrac as dC, quadBounds as dD, quadIou as dE, quadTiltRatio as dF, randomUuid as dG, readStoredLens as dH, resetChallengeFrameForTests as dI, resetLivenessAssetsForTests as dJ, resolveDocCameraTuning as dK, resolveDocShutterTuning as dL, resolveGuideLockTuning as dM, runLivenessFlow as dN, runSubmission as dO, scannerFormatFor as dP, setPreloadLoaderForTests as dQ, settledHint as dR, singleShotFocusAt as dS, specularFraction as dT, supportsFocusMode as dU, warmDocDetector as dV, writeStoredLens as dW, aspectFits as da, buildDeviceReadHint as db, coverPointToVideo as dc, createDocumentCaptureInternal as dd, createFaceLandmarker as de, createLivePhotoKit as df, createLivenessCaptureInternal as dg, createPortraitCaptureInternal as dh, createVerificationInternal as di, docZoomFor as dj, encodeDocumentImage as dk, executeChallenge as dl, facesOf as dm, feedbackVoteOf as dn, focusOk as dp, guideQuad as dq, guideRegionInFrame as dr, initialScanState as ds, mapEngineState as dt, mapErrorKind as du, mapGuidanceHint as dv, nextScanState as dw, observe as dx, openDocCamera as dy, passportBandOf 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 ChallengeErrorCode as m, type ChoiceOptionSnapshot as n, type ChoiceSnapshot as o, type ChoiceStepHandle as p, type ContactChoiceSnapshot as q, type ContactChoiceStepHandle as r, DEFAULT_API_ORIGIN as s, DOCUMENT_TYPE_ORDER as t, type DeriveStepEnv as u, type DocumentCaptureEvents as v, type DocumentCaptureState as w, type DocumentFeedback as x, type DocumentFeedbackKey as y, type DocumentGateUpdate as z };
3714
+ export { type GateUpdate as $, type AcceptedDocumentsLike as A, type DocumentGuide as B, type CameraFacing as C, type DocumentCaptureOptions as D, type DocumentGuideMeasure as E, type FormIssue as F, type DocumentLiveMrzOptions as G, type DocumentMrzUpdate as H, type DocumentPoint as I, type DocumentQuad as J, type DocumentReticle as K, type DocumentScanPhase as L, type DocumentScanUpdate as M, type DocumentSide as N, type DocumentSnapshot as O, type PortraitCaptureOptions as P, type DocumentStepHandle as Q, type EidSnapshot as R, type EidStepHandle as S, type EmailOtpSnapshot as T, type EmailOtpStepHandle as U, type EmailSource as V, FORM_ANSWERS_INVALID as W, FormAnswersError as X, type FormSnapshot as Y, type FormStepHandle as Z, type GateHint as _, type DocumentCaptureHandle as a, cameraUnavailableCauseOf as a$, ISSUER_CODES as a0, type IdentitySummarySnapshot as a1, type IdentitySummaryStepHandle as a2, type InLaneSwitch as a3, type LivePhotoGateUpdate as a4, type LivePhotoPlan as a5, type LivenessAssetsStatus as a6, type LivenessCaptureEvents as a7, type LivenessCaptureHandle as a8, type LivenessCaptureOptions as a9, type ProofOfAddressSnapshot as aA, type ProofOfAddressStepHandle as aB, type ReasonCode as aC, type RegistrySnapshot as aD, type RegistrySource as aE, type RegistryStepHandle as aF, type ResultDisplay as aG, type ResultSnapshot as aH, type ResultStepHandle as aI, type SdkFailureReason as aJ, type StepAttempts as aK, type StepContext as aL, type StepSnapshot as aM, type UnsupportedReason as aN, type UnsupportedSnapshot as aO, type UnsupportedStepHandle as aP, type Verification as aQ, type VerificationBusy as aR, type VerificationEvents as aS, type VerificationLocale as aT, type VerificationOptions as aU, type VerificationResult as aV, type VerificationStatus as aW, type VerificationStep as aX, WEB_IDENTITY_METHODS as aY, acceptedIssuers as aZ, acceptedTypesFor as a_, type LivenessSnapshot as aa, type LivenessStartOptions as ab, type LivenessStepHandle as ac, type MethodSnapshot as ad, type MethodStepHandle as ae, type MobileRequiredSnapshot as af, type MobileRequiredStepHandle as ag, type NativeAppRequiredSnapshot as ah, type NativeAppRequiredStepHandle as ai, type OtpChannel as aj, type OtpNumberSource as ak, PLATFORM_UNSUPPORTED as al, type PageCaptureHandle as am, type PhoneOtpSnapshot as an, type PhoneOtpStepHandle as ao, type PhotoSourceState as ap, type PlanChoiceSnapshot as aq, type PortraitCaptureEvents as ar, type PortraitCaptureState as as, type PortraitGateUpdate as at, type PortraitSnapshot as au, type PortraitStartOptions as av, type PortraitStepHandle as aw, type PreloadLivenessAssetsOptions as ax, type ProcessingSnapshot as ay, type ProcessingStepHandle as az, type PortraitCaptureHandle as b, type DocFrameAnalysis as b$, createLivenessCapture as b0, createVerification as b1, deriveStep as b2, flagOf as b3, getLivenessAssetsStatus as b4, laneOf as b5, otherOptions as b6, preloadLivenessAssets as b7, releaseLivenessAssets as b8, resolveAcceptedDocuments as b9, type ChallengeAction as bA, ChallengeError as bB, DOC_ANALYSIS_DEFAULTS as bC, DOC_BLACK_FRAME_LUMA as bD, DOC_BLACK_FRAME_TICKS as bE, DOC_CADENCE_HZ as bF, DOC_CAMERA_TUNING_DEFAULTS as bG, DOC_CATALOG as bH, DOC_DETECT_WIDTH as bI, DOC_FEEDBACK_STATES as bJ, DOC_FIRST_FRAME_MS as bK, DOC_GATE_V1_DEFAULTS as bL, DOC_SHUTTER_DEFAULTS as bM, type DeviceReadHint as bN, type DocArtifacts as bO, DocAssist as bP, type DocAssistEngine as bQ, type DocAssistTick as bR, type DocCameraTuning as bS, type DocCaptureReport as bT, type DocCaptureVia as bU, type DocChecksPayload as bV, type DocEngineLike as bW, DocFeedbackAggregator as bX, type DocFeedbackKey as bY, type DocFeedbackState as bZ, type DocFormat as b_, sectionOf as ba, subscribeLivenessAssets as bb, type SubmitRuntime as bc, type HostedClientLike as bd, type DocCatalogEntry as be, type LiveMrzTuning as bf, type TextLockTuning as bg, type OcrEngineClient as bh, type DocAssistReport as bi, type ReadyInfo as bj, type LoadFailure as bk, type OcrEngineOptions as bl, ANALYSIS_LONG_EDGE as bm, ASPECT_BANDS as bn, AttestationError as bo, BLUR_REFUSE_SHARPNESS_MAX as bp, type BlurStatus as bq, CAPTURE_CANDIDATE_SPACING_MS as br, CAPTURE_EXTRA_CANDIDATES as bs, CHALLENGE_EXECUTE_TIMEOUT_MS as bt, CHALLENGE_READY_TIMEOUT_MS as bu, CLIP_MIME_ALLOWLIST as bv, type CaptureEngine as bw, CaptureSessionDoc as bx, type CaptureSessionDocEvents as by, type CaptureSessionDocOptions as bz, type CaptureChannel as c, REGISTRY_RETRY_DELAY_MS as c$, type DocFrameMeasures as c0, type DocGateQuality as c1, type DocGateThresholds as c2, type DocGateTick as c3, type DocGateTickInput as c4, DocGateV1 as c5, type DocQuad as c6, type DocQuadPoint as c7, type DocShutterReason as c8, type DocShutterTuning as c9, LIVE_PHOTO_MAX_HZ as cA, type LandmarkedFace as cB, type LandmarkerLike as cC, type LensSource as cD, type LightingStatus as cE, type LiveMrzCapture as cF, type LiveMrzState as cG, type LivePhotoGate as cH, type LivePhotoKit as cI, type LivePhotoKitInternals as cJ, type LivePhotoKitOptions as cK, type LivePhotoStill as cL, type LivenessCaptureInternalHandle as cM, type LivenessCaptureInternals as cN, type LivenessFlowDeps as cO, type LivenessFlowOutcome as cP, MANUAL_SHUTTER_MS as cQ, MR_DOC_CATALOG as cR, NO_REPORT_MS as cS, type OpenDocCameraDeps as cT, PORTRAIT_JPEG_QUALITY as cU, PRELOAD_BLAZE_INIT_TIMEOUT_MS as cV, PRELOAD_BUDGET_MS as cW, PROCESSING_POLL_DELAY_MS as cX, PROCESSING_POLL_MAX as cY, type PortraitCaptureController as cZ, type PortraitCaptureInternals as c_, type DocSide as ca, type DocumentCaptureController as cb, type DocumentCaptureInternals as cc, EMPTY_GUIDE_METRICS as cd, type EncodedDocument as ce, type ExecuteChallengeOptions as cf, FLIP_FILL_MIN as cg, FLIP_GAP_MS as ch, FLIP_TIMEOUT_MS as ci, type FocusCaps as cj, type FramingStatus as ck, GUIDE_LOCK_DEFAULTS as cl, type GlareStatus as cm, type GrabbedFrame as cn, type GuideBlocker as co, GuideLock as cp, type GuideLockTick as cq, type GuideLockTuning as cr, type GuideMetrics as cs, type GuideRect as ct, INFERENCE_RETRY_ATTEMPTS as cu, INFERENCE_RETRY_DEFAULT_S as cv, LANDMARKER_MODEL as cw, LENS_STORAGE_KEY as cx, LIVE_MRZ_DEFAULTS as cy, LIVE_PHOTO_IDLE_MS as cz, type CaptureEngineId as d, supportsFocusMode as d$, type ReticleType as d0, SAME_FACE_MAX_DROPS as d1, type ScanEvent as d2, type ScanLayout as d3, type ScanNotice as d4, type ScanPhase as d5, type ScanReport as d6, type ScanSide as d7, type ScanState as d8, type SubmitExecutor as d9, mapEngineState as dA, mapErrorKind as dB, mapGuidanceHint as dC, nextScanState as dD, observe as dE, openDocCamera as dF, passportBandOf as dG, portraitMatchStep as dH, preloadedDetectorFactory as dI, quadAreaFrac as dJ, quadBounds as dK, quadIou as dL, quadTiltRatio as dM, randomUuid as dN, readStoredLens as dO, resetChallengeFrameForTests as dP, resetLivenessAssetsForTests as dQ, resolveDocCameraTuning as dR, resolveDocShutterTuning as dS, resolveGuideLockTuning as dT, runLivenessFlow as dU, runSubmission as dV, scannerFormatFor as dW, setPreloadLoaderForTests as dX, settledHint as dY, singleShotFocusAt as dZ, specularFraction as d_, TEXT_LOCK_DEFAULTS as da, TRANSPORT_REPLAY_ATTEMPTS as db, TRANSPORT_REPLAY_DELAY_MS as dc, type VerificationInternals as dd, analyzeDocFrame as de, analyzeGuide as df, aspectBand as dg, aspectFits as dh, buildDeviceReadHint as di, coverPointToVideo as dj, createDocumentCaptureInternal as dk, createFaceLandmarker as dl, createLivePhotoKit as dm, createLivenessCaptureInternal as dn, createPortraitCaptureInternal as dp, createVerificationInternal as dq, docZoomFor as dr, encodeDocumentImage as ds, executeChallenge as dt, facesOf as du, feedbackVoteOf as dv, focusOk as dw, guideQuad as dx, guideRegionInFrame as dy, initialScanState as dz, type CaptureError as e, warmDocDetector as e0, writeStoredLens as e1, 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 ChallengeErrorCode as m, type ChoiceOptionSnapshot as n, type ChoiceSnapshot as o, type ChoiceStepHandle as p, type ContactChoiceSnapshot as q, type ContactChoiceStepHandle as r, DEFAULT_API_ORIGIN as s, DOCUMENT_TYPE_ORDER as t, type DeriveStepEnv as u, type DocumentCaptureEvents as v, type DocumentCaptureState as w, type DocumentFeedback as x, type DocumentFeedbackKey as y, type DocumentGateUpdate as z };