@velion-la/onboarding-sdk-react-native 1.0.0-beta.10

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 (614) hide show
  1. package/CHANGELOG.md +66 -0
  2. package/LICENSE +12 -0
  3. package/README.md +888 -0
  4. package/app.plugin.js +101 -0
  5. package/lib/commonjs/camera/AddressSearchBar.js +304 -0
  6. package/lib/commonjs/camera/AddressSearchBar.js.map +1 -0
  7. package/lib/commonjs/camera/DocumentCapture.js +513 -0
  8. package/lib/commonjs/camera/DocumentCapture.js.map +1 -0
  9. package/lib/commonjs/camera/LivenessCamera.js +628 -0
  10. package/lib/commonjs/camera/LivenessCamera.js.map +1 -0
  11. package/lib/commonjs/camera/MapAddressPicker.js +331 -0
  12. package/lib/commonjs/camera/MapAddressPicker.js.map +1 -0
  13. package/lib/commonjs/core/VelionOnboarding.js +1113 -0
  14. package/lib/commonjs/core/VelionOnboarding.js.map +1 -0
  15. package/lib/commonjs/core/retryStepCopy.js +43 -0
  16. package/lib/commonjs/core/retryStepCopy.js.map +1 -0
  17. package/lib/commonjs/core/routingCommands.js +62 -0
  18. package/lib/commonjs/core/routingCommands.js.map +1 -0
  19. package/lib/commonjs/core/sessionDeclinedCopy.js +56 -0
  20. package/lib/commonjs/core/sessionDeclinedCopy.js.map +1 -0
  21. package/lib/commonjs/core/sessionStateMapper.js +200 -0
  22. package/lib/commonjs/core/sessionStateMapper.js.map +1 -0
  23. package/lib/commonjs/core/sseReasonMessages.js +450 -0
  24. package/lib/commonjs/core/sseReasonMessages.js.map +1 -0
  25. package/lib/commonjs/data/iso3166Alpha2Codes.json +1 -0
  26. package/lib/commonjs/data/iso3166CountryNames.json +251 -0
  27. package/lib/commonjs/i18n/index.js +30 -0
  28. package/lib/commonjs/i18n/index.js.map +1 -0
  29. package/lib/commonjs/i18n/strings/en.js +301 -0
  30. package/lib/commonjs/i18n/strings/en.js.map +1 -0
  31. package/lib/commonjs/i18n/strings/es.js +306 -0
  32. package/lib/commonjs/i18n/strings/es.js.map +1 -0
  33. package/lib/commonjs/index.js +225 -0
  34. package/lib/commonjs/index.js.map +1 -0
  35. package/lib/commonjs/package.json +1 -0
  36. package/lib/commonjs/steps/AddressInfoStep.js +662 -0
  37. package/lib/commonjs/steps/AddressInfoStep.js.map +1 -0
  38. package/lib/commonjs/steps/DocumentsOcrStep.js +405 -0
  39. package/lib/commonjs/steps/DocumentsOcrStep.js.map +1 -0
  40. package/lib/commonjs/steps/EconomicActivityStep.js +214 -0
  41. package/lib/commonjs/steps/EconomicActivityStep.js.map +1 -0
  42. package/lib/commonjs/steps/EmailContactStep.js +150 -0
  43. package/lib/commonjs/steps/EmailContactStep.js.map +1 -0
  44. package/lib/commonjs/steps/EmailOtpStep.js +225 -0
  45. package/lib/commonjs/steps/EmailOtpStep.js.map +1 -0
  46. package/lib/commonjs/steps/FaceMatchStep.js +169 -0
  47. package/lib/commonjs/steps/FaceMatchStep.js.map +1 -0
  48. package/lib/commonjs/steps/FingerprintStep.js +92 -0
  49. package/lib/commonjs/steps/FingerprintStep.js.map +1 -0
  50. package/lib/commonjs/steps/HumanBasicInfoStep.js +251 -0
  51. package/lib/commonjs/steps/HumanBasicInfoStep.js.map +1 -0
  52. package/lib/commonjs/steps/HumanExtendedInfoStep.js +275 -0
  53. package/lib/commonjs/steps/HumanExtendedInfoStep.js.map +1 -0
  54. package/lib/commonjs/steps/LegalBasicInfoStep.js +195 -0
  55. package/lib/commonjs/steps/LegalBasicInfoStep.js.map +1 -0
  56. package/lib/commonjs/steps/LegalExtendedInfoStep.js +173 -0
  57. package/lib/commonjs/steps/LegalExtendedInfoStep.js.map +1 -0
  58. package/lib/commonjs/steps/LivenessMatchStep.js +1184 -0
  59. package/lib/commonjs/steps/LivenessMatchStep.js.map +1 -0
  60. package/lib/commonjs/steps/PhoneContactStep.js +151 -0
  61. package/lib/commonjs/steps/PhoneContactStep.js.map +1 -0
  62. package/lib/commonjs/steps/PhoneOtpStep.js +224 -0
  63. package/lib/commonjs/steps/PhoneOtpStep.js.map +1 -0
  64. package/lib/commonjs/steps/SwornDeclarationStep.js +206 -0
  65. package/lib/commonjs/steps/SwornDeclarationStep.js.map +1 -0
  66. package/lib/commonjs/steps/TaxInfoStep.js +251 -0
  67. package/lib/commonjs/steps/TaxInfoStep.js.map +1 -0
  68. package/lib/commonjs/steps/TermsAndConditionsStep.js +245 -0
  69. package/lib/commonjs/steps/TermsAndConditionsStep.js.map +1 -0
  70. package/lib/commonjs/steps/_shared.js +61 -0
  71. package/lib/commonjs/steps/_shared.js.map +1 -0
  72. package/lib/commonjs/steps/types.js +6 -0
  73. package/lib/commonjs/steps/types.js.map +1 -0
  74. package/lib/commonjs/transport/api.js +176 -0
  75. package/lib/commonjs/transport/api.js.map +1 -0
  76. package/lib/commonjs/transport/irisWebSocket.js +121 -0
  77. package/lib/commonjs/transport/irisWebSocket.js.map +1 -0
  78. package/lib/commonjs/transport/secureUrl.js +50 -0
  79. package/lib/commonjs/transport/secureUrl.js.map +1 -0
  80. package/lib/commonjs/transport/sse.js +248 -0
  81. package/lib/commonjs/transport/sse.js.map +1 -0
  82. package/lib/commonjs/types/index.js +458 -0
  83. package/lib/commonjs/types/index.js.map +1 -0
  84. package/lib/commonjs/ui/MapFallbackBoundary.js +42 -0
  85. package/lib/commonjs/ui/MapFallbackBoundary.js.map +1 -0
  86. package/lib/commonjs/ui/StepShell.js +251 -0
  87. package/lib/commonjs/ui/StepShell.js.map +1 -0
  88. package/lib/commonjs/ui/VelionOnboardingScreen.js +276 -0
  89. package/lib/commonjs/ui/VelionOnboardingScreen.js.map +1 -0
  90. package/lib/commonjs/ui/forms/index.js +38 -0
  91. package/lib/commonjs/ui/forms/index.js.map +1 -0
  92. package/lib/commonjs/ui/forms/useInlineValidation.js +88 -0
  93. package/lib/commonjs/ui/forms/useInlineValidation.js.map +1 -0
  94. package/lib/commonjs/ui/forms/validators.js +34 -0
  95. package/lib/commonjs/ui/forms/validators.js.map +1 -0
  96. package/lib/commonjs/ui/icons/HomeHeartIcon.js +38 -0
  97. package/lib/commonjs/ui/icons/HomeHeartIcon.js.map +1 -0
  98. package/lib/commonjs/ui/icons/StepIcon.js +59 -0
  99. package/lib/commonjs/ui/icons/StepIcon.js.map +1 -0
  100. package/lib/commonjs/ui/overlays/AnalyzingOverlay.js +284 -0
  101. package/lib/commonjs/ui/overlays/AnalyzingOverlay.js.map +1 -0
  102. package/lib/commonjs/ui/overlays/LoadingOverlay.js +108 -0
  103. package/lib/commonjs/ui/overlays/LoadingOverlay.js.map +1 -0
  104. package/lib/commonjs/ui/overlays/ProgressBar.js +101 -0
  105. package/lib/commonjs/ui/overlays/ProgressBar.js.map +1 -0
  106. package/lib/commonjs/ui/overlays/RetryDialog.js +125 -0
  107. package/lib/commonjs/ui/overlays/RetryDialog.js.map +1 -0
  108. package/lib/commonjs/ui/overlays/index.js +33 -0
  109. package/lib/commonjs/ui/overlays/index.js.map +1 -0
  110. package/lib/commonjs/ui/primitives/BackButton.js +75 -0
  111. package/lib/commonjs/ui/primitives/BackButton.js.map +1 -0
  112. package/lib/commonjs/ui/primitives/Banner.js +81 -0
  113. package/lib/commonjs/ui/primitives/Banner.js.map +1 -0
  114. package/lib/commonjs/ui/primitives/Button.js +142 -0
  115. package/lib/commonjs/ui/primitives/Button.js.map +1 -0
  116. package/lib/commonjs/ui/primitives/Card.js +50 -0
  117. package/lib/commonjs/ui/primitives/Card.js.map +1 -0
  118. package/lib/commonjs/ui/primitives/Checkbox.js +139 -0
  119. package/lib/commonjs/ui/primitives/Checkbox.js.map +1 -0
  120. package/lib/commonjs/ui/primitives/CountrySelect.js +288 -0
  121. package/lib/commonjs/ui/primitives/CountrySelect.js.map +1 -0
  122. package/lib/commonjs/ui/primitives/DatePicker.js +245 -0
  123. package/lib/commonjs/ui/primitives/DatePicker.js.map +1 -0
  124. package/lib/commonjs/ui/primitives/Input.js +101 -0
  125. package/lib/commonjs/ui/primitives/Input.js.map +1 -0
  126. package/lib/commonjs/ui/primitives/SearchableSingleSelectList.js +162 -0
  127. package/lib/commonjs/ui/primitives/SearchableSingleSelectList.js.map +1 -0
  128. package/lib/commonjs/ui/primitives/Select.js +209 -0
  129. package/lib/commonjs/ui/primitives/Select.js.map +1 -0
  130. package/lib/commonjs/ui/primitives/Spinner.js +25 -0
  131. package/lib/commonjs/ui/primitives/Spinner.js.map +1 -0
  132. package/lib/commonjs/ui/primitives/index.js +89 -0
  133. package/lib/commonjs/ui/primitives/index.js.map +1 -0
  134. package/lib/commonjs/ui/primitives/searchableSingleSelectFilter.js +31 -0
  135. package/lib/commonjs/ui/primitives/searchableSingleSelectFilter.js.map +1 -0
  136. package/lib/commonjs/ui/theme/ThemeProvider.js +74 -0
  137. package/lib/commonjs/ui/theme/ThemeProvider.js.map +1 -0
  138. package/lib/commonjs/ui/theme/index.js +68 -0
  139. package/lib/commonjs/ui/theme/index.js.map +1 -0
  140. package/lib/commonjs/ui/theme/tokens.js +154 -0
  141. package/lib/commonjs/ui/theme/tokens.js.map +1 -0
  142. package/lib/commonjs/utils/EventEmitter.js +144 -0
  143. package/lib/commonjs/utils/EventEmitter.js.map +1 -0
  144. package/lib/commonjs/utils/base64.js +53 -0
  145. package/lib/commonjs/utils/base64.js.map +1 -0
  146. package/lib/commonjs/utils/deviceFingerprint.js +132 -0
  147. package/lib/commonjs/utils/deviceFingerprint.js.map +1 -0
  148. package/lib/commonjs/utils/documentTypeOptions.js +35 -0
  149. package/lib/commonjs/utils/documentTypeOptions.js.map +1 -0
  150. package/lib/commonjs/utils/googleMapsPreflight.js +88 -0
  151. package/lib/commonjs/utils/googleMapsPreflight.js.map +1 -0
  152. package/lib/commonjs/utils/hmac.js +58 -0
  153. package/lib/commonjs/utils/hmac.js.map +1 -0
  154. package/lib/commonjs/utils/iso3166Countries.js +98 -0
  155. package/lib/commonjs/utils/iso3166Countries.js.map +1 -0
  156. package/lib/commonjs/utils/jpegFromUri.js +44 -0
  157. package/lib/commonjs/utils/jpegFromUri.js.map +1 -0
  158. package/lib/commonjs/utils/keepAwake.js +58 -0
  159. package/lib/commonjs/utils/keepAwake.js.map +1 -0
  160. package/lib/commonjs/utils/log.js +42 -0
  161. package/lib/commonjs/utils/log.js.map +1 -0
  162. package/lib/commonjs/utils/osGeocoder.js +70 -0
  163. package/lib/commonjs/utils/osGeocoder.js.map +1 -0
  164. package/lib/commonjs/utils/parseGoogleAddressComponents.js +74 -0
  165. package/lib/commonjs/utils/parseGoogleAddressComponents.js.map +1 -0
  166. package/lib/commonjs/utils/personNameNormalize.js +24 -0
  167. package/lib/commonjs/utils/personNameNormalize.js.map +1 -0
  168. package/lib/commonjs/utils/sdkError.js +34 -0
  169. package/lib/commonjs/utils/sdkError.js.map +1 -0
  170. package/lib/commonjs/utils/sdkVersion.js +13 -0
  171. package/lib/commonjs/utils/sdkVersion.js.map +1 -0
  172. package/lib/commonjs/utils/stepConfig.js +65 -0
  173. package/lib/commonjs/utils/stepConfig.js.map +1 -0
  174. package/lib/commonjs/utils/taxInfoConfig.js +19 -0
  175. package/lib/commonjs/utils/taxInfoConfig.js.map +1 -0
  176. package/lib/commonjs/utils/useSafeAreaInsets.js +41 -0
  177. package/lib/commonjs/utils/useSafeAreaInsets.js.map +1 -0
  178. package/lib/commonjs/utils/velionExtra.js +48 -0
  179. package/lib/commonjs/utils/velionExtra.js.map +1 -0
  180. package/lib/module/camera/AddressSearchBar.js +299 -0
  181. package/lib/module/camera/AddressSearchBar.js.map +1 -0
  182. package/lib/module/camera/DocumentCapture.js +508 -0
  183. package/lib/module/camera/DocumentCapture.js.map +1 -0
  184. package/lib/module/camera/LivenessCamera.js +623 -0
  185. package/lib/module/camera/LivenessCamera.js.map +1 -0
  186. package/lib/module/camera/MapAddressPicker.js +326 -0
  187. package/lib/module/camera/MapAddressPicker.js.map +1 -0
  188. package/lib/module/core/VelionOnboarding.js +1109 -0
  189. package/lib/module/core/VelionOnboarding.js.map +1 -0
  190. package/lib/module/core/retryStepCopy.js +39 -0
  191. package/lib/module/core/retryStepCopy.js.map +1 -0
  192. package/lib/module/core/routingCommands.js +57 -0
  193. package/lib/module/core/routingCommands.js.map +1 -0
  194. package/lib/module/core/sessionDeclinedCopy.js +52 -0
  195. package/lib/module/core/sessionDeclinedCopy.js.map +1 -0
  196. package/lib/module/core/sessionStateMapper.js +189 -0
  197. package/lib/module/core/sessionStateMapper.js.map +1 -0
  198. package/lib/module/core/sseReasonMessages.js +446 -0
  199. package/lib/module/core/sseReasonMessages.js.map +1 -0
  200. package/lib/module/data/iso3166Alpha2Codes.json +1 -0
  201. package/lib/module/data/iso3166CountryNames.json +251 -0
  202. package/lib/module/i18n/index.js +25 -0
  203. package/lib/module/i18n/index.js.map +1 -0
  204. package/lib/module/i18n/strings/en.js +297 -0
  205. package/lib/module/i18n/strings/en.js.map +1 -0
  206. package/lib/module/i18n/strings/es.js +302 -0
  207. package/lib/module/i18n/strings/es.js.map +1 -0
  208. package/lib/module/index.js +36 -0
  209. package/lib/module/index.js.map +1 -0
  210. package/lib/module/steps/AddressInfoStep.js +658 -0
  211. package/lib/module/steps/AddressInfoStep.js.map +1 -0
  212. package/lib/module/steps/DocumentsOcrStep.js +399 -0
  213. package/lib/module/steps/DocumentsOcrStep.js.map +1 -0
  214. package/lib/module/steps/EconomicActivityStep.js +209 -0
  215. package/lib/module/steps/EconomicActivityStep.js.map +1 -0
  216. package/lib/module/steps/EmailContactStep.js +145 -0
  217. package/lib/module/steps/EmailContactStep.js.map +1 -0
  218. package/lib/module/steps/EmailOtpStep.js +220 -0
  219. package/lib/module/steps/EmailOtpStep.js.map +1 -0
  220. package/lib/module/steps/FaceMatchStep.js +164 -0
  221. package/lib/module/steps/FaceMatchStep.js.map +1 -0
  222. package/lib/module/steps/FingerprintStep.js +87 -0
  223. package/lib/module/steps/FingerprintStep.js.map +1 -0
  224. package/lib/module/steps/HumanBasicInfoStep.js +246 -0
  225. package/lib/module/steps/HumanBasicInfoStep.js.map +1 -0
  226. package/lib/module/steps/HumanExtendedInfoStep.js +270 -0
  227. package/lib/module/steps/HumanExtendedInfoStep.js.map +1 -0
  228. package/lib/module/steps/LegalBasicInfoStep.js +190 -0
  229. package/lib/module/steps/LegalBasicInfoStep.js.map +1 -0
  230. package/lib/module/steps/LegalExtendedInfoStep.js +168 -0
  231. package/lib/module/steps/LegalExtendedInfoStep.js.map +1 -0
  232. package/lib/module/steps/LivenessMatchStep.js +1177 -0
  233. package/lib/module/steps/LivenessMatchStep.js.map +1 -0
  234. package/lib/module/steps/PhoneContactStep.js +146 -0
  235. package/lib/module/steps/PhoneContactStep.js.map +1 -0
  236. package/lib/module/steps/PhoneOtpStep.js +219 -0
  237. package/lib/module/steps/PhoneOtpStep.js.map +1 -0
  238. package/lib/module/steps/SwornDeclarationStep.js +203 -0
  239. package/lib/module/steps/SwornDeclarationStep.js.map +1 -0
  240. package/lib/module/steps/TaxInfoStep.js +246 -0
  241. package/lib/module/steps/TaxInfoStep.js.map +1 -0
  242. package/lib/module/steps/TermsAndConditionsStep.js +240 -0
  243. package/lib/module/steps/TermsAndConditionsStep.js.map +1 -0
  244. package/lib/module/steps/_shared.js +52 -0
  245. package/lib/module/steps/_shared.js.map +1 -0
  246. package/lib/module/steps/types.js +4 -0
  247. package/lib/module/steps/types.js.map +1 -0
  248. package/lib/module/transport/api.js +173 -0
  249. package/lib/module/transport/api.js.map +1 -0
  250. package/lib/module/transport/irisWebSocket.js +115 -0
  251. package/lib/module/transport/irisWebSocket.js.map +1 -0
  252. package/lib/module/transport/secureUrl.js +45 -0
  253. package/lib/module/transport/secureUrl.js.map +1 -0
  254. package/lib/module/transport/sse.js +242 -0
  255. package/lib/module/transport/sse.js.map +1 -0
  256. package/lib/module/types/index.js +532 -0
  257. package/lib/module/types/index.js.map +1 -0
  258. package/lib/module/ui/MapFallbackBoundary.js +37 -0
  259. package/lib/module/ui/MapFallbackBoundary.js.map +1 -0
  260. package/lib/module/ui/StepShell.js +246 -0
  261. package/lib/module/ui/StepShell.js.map +1 -0
  262. package/lib/module/ui/VelionOnboardingScreen.js +273 -0
  263. package/lib/module/ui/VelionOnboardingScreen.js.map +1 -0
  264. package/lib/module/ui/forms/index.js +5 -0
  265. package/lib/module/ui/forms/index.js.map +1 -0
  266. package/lib/module/ui/forms/useInlineValidation.js +84 -0
  267. package/lib/module/ui/forms/useInlineValidation.js.map +1 -0
  268. package/lib/module/ui/forms/validators.js +27 -0
  269. package/lib/module/ui/forms/validators.js.map +1 -0
  270. package/lib/module/ui/icons/HomeHeartIcon.js +33 -0
  271. package/lib/module/ui/icons/HomeHeartIcon.js.map +1 -0
  272. package/lib/module/ui/icons/StepIcon.js +55 -0
  273. package/lib/module/ui/icons/StepIcon.js.map +1 -0
  274. package/lib/module/ui/overlays/AnalyzingOverlay.js +279 -0
  275. package/lib/module/ui/overlays/AnalyzingOverlay.js.map +1 -0
  276. package/lib/module/ui/overlays/LoadingOverlay.js +104 -0
  277. package/lib/module/ui/overlays/LoadingOverlay.js.map +1 -0
  278. package/lib/module/ui/overlays/ProgressBar.js +97 -0
  279. package/lib/module/ui/overlays/ProgressBar.js.map +1 -0
  280. package/lib/module/ui/overlays/RetryDialog.js +121 -0
  281. package/lib/module/ui/overlays/RetryDialog.js.map +1 -0
  282. package/lib/module/ui/overlays/index.js +6 -0
  283. package/lib/module/ui/overlays/index.js.map +1 -0
  284. package/lib/module/ui/primitives/BackButton.js +71 -0
  285. package/lib/module/ui/primitives/BackButton.js.map +1 -0
  286. package/lib/module/ui/primitives/Banner.js +77 -0
  287. package/lib/module/ui/primitives/Banner.js.map +1 -0
  288. package/lib/module/ui/primitives/Button.js +138 -0
  289. package/lib/module/ui/primitives/Button.js.map +1 -0
  290. package/lib/module/ui/primitives/Card.js +46 -0
  291. package/lib/module/ui/primitives/Card.js.map +1 -0
  292. package/lib/module/ui/primitives/Checkbox.js +136 -0
  293. package/lib/module/ui/primitives/Checkbox.js.map +1 -0
  294. package/lib/module/ui/primitives/CountrySelect.js +284 -0
  295. package/lib/module/ui/primitives/CountrySelect.js.map +1 -0
  296. package/lib/module/ui/primitives/DatePicker.js +241 -0
  297. package/lib/module/ui/primitives/DatePicker.js.map +1 -0
  298. package/lib/module/ui/primitives/Input.js +97 -0
  299. package/lib/module/ui/primitives/Input.js.map +1 -0
  300. package/lib/module/ui/primitives/SearchableSingleSelectList.js +153 -0
  301. package/lib/module/ui/primitives/SearchableSingleSelectList.js.map +1 -0
  302. package/lib/module/ui/primitives/Select.js +205 -0
  303. package/lib/module/ui/primitives/Select.js.map +1 -0
  304. package/lib/module/ui/primitives/Spinner.js +21 -0
  305. package/lib/module/ui/primitives/Spinner.js.map +1 -0
  306. package/lib/module/ui/primitives/index.js +14 -0
  307. package/lib/module/ui/primitives/index.js.map +1 -0
  308. package/lib/module/ui/primitives/searchableSingleSelectFilter.js +27 -0
  309. package/lib/module/ui/primitives/searchableSingleSelectFilter.js.map +1 -0
  310. package/lib/module/ui/theme/ThemeProvider.js +67 -0
  311. package/lib/module/ui/theme/ThemeProvider.js.map +1 -0
  312. package/lib/module/ui/theme/index.js +5 -0
  313. package/lib/module/ui/theme/index.js.map +1 -0
  314. package/lib/module/ui/theme/tokens.js +145 -0
  315. package/lib/module/ui/theme/tokens.js.map +1 -0
  316. package/lib/module/utils/EventEmitter.js +139 -0
  317. package/lib/module/utils/EventEmitter.js.map +1 -0
  318. package/lib/module/utils/base64.js +47 -0
  319. package/lib/module/utils/base64.js.map +1 -0
  320. package/lib/module/utils/deviceFingerprint.js +129 -0
  321. package/lib/module/utils/deviceFingerprint.js.map +1 -0
  322. package/lib/module/utils/documentTypeOptions.js +31 -0
  323. package/lib/module/utils/documentTypeOptions.js.map +1 -0
  324. package/lib/module/utils/googleMapsPreflight.js +84 -0
  325. package/lib/module/utils/googleMapsPreflight.js.map +1 -0
  326. package/lib/module/utils/hmac.js +53 -0
  327. package/lib/module/utils/hmac.js.map +1 -0
  328. package/lib/module/utils/iso3166Countries.js +92 -0
  329. package/lib/module/utils/iso3166Countries.js.map +1 -0
  330. package/lib/module/utils/jpegFromUri.js +40 -0
  331. package/lib/module/utils/jpegFromUri.js.map +1 -0
  332. package/lib/module/utils/keepAwake.js +53 -0
  333. package/lib/module/utils/keepAwake.js.map +1 -0
  334. package/lib/module/utils/log.js +37 -0
  335. package/lib/module/utils/log.js.map +1 -0
  336. package/lib/module/utils/osGeocoder.js +65 -0
  337. package/lib/module/utils/osGeocoder.js.map +1 -0
  338. package/lib/module/utils/parseGoogleAddressComponents.js +69 -0
  339. package/lib/module/utils/parseGoogleAddressComponents.js.map +1 -0
  340. package/lib/module/utils/personNameNormalize.js +20 -0
  341. package/lib/module/utils/personNameNormalize.js.map +1 -0
  342. package/lib/module/utils/sdkError.js +29 -0
  343. package/lib/module/utils/sdkError.js.map +1 -0
  344. package/lib/module/utils/sdkVersion.js +9 -0
  345. package/lib/module/utils/sdkVersion.js.map +1 -0
  346. package/lib/module/utils/stepConfig.js +59 -0
  347. package/lib/module/utils/stepConfig.js.map +1 -0
  348. package/lib/module/utils/taxInfoConfig.js +15 -0
  349. package/lib/module/utils/taxInfoConfig.js.map +1 -0
  350. package/lib/module/utils/useSafeAreaInsets.js +37 -0
  351. package/lib/module/utils/useSafeAreaInsets.js.map +1 -0
  352. package/lib/module/utils/velionExtra.js +44 -0
  353. package/lib/module/utils/velionExtra.js.map +1 -0
  354. package/lib/typescript/camera/AddressSearchBar.d.ts +37 -0
  355. package/lib/typescript/camera/AddressSearchBar.d.ts.map +1 -0
  356. package/lib/typescript/camera/DocumentCapture.d.ts +34 -0
  357. package/lib/typescript/camera/DocumentCapture.d.ts.map +1 -0
  358. package/lib/typescript/camera/LivenessCamera.d.ts +67 -0
  359. package/lib/typescript/camera/LivenessCamera.d.ts.map +1 -0
  360. package/lib/typescript/camera/MapAddressPicker.d.ts +57 -0
  361. package/lib/typescript/camera/MapAddressPicker.d.ts.map +1 -0
  362. package/lib/typescript/core/VelionOnboarding.d.ts +169 -0
  363. package/lib/typescript/core/VelionOnboarding.d.ts.map +1 -0
  364. package/lib/typescript/core/retryStepCopy.d.ts +27 -0
  365. package/lib/typescript/core/retryStepCopy.d.ts.map +1 -0
  366. package/lib/typescript/core/routingCommands.d.ts +39 -0
  367. package/lib/typescript/core/routingCommands.d.ts.map +1 -0
  368. package/lib/typescript/core/sessionDeclinedCopy.d.ts +16 -0
  369. package/lib/typescript/core/sessionDeclinedCopy.d.ts.map +1 -0
  370. package/lib/typescript/core/sessionStateMapper.d.ts +52 -0
  371. package/lib/typescript/core/sessionStateMapper.d.ts.map +1 -0
  372. package/lib/typescript/core/sseReasonMessages.d.ts +20 -0
  373. package/lib/typescript/core/sseReasonMessages.d.ts.map +1 -0
  374. package/lib/typescript/i18n/index.d.ts +13 -0
  375. package/lib/typescript/i18n/index.d.ts.map +1 -0
  376. package/lib/typescript/i18n/strings/en.d.ts +3 -0
  377. package/lib/typescript/i18n/strings/en.d.ts.map +1 -0
  378. package/lib/typescript/i18n/strings/es.d.ts +297 -0
  379. package/lib/typescript/i18n/strings/es.d.ts.map +1 -0
  380. package/lib/typescript/index.d.ts +26 -0
  381. package/lib/typescript/index.d.ts.map +1 -0
  382. package/lib/typescript/steps/AddressInfoStep.d.ts +26 -0
  383. package/lib/typescript/steps/AddressInfoStep.d.ts.map +1 -0
  384. package/lib/typescript/steps/DocumentsOcrStep.d.ts +26 -0
  385. package/lib/typescript/steps/DocumentsOcrStep.d.ts.map +1 -0
  386. package/lib/typescript/steps/EconomicActivityStep.d.ts +29 -0
  387. package/lib/typescript/steps/EconomicActivityStep.d.ts.map +1 -0
  388. package/lib/typescript/steps/EmailContactStep.d.ts +15 -0
  389. package/lib/typescript/steps/EmailContactStep.d.ts.map +1 -0
  390. package/lib/typescript/steps/EmailOtpStep.d.ts +21 -0
  391. package/lib/typescript/steps/EmailOtpStep.d.ts.map +1 -0
  392. package/lib/typescript/steps/FaceMatchStep.d.ts +27 -0
  393. package/lib/typescript/steps/FaceMatchStep.d.ts.map +1 -0
  394. package/lib/typescript/steps/FingerprintStep.d.ts +25 -0
  395. package/lib/typescript/steps/FingerprintStep.d.ts.map +1 -0
  396. package/lib/typescript/steps/HumanBasicInfoStep.d.ts +25 -0
  397. package/lib/typescript/steps/HumanBasicInfoStep.d.ts.map +1 -0
  398. package/lib/typescript/steps/HumanExtendedInfoStep.d.ts +23 -0
  399. package/lib/typescript/steps/HumanExtendedInfoStep.d.ts.map +1 -0
  400. package/lib/typescript/steps/LegalBasicInfoStep.d.ts +17 -0
  401. package/lib/typescript/steps/LegalBasicInfoStep.d.ts.map +1 -0
  402. package/lib/typescript/steps/LegalExtendedInfoStep.d.ts +17 -0
  403. package/lib/typescript/steps/LegalExtendedInfoStep.d.ts.map +1 -0
  404. package/lib/typescript/steps/LivenessMatchStep.d.ts +26 -0
  405. package/lib/typescript/steps/LivenessMatchStep.d.ts.map +1 -0
  406. package/lib/typescript/steps/PhoneContactStep.d.ts +15 -0
  407. package/lib/typescript/steps/PhoneContactStep.d.ts.map +1 -0
  408. package/lib/typescript/steps/PhoneOtpStep.d.ts +19 -0
  409. package/lib/typescript/steps/PhoneOtpStep.d.ts.map +1 -0
  410. package/lib/typescript/steps/SwornDeclarationStep.d.ts +20 -0
  411. package/lib/typescript/steps/SwornDeclarationStep.d.ts.map +1 -0
  412. package/lib/typescript/steps/TaxInfoStep.d.ts +19 -0
  413. package/lib/typescript/steps/TaxInfoStep.d.ts.map +1 -0
  414. package/lib/typescript/steps/TermsAndConditionsStep.d.ts +21 -0
  415. package/lib/typescript/steps/TermsAndConditionsStep.d.ts.map +1 -0
  416. package/lib/typescript/steps/_shared.d.ts +22 -0
  417. package/lib/typescript/steps/_shared.d.ts.map +1 -0
  418. package/lib/typescript/steps/types.d.ts +89 -0
  419. package/lib/typescript/steps/types.d.ts.map +1 -0
  420. package/lib/typescript/transport/api.d.ts +35 -0
  421. package/lib/typescript/transport/api.d.ts.map +1 -0
  422. package/lib/typescript/transport/irisWebSocket.d.ts +72 -0
  423. package/lib/typescript/transport/irisWebSocket.d.ts.map +1 -0
  424. package/lib/typescript/transport/secureUrl.d.ts +14 -0
  425. package/lib/typescript/transport/secureUrl.d.ts.map +1 -0
  426. package/lib/typescript/transport/sse.d.ts +54 -0
  427. package/lib/typescript/transport/sse.d.ts.map +1 -0
  428. package/lib/typescript/types/index.d.ts +1219 -0
  429. package/lib/typescript/types/index.d.ts.map +1 -0
  430. package/lib/typescript/ui/MapFallbackBoundary.d.ts +28 -0
  431. package/lib/typescript/ui/MapFallbackBoundary.d.ts.map +1 -0
  432. package/lib/typescript/ui/StepShell.d.ts +29 -0
  433. package/lib/typescript/ui/StepShell.d.ts.map +1 -0
  434. package/lib/typescript/ui/VelionOnboardingScreen.d.ts +26 -0
  435. package/lib/typescript/ui/VelionOnboardingScreen.d.ts.map +1 -0
  436. package/lib/typescript/ui/forms/index.d.ts +3 -0
  437. package/lib/typescript/ui/forms/index.d.ts.map +1 -0
  438. package/lib/typescript/ui/forms/useInlineValidation.d.ts +30 -0
  439. package/lib/typescript/ui/forms/useInlineValidation.d.ts.map +1 -0
  440. package/lib/typescript/ui/forms/validators.d.ts +11 -0
  441. package/lib/typescript/ui/forms/validators.d.ts.map +1 -0
  442. package/lib/typescript/ui/icons/HomeHeartIcon.d.ts +14 -0
  443. package/lib/typescript/ui/icons/HomeHeartIcon.d.ts.map +1 -0
  444. package/lib/typescript/ui/icons/StepIcon.d.ts +26 -0
  445. package/lib/typescript/ui/icons/StepIcon.d.ts.map +1 -0
  446. package/lib/typescript/ui/overlays/AnalyzingOverlay.d.ts +24 -0
  447. package/lib/typescript/ui/overlays/AnalyzingOverlay.d.ts.map +1 -0
  448. package/lib/typescript/ui/overlays/LoadingOverlay.d.ts +19 -0
  449. package/lib/typescript/ui/overlays/LoadingOverlay.d.ts.map +1 -0
  450. package/lib/typescript/ui/overlays/ProgressBar.d.ts +32 -0
  451. package/lib/typescript/ui/overlays/ProgressBar.d.ts.map +1 -0
  452. package/lib/typescript/ui/overlays/RetryDialog.d.ts +17 -0
  453. package/lib/typescript/ui/overlays/RetryDialog.d.ts.map +1 -0
  454. package/lib/typescript/ui/overlays/index.d.ts +4 -0
  455. package/lib/typescript/ui/overlays/index.d.ts.map +1 -0
  456. package/lib/typescript/ui/primitives/BackButton.d.ts +20 -0
  457. package/lib/typescript/ui/primitives/BackButton.d.ts.map +1 -0
  458. package/lib/typescript/ui/primitives/Banner.d.ts +11 -0
  459. package/lib/typescript/ui/primitives/Banner.d.ts.map +1 -0
  460. package/lib/typescript/ui/primitives/Button.d.ts +27 -0
  461. package/lib/typescript/ui/primitives/Button.d.ts.map +1 -0
  462. package/lib/typescript/ui/primitives/Card.d.ts +10 -0
  463. package/lib/typescript/ui/primitives/Card.d.ts.map +1 -0
  464. package/lib/typescript/ui/primitives/Checkbox.d.ts +25 -0
  465. package/lib/typescript/ui/primitives/Checkbox.d.ts.map +1 -0
  466. package/lib/typescript/ui/primitives/CountrySelect.d.ts +31 -0
  467. package/lib/typescript/ui/primitives/CountrySelect.d.ts.map +1 -0
  468. package/lib/typescript/ui/primitives/DatePicker.d.ts +42 -0
  469. package/lib/typescript/ui/primitives/DatePicker.d.ts.map +1 -0
  470. package/lib/typescript/ui/primitives/Input.d.ts +17 -0
  471. package/lib/typescript/ui/primitives/Input.d.ts.map +1 -0
  472. package/lib/typescript/ui/primitives/SearchableSingleSelectList.d.ts +33 -0
  473. package/lib/typescript/ui/primitives/SearchableSingleSelectList.d.ts.map +1 -0
  474. package/lib/typescript/ui/primitives/Select.d.ts +26 -0
  475. package/lib/typescript/ui/primitives/Select.d.ts.map +1 -0
  476. package/lib/typescript/ui/primitives/Spinner.d.ts +10 -0
  477. package/lib/typescript/ui/primitives/Spinner.d.ts.map +1 -0
  478. package/lib/typescript/ui/primitives/index.d.ts +12 -0
  479. package/lib/typescript/ui/primitives/index.d.ts.map +1 -0
  480. package/lib/typescript/ui/primitives/searchableSingleSelectFilter.d.ts +25 -0
  481. package/lib/typescript/ui/primitives/searchableSingleSelectFilter.d.ts.map +1 -0
  482. package/lib/typescript/ui/theme/ThemeProvider.d.ts +23 -0
  483. package/lib/typescript/ui/theme/ThemeProvider.d.ts.map +1 -0
  484. package/lib/typescript/ui/theme/index.d.ts +3 -0
  485. package/lib/typescript/ui/theme/index.d.ts.map +1 -0
  486. package/lib/typescript/ui/theme/tokens.d.ts +42 -0
  487. package/lib/typescript/ui/theme/tokens.d.ts.map +1 -0
  488. package/lib/typescript/utils/EventEmitter.d.ts +98 -0
  489. package/lib/typescript/utils/EventEmitter.d.ts.map +1 -0
  490. package/lib/typescript/utils/base64.d.ts +19 -0
  491. package/lib/typescript/utils/base64.d.ts.map +1 -0
  492. package/lib/typescript/utils/deviceFingerprint.d.ts +42 -0
  493. package/lib/typescript/utils/deviceFingerprint.d.ts.map +1 -0
  494. package/lib/typescript/utils/documentTypeOptions.d.ts +13 -0
  495. package/lib/typescript/utils/documentTypeOptions.d.ts.map +1 -0
  496. package/lib/typescript/utils/googleMapsPreflight.d.ts +52 -0
  497. package/lib/typescript/utils/googleMapsPreflight.d.ts.map +1 -0
  498. package/lib/typescript/utils/hmac.d.ts +39 -0
  499. package/lib/typescript/utils/hmac.d.ts.map +1 -0
  500. package/lib/typescript/utils/iso3166Countries.d.ts +27 -0
  501. package/lib/typescript/utils/iso3166Countries.d.ts.map +1 -0
  502. package/lib/typescript/utils/jpegFromUri.d.ts +29 -0
  503. package/lib/typescript/utils/jpegFromUri.d.ts.map +1 -0
  504. package/lib/typescript/utils/keepAwake.d.ts +16 -0
  505. package/lib/typescript/utils/keepAwake.d.ts.map +1 -0
  506. package/lib/typescript/utils/log.d.ts +18 -0
  507. package/lib/typescript/utils/log.d.ts.map +1 -0
  508. package/lib/typescript/utils/osGeocoder.d.ts +38 -0
  509. package/lib/typescript/utils/osGeocoder.d.ts.map +1 -0
  510. package/lib/typescript/utils/parseGoogleAddressComponents.d.ts +43 -0
  511. package/lib/typescript/utils/parseGoogleAddressComponents.d.ts.map +1 -0
  512. package/lib/typescript/utils/personNameNormalize.d.ts +10 -0
  513. package/lib/typescript/utils/personNameNormalize.d.ts.map +1 -0
  514. package/lib/typescript/utils/sdkError.d.ts +14 -0
  515. package/lib/typescript/utils/sdkError.d.ts.map +1 -0
  516. package/lib/typescript/utils/sdkVersion.d.ts +7 -0
  517. package/lib/typescript/utils/sdkVersion.d.ts.map +1 -0
  518. package/lib/typescript/utils/stepConfig.d.ts +8 -0
  519. package/lib/typescript/utils/stepConfig.d.ts.map +1 -0
  520. package/lib/typescript/utils/taxInfoConfig.d.ts +7 -0
  521. package/lib/typescript/utils/taxInfoConfig.d.ts.map +1 -0
  522. package/lib/typescript/utils/useSafeAreaInsets.d.ts +26 -0
  523. package/lib/typescript/utils/useSafeAreaInsets.d.ts.map +1 -0
  524. package/lib/typescript/utils/velionExtra.d.ts +24 -0
  525. package/lib/typescript/utils/velionExtra.d.ts.map +1 -0
  526. package/package.json +107 -0
  527. package/src/camera/AddressSearchBar.tsx +363 -0
  528. package/src/camera/DocumentCapture.tsx +514 -0
  529. package/src/camera/LivenessCamera.tsx +706 -0
  530. package/src/camera/MapAddressPicker.tsx +391 -0
  531. package/src/core/VelionOnboarding.ts +1291 -0
  532. package/src/core/retryStepCopy.ts +54 -0
  533. package/src/core/routingCommands.ts +63 -0
  534. package/src/core/sessionDeclinedCopy.ts +76 -0
  535. package/src/core/sessionStateMapper.ts +232 -0
  536. package/src/core/sseReasonMessages.ts +531 -0
  537. package/src/data/iso3166Alpha2Codes.json +1 -0
  538. package/src/data/iso3166CountryNames.json +251 -0
  539. package/src/i18n/index.ts +26 -0
  540. package/src/i18n/strings/en.ts +335 -0
  541. package/src/i18n/strings/es.ts +337 -0
  542. package/src/index.ts +146 -0
  543. package/src/steps/AddressInfoStep.tsx +744 -0
  544. package/src/steps/DocumentsOcrStep.tsx +481 -0
  545. package/src/steps/EconomicActivityStep.tsx +230 -0
  546. package/src/steps/EmailContactStep.tsx +165 -0
  547. package/src/steps/EmailOtpStep.tsx +256 -0
  548. package/src/steps/FaceMatchStep.tsx +176 -0
  549. package/src/steps/FingerprintStep.tsx +99 -0
  550. package/src/steps/HumanBasicInfoStep.tsx +286 -0
  551. package/src/steps/HumanExtendedInfoStep.tsx +362 -0
  552. package/src/steps/LegalBasicInfoStep.tsx +214 -0
  553. package/src/steps/LegalExtendedInfoStep.tsx +184 -0
  554. package/src/steps/LivenessMatchStep.tsx +1351 -0
  555. package/src/steps/PhoneContactStep.tsx +166 -0
  556. package/src/steps/PhoneOtpStep.tsx +255 -0
  557. package/src/steps/SwornDeclarationStep.tsx +237 -0
  558. package/src/steps/TaxInfoStep.tsx +288 -0
  559. package/src/steps/TermsAndConditionsStep.tsx +269 -0
  560. package/src/steps/_shared.ts +69 -0
  561. package/src/steps/types.ts +93 -0
  562. package/src/transport/api.ts +257 -0
  563. package/src/transport/irisWebSocket.ts +186 -0
  564. package/src/transport/secureUrl.ts +47 -0
  565. package/src/transport/sse.ts +310 -0
  566. package/src/types/index.ts +1421 -0
  567. package/src/ui/MapFallbackBoundary.tsx +46 -0
  568. package/src/ui/StepShell.tsx +273 -0
  569. package/src/ui/VelionOnboardingScreen.tsx +297 -0
  570. package/src/ui/forms/index.ts +12 -0
  571. package/src/ui/forms/useInlineValidation.ts +115 -0
  572. package/src/ui/forms/validators.ts +29 -0
  573. package/src/ui/icons/HomeHeartIcon.tsx +34 -0
  574. package/src/ui/icons/StepIcon.tsx +78 -0
  575. package/src/ui/overlays/AnalyzingOverlay.tsx +323 -0
  576. package/src/ui/overlays/LoadingOverlay.tsx +115 -0
  577. package/src/ui/overlays/ProgressBar.tsx +106 -0
  578. package/src/ui/overlays/RetryDialog.tsx +128 -0
  579. package/src/ui/overlays/index.ts +3 -0
  580. package/src/ui/primitives/BackButton.tsx +65 -0
  581. package/src/ui/primitives/Banner.tsx +81 -0
  582. package/src/ui/primitives/Button.tsx +164 -0
  583. package/src/ui/primitives/Card.tsx +55 -0
  584. package/src/ui/primitives/Checkbox.tsx +153 -0
  585. package/src/ui/primitives/CountrySelect.tsx +356 -0
  586. package/src/ui/primitives/DatePicker.tsx +266 -0
  587. package/src/ui/primitives/Input.tsx +110 -0
  588. package/src/ui/primitives/SearchableSingleSelectList.tsx +195 -0
  589. package/src/ui/primitives/Select.tsx +259 -0
  590. package/src/ui/primitives/Spinner.tsx +17 -0
  591. package/src/ui/primitives/index.ts +16 -0
  592. package/src/ui/primitives/searchableSingleSelectFilter.ts +38 -0
  593. package/src/ui/theme/ThemeProvider.tsx +102 -0
  594. package/src/ui/theme/index.ts +17 -0
  595. package/src/ui/theme/tokens.ts +159 -0
  596. package/src/utils/EventEmitter.ts +155 -0
  597. package/src/utils/base64.ts +44 -0
  598. package/src/utils/deviceFingerprint.ts +184 -0
  599. package/src/utils/documentTypeOptions.ts +31 -0
  600. package/src/utils/googleMapsPreflight.ts +89 -0
  601. package/src/utils/hmac.ts +61 -0
  602. package/src/utils/iso3166Countries.ts +111 -0
  603. package/src/utils/jpegFromUri.ts +42 -0
  604. package/src/utils/keepAwake.ts +62 -0
  605. package/src/utils/log.ts +37 -0
  606. package/src/utils/osGeocoder.ts +75 -0
  607. package/src/utils/parseGoogleAddressComponents.ts +123 -0
  608. package/src/utils/personNameNormalize.ts +17 -0
  609. package/src/utils/sdkError.ts +40 -0
  610. package/src/utils/sdkVersion.ts +6 -0
  611. package/src/utils/stepConfig.ts +75 -0
  612. package/src/utils/taxInfoConfig.ts +14 -0
  613. package/src/utils/useSafeAreaInsets.ts +37 -0
  614. package/src/utils/velionExtra.ts +46 -0
