@sekyro/web 0.1.0-rc.1 → 0.1.0-rc.11

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 (127) hide show
  1. package/CHANGELOG.md +225 -0
  2. package/LICENSE +25 -16
  3. package/README.md +105 -61
  4. package/THIRD-PARTY-NOTICES.txt +154 -0
  5. package/dist/background-monitor-A7FKJOAG.js +1 -0
  6. package/dist/capture-constraints-B5omafmk.d.cts +44 -0
  7. package/dist/capture-constraints-B5omafmk.d.ts +44 -0
  8. package/dist/capture-session-doc-DMQ7T3HC.js +1 -0
  9. package/dist/{capture-session-v3-CAoWM8iT.d.cts → capture-session-v3-CCHws1mz.d.cts} +174 -15
  10. package/dist/{capture-session-v3-BJ8ciaWl.d.ts → capture-session-v3-DYrhYJoM.d.ts} +174 -15
  11. package/dist/chunk-73M7LS4H.js +1 -0
  12. package/dist/chunk-7ZCZY3ZP.js +1 -0
  13. package/dist/chunk-A3FUGHAH.js +2 -0
  14. package/dist/chunk-AHD4DA2V.js +1 -0
  15. package/dist/chunk-BPE5NSQ2.js +1 -0
  16. package/dist/chunk-CJHMFPL6.js +1 -0
  17. package/dist/chunk-DFTCAWMP.js +1 -0
  18. package/dist/chunk-DK5YPBDQ.js +1 -0
  19. package/dist/chunk-FHJ7HO3M.js +1 -0
  20. package/dist/chunk-FPXL63KZ.js +1 -0
  21. package/dist/chunk-FUHDOEBP.js +1 -0
  22. package/dist/chunk-G6LKLN4U.js +1 -0
  23. package/dist/chunk-GI3UFGRQ.js +1 -0
  24. package/dist/chunk-GT2ZLGF7.js +1 -0
  25. package/dist/chunk-HHCGQSD4.js +1 -0
  26. package/dist/chunk-IJLHPX35.js +1 -0
  27. package/dist/chunk-JDGEZ542.js +1 -0
  28. package/dist/chunk-LUKTHL6K.js +1 -0
  29. package/dist/chunk-MXNZMTC2.js +1 -0
  30. package/dist/chunk-MXWLCDFX.js +1 -0
  31. package/dist/chunk-O5WKNZ2C.js +1 -0
  32. package/dist/chunk-OKWG3PVH.js +1 -0
  33. package/dist/chunk-OWU22VXP.js +1 -0
  34. package/dist/chunk-POIQGEZM.js +1 -0
  35. package/dist/chunk-RI3E7GBN.js +1 -0
  36. package/dist/chunk-SMKCBUJL.js +1 -0
  37. package/dist/chunk-TDLIXFDT.js +1 -0
  38. package/dist/chunk-U6TYL2IJ.js +1 -0
  39. package/dist/chunk-URUKV6NC.js +1 -0
  40. package/dist/chunk-V5K2JLC7.js +1 -0
  41. package/dist/client/index.cjs +1 -357
  42. package/dist/client/index.d.cts +37 -3
  43. package/dist/client/index.d.ts +37 -3
  44. package/dist/client/index.js +1 -15
  45. package/dist/core/index.cjs +1 -1605
  46. package/dist/core/index.d.cts +5 -4
  47. package/dist/core/index.d.ts +5 -4
  48. package/dist/core/index.js +1 -139
  49. package/dist/core/ocr/worker.bundle.js +42 -0
  50. package/dist/core/ocr/worker.cjs +42 -0
  51. package/dist/core/ocr/worker.d.cts +84 -0
  52. package/dist/core/ocr/worker.d.ts +84 -0
  53. package/dist/core/ocr/worker.js +41 -0
  54. package/dist/core/v3/detect-worker.cjs +1 -392
  55. package/dist/core/v3/detect-worker.d.cts +1 -1
  56. package/dist/core/v3/detect-worker.d.ts +1 -1
  57. package/dist/core/v3/detect-worker.js +1 -13
  58. package/dist/create-document-capture-FV4XGUKQ.js +1 -0
  59. package/dist/create-portrait-capture-C462EIB6.js +1 -0
  60. package/dist/create-verification-CmJzn7sq.d.ts +3041 -0
  61. package/dist/create-verification-CzLrQjeM.d.cts +3041 -0
  62. package/dist/{detect-worker-CKXHlXx9.d.cts → detect-worker-DclNxkZT.d.cts} +6 -0
  63. package/dist/{detect-worker-CKXHlXx9.d.ts → detect-worker-DclNxkZT.d.ts} +6 -0
  64. package/dist/detector-scanic-YCDNLCGV.js +1 -0
  65. package/dist/icao-gate-BeznQECA.d.cts +500 -0
  66. package/dist/icao-gate-Bw5sQVlt.d.ts +500 -0
  67. package/dist/icao-gate-PWBMKRGC.js +1 -0
  68. package/dist/icao-tuning-4GGVX6B4.js +1 -0
  69. package/dist/index.cjs +1 -2580
  70. package/dist/index.d.cts +84 -5
  71. package/dist/index.d.ts +84 -5
  72. package/dist/index.js +1 -28
  73. package/dist/internal/index.cjs +1 -4110
  74. package/dist/internal/index.d.cts +364 -324
  75. package/dist/internal/index.d.ts +364 -324
  76. package/dist/internal/index.js +1 -647
  77. package/dist/keyframe-rank-YAJLYJYF.js +1 -0
  78. package/dist/landmarker-KB7LVXAU.js +1 -0
  79. package/dist/mrz-band-VYHOTDHY.js +1 -0
  80. package/dist/plan-runner-ZVAY4FSB.js +1 -0
  81. package/dist/popup/index.cjs +1 -76
  82. package/dist/popup/index.d.cts +7 -1
  83. package/dist/popup/index.d.ts +7 -1
  84. package/dist/popup/index.js +1 -11
  85. package/dist/scanic-ml-stub-KW7IZHUT.js +1 -0
  86. package/dist/segmenter-USLNBX65.js +1 -0
  87. package/dist/turnstile-FATNZ4AG.js +1 -0
  88. package/dist/types-BWyAHKt_.d.cts +1435 -0
  89. package/dist/types-BWyAHKt_.d.ts +1435 -0
  90. package/package.json +25 -10
  91. package/sbom.cdx.json +195 -0
  92. package/dist/capture-constraints-BujkZcfb.d.cts +0 -21
  93. package/dist/capture-constraints-BujkZcfb.d.ts +0 -21
  94. package/dist/chunk-LOTAJDRE.js +0 -1094
  95. package/dist/chunk-LOTAJDRE.js.map +0 -1
  96. package/dist/chunk-MWNFSNMP.js +0 -52
  97. package/dist/chunk-MWNFSNMP.js.map +0 -1
  98. package/dist/chunk-NILNKLK6.js +0 -50
  99. package/dist/chunk-NILNKLK6.js.map +0 -1
  100. package/dist/chunk-NU4YOLCN.js +0 -796
  101. package/dist/chunk-NU4YOLCN.js.map +0 -1
  102. package/dist/chunk-NWF46H7K.js +0 -359
  103. package/dist/chunk-NWF46H7K.js.map +0 -1
  104. package/dist/chunk-WY6U7AIK.js +0 -193
  105. package/dist/chunk-WY6U7AIK.js.map +0 -1
  106. package/dist/chunk-YVFF4Q4G.js +0 -327
  107. package/dist/chunk-YVFF4Q4G.js.map +0 -1
  108. package/dist/client/index.cjs.map +0 -1
  109. package/dist/client/index.js.map +0 -1
  110. package/dist/core/index.cjs.map +0 -1
  111. package/dist/core/index.js.map +0 -1
  112. package/dist/core/v3/detect-worker.cjs.map +0 -1
  113. package/dist/core/v3/detect-worker.js.map +0 -1
  114. package/dist/create-verification--ldwakXV.d.cts +0 -341
  115. package/dist/create-verification-BlAPWeW5.d.ts +0 -341
  116. package/dist/detector-scanic-4C6IEW2K.js +0 -787
  117. package/dist/detector-scanic-4C6IEW2K.js.map +0 -1
  118. package/dist/hosted-client-BpvBqu9f.d.cts +0 -408
  119. package/dist/hosted-client-BpvBqu9f.d.ts +0 -408
  120. package/dist/index.cjs.map +0 -1
  121. package/dist/index.js.map +0 -1
  122. package/dist/internal/index.cjs.map +0 -1
  123. package/dist/internal/index.js.map +0 -1
  124. package/dist/popup/index.cjs.map +0 -1
  125. package/dist/popup/index.js.map +0 -1
  126. package/dist/scanic-ml-stub-S2OZ6HEF.js +0 -10
  127. package/dist/scanic-ml-stub-S2OZ6HEF.js.map +0 -1
