@sekyro/react 0.1.0-rc.4 → 0.1.0-rc.41

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 (61) hide show
  1. package/CHANGELOG.md +636 -0
  2. package/LICENSE +25 -16
  3. package/README.md +179 -37
  4. package/dist/chunk-2KED7D2Q.js +2 -0
  5. package/dist/chunk-2SVN4T5I.js +2 -0
  6. package/dist/chunk-55NNQK5P.js +2 -0
  7. package/dist/chunk-5JJT6XTG.js +2 -0
  8. package/dist/chunk-7MMT5M4E.js +2 -0
  9. package/dist/chunk-A7C3KQ7K.js +2 -0
  10. package/dist/chunk-B26PUCMP.js +2 -0
  11. package/dist/chunk-FE6AS435.js +2 -0
  12. package/dist/chunk-GUTF3SPK.js +2 -0
  13. package/dist/chunk-HJDSATKF.js +2 -0
  14. package/dist/chunk-MDXA7C7O.js +2 -0
  15. package/dist/chunk-NZKIRHZR.js +2 -0
  16. package/dist/chunk-OLU5EOHP.js +2 -0
  17. package/dist/chunk-P7QMLT56.js +2 -0
  18. package/dist/chunk-Q7TAM5DA.js +2 -0
  19. package/dist/chunk-SRQXICOI.js +2 -0
  20. package/dist/chunk-TLYACCNO.js +2 -0
  21. package/dist/chunk-V3BQZTXH.js +2 -0
  22. package/dist/chunk-WIHBHY2K.js +2 -0
  23. package/dist/chunk-ZARKJW2C.js +2 -0
  24. package/dist/document-capture-view-ZQONDCSM.js +2 -0
  25. package/dist/eid-view-FEJHQBSB.js +2 -0
  26. package/dist/email-otp-view-4EY5CKR5.js +2 -0
  27. package/dist/flow-views-JC2DWBW3.js +2 -0
  28. package/dist/fonts/Cairo-OFL.txt +93 -0
  29. package/dist/fonts/Geist-OFL.txt +93 -0
  30. package/dist/fonts/Inter-OFL.txt +93 -0
  31. package/dist/fonts/SekyroCairo-Bold.woff2 +0 -0
  32. package/dist/fonts/SekyroCairo-Regular.woff2 +0 -0
  33. package/dist/fonts/SekyroCairo-SemiBold.woff2 +0 -0
  34. package/dist/fonts/SekyroGeist-Bold.woff2 +0 -0
  35. package/dist/fonts/SekyroGeist-SemiBold.woff2 +0 -0
  36. package/dist/fonts/SekyroInter-Medium.woff2 +0 -0
  37. package/dist/fonts/SekyroInter-Regular.woff2 +0 -0
  38. package/dist/fonts/SekyroInter-SemiBold.woff2 +0 -0
  39. package/dist/form-view-GPITA6X5.js +2 -0
  40. package/dist/index.cjs +1 -2
  41. package/dist/index.d.cts +7 -382
  42. package/dist/index.d.ts +7 -382
  43. package/dist/index.js +1 -2
  44. package/dist/overlay-de-7NCDPEIN.js +2 -0
  45. package/dist/overlay-es-6MGCPCFO.js +2 -0
  46. package/dist/overlay-pt-VTK6XJDH.js +2 -0
  47. package/dist/portrait-capture-view-Q6XYTGE7.js +2 -0
  48. package/dist/portrait-review-view-KZVKR6XN.js +2 -0
  49. package/dist/proof-of-address-view-YYZTILHQ.js +2 -0
  50. package/dist/styles.css +35 -11
  51. package/dist/theme-BhxSZSbp.d.cts +548 -0
  52. package/dist/theme-BhxSZSbp.d.ts +548 -0
  53. package/dist/verification/index.cjs +2 -0
  54. package/dist/verification/index.d.cts +895 -0
  55. package/dist/verification/index.d.ts +895 -0
  56. package/dist/verification/index.js +2 -0
  57. package/dist/verification.css +868 -0
  58. package/package.json +26 -13
  59. package/sbom.cdx.json +153 -0
  60. package/dist/index.cjs.map +0 -1
  61. package/dist/index.js.map +0 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,641 @@
1
1
  # @sekyro/react
2
2
 
