@sekyro/react 0.1.0-rc.2 → 0.1.0-rc.21

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 (57) hide show
  1. package/CHANGELOG.md +477 -0
  2. package/LICENSE +25 -16
  3. package/README.md +228 -16
  4. package/dist/chunk-2I4BU32X.js +2 -0
  5. package/dist/chunk-2KED7D2Q.js +2 -0
  6. package/dist/chunk-55NNQK5P.js +2 -0
  7. package/dist/chunk-5CLPIFBP.js +2 -0
  8. package/dist/chunk-5RQLU3VM.js +2 -0
  9. package/dist/chunk-7MMT5M4E.js +2 -0
  10. package/dist/chunk-BGAPVTOP.js +2 -0
  11. package/dist/chunk-D65O3EVR.js +2 -0
  12. package/dist/chunk-E4OK3CB5.js +2 -0
  13. package/dist/chunk-EGCGC7NK.js +2 -0
  14. package/dist/chunk-FTKNXQTF.js +2 -0
  15. package/dist/chunk-GUTF3SPK.js +2 -0
  16. package/dist/chunk-MH5E5KTI.js +2 -0
  17. package/dist/chunk-SDO324RU.js +2 -0
  18. package/dist/chunk-VRDPGOXM.js +2 -0
  19. package/dist/chunk-WPSVDW2G.js +2 -0
  20. package/dist/chunk-XQNZJ3J3.js +2 -0
  21. package/dist/chunk-ZLA6BTHU.js +2 -0
  22. package/dist/document-capture-view-GZX5JJ7N.js +2 -0
  23. package/dist/eid-view-ERVRHLLD.js +2 -0
  24. package/dist/email-otp-view-B7UQ5CHL.js +2 -0
  25. package/dist/flow-views-IGQ5MYS2.js +2 -0
  26. package/dist/fonts/Cairo-OFL.txt +93 -0
  27. package/dist/fonts/Geist-OFL.txt +93 -0
  28. package/dist/fonts/Inter-OFL.txt +93 -0
  29. package/dist/fonts/SekyroCairo-Bold.woff2 +0 -0
  30. package/dist/fonts/SekyroCairo-Regular.woff2 +0 -0
  31. package/dist/fonts/SekyroCairo-SemiBold.woff2 +0 -0
  32. package/dist/fonts/SekyroGeist-Bold.woff2 +0 -0
  33. package/dist/fonts/SekyroGeist-SemiBold.woff2 +0 -0
  34. package/dist/fonts/SekyroInter-Medium.woff2 +0 -0
  35. package/dist/fonts/SekyroInter-Regular.woff2 +0 -0
  36. package/dist/fonts/SekyroInter-SemiBold.woff2 +0 -0
  37. package/dist/index.cjs +2 -901
  38. package/dist/index.d.cts +7 -233
  39. package/dist/index.d.ts +7 -233
  40. package/dist/index.js +2 -880
  41. package/dist/overlay-de-5KYN4JFO.js +2 -0
  42. package/dist/overlay-es-6CAERCCN.js +2 -0
  43. package/dist/overlay-pt-UBGXJ3C3.js +2 -0
  44. package/dist/portrait-capture-view-TMHG2UX2.js +2 -0
  45. package/dist/portrait-review-view-XUWQ5LIN.js +2 -0
  46. package/dist/styles.css +310 -12
  47. package/dist/theme-quu7XV_Y.d.cts +544 -0
  48. package/dist/theme-quu7XV_Y.d.ts +544 -0
  49. package/dist/verification/index.cjs +2 -0
  50. package/dist/verification/index.d.cts +689 -0
  51. package/dist/verification/index.d.ts +689 -0
  52. package/dist/verification/index.js +2 -0
  53. package/dist/verification.css +757 -0
  54. package/package.json +28 -13
  55. package/sbom.cdx.json +153 -0
  56. package/dist/index.cjs.map +0 -1
  57. package/dist/index.js.map +0 -1