@@ -0,0 +1,154 @@
1
+ @sekyro/web: third-party notices
2
+ ================================
3
+
4
+ @sekyro/web is licensed under the Sekyro AI SDK License (see LICENSE). The
5
+ dist/ files of this package also contain the third-party components below,
6
+ which remain under their own licenses.
7
+
8
+ 1. scanic (document edge detection, classical pipeline)
9
+ Bundled in dist/ (the document detector chunks).
10
+ Copyright (c) 2025 marquaye
11
+ License: MIT License (full text in section A).
12
+
13
+ 2. Emscripten runtime and JavaScript glue, version 4.0.23
14
+ Bundled in the OCR worker (dist/core/ocr/worker.js, worker.cjs and
15
+ worker.bundle.js) as the loader of the on-device OCR engine.
16
+ Copyright (c) 2010-2014 Emscripten authors, see AUTHORS file.
17
+ License: MIT License or University of Illinois/NCSA Open Source License,
18
+ at your choice (full text in section B).
19
+
20
+ The OCR engine binary (sekyro-ocr.wasm) and its models are not part of this
21
+ package: they are downloaded at runtime, and their notices are published with
22
+ them.
23
+
24
+ -------------------------------------------------------------------------------
25
+ A. scanic: MIT License
26
+ -------------------------------------------------------------------------------
27
+
28
+ MIT License
29
+
30
+ Copyright (c) 2025 marquaye
31
+
32
+ Permission is hereby granted, free of charge, to any person obtaining a copy
33
+ of this software and associated documentation files (the "Software"), to deal
34
+ in the Software without restriction, including without limitation the rights
35
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
36
+ copies of the Software, and to permit persons to whom the Software is
37
+ furnished to do so, subject to the following conditions:
38
+
39
+ The above copyright notice and this permission notice shall be included in all
40
+ copies or substantial portions of the Software.
41
+
42
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
43
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
44
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
45
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
46
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
47
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
48
+ SOFTWARE.
49
+ -------------------------------------------------------------------------------
50
+ B. Emscripten: MIT License or University of Illinois/NCSA Open Source License
51
+ -------------------------------------------------------------------------------
52
+
53
+ Emscripten is available under 2 licenses, the MIT license and the
54
+ University of Illinois/NCSA Open Source License.
55
+
56
+ Both are permissive open source licenses, with little if any
57
+ practical difference between them.
58
+
59
+ The reason for offering both is that (1) the MIT license is
60
+ well-known, while (2) the University of Illinois/NCSA Open Source
61
+ License allows Emscripten's code to be integrated upstream into
62
+ LLVM, which uses that license, should the opportunity arise.
63
+
64
+ The full text of both licenses follows.
65
+
66
+ ==============================================================================
67
+
68
+ Copyright (c) 2010-2014 Emscripten authors, see AUTHORS file.
69
+
70
+ Permission is hereby granted, free of charge, to any person obtaining a copy
71
+ of this software and associated documentation files (the "Software"), to deal
72
+ in the Software without restriction, including without limitation the rights
73
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
74
+ copies of the Software, and to permit persons to whom the Software is
75
+ furnished to do so, subject to the following conditions:
76
+
77
+ The above copyright notice and this permission notice shall be included in
78
+ all copies or substantial portions of the Software.
79
+
80
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
81
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
82
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
83
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
84
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
85
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
86
+ THE SOFTWARE.
87
+
88
+ ==============================================================================
89
+
90
+ Copyright (c) 2010-2014 Emscripten authors, see AUTHORS file.
91
+ All rights reserved.
92
+
93
+ Permission is hereby granted, free of charge, to any person obtaining a
94
+ copy of this software and associated documentation files (the
95
+ "Software"), to deal with the Software without restriction, including
96
+ without limitation the rights to use, copy, modify, merge, publish,
97
+ distribute, sublicense, and/or sell copies of the Software, and to
98
+ permit persons to whom the Software is furnished to do so, subject to
99
+ the following conditions:
100
+
101
+ Redistributions of source code must retain the above copyright
102
+ notice, this list of conditions and the following disclaimers.
103
+
104
+ Redistributions in binary form must reproduce the above
105
+ copyright notice, this list of conditions and the following disclaimers
106
+ in the documentation and/or other materials provided with the
107
+ distribution.
108
+
109
+ Neither the names of Mozilla,
110
+ nor the names of its contributors may be used to endorse
111
+ or promote products derived from this Software without specific prior
112
+ written permission.
113
+
114
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
115
+ OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
116
+ MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
117
+ IN NO EVENT SHALL THE CONTRIBUTORS OR COPYRIGHT HOLDERS BE LIABLE FOR
118
+ ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
119
+ TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
120
+ SOFTWARE OR THE USE OR OTHER DEALINGS WITH THE SOFTWARE.
121
+
122
+ ==============================================================================
123
+
124
+ This program uses portions of Node.js source code located in src/library_path.js,
125
+ in accordance with the terms of the MIT license. Node's license follows:
126
+
127
+ """
128
+ Copyright Joyent, Inc. and other Node contributors. All rights reserved.
129
+ Permission is hereby granted, free of charge, to any person obtaining a copy
130
+ of this software and associated documentation files (the "Software"), to
131
+ deal in the Software without restriction, including without limitation the
132
+ rights to use, copy, modify, merge, publish, distribute, sublicense, and/or
133
+ sell copies of the Software, and to permit persons to whom the Software is
134
+ furnished to do so, subject to the following conditions:
135
+
136
+ The above copyright notice and this permission notice shall be included in
137
+ all copies or substantial portions of the Software.
138
+
139
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
140
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
141
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
142
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
143
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
144
+ FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS
145
+ IN THE SOFTWARE.
146
+ """
147
+
148
+ The musl libc project is bundled in this repo, and it has the MIT license, see
149
+ system/lib/libc/musl/COPYRIGHT
150
+
151
+ The third_party/ subdirectory contains code with other licenses. None of it is
152
+ used by default, but certain options use it (e.g., the optional closure compiler
153
+ flag will run closure compiler from third_party/).
154
+
@@ -0,0 +1 @@
1
+ import{a}from"./chunk-RI3E7GBN.js";import"./chunk-GI3UFGRQ.js";export{a as createBackgroundMonitor};
@@ -0,0 +1,44 @@
1
+ /** getUserMedia constraint tier — 720p-class on every device since 2026-07-06.
2
+ * The v2 FAS-CLIP liveness head loses its texture cues below ~720p: the SAME
3
+ * genuine clip scores heads 0.0001 at 720x1280 vs 0.355 at the old 480x360
4
+ * mobile tier, which pushed real users into review (first observed live on
5
+ * staging 2026-07-06; falsified on corpus clips the same day). Dimensions are
6
+ * sensor-relative (landscape); mobile browsers deliver portrait via rotation
7
+ * metadata, which the liveness service's decoder applies (cv2
8
+ * ORIENTATION_AUTO). `isMobile` is kept for call-site compat and future
9
+ * divergence — both tiers are 720p today. Bitrate pairs with VIDEO_BPS in
10
+ * clip-recorder.ts (2.5 Mbps). */
11
+ declare function buildCaptureConstraints(isMobile: boolean, facingMode: "user" | "environment"): MediaStreamConstraints;
12
+ /** The kind of device the browser runs on (spec 2026-10-28 §4.2). */
13
+ type FormFactor = "phone" | "tablet" | "desktop";
14
+ /** A touch device whose shorter screen side is below this (CSS px) is a phone; at or above it, a tablet. */
15
+ declare const PHONE_MAX_SHORT_SIDE = 600;
16
+ /**
17
+ * Phone, tablet or desktop:
18
+ * - phone: an iPhone / iPod user agent, an Android user agent with `Mobile`, a legacy mobile user agent, or a touch
19
+ * device with a coarse primary pointer whose shorter screen side is under {@link PHONE_MAX_SHORT_SIDE} CSS px;
20
+ * - tablet: iPadOS (an iPad user agent, or the desktop `Macintosh` one with touch points), Android without `Mobile`,
21
+ * and other touch devices with a coarse primary pointer (Windows / ChromeOS tablets);
22
+ * - desktop: everything else. The window width plays no part: a narrow desktop window is still a desktop, and a touch
23
+ * laptop keeps a fine primary pointer.
24
+ * SSR-safe (`desktop` without window / navigator).
25
+ */
26
+ declare function detectFormFactor(): FormFactor;
27
+ /**
28
+ * Whether this browser runs on a phone or tablet ({@link detectFormFactor} is not `desktop`): the capture channel,
29
+ * `mobile_required` and the hand-over use it. The upright guard is phones only.
30
+ */
31
+ declare function detectIsMobile(): boolean;
32
+ /**
33
+ * The facing the live video track of `stream` reports (`getSettings().facingMode`), or `null` when the track does not
34
+ * say (most desktop webcams) or reports something else (`left` / `right`). Never throws.
35
+ */
36
+ declare function trackFacingMode(stream: MediaStream | null | undefined): "user" | "environment" | null;
37
+ /** Gate radius as a fraction of the guidance circle (v1 L501: circleSize × 0.45). */
38
+ declare const CIRCLE_RADIUS_FACTOR = 0.45;
39
+ /** `inCircle` tolerance as a fraction of the gate radius (v1 L508: r × 0.9). */
40
+ declare const IN_CIRCLE_FACTOR = 0.9;
41
+ /** `centered` tolerance as a fraction of the gate radius (v1 L509: r × 0.4). */
42
+ declare const CENTERED_FACTOR = 0.4;
43
+
44
+ export { CENTERED_FACTOR as C, type FormFactor as F, IN_CIRCLE_FACTOR as I, PHONE_MAX_SHORT_SIDE as P, CIRCLE_RADIUS_FACTOR as a, buildCaptureConstraints as b, detectIsMobile as c, detectFormFactor as d, trackFacingMode as t };
@@ -0,0 +1,44 @@
1
+ /** getUserMedia constraint tier — 720p-class on every device since 2026-07-06.
2
+ * The v2 FAS-CLIP liveness head loses its texture cues below ~720p: the SAME
3
+ * genuine clip scores heads 0.0001 at 720x1280 vs 0.355 at the old 480x360
4
+ * mobile tier, which pushed real users into review (first observed live on
5
+ * staging 2026-07-06; falsified on corpus clips the same day). Dimensions are
6
+ * sensor-relative (landscape); mobile browsers deliver portrait via rotation
7
+ * metadata, which the liveness service's decoder applies (cv2
8
+ * ORIENTATION_AUTO). `isMobile` is kept for call-site compat and future
9
+ * divergence — both tiers are 720p today. Bitrate pairs with VIDEO_BPS in
10
+ * clip-recorder.ts (2.5 Mbps). */
11
+ declare function buildCaptureConstraints(isMobile: boolean, facingMode: "user" | "environment"): MediaStreamConstraints;
12
+ /** The kind of device the browser runs on (spec 2026-10-28 §4.2). */
13
+ type FormFactor = "phone" | "tablet" | "desktop";
14
+ /** A touch device whose shorter screen side is below this (CSS px) is a phone; at or above it, a tablet. */
15
+ declare const PHONE_MAX_SHORT_SIDE = 600;
16
+ /**
17
+ * Phone, tablet or desktop:
18
+ * - phone: an iPhone / iPod user agent, an Android user agent with `Mobile`, a legacy mobile user agent, or a touch
19
+ * device with a coarse primary pointer whose shorter screen side is under {@link PHONE_MAX_SHORT_SIDE} CSS px;
20
+ * - tablet: iPadOS (an iPad user agent, or the desktop `Macintosh` one with touch points), Android without `Mobile`,
21
+ * and other touch devices with a coarse primary pointer (Windows / ChromeOS tablets);
22
+ * - desktop: everything else. The window width plays no part: a narrow desktop window is still a desktop, and a touch
23
+ * laptop keeps a fine primary pointer.
24
+ * SSR-safe (`desktop` without window / navigator).
25
+ */
26
+ declare function detectFormFactor(): FormFactor;
27
+ /**
28
+ * Whether this browser runs on a phone or tablet ({@link detectFormFactor} is not `desktop`): the capture channel,
29
+ * `mobile_required` and the hand-over use it. The upright guard is phones only.
30
+ */
31
+ declare function detectIsMobile(): boolean;
32
+ /**
33
+ * The facing the live video track of `stream` reports (`getSettings().facingMode`), or `null` when the track does not
34
+ * say (most desktop webcams) or reports something else (`left` / `right`). Never throws.
35
+ */
36
+ declare function trackFacingMode(stream: MediaStream | null | undefined): "user" | "environment" | null;
37
+ /** Gate radius as a fraction of the guidance circle (v1 L501: circleSize × 0.45). */
38
+ declare const CIRCLE_RADIUS_FACTOR = 0.45;
39
+ /** `inCircle` tolerance as a fraction of the gate radius (v1 L508: r × 0.9). */
40
+ declare const IN_CIRCLE_FACTOR = 0.9;
41
+ /** `centered` tolerance as a fraction of the gate radius (v1 L509: r × 0.4). */
42
+ declare const CENTERED_FACTOR = 0.4;
43
+
44
+ export { CENTERED_FACTOR as C, type FormFactor as F, IN_CIRCLE_FACTOR as I, PHONE_MAX_SHORT_SIDE as P, CIRCLE_RADIUS_FACTOR as a, buildCaptureConstraints as b, detectIsMobile as c, detectFormFactor as d, trackFacingMode as t };
@@ -0,0 +1 @@
1
+ import{C as a,D as b,E as c,F as d,G as e,H as f,I as g,J as h}from"./chunk-OWU22VXP.js";import"./chunk-SMKCBUJL.js";import"./chunk-MXWLCDFX.js";import"./chunk-G6LKLN4U.js";import"./chunk-TDLIXFDT.js";import"./chunk-POIQGEZM.js";import"./chunk-FHJ7HO3M.js";import"./chunk-FPXL63KZ.js";import"./chunk-LUKTHL6K.js";import"./chunk-DK5YPBDQ.js";export{h as CAPTURE_CANDIDATE_SPACING_MS,g as CAPTURE_EXTRA_CANDIDATES,e as CaptureSessionDoc,b as DOC_CADENCE_HZ,c as DOC_SHUTTER_DEFAULTS,f as passportBandOf,d as resolveDocShutterTuning,a as warmDocDetector};
@@ -1,4 +1,5 @@
1
- import { F as FaceObservation, b as Detector, W as WorkerLike } from './detect-worker-CKXHlXx9.cjs';
1
+ import { al as ScreenRampReport, i as CaptureProvenance, aj as ScreenRampChallenge, S as ScreenRampColour } from './types-BWyAHKt_.cjs';
2
+ import { F as FaceObservation, b as Detector, W as WorkerLike } from './detect-worker-DclNxkZT.cjs';
2
3
 