3
+ ## 0.1.0-rc.41
4
+
5
+ ### Patch Changes
6
+
7
+ - 67d39fe: The confirm details screen shows the person's name in Arabic script on an Arabic page when the document or the chip gives one, with the father's name when the document prints it. Other pages show the Latin name.
8
+ - Updated dependencies [67d39fe]
9
+ - @sekyro/web@0.1.0-rc.43
10
+
11
+ ## 0.1.0-rc.40
12
+
13
+ ### Patch Changes
14
+
15
+ - 07f89de: Document camera: each slot under the frame shows the photo the server holds for that face, and a "could not read" notice goes as soon as a new photo is taken instead of staying through that photo's check.
16
+ - 9bcc9c1: When a document step ends because its attempts ran out on one side of the document, the result screen now says the other side never came ("We did not receive the other side of your document before your attempts ran out"), in all six languages, instead of saying the captures were not clear enough.
17
+ - Updated dependencies [07f89de]
18
+ - @sekyro/web@0.1.0-rc.42
19
+
20
+ ## 0.1.0-rc.39
21
+
22
+ ### Patch Changes
23
+
24
+ - f341f83: Verification flow, document step: when the browser check does not complete, the camera screen says so and offers "Try again" (or asks the person to set the date and time when the device clock is wrong). The photos already taken stay in the tray and are sent again on the retry; the screen no longer says the document is being checked while it waits, and no longer asks for a side again. Other steps show the clock message when the check refused the device's clock.
25
+ - 49bb89b: Document camera: when the on-device MRZ read shows the document has expired and the verification refuses expired documents, the band under the frame says "This document has expired. Scan a valid document." (new string `native.scan.expired`, six languages) and no photo of it is taken. "Hold still" and the green frame show again while the scanner locks, before the photo. In the tray, "Received" is shown only for a side the server held before the camera opened; a photo taken on this camera no longer shows it while its thumbnail is prepared.
26
+ - 8f3fb74: Verification flow: a side of the document the server already holds shows as "Received" in the captured-sides tray (new string `doc.sideReceived`, six languages). A liveness retake that was inconclusive, or whose hint is about the light, no longer repeats the light tip: it shows "Before you film again:" with the eye-level and head tips, and the reworded `reasons.liveness_inconclusive` / `hints.appearance` say "We couldn't confirm it's you this time. Hold still and let's try once more." A reason with its own fix keeps its own tips.
27
+ - Updated dependencies [f341f83]
28
+ - Updated dependencies [62dd01e]
29
+ - Updated dependencies
30
+ - Updated dependencies [00bc614]
31
+ - Updated dependencies [49bb89b]
32
+ - Updated dependencies [8f3fb74]
33
+ - @sekyro/web@0.1.0-rc.41
34
+
35
+ ## 0.1.0-rc.38
36
+
37
+ ### Patch Changes
38
+
39
+ - 4f4bd85: The tester gate says why it did not recognise the person. `verification.testerGate()` resolves `missReason` when the server sends it (`retake`: the face could not be checked clearly, film again, the try does not count; `liveness`: the liveness check failed; `no_match`: no enrolled tester matched), typed `TesterGateMissReason` (also on `TesterGateResponse`). `<SekyroVerification>` shows the matching copy in the six locales and always offers to film again after a retake.
40
+ - Updated dependencies [4f4bd85]
41
+ - @sekyro/web@0.1.0-rc.40
42
+
43
+ ## 0.1.0-rc.37
44
+
45
+ ### Patch Changes
46
+
47
+ - 9610931: Japan: the My Number card (Individual Number Card) is captured and read from its front only. Its back holds the My Number, which the law limits who may collect (My Number Act, Arts. 19-20), so the capture plan leaves it out and the server refuses a back sent anyway with the new retryable reason `document_side_not_read` (not billed, nothing kept), shown with its own retake line. The Japanese residence card and driving licence numbers people type are checked against their formats.
48
+ - 10715ba: Document capture: a method that serves only some countries (a population registry, a national eID) is a row on those countries' document type lists, listed first, and no longer a switch under another country's documents. After picking Senegal, no « Enter my Mauritanian NNI »; Mauritania lists Numéro national (NNI), Carte d'identité, Passeport, Carte de séjour. Choice options carry `countries` and `names` from the server; the row label comes from that data (`laneOptionsFor`, `optionNameFor` in @sekyro/web).
49
+ - Updated dependencies [9610931]
50
+ - Updated dependencies [10715ba]
51
+ - @sekyro/web@0.1.0-rc.39
52
+
53
+ ## 0.1.0-rc.36
54
+
55
+ ### Patch Changes
56
+
57
+ - ae5142b: Document capture on low-end phones: the back of a card held still reaches the server again. A photo the live MRZ reader fired on is the MRZ face (the band classifier is not asked). After two same-face drops the next photo goes to the server as the missing face, a drop no longer waits for a flip the phone did not see, and the notice clears once the card leaves the guide. The server asking for the face the camera already waits on no longer restarts the scan. On the low reader tier the live MRZ read holds the auto-capture back for 3 s at most and the still confirmation (`deviceRead`) is skipped. Low-end devices keep the 1080p camera with the live reader (no 2560 × 1440 stream) and take the first still (no best-frame window). The barcode decoder has a 1.5 s budget per photo, after which the capture order decides. The React capture view no longer re-renders for sub-pixel bracket moves.
58
+ - Updated dependencies [7528fca]
59
+ - Updated dependencies [451cd78]
60
+ - Updated dependencies [4743339]
61
+ - Updated dependencies [ae5142b]
62
+ - @sekyro/web@0.1.0-rc.38
63
+
64
+ ## 0.1.0-rc.35
65
+
66
+ ### Patch Changes
67
+
68
+ - 8bbc6f8: The header under the organisation name says "Contact verification" for a level-1 flow (contact or device steps only, Device and network plus Form included) instead of "Human verification", in all six languages (new string `shell.subtitleContact`). Level 2 and 3 flows keep "Human verification" and "Identity verification". Same on Android and iOS.
69
+ - 3617649: Document capture: the intro names the picked document ("Photograph your passport"), and when the picked country accepts one type only, so no type was asked, one line says so ("Algeria: only a passport is accepted here."). The mark follows the type (a passport page with the booklet behind it and its code lines, or a card front), is smaller, and the lead and two tips are shorter, so the intro fits a phone screen without scrolling; a short screen drops the mark. Same on Android and iOS.
70
+ - Updated dependencies [8bbc6f8]
71
+ - @sekyro/web@0.1.0-rc.36
72
+
73
+ ## 0.1.0-rc.34
74
+
75
+ ### Patch Changes
76
+
77
+ - ba23547: The document camera keeps its instruction at the top steady: it says what to scan and nothing else. Problems and capture hints now show in a warning band directly under the scan frame. A wrong document says what the camera saw and what to show instead ("This looks like a passport. Show your residence permit instead.") and stays until a later photo is taken; it is no longer replaced after 2 seconds. A refused photo (blurry, unreadable, same side, a server retake reason with the attempts left) stays at least 3 seconds and through the retake, so a second refusal never makes the band blink. Capture hints (glare, too far, too dark, the code-line reader's coaching) stay at least 2.5 seconds once shown. The band is a polite live region and grows in and out, so nothing under it jumps. New string keys: `native.scan.seenPassport`, `native.scan.seenCard`, `native.scan.showInstead.{carte_identite,passport,residence_permit,drivers_license}`.
78
+ - d8b6db7: Document capture: when the back comes from a different card than the front, the retake now says so plainly: "This back belongs to a different card. Turn over the card you photographed first and scan its back." (fr, ar, es, pt, de alike). No API change.
79
+ - Updated dependencies [675fc46]
80
+ - @sekyro/web@0.1.0-rc.35
81
+
82
+ ## 0.1.0-rc.33
83
+
84
+ ### Patch Changes
85
+
86
+ - 9a15ded: Voice guidance now plays its first prompt when the capture starts on its own, before the person has tapped the page. Browsers refuse audio until the first tap. Before, that first prompt was counted as spoken and never played, so a cold page load stayed silent until the guidance changed. Now the refused prompt plays on the first tap, once. Prompts still play one at a time, a newer prompt replaces a waiting one, and a prompt never repeats.
87
+
88
+ ## 0.1.0-rc.32
89
+
90
+ ### Patch Changes
91
+
92
+ - b884dc6: Requires `@sekyro/web` 0.1.0-rc.34 or later, which sends the verification's `locale` on every hosted API call, so your Form step's questions, intro and consent text show in the person's language even when the form is the first screen. Bump both packages together.
93
+ - Updated dependencies [e38c7e2]
94
+ - Updated dependencies [5c2b1fa]
95
+ - Updated dependencies [24c87ef]
96
+ - Updated dependencies [ea2bd51]
97
+ - Updated dependencies [b3a1018]
98
+ - @sekyro/web@0.1.0-rc.34
99
+
100
+ ## 0.1.0-rc.31
101
+
102
+ ### Patch Changes
103
+
104
+ - b61c1b7: When the browser check fails because the phone's date and time are wrong (`attestationError: "clock_wrong"`), `<LivenessCapture>` says "Set your phone's date and time to automatic, then try again" (`errors.device_clock`, six languages). After a failed browser check the button reads "Try again" and resubmits the same video instead of starting a new attempt.
105
+ - Updated dependencies [b61c1b7]
106
+ - @sekyro/web@0.1.0-rc.33
107
+
108
+ ## 0.1.0-rc.30
109
+
110
+ ### Minor Changes
111
+
112
+ - 18265a3: A neutral end for suspected fraud. When a session fails in a way the page does not explain (a fraud-grade failure, or a stop by an automatic block), the session view and the result handed to your client say `status: "not_verified"`, `reason: "rejected"` and the new view-only `reasonCode: "identity_not_verified"` (`SessionFailureReason`), with no `retryAfter`. The code is never stored and never appears in the partner API or webhooks: read the session's real outcome on your server. `@sekyro/react` shows the rejected title and "We couldn't verify your identity. Contact {org} for help." (without an organization name: "Contact the organization that sent you this link for help."), in six languages (`reasons.identity_not_verified`, `session.result.identityNotVerified`).
113
+
114
+ ### Patch Changes
115
+
116
+ - 7a73651: When the browser blocks the camera, `<SekyroVerification>` now always shows how to allow it in this browser (Chrome, Samsung Internet, Safari or a computer, plus the phone's own camera setting), and an app's own browser (Facebook, Instagram, a WebView) is asked to open the page in Chrome or Safari. "Try again" asks the camera again only on a tap, and while the browser still reports the camera as blocked it says so instead of failing again at once. Eight new `capture.noCamera.*` keys, in every built-in language.
117
+ - Updated dependencies [7a73651]
118
+ - Updated dependencies [18265a3]
119
+ - @sekyro/web@0.1.0-rc.32
120
+
121
+ ## 0.1.0-rc.29
122
+
123
+ ### Minor Changes
124
+
125
+ - ae5e1c6: The colour flash speaks its line: `capture.lookAtColours` ("Look at the colours") is now a voice key (`VOICE_KEYS`, `VoiceKey`), spoken once as the flash starts, from the session's clip when it has one, else the device voice. `onGuidance` reports it too. The Android and iOS drop-ins speak it the same way.
126
+
127
+ ### Patch Changes
128
+
129
+ - a649247: Use with `@sekyro/web` 0.1.0-rc.31 or later: one browser check per session (plus one per code send), started when the session loads, and a "Try again" after a failed check submits the same selfie video again instead of filming it again. The security check error now reads "We could not complete the security check. Check your connection and try again" (all six languages), since reloading the page is no longer needed. Bump both packages together.
130
+ - Updated dependencies [a649247]
131
+ - @sekyro/web@0.1.0-rc.31
132
+
133
+ ## 0.1.0-rc.28
134
+
135
+ ### Patch Changes
136
+
137
+ - a02fe2f: Requires `@sekyro/web` 0.1.0-rc.30 or later, which gives the browser security check the time slow phones need (a 120 s limit, no restart while a slow check is still running, and a fresh check when the camera starts). Bump both packages together.
138
+ - Updated dependencies [e70fdcd]
139
+ - @sekyro/web@0.1.0-rc.30
140
+
141
+ ## 0.1.0-rc.27
142
+
143
+ ### Minor Changes
144
+
145
+ - 1e6001c: Two new document reasons. `document_sides_mismatch` (`DocReason`): the front and the back of the card are from two different cards. It is retryable and not billed. When the front was read first the server keeps it (`acceptedSides: ["recto"]`) and the camera asks for the back only; when the back was read first both faces are dropped and the camera starts the card again. `@sekyro/react` shows `doc.reason_document_sides_mismatch` (six languages) without the photo tips. `document_photo_mismatch` (`DocReason` and `NfcChipReason`): the portrait on the document, or in its chip, is a different person from the registry's photo for its identity number. It is final: the session ends rejected.
146
+ - 06d8764: New document step reason `document_type_not_supported`: the document type chosen cannot be used in this flow (it has no machine-readable zone the flow accepts, or the session does not offer it). It is retryable and not billed. The step comes back with `documentType: null`, so the picker reopens, and the refused type is no longer in `step.documents`; when no other type is left, the step fails with this reason. `@sekyro/react` shows `doc.reason_document_type_not_supported` (six languages) without the photo tips. `identity.document.evidence` says what the identity was read from (`mrz`, `barcode`, `visual` or `chip`).
147
+ - 1c7c752: The Form step's copy in ar, fr, en, es, pt and de (`form.*` and the `form` section title): the ready-made field labels, the buttons, "optional" and the person's errors. It loads with the step's own lazy chunk once the step is rendered.
148
+ - 8a832f3: `<SekyroVerification>` draws the Form step with the new `<FormStep>` (a lazy view): one column of the partner's questions, the consents last and one "Continue". New controls, styled with the flow's tokens and logical properties: text and long text, a radio group and a checkbox group as touch rows (arrow keys move in both), yes or no, a day / month / year date, a country list named by the browser in the page language, a phone number with its country code, an address, and consent checkboxes with their link. Every control has a visible label, "optional" on the questions that are, its help and error tied to it; a refused submit puts each error under its question, announces it and moves the focus to the first one. The partner's text keeps its own `lang` and `dir`; prefilled answers stay editable.
149
+ - 1b8395d: Flows that take their photos in a native app only. When a flow's Device & Network step is set to capture on "Native app or SDK only", its camera steps carry `requiresNativeApp` and the view carries `nativeApp` (`HostedNativeAppView`: whether the Sekyro AI app is allowed, the session link and the Sekyro AI app link). In a browser such a step is the new `native_app_required` step (`NativeAppRequiredStepHandle`, with `refresh`) instead of the camera. A submission from a browser answers `409 native_app_required` (new in `KNOWN_CODES`); the SDK re-reads the session and shows that step. `@sekyro/react` renders it: the partner's app and, when allowed, the Sekyro AI app (open link on a phone, store links, the session QR on a desktop), in six languages (`needsApp.capture.*`).
150
+ - 43ae1ec: New prop `documentBarcodeAssetBaseUrl` on `<SekyroVerification>` and `<SekyroFlow>` to self-host the barcode decoder binary that `@sekyro/web` uses to tell the faces of a document without an MRZ apart (`<base>/<sha12>/zxing_reader.wasm`). Without it, the binary comes from Sekyro AI's asset host. It is passed to the camera for every document type, a driving licence included.
151
+ - 62faf99: During the self capture's colour flash (the screen ramp), the camera now says "Look at the colours" from the first colour until the layer clears, and stays in its recording state until then: a gate hint, the host's `coach` line or the still arriving before the last colour clears no longer replace the line or freeze the stage. The flash itself (colours, order and timings) is unchanged, and assisted capture has no flash. New string `capture.lookAtColours` in every language.
152
+ - 80fbf3d: The document step now tells the server which document type and issuing country the person picked, on every side (camera and upload). A document that is not the one picked is refused with `document_type_mismatch`.
153
+
154
+ ### Patch Changes
155
+
156
+ - 9d173d9: `<SekyroVerification>` titles no longer change shape when Geist arrives: until the title face has loaded they are drawn in a metric-matched bold fallback (Arial Bold or Roboto Bold, sized to Geist), where they used to show Inter or the system face at a different width, so the title reflowed when Geist arrived. The result title now uses the flow's hero size (28 px), as on iOS and Android. A partner font still replaces the titles' face.
157
+ - 1411e5b: The phone number field's country code opens a country list under the field, as on Android and iOS: each row has the flag, the country's name and its calling code, the current country is marked, a search shows above eight countries, and "Another country" is the last row when the flow takes any number. Escape closes it. The segment is a button named "Country: {name} ({calling code})". New string `otp.countrySearch`.
158
+ - 4ab4df6: The native-only capture screen's App Store link opens the Sekyro AI app's listing instead of an App Store search.
159
+ - 567f41a: A refused Form submit now shows which questions to change. The client reads the server's `details.errors` (one `{ id, code }` per refused question) and turns each server code into its own `FormIssue` code, with the limit its message names, so every error appears under its question; a card number keeps its own message. `HostedErrorDetails` gains the optional `errors` list. With no details, the client's own check runs again on what was sent. When a refusal names no question of the form, the Form screen says the answers could not be sent instead of staying silent.
160
+ - Updated dependencies [1e6001c]
161
+ - Updated dependencies [06d8764]
162
+ - Updated dependencies [1c7c752]
163
+ - Updated dependencies [030c9dc]
164
+ - Updated dependencies [4581cc5]
165
+ - Updated dependencies [1b8395d]
166
+ - Updated dependencies [43ae1ec]
167
+ - Updated dependencies [a63d45e]
168
+ - Updated dependencies [98f6752]
169
+ - Updated dependencies [567f41a]
170
+ - Updated dependencies [a75a33e]
171
+ - Updated dependencies [80fbf3d]
172
+ - @sekyro/web@0.1.0-rc.29
173
+
174
+ ## 0.1.0-rc.26
175
+
176
+ ### Patch Changes
177
+
178
+ - ee0a55c: The package description now names the six languages the SDK supports: Arabic, French, English, Spanish, Portuguese and German.
179
+
180
+ ## 0.1.0-rc.25
181
+
182
+ ### Minor Changes
183
+
184
+ - 14faf9e: The result screen of a simulated Sandbox session now shows a short notice: "This was a simulation", with what to do to run real checks (enroll a Sandbox tester, or run the tester check at the start of the session). It appears only on a Sandbox session that no enrolled tester ran, never in Live, and it follows your theme and the six languages. The result you receive (`onResult`, `onClose`, the `sekyro-result` event) carries `sandbox: { simulated: true, reason }` with `@sekyro/web` at this release or later. Three string keys are new and can be overridden through `strings`: `sandbox.simulatedTitle`, `sandbox.simulatedNoTesters` and `sandbox.simulatedGate`.
185
+
186
+ ### Patch Changes
187
+
188
+ - f3470cd: The result screen's words fit a person who is still in your app or page. The verified line reads "Your verification is complete." (no more "You can go back to {org}"). The inconclusive, unavailable and expired screens no longer ask for a new link: inconclusive says "Start again from {org}, in good light and holding the phone upright. Contact {org} if this keeps happening.", unavailable says "Try again later from {org}, or contact {org} if this keeps happening.", and expired is titled "This verification has ended" with "Start again from {org}.". The verified title now says what the session proved, from `result.level` and `result.assurance`: "Your identity is verified" at level 3, "Your phone number is confirmed" or "Your email address is confirmed" for a level 1 code, and "You're verified" otherwise (level 2, a liveness check, no longer claims an identity). All six languages. New string keys you can override through `strings`: `native.result.expiredTitle`, `session.result.verified.titleHuman`, `session.result.verified.titlePhone`, `session.result.verified.titleEmail`.
189
+ - 5379d91: A level 1 result that is not exactly one phone code or one email code (for example both confirmed, or a contact your organization supplied) is now titled "Your details are confirmed" instead of "You're verified". Level 2 and a result with no level keep "You're verified". The same on Android, iOS and Flutter. All six languages. New string key you can override through `strings`: `session.result.verified.titleContact`.
190
+ - e971f5d: The verified result draws its mark again: a soft green band traces round, the disc springs in, then the check draws. Reduced motion shows the finished mark.
191
+ - Updated dependencies [94565f2]
192
+ - Updated dependencies [14faf9e]
193
+ - @sekyro/web@0.1.0-rc.28
194
+
195
+ ## 0.1.0-rc.24
196
+
197
+ ### Patch Changes
198
+
199
+ - 3aab1fe: The result screen's button now reads "Continue" for every outcome (fr « Continuer », ar «متابعة», es "Continuar", pt "Continuar", de "Weiter"), with or without an organization name. The flow runs inside your app or page, so the person never left it: "Back to {org}" made people think they had. The dead-end pages (update needed, a step this browser cannot do) use the same button. Nothing else changes: the button still shows only when you pass `onClose`, and pressing it still calls `onClose({ reason: "finished", result })`. The string key `native.result.back` is replaced by `native.result.continue`; if you override the label through `strings`, rename the key.
200
+
201
+ ## 0.1.0-rc.23
202
+
203
+ ### Minor Changes
204
+
205
+ - 707ccc7: Levels are renumbered: `1` Contact, `2` Human, `3` Identity, `0` when nothing was proven. `VerificationAssurance` gains the Contact values `device_only`, `contact_email`, `contact_phone` and `unbound_identity`. A result's `level` stays a display hint: a check for a real person is now `level >= 2` and a check for identity `level >= 3`. To require a particular proof, compare `assurance` with a list of accepted values on your server, for example `["registry_biometric"]`.
206
+
207
+ ### Patch Changes
208
+
209
+ - Updated dependencies [707ccc7]
210
+ - @sekyro/web@0.1.0-rc.27
211
+
212
+ ## 0.1.0-rc.22
213
+
214
+ ### Minor Changes
215
+
216
+ - 7822734: Proof of address and the driver's license. `<SekyroVerification>` renders the new `proof_of_address` step with `<ProofOfAddress>` (also exported from `@sekyro/react/verification`): the accepted documents for the person's country ("Accepted for {country}", the country named through `Intl.DisplayNames`, or "Accepted documents"), each kind with its own "dated within the last N days"; a file picker for 1 to 3 photos or one PDF, a page camera with one photo per page, or the choice between them per the step's source; the phone hand-over for the camera on a desktop; the retry reason with what to do next; and the bill holder's letter. Its screens and copy (`poa.*` and the nine new reasons, in six languages) load on demand. While the step accepts the address the driver's license gave, it offers "Use the address on my driver's license" (`poa.licence.use`, `poa.licence.note`). The document picker names the driver's license (`doc.type.drivers_license`, `doc.sub.drivers_license`) and its camera skips the live MRZ hint. The document step says what to do next after the license reasons `document_type_mismatch`, `document_number_invalid` and `provider_unavailable` (`doc.reason_*`, six languages). New `StepStrings` keys: `handoff.lead.poa`, `session.processing.proof_of_address.*`, `section.documents`, the license labels, and the optional `poa.*` and reason keys.
217
+
218
+ ### Patch Changes
219
+
220
+ - Updated dependencies [246b0f3]
221
+ - Updated dependencies [cc7eedb]
222
+ - @sekyro/web@0.1.0-rc.26
223
+
224
+ ## 0.1.0-rc.21
225
+
226
+ ### Patch Changes
227
+
228
+ - 0d23a56: Works with the `@sekyro/web` security check frame: a result with `reasonCode: 'attestation'` keeps the `errors.attestation_invalid` copy and now carries `attestationError`, so your UI can tell a frame your page blocked (`challenge_frame_blocked`: allow `frame-src https://verify.sekyro.ai` in your Content-Security-Policy) from a token the server refused. The `challenges.cloudflare.com` CSP entries are no longer needed.
229
+ - Updated dependencies [0d23a56]
230
+ - @sekyro/web@0.1.0-rc.25
231
+
232
+ ## 0.1.0-rc.20
233
+
234
+ ### Minor Changes
235
+
236
+ - f7b755c: `<SekyroVerification>` shows the "Test session" badge in its header on a Sandbox session (`context.sandbox`), in the six locales, as the iOS and Android flows do. New string key `app.sandboxBadge`.
237
+ - 3eafb6e: `<SekyroVerification>` offers "Run real checks as a tester" next to "Skip with test data" while the session offers the tester gate: one liveness capture, then real checks or test data. The browser remembers a recognised tester for 30 days and opens the gate first next time (the face still decides); "Continue with test data" forgets it. Copy `testerGate.*` in the six locales.
238
+
239
+ ### Patch Changes
240
+
241
+ - 9db1219: A face match retry now reopens the liveness step, so the person records a new video and the face match runs on it. The face retake screen says so: "We couldn't confirm it's you. Record the video again in good light, without glasses" (new string `capture.retryMatch.message` in every language) for `match_inconclusive`, `no_face_source` and `below_threshold`. The 0.1 `reasons.*` wording is unchanged.
242
+ - 8dc6b2b: Next.js App Router: a test now proves that both entries import and server-render in Node without a DOM and that every built file starts with `"use client"`. The README gains a "Next.js App Router" section (Server Action, client component, stylesheets, webhook route handler).
243
+ - Updated dependencies [f7b755c]
244
+ - Updated dependencies [3eafb6e]
245
+ - Updated dependencies [d25960c]
246
+ - @sekyro/web@0.1.0-rc.23
247
+
248
+ ## 0.1.0-rc.19
249
+
250
+ ### Minor Changes
251
+
252
+ - ad0d148: Assisted capture uses the back camera only, on the liveness and the portrait cameras, as self capture uses the front camera only. `switchCamera()` on `LivenessCaptureHandle` and `PortraitCaptureHandle` does nothing and returns `false`, and a `facing` option or `start({ facing })` asking for the other camera is ignored; both log one console warning per handle. Under capture mode `choice` the person still switches the mode (`setCaptureMode`), and the camera follows it. `CapturedPortrait.facingMode` reports the camera the photo was taken with, and the portrait submission sends it as `input.capture.facingMode`. New reason `capture_front_camera` on `LivenessReason` and `PortraitIcaoReason`: an assisted capture reported on the front camera is refused before scoring, retryable, not billed and not counted as an attempt (in `RETRYABLE_REASONS`).
253
+
254
+ `@sekyro/react`: the front/back camera choice before an assisted capture and the flip button on the liveness and portrait cameras are gone. `IntroContext` no longer has `setFacing` or `canChooseFacing`; `IntroContext.facing` is the capture mode's camera. The new `reasons.capture_front_camera` string comes in every language.
255
+ - ad0d148: Under capture mode `choice` the person switches between filming themselves and being filmed on the camera view. `LivenessCaptureHandle.canSwitchCaptureMode()` says whether the switch is offered (a device with a front and a back camera), and `LivenessCaptureHandle.setCaptureMode(mode)` switches: the pick is recorded for the session (`Verification.chooseCaptureMode`), a running take restarts in the new mode (the recording is dropped, never submitted, and `CaptureState` passes through `mode_switch`), and the camera reopens on the front camera for `self` and the back one for `assisted`. The mode sets the camera.
256
+
257
+ `@sekyro/react`: `<LivenessCapture>` no longer asks who films before the liveness camera opens. Under `choice` the stage shows a chip in its end corner ("Someone is helping me", then "I film myself") that switches the mode and restarts the take with a "Camera switched" status line; a one-camera device does not show it. The new `capture.modeSwitch.*` strings come in every language. The portrait step keeps its who-takes-the-photo question.
258
+ - ad0d148: Every camera step hands off to a phone on a desktop browser, in every decision mode. `deriveStep` turns a `doc_ocr` or `portrait_icao` step that `requiresMobile` with the camera as its source into the `mobile_required` step (`MobileRequiredSnapshot.checkType` gains `doc_ocr` and `portrait_icao`); a `choice` photo step stays on the desktop with `photo.cameraOnPhone: true`, its upload offered and `refresh()` on the document and portrait handles. `Verification.mobileRequired()` covers every camera step. Under capture mode `choice`, `HostedCaptureTuning.pick` is the session's latest mode and the cameras open in it (`Verification.captureChoice` reports it). `detectFormFactor()` reads Windows and ChromeOS touch devices as desktops; iPadOS stays a tablet; a browser whose client hints (`navigator.userAgentData`) say `mobile` or an Android, iOS or iPadOS platform is never a desktop, so an Android phone in "desktop site" mode (a Windows user agent) is not handed off. The reason `uncalibrated_capture_channel` is gone from `LivenessReason`; `@sekyro/react` keeps its `reasons.uncalibrated_capture_channel` wording and `Strings` entry, frozen in the 0.1 dictionaries, though no reason resolves to it.
259
+
260
+ `@sekyro/react`: `<SekyroVerification>` shows the QR of `handoffUrl` at a camera document or portrait step, with a line that says what the phone is for; a `choice` photo step offers "Continue on my phone" and "Upload a photo", and never opens the webcam. Each of these hand-overs, and the liveness hand-over, uses the styled QR code with the Sekyro AI mark in the centre at error correction level H, like the QR codes in the dashboard. The code no longer shows your branding logo, with or without one in your session branding; the rest of the page keeps your branding. The code stays navy on a white tile, in dark mode and under your branding colours.
261
+ - 0804d05: Only one person may be in the liveness video. The capture gate reads the faces its detector already finds (no new model): while another face has at least a quarter of the person's face area, the gate waits (progress drains, the clip never starts) with the new hint `one_face` on `GateHint` and resumes once one face remains. Smaller faces further back never block. The native `FaceDetector` tier now asks for up to four faces and takes the largest as the person. New reason `multiple_faces` on `LivenessReason`: the server saw a second person in the clip and asks for a new one; retryable, not billed and not counted as an attempt for up to 5 retakes per step (in `RETRYABLE_REASONS`).
262
+
263
+ `@sekyro/react`: new strings `fcv3.one_face` (the guidance line, also spoken by the device voice) and `reasons.multiple_faces` (the retake line) in every language; `hintStringKey("one_face")` and `VOICE_KEYS` include it.
264
+ - ad0d148: The portrait step switches the capture mode on its camera too, under capture mode `choice`. `PortraitCaptureHandle.canSwitchCaptureMode()` and `PortraitCaptureHandle.setCaptureMode(mode)` work as on the liveness handle: the pick is recorded for the session, the camera reopens in the new mode (front for `self`, back for `assisted`) with the gate from zero, and `PortraitCaptureState` passes through `mode_switch`. Before the photo is taken only.
265
+
266
+ `@sekyro/react`: the portrait camera opens on the person's pick (`self` before one) with the switch chip in its end corner ("Someone is helping me", then "I take the photo myself") and a "Camera switched" line; a one-camera device does not show it. The who-takes-the-photo question is gone, and with it `CaptureModePicker` and the `capture.modePicker.*` strings; the new `capture.modeSwitch.*Photo` strings come in every language.
267
+ - b426395: Retake screens teach the fix for their own reason. After a liveness retake for a reason that is not about the face or the light, the retry panel shows "Before you film again:" and the reason's tips instead of the lighting coaching: the front camera (`capture_back_camera`), the back camera and where to hold it (`capture_front_camera`), the phone upright (`capture_not_upright`), letting the recording finish (`media_unreadable`, `clip_too_short`) and the device (`device_integrity_failed`). `no_face`, `liveness_inconclusive` and the face match retries keep the face and light tips. The document intro leaves out the photo tips when the document itself is the wrong one (`document_type_not_accepted`, `tester_document_mismatch`), and the Sandbox tester reasons (`tester_document_mismatch` on the document step, `tester_phone_mismatch` on the phone step) now show their line.
268
+
269
+ New strings in every language: `capture.retryTips.title` (replaces `capture.retryOneFace.title`, same words), `capture.retryFrontCamera.*`, `capture.retryBackCamera.*`, `capture.retryUpright.*`, `capture.retryRecording.*` and `capture.retryDevice.*`.
270
+ - 2beba0c: `PopulationReason` no longer has `result_from_cache`: a passed registry step carries no reason. `@sekyro/react` drops its wording (`reasons.result_from_cache`) in every language.
271
+
272
+ An object literal that overrides `reasons.result_from_cache` (for example the strings passed to `resolveStrings` or a custom dictionary typed with the package's strings type) must drop that key, or TypeScript reports an unknown property.
273
+ - 5329680: Screen ramp v2 (the liveness colour flash): the layer paints the four saturated ramp colours and, in the dark-gap arm, black, full screen at full value with no scrim over it. The text bands keep 4.5:1 over every colour and over black.
274
+ - 81b8e9a: The result page follows the session outcome model: one screen per end state, each with its own title and explanation in all six languages. `verified`, `review`, `rejected`, `inconclusive` (no verdict could be reached: the captures were not clear enough), `unavailable` (the service could not run the check), `expired` (the person left, nobody opened the link, the organization cancelled it or a newer session took it over), `policy` (a flow rule stopped it, with the rule's own line), `cooldown` (this device may try again later) and `platform_unsupported`. The review, rejected and expired explanations are reworded. A rejection on the details the organization holds names the organization.
275
+
276
+ `<LivenessCapture>` reads `VerificationResult.reasonCode` for its lines and coaching and shows "the session expired" for a `not_verified` link that is over. The `session.result.approved.*` and `native.result.approved` strings are replaced by `session.result.verified.*` and `native.result.verified` (same words), next to the new `session.result.{inconclusive,unavailable,policy,cooldown}.*` and `native.result.{inconclusive,unavailable,policy}`.
277
+
278
+ ### Patch Changes
279
+
280
+ - 37a6305: Assisted capture asks for the back camera exactly (`facingMode: { exact: "environment" }`), then a back lens by `deviceId`, then the browser's own pick, on the liveness and the portrait cameras. When only the front camera opens, nothing is recorded or uploaded: under capture mode `choice` the take continues as a self capture on the front camera (the pick is recorded and the stage shows the mode switch), otherwise the capture fails with `kind: "notfound"` and `detail.engineKind: "backcamera"`. Before this, a browser could answer the back-camera request with the front camera, and the server refused the uploaded clip with `capture_front_camera`.
281
+
282
+ `@sekyro/react`: the camera error notice shows the new `fcv2.err.backcamera` string for that failure, in every language.
283
+ - f8eae5a: The document step returns to the camera when the server asks for a retake of a passport page (`doc_ocr` `input_required` with `unreadable` or any other retryable reason). Before, the one-face read was settled as accepted and the camera stayed on the read screen with no way forward; a card whose two faces were both in but still asked for again did the same. Both now re-read the face that was sent. `@sekyro/react`: the retake line over the camera shows the server's reason, as the native SDKs do; a re-read the device asks for by itself keeps the re-read line.
284
+ - b4f1b19: Phone code step: when the person taps WhatsApp or SMS, only the tapped button shows the loading spinner and `aria-busy`. The other channel button is disabled without a spinner until the send settles, and both are enabled again after a refused send. A polite status line tells screen readers which channel the code is being sent by, with the new `otp.sending` string in every language.
285
+ - 5299fd3: ICAO portrait retake: the panel after a failed photo says the reason once. "What to fix" lists only the failing criteria the reason does not name, and the live checklist is left out until the gate runs again. While the gate runs, the checklist flags the criteria the server failed, and an occlusion failure gets its own row (the gate does not measure occlusion).
286
+ - eb2c03a: After a face-match probe mismatch (`probe_not_from_liveness`) the server reopens the liveness step, and the face retake now says what to do: "The same person needs to be on camera from start to finish. Record the video again" (new string `capture.retrySamePerson.message` in every language). The 0.1 `reasons.probe_not_from_liveness` wording is unchanged.
287
+ - 50c4b68: The liveness screen ramp now covers the whole screen, edge to edge. Before, the colour wash was a fixed layer inside the camera stage. The page's rise animation leaves a transform on the capture's container, and a transformed ancestor makes `position: fixed` relative to that box, so the wash stopped at the flow's 24 px gutters and the sides stayed dark. The wash is now portalled into `document.body`, fixed at inset 0 and at least the large viewport, and sits under the page. While it shows, the stage and every box up to `<body>` are transparent (inline, restored when the ramp clears), and a cover in the same colour fills the stage over the camera preview, so the colour covers the whole screen, the face oval included, as on iOS and Android. The scrim steps aside, and the ring, the instruction band and the controls stay above the colour. The colours stay the fixed palette values, which partner branding does not change. The text bands keep 4.5:1. Hosts should set `viewport-fit=cover` in their viewport meta, so the colour also reaches under the notch and the home indicator.
288
+ - Updated dependencies [37a6305]
289
+ - Updated dependencies [ad0d148]
290
+ - Updated dependencies [960f295]
291
+ - Updated dependencies [ab329bc]
292
+ - Updated dependencies [ad0d148]
293
+ - Updated dependencies [ad0d148]
294
+ - Updated dependencies [f8eae5a]
295
+ - Updated dependencies [704e58a]
296
+ - Updated dependencies [59b610b]
297
+ - Updated dependencies [0804d05]
298
+ - Updated dependencies [ad0d148]
299
+ - Updated dependencies [f4840d7]
300
+ - Updated dependencies [2beba0c]
301
+ - Updated dependencies [5329680]
302
+ - Updated dependencies [c5b46c4]
303
+ - Updated dependencies [745caf9]
304
+ - Updated dependencies [1d7ee00]
305
+ - @sekyro/web@0.1.0-rc.22
306
+
307
+ ## 0.1.0-rc.18
308
+
309
+ ### Minor Changes
310
+
311
+ - f3f4313: `PortraitIcaoReason` no longer has `portrait_recaptured`: the server no longer checks a portrait photo for a photo of a screen or a print, so a portrait step never ends with that reason. `@sekyro/react` drops its wording (`reasons.portrait_recaptured`) in every language.
312
+
313
+ ### Patch Changes
314
+
315
+ - ff2011d: The document country picker lists the person's own country first, as detected from their network, when the session accepts a document from it. `HostedSessionView.detectedCountry` and the document step's `detectedCountry` carry it (ISO 3166-1 alpha-2), absent when unknown. The search still covers every accepted country.
316
+ - 74477bc: ID photo gate: a relaxed narrow mouth no longer fails "Neutral expression" (the pucker limit is 0.48 on the device), and each eye is now judged against its own usual openness, so one eye that is always less open passes while a blink or a closed eye still fails. The gate submits a baseline per eye (`gate.baselineEyeOpennessLeft` and `Right`) next to the existing one. The gate also reports its mouth scores (numbers only, no image) for Sekyro staff diagnostics. No code change on your side.
317
+ - bb79da6: Simulated Sandbox sessions now say so in the flow. `<SekyroVerification>` replaces "We sent a code" with a test-session message that shows the code to enter, and offers "Skip with test data" on the document, chip, live photo and portrait steps, before the camera opens and on the camera screen. Headless flows read `step.context.simulation` (`{ otpCode, skipCapture }`) and call `step.skipCapture()` on those steps. Nothing changes on a Live session or a session bound to a tester: the block and the action are absent.
318
+ - 994244c: The "continue on your phone" QR code now has the Sekyro AI look: round dots and rounded corner markers. When your session branding has a logo, the logo sits in the centre of the code and the code uses error correction level H, so it still scans. Without a logo the code has no centre image. If the logo fails to load, the plain code is shown. The code is always navy on a white tile, in dark mode and under your branding colours too, because phone cameras read dark codes on a light background best. You don't need to change any code.
319
+ - Updated dependencies [ff2011d]
320
+ - Updated dependencies [5f9503f]
321
+ - Updated dependencies [74477bc]
322
+ - Updated dependencies [f3f4313]
323
+ - Updated dependencies [bb79da6]
324
+ - @sekyro/web@0.1.0-rc.21
325
+
326
+ ## 0.1.0-rc.17
327
+
328
+ ### Minor Changes
329
+
330
+ - 1005d9e: The document step can take a photo of the document picked from the device. Where the photo comes from is a setting of the step: the hosted session view gains `documents` (`HostedDocumentsView`: `source` `camera`, `upload` or `choice` (`PhotoSource`), `sourcePick` once the person chose under `choice` (`PhotoSourcePick`: `camera` or `upload`), and `uploadOffered`, true when an upload is accepted now). Absent means the camera with no upload offered. Under `camera` no upload is ever offered, even when the step's camera cannot open: the step's source is final. `DocumentSnapshot.photo` (`PhotoSourceState`: `source`, `pick` and `uploadOffered`) tells the UI what to show.
331
+
332
+ `DocumentStepHandle.uploadDocument(file)` sends the picked photo for the face the step asks for and submits `doc_ocr` with `source: "upload"` (new on `DocOcrInput`; a camera photo sends `source: "camera"` when the view has a `documents` block). A JPEG or PNG within 5 MB is sent as picked; a HEIC photo is converted to JPEG on the device where the browser can decode it, and a larger photo is scaled down. It rejects with `RangeError("upload_not_offered")` while `photo.uploadOffered` is false and with `TypeError("unsupported_file")` for any other file. The photo is presigned as a declared upload (`source: "upload"` on the media request, no capture proof). `HostedClient.presign` takes `{ source: "upload" }`, and a repeated `reportCaptureIssue` now resolves when the first send settles.
333
+
334
+ `@sekyro/react` follows the step's source: the camera screen (with "Upload a photo instead" only under `choice` while an upload is offered, never under `camera`), the upload screen at once, or a "Take a photo" / "Upload a photo" choice unless the person already chose for the step.
335
+ - c17645e: The portrait step: an ICAO photo of its own, from the camera or a photo picked from the device, which the server may adjust and the person accepts. The hosted session view's `portrait` gains `source` (`PhotoSource`: `camera`, `upload` or `choice`), `sourcePick` (`PhotoSourcePick`), `uploadOffered`, `fixes`, `fixReview`, `output` (`PortraitOutputFormat`) and `pendingFix` (`HostedPortraitPendingFix`: the original and adjusted photo URLs, the fixes applied and when the URLs expire). `PortraitSnapshot` gains `photo` (`PhotoSourceState`), `pendingFix` and the `review` phase. `CaptureIssueReport.check` gains `portrait`: `@sekyro/react` reports a portrait camera that cannot open as a diagnostic. A step under `camera` never offers an upload, even then.
336
+
337
+ `PortraitStepHandle.uploadPortrait(file)` sends a photo picked from the device (converted on the device like a document upload, presigned as a declared upload without a capture proof) and submits `portrait_icao` with `source: "upload"`; it rejects with `RangeError("upload_not_offered")` while `photo.uploadOffered` is false and with `TypeError("unsupported_file")` for any other file. `PortraitStepHandle.confirmFix(accept)` answers an adjusted photo in the `review` phase (`portrait_icao` with `{ fixReview: { accept } }`, `PortraitFixReviewInput`). A camera photo now sends `source: "camera"` and `capture: { mode }` (new on `PortraitIcaoInput`). `PortraitIcaoReason` gains `portrait_recaptured`, `portrait_morph_suspected`, `portrait_reference_mismatch`, `portrait_declined_fix` and `portrait_fix_review`, and `PortraitFix` names the fixes the server applies.
338
+
339
+ `@sekyro/react` asks "Take a photo" or "Upload a photo" under `choice` unless the person already chose (the upload screen at once under `upload`), shows the adjusted photo next to the original with the fixes in words, "Use this photo" and another photo, and words the new reasons in every language.
340
+
341
+ The face match after an accepted portrait sends no image key: the server compares the liveness capture with the reference, not the portrait.
342
+ - b7e6423: `VerificationResult` no longer carries `personId` or `subjectId` (and `HostedSessionView` no longer has `subjectId`): the hosted session view can be read by anyone holding the link, so it never names the person. Identify the person on your server with the result token's `sub` after you verify the token (the API's `personId` is `per_<sub>`), or with the webhook.
343
+ - 437509b: `<SekyroFlow>` no longer takes over the browser's back button by default: `backNavigation` now defaults to `"none"`, as on `<SekyroVerification>`, so the flow never adds an entry to your page's history. Pass `backNavigation="history"` when the flow owns the page and the browser's back should walk the flow (one screen back, or "Leave verification?" once something was sent). With `"history"`, a back press that leaves the flow now leaves it: your `onClose`, else one more step back in the browser.
344
+
345
+ The phone and email code steps keep the number or address on screen until a new code arrives, so a send the server refused changes neither what is shown nor where Resend goes. Countdowns never run past the server's window on a device whose clock is late.
346
+
347
+ ### Patch Changes
348
+
349
+ - 1f93754: The device header says when the page runs inside an app's browser (`inApp`), so the dashboard can show how often that happens on an integration. `isInAppBrowser()` is also exported from `@sekyro/web/client`.
350
+ - 6c0141f: `SessionFailureReason` gains `blocked_by_org`: one of the organization's blocks stopped the session. The result screen shows one line asking the person to contact the organization, in every locale. Nothing returns it until blocks are available to the organization.
351
+ - 5994d5d: Retries the service paces are spread out and wait longer when asked. When the service is busy (503 `server_busy` or `request_timeout`), the hosted client waits the `Retry-After` the service sends (2 seconds without one) up to 20 seconds, previously 3, before its one retry. When the model service is unavailable (503 `inference_unavailable`), a submission waits the `Retry-After` (10 seconds without one) up to 20 seconds, previously 30, before each of its three retries. Every such wait is spread by ±25 % (at least 0.5 seconds) so clients do not all come back at the same moment, and the `busy` event's `retryAfterSeconds` is the wait actually taken, so it can have a fraction.
352
+ - 0b01cee: The web SDK sends a device fingerprint for fraud prevention: browser, hardware and camera traits from the ThumbmarkJS library, each hashed in the browser, and the phone model and operating system version on Chromium browsers. It adds the `@thumbmarkjs/thumbmarkjs` dependency, loaded on demand, with no network request of its own. Name device fingerprinting in your privacy notice; see "Device fingerprinting" in the web SDK guide.
353
+ - Updated dependencies [1005d9e]
354
+ - Updated dependencies [6a53392]
355
+ - Updated dependencies [1f93754]
356
+ - Updated dependencies [c17645e]
357
+ - Updated dependencies [6c0141f]
358
+ - Updated dependencies [b7e6423]
359
+ - Updated dependencies [5994d5d]
360
+ - Updated dependencies [0b01cee]
361
+ - Updated dependencies [5c5f7e3]
362
+ - @sekyro/web@0.1.0-rc.20
363
+
364
+ ## 0.1.0-rc.16
365
+
366
+ ### Minor Changes
367
+
368
+ - 5c480f8: Age check (selfie) copy. A document step reached because the selfie could not settle the person's age carries `ageStepUp: true`, and `<SekyroVerification>` shows "We could not confirm your age from the selfie. Continue with an ID document." on the first document screen the person sees, in all six locales. A session stopped with `underage_estimated` ends on "This service is for people who have reached its minimum age." in all six locales, instead of the generic rejection. New string keys: `doc.ageStepUp` and `reasons.underage_estimated`.
369
+
370
+ ### Patch Changes
371
+
372
+ - 61f92b1: Capture failures leave a diagnostic trace. A capture error now carries an optional `detail`: the step that was running (`phase`), the thrown error's `name` (never its message) and the engine's own kind before the public collapse (`engineKind`). A camera that Android Chrome reports as `AbortError` (held by a call or another app) is now `inuse`, and a `SecurityError` is `permission`. `Verification.reportCaptureIssue()` records a shown capture failure on the session (`POST /hosted/capture-issue`); it never changes the session, never bills and never counts as an attempt. `<LivenessCapture>` and the document step of `<SekyroVerification>` report the errors they show.
373
+
374
+ The result screen explains an owner check refused because the same person already earned the starting credit (`failureReason: "starter_credit_claimed"`, hosted owner checks only), in every SDK language.
375
+ - 4555bac: A flow can let the person choose how the face video is filmed. When the session's capture mode is `choice`, the person picks once, before the first camera step, between filming themselves and having an agent film them; the pick holds for the whole session, including the portrait camera. `@sekyro/web`: `Verification.chooseCaptureMode(mode)` records the pick, `captureChoice` reads it, `captureMode()` returns `"choice"` until a pick and the pick after, and the pick is sent with the capture (`input.capture.mode`). `CaptureMode` gains `"choice"` and the new `ResolvedCaptureMode` is `"self" | "assisted"`. The portrait still is encoded at the camera's full size. `@sekyro/react`: `<LivenessCapture>` and `<PortraitCapture>` show the new `CaptureModePicker` when the session is `choice` and nobody has picked yet, in every SDK language.
376
+ - 64ca525: `es`, `pt` and `de` now translate every screen, the identity screens (document, ID number, registry, chip, eID, summary) and the shared errors and reasons included; before, they covered the Human copy and showed English elsewhere. The copy still loads on demand, only for those locales. React Native: without a `locale`, the flow follows a device language of `es`, `pt` or `de` too.
377
+ - Updated dependencies [5c480f8]
378
+ - Updated dependencies [61f92b1]
379
+ - Updated dependencies [4555bac]
380
+ - Updated dependencies [c8ec50f]
381
+ - @sekyro/web@0.1.0-rc.19
382
+
383
+ ## 0.1.0-rc.15
384
+
385
+ ### Minor Changes
386
+
387
+ - 8e9ca8e: With `@sekyro/web` from the contract release, the result passed to `onResult` names the session as `ses_...` (the form `sessions.create` returns and webhooks name) and carries `personId` (`per_...`) next to the bare `subjectId`; the reference shown on the result screen uses the `ses_` form too.
388
+
389
+ ### Patch Changes
390
+
391
+ - Updated dependencies [75b8595]
392
+ - @sekyro/web@0.1.0-rc.18
393
+
394
+ ## 0.1.0-rc.14
395
+
396
+ ### Patch Changes
397
+
398
+ - a5ce0c1: Phone step: the hint below the field is now one line for every country, "Type your phone number without the prefix" (and its translation in each locale), instead of "8 digits" for Mauritania. The `otp.phonePlaceholder` key stays in the dictionaries but the step no longer reads it; an override of it now goes under `otp.phonePlaceholderGeneric`. The free international field still shows no hint.
399
+ - 5ef8039: Phone step: with the server's phone rules, the number field groups digits as they are typed, stops at the country's longest length and enables Send only on a valid length, with an inline message when the person leaves the field or presses Enter too early. A full number typed or pasted lands on its country, Arabic-Indic digits are accepted, a leading `00` or a national prefix is handled, and an open flow offers "Another country". The two new server reasons `otp_number_invalid` and `otp_number_not_mobile` show their own notice. On a server without rules the field behaves as before. Additive: nothing to change on an existing integration.
400
+ - 3d43b65: Phone step: one field. The country choice moved into the field's leading segment (flag, calling code and chevron over a native select named with the country), the number takes the rest of the width, and the format hint sits below the field so it is never cut off. A flow with one country shows the flag and code without a chevron.
401
+ - Updated dependencies [c40301a]
402
+ - @sekyro/web@0.1.0-rc.17
403
+
404
+ ## 0.1.0-rc.13
405
+
406
+ ### Patch Changes
407
+
408
+ - 705cd00: Status colours are standard. `<SekyroVerification>` paints the Sekyro status colours and picks the set that stays readable on the partner's page colours (a dark partner page in the light scheme gets the dark set; notices sit on its soft surfaces). `danger`, `success` and `warning` in a runtime theme are deprecated and ignored, with one warning in development builds; they will be removed in 1.0. Status keys from an older server's branding are ignored.
409
+ - Updated dependencies [7eddbf1]
410
+ - Updated dependencies [ff5cc35]
411
+ - @sekyro/web@0.1.0-rc.15
412
+
413
+ ## 0.1.0-rc.12
414
+
415
+ ### Patch Changes
416
+
417
+ - 5fded53: The document camera never stays dark without a word. If the scanner fails to load (a flaky network, or a new deploy that replaced its files), the capture now emits a retryable `error` instead of rejecting `start()` silently. Before it opens the back camera, the capture releases any camera stream an earlier Sekyro capture in the page still holds. If the opened camera shows no picture within 4 seconds (it never plays, its track ends, or it sends only black frames), the capture reopens it once and then emits a retryable `generic` error. When the browser refuses to play a live stream, the retry plays it from the person's tap. `<DocumentCapture>` now gives the reason for a camera error: the permission hint when access was refused, and the camera error's own text otherwise.
418
+ - b4c2258: Remove em dashes from the en/fr/ar capture, error and reason strings, rewritten as plain sentences (for example "Face a light source and avoid strong light behind you"). Keys are unchanged; the native string tables generated from the contract carry the same wording.
419
+ - 37c823e: Add the `insufficient_balance` phone OTP reason: the organization's prepaid balance cannot cover the send, so nothing was sent. `PhoneOtpReason` gains it, and the phone step shows the same "This verification method is not available right now" notice as `spend_cap_reached` (`otp.reason_insufficient_balance`, ar/fr/en and the es/pt/de overlays).
420
+ - Updated dependencies [5fded53]
421
+ - Updated dependencies [37c823e]
422
+ - @sekyro/web@0.1.0-rc.14
423
+
424
+ ## 0.1.0-rc.11
425
+
426
+ ### Minor Changes
427
+
428
+ - ef0b9b2: Person data (spec 2026-10-31): `<IdNumberEntry>` replaces `<NniEntry>` (kept as a deprecated alias). The dictionaries gain the generic keys (`reasons.id_number_invalid`, `reasons.registry_record_not_found`, `reasons.document_id_number_mismatch`, `errors.id_number_unbound`, `population.reason_id_number_invalid`, `population.reason_registry_record_not_found`, `population.reason_registry_record_not_found_or_document`, `summary.id_number`, `otp.countryLabel`, `otp.phonePlaceholderGeneric`); either name of a renamed reason shows the generic copy, and an override written under a former key still applies. The phone step no longer assumes one country: it uses the flow's contact countries (a fixed prefix for one, a country select for several, a free international field for an empty list; a server that sends none keeps the former Mauritanian prefix), drops the country's trunk prefix, and the submitted number stays E.164. The document picker lists the session's named issuers first.
429
+
430
+ ### Patch Changes
431
+
432
+ - Updated dependencies [ef0b9b2]
433
+ - @sekyro/web@0.1.0-rc.13
434
+
435
+ ## 0.1.0-rc.10
436
+
437
+ ### Patch Changes
438
+
439
+ - 22acfcf: Adds the Age check (selfie) processing step and renders any future server step as processing. Deploy this version before turning on the age check for your organization. While the age check runs, the processing screen says "Checking your age" in every supported language.
440
+ - Updated dependencies [22acfcf]
441
+ - @sekyro/web@0.1.0-rc.12
442
+
443
+ ## 0.1.0-rc.9
444
+
445
+ ### Minor Changes
446
+
447
+ - a3247a3: Screen ramp and capture provenance (liveness v7). When the session's capture tuning carries `capture.liveness.screenRamp` (a server-issued challenge: three pastel colours and their onsets), `@sekyro/web` paints them through the new `ramp` event of the liveness capture handle while the clip records, stamps each change on the clip's own timeline (the recorder's start, corrected by the video element's frame clock when the browser reports one) and sends what it rendered as `input.capture.screenRamp: {nonce, rendered: [{tMs, colour}]}`. `@sekyro/react` paints the layer in both stages (the face camera of `SekyroVerification` and the 0.1 stage) and hands it to a custom stage renderer as `ramp` on the stage view; a host on `@sekyro/web` alone subscribes to `ramp` and paints a fixed full-viewport element with `screenRampColourValue(colour)`, or leaves the event unbound (then no ramp is reported). Hosts that want ramp verification bind the `ramp` event: `provenance.rampPainter` tells the backend whether a painter was bound, so an unbound host is a client without the ramp rather than one missing it. No ramp in an assisted capture or without a challenge. Every liveness submit now also carries `input.capture.provenance` (the video track's settings with the device id hashed, whether `getCapabilities` exists, the camera label's class against a small list of virtual-camera products, `requestVideoFrameCallback` statistics over the recording, and whether the capture prototypes are still native code): signals only, no media, no raw identifiers. New types: `ScreenRampChallenge`, `ScreenRampColour`, `ScreenRampReport`, `CaptureProvenance`, `HostedLivenessCaptureTuning`. The native SDKs decode the challenge in this release and render it in the following one.
448
+
449
+ ### Patch Changes
450
+
451
+ - 032585b: Liveness retakes: `VerificationResult.retakeHint` and `StepAttempts.retakeHint` (`appearance | motion | lighting | framing`) carry the backend's retake hint; `@sekyro/react` shows the matching `hints.*` copy in place of the reason's generic text. A parked step whose attempts did not grow (a voided capture) is always a `retry`, and `capture_back_camera` / `capture_not_upright` are retryable.
452
+ - 4bdc14c: `DEFAULT_THEME` and the `styles.css` defaults now use the Sekyro AI brand: the same colours, font and 16px control radius as `<SekyroVerification>` and the native SDKs. Dashboard branding radius steps map to 0, 6, 10, 16 and 9999px, matching iOS and Android. Pass your own theme to keep the previous look.
453
+ - Updated dependencies [a3247a3]
454
+ - Updated dependencies [032585b]
455
+ - Updated dependencies [f13b832]
456
+ - Updated dependencies [90dde69]
457
+ - @sekyro/web@0.1.0-rc.11
458
+
459
+ ## 0.1.0-rc.8
460
+
461
+ ### Minor Changes
462
+
463
+ - 97fe8cf: Assisted capture follow-ups.
464
+
465
+ - `<LivenessCapture>` in an assisted session opens the back camera by default only on a device with a front/back choice, else the front one (`IntroContext.facing`). While the stage runs, the preview mirror follows the camera the live stream reports, not the one requested.
466
+ - Start stays a loader (`IntroContext.assets` is `"loading"`) and the auto-start waits until the camera to open is known: the session's capture mode and, in an assisted session, whether the device has a front/back choice.
467
+ - The ICAO portrait camera follows the session too: in an assisted session it shows the back camera unmirrored and a front/back switch (on a device with both, until the photo is taken); a self session keeps the mirrored front camera.
468
+ - b8af08c: Breaking (pre-1.0): the session's flow decides who films the face, and no prop can widen it. `allowCameraSwitch` (`<SekyroVerification>`) and `defaultFacing` (`<LivenessCapture>`, `livenessProps`) are removed.
469
+
470
+ - Self capture (the default, and every capture-only `<LivenessCapture>`): the front camera only, no front/back picker, no switch on the stage.
471
+ - Assisted capture (an agent films the person, set in the flow): the back camera by default with an unmirrored preview, the front/back picker on a device with both cameras, the switch until the clip records, and copy for the agent (`capture.assisted.title`, `capture.assisted.lead`, `capture.assisted.stage`). The voice guidance still speaks to the person filmed.
472
+ - `IntroContext` gains `captureMode`; `canChooseFacing` is `false` in a self capture.
473
+ - New copy in ar/fr/en: `fcv3.hold_upright` (the phone is held sideways; also a voice key) and the retake reasons `reasons.capture_back_camera` and `reasons.capture_not_upright`. `hintStringKey("upright")` maps to `fcv3.hold_upright`.
474
+
475
+ ### Patch Changes
476
+
477
+ - b092ac3: The back camera is no longer mirrored. On the front camera (the default) the face preview and the keyframe stay mirrored like a selfie, exactly as before. When a capture runs on the back camera (`start({ facing: "environment" })` or the in-capture switch), the engine's keyframe and `previewDataUrl` are drawn as the camera sees them, and `<LivenessCapture>` / `<SekyroVerification>` show the back camera's preview unmirrored (an inline `transform: none` on the `<video>`). The liveness clip is unchanged: it was never mirrored.
478
+ - eabd027: Consent and registry copy no longer says "NNI" to everyone: the consent screen names "your identity document number", checked against the issuing authority's records when available, and `reasons.registry_unavailable` says "your number". The Mauritanian registry steps (`population.label`, `method.national_number`, `summary.nni`) say "Mauritanian national ID number (NNI)". Keys are unchanged; only the en, fr and ar values of these strings changed.
479
+ - Updated dependencies [a3cd61c]
480
+ - Updated dependencies [7ce5ab1]
481
+ - Updated dependencies [b092ac3]
482
+ - Updated dependencies [857ec58]
483
+ - @sekyro/web@0.1.0-rc.10
484
+
485
+ ## 0.1.0-rc.7
486
+
487
+ ### Minor Changes
488
+
489
+ - 1639f8a: Sekyro flows: one choice screen for every choice of the flow plan (`plan.choice`).
490
+
491
+ - `ChoiceScreen` (DESIGN.md Choice Cards: line glyph, label, radio; one tap picks and moves on after 220 ms) replaces the method screen and the contact choice: `<MethodChoice>` (identity method, `method.*` copy), the contact choice (`contact.*`) and the new generic choice step (`choice.*`, ar/fr/en) all render it, options in the server's order, labelled by their service (`nfc` and unknown services are never shown on the web). The 0.1 `<LivenessCapture>` method step uses the same component with its 0.1 buttons look (styles.css unchanged).
492
+ - The section progress follows `plan.sections` (`done | current | upcoming`); `section.screening` copy added.
493
+ - The identity summary is the `summary_confirm` step (no API change).
494
+ - In-lane switch on every step screen while the session's choice is open (C4 rule §5 item 6): one other option → a direct quiet action labelled by it (phone ⇄ email, « Use my document instead », the eID camera action, or the target's method label); two or more → « Use another option » (`choice.switch`, ar/fr/en), which re-opens the ChoiceScreen with the current option marked.
495
+ - Flow-view chunk budget 10 240 → 10 752 B gzip (the generic choice copy, then the in-lane switch views).
496
+
497
+ ### Patch Changes
498
+
499
+ - Updated dependencies [8dbdcf3]
500
+ - @sekyro/web@0.1.0-rc.9
501
+
502
+ ## 0.1.0-rc.6
503
+
504
+ ### Minor Changes
505
+
506
+ - ff0dcc7: Flow model 2026-10-23 (web lane):
507
+
508
+ - `<SekyroVerification>`: one-line implicit consent ("By continuing, you agree to the terms." with a terms link — no photo/video wording), one progress segment per section, the phone-or-email choice (+ "Use another option" under the OTP), the identity summary (portrait from memory as a blob URL, revoked on unmount; masked values left to right inside RTL; confirm / retake), the eID "then a quick live photo" hint (method screen and eID screen), the ICAO tips variant and ICAO coaching for the one-capture live photo, the portrait-only retake notice, and a QR handoff for `mobile_required` when `handoffUrl` is set. The new views and their ar/fr/en copy load on demand (one lazy chunk).
509
+ - `<SekyroFlow>`: the page shell — in-app browser prompt (WhatsApp, Instagram, Facebook, TikTok, … → open in the browser / copy link / continue anyway) and the desktop-to-phone QR of `hostedUrl` (a built-in QR encoder, no new runtime dependency). `isInAppBrowser()` is exported.
510
+ - `<LivenessCapture>`: `tipsSummary` (the spoken summary of custom tips, device voice) and `coach` (host coaching that replaces the guidance line while the camera runs).
511
+ - Step copy: new optional keys (`consent.short`, `consent.termsLink`, `section.*`, `contact.*`, `summary.*`, `capture.tipsIcao.*`, `portrait.retakeOnly`, `portrait.keepCamera`, `handoff.*`, `inApp.*`, `eid.continueHint*`, `session.progressLabel`).
512
+ - e240081: National eID screens (SDK spec §3.2; Houwiyeti in Mauritania) in `@sekyro/react/verification`: the method screen now offers "Verify with Houwiyeti" (generic "Verify with your national eID" without provider details) when the session does, and `<SekyroVerification>` runs the new `<EidStep>` — NNI entry (never asked on an NNI-bound session, which starts by itself once), the 6-digit code from the provider's app with its expiry countdown, resend after the server's spacing and up to its limit, and every `eid_*` verdict with "Verify with my camera instead" where the session allows the camera path. The view and its ar/fr/en copy load lazily (like the email OTP view), so apps without a national eID never download them. `StepStrings` gains the `method.national_eid*` keys and optional `eid.*` / `reasons.eid_*` keys (host overrides win). The 0.1 `<LivenessCapture>` drop-in is unchanged (it never offers the eID).
513
+ - 46905f2: National eID sign-in (SDK spec §3.2; Houwiyeti in Mauritania) in the headless web runner: the `eid_auth` check type, the `national_eid` identity method with `methodChoice.nationalEid`, the `HostedStepView.eid` view and the `eid_*` reasons, and an `eid` plan-runner step whose handle offers `start(identifier?)`, `verify(code)`, `resend()` and `useCamera()`. `@sekyro/react` has no eID screen yet: its method screen leaves `national_eid` out and `<SekyroVerification>` shows the "unsupported" notice when the eID is the only path.
514
+
515
+ **Migration (TypeScript):** these exported unions gained members — `CheckType` (`eid_auth`), `IdentityMethod` (`national_eid`), `CheckReason` (the `eid_*` reasons), `VerificationStep` (a new `kind: "eid"` step). Code that switches over them exhaustively must add an `eid` branch. An invalid eID number rejects with the existing `InvalidInputError("nni", …)`. Nothing changes at runtime until a profile turns the national eID on.
516
+ - 7a3f935: Phone OTP channel choice and the email OTP step.
517
+
518
+ - `@sekyro/web`: the phone OTP step lists the channels the person can choose from (`PhoneOtpSnapshot.channels`, WhatsApp first; `[]` on a session created before channel choice). With more than one, `send({ channel })` needs the person's choice — it is never picked for them — and a channel the step doesn't offer is refused locally with the new `OtpInputError` (`channel`, `required` / `unavailable`). `resendAvailableAt` now follows the server's resend time when the session reports one. New `email_otp` step (`EmailOtpStepHandle`: `send({ email })`, `verify(code)`; a malformed address rejects with `OtpInputError("email", "format")`), shown before the identity-method choice like the phone step. New types: `HostedEmailOtpView`, `EmailOtpInput`, `EmailOtpReason`, the `email_otp` check type and the reasons `otp_channel_unavailable`, `otp_destination_not_allowed`, `otp_destination_unknown`, `otp_rate_limited`, `email_invalid`, `email_disposable`.
519
+ - `@sekyro/react`: `PhoneOtpStep` shows one "Send code by …" button per offered channel (WhatsApp first) and a "Resend by …" button per channel after the server's resend time; sessions without channels keep the single "Send code" button. New `EmailOtpStep` (rendered by `SekyroVerification` for the `email_otp` step); its view and ar/fr/en copy load on demand, so apps without an email check don't download them. New copy keys `otp.chooseChannel`, `otp.sendBy`, `otp.resendBy`, the new `otp.reason_*` keys and `emailOtp.*` (overridable through `strings`).
520
+ - `@sekyro/node`: profile `phone.channels` / `phone.destinations`, `email` (`ProfileEmail`: `emailSource`, `disposable`), `attempts.email`, the `input.email` session anchor and the `email_otp` check type.
521
+ - 0c59c9a: `@sekyro/react/verification`: `<DocumentCapture>` — pick the issuing country (searchable, only the countries your eKYC profile accepts), then the document type, then scan identity cards, residence permits or passports with the rear camera: the photo is taken by itself, a flip animation asks for the other face, and the progress line shows Front · Back. The camera view loads only when a document step is shown.
522
+ - ac69110: `@sekyro/react/verification`: `<PhoneOtpStep>`, `<MethodChoice>` and `<NniEntry>` — the phone OTP, "How do you want to verify?" and national-number steps of the hosted page, accessible in Arabic, French and English.
523
+ - 7a77b9d: `@sekyro/react/verification`: `<SekyroVerification verification={…} locale="fr" />` renders the whole eKYC profile — phone OTP, method choice, national number, document for any country, liveness and face match, and every result screen (policy stops, cooldown, "needs a phone app", no attempts left) — in your theme over the session's branding, with `slots` for header, footer and result and an `onLivenessCaptured` hook that fires before the upload. `<VerificationResultScreen>` is available on its own.
524
+ - d93f378: New entry `@sekyro/react/verification` (with `@sekyro/react/verification.css`) for the profile v2 steps: the ar/fr/en step copy (`enSteps`, `frSteps`, `arSteps`, `resolveSekyroStrings`) and `useVerificationStep(verification)`. The main `@sekyro/react` entry, its strings, theme and stylesheet are unchanged.
525
+ - c9edead: `<SekyroVerification>` matches the native SDKs on the remaining screens. Consent stays flow model v3's one line (no consent screen). The face capture (liveness and the ICAO live photo, whose tips the Sekyro face intro lists) is the Lumière face camera, edge to edge: the oval cut from the ink, a ring of ticks that turns green with the capture while the aqua light runs round it, the instruction above the oval. New optional `onClose(event)` prop: when given, the header ends with a close button (`{ reason: "cancelled" }`) and the result page with "Back to {org}" (`{ reason: "finished", result }`); `VerificationResultScreen` takes an optional `onClose` for the same action. The SDK's fonts (Inter, Inter Display for titles, Cairo for Arabic) ship as woff2 assets beside `verification.css` (`font-display: swap`, `unicode-range`). Also: resending a code is a quiet text action with its countdown; the document intro offers "Change document" when the country has other documents and "Change country" only with several countries; the ID card's landscape glyph; white turn cue; one 2 px read line; the lock and the capture checks in the camera's own green; the reference is one tabular caption line with a copy glyph. In `@sekyro/web`, a card's face is classified on the card itself (an MRZ band in its lower half), so the photo side is no longer filed as the verso. The 0.1 surface (`DEFAULT_THEME`, `styles.css`) is unchanged.
526
+ - c9edead: `<SekyroVerification>` takes the Sekyro identity the Android and iOS SDKs share: the partner's logo (or initials) and name
527
+ over "identity verification", the section progress (flow model v3) drawn as thin bars, the Sekyro brand as the default
528
+ theme (partner branding and the runtime theme still win), six-box one-time code fields, document cards with an icon
529
+ and a subtitle, the camera stages in the Sekyro navy, and a "Verified by Sekyro AI" footer (`slots.footer` replaces it,
530
+ `footer: null` hides it). New `colorScheme` prop: `light` (default), `dark` or `system`; in dark a partner's brand is
531
+ kept only while it stands out from the dark canvas.
532
+ The 0.1 surface (`DEFAULT_THEME`, `styles.css`, `<LivenessCapture>` and the other 0.1 components) is unchanged.
533
+
534
+ **Visible to existing `<SekyroVerification>` integrations.** Without a `theme` prop or session branding the flow now
535
+ draws in the Sekyro brand (it used `DEFAULT_THEME` before) and ends with a "Verified by Sekyro AI" line. To keep your
536
+ current look, pass your colours (`theme={{ colors: … }}`, or set them as the app's branding) and `slots={{ footer: null }}`.
537
+ `verification.css` now loads the SDK's fonts (`./fonts/*.woff2`): your bundler must emit them as assets (esbuild needs
538
+ `loader: { ".woff2": "file" }`; Vite, webpack 5 and Next.js do it by default) and your CSP `font-src` must allow them.
539
+ - fce1604: Web live MRZ (on-device, server-controlled, additive):
540
+
541
+ - `@sekyro/web`: `DocumentCaptureOptions.liveMrz` (`mode`, `assetBaseUrl`, `workerUrl`) and the text-free `mrz` event (`searching` / `reading` / `valid` / `mismatch` / `fallback`, with a format, a coaching hint or a reason — never MRZ text). On a face with an MRZ, the session's `capture.document.liveMrz` tuning lets the on-device reader (the OCR engine in a Web Worker, now with a 494 KB MRZ-only recognizer) take the photo once every hard check digit validates twice in a row; card fronts get a text-layout lock (`capture.document.frontLock`). Every failure is today's capture. `doc_ocr` submissions carry the optional, text-free `deviceRead` hint (`DocOcrInput.deviceRead`, `DocDeviceRead`) when the still confirmation is ready. New static file `core/ocr/worker.bundle.js` (a self-contained OCR worker for static hosting).
542
+ - `@sekyro/react`: `SekyroVerification`'s `documentLiveMrz` and `DocumentCapture`'s `liveMrz` pass the options through; the document view shows the reader's states (ar/fr/en), a band strip and the 2 s "this looks like a passport/card" line.
543
+
544
+ ### Patch Changes
545
+
546
+ - 626104f: Document capture resolution: the scanner asks the opened back camera for up to 4K, takes the full-sensor `ImageCapture` photo where the browser has one (else the native video frame), crops the still to the document (card + 15 % margins, or the passport page estimated from the MRZ band) and encodes the crop at a 2560 / 2240 / 1920 px long edge (1.6 MB / 1.2 MB / 700 KB budgets). A passport MRZ goes from ~630 px to ≥ 1300 px wide where the camera delivers the pixels. `@sekyro/react`'s document stage switches to a 4:3 layout when the phone is held sideways.
547
+
548
+ Focus: the scanner ranks the back cameras after permission and opens the main wide lens (lowest-index Android back camera with continuous AF; iOS "Back Camera"), remembered per browser, falling back to `facingMode`. It applies continuous autofocus where offered, refocuses (single-shot at the document) before the photo, zooms in (≤ 2×) when the camera reports a minimum focus distance beyond the document's fill distance (1.5× on a ≥ 4K track with no focus info), refuses an out-of-focus auto-captured still (`focus_far` coaching, `dcv2.focus_far`), and adds `DocumentCaptureHandle.focusAt(x, y)` for tap-to-focus (wired into `@sekyro/react`'s stage). All feature-detected; no-ops where unsupported.
549
+ - 83c7664: `<SekyroVerification>` sets its titles of 22 px and more (page titles, the result, the camera guidance, the phone and code fields) in Geist, the brand's display face on the website and dashboard, instead of Inter Display. `verification.css` loads `fonts/SekyroGeist-SemiBold.woff2` and `fonts/SekyroGeist-Bold.woff2` (OFL, `fonts/Geist-OFL.txt`); the two Inter Display files are gone, so the fonts beside `verification.css` shrink from about 249 KB to 215 KB. Body text stays Inter, Arabic stays Cairo, and a partner font from the dashboard still replaces the titles' face too. The native SDKs (and the React Native and Flutter wrappers, which render them) ship the same change.
550
+ - 9db49b8: Adds the `nationality_unreadable` document reason: the MRZ nationality (no check digit covers it) could not be read as a country code, nor recovered from a re-read or the printed nationality — retryable with a clearer photo, not billed, and never replaced by the issuing state. `@sekyro/web`: in `DocReason` and the retryable set (the same document side is re-read). `@sekyro/react`: `reasons.nationality_unreadable` copy in ar/fr/en.
551
+ - 9acafe1: NFC chip check (M-nfc). New check type `nfc_chip` (read by the native SDKs only), its reasons (`NfcChipReason`: retryable `chip_read_failed`, `chip_access_denied`, `chip_parse_failed`; final `chip_not_present`, `nfc_unavailable`, `chip_document_mismatch`, `chip_integrity_failed`, `registry_mismatch`, `document_nni_mismatch`, `platform_unsupported`), the error codes `method_not_offered` and `nfc_outcome_not_accepted` (`KNOWN_CODES`), the identity method `document_chip`, the session failure reason `platform_unsupported` and the optional `HostedStepView.nfc` hints (`NfcStepView`). Web behaviour is unchanged: the server skips the chip for web clients or stops the session with `platform_unsupported`; `@sekyro/react`'s method screen never renders the `document_chip` option.
552
+ - 4dd2b68: ICAO `id_document` portrait capture on the web (SDK spec §5.4, M1b): `createPortraitCapture` (strict ICAO gate on the MediaPipe Face Landmarker, lazy-loaded engine, server `capture.icao` tuning), a `portrait` plan-runner step that submits `portrait_icao` and then `face_match` with the portrait, the `portrait_required` hand-over reason, and `<PortraitCapture>` in `@sekyro/react/verification`.
553
+ - 8425e95: Face-match probe binding (SDK spec §4.10): the server matches the face_match probe against face crops of the scored liveness clip. New retryable, billed `face_match` reason `probe_not_from_liveness` (the face image isn't the person in the liveness clip). `@sekyro/web`: in `FaceMatchReason` and the retryable set (the runner re-captures). `@sekyro/react`: ar/fr/en retry copy "Keep your face in the frame the whole time, then try again"; bundle budget 24 → 25 KiB. `@sekyro/node`: `ProbeBindingReason`. No capture or upload change on any platform.
554
+ - e0da6e6: `<SekyroVerification>`: `slots.headerEnd` adds a node (a language menu) at the inline end of the partner header, before the close button; and `livenessProps.slots.stageOverlay` now draws over the full-screen face camera.
555
+ - b758c1e: `<SekyroVerification>`: a step the web cannot run because it reads the document's chip (`unsupported` / `platform_unsupported`) now says "This verification needs a phone app" and names the organisation's app ("{org} asks to read your document's chip. Open {org}'s app on a phone with NFC to continue."), instead of "Update required". New `StepStrings` keys: `needsApp.title`, `needsApp.description`, `needsApp.descriptionNoOrg`.
556
+ - c9edead: `<SekyroVerification>` takes the premium redesign of the native SDKs, so the flow looks and behaves the same on the web: the flow-* type scale; one heading per page with its actions pinned in the thumb zone; the old page leaves before the new one rises in; a thin section progress whose current section is partly filled; white fields with a hairline and a 2px focus ring; the phone number after a fixed 🇲🇷 +222 segment, sendable only once valid; full-width code boxes (digit pop, caret, a shake on a wrong code) that send the code on its last digit; one tap on a country or a document chooses it; the camera intros' line marks; the Lumière document camera edge to edge (brackets that follow the card, steadied like the native ScanPresenter; the lock trace; the aqua read line; a light blur with the photo sharp in the slot while it is read and "you can put it down"; the turn cue under the slot; the captured faces in the tray); the face intro; the outcome mark drawn in light with a tap-to-copy reference. The 0.1 surface (`DEFAULT_THEME`, `styles.css`) is unchanged.
557
+ - 58c18a4: The `@sekyro/web` peer range is now `^0.1.0-rc.8 || ^0.2.0-rc.0` (was `^0.1.0-rc.7 || ^0.2.0-rc.0`): `@sekyro/react/verification` needs the step runner, `DocumentCapture` (`warmDocumentCapture`), `isValidNni` and `acceptedIssuers`, first released in `@sekyro/web` 0.1.0-rc.8. Upgrade `@sekyro/web` to 0.1.0-rc.8 or later together with this release; the main `@sekyro/react` entry is otherwise unchanged.
558
+ - f316221: The `@sekyro/web` peer range is widened to `^0.1.0-rc.7 || ^0.2.0-rc.0`. The next `@sekyro/web` release candidate (0.1.0-rc.8, with the step runner and DocumentCapture) is already inside the old range; the wider range only keeps a later 0.2 line installable next to this package. Nothing in `@sekyro/react` changes.
559
+ - 8425e95: Returning-user sessions (profile v2 step 5): `HostedSessionView.returning` and the optional `Verification.returning()` tell the host the session only confirms a known person (liveness + face match against their stored photo); `<LivenessCapture>` opens with "Confirm it's you" (ar/fr/en) unless the host renders its own header.
560
+ - 45f639f: Licence: the SDKs are now under the Sekyro AI SDK License of Ibtikar Technologies, Inc. (https://sekyro.ai/en/legal/sdk-license, also in French and Arabic). `package.json#license` is `SEE LICENSE IN LICENSE`, and each package's `LICENSE` summarises the licence and links to it. `@sekyro/web` now also ships `THIRD-PARTY-NOTICES.txt` with the MIT notice of the bundled scanic document detector and the MIT/NCSA notice of the Emscripten glue in its OCR worker.
561
+ - bc29977: Selfie ICAO policy: on a session whose selfie is checked with the `selfie` ICAO profile, the one-capture live photo shows the ICAO tips without the background tip, under the standard tips title (it is not an ID photo), and speaks those tips. ID-document sessions are unchanged.
562
+ - Updated dependencies [b81288e]
563
+ - Updated dependencies [d0c4f27]
564
+ - Updated dependencies [3438e10]
565
+ - Updated dependencies [e82324a]
566
+ - Updated dependencies [c9edead]
567
+ - Updated dependencies [f0ba853]
568
+ - Updated dependencies [626104f]
569
+ - Updated dependencies [0f19e99]
570
+ - Updated dependencies [76174c8]
571
+ - Updated dependencies [67a6be3]
572
+ - Updated dependencies [c9edead]
573
+ - Updated dependencies [650d70d]
574
+ - Updated dependencies [6571361]
575
+ - Updated dependencies [ff0dcc7]
576
+ - Updated dependencies [68b5df5]
577
+ - Updated dependencies [4c1aa5b]
578
+ - Updated dependencies [273d2ce]
579
+ - Updated dependencies [46905f2]
580
+ - Updated dependencies [9db49b8]
581
+ - Updated dependencies [6420611]
582
+ - Updated dependencies [9acafe1]
583
+ - Updated dependencies [2055ae5]
584
+ - Updated dependencies [9e27401]
585
+ - Updated dependencies [7a3f935]
586
+ - Updated dependencies [723039c]
587
+ - Updated dependencies [4dd2b68]
588
+ - Updated dependencies [471d833]
589
+ - Updated dependencies [8425e95]
590
+ - Updated dependencies [c9edead]
591
+ - Updated dependencies [8425e95]
592
+ - Updated dependencies [a3689e4]
593
+ - Updated dependencies [45f639f]
594
+ - Updated dependencies [c9edead]
595
+ - Updated dependencies [bc29977]
596
+ - Updated dependencies [4e6bfb8]
597
+ - Updated dependencies [69638fa]
598
+ - Updated dependencies [5eec558]
599
+ - Updated dependencies [fce1604]
600
+ - Updated dependencies [bdcd56e]
601
+ - Updated dependencies [426e180]
602
+ - Updated dependencies [2f9e980]
603
+ - Updated dependencies [b4c8465]
604
+ - Updated dependencies [225aeea]
605
+ - @sekyro/web@0.1.0-rc.8
606
+
607
+ ## 0.1.0-rc.5
608
+
609
+ ### Minor Changes
610
+
611
+ - 06ea302: Org and app branding from the Sekyro AI dashboard.
612
+
613
+ - `@sekyro/web`: `HostedSessionView.branding` (`HostedBranding`: `logoUrl`, `colors`, `radius`, `fontFamily`, all optional) carries only the branding set in the dashboard, merged per field (app over org). Fields nobody set are absent (keep your defaults for them), and `branding` itself is absent when nothing is set or on older APIs.
614
+ - `@sekyro/react`: `brandingToTheme(view.branding)` maps it onto a `SekyroTheme`, and `mergeThemes(...)` combines themes left to right. Pass your own theme last so it still wins: `mergeThemes(brandingToTheme(view.branding), myTheme)`. Integrations that ignore it keep the default theme.
615
+
616
+ ### Patch Changes
617
+
618
+ - 4e7a4a3: Brand: the product is now **Sekyro AI** — package descriptions, READMEs, LICENSE text and the `@sekyro/node` configuration error messages say "Sekyro AI". No API change: package names, the `Sekyro` class, exports and header names are unchanged.
619
+ - 1b6bef2: Profile v2 policy reasons, round 2. New eligibility reason `age_unverifiable` (the app sets a minimum age but the birth date could not be read — `doc_ocr`: retryable with a clearer photo; `population_registry`: final). `failureReason` is widened to every policy reason a session can end on: the session-level reasons plus `nationality_not_allowed`, `underage`, `document_type_not_accepted`, `document_nni_mismatch` and `age_unverifiable`. `@sekyro/web`: `PolicyFailureReason` widened, `age_unverifiable` in `DocReason` / `PopulationReason` / `RETRYABLE_REASONS`. `@sekyro/react`: ar/fr/en copy for `age_unverifiable`. `@sekyro/node`: `EligibilityReason` gains `age_unverifiable`; new `PolicyFailureReason` type used by `Session.failureReason` and the `session.failed` webhook data.
620
+ - 1b6bef2: Profile v2 policy reasons. `@sekyro/web`: the eligibility check reasons `document_type_not_accepted` (retryable), `nationality_not_allowed` and `underage`; `SessionFailureReason` (`location_not_allowed`, `anonymizer_blocked`); `HostedSessionView.failureReason` and `acceptedDocumentTypes`. `@sekyro/react`: ar/fr/en copy for the five reasons. `@sekyro/node`: `SessionFailureReason`, `EligibilityReason`, and `failureReason` on `Session` and the `session.failed` webhook data.
621
+ - 13d512f: Profile v2 step 3: identity-method choice, document-NNI registry submit, matching reasons, `subject` input. `@sekyro/web`: `IdentityMethod`, `MethodChoiceView` and `HostedSessionView.methodChoice`; `HostedStepView.attemptsExhausted` / `nniFromDocument` (and `SessionStepView.attemptsExhausted`); `HostedClient.selectMethod()` (`POST /hosted/method`); error codes `method_required` / `method_locked` / `document_nni_mismatch` (409 when a typed NNI differs from the document's); matching reasons `name_mismatch`, `birth_date_mismatch`, `nationality_mismatch` (doc_ocr + population_registry) and `document_number_mismatch` (doc_ocr) as `MatchReason`. The headless runner stops on a pending choice (`unavailable` / `method_required`, `on('method')`), adds `verification.methodChoice()` / `selectMethod()`, and submits the registry with an empty input when the document gave the NNI. `@sekyro/react`: ar/fr/en copy for the four reasons and the method screen; `<LivenessCapture>` handles the method step while the session waits on the choice: it offers only the methods it can run (the national number — it has no document capture) and selects it without a screen when it is the only one left. `@sekyro/node`: `CreateSessionInput.subject` (`SessionSubjectInput`), `CreateSessionInput.identityMethod` and `sessions.selectMethod(id, method)` (`POST /sessions/:id/method`, `IdentityMethod`) so partners can choose the identity method of an optional-document session, `subjectId` / `externalRef` / `subjectConflict` on `Session` and session webhooks, `SessionStep.attemptsExhausted`, `MatchReason`, and the `subject.updated` webhook data (`{ subjectId, sessionId, status, outcome }`).
622
+ - acbf409: Profile v2 step 4: decision mode, desktop handoff, device stops, per-session profile overrides. `@sekyro/web`: decision-mode reasons `liveness_inconclusive`, `mobile_required`, `match_inconclusive`, `document_authenticity` (`DecisionReason`; the inconclusive three are retryable) and the registered `uncalibrated_capture_channel`; session failure reasons `capture_tampered`, `device_velocity_exceeded`, `device_cooldown`; `HostedStepView.requiresMobile` and `HostedSessionView.retryAfter`; the error code `inference_unavailable` (503, request-level, with `retryAfterSeconds` from `Retry-After` or the body). The headless runner retries `inference_unavailable` up to 3 times after `retryAfterSeconds` (default 10 s) under a fresh idempotency key and a fresh attestation, emitting `on('busy')` for each retry, then surfaces `unavailable / inference_unavailable`; it never captures a `requiresMobile` liveness step on desktop (`unavailable / mobile_required`, nothing uploaded) and adds `verification.mobileRequired()`; a `device_cooldown` result carries `retryAfter`. `@sekyro/react`: ar/fr/en coaching for the inconclusive reasons, "Continue on your phone" instead of the camera when liveness needs a phone, a "busy, trying again" notice, the device stop copy (the cooldown says when to try again — `retryAfterTime()`), no retry button for stops or `mobile_required`; bundle budget 23 → 24 KiB. `@sekyro/node`: `CreateSessionInput.profile` (`EkycProfileOverride`, a deep-partial of `EkycProfileSettings`; unknown keys are rejected server-side, widening answers `403 override_widens_profile` unless the app allows it), `Session.overriddenFields` / `riskSignals` / `retryAfter` (`overriddenFields` and `riskSignals` also on the session lifecycle webhooks), `DecisionReason`, the three device stops in `SessionFailureReason`, and the `subject.suspicious_activity` webhook data (`{ subjectId, sessionId, count }`).
623
+ - c3699fd: Add the `document_nni_mismatch` reason copy (en/fr/ar): the document belongs to a different person than the one the verification was created for.
624
+ - 58e220c: Published bundles are now minified and no longer include source maps. The public API and types are unchanged.
625
+ - Updated dependencies [4e7a4a3]
626
+ - Updated dependencies [fa95c41]
627
+ - Updated dependencies [d321707]
628
+ - Updated dependencies [c3699fd]
629
+ - Updated dependencies [c3699fd]
630
+ - Updated dependencies [1b6bef2]
631
+ - Updated dependencies [1b6bef2]
632
+ - Updated dependencies [13d512f]
633
+ - Updated dependencies [acbf409]
634
+ - Updated dependencies [b230694]
635
+ - Updated dependencies [06ea302]
636
+ - Updated dependencies [58e220c]
637
+ - @sekyro/web@0.1.0-rc.7
638
+
3
639
  ## 0.1.0-rc.4
4
640
 
5
641
  ### Minor Changes