@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
package/README.md ADDED
@@ -0,0 +1,888 @@
1
+ # Velion Onboarding SDK — React Native
2
+
3
+ `@velion-la/onboarding-sdk-react-native` is the native React Native SDK that
4
+ runs the complete Velion KYC flow inside an iOS or Android app:
5
+
6
+ - Device fingerprint.
7
+ - Personal / legal information forms.
8
+ - Email and SMS OTP.
9
+ - Sworn declaration and terms & conditions.
10
+ - Document OCR (front + back) with a native camera.
11
+ - Active liveness with face mesh challenges.
12
+ - Face match against the captured ID document.
13
+ - Optional map-assisted address picker.
14
+
15
+ The SDK uses the same Onboarding backend contract (REST + SSE events + step
16
+ state machine) as Velion's web SDK and adds a fully native UI and camera.
17
+
18
+ ## Table of contents
19
+
20
+ - [Quickstart](#quickstart)
21
+ - [Installation](#installation)
22
+ - [Native setup](#native-setup)
23
+ - [Permissions](#permissions)
24
+ - [Using the component](#using-the-component)
25
+ - [`VelionConfig`](#velionconfig)
26
+ - [Callbacks](#callbacks)
27
+ - [Theming](#theming)
28
+ - [Locales](#locales)
29
+ - [Errors](#errors)
30
+ - [Assisted address mode (Google Maps)](#assisted-address-mode-google-maps)
31
+ - [Supported steps](#supported-steps)
32
+ - [Stack and architecture](#stack-and-architecture)
33
+ - [Local development](#local-development)
34
+ - [Publishing](#publishing)
35
+ - [License](#license)
36
+
37
+ ---
38
+
39
+ ## Quickstart
40
+
41
+ ```tsx
42
+ import { VelionOnboardingScreen } from '@velion-la/onboarding-sdk-react-native';
43
+
44
+ export function KycScreen({ navigation }) {
45
+ return (
46
+ <VelionOnboardingScreen
47
+ config={{
48
+ sessionId: 'ses_abc123', // returned by your backend
49
+ sessionToken: 'eyJ...', // returned by your backend
50
+ apiUrl: 'https://api.velion.la/gateway/api/v1/onboarding/public/sdk',
51
+ locale: 'es',
52
+ colorMode: 'auto',
53
+ onSuccess: (result) => console.log('done', result.status),
54
+ onError: (err) => console.error(err.code, err.message),
55
+ }}
56
+ onComplete={(result) => navigation.replace('Home', { kyc: result })}
57
+ onFail={() => navigation.goBack()}
58
+ />
59
+ );
60
+ }
61
+ ```
62
+
63
+ The component is full-screen and takes care of:
64
+
65
+ 1. Loading the session (`GET /sessions/:id`).
66
+ 2. Opening the SSE stream for backend-driven events.
67
+ 3. Rendering each step requested by the backend in order.
68
+ 4. Resolving the flow at the end (`onSuccess` / `onError`).
69
+
70
+ ---
71
+
72
+ ## Installation
73
+
74
+ ### 1. The SDK
75
+
76
+ ```bash
77
+ npm install @velion-la/onboarding-sdk-react-native
78
+ ```
79
+
80
+ ### 2. Required peer dependencies
81
+
82
+ ```bash
83
+ npm install \
84
+ react-native-vision-camera \
85
+ react-native-svg \
86
+ react-native-sse \
87
+ expo-application expo-crypto expo-device expo-image-manipulator expo-keep-awake expo-location \
88
+ @noble/hashes
89
+ ```
90
+
91
+ ### 3. Optional peer dependencies (assisted address mode)
92
+
93
+ ```bash
94
+ npm install react-native-maps
95
+ ```
96
+
97
+ When `react-native-maps` is not installed, the `ADDRESS_INFO` step falls back
98
+ to a manual form and nothing else is required. The SDK does **not** depend on
99
+ `react-native-google-places-autocomplete`; the address search uses the
100
+ OS-native geocoder via `expo-location`.
101
+
102
+ ### Supported versions
103
+
104
+ | Package | Minimum | Tested against |
105
+ |---|---|---|
106
+ | `react` | `>=19.0.0` | `19.1.0` |
107
+ | `react-native` | `>=0.81.0` | `0.81.5` |
108
+ | `expo` | `>=54.0.0` | `~54.0.34` |
109
+ | `react-native-vision-camera` | `>=4.6.0` | `4.7.x` |
110
+
111
+ ---
112
+
113
+ ## Native setup
114
+
115
+ Vision Camera **does not run inside Expo Go**. Your app must have the `ios/`
116
+ and `android/` folders generated (either a bare React Native project or
117
+ `npx expo prebuild`).
118
+
119
+ ### Expo plugins (`app.json` / `app.config.js`)
120
+
121
+ ```jsonc
122
+ {
123
+ "expo": {
124
+ "plugins": [
125
+ "expo-dev-client",
126
+ [
127
+ "react-native-vision-camera",
128
+ {
129
+ "cameraPermissionText": "$(PRODUCT_NAME) needs access to your camera to capture your ID document and run the liveness check.",
130
+ "enableMicrophonePermission": false,
131
+ "enableCodeScanner": false
132
+ }
133
+ ],
134
+ [
135
+ "expo-location",
136
+ {
137
+ "locationWhenInUsePermission": "We use your location to suggest your home address."
138
+ }
139
+ ]
140
+ ]
141
+ }
142
+ }
143
+ ```
144
+
145
+ > Do **not** include `"expo-image-manipulator"` in `plugins[]`. From Expo SDK
146
+ > 54 onwards it is a runtime-only module, not a config plugin.
147
+
148
+ Then run:
149
+
150
+ ```bash
151
+ npx expo prebuild --clean
152
+ npx expo run:ios # or run:android
153
+ ```
154
+
155
+ ### Bare React Native (no Expo)
156
+
157
+ Follow each library's own setup guide:
158
+
159
+ - Vision Camera: <https://react-native-vision-camera.com/docs/guides>
160
+ - React Native Maps (only if used): <https://github.com/react-native-maps/react-native-maps#installation>
161
+ - Expo modules inside a bare project: <https://docs.expo.dev/bare/installing-expo-modules/>
162
+
163
+ ---
164
+
165
+ ## Permissions
166
+
167
+ ### iOS — `Info.plist`
168
+
169
+ ```xml
170
+ <key>NSCameraUsageDescription</key>
171
+ <string>We need access to your camera to capture your ID document and run the liveness check.</string>
172
+
173
+ <!-- Only when googleMapsApiKey is set -->
174
+ <key>NSLocationWhenInUseUsageDescription</key>
175
+ <string>We use your location to suggest your home address.</string>
176
+ ```
177
+
178
+ With Expo, the Vision Camera and `expo-location` plugins inject these
179
+ automatically from `app.json`.
180
+
181
+ ### Android — `AndroidManifest.xml`
182
+
183
+ ```xml
184
+ <uses-permission android:name="android.permission.CAMERA" />
185
+
186
+ <!-- Only when googleMapsApiKey is set -->
187
+ <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
188
+ <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
189
+ ```
190
+
191
+ With Expo, declare them in `app.json`:
192
+
193
+ ```jsonc
194
+ {
195
+ "expo": {
196
+ "android": {
197
+ "permissions": [
198
+ "android.permission.CAMERA",
199
+ "android.permission.ACCESS_COARSE_LOCATION",
200
+ "android.permission.ACCESS_FINE_LOCATION"
201
+ ]
202
+ }
203
+ }
204
+ }
205
+ ```
206
+
207
+ ---
208
+
209
+ ## Using the component
210
+
211
+ ```tsx
212
+ import {
213
+ VelionOnboardingScreen,
214
+ type VelionConfig,
215
+ type OnboardingResult,
216
+ type SdkError,
217
+ } from '@velion-la/onboarding-sdk-react-native';
218
+
219
+ const config: VelionConfig = {
220
+ sessionId: '<sessionId from your backend>',
221
+ sessionToken: '<sessionToken from your backend>',
222
+ apiUrl: 'https://<your-host>/public/sdk',
223
+ locale: 'es',
224
+ colorMode: 'auto',
225
+ onSuccess: (result) => { /* flow completed */ },
226
+ onError: (err) => { /* flow failed */ },
227
+ onStepChange: (step, idx) => { /* analytics */ },
228
+ onStepComplete: (step) => { /* analytics */ },
229
+ onSessionEvent: (evt) => { /* raw SSE events */ },
230
+ };
231
+
232
+ <VelionOnboardingScreen
233
+ config={config}
234
+ onComplete={(result) => navigation.replace('Home')}
235
+ onFail={(err) => navigation.goBack()}
236
+ />
237
+ ```
238
+
239
+ ### Lifecycle
240
+
241
+ | Event | When it fires |
242
+ |---|---|
243
+ | Mount | The SDK opens the session, connects SSE, and starts the first step. |
244
+ | `onStepChange` | The orchestrator transitions into a new step. |
245
+ | `onStepComplete` | The current step was successfully submitted. |
246
+ | `onSessionEvent` | Every SSE event received (useful for debugging). |
247
+ | `onSuccess` / `onComplete` | The flow finished: `APPROVED`, `MANUAL_REVIEW`, `REJECTED` or `DECLINED`. |
248
+ | `onError` / `onFail` | Unrecoverable error (token expired, fatal network error, backend decline, …). |
249
+ | Unmount | The SDK aborts in-flight requests, closes SSE, and releases the camera. |
250
+
251
+ > Use the component props `onComplete` / `onFail` **or** the config callbacks
252
+ > `onSuccess` / `onError`. Both do the same thing. The config callbacks are
253
+ > exposed for imperative integrations as well.
254
+
255
+ ### Manual dismissal (modal usage)
256
+
257
+ ```tsx
258
+ function KycModal({ visible, onClose }) {
259
+ return (
260
+ <Modal visible={visible} onRequestClose={onClose}>
261
+ <VelionOnboardingScreen config={config} onComplete={onClose} onFail={onClose} />
262
+ </Modal>
263
+ );
264
+ }
265
+ ```
266
+
267
+ When the modal unmounts, the SDK runs its internal cleanup automatically
268
+ (aborts in-flight `fetch` calls, closes SSE, releases the camera).
269
+
270
+ ### Imperative usage (advanced)
271
+
272
+ If you need to control the lifecycle outside React (custom navigation
273
+ container, headless mode, etc.):
274
+
275
+ ```tsx
276
+ import { VelionOnboarding } from '@velion-la/onboarding-sdk-react-native';
277
+
278
+ const sdk = new VelionOnboarding(config);
279
+ sdk.attachView({
280
+ setLoading: (text) => /* show overlay */,
281
+ setStepNode: (node) => /* render the step UI */,
282
+ setError: (err) => /* show error */,
283
+ setResult: (r) => /* show result */,
284
+ });
285
+ await sdk.start();
286
+ // …later:
287
+ sdk.destroy();
288
+ ```
289
+
290
+ `<VelionOnboardingScreen>` is a thin wrapper over this API.
291
+
292
+ ### Mount once per session
293
+
294
+ `<VelionOnboardingScreen>` opens an SSE stream and drives a state machine on
295
+ mount. If React unmounts and remounts the component, the SDK starts a fresh
296
+ session, re-opens SSE, and discards in-memory progress. To avoid this:
297
+
298
+ - Keep `config.sessionId` and `config.apiUrl` stable. The SDK uses them as
299
+ identity; changing either tears down the inner instance and starts over
300
+ (intentional, to support session rotation).
301
+ - Don't declare component wrappers (Provider, layout, frame) inside the body
302
+ of your screen. A new function on each render is a new component type for
303
+ React and forces the entire subtree to unmount.
304
+ - If your `config` includes dynamic callbacks, memoize it with `useMemo` or
305
+ stash the callbacks in a `useRef` to avoid identity churn.
306
+ - Don't pass a `key` that changes per render.
307
+
308
+ ```tsx
309
+ import { useMemo, useRef } from 'react';
310
+ import { VelionOnboardingScreen } from '@velion-la/onboarding-sdk-react-native';
311
+
312
+ export function KycScreen({ sessionId, sessionToken, navigation }) {
313
+ const navRef = useRef(navigation);
314
+ navRef.current = navigation;
315
+
316
+ const config = useMemo(
317
+ () => ({
318
+ sessionId,
319
+ sessionToken,
320
+ locale: 'es',
321
+ onSuccess: (result) => navRef.current.replace('Home', { kyc: result }),
322
+ onError: () => navRef.current.goBack(),
323
+ }),
324
+ [sessionId, sessionToken],
325
+ );
326
+
327
+ return <VelionOnboardingScreen config={config} />;
328
+ }
329
+ ```
330
+
331
+ Symptom of a misconfigured mount: repeated `[SSE] Opening stream` log lines
332
+ every few hundred milliseconds, or the first step (typically
333
+ `DEVICE_FINGERPRINT`) never completing.
334
+
335
+ ---
336
+
337
+ ## `VelionConfig`
338
+
339
+ ```ts
340
+ interface VelionConfig {
341
+ // Session
342
+ sessionId: string; // generated by your backend
343
+ sessionToken: string; // bearer token for this session
344
+ apiUrl: string; // base URL ending in `/public/sdk`
345
+ expiresAt?: string; // ISO-8601, optional client-side check
346
+
347
+ // UI
348
+ locale?: 'es' | 'en';
349
+ colorMode?: 'light' | 'dark' | 'auto';
350
+ theme?: VelionTheme;
351
+ showProgressBar?: boolean;
352
+ showFinalResultScreen?: boolean;
353
+ finalResultScreenTexts?: VelionFinalResultScreenTexts;
354
+ sessionDeclinedReasonTexts?: VelionSessionDeclinedReasonTexts;
355
+
356
+ // Liveness
357
+ livenessShowIntro?: boolean; // default true
358
+ livenessShowBackButton?: boolean; // default true
359
+
360
+ // Address (assisted)
361
+ googleMapsApiKey?: string;
362
+
363
+ // Fingerprint
364
+ fingerprintEndpoint?: string;
365
+ fingerprintApiKey?: string;
366
+ fingerprintTimeoutMs?: number;
367
+
368
+ // Debug
369
+ debug?: boolean;
370
+
371
+ // Callbacks
372
+ onSuccess?: (result: OnboardingResult) => void;
373
+ onError?: (err: SdkError) => void;
374
+ onStepChange?: (step: OnboardingStep, index: number) => void;
375
+ onStepComplete?: (step: OnboardingStep) => void;
376
+ onSessionEvent?: (event: OnboardingSessionEvent) => void;
377
+ onFinalResultScreenDismiss?: () => void;
378
+ }
379
+ ```
380
+
381
+ ### Critical fields
382
+
383
+ - **`apiUrl`** must be HTTPS (or `http://localhost:*` for development). The
384
+ SDK refuses insecure URLs so the `sessionToken` is never sent in cleartext.
385
+ - **`sessionId` + `sessionToken`** are issued by your backend when the
386
+ session is created. The token is single-use for that session.
387
+ - **`apiUrl`** must end with `/public/sdk`; all relative endpoints are
388
+ resolved against it.
389
+
390
+ ---
391
+
392
+ ## Callbacks
393
+
394
+ ```ts
395
+ onSuccess: (result: OnboardingResult) => void;
396
+ ```
397
+
398
+ ```ts
399
+ interface OnboardingResult {
400
+ sessionId: string;
401
+ completedAt: string; // ISO-8601
402
+ status: 'APPROVED' | 'MANUAL_REVIEW' | 'REJECTED' | 'DECLINED';
403
+ referenceId?: string; // for support / audit trail
404
+ terminalReason?: string; // backend-supplied reason
405
+ }
406
+ ```
407
+
408
+ ```ts
409
+ onError: (err: SdkError) => void;
410
+ ```
411
+
412
+ ```ts
413
+ onExit: (exit: OnboardingExit) => void; // { reason: 'BACK_EXIT'; step?: OnboardingStep }
414
+ ```
415
+
416
+ Fires when the user leaves the flow **without a verdict** — currently only when
417
+ they tap "back" on the first reversible step. Neither `onSuccess` nor `onError`
418
+ runs; dismiss the SDK screen and return the user to the previous context. See
419
+ [Reverse navigation](#reverse-navigation-back).
420
+
421
+ ```ts
422
+ interface SdkError {
423
+ code: SdkErrorCode;
424
+ message: string;
425
+ declineReason?: string; // when code === SESSION_DECLINED
426
+ stepCode?: string;
427
+ declineTitle?: string; // localized copy
428
+ declineMessage?: string;
429
+ cameraCode?: CameraErrorCode;
430
+ httpStatus?: number;
431
+ cause?: unknown;
432
+ }
433
+ ```
434
+
435
+ Possible `SdkErrorCode` values:
436
+
437
+ | Code | When |
438
+ |---|---|
439
+ | `SESSION_INVALID` | Token rejected (403). |
440
+ | `SESSION_EXPIRED` | Token expired (401) — request a fresh one. |
441
+ | `SESSION_FETCH_FAILED` | Could not load the initial session. |
442
+ | `SESSION_DECLINED` | Backend sent `SESSION_DECLINED` over SSE. |
443
+ | `FINGERPRINT_FAILED` | Visitor id could not be generated. |
444
+ | `DOCUMENT_UPLOAD_FAILED` | `PUT` to the signed URL or `verify` step failed. |
445
+ | `LIVENESS_FAILED` | Liveness service closed the WebSocket with a terminal warning. |
446
+ | `LIVENESS_INIT_FAILED` | `/liveness-init` failed. |
447
+ | `CAMERA_ERROR` | Camera denied or unavailable. |
448
+ | `NETWORK_ERROR` | Connectivity lost. |
449
+ | `API_ERROR` | Backend returned 5xx or an unexpected response. |
450
+ | `ALREADY_STARTED`, `INSTANCE_DESTROYED` | Lifecycle misuse. |
451
+ | `UNKNOWN` | Anything else. |
452
+
453
+ ```ts
454
+ onStepChange: (step: OnboardingStep, index: number) => void;
455
+ ```
456
+
457
+ `step` is one of `'DEVICE_FINGERPRINT' | 'HUMAN_BASIC_INFO' | 'EMAIL_OTP' | …`
458
+ (see [Supported steps](#supported-steps)).
459
+
460
+ ```ts
461
+ onSessionEvent: (event: OnboardingSessionEvent) => void;
462
+ ```
463
+
464
+ You receive every raw SSE event for analytics or debugging. The SDK already
465
+ handles everything internally; this callback is optional.
466
+
467
+ ---
468
+
469
+ ## Theming
470
+
471
+ ```ts
472
+ import type { VelionTheme } from '@velion-la/onboarding-sdk-react-native';
473
+
474
+ const theme: VelionTheme = {
475
+ primaryColor: '#0052CC',
476
+ secondaryColor: '#1D4ED8',
477
+ backgroundColor: '#FFFFFF',
478
+ textColor: '#111827',
479
+ textSecondaryColor: '#6B7280',
480
+ errorColor: '#DC2626',
481
+ successColor: '#16A34A',
482
+ warningColor: '#D97706',
483
+ borderColor: '#E5E7EB',
484
+ borderRadius: '8px',
485
+ fontFamily: 'System',
486
+ hideStepIcons: false, // hide the colored round icon next to step titles
487
+ hideProgressBar: false, // hide the sticky top progress bar
488
+ };
489
+ ```
490
+
491
+ ### Layout switches
492
+
493
+ `VelionTheme` exposes two layout flags controlled alongside the visual theme:
494
+
495
+ ```tsx
496
+ config={{
497
+ ...config,
498
+ theme: {
499
+ ...theme,
500
+ hideStepIcons: true,
501
+ hideProgressBar: true,
502
+ },
503
+ }}
504
+ ```
505
+
506
+ Equivalences:
507
+
508
+ - `theme.hideProgressBar = true` and `config.showProgressBar = false` both
509
+ hide the bar.
510
+ - `theme.hideStepIcons = true` hides the per-step icons (no equivalent in
511
+ `VelionConfig`; theme-only).
512
+
513
+ ### Step header icons
514
+
515
+ Each step renders a themed icon (Material Icons) inside a circle of
516
+ `primaryColor` next to the title. They come from `@expo/vector-icons`, which
517
+ Expo SDK 54+ ships by default. In bare React Native projects without Expo,
518
+ install it separately (`npm install @expo/vector-icons`) or enable
519
+ `hideStepIcons` to skip the dependency.
520
+
521
+ ### Color mode
522
+
523
+ ```tsx
524
+ <VelionOnboardingScreen
525
+ config={{ ...config, theme, colorMode: 'light' }}
526
+ />
527
+ ```
528
+
529
+ With `colorMode: 'auto'` (default), the SDK follows `useColorScheme()` from
530
+ the system. `'light'` or `'dark'` force the mode.
531
+
532
+ If you pass a `theme` whose `backgroundColor` has the opposite luminance to
533
+ the active `colorMode`, the SDK detects the conflict and switches its icons
534
+ and SVGs to the correct tone. This avoids the case where
535
+ `colorMode: 'light'` + `backgroundColor: '#0B1220'` leaves dark icons on a
536
+ dark background.
537
+
538
+ ### Reduced motion
539
+
540
+ The SDK honours `AccessibilityInfo.isReduceMotionEnabled()` automatically.
541
+ There is nothing to configure — animations are disabled when the OS asks for
542
+ reduced motion.
543
+
544
+ ---
545
+
546
+ ## Locales
547
+
548
+ `locale: 'es' | 'en'`. Any other value falls back to `'es'`.
549
+
550
+ To override specific copy (e.g. the final result screen for
551
+ `SESSION_DECLINED`):
552
+
553
+ ```tsx
554
+ config={{
555
+ ...config,
556
+ finalResultScreenTexts: {
557
+ approved: { title: 'Done!', message: 'Your account is active.' },
558
+ manualReview: { title: 'Under review', message: 'We will reach out within 24h.' },
559
+ },
560
+ sessionDeclinedReasonTexts: {
561
+ LIVENESS_FAILED: {
562
+ es: { title: 'No pudimos verificarte', message: 'Probá de nuevo con buena luz.' },
563
+ en: { title: 'We could not verify you', message: 'Please retry under good light.' },
564
+ },
565
+ },
566
+ }}
567
+ ```
568
+
569
+ ---
570
+
571
+ ## Errors
572
+
573
+ ```tsx
574
+ import { SdkErrorCode, CameraErrorCode } from '@velion-la/onboarding-sdk-react-native';
575
+
576
+ onError: (err) => {
577
+ if (err.code === SdkErrorCode.SESSION_EXPIRED) {
578
+ refreshSessionToken().then((newConfig) => remountSdk(newConfig));
579
+ return;
580
+ }
581
+ if (err.code === SdkErrorCode.SESSION_DECLINED) {
582
+ // err.declineTitle / declineMessage already come localized
583
+ showDeclineScreen(err);
584
+ return;
585
+ }
586
+ if (err.code === SdkErrorCode.CAMERA_ERROR) {
587
+ if (err.cameraCode === CameraErrorCode.PERMISSION_DENIED) {
588
+ showCameraPermissionDialog();
589
+ }
590
+ return;
591
+ }
592
+ // Fallback
593
+ showRetry(err.message);
594
+ };
595
+ ```
596
+
597
+ ---
598
+
599
+ ## Assisted address mode (map + search)
600
+
601
+ `ADDRESS_INFO` has two modes:
602
+
603
+ - **Manual** (default fallback): full structured form (country, state, city,
604
+ district, neighbourhood, street, number, postal code, floor, apartment,
605
+ references).
606
+ - **Assisted**: fullscreen map with a floating search bar on top and a
607
+ floating "Next" button on the bottom. The user searches for their address
608
+ by typing, picks a suggestion, or drags the pin manually. On confirm, the
609
+ structured fields are filled automatically and `lat`/`lng` are added to
610
+ the payload.
611
+
612
+ ### Map provider per platform
613
+
614
+ | Platform | Map provider | API key required? |
615
+ |---|---|---|
616
+ | **iOS** | Apple Maps (system) | **No.** No GCP setup, no `AirGoogleMaps` target, no extra plugin. |
617
+ | **Android** | Google Maps SDK | **Yes.** Maps SDK for Android, application restriction `Android apps` + package + SHA-1. |
618
+
619
+ ### Geocoding and search — fully OS-native, no Google REST
620
+
621
+ The SDK does **not** call Google's HTTP APIs (Geocoding / Places Web
622
+ Service) from the client. Those APIs do not honour application restrictions
623
+ (bundle ID / package + SHA-1), so a tightly restricted key would fail with
624
+ `REQUEST_DENIED` on mobile. Instead:
625
+
626
+ - **Reverse geocoding** (pin → street / number / postal code / city /
627
+ state / country) uses `expo-location.reverseGeocodeAsync`. On iOS that is
628
+ `CLGeocoder` (Apple Maps); on Android it is `android.location.Geocoder`
629
+ (Google Play Services on-device). No key, no quota, no external Google
630
+ network call.
631
+ - **Search bar** uses `expo-location.geocodeAsync` with a 400 ms debounce,
632
+ plus a reverse-geocode fan-out on the top 5 candidates to build the
633
+ visible label ("Av. Corrientes 1234, CABA, Argentina"). Suggestions
634
+ appear when the user pauses typing.
635
+
636
+ ### When the assisted mode activates
637
+
638
+ ```
639
+ 1) Is `react-native-maps` linked?
640
+ no → manual
641
+ yes → ↓
642
+ 2) Platform?
643
+ iOS → assisted (Apple Maps, no key)
644
+ Android → is `googleMapsApiKey` set in VelionConfig?
645
+ yes → assisted (Google Maps with that key)
646
+ no → manual (Android MapView without a key renders blank)
647
+ 3) Does the MapView throw at runtime?
648
+ yes → manual (an error boundary captures it and falls back)
649
+ ```
650
+
651
+ In practice:
652
+
653
+ - On **iOS** it is enough to have `react-native-maps` installed.
654
+ `googleMapsApiKey` can be omitted.
655
+ - On **Android** you need `googleMapsApiKey` in `VelionConfig` **and** the
656
+ same key declared in `AndroidManifest.xml` (Expo handles this via
657
+ `app.config.js` → `android.config.googleMaps.apiKey`). Google Maps SDK
658
+ reads the key from the manifest, not from JS, so both places are required.
659
+
660
+ ### Google Cloud setup (Android only)
661
+
662
+ If you want assisted mode on Android:
663
+
664
+ 1. Enable **`Maps SDK for Android`** on your GCP project.
665
+ 2. **Application restriction**: `Android apps`. Add your package name plus
666
+ the SHA-1 fingerprint of the signing certificate. For debug builds:
667
+ ```bash
668
+ cd example/android && ./gradlew signingReport
669
+ # look for "Variant: debug" → SHA1
670
+ ```
671
+ 3. **API restriction**: restrict the key to `Maps SDK for Android` (do not
672
+ leave it as "Don't restrict key").
673
+ 4. **Billing enabled** on the GCP project (required even for the free tier).
674
+
675
+ ### Extra permissions (assisted mode only)
676
+
677
+ - iOS: `NSLocationWhenInUseUsageDescription`.
678
+ - Android: `ACCESS_COARSE_LOCATION` + `ACCESS_FINE_LOCATION`.
679
+
680
+ If the user rejects location, the map opens at a default centre and the
681
+ user can move the pin or use the search bar — the flow is not broken.
682
+
683
+ ### Automatic fallback when something fails
684
+
685
+ When mounting `ADDRESS_INFO`, the SDK checks:
686
+
687
+ 1. That `react-native-maps` is importable. If not → manual.
688
+ 2. On Android, that `googleMapsApiKey` is in `VelionConfig`. If not →
689
+ manual. Additionally, when `expo-constants` is available, the SDK checks
690
+ that the same key is declared in the Expo config; otherwise the
691
+ `MapView` would crash natively. If missing → manual with an
692
+ `[address]` warning explaining the fix.
693
+ 3. The `<MapAddressPicker>` is wrapped in an error boundary that catches a
694
+ throwing `MapView` at runtime (typical example: `AirGoogleMaps dir must
695
+ be added` on iOS if someone forces `provider="google"`). If it fires →
696
+ manual.
697
+
698
+ In every fallback path the SDK logs a warning prefixed with `[address]` and
699
+ renders the manual form. The user keeps completing the address, just
700
+ without `lat`/`lng`.
701
+
702
+ ---
703
+
704
+ ## Supported steps
705
+
706
+ | Step | Backend endpoint | UI |
707
+ |---|---|---|
708
+ | `DEVICE_FINGERPRINT` | `POST /sessions/:id/fingerprint` | Loading overlay |
709
+ | `HUMAN_BASIC_INFO` | `POST /basic-info/human` | Form |
710
+ | `LEGAL_BASIC_INFO` | `POST /basic-info/legal` | Form |
711
+ | `HUMAN_EXTENDED_INFO` | `POST /extended-info/human` | Form (fields per `stepConfig`) |
712
+ | `LEGAL_EXTENDED_INFO` | `POST /extended-info/legal` | Form (date + country) |
713
+ | `EMAIL_CONTACT` | `POST /contact/email` | Form |
714
+ | `PHONE_CONTACT` | `POST /contact/phone` | Form (E.164) |
715
+ | `EMAIL_OTP` | `POST /email/send-otp` + `verify-otp` | Two-stage form |
716
+ | `PHONE_OTP` | `POST /phone/send-otp` + `verify-otp` | Two-stage form |
717
+ | `TAX_INFO` | `POST /tax-info` | Form (selects from `stepConfig`) |
718
+ | `SWORN_DECLARATION` | `POST /sworn-declaration` | Cards with checkbox |
719
+ | `TERMS_AND_CONDITIONS` | `POST /terms-and-conditions` | Checkbox list + link |
720
+ | `ADDRESS_INFO` | `POST /address-info` | Manual or assisted (Maps) |
721
+ | `DOCUMENTS_OCR` | `POST /documents-init` + `PUT` × 2 + `verify` | Camera + intro tips |
722
+ | `LIVENESS_MATCH` | `POST /liveness-init` + WebSocket + `verify` | Front camera + oval mask |
723
+ | `FACE_MATCH` | (backend-only, no POST) | Loading + poll |
724
+
725
+ The order is determined dynamically by the backend via `current_step` and
726
+ the SSE `ROUTING_COMMAND` events. The SDK does no client-side routing.
727
+
728
+ ---
729
+
730
+ ## Reverse navigation ("Back")
731
+
732
+ Form steps can let the user return to a previous step to fix earlier answers.
733
+ As with everything else, **the SDK does not decide the sequence or which steps
734
+ are reversible — it obeys the backend**.
735
+
736
+ How it works, end to end:
737
+
738
+ 1. **When to show it.** The backend computes a session-level **`can_go_back`**
739
+ flag from the workflow graph (barrier model) and delivers it both on
740
+ `GET /sessions/:id` (top-level) and inside the `ROUTING_COMMAND / NEXT_STEP`
741
+ and `PREVIOUS_STEP` SSE messages. The SDK renders a top-left **"Atrás"**
742
+ control (chevron-back) **when `can_go_back === true`** — *not* a step's
743
+ intrinsic `reversible` flag. So the control also appears on non-reversible
744
+ steps (e.g. `DOCUMENTS_OCR`, before capturing) when there's an earlier
745
+ reversible step to return to, and is hidden on the very first step when
746
+ there's nowhere to go. `reversible` is still used for the prefill on
747
+ re-entry. The SDK never hardcodes the list.
748
+
749
+ > The backend `can_go_back` is the source of truth — the SDK uses it
750
+ > verbatim on the GET and on every routing command. As a safety net (e.g. an
751
+ > older backend that omits it, or the GET-on-resume path), the SDK falls back
752
+ > to deriving the flag from the per-step reversibility map cached at session
753
+ > load: a step can go back when any earlier step is reversible, or it is
754
+ > itself the first reversible step.
755
+ 2. **Tapping it.** The SDK calls `POST /sessions/:id/back` (fire-and-forget;
756
+ the same session `Bearer` token as every other call). A `400`
757
+ (`SESSION_INVALID_STATE`, session not `IN_PROGRESS`) or any other failure is
758
+ swallowed silently — the user simply keeps editing the current step.
759
+ 3. **The transition.** The backend re-opens the nearest reversible step and
760
+ pushes a `ROUTING_COMMAND` with `action: "PREVIOUS_STEP"` over SSE, carrying
761
+ the step's `step_config` and the previously-captured `step_result`. The SDK
762
+ tears down the active form and re-renders the re-opened step **prefilled**
763
+ with `step_result`.
764
+ 4. **Exiting from the first step.** When there is no earlier reversible step
765
+ (the user tapped back on the first interactive step), the backend instead
766
+ sends `action: "BACK_EXIT"`. The SDK leaves the flow: it clears its UI and
767
+ fires `onExit` (`{ reason: 'BACK_EXIT', step }`) so the host can dismiss the
768
+ SDK screen and return the user to the previous context. This is **neither**
769
+ `onSuccess` **nor** `onError`.
770
+ 5. **Idempotency.** Prefill is treated as editable initial state only — going
771
+ back never re-fires a step's side effects (no re-sending OTPs, no
772
+ re-uploading documents).
773
+
774
+ Reversible form steps and the data they prefill: `HUMAN_BASIC_INFO`,
775
+ `LEGAL_BASIC_INFO`, `HUMAN_EXTENDED_INFO`, `LEGAL_EXTENDED_INFO`, `TAX_INFO`,
776
+ and `ADDRESS_INFO`. For the assisted (map-based) address flow the structured
777
+ fields are re-confirmed on the map; the manual address form prefills every
778
+ field. This mirrors the Web SDK runtime for UX parity.
779
+
780
+ There is nothing to configure — the feature is driven entirely by the backend
781
+ `reversible` flag and the `PREVIOUS_STEP` routing command.
782
+
783
+ The only host-facing hook is the optional **`onExit`** callback (on
784
+ `VelionConfig` and as a `<VelionOnboardingScreen onExit={…} />` prop), invoked
785
+ on `BACK_EXIT` so you can unmount/dismiss the SDK:
786
+
787
+ ```tsx
788
+ <VelionOnboardingScreen
789
+ config={config}
790
+ onComplete={(result) => { /* verdict */ }}
791
+ onFail={(err) => { /* error / declined */ }}
792
+ onExit={({ step }) => navigation.goBack()} // user backed out of the first step
793
+ />
794
+ ```
795
+
796
+ > **Backend requirement.** Reverse navigation needs an Onboarding backend that
797
+ > exposes `POST /sessions/:id/back`, the session-level `can_go_back` flag (on the
798
+ > GET and on the `NEXT_STEP` / `PREVIOUS_STEP` routing commands; plus per-step
799
+ > `reversible` for prefill), and the `ROUTING_COMMAND` SSE commands
800
+ > `PREVIOUS_STEP` and `BACK_EXIT` (VON-20). Against an older backend `can_go_back`
801
+ > is absent and no earlier step is reversible, so the control never shows and the
802
+ > flow behaves exactly as before.
803
+
804
+ ---
805
+
806
+ ## Stack and architecture
807
+
808
+ ```
809
+ ┌─────────────────────────────────────────────────────────────────────────┐
810
+ │ <VelionOnboardingScreen config /> │
811
+ │ ┌──────────────────────────────────────────────────────────────────┐ │
812
+ │ │ ThemeProvider │ │
813
+ │ │ ┌────────────────────────────────────────────────────────────┐ │ │
814
+ │ │ │ ProgressBar (sticky top) │ │ │
815
+ │ │ │ ┌──────────────────────────────────────────────────────┐ │ │ │
816
+ │ │ │ │ Step slot (driven by orchestrator) │ │ │ │
817
+ │ │ │ │ HumanBasicInfo / EmailOtp / Documents / Liveness… │ │ │ │
818
+ │ │ │ └──────────────────────────────────────────────────────┘ │ │ │
819
+ │ │ │ LoadingOverlay / RetryDialog │ │ │
820
+ │ │ └────────────────────────────────────────────────────────────┘ │ │
821
+ │ └──────────────────────────────────────────────────────────────────┘ │
822
+ └────────────────────────────┬────────────────────────────────────────────┘
823
+ │
824
+ VelionOnboarding (orchestrator, plain TS)
825
+ │
826
+ ┌────────────────────┼────────────────────────────┐
827
+ │ │ │
828
+ ApiCaller (fetch) SSE (react-native-sse) Liveness WS (binary + HMAC)
829
+ ```
830
+
831
+ - **Types**: shipped inside the package (`lib/typescript/`). They mirror
832
+ the Onboarding backend contract.
833
+ - **Build**: `react-native-builder-bob` emits CommonJS, ESM and TypeScript
834
+ declarations.
835
+ - **No `Buffer`**: base64 helpers use `btoa` / `atob` globals (Hermes-
836
+ compatible).
837
+ - **HMAC-SHA256**: pure JavaScript via `@noble/hashes`, no native bridge.
838
+
839
+ ---
840
+
841
+ ## Local development
842
+
843
+ ```bash
844
+ git clone <repo>
845
+ cd onboarding-sdk-react-native
846
+ npm install
847
+ npm run typecheck # both workspaces
848
+ npm run build # build the SDK with bob → sdk/lib/
849
+
850
+ # Demo on a simulator (vision-camera requires prebuild, no Expo Go)
851
+ npm run prebuild
852
+ npm run ios # or npm run android
853
+ ```
854
+
855
+ The `example/` app consumes the SDK by path resolution (via the
856
+ `react-native` field in `package.json`); there is no need for `npm link` or
857
+ `npm pack` while iterating.
858
+
859
+ ---
860
+
861
+ ## Publishing
862
+
863
+ ```bash
864
+ cd sdk
865
+
866
+ # 1. Inspect what would be published
867
+ npm pack --dry-run
868
+
869
+ # 2. Publish
870
+ npm publish
871
+ ```
872
+
873
+ The `prepare` script runs `bob build` automatically, so a fresh build is
874
+ guaranteed before publishing.
875
+
876
+ To bump the version:
877
+
878
+ ```bash
879
+ cd sdk
880
+ npm version patch # or minor / major
881
+ ```
882
+
883
+ ---
884
+
885
+ ## License
886
+
887
+ Proprietary. This package is distributed under a commercial agreement with
888
+ Velion. Contact `dev@velion.la` for licensing terms.