3
4
  /** MP4-first ladder: one container (H.264 MP4) covers iOS/macOS Safari + Chrome 130+.
4
5
  * WebM/VP9→VP8 only as the Firefox/older-Chromium fallback. */
@@ -67,8 +68,14 @@ declare class ClipRecorder {
67
68
  * instead of waiting for the blob. PURE NOTIFICATION — it does not touch
68
69
  * timers, chunks, or the finalize path, so it is calibration-neutral (no
69
70
  * effect on clip bytes). Never fires on a rejected capture (error /
70
- * cliptoolarge settle before the hard-stop and clear the timer). */
71
- record(stream: MediaStream, onStopped?: () => void): Promise<ClipResult>;
71
+ * cliptoolarge settle before the hard-stop and clear the timer).
72
+ *
73
+ * `onStarted` (optional, liveness v7 §4.4) fires ONCE on the recorder's
74
+ * `start` event: the zero of the clip's own timeline, which the screen ramp
75
+ * stamps its colour changes against. PURE NOTIFICATION as well (the
76
+ * `onstart` handler was unset before; nothing else changes), so it is
77
+ * calibration-neutral. Never fires when construction or `start()` failed. */
78
+ record(stream: MediaStream, onStopped?: () => void, onStarted?: () => void): Promise<ClipResult>;
72
79
  /** Idempotent teardown: stop recorder + ALL tracks (v1 `stopAndCleanup` + the unmount
73
80
  * effect). Optional `stream` override mirrors v1's `stopAndCleanup(stream?)`.
74
81
  *
@@ -105,16 +112,39 @@ interface GateChecks {
105
112
  goodQuality: boolean;
106
113
  stable: boolean;
107
114
  }
115
+ /**
116
+ * Client-side capture timing (face-capture duration, 2026-10-17), measured
117
+ * by the engine with its monotonic clock (`performance.now()` by default) and
118
+ * rounded to whole milliseconds. All fields are optional: a phase that never
119
+ * happened (e.g. no face ever detected before a retry) is simply absent.
120
+ */
121
+ interface CaptureTiming {
122
+ /** `getUserMedia` call → stream attached and the preview playing. */
123
+ cameraReadyMs?: number;
124
+ /** Camera ready → the first tick on which the GATE accepted the face
125
+ * (present + size / centering / quality good enough to make progress —
126
+ * not merely detected). */
127
+ faceAcquireMs?: number;
128
+ /** FIRST accepted face → gate progress 100 % (capture complete, BEFORE the
129
+ * clip window / upload). A face lost and re-acquired keeps the first start. */
130
+ captureMs?: number;
131
+ }
108
132
  /** Capture output. Upload is NOT the engine's job — hosts submit these themselves. */