@@ -0,0 +1,514 @@
1
+ /**
2
+ * @fileoverview Full-screen document camera with an ID-1 frame guide.
3
+ *
4
+ * Uses `react-native-vision-camera` v4 in `photo` mode. Tapping the shutter
5
+ * triggers `takePhoto()` with `qualityPrioritization: 'balanced'`; the file
6
+ * URI is returned to the caller via `onCaptured`.
7
+ *
8
+ * Visual: dark scrim with a transparent rectangular cutout (ID-1 16:10 ratio
9
+ * by default). The cutout is the visible-only guide — we do NOT crop the
10
+ * image client-side because the server's OCR pipeline rejects soft crops.
11
+ * The user is asked to fill the frame; the backend handles edge detection.
12
+ *
13
+ * No edge detection / OpenCV port (intentional MVP scope per the brief).
14
+ */
15
+
16
+ import { useCallback, useEffect, useRef, useState } from 'react';
17
+ import {
18
+ ActivityIndicator,
19
+ Pressable,
20
+ StyleSheet,
21
+ Text,
22
+ useWindowDimensions,
23
+ View,
24
+ } from 'react-native';
25
+ import Svg, { Defs, Mask, Rect } from 'react-native-svg';
26
+ import {
27
+ Camera,
28
+ useCameraDevice,
29
+ useCameraPermission,
30
+ type PhotoFile,
31
+ } from 'react-native-vision-camera';
32
+ import type { DocumentOrientation, DocumentSide } from '../types';
33
+ import { useTheme, withAlpha } from '../ui/theme';
34
+ import { Button } from '../ui/primitives/Button';
35
+ import { useSafeAreaInsets } from '../utils/useSafeAreaInsets';
36
+
37
+ export interface DocumentCaptureProps {
38
+ side: DocumentSide;
39
+ orientation: DocumentOrientation;
40
+ /** Localized instruction shown above the cutout. */
41
+ instructions: string;
42
+ /** Localized "Take photo" label for the shutter button. */
43
+ captureLabel: string;
44
+ /** Localized error string when permission is denied. */
45
+ permissionDeniedLabel: string;
46
+ /** Localized "Try again" label. */
47
+ retryLabel: string;
48
+ /** Localized "Cancel" / back label. */
49
+ cancelLabel: string;
50
+ onCaptured: (photo: PhotoFile, side: DocumentSide) => void;
51
+ onCancel: () => void;
52
+ }
53
+
54
+ export function DocumentCapture({
55
+ side,
56
+ orientation,
57
+ instructions,
58
+ captureLabel,
59
+ permissionDeniedLabel,
60
+ retryLabel,
61
+ cancelLabel,
62
+ onCaptured,
63
+ onCancel,
64
+ }: DocumentCaptureProps) {
65
+ const theme = useTheme();
66
+ const insets = useSafeAreaInsets();
67
+ const cameraRef = useRef<Camera>(null);
68
+ // Cross-platform back-camera selection.
69
+ //
70
+ // iOS (especially 15 Pro / Pro Max with multi-lens systems): asking for
71
+ // just 'back' returns the *wide-angle* device, whose ~20 cm minimum focus
72
+ // distance produces blurry frames when the user holds the ID closer.
73
+ // Passing the `physicalDevices` array makes vision-camera pick the
74
+ // *virtual multi-camera* device, which lets iOS auto-switch to the
75
+ // ultra-wide lens for macro / close-range subjects. Order = preference.
76
+ //
77
+ // Android: vision-camera's Android implementation ignores the
78
+ // `physicalDevices` filter (Android cameras are addressed by ID, not by
79
+ // physical-lens type) and returns the same default back camera it would
80
+ // return without the filter. So the filter is a no-op there but doesn't
81
+ // harm anything. Continuous AF is the default focus mode on both
82
+ // platforms, so cross-platform behaviour stays consistent.
83
+ const device = useCameraDevice('back', {
84
+ physicalDevices: [
85
+ 'ultra-wide-angle-camera',
86
+ 'wide-angle-camera',
87
+ 'telephoto-camera',
88
+ ],
89
+ });
90
+ const { hasPermission, requestPermission } = useCameraPermission();
91
+ const [requestedOnce, setRequestedOnce] = useState(false);
92
+ const [shooting, setShooting] = useState(false);
93
+ const [error, setError] = useState<string | null>(null);
94
+ // After ~4s without a device, surface a clear error instead of an
95
+ // infinite spinner. The most common cause is running the SDK in the
96
+ // iOS Simulator, which has no real camera.
97
+ const [deviceTimeout, setDeviceTimeout] = useState(false);
98
+ const [focusPoint, setFocusPoint] = useState<
99
+ { x: number; y: number; key: number } | null
100
+ >(null);
101
+
102
+ useEffect(() => {
103
+ if (!hasPermission && !requestedOnce) {
104
+ setRequestedOnce(true);
105
+ void requestPermission();
106
+ }
107
+ }, [hasPermission, requestedOnce, requestPermission]);
108
+
109
+ useEffect(() => {
110
+ if (device || !hasPermission) {
111
+ setDeviceTimeout(false);
112
+ return;
113
+ }
114
+ const t = setTimeout(() => setDeviceTimeout(true), 4000);
115
+ return () => clearTimeout(t);
116
+ }, [device, hasPermission]);
117
+
118
+ // NOTE: we intentionally do NOT call `cameraRef.current.focus()` on mount
119
+ // or before each shutter. iOS's continuous auto-focus runs by default and
120
+ // is what makes the native Camera app feel sharp at any distance. Calling
121
+ // `focus()` switches the device into single-shot/locked mode and DOES NOT
122
+ // restore continuous AF afterwards (vision-camera v4 has no "resume AF"
123
+ // API). The previous "autofocus on mount" + "autofocus before shutter"
124
+ // calls were the cause of blurry captures on iPhone 15 Pro Max: they
125
+ // pinned focus to the centre even after the user moved the phone, and
126
+ // never re-engaged continuous AF.
127
+ //
128
+ // Tap-to-focus is the one user-initiated override — when the user taps,
129
+ // they're explicitly asking us to lock focus on that point.
130
+ const supportsFocus = Boolean(device?.supportsFocus);
131
+
132
+ const handleTapToFocus = useCallback(
133
+ (event: { nativeEvent: { locationX: number; locationY: number } }) => {
134
+ if (!supportsFocus || !cameraRef.current) return;
135
+ const { locationX, locationY } = event.nativeEvent;
136
+ cameraRef.current.focus({ x: locationX, y: locationY }).catch(() => {
137
+ // Ignore — focus rejection is non-fatal.
138
+ });
139
+ setFocusPoint({ x: locationX, y: locationY, key: Date.now() });
140
+ },
141
+ [supportsFocus],
142
+ );
143
+
144
+ // Auto-hide the focus indicator after a short period.
145
+ useEffect(() => {
146
+ if (!focusPoint) return;
147
+ const t = setTimeout(() => setFocusPoint(null), 700);
148
+ return () => clearTimeout(t);
149
+ }, [focusPoint]);
150
+
151
+ const handleShutter = useCallback(async () => {
152
+ if (!cameraRef.current || shooting) return;
153
+ setShooting(true);
154
+ setError(null);
155
+ try {
156
+ const photo = await cameraRef.current.takePhoto({
157
+ flash: 'off',
158
+ enableShutterSound: false,
159
+ });
160
+ onCaptured(photo, side);
161
+ } catch (err) {
162
+ setError(err instanceof Error ? err.message : String(err));
163
+ } finally {
164
+ setShooting(false);
165
+ }
166
+ }, [onCaptured, side, shooting]);
167
+
168
+ if (!hasPermission) {
169
+ return (
170
+ <View style={[styles.permission, { backgroundColor: theme.backgroundColor }]}>
171
+ <Text style={[styles.permissionText, { color: theme.textColor }]}>
172
+ {permissionDeniedLabel}
173
+ </Text>
174
+ <View style={styles.row}>
175
+ <Button
176
+ variant="ghost"
177
+ label={cancelLabel}
178
+ onPress={onCancel}
179
+ fullWidth={false}
180
+ style={styles.actionBtn}
181
+ />
182
+ <Button
183
+ label={retryLabel}
184
+ onPress={() => {
185
+ void requestPermission();
186
+ }}
187
+ fullWidth={false}
188
+ style={styles.actionBtn}
189
+ />
190
+ </View>
191
+ </View>
192
+ );
193
+ }
194
+
195
+ if (!device) {
196
+ if (deviceTimeout) {
197
+ return (
198
+ <View style={[styles.permission, { backgroundColor: theme.backgroundColor }]}>
199
+ <Text style={[styles.permissionText, { color: theme.textColor }]}>
200
+ No camera detected. The iOS Simulator does not provide a real
201
+ camera — please run on a physical device to capture documents.
202
+ </Text>
203
+ <View style={styles.row}>
204
+ <Button
205
+ variant="ghost"
206
+ label={cancelLabel}
207
+ onPress={onCancel}
208
+ fullWidth={false}
209
+ style={styles.actionBtn}
210
+ />
211
+ </View>
212
+ </View>
213
+ );
214
+ }
215
+ return (
216
+ <View style={[styles.permission, { backgroundColor: theme.backgroundColor }]}>
217
+ <ActivityIndicator color={theme.primaryColor} />
218
+ </View>
219
+ );
220
+ }
221
+
222
+ return (
223
+ <View style={styles.root}>
224
+ <Camera
225
+ ref={cameraRef}
226
+ style={StyleSheet.absoluteFill}
227
+ device={device}
228
+ photo
229
+ photoQualityBalance="quality"
230
+ enableZoomGesture={false}
231
+ isActive
232
+ />
233
+ {/* Invisible pressable layer over the camera preview for tap-to-focus.
234
+ Sits below the mask + chrome so the user can tap anywhere except
235
+ the bottom shutter / top close button. */}
236
+ <Pressable
237
+ style={StyleSheet.absoluteFill}
238
+ onPress={handleTapToFocus}
239
+ accessibilityLabel="Tap to focus"
240
+ />
241
+ <DocumentMaskOverlay orientation={orientation} />
242
+ {focusPoint ? (
243
+ <View
244
+ pointerEvents="none"
245
+ style={[
246
+ styles.focusRing,
247
+ {
248
+ left: focusPoint.x - FOCUS_RING_SIZE / 2,
249
+ top: focusPoint.y - FOCUS_RING_SIZE / 2,
250
+ },
251
+ ]}
252
+ />
253
+ ) : null}
254
+ {/* The <Camera> above stays full-bleed (absoluteFill) so OCR framing is
255
+ never cropped; only the chrome below is offset by the safe-area
256
+ insets so the ✕ clears the top notch and the shutter clears the
257
+ bottom navigation bar / gesture area. */}
258
+ <View style={[styles.topBar, { top: insets.top + 12 }]}>
259
+ <Pressable onPress={onCancel} style={styles.iconBtn} accessibilityLabel={cancelLabel}>
260
+ <Text style={styles.iconBtnText}>✕</Text>
261
+ </Pressable>
262
+ </View>
263
+ <View
264
+ style={[styles.instructions, { top: insets.top + 60 }]}
265
+ pointerEvents="none"
266
+ >
267
+ <Text style={styles.instructionsText}>{instructions}</Text>
268
+ </View>
269
+ <View style={[styles.bottomBar, { bottom: insets.bottom + 32 }]}>
270
+ {error ? <Text style={styles.errorText}>{error}</Text> : null}
271
+ <Pressable
272
+ accessibilityRole="button"
273
+ accessibilityLabel={captureLabel}
274
+ accessibilityState={{ disabled: shooting }}
275
+ disabled={shooting}
276
+ onPress={handleShutter}
277
+ style={[
278
+ styles.shutter,
279
+ { borderColor: '#FFFFFF', backgroundColor: withAlpha('#FFFFFF', 0.18) },
280
+ shooting && styles.shutterDisabled,
281
+ ]}
282
+ >
283
+ <View
284
+ style={[styles.shutterCore, { backgroundColor: '#FFFFFF' }]}
285
+ />
286
+ </Pressable>
287
+ </View>
288
+ </View>
289
+ );
290
+ }
291
+
292
+ const FOCUS_RING_SIZE = 64;
293
+
294
+ interface MaskProps {
295
+ orientation: DocumentOrientation;
296
+ }
297
+
298
+ const CUTOUT_WIDTH_RATIO = 0.85; // 85% of screen width
299
+ const CUTOUT_MAX_HEIGHT_RATIO = 0.62; // never taller than 62% of screen height
300
+ const CORNER_LENGTH = 28;
301
+ const CORNER_THICKNESS = 3;
302
+ /**
303
+ * Radius of the rounded cutout AND of the corner brackets. The SVG mask uses
304
+ * it for the inner rounded rect; each bracket's outward corner radius is the
305
+ * same value so the brackets sit flush on the curve.
306
+ */
307
+ const CUTOUT_RADIUS = 16;
308
+ const DIM_COLOR = 'rgba(0,0,0,0.55)';
309
+
310
+ function DocumentMaskOverlay({ orientation }: MaskProps) {
311
+ const { width: screenW, height: screenH } = useWindowDimensions();
312
+ const aspectRatio = orientation === 'portrait' ? 0.625 : 1.586;
313
+
314
+ // Compute the cutout proportionally. Width is the primary dimension; if
315
+ // the resulting height would overflow the screen budget (mostly portrait
316
+ // ID-1 = 0.625 aspect on tall phones), shrink it back to fit.
317
+ let cutoutW = screenW * CUTOUT_WIDTH_RATIO;
318
+ let cutoutH = cutoutW / aspectRatio;
319
+ const maxH = screenH * CUTOUT_MAX_HEIGHT_RATIO;
320
+ if (cutoutH > maxH) {
321
+ cutoutH = maxH;
322
+ cutoutW = cutoutH * aspectRatio;
323
+ }
324
+ const left = (screenW - cutoutW) / 2;
325
+ const top = (screenH - cutoutH) / 2;
326
+ const R = CUTOUT_RADIUS;
327
+
328
+ // SVG mask: opaque outer rect minus a rounded inner rect. The mask paints
329
+ // white where dim should render and black where the cutout is transparent;
330
+ // the rounded inner Rect (rx/ry = R) produces exact concave curves at each
331
+ // corner — no quarter-circle fillers, no curve inversion.
332
+ return (
333
+ <View pointerEvents="none" style={StyleSheet.absoluteFill}>
334
+ <Svg width={screenW} height={screenH} style={StyleSheet.absoluteFill}>
335
+ <Defs>
336
+ <Mask id="documentCutout">
337
+ <Rect x={0} y={0} width={screenW} height={screenH} fill="white" />
338
+ <Rect
339
+ x={left}
340
+ y={top}
341
+ width={cutoutW}
342
+ height={cutoutH}
343
+ rx={R}
344
+ ry={R}
345
+ fill="black"
346
+ />
347
+ </Mask>
348
+ </Defs>
349
+ <Rect
350
+ x={0}
351
+ y={0}
352
+ width={screenW}
353
+ height={screenH}
354
+ fill={DIM_COLOR}
355
+ mask="url(#documentCutout)"
356
+ />
357
+ </Svg>
358
+
359
+ {/* Corner brackets, anchored to the cutout bounding box. Each bracket's
360
+ outward corner uses the same radius as the cutout so it sits flush
361
+ on the curve. */}
362
+ <View
363
+ style={{
364
+ position: 'absolute',
365
+ left,
366
+ top,
367
+ width: cutoutW,
368
+ height: cutoutH,
369
+ }}
370
+ >
371
+ <View style={[styles.corner, styles.cornerTL, { borderTopLeftRadius: R }]} />
372
+ <View style={[styles.corner, styles.cornerTR, { borderTopRightRadius: R }]} />
373
+ <View style={[styles.corner, styles.cornerBL, { borderBottomLeftRadius: R }]} />
374
+ <View style={[styles.corner, styles.cornerBR, { borderBottomRightRadius: R }]} />
375
+ </View>
376
+ </View>
377
+ );
378
+ }
379
+
380
+ const styles = StyleSheet.create({
381
+ root: {
382
+ flex: 1,
383
+ backgroundColor: '#000',
384
+ },
385
+ permission: {
386
+ flex: 1,
387
+ alignItems: 'center',
388
+ justifyContent: 'center',
389
+ padding: 32,
390
+ gap: 16,
391
+ },
392
+ permissionText: {
393
+ textAlign: 'center',
394
+ fontSize: 15,
395
+ lineHeight: 22,
396
+ },
397
+ row: {
398
+ flexDirection: 'row',
399
+ gap: 12,
400
+ width: '100%',
401
+ maxWidth: 380,
402
+ },
403
+ actionBtn: {
404
+ flex: 1,
405
+ },
406
+ topBar: {
407
+ position: 'absolute',
408
+ top: 12,
409
+ left: 12,
410
+ right: 12,
411
+ flexDirection: 'row',
412
+ alignItems: 'center',
413
+ justifyContent: 'flex-end',
414
+ },
415
+ iconBtn: {
416
+ width: 36,
417
+ height: 36,
418
+ borderRadius: 18,
419
+ backgroundColor: 'rgba(0,0,0,0.5)',
420
+ alignItems: 'center',
421
+ justifyContent: 'center',
422
+ },
423
+ iconBtnText: {
424
+ color: '#FFFFFF',
425
+ fontSize: 16,
426
+ fontWeight: '700',
427
+ },
428
+ instructions: {
429
+ position: 'absolute',
430
+ top: 60,
431
+ left: 24,
432
+ right: 24,
433
+ alignItems: 'center',
434
+ },
435
+ instructionsText: {
436
+ color: '#FFFFFF',
437
+ fontSize: 14,
438
+ textAlign: 'center',
439
+ backgroundColor: 'rgba(0,0,0,0.5)',
440
+ paddingHorizontal: 12,
441
+ paddingVertical: 6,
442
+ borderRadius: 16,
443
+ overflow: 'hidden',
444
+ },
445
+ bottomBar: {
446
+ position: 'absolute',
447
+ bottom: 32,
448
+ left: 0,
449
+ right: 0,
450
+ alignItems: 'center',
451
+ gap: 12,
452
+ },
453
+ errorText: {
454
+ color: '#FCA5A5',
455
+ fontSize: 13,
456
+ textAlign: 'center',
457
+ paddingHorizontal: 24,
458
+ },
459
+ shutter: {
460
+ width: 76,
461
+ height: 76,
462
+ borderRadius: 38,
463
+ borderWidth: 4,
464
+ alignItems: 'center',
465
+ justifyContent: 'center',
466
+ },
467
+ shutterDisabled: {
468
+ opacity: 0.5,
469
+ },
470
+ shutterCore: {
471
+ width: 56,
472
+ height: 56,
473
+ borderRadius: 28,
474
+ },
475
+ corner: {
476
+ position: 'absolute',
477
+ width: CORNER_LENGTH,
478
+ height: CORNER_LENGTH,
479
+ borderColor: '#FFFFFF',
480
+ },
481
+ cornerTL: {
482
+ top: 0,
483
+ left: 0,
484
+ borderTopWidth: CORNER_THICKNESS,
485
+ borderLeftWidth: CORNER_THICKNESS,
486
+ },
487
+ cornerTR: {
488
+ top: 0,
489
+ right: 0,
490
+ borderTopWidth: CORNER_THICKNESS,
491
+ borderRightWidth: CORNER_THICKNESS,
492
+ },
493
+ cornerBL: {
494
+ bottom: 0,
495
+ left: 0,
496
+ borderBottomWidth: CORNER_THICKNESS,
497
+ borderLeftWidth: CORNER_THICKNESS,
498
+ },
499
+ cornerBR: {
500
+ bottom: 0,
501
+ right: 0,
502
+ borderBottomWidth: CORNER_THICKNESS,
503
+ borderRightWidth: CORNER_THICKNESS,
504
+ },
505
+ focusRing: {
506
+ position: 'absolute',
507
+ width: FOCUS_RING_SIZE,
508
+ height: FOCUS_RING_SIZE,
509
+ borderRadius: FOCUS_RING_SIZE / 2,
510
+ borderWidth: 2,
511
+ borderColor: '#FFFFFF',
512
+ backgroundColor: 'transparent',
513
+ },
514
+ });