package/CHANGELOG.md CHANGED
@@ -1,5 +1,482 @@
1
1
  # @sekyro/react
2
2
 
3
+ ## 0.1.0-rc.21
4
+
5
+ ### Patch Changes
6
+
7
+ - 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.
8
+ - Updated dependencies [0d23a56]
9
+ - @sekyro/web@0.1.0-rc.25
10
+
11
+ ## 0.1.0-rc.20
12
+
13
+ ### Minor Changes
14
+
15
+ - 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`.
16
+ - 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.
17
+
18
+ ### Patch Changes
19
+
20
+ - 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.
21
+ - 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).
22
+ - Updated dependencies [f7b755c]
23
+ - Updated dependencies [3eafb6e]
24
+ - Updated dependencies [d25960c]
25
+ - @sekyro/web@0.1.0-rc.23
26
+
27
+ ## 0.1.0-rc.19
28
+
29
+ ### Minor Changes
30
+
31
+ - 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`).
32
+
33
+ `@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.
34
+ - 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.
35
+
36
+ `@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.
37
+ - 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.
38
+
39
+ `@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.
40
+ - 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`).
41
+
42
+ `@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.
43
+ - 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.
44
+
45
+ `@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.
46
+ - 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.
47
+
48
+ 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.*`.
49
+ - 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.
50
+
51
+ 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.
52
+ - 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.
53
+ - 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.
54
+
55
+ `<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}`.
56
+
57
+ ### Patch Changes
58
+
59
+ - 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`.
60
+
61
+ `@sekyro/react`: the camera error notice shows the new `fcv2.err.backcamera` string for that failure, in every language.
62
+ - 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.
63
+ - 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.
64
+ - 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).
65
+ - 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.
66
+ - 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.
67
+ - Updated dependencies [37a6305]
68
+ - Updated dependencies [ad0d148]
69
+ - Updated dependencies [960f295]
70
+ - Updated dependencies [ab329bc]
71
+ - Updated dependencies [ad0d148]
72
+ - Updated dependencies [ad0d148]
73
+ - Updated dependencies [f8eae5a]
74
+ - Updated dependencies [704e58a]
75
+ - Updated dependencies [59b610b]
76
+ - Updated dependencies [0804d05]
77
+ - Updated dependencies [ad0d148]
78
+ - Updated dependencies [f4840d7]
79
+ - Updated dependencies [2beba0c]
80
+ - Updated dependencies [5329680]
81
+ - Updated dependencies [c5b46c4]
82
+ - Updated dependencies [745caf9]
83
+ - Updated dependencies [1d7ee00]
84
+ - @sekyro/web@0.1.0-rc.22
85
+
86
+ ## 0.1.0-rc.18
87
+
88
+ ### Minor Changes
89
+
90
+ - 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.
91
+
92
+ ### Patch Changes
93
+
94
+ - 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.
95
+ - 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.
96
+ - 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.
97
+ - 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.
98
+ - Updated dependencies [ff2011d]
99
+ - Updated dependencies [5f9503f]
100
+ - Updated dependencies [74477bc]
101
+ - Updated dependencies [f3f4313]
102
+ - Updated dependencies [bb79da6]
103
+ - @sekyro/web@0.1.0-rc.21
104
+
105
+ ## 0.1.0-rc.17
106
+
107
+ ### Minor Changes
108
+
109
+ - 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.
110
+
111
+ `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.
112
+
113
+ `@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.
114
+ - 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.
115
+
116
+ `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.
117
+
118
+ `@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.
119
+
120
+ The face match after an accepted portrait sends no image key: the server compares the liveness capture with the reference, not the portrait.
121
+ - 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.
122
+ - 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.
123
+
124
+ 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.
125
+
126
+ ### Patch Changes
127
+
128
+ - 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`.
129
+ - 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.
130
+ - 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.
131
+ - 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.
132
+ - Updated dependencies [1005d9e]
133
+ - Updated dependencies [6a53392]
134
+ - Updated dependencies [1f93754]
135
+ - Updated dependencies [c17645e]
136
+ - Updated dependencies [6c0141f]
137
+ - Updated dependencies [b7e6423]
138
+ - Updated dependencies [5994d5d]
139
+ - Updated dependencies [0b01cee]
140
+ - Updated dependencies [5c5f7e3]
141
+ - @sekyro/web@0.1.0-rc.20
142
+
143
+ ## 0.1.0-rc.16
144
+
145
+ ### Minor Changes
146
+
147
+ - 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`.
148
+
149
+ ### Patch Changes
150
+
151
+ - 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.
152
+
153
+ 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.
154
+ - 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.
155
+ - 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.
156
+ - Updated dependencies [5c480f8]
157
+ - Updated dependencies [61f92b1]
158
+ - Updated dependencies [4555bac]
159
+ - Updated dependencies [c8ec50f]
160
+ - @sekyro/web@0.1.0-rc.19
161
+
162
+ ## 0.1.0-rc.15
163
+
164
+ ### Minor Changes
165
+
166
+ - 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.
167
+
168
+ ### Patch Changes
169
+
170
+ - Updated dependencies [75b8595]
171
+ - @sekyro/web@0.1.0-rc.18
172
+
173
+ ## 0.1.0-rc.14
174
+
175
+ ### Patch Changes
176
+
177
+ - 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.
178
+ - 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.
179
+ - 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.
180
+ - Updated dependencies [c40301a]
181
+ - @sekyro/web@0.1.0-rc.17
182
+
183
+ ## 0.1.0-rc.13
184
+
185
+ ### Patch Changes
186
+
187
+ - 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.
188
+ - Updated dependencies [7eddbf1]
189
+ - Updated dependencies [ff5cc35]
190
+ - @sekyro/web@0.1.0-rc.15
191
+
192
+ ## 0.1.0-rc.12
193
+
194
+ ### Patch Changes
195
+
196
+ - 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.
197
+ - 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.
198
+ - 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).
199
+ - Updated dependencies [5fded53]
200
+ - Updated dependencies [37c823e]
201
+ - @sekyro/web@0.1.0-rc.14
202
+
203
+ ## 0.1.0-rc.11
204
+
205
+ ### Minor Changes
206
+
207
+ - 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.
208
+
209
+ ### Patch Changes
210
+
211
+ - Updated dependencies [ef0b9b2]
212
+ - @sekyro/web@0.1.0-rc.13
213
+
214
+ ## 0.1.0-rc.10
215
+
216
+ ### Patch Changes
217
+
218
+ - 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.
219
+ - Updated dependencies [22acfcf]
220
+ - @sekyro/web@0.1.0-rc.12
221
+
222
+ ## 0.1.0-rc.9
223
+
224
+ ### Minor Changes
225
+
226
+ - 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.
227
+
228
+ ### Patch Changes
229
+
230
+ - 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.
231
+ - 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.
232
+ - Updated dependencies [a3247a3]
233
+ - Updated dependencies [032585b]
234
+ - Updated dependencies [f13b832]
235
+ - Updated dependencies [90dde69]
236
+ - @sekyro/web@0.1.0-rc.11
237
+
238
+ ## 0.1.0-rc.8
239
+
240
+ ### Minor Changes
241
+
242
+ - 97fe8cf: Assisted capture follow-ups.
243
+
244
+ - `<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.
245
+ - 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.
246
+ - 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.
247
+ - 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.
248
+
249
+ - Self capture (the default, and every capture-only `<LivenessCapture>`): the front camera only, no front/back picker, no switch on the stage.
250
+ - 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.
251
+ - `IntroContext` gains `captureMode`; `canChooseFacing` is `false` in a self capture.
252
+ - 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`.
253
+
254
+ ### Patch Changes
255
+
256
+ - 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.
257
+ - 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.
258
+ - Updated dependencies [a3cd61c]
259
+ - Updated dependencies [7ce5ab1]
260
+ - Updated dependencies [b092ac3]
261
+ - Updated dependencies [857ec58]
262
+ - @sekyro/web@0.1.0-rc.10
263
+
264
+ ## 0.1.0-rc.7
265
+
266
+ ### Minor Changes
267
+
268
+ - 1639f8a: Sekyro flows: one choice screen for every choice of the flow plan (`plan.choice`).
269
+
270
+ - `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).
271
+ - The section progress follows `plan.sections` (`done | current | upcoming`); `section.screening` copy added.
272
+ - The identity summary is the `summary_confirm` step (no API change).
273
+ - 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.
274
+ - Flow-view chunk budget 10 240 → 10 752 B gzip (the generic choice copy, then the in-lane switch views).
275
+
276
+ ### Patch Changes
277
+
278
+ - Updated dependencies [8dbdcf3]
279
+ - @sekyro/web@0.1.0-rc.9
280
+
281
+ ## 0.1.0-rc.6
282
+
283
+ ### Minor Changes
284
+
285
+ - ff0dcc7: Flow model 2026-10-23 (web lane):
286
+
287
+ - `<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).
288
+ - `<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.
289
+ - `<LivenessCapture>`: `tipsSummary` (the spoken summary of custom tips, device voice) and `coach` (host coaching that replaces the guidance line while the camera runs).
290
+ - Step copy: new optional keys (`consent.short`, `consent.termsLink`, `section.*`, `contact.*`, `summary.*`, `capture.tipsIcao.*`, `portrait.retakeOnly`, `portrait.keepCamera`, `handoff.*`, `inApp.*`, `eid.continueHint*`, `session.progressLabel`).
291
+ - 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).
292
+ - 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.
293
+
294
+ **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.
295
+ - 7a3f935: Phone OTP channel choice and the email OTP step.
296
+
297
+ - `@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`.
298
+ - `@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`).
299
+ - `@sekyro/node`: profile `phone.channels` / `phone.destinations`, `email` (`ProfileEmail`: `emailSource`, `disposable`), `attempts.email`, the `input.email` session anchor and the `email_otp` check type.
300
+ - 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.
301
+ - 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.
302
+ - 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.
303
+ - 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.
304
+ - 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.
305
+ - c9edead: `<SekyroVerification>` takes the Sekyro identity the Android and iOS SDKs share: the partner's logo (or initials) and name
306
+ over "identity verification", the section progress (flow model v3) drawn as thin bars, the Sekyro brand as the default
307
+ theme (partner branding and the runtime theme still win), six-box one-time code fields, document cards with an icon
308
+ and a subtitle, the camera stages in the Sekyro navy, and a "Verified by Sekyro AI" footer (`slots.footer` replaces it,
309
+ `footer: null` hides it). New `colorScheme` prop: `light` (default), `dark` or `system`; in dark a partner's brand is
310
+ kept only while it stands out from the dark canvas.
311
+ The 0.1 surface (`DEFAULT_THEME`, `styles.css`, `<LivenessCapture>` and the other 0.1 components) is unchanged.
312
+
313
+ **Visible to existing `<SekyroVerification>` integrations.** Without a `theme` prop or session branding the flow now
314
+ draws in the Sekyro brand (it used `DEFAULT_THEME` before) and ends with a "Verified by Sekyro AI" line. To keep your
315
+ current look, pass your colours (`theme={{ colors: … }}`, or set them as the app's branding) and `slots={{ footer: null }}`.
316
+ `verification.css` now loads the SDK's fonts (`./fonts/*.woff2`): your bundler must emit them as assets (esbuild needs
317
+ `loader: { ".woff2": "file" }`; Vite, webpack 5 and Next.js do it by default) and your CSP `font-src` must allow them.
318
+ - fce1604: Web live MRZ (on-device, server-controlled, additive):
319
+
320
+ - `@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).
321
+ - `@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.
322
+
323
+ ### Patch Changes
324
+
325
+ - 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.
326
+
327
+ 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.
328
+ - 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.
329
+ - 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.
330
+ - 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.
331
+ - 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`.
332
+ - 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.
333
+ - 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.
334
+ - 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`.
335
+ - 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.
336
+ - 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.
337
+ - 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.
338
+ - 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.
339
+ - 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.
340
+ - 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.
341
+ - Updated dependencies [b81288e]
342
+ - Updated dependencies [d0c4f27]
343
+ - Updated dependencies [3438e10]
344
+ - Updated dependencies [e82324a]
345
+ - Updated dependencies [c9edead]
346
+ - Updated dependencies [f0ba853]
347
+ - Updated dependencies [626104f]
348
+ - Updated dependencies [0f19e99]
349
+ - Updated dependencies [76174c8]
350
+ - Updated dependencies [67a6be3]
351
+ - Updated dependencies [c9edead]
352
+ - Updated dependencies [650d70d]
353
+ - Updated dependencies [6571361]
354
+ - Updated dependencies [ff0dcc7]
355
+ - Updated dependencies [68b5df5]
356
+ - Updated dependencies [4c1aa5b]
357
+ - Updated dependencies [273d2ce]
358
+ - Updated dependencies [46905f2]
359
+ - Updated dependencies [9db49b8]
360
+ - Updated dependencies [6420611]
361
+ - Updated dependencies [9acafe1]
362
+ - Updated dependencies [2055ae5]
363
+ - Updated dependencies [9e27401]
364
+ - Updated dependencies [7a3f935]
365
+ - Updated dependencies [723039c]
366
+ - Updated dependencies [4dd2b68]
367
+ - Updated dependencies [471d833]
368
+ - Updated dependencies [8425e95]
369
+ - Updated dependencies [c9edead]
370
+ - Updated dependencies [8425e95]
371
+ - Updated dependencies [a3689e4]
372
+ - Updated dependencies [45f639f]
373
+ - Updated dependencies [c9edead]
374
+ - Updated dependencies [bc29977]
375
+ - Updated dependencies [4e6bfb8]
376
+ - Updated dependencies [69638fa]
377
+ - Updated dependencies [5eec558]
378
+ - Updated dependencies [fce1604]
379
+ - Updated dependencies [bdcd56e]
380
+ - Updated dependencies [426e180]
381
+ - Updated dependencies [2f9e980]
382
+ - Updated dependencies [b4c8465]
383
+ - Updated dependencies [225aeea]
384
+ - @sekyro/web@0.1.0-rc.8
385
+
386
+ ## 0.1.0-rc.5
387
+
388
+ ### Minor Changes
389
+
390
+ - 06ea302: Org and app branding from the Sekyro AI dashboard.
391
+
392
+ - `@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.
393
+ - `@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.
394
+
395
+ ### Patch Changes
396
+
397
+ - 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.
398
+ - 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.
399
+ - 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.
400
+ - 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 }`).
401
+ - 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 }`).
402
+ - 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.
403
+ - 58e220c: Published bundles are now minified and no longer include source maps. The public API and types are unchanged.
404
+ - Updated dependencies [4e7a4a3]
405
+ - Updated dependencies [fa95c41]
406
+ - Updated dependencies [d321707]
407
+ - Updated dependencies [c3699fd]
408
+ - Updated dependencies [c3699fd]
409
+ - Updated dependencies [1b6bef2]
410
+ - Updated dependencies [1b6bef2]
411
+ - Updated dependencies [13d512f]
412
+ - Updated dependencies [acbf409]
413
+ - Updated dependencies [b230694]
414
+ - Updated dependencies [06ea302]
415
+ - Updated dependencies [58e220c]
416
+ - @sekyro/web@0.1.0-rc.7
417
+
418
+ ## 0.1.0-rc.4
419
+
420
+ ### Minor Changes
421
+
422
+ - e3469ab: The pre-capture screen can now read its instructions aloud. A "Listen to the instructions" button under the tips plays a short spoken summary of them, and tapping it again stops it.
423
+
424
+ - **When it shows.** The button needs something that can speak the summary in the current locale: a clip, or a device voice that `speechFallback` allows. It shows with the built-in tips, in any order. It never shows with `voice={false}`. It stays visible when the voice-guidance switch is off, because the person asked for it by tapping.
425
+ - **Playback.** It never auto-plays. The clip comes from the same source as the guidance clips: your `voice.clips`, else the session's Sekyro set, else the device voice. Playback stops when the person taps Start, when the screen unmounts, or when voice guidance is switched off. It never overlaps the guidance during capture. The tap is a user gesture, so it also unlocks audio on iOS.
426
+ - **New voice key `capture.tips.summary`.** It is now in `VOICE_KEYS` and `VoiceKey`, so a `voice.clips` resolver or map can also be asked for it. If your resolver builds file names from the key, check that it handles this key.
427
+ - **Custom tips.** With your own `tips`, or `tips={false}`, the built-in summary would describe tips that are not on the screen, so the button stays hidden. To offer it, put a `capture.tips.summary` clip for the locale in `voice.clips`. Optionally override the `capture.tips.summary` string too, as the device voice reads it when the clip cannot play: `voice={{ clips: { fr: { "capture.tips.summary": "https://cdn.example.com/fr/summary.mp3" } } }}`.
428
+ - **New strings** (en/fr/ar): `capture.tips.summary` (the spoken text), `capture.tips.listen` (the button label) and `capture.tips.stop` (the label while it plays).
429
+ - 4b7bbfc: Voice guidance in verification mode now speaks the recorded Sekyro clip set that comes with the session. The package no longer ships any audio.
430
+
431
+ - **Sekyro clips by default.** With a `verification`, `<LivenessCapture>` speaks the session's ar/fr clips, read through `verification.voiceClips()` from `@sekyro/web`. They are served from `https://assets.sekyro.ai`, so a page with a Content-Security-Policy must add that origin to `media-src`. Until the set arrives, when the session has none, or when it cannot be fetched, the device voice speaks as before. A set that arrives after the Start tap is prefetched then. The guidance being spoken is never repeated.
432
+ - **Your clips still win.** `voice.clips` replaces the Sekyro clips entirely. With it set, or with `voice={false}`, the component does not fetch the Sekyro set.
433
+ - **Capture-only mode is unchanged.** Without a `verification` there are no default clips, only the device voice, which is how it already behaved: the bundled set was empty.
434
+ - **Peer dependency:** `@sekyro/web` `^0.1.0-rc.6` (for `verification.voiceClips()`).
435
+
436
+ **Breaking (rc):**
437
+
438
+ - `VoiceOptions.clipBaseUrl` is removed. There is no bundled set left to locate.
439
+ - `createManifestResolver` and the `VoiceClipManifest` type are removed.
440
+ - The `@sekyro/react/assets/*` export, including `assets/audio/v1/`, is removed, and the package no longer ships an `assets/` directory.
441
+
442
+ If you host your own clips in the `<base>/<locale>/<name>.mp3` layout, pass a resolver. `<name>` is the last segment of the key, for example `center_face`:
443
+
444
+ ```ts
445
+ const base = "https://cdn.example.com/voice/v1";
446
+ const clips: VoiceClipResolver = (key, locale) => `${base}/${locale}/${key.slice(key.lastIndexOf(".") + 1)}.mp3`;
447
+ <LivenessCapture verification={verification} locale="fr" voice={{ clips }} />;
448
+ ```
449
+
450
+ ### Patch Changes
451
+
452
+ - 26270c4: Shorter pre-capture spoken summary (`capture.tips.summary`) in fr, en and ar: well-lit place, uncover your face, phone at eye level, look at the camera and keep still.
453
+ - 819d2fa: Clarify the `fcv3.too_bright` capture hint (en/fr/ar). The old wording ("turn away from the light source" / "tournez-vous dos à la source de lumière") could lead users to backlight their face; it now reads "Too much light — move out of direct light" / "Trop de lumière — évitez la lumière directe sur le visage" / "الإضاءة قوية جدًا — تجنّب الضوء المباشر على وجهك".
454
+ - Updated dependencies [54b153c]
455
+ - @sekyro/web@0.1.0-rc.6
456
+
457
+ ## 0.1.0-rc.3
458
+
459
+ ### Minor Changes
460
+
461
+ - 1ab07df: `<LivenessCapture>` now ships a built-in "get ready" screen and speaks the capture guidance.
462
+
463
+ - **Pre-capture screen (default intro).** Tips, a camera-permission row, a front/back camera choice (on devices with both), a voice switch, the security note and one Start control that waits for the detector preload (`preloadLivenessAssets`, started on mount): busy while the models download, ready to start, or a Retry if the download failed.
464
+ - **New props:** `notice` (a node or `{ tone, text }` above the screen, pre-capture only), `startDisabled` / `startLabel` (e.g. a cooldown; gates only the built-in Start, not the error Retry / "record again" / retake), `tips` (`false`, or built-in ids / your own `IntroTip`s; `DEFAULT_TIPS`), `defaultFacing`, `voice` (`false` or `VoiceOptions`), `onGuidance(key)` (once per displayed `fcv3.*` key change).
465
+ - **`autoStart: "when-permitted"`** starts only when the camera permission is already granted (until the permission probe answers, the screen shows its loader). **Behaviour change:** `autoStart` (both forms) now waits for the detector preload to be ready before starting; meanwhile the screen shows its loader (or the retry on failure).
466
+ - **Voice guidance, on by default.** Bundled clips (`assets/audio/v1`, served at `${assetBaseUrl ?? "/models-v3"}/audio/v1`) with a device-voice (speechSynthesis) fallback; a stage chip and the intro switch toggle it; the choice persists in `localStorage`. `VoiceOptions.clips` takes a `VoiceClipSource`: a resolver `(key, locale) => url | null` or a `{ [locale]: { [voiceKey]: url } }` map (e.g. from your backend); `createManifestResolver(manifest, baseUrl)` resolves over a clip-set manifest. CSP: `media-src 'self' blob:` is enough. On iOS audio unlocks in the Start tap; with `autoStart` it unlocks on the first activating touch (`touchend`), click or key press (not Escape) inside the component. Clips are prefetched in that same gesture, and only while voice is on.
467
+ - **Slots:** `slots.intro(start, context)` gets an `IntroContext` (preload gate + retry, permission, facing + setter, voice), and `start` opens the chosen camera. `slots.voicePrompt(hint, text, key, voice)` replaces the built-in chip and gets the `VoiceControl` (`{ supported, enabled, setEnabled, toggle }`) as a 4th argument.
468
+ - **Migration — partners who speak from `voicePrompt`:** the component now speaks the guidance itself; pass `voice={false}` or the person hears it twice. A development build warns once (`console.warn`) when `slots.voicePrompt` is set and `voice` is left undefined; pass `voice={false}` (your slot speaks) or `voice={{}}` (keep the built-in voice) to silence it.
469
+ - **Migration — hosts with their own intro + `autoStart`:** if you render your own "get ready" screen outside the component and mount it with `autoStart`, the built-in pre-capture screen now appears (with its loader) while the detector preload loads, instead of the camera starting at once. Pass `slots.intro` to keep your own look during that wait (e.g. `(start, context) => context.assets === "failed" ? <YourRetry onClick={context.retryAssets} /> : <YourLoader />`), or move your intro into `slots.intro` and drop `autoStart`.
470
+ - New exports: `LivenessNotice`, `IntroContext`, `IntroTip`, `BuiltInTipId`, `DEFAULT_TIPS`, `VoiceOptions`, `VoiceControl`, `VoiceKey`, `VOICE_KEYS`, `VoiceClipSource`, `VoiceClipMap`, `VoiceClipResolver`, `VoiceClipManifest`, `createManifestResolver`.
471
+ - The bundle is now built with whitespace/syntax minification (identifiers, function names and sourcemaps kept). `process.env.NODE_ENV` stays a live expression in the published bundle, so the dev-only warnings follow your build mode.
472
+ - Peer dependency: `@sekyro/web` `^0.1.0-rc.5` (the pre-capture building blocks).
473
+
474
+ ### Patch Changes
475
+
476
+ - Updated dependencies [a14ac15]
477
+ - Updated dependencies [66522c3]
478
+ - @sekyro/web@0.1.0-rc.5
479
+
3
480
  ## 0.1.0-rc.2
4
481
 
5
482
  ### Patch Changes
package/LICENSE CHANGED
@@ -1,20 +1,29 @@
1
- Sekyro SDK — Proprietary License
1
+ Sekyro AI SDK License (proprietary)
2
2
 
3
- Copyright (c) 2026 Ibtikar Technologies. All rights reserved.
3
+ Copyright (c) 2026 Ibtikar Technologies, Inc. All rights reserved.
4
4
 
5
- This software (the "SDK") is proprietary to Ibtikar Technologies. Use is
6
- permitted only under a Sekyro customer agreement with Ibtikar Technologies, and
7
- only to integrate the customer's own applications with the Sekyro
8
- identity-verification service. For that purpose you may install the SDK
9
- from the public npm registry and run it unmodified.
5
+ This SDK is proprietary software of Ibtikar Technologies, Inc., licensed
6
+ only under the Sekyro AI SDK License:
7
+ https://sekyro.ai/en/legal/sdk-license
8
+ (in French: https://sekyro.ai/fr/legal/sdk-license,
9
+ in Arabic: https://sekyro.ai/ar/legal/sdk-license).
10
10
 
11
- No other right or license, express or implied, is granted. You may not
12
- modify, reverse-engineer, redistribute, sublicense, resell or create
13
- derivative works of the SDK, nor remove or alter this notice. The source
14
- code is published for transparency (build provenance, security review); its
15
- publication grants no additional rights.
11
+ In short, and subject to the full license:
16
12
 
17
- THE SDK IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18
- IMPLIED. TO THE EXTENT PERMITTED BY LAW, IBTIKAR TECHNOLOGIES SHALL NOT BE
19
- LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY ARISING FROM THE USE OF THE
20
- SDK, EXCEPT AS PROVIDED IN THE APPLICABLE CUSTOMER AGREEMENT.
13
+ - You may use the SDK only with a Sekyro AI account, a customer agreement
14
+ with Ibtikar Technologies, Inc. and valid API keys, to integrate the
15
+ Sekyro AI services into your own applications. You may distribute it to
16
+ your end users only as embedded in those applications.
17
+ - You may not use it with another identity verification provider, modify it
18
+ beyond the configuration and theming it exposes, reverse engineer,
19
+ decompile or disassemble it (except where the law expressly allows it),
20
+ circumvent its security, attestation, license checks or usage metering,
21
+ or distribute or sublicense it on its own.
22
+ - Open-source components keep their own licenses. See the third-party
23
+ notices shipped with this SDK.
24
+ - The SDK is provided "as is", without warranty, except as your customer
25
+ agreement provides. The license is governed by the laws of the State of
26
+ Delaware, USA. If this license and your customer agreement conflict,
27
+ the customer agreement prevails.
28
+
29
+ Questions: contact@sekyro.ai