109
133
  interface CaptureArtifacts {
110
134
  /** Absent in photo mode. */
111
135
  clip?: Blob;
112
136
  /** Container mime the clip finalized with. Absent in photo mode. */
113
137
  clipMimeType?: string;
114
- /** Mirrored JPEG keyframe (captureMirroredKeyframe). */
138
+ /** JPEG keyframe (captureMirroredKeyframe): mirrored on the front camera, as the sensor sees it on the back one. */
115
139
  keyframe: Blob;
116
140
  /** JPEG data URL of the keyframe canvas (v1 preview, quality 0.92). */
117
141
  previewDataUrl: string;
142
+ /** Capture-phase timing of the attempt that produced these artifacts. */
143
+ timing?: CaptureTiming;
144
+ /** Liveness v7 §4.4: the screen ramp rendered against the session's issued challenge (clip mode, a challenge issued, a host painting). */
145
+ screenRamp?: ScreenRampReport;
146
+ /** Liveness v7 §4.5 item 2: how the capture was made (whenever the engine had a camera track). */
147
+ provenance?: CaptureProvenance;
118
148
  }
119
149
  interface CaptureSessionEvents {
120
150
  statechange: {
@@ -167,12 +197,13 @@ interface V3GateThresholds {
167
197
  /** Velocities at/below this (IOD/s) count as stillness — absorbs detector
168
198
  * box jitter (largest on LOW's 128px input) before it reaches the EMA. */
169
199
  MOTION_DEADBAND_IOD_PER_S: number;
170
- /** ready = p ≥ 1 AND mean q over this window ≥ READY_MEAN_Q. The mean is
171
- * TRIMMED: with ≥3 samples in the window the single worst is dropped, so
172
- * one flaky tick (5 Hz LOW cadence = only 2–3 samples per window) cannot
173
- * veto an otherwise-ready user. */
200
+ /** ready = p ≥ 1 AND no bad tick (q < Q_GOOD) left in this window after
201
+ * TRIMMING: with ≥3 samples the single worst is dropped, so one flaky tick
202
+ * (5 Hz LOW cadence = only 2–3 samples per window) cannot veto an
203
+ * otherwise-ready user, while a SECOND bad tick (a real sustained wobble)
204
+ * still blocks. The readiness bar is Q_GOOD itself — the level the
205
+ * integrator rises on — so any input that fills the ring also fires it. */
174
206
  READY_WINDOW_MS: number;
175
- READY_MEAN_Q: number;
176
207
  /** Per-factor guidance trigger levels (lowest failing factor speaks). */
177
208
  GUIDE_SIZE: number;
178
209
  GUIDE_CENTERING: number;
@@ -215,8 +246,12 @@ interface V3GateTick {
215
246
  factors: Record<V3GateFactor, number>;
216
247
  /** fcv3.* message key for the lowest failing factor (host translates). */
217
248
  guidanceKey: string;
218
- /** Fire signal: p ≥ 1 AND the READY_WINDOW mean q ≥ READY_MEAN_Q. */
249
+ /** Fire signal: p ≥ 1 AND no second bad tick (q < Q_GOOD) in READY_WINDOW_MS. */
219
250
  ready: boolean;
251
+ /** The face on THIS tick is ACCEPTED by the gate — present and every factor
252
+ * (size, centering, pose, sharpness, exposure, motion) good enough that the
253
+ * integrator RISES (q ≥ Q_GOOD). The engine's "first accepted face" mark. */
254
+ accepted: boolean;
220
255
  }
221
256
  declare class FaceGateV3 {
222
257
  private readonly t;
@@ -288,9 +323,47 @@ declare class DeviceProfiler {
288
323
  record(detectMs: number): DeviceClass;
289
324
  }
290
325
 
326
+ /** Why a gate tick did not advance: no face, or the weakest gate check. */
327
+ type GateBlockReason = "no_face" | Exclude<V3GateFactor, "presence">;
328
+ interface GateBlockEntry {
329
+ /** Ticks blocked by this reason. */
330
+ count: number;
331
+ /** Wall time (whole ms) those ticks covered. */
332
+ ms: number;
333
+ }
334
+ interface GateBlockSummary {
335
+ /** Only the reasons that blocked at least once. */
336
+ blocked: Partial<Record<GateBlockReason, GateBlockEntry>>;
337
+ /** Wall time (whole ms) of ticks the gate accepted (progress rising). */
338
+ acceptedMs: number;
339
+ /** Total ticks seen. */
340
+ ticks: number;
341
+ }
342
+ /** The reason one tick was held back, or null when the gate accepted it. */
343
+ declare function blockReasonOf(tick: Pick<V3GateTick, "accepted" | "factors">): GateBlockReason | null;
344
+ declare class GateBlockStats {
345
+ private blocked;
346
+ private acceptedMs;
347
+ private ticks;
348
+ private lastAt;
349
+ /** Record one gate tick; the time since the previous tick is charged to THIS tick's state. */
350
+ record(tick: Pick<V3GateTick, "at" | "accepted" | "factors">): void;
351
+ summary(): GateBlockSummary;
352
+ }
353
+
354
+ /** A non-final `gate` telemetry snapshot at most this often while positioning
355
+ * (so an abandoned attempt still reports where its time went). */
356
+ declare const GATE_SNAPSHOT_MS = 1000;
357
+ /** Guidance key while a phone shows a landscape camera frame (the upright guard). */
358
+ declare const HOLD_UPRIGHT_KEY = "fcv3.hold_upright";
359
+ /** How often the upright guard re-reads the frame size while the clip records (plus every `resize` event). */
360
+ declare const UPRIGHT_WATCH_MS = 200;
291
361
  /** Best-of-N keyframe window: up to 4 candidates over the first 600ms. */
292
362
  declare const KEYFRAME_CANDIDATES = 4;
293
363
  declare const KEYFRAME_WINDOW_MS = 600;
364
+ /** Liveness v7 §4.5 item 2: the longest the capture waits on the track description (its WebCrypto hash) once the
365
+ * clip is done; past it the artifacts ship without `provenance`. */
366
+ declare const PROVENANCE_WAIT_MS = 1000;
294
367
  interface V3ChecksPayload {
295
368
  engine: "v3";
296
369
  /** Gate integrator 0..1 — the ring drives off this directly. */
@@ -324,6 +397,12 @@ interface CaptureSessionV3Events {
324
397
  frozen: {
325
398
  previewDataUrl: string;
326
399
  };
400
+ /** Liveness v7 §4.4: paint the full-viewport screen-ramp layer this colour (`null` clears it). Clip mode, a
401
+ * challenge issued by `screenRamp()`; at most four events per recording. CHROME-only: the host paints, the
402
+ * engine stamps the clip timeline. */
403
+ ramp: {
404
+ colour: ScreenRampColour | null;
405
+ };
327
406
  }
328
407
  type V3TelemetryEvent = {
329
408
  type: "detector";
@@ -339,10 +418,39 @@ type V3TelemetryEvent = {
339
418
  timeToGateMs: number;
340
419
  degradeCount: number;
341
420
  meanDetectMs: number;
342
- } | {
421
+ }
422
+ /** Where the attempt's gate time went (see gate-blocking.ts): per-reason
423
+ * blocked tick counts + ms, accepted ms, and the ACTIVE device class /
424
+ * cadence after any dynamic profile adjustment. `final` on the attempt's
425
+ * end (fired / error / retry / destroy); throttled snapshots before it. */
426
+ | ({
427
+ type: "gate";
428
+ final: boolean;
429
+ activeClass: DeviceClass;
430
+ cadenceHz: number;
431
+ } & GateBlockSummary) | {
343
432
  type: "error";
344
433
  kind: CaptureErrorKind;
345
434
  fallbackReason?: string;
435
+ }
436
+ /** Keyframe ranking (SDK spec §4.8a; only when `rankKeyframes` is on): the
437
+ * rank numbers of every candidate (never an image), the chosen index, the
438
+ * index sharpness alone would have chosen, and the extra detector time. */
439
+ | {
440
+ type: "keyframe";
441
+ tier: Detector["tier"] | null;
442
+ chosen: number;
443
+ sharpest: number;
444
+ detectMs: number;
445
+ candidates: Array<{
446
+ face: boolean;
447
+ frontal: number;
448
+ yaw?: number;
449
+ roll?: number;
450
+ eyes?: number;
451
+ score: number;
452
+ sharpness: number;
453
+ }>;
346
454
  };
347
455
  interface KeyframeCandidate {
348
456
  blob: Blob;
@@ -381,7 +489,7 @@ interface CaptureSessionV3Options {
381
489
  createRecorder?: () => Pick<ClipRecorder, "record" | "stop">;
382
490
  /** (navigator.mediaDevices.getUserMedia) */
383
491
  getUserMedia?: (constraints: MediaStreamConstraints) => Promise<MediaStream>;
384
- /** (mirrored canvas keyframe + downscaled Laplacian sharpness) */
492
+ /** (canvas keyframe, mirrored on the front camera only, + downscaled Laplacian sharpness) */
385
493
  captureKeyframe?: (video: HTMLVideoElement) => Promise<KeyframeCandidate>;
386
494
  /** (downscaled face-crop sharpness/exposure via canvas) */
387
495
  measureQuality?: (video: HTMLVideoElement, box: {
@@ -398,13 +506,33 @@ interface CaptureSessionV3Options {
398
506
  * worker-side through WorkerDetectorProxy. Hosts own Worker construction
399
507
  * (bundler-specific `new Worker(new URL(...))`). */
400
508
  createWorker?: () => WorkerLike;
509
+ /** Keyframe ranking switch (SDK spec §4.8a; server tuning
510
+ * `capture.liveness.keyframe.rank`, default off): read when positioning
511
+ * starts (prefetches the lazy ranker) and again when the capture fires.
512
+ * Off → today's sharpest-of-N, byte for byte. */
513
+ rankKeyframes?: () => boolean;
514
+ /** Screen-ramp challenge (liveness v7 §4.4; server tuning `capture.liveness.screenRamp`): read once when the
515
+ * clip recording starts. A challenge → the engine emits `ramp` at each issued onset on the clip timeline and
516
+ * reports what it rendered in `artifacts.screenRamp`; `undefined` (older backends, assisted sessions, no host
517
+ * painting) → no ramp, no field. Photo mode never ramps. */
518
+ screenRamp?: () => ScreenRampChallenge | undefined;
401
519
  /** INERT (Phase 3 escalation seam — see EscalationHook). Accepted and
402
520
  * retained, never called in Phases 1–2. */
403
521
  escalation?: EscalationHook;
522
+ /** Upright guard (spec 2026-10-28 §4.2): the device is a phone, so a landscape frame (videoWidth > videoHeight)
523
+ * holds the gate and drops a clip being recorded (or the keyframes of a photo-mode capture). Read at each attempt
524
+ * start. (detectFormFactor() === 'phone' — desktop webcams are landscape by nature, and a tablet may stand in
525
+ * landscape on a stand: neither is ever guarded) */
526
+ isPhone?: () => boolean;
404
527
  /** (performance.now) */
405
528
  now?: () => number;
406
529
  }
407
530
  type Handler<K extends keyof CaptureSessionV3Events> = (payload: CaptureSessionV3Events[K]) => void;
531
+ /** Per-start options (the public handle's `start({ facing })`). */
532
+ interface CaptureSessionV3StartOptions {
533
+ /** Camera for this attempt AND later retries; absent → keep the current one. */
534
+ facingMode?: "user" | "environment";
535
+ }
408
536
  declare class CaptureSessionV3 {
409
537
  private readonly options;
410
538
  private readonly handlers;
@@ -418,14 +546,29 @@ declare class CaptureSessionV3 {
418
546
  private profiler;
419
547
  private lastGuidanceKey;
420
548
  private positioningStartedAt;
549
+ private cameraRequestedAt;
550
+ private cameraReadyAt;
551
+ private faceAcquiredAt;
552
+ private captureCompleteAt;
421
553
  private fired;
422
554
  private carriedDegrade;
423
555
  private carriedMeans;
556
+ private blockStats;
557
+ private lastGateSnapshotAt;
558
+ /** The upright guard applies to this attempt (a phone). */
559
+ private uprightGuard;
560
+ /** Liveness v7 §4.5 item 2: the attempt's video track described right after getUserMedia (null: no track). */
561
+ private trackProvenance;
562
+ /** The ramp of the clip being recorded (stopped with the recording, the attempt or the session). */
563
+ private ramp;
424
564
  constructor(options: CaptureSessionV3Options);
425
565
  get state(): CaptureState;
426
566
  on<K extends keyof CaptureSessionV3Events>(event: K, handler: Handler<K>): () => void;
427
567
  private emit;
428
- start(): Promise<void>;
568
+ start(options?: CaptureSessionV3StartOptions): Promise<void>;
569
+ /** The camera of the current attempt: the one its track reports once the stream is live, else the requested one
570
+ * (start option, switchCamera toggles). */
571
+ get facingMode(): "user" | "environment";
429
572
  /** Full reset + camera restart — the documented recovery path (v1 parity). */
430
573
  retry(): void;
431
574
  switchCamera(): void;
@@ -436,10 +579,24 @@ declare class CaptureSessionV3 {
436
579
  private startScheduler;
437
580
  private detectTick;
438
581
  private fire;
439
- /** Up to KEYFRAME_CANDIDATES mirrored frames over KEYFRAME_WINDOW_MS —
582
+ /** `{ provenance }` from the live track's description, the recording's frame statistics and the painter flag; `{}` without a track. */
583
+ private provenance;
584
+ /** A phone showing a landscape frame: the guard holds the gate. */
585
+ private isLandscape;
586
+ /** Positioning on a sideways phone: no detection, the gate restarts from zero and the coaching says why. */
587
+ private holdUpright;
588
+ /** While the clip records (or, `recorder` null, the photo-mode keyframes are taken): a rotation to landscape aborts
589
+ * it. Returns the unwatch function. */
590
+ private watchRotation;
591
+ /** Drop the clip being recorded (or the photo-mode keyframes being taken; same stream, same detector) and go back to
592
+ * positioning with the upright coaching. */
593
+ private abortRecording;
594
+ /** Up to KEYFRAME_CANDIDATES frames (mirrored on the front camera) over KEYFRAME_WINDOW_MS —
440
595
  * sharpest wins (reuses frame-quality.sharpness via the capture seam). */
441
596
  private collectKeyframes;
442
597
  private finishCapture;
598
+ /** The attempt's capture-phase timing (whole ms, ≥ 0); undefined when no mark landed. */
599
+ private captureTiming;
443
600
  private defaultKeyframe;
444
601
  /** Reused downscale canvas — falls back to the raw video where canvas 2D
445
602
  * is unavailable (jsdom) so tests and exotic hosts keep detecting. */
@@ -448,10 +605,12 @@ declare class CaptureSessionV3 {
448
605
  private defaultQuality;
449
606
  private centerSharpness;
450
607
  private teardownAttempt;
608
+ /** Emit the attempt's gate breakdown; a final report closes it (exactly once). */
609
+ private reportGate;
451
610
  private stopTracks;
452
611
  private fail;
453
612
  private setState;
454
613
  private now;
455
614
  }
456
615
 
457
- export { V3_GATE_DEFAULTS as A, VIDEO_BPS as B, type CameraErrorKind as C, DEFAULT_CLIP_MIME as D, type EscalationClipArtifact as E, FaceGateV3 as F, type GateChecks as G, buildLivenessV2FormData as H, cameraPreflight as I, classifyDevice as J, KEYFRAME_CANDIDATES as K, extForMime as L, MAX_CLIP_BYTES as M, isClipTooLarge as N, isMediaRecorderSupported as O, mapGetUserMediaError as P, pickMimeType as Q, probeDevice as R, STOP_GRACE_MS as S, TIMESLICE_MS as T, type V3ChecksPayload as V, CLIP_MS as a, type CaptureArtifacts as b, type CaptureErrorKind as c, type CaptureSessionEvents as d, CaptureSessionV3 as e, type CaptureSessionV3Events as f, type CaptureSessionV3Options as g, type CaptureState as h, ClipError as i, type ClipErrorKind as j, ClipRecorder as k, type ClipResult as l, DEVICE_PROFILES as m, type DeviceClass as n, type DeviceProbe as o, type DeviceProfile as p, DeviceProfiler as q, type EscalationHook as r, KEYFRAME_WINDOW_MS as s, MIME_CANDIDATES as t, type V3GateFactor as u, type V3GateQuality as v, type V3GateThresholds as w, type V3GateTick as x, type V3GateTickInput as y, type V3TelemetryEvent as z };
616
+ export { isClipTooLarge as $, MIME_CANDIDATES as A, type V3GateFactor as B, type CameraErrorKind as C, DEFAULT_CLIP_MIME as D, type EscalationClipArtifact as E, FaceGateV3 as F, GATE_SNAPSHOT_MS as G, HOLD_UPRIGHT_KEY as H, type V3GateQuality as I, type V3GateThresholds as J, KEYFRAME_CANDIDATES as K, type V3GateTick as L, MAX_CLIP_BYTES as M, type V3GateTickInput as N, type V3TelemetryEvent as O, PROVENANCE_WAIT_MS as P, V3_GATE_DEFAULTS as Q, VIDEO_BPS as R, STOP_GRACE_MS as S, TIMESLICE_MS as T, UPRIGHT_WATCH_MS as U, type V3ChecksPayload as V, blockReasonOf as W, buildLivenessV2FormData as X, cameraPreflight as Y, classifyDevice as Z, extForMime as _, CLIP_MS as a, isMediaRecorderSupported as a0, mapGetUserMediaError as a1, pickMimeType as a2, probeDevice as a3, type CaptureArtifacts as b, type CaptureErrorKind as c, type CaptureSessionEvents as d, CaptureSessionV3 as e, type CaptureSessionV3Events as f, type CaptureSessionV3Options as g, type CaptureSessionV3StartOptions as h, type CaptureState as i, type CaptureTiming as j, ClipError as k, type ClipErrorKind as l, ClipRecorder as m, type ClipResult as n, DEVICE_PROFILES as o, type DeviceClass as p, type DeviceProbe as q, type DeviceProfile as r, DeviceProfiler as s, type EscalationHook as t, type GateBlockEntry as u, type GateBlockReason as v, GateBlockStats as w, type GateBlockSummary as x, type GateChecks as y, KEYFRAME_WINDOW_MS as z };