@internetarchive/donation-form 0.5.18-alpha.1 → 0.5.18

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 (420) hide show
  1. package/LICENSE +661 -661
  2. package/README.md +115 -115
  3. package/dist/demo/braintree-endpoint-manager.d.ts +9 -9
  4. package/dist/demo/braintree-endpoint-manager.js +45 -45
  5. package/dist/demo/braintree-endpoint-manager.js.map +1 -1
  6. package/dist/demo/demo-analytics-handler.d.ts +17 -17
  7. package/dist/demo/demo-analytics-handler.js +13 -13
  8. package/dist/demo/demo-analytics-handler.js.map +1 -1
  9. package/dist/demo/submit-form-with.d.ts +7 -7
  10. package/dist/demo/submit-form-with.js +21 -21
  11. package/dist/demo/submit-form-with.js.map +1 -1
  12. package/dist/index.d.ts +7 -7
  13. package/dist/index.js +7 -7
  14. package/dist/index.js.map +1 -1
  15. package/dist/src/braintree-manager/braintree-interfaces.d.ts +147 -147
  16. package/dist/src/braintree-manager/braintree-interfaces.js +5 -5
  17. package/dist/src/braintree-manager/braintree-interfaces.js.map +1 -1
  18. package/dist/src/braintree-manager/braintree-manager.d.ts +124 -124
  19. package/dist/src/braintree-manager/braintree-manager.js +149 -149
  20. package/dist/src/braintree-manager/braintree-manager.js.map +1 -1
  21. package/dist/src/braintree-manager/payment-clients.d.ts +47 -47
  22. package/dist/src/braintree-manager/payment-clients.js +116 -116
  23. package/dist/src/braintree-manager/payment-clients.js.map +1 -1
  24. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-interface.d.ts +8 -8
  25. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-interface.js.map +1 -1
  26. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-delegate.d.ts +6 -6
  27. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-delegate.js.map +1 -1
  28. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-interface.d.ts +10 -10
  29. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-interface.js.map +1 -1
  30. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource.d.ts +21 -21
  31. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource.js +99 -99
  32. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource.js.map +1 -1
  33. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-manager.d.ts +10 -10
  34. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-manager.js +12 -12
  35. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-manager.js.map +1 -1
  36. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay.d.ts +20 -20
  37. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay.js +71 -71
  38. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay.js.map +1 -1
  39. package/dist/src/braintree-manager/payment-providers/credit-card/credit-card-interface.d.ts +16 -16
  40. package/dist/src/braintree-manager/payment-providers/credit-card/credit-card-interface.js.map +1 -1
  41. package/dist/src/braintree-manager/payment-providers/credit-card/credit-card.d.ts +29 -29
  42. package/dist/src/braintree-manager/payment-providers/credit-card/credit-card.js +99 -99
  43. package/dist/src/braintree-manager/payment-providers/credit-card/credit-card.js.map +1 -1
  44. package/dist/src/braintree-manager/payment-providers/credit-card/hosted-field-configuration.d.ts +11 -11
  45. package/dist/src/braintree-manager/payment-providers/credit-card/hosted-field-configuration.js +7 -7
  46. package/dist/src/braintree-manager/payment-providers/credit-card/hosted-field-configuration.js.map +1 -1
  47. package/dist/src/braintree-manager/payment-providers/credit-card/hosted-field-container.d.ts +34 -34
  48. package/dist/src/braintree-manager/payment-providers/credit-card/hosted-field-container.js +52 -52
  49. package/dist/src/braintree-manager/payment-providers/credit-card/hosted-field-container.js.map +1 -1
  50. package/dist/src/braintree-manager/payment-providers/google-pay-interface.d.ts +7 -7
  51. package/dist/src/braintree-manager/payment-providers/google-pay-interface.js.map +1 -1
  52. package/dist/src/braintree-manager/payment-providers/google-pay.d.ts +18 -18
  53. package/dist/src/braintree-manager/payment-providers/google-pay.js +40 -40
  54. package/dist/src/braintree-manager/payment-providers/google-pay.js.map +1 -1
  55. package/dist/src/braintree-manager/payment-providers/paypal/paypal-button-datasource.d.ts +145 -145
  56. package/dist/src/braintree-manager/payment-providers/paypal/paypal-button-datasource.js +60 -60
  57. package/dist/src/braintree-manager/payment-providers/paypal/paypal-button-datasource.js.map +1 -1
  58. package/dist/src/braintree-manager/payment-providers/paypal/paypal-interface.d.ts +11 -11
  59. package/dist/src/braintree-manager/payment-providers/paypal/paypal-interface.js.map +1 -1
  60. package/dist/src/braintree-manager/payment-providers/paypal/paypal.d.ts +23 -23
  61. package/dist/src/braintree-manager/payment-providers/paypal/paypal.js +46 -46
  62. package/dist/src/braintree-manager/payment-providers/paypal/paypal.js.map +1 -1
  63. package/dist/src/braintree-manager/payment-providers/venmo-interface.d.ts +6 -6
  64. package/dist/src/braintree-manager/payment-providers/venmo-interface.js.map +1 -1
  65. package/dist/src/braintree-manager/payment-providers/venmo.d.ts +28 -28
  66. package/dist/src/braintree-manager/payment-providers/venmo.js +50 -50
  67. package/dist/src/braintree-manager/payment-providers/venmo.js.map +1 -1
  68. package/dist/src/braintree-manager/payment-providers-interface.d.ts +16 -16
  69. package/dist/src/braintree-manager/payment-providers-interface.js.map +1 -1
  70. package/dist/src/braintree-manager/payment-providers.d.ts +45 -45
  71. package/dist/src/braintree-manager/payment-providers.js +105 -105
  72. package/dist/src/braintree-manager/payment-providers.js.map +1 -1
  73. package/dist/src/donation-form-controller.d.ts +116 -116
  74. package/dist/src/donation-form-controller.js +562 -562
  75. package/dist/src/donation-form-controller.js.map +1 -1
  76. package/dist/src/donation-form-error.d.ts +3 -3
  77. package/dist/src/donation-form-error.js +6 -6
  78. package/dist/src/donation-form-error.js.map +1 -1
  79. package/dist/src/donation-form.d.ts +120 -120
  80. package/dist/src/donation-form.js +530 -530
  81. package/dist/src/donation-form.js.map +1 -1
  82. package/dist/src/form-elements/badged-input.d.ts +32 -32
  83. package/dist/src/form-elements/badged-input.js +124 -124
  84. package/dist/src/form-elements/badged-input.js.map +1 -1
  85. package/dist/src/form-elements/contact-form/autocomplete-field-options.d.ts +1 -1
  86. package/dist/src/form-elements/contact-form/autocomplete-field-options.js.map +1 -1
  87. package/dist/src/form-elements/contact-form/contact-form.d.ts +53 -53
  88. package/dist/src/form-elements/contact-form/contact-form.js +428 -428
  89. package/dist/src/form-elements/contact-form/contact-form.js.map +1 -1
  90. package/dist/src/form-elements/contact-form/countries.d.ts +3 -3
  91. package/dist/src/form-elements/contact-form/countries.js +252 -252
  92. package/dist/src/form-elements/contact-form/countries.js.map +1 -1
  93. package/dist/src/form-elements/header/donation-form-header.d.ts +27 -27
  94. package/dist/src/form-elements/header/donation-form-header.js +97 -97
  95. package/dist/src/form-elements/header/donation-form-header.js.map +1 -1
  96. package/dist/src/form-elements/header/donation-summary.d.ts +11 -11
  97. package/dist/src/form-elements/header/donation-summary.js +57 -57
  98. package/dist/src/form-elements/header/donation-summary.js.map +1 -1
  99. package/dist/src/form-elements/payment-selector.d.ts +25 -25
  100. package/dist/src/form-elements/payment-selector.js +286 -286
  101. package/dist/src/form-elements/payment-selector.js.map +1 -1
  102. package/dist/src/form-elements/total-amount.d.ts +8 -8
  103. package/dist/src/form-elements/total-amount.js +47 -47
  104. package/dist/src/form-elements/total-amount.js.map +1 -1
  105. package/dist/src/modals/confirm-donation-modal-content.d.ts +31 -31
  106. package/dist/src/modals/confirm-donation-modal-content.js +168 -168
  107. package/dist/src/modals/confirm-donation-modal-content.js.map +1 -1
  108. package/dist/src/modals/error-modal-content.d.ts +14 -14
  109. package/dist/src/modals/error-modal-content.js +49 -49
  110. package/dist/src/modals/error-modal-content.js.map +1 -1
  111. package/dist/src/modals/upsell-modal-content.d.ts +32 -32
  112. package/dist/src/modals/upsell-modal-content.js +294 -294
  113. package/dist/src/modals/upsell-modal-content.js.map +1 -1
  114. package/dist/src/payment-flow-handlers/donation-flow-modal-manager.d.ts +181 -181
  115. package/dist/src/payment-flow-handlers/donation-flow-modal-manager.js +252 -252
  116. package/dist/src/payment-flow-handlers/donation-flow-modal-manager.js.map +1 -1
  117. package/dist/src/payment-flow-handlers/handlers/applepay-flow-handler.d.ts +21 -21
  118. package/dist/src/payment-flow-handlers/handlers/applepay-flow-handler.js +76 -76
  119. package/dist/src/payment-flow-handlers/handlers/applepay-flow-handler.js.map +1 -1
  120. package/dist/src/payment-flow-handlers/handlers/creditcard-flow-handler.d.ts +70 -70
  121. package/dist/src/payment-flow-handlers/handlers/creditcard-flow-handler.js +140 -140
  122. package/dist/src/payment-flow-handlers/handlers/creditcard-flow-handler.js.map +1 -1
  123. package/dist/src/payment-flow-handlers/handlers/googlepay-flow-handler.d.ts +22 -22
  124. package/dist/src/payment-flow-handlers/handlers/googlepay-flow-handler.js +74 -74
  125. package/dist/src/payment-flow-handlers/handlers/googlepay-flow-handler.js.map +1 -1
  126. package/dist/src/payment-flow-handlers/handlers/paypal-flow-handler.d.ts +52 -52
  127. package/dist/src/payment-flow-handlers/handlers/paypal-flow-handler.js +239 -239
  128. package/dist/src/payment-flow-handlers/handlers/paypal-flow-handler.js.map +1 -1
  129. package/dist/src/payment-flow-handlers/handlers/venmo-flow-handler.d.ts +30 -30
  130. package/dist/src/payment-flow-handlers/handlers/venmo-flow-handler.js +89 -89
  131. package/dist/src/payment-flow-handlers/handlers/venmo-flow-handler.js.map +1 -1
  132. package/dist/src/payment-flow-handlers/handlers/venmo-restoration-state-handler.d.ts +75 -75
  133. package/dist/src/payment-flow-handlers/handlers/venmo-restoration-state-handler.js +94 -94
  134. package/dist/src/payment-flow-handlers/handlers/venmo-restoration-state-handler.js.map +1 -1
  135. package/dist/src/payment-flow-handlers/payment-flow-handlers.d.ts +111 -111
  136. package/dist/src/payment-flow-handlers/payment-flow-handlers.js +107 -107
  137. package/dist/src/payment-flow-handlers/payment-flow-handlers.js.map +1 -1
  138. package/dist/src/recaptcha-manager/recaptcha-manager.d.ts +48 -48
  139. package/dist/src/recaptcha-manager/recaptcha-manager.js +88 -88
  140. package/dist/src/recaptcha-manager/recaptcha-manager.js.map +1 -1
  141. package/dist/src/util/promisedSleep.d.ts +1 -1
  142. package/dist/src/util/promisedSleep.js +3 -3
  143. package/dist/src/util/promisedSleep.js.map +1 -1
  144. package/dist/test/helpers/fillInContactForm.d.ts +2 -2
  145. package/dist/test/helpers/fillInContactForm.js +19 -19
  146. package/dist/test/helpers/fillInContactForm.js.map +1 -1
  147. package/dist/test/mocks/flow-handlers/individual-handlers/mock-applepay-flow-handler.d.ts +7 -7
  148. package/dist/test/mocks/flow-handlers/individual-handlers/mock-applepay-flow-handler.js +9 -9
  149. package/dist/test/mocks/flow-handlers/individual-handlers/mock-applepay-flow-handler.js.map +1 -1
  150. package/dist/test/mocks/flow-handlers/individual-handlers/mock-creditcard-flow-handler.d.ts +15 -15
  151. package/dist/test/mocks/flow-handlers/individual-handlers/mock-creditcard-flow-handler.js +32 -32
  152. package/dist/test/mocks/flow-handlers/individual-handlers/mock-creditcard-flow-handler.js.map +1 -1
  153. package/dist/test/mocks/flow-handlers/individual-handlers/mock-googlepay-flow-handler.d.ts +9 -9
  154. package/dist/test/mocks/flow-handlers/individual-handlers/mock-googlepay-flow-handler.js +15 -15
  155. package/dist/test/mocks/flow-handlers/individual-handlers/mock-googlepay-flow-handler.js.map +1 -1
  156. package/dist/test/mocks/flow-handlers/individual-handlers/mock-paypal-flow-handler.d.ts +15 -15
  157. package/dist/test/mocks/flow-handlers/individual-handlers/mock-paypal-flow-handler.js +30 -30
  158. package/dist/test/mocks/flow-handlers/individual-handlers/mock-paypal-flow-handler.js.map +1 -1
  159. package/dist/test/mocks/flow-handlers/individual-handlers/mock-venmo-flow-handler.d.ts +9 -9
  160. package/dist/test/mocks/flow-handlers/individual-handlers/mock-venmo-flow-handler.js +17 -17
  161. package/dist/test/mocks/flow-handlers/individual-handlers/mock-venmo-flow-handler.js.map +1 -1
  162. package/dist/test/mocks/flow-handlers/mock-payment-flow-handlers.d.ts +30 -30
  163. package/dist/test/mocks/flow-handlers/mock-payment-flow-handlers.js +29 -29
  164. package/dist/test/mocks/flow-handlers/mock-payment-flow-handlers.js.map +1 -1
  165. package/dist/test/mocks/mock-analytics-handler.d.ts +8 -0
  166. package/dist/test/mocks/mock-analytics-handler.js +10 -0
  167. package/dist/test/mocks/mock-analytics-handler.js.map +1 -0
  168. package/dist/test/mocks/mock-braintree-manager.d.ts +45 -45
  169. package/dist/test/mocks/mock-braintree-manager.js +71 -71
  170. package/dist/test/mocks/mock-braintree-manager.js.map +1 -1
  171. package/dist/test/mocks/mock-donation-info.d.ts +4 -4
  172. package/dist/test/mocks/mock-donation-info.js +10 -10
  173. package/dist/test/mocks/mock-donation-info.js.map +1 -1
  174. package/dist/test/mocks/mock-endpoint-manager.d.ts +12 -12
  175. package/dist/test/mocks/mock-endpoint-manager.js +19 -19
  176. package/dist/test/mocks/mock-endpoint-manager.js.map +1 -1
  177. package/dist/test/mocks/mock-hosted-fields-config.d.ts +4 -4
  178. package/dist/test/mocks/mock-hosted-fields-config.js +37 -37
  179. package/dist/test/mocks/mock-hosted-fields-config.js.map +1 -1
  180. package/dist/test/mocks/mock-hosted-fields-container.d.ts +13 -13
  181. package/dist/test/mocks/mock-hosted-fields-container.js +27 -27
  182. package/dist/test/mocks/mock-hosted-fields-container.js.map +1 -1
  183. package/dist/test/mocks/mock-lazy-loader.d.ts +15 -15
  184. package/dist/test/mocks/mock-lazy-loader.js +20 -20
  185. package/dist/test/mocks/mock-lazy-loader.js.map +1 -1
  186. package/dist/test/mocks/mock-modal-manager.d.ts +17 -17
  187. package/dist/test/mocks/mock-modal-manager.js +26 -26
  188. package/dist/test/mocks/mock-modal-manager.js.map +1 -1
  189. package/dist/test/mocks/mock-payment-clients.d.ts +29 -29
  190. package/dist/test/mocks/mock-payment-clients.js +78 -78
  191. package/dist/test/mocks/mock-payment-clients.js.map +1 -1
  192. package/dist/test/mocks/mock-paypal-button-renderer.d.ts +5 -5
  193. package/dist/test/mocks/mock-paypal-button-renderer.js +6 -6
  194. package/dist/test/mocks/mock-paypal-button-renderer.js.map +1 -1
  195. package/dist/test/mocks/mock-recaptcha-manager.d.ts +7 -7
  196. package/dist/test/mocks/mock-recaptcha-manager.js +14 -14
  197. package/dist/test/mocks/mock-recaptcha-manager.js.map +1 -1
  198. package/dist/test/mocks/models/mock-billing-info.d.ts +2 -2
  199. package/dist/test/mocks/models/mock-billing-info.js +9 -9
  200. package/dist/test/mocks/models/mock-billing-info.js.map +1 -1
  201. package/dist/test/mocks/models/mock-custom-fields.d.ts +2 -2
  202. package/dist/test/mocks/models/mock-custom-fields.js +7 -7
  203. package/dist/test/mocks/models/mock-custom-fields.js.map +1 -1
  204. package/dist/test/mocks/models/mock-customer-info.d.ts +2 -2
  205. package/dist/test/mocks/models/mock-customer-info.js +6 -6
  206. package/dist/test/mocks/models/mock-customer-info.js.map +1 -1
  207. package/dist/test/mocks/models/mock-donation-request.d.ts +2 -2
  208. package/dist/test/mocks/models/mock-donation-request.js +18 -18
  209. package/dist/test/mocks/models/mock-donation-request.js.map +1 -1
  210. package/dist/test/mocks/models/mock-success-response.d.ts +2 -2
  211. package/dist/test/mocks/models/mock-success-response.js +14 -14
  212. package/dist/test/mocks/models/mock-success-response.js.map +1 -1
  213. package/dist/test/mocks/payment-clients/mock-applepay-client.d.ts +21 -21
  214. package/dist/test/mocks/payment-clients/mock-applepay-client.js +72 -72
  215. package/dist/test/mocks/payment-clients/mock-applepay-client.js.map +1 -1
  216. package/dist/test/mocks/payment-clients/mock-applepay-payment.d.ts +6 -6
  217. package/dist/test/mocks/payment-clients/mock-applepay-payment.js +42 -42
  218. package/dist/test/mocks/payment-clients/mock-applepay-payment.js.map +1 -1
  219. package/dist/test/mocks/payment-clients/mock-applepay-paymentauthorizedevent.d.ts +22 -22
  220. package/dist/test/mocks/payment-clients/mock-applepay-paymentauthorizedevent.js +35 -35
  221. package/dist/test/mocks/payment-clients/mock-applepay-paymentauthorizedevent.js.map +1 -1
  222. package/dist/test/mocks/payment-clients/mock-applepay-session.d.ts +30 -30
  223. package/dist/test/mocks/payment-clients/mock-applepay-session.js +52 -52
  224. package/dist/test/mocks/payment-clients/mock-applepay-session.js.map +1 -1
  225. package/dist/test/mocks/payment-clients/mock-applepay-sessionmanager.d.ts +10 -10
  226. package/dist/test/mocks/payment-clients/mock-applepay-sessionmanager.js +12 -12
  227. package/dist/test/mocks/payment-clients/mock-applepay-sessionmanager.js.map +1 -1
  228. package/dist/test/mocks/payment-clients/mock-applepay-validatemerchantevent.d.ts +22 -22
  229. package/dist/test/mocks/payment-clients/mock-applepay-validatemerchantevent.js +34 -34
  230. package/dist/test/mocks/payment-clients/mock-applepay-validatemerchantevent.js.map +1 -1
  231. package/dist/test/mocks/payment-clients/mock-braintree-client.d.ts +14 -14
  232. package/dist/test/mocks/payment-clients/mock-braintree-client.js +19 -19
  233. package/dist/test/mocks/payment-clients/mock-braintree-client.js.map +1 -1
  234. package/dist/test/mocks/payment-clients/mock-data-collector.d.ts +11 -11
  235. package/dist/test/mocks/payment-clients/mock-data-collector.js +17 -17
  236. package/dist/test/mocks/payment-clients/mock-data-collector.js.map +1 -1
  237. package/dist/test/mocks/payment-clients/mock-googlepay-client.d.ts +22 -22
  238. package/dist/test/mocks/payment-clients/mock-googlepay-client.js +42 -42
  239. package/dist/test/mocks/payment-clients/mock-googlepay-client.js.map +1 -1
  240. package/dist/test/mocks/payment-clients/mock-googlepay-library.d.ts +10 -10
  241. package/dist/test/mocks/payment-clients/mock-googlepay-library.js +22 -22
  242. package/dist/test/mocks/payment-clients/mock-googlepay-library.js.map +1 -1
  243. package/dist/test/mocks/payment-clients/mock-grecaptcha.d.ts +23 -23
  244. package/dist/test/mocks/payment-clients/mock-grecaptcha.js +62 -62
  245. package/dist/test/mocks/payment-clients/mock-grecaptcha.js.map +1 -1
  246. package/dist/test/mocks/payment-clients/mock-hostedfields-client.d.ts +33 -33
  247. package/dist/test/mocks/payment-clients/mock-hostedfields-client.js +54 -54
  248. package/dist/test/mocks/payment-clients/mock-hostedfields-client.js.map +1 -1
  249. package/dist/test/mocks/payment-clients/mock-hostedfieldstateobject-generator.d.ts +1 -1
  250. package/dist/test/mocks/payment-clients/mock-hostedfieldstateobject-generator.js +50 -50
  251. package/dist/test/mocks/payment-clients/mock-hostedfieldstateobject-generator.js.map +1 -1
  252. package/dist/test/mocks/payment-clients/mock-hostedfieldtokenizepayload.d.ts +1 -1
  253. package/dist/test/mocks/payment-clients/mock-hostedfieldtokenizepayload.js +13 -13
  254. package/dist/test/mocks/payment-clients/mock-hostedfieldtokenizepayload.js.map +1 -1
  255. package/dist/test/mocks/payment-clients/mock-paypal-client.d.ts +23 -23
  256. package/dist/test/mocks/payment-clients/mock-paypal-client.js +62 -62
  257. package/dist/test/mocks/payment-clients/mock-paypal-client.js.map +1 -1
  258. package/dist/test/mocks/payment-clients/mock-paypal-library.d.ts +4 -4
  259. package/dist/test/mocks/payment-clients/mock-paypal-library.js +9 -9
  260. package/dist/test/mocks/payment-clients/mock-paypal-library.js.map +1 -1
  261. package/dist/test/mocks/payment-clients/mock-venmo-client.d.ts +22 -22
  262. package/dist/test/mocks/payment-clients/mock-venmo-client.js +36 -36
  263. package/dist/test/mocks/payment-clients/mock-venmo-client.js.map +1 -1
  264. package/dist/test/mocks/payment-providers/individual-providers/mock-applepay-datasource-delegate.d.ts +10 -10
  265. package/dist/test/mocks/payment-providers/individual-providers/mock-applepay-datasource-delegate.js +14 -14
  266. package/dist/test/mocks/payment-providers/individual-providers/mock-applepay-datasource-delegate.js.map +1 -1
  267. package/dist/test/mocks/payment-providers/individual-providers/mock-applepay-handler.d.ts +9 -9
  268. package/dist/test/mocks/payment-providers/individual-providers/mock-applepay-handler.js +19 -19
  269. package/dist/test/mocks/payment-providers/individual-providers/mock-applepay-handler.js.map +1 -1
  270. package/dist/test/mocks/payment-providers/individual-providers/mock-creditcard-handler.d.ts +18 -18
  271. package/dist/test/mocks/payment-providers/individual-providers/mock-creditcard-handler.js +41 -41
  272. package/dist/test/mocks/payment-providers/individual-providers/mock-creditcard-handler.js.map +1 -1
  273. package/dist/test/mocks/payment-providers/individual-providers/mock-googlepay-handler.d.ts +8 -8
  274. package/dist/test/mocks/payment-providers/individual-providers/mock-googlepay-handler.js +16 -16
  275. package/dist/test/mocks/payment-providers/individual-providers/mock-googlepay-handler.js.map +1 -1
  276. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-button-datasource-delegate.d.ts +28 -28
  277. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-button-datasource-delegate.js +52 -52
  278. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-button-datasource-delegate.js.map +1 -1
  279. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-button-datasource.d.ts +11 -11
  280. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-button-datasource.js +37 -37
  281. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-button-datasource.js.map +1 -1
  282. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-handler.d.ts +12 -12
  283. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-handler.js +15 -15
  284. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-handler.js.map +1 -1
  285. package/dist/test/mocks/payment-providers/individual-providers/mock-venmo-handler.d.ts +7 -7
  286. package/dist/test/mocks/payment-providers/individual-providers/mock-venmo-handler.js +22 -22
  287. package/dist/test/mocks/payment-providers/individual-providers/mock-venmo-handler.js.map +1 -1
  288. package/dist/test/mocks/payment-providers/mock-payment-providers.d.ts +21 -21
  289. package/dist/test/mocks/payment-providers/mock-payment-providers.js +45 -45
  290. package/dist/test/mocks/payment-providers/mock-payment-providers.js.map +1 -1
  291. package/dist/test/tests/braintree-manager.test.d.ts +1 -1
  292. package/dist/test/tests/braintree-manager.test.js +166 -166
  293. package/dist/test/tests/braintree-manager.test.js.map +1 -1
  294. package/dist/test/tests/donation-form-controller.test.d.ts +1 -1
  295. package/dist/test/tests/donation-form-controller.test.js +188 -188
  296. package/dist/test/tests/donation-form-controller.test.js.map +1 -1
  297. package/dist/test/tests/donation-form.test.d.ts +1 -1
  298. package/dist/test/tests/donation-form.test.js +109 -109
  299. package/dist/test/tests/donation-form.test.js.map +1 -1
  300. package/dist/test/tests/flow-handlers/donation-flow-modal-manager.test.d.ts +1 -1
  301. package/dist/test/tests/flow-handlers/donation-flow-modal-manager.test.js +216 -216
  302. package/dist/test/tests/flow-handlers/donation-flow-modal-manager.test.js.map +1 -1
  303. package/dist/test/tests/form-elements/donation-summary.test.d.ts +1 -1
  304. package/dist/test/tests/form-elements/donation-summary.test.js +36 -36
  305. package/dist/test/tests/form-elements/donation-summary.test.js.map +1 -1
  306. package/dist/test/tests/form-elements/payment-selector.test.d.ts +1 -1
  307. package/dist/test/tests/form-elements/payment-selector.test.js +69 -69
  308. package/dist/test/tests/form-elements/payment-selector.test.js.map +1 -1
  309. package/dist/test/tests/modals/error-modal-content.test.d.ts +1 -1
  310. package/dist/test/tests/modals/error-modal-content.test.js +14 -14
  311. package/dist/test/tests/modals/error-modal-content.test.js.map +1 -1
  312. package/dist/test/tests/modals/upsell-modal-content.test.d.ts +1 -1
  313. package/dist/test/tests/modals/upsell-modal-content.test.js +163 -163
  314. package/dist/test/tests/modals/upsell-modal-content.test.js.map +1 -1
  315. package/dist/test/tests/models/donation-payment-info.test.d.ts +1 -1
  316. package/dist/test/tests/models/donation-payment-info.test.js +74 -74
  317. package/dist/test/tests/models/donation-payment-info.test.js.map +1 -1
  318. package/dist/test/tests/payment-clients.test.d.ts +1 -1
  319. package/dist/test/tests/payment-clients.test.js +130 -130
  320. package/dist/test/tests/payment-clients.test.js.map +1 -1
  321. package/dist/test/tests/payment-providers/applepay-sessiondatasource.test.d.ts +1 -1
  322. package/dist/test/tests/payment-providers/applepay-sessiondatasource.test.js +160 -160
  323. package/dist/test/tests/payment-providers/applepay-sessiondatasource.test.js.map +1 -1
  324. package/dist/test/tests/payment-providers/applepay-sessionmanager.test.d.ts +1 -1
  325. package/dist/test/tests/payment-providers/applepay-sessionmanager.test.js +36 -36
  326. package/dist/test/tests/payment-providers/applepay-sessionmanager.test.js.map +1 -1
  327. package/dist/test/tests/payment-providers/applepay.test.d.ts +1 -1
  328. package/dist/test/tests/payment-providers/applepay.test.js +78 -78
  329. package/dist/test/tests/payment-providers/applepay.test.js.map +1 -1
  330. package/dist/test/tests/payment-providers/creditcard.test.d.ts +1 -1
  331. package/dist/test/tests/payment-providers/creditcard.test.js +190 -190
  332. package/dist/test/tests/payment-providers/creditcard.test.js.map +1 -1
  333. package/dist/test/tests/payment-providers/googlepay.test.d.ts +1 -1
  334. package/dist/test/tests/payment-providers/googlepay.test.js +48 -48
  335. package/dist/test/tests/payment-providers/googlepay.test.js.map +1 -1
  336. package/dist/test/tests/payment-providers/payment-providers.test.d.ts +1 -1
  337. package/dist/test/tests/payment-providers/payment-providers.test.js +38 -38
  338. package/dist/test/tests/payment-providers/payment-providers.test.js.map +1 -1
  339. package/dist/test/tests/payment-providers/paypal-button-datasource.test.d.ts +1 -1
  340. package/dist/test/tests/payment-providers/paypal-button-datasource.test.js +162 -162
  341. package/dist/test/tests/payment-providers/paypal-button-datasource.test.js.map +1 -1
  342. package/dist/test/tests/payment-providers/paypal.test.d.ts +1 -1
  343. package/dist/test/tests/payment-providers/paypal.test.js +38 -38
  344. package/dist/test/tests/payment-providers/paypal.test.js.map +1 -1
  345. package/dist/test/tests/payment-providers/venmo.test.d.ts +1 -1
  346. package/dist/test/tests/payment-providers/venmo.test.js +77 -77
  347. package/dist/test/tests/payment-providers/venmo.test.js.map +1 -1
  348. package/dist/test/tests/recaptcha-manager.test.d.ts +1 -1
  349. package/dist/test/tests/recaptcha-manager.test.js +70 -70
  350. package/dist/test/tests/recaptcha-manager.test.js.map +1 -1
  351. package/package.json +101 -101
  352. package/src/@types/analytics-handler/index.d.ts +8 -8
  353. package/src/@types/braintree-web/LICENSE +21 -21
  354. package/src/@types/braintree-web/index.d.ts +93 -93
  355. package/src/@types/braintree-web/modules/american-express.d.ts +50 -50
  356. package/src/@types/braintree-web/modules/apple-pay.d.ts +213 -213
  357. package/src/@types/braintree-web/modules/client.d.ts +103 -103
  358. package/src/@types/braintree-web/modules/core.d.ts +34 -34
  359. package/src/@types/braintree-web/modules/data-collector.d.ts +13 -13
  360. package/src/@types/braintree-web/modules/google-payment.d.ts +269 -269
  361. package/src/@types/braintree-web/modules/hosted-fields.d.ts +366 -366
  362. package/src/@types/braintree-web/modules/paypal-checkout.d.ts +262 -262
  363. package/src/@types/braintree-web/modules/paypal.d.ts +177 -177
  364. package/src/@types/braintree-web/modules/three-d-secure.d.ts +141 -141
  365. package/src/@types/braintree-web/modules/unionpay.d.ts +224 -224
  366. package/src/@types/braintree-web/modules/us-bank-account.d.ts +81 -81
  367. package/src/@types/braintree-web/modules/venmo.d.ts +110 -110
  368. package/src/@types/braintree-web/package.json +64 -64
  369. package/src/@types/paypal-checkout-components/LICENSE +21 -21
  370. package/src/@types/paypal-checkout-components/index.d.ts +67 -67
  371. package/src/@types/paypal-checkout-components/modules/button.d.ts +50 -50
  372. package/src/@types/paypal-checkout-components/modules/callback-data.d.ts +244 -244
  373. package/src/@types/paypal-checkout-components/modules/configuration.d.ts +114 -114
  374. package/src/@types/paypal-checkout-components/package.json +58 -58
  375. package/src/braintree-manager/braintree-interfaces.ts +172 -172
  376. package/src/braintree-manager/braintree-manager.ts +283 -283
  377. package/src/braintree-manager/payment-clients.ts +148 -148
  378. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-interface.ts +13 -13
  379. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-delegate.ts +8 -8
  380. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-interface.ts +10 -10
  381. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource.ts +119 -119
  382. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-manager.ts +21 -21
  383. package/src/braintree-manager/payment-providers/apple-pay/apple-pay.ts +98 -98
  384. package/src/braintree-manager/payment-providers/credit-card/credit-card-interface.ts +21 -21
  385. package/src/braintree-manager/payment-providers/credit-card/credit-card.ts +130 -130
  386. package/src/braintree-manager/payment-providers/credit-card/hosted-field-configuration.ts +19 -19
  387. package/src/braintree-manager/payment-providers/credit-card/hosted-field-container.ts +85 -85
  388. package/src/braintree-manager/payment-providers/google-pay-interface.ts +8 -8
  389. package/src/braintree-manager/payment-providers/google-pay.ts +59 -59
  390. package/src/braintree-manager/payment-providers/paypal/paypal-button-datasource.ts +218 -218
  391. package/src/braintree-manager/payment-providers/paypal/paypal-interface.ts +13 -13
  392. package/src/braintree-manager/payment-providers/paypal/paypal.ts +78 -78
  393. package/src/braintree-manager/payment-providers/venmo-interface.ts +8 -8
  394. package/src/braintree-manager/payment-providers/venmo.ts +67 -67
  395. package/src/braintree-manager/payment-providers-interface.ts +25 -25
  396. package/src/braintree-manager/payment-providers.ts +147 -147
  397. package/src/donation-form-controller.ts +619 -619
  398. package/src/donation-form-error.ts +6 -6
  399. package/src/donation-form.ts +566 -566
  400. package/src/form-elements/badged-input.ts +113 -113
  401. package/src/form-elements/contact-form/autocomplete-field-options.ts +63 -63
  402. package/src/form-elements/contact-form/contact-form.ts +427 -427
  403. package/src/form-elements/contact-form/countries.ts +252 -252
  404. package/src/form-elements/header/donation-form-header.ts +100 -100
  405. package/src/form-elements/header/donation-summary.ts +61 -61
  406. package/src/form-elements/payment-selector.ts +293 -293
  407. package/src/form-elements/total-amount.ts +46 -46
  408. package/src/modals/confirm-donation-modal-content.ts +160 -160
  409. package/src/modals/error-modal-content.ts +48 -48
  410. package/src/modals/upsell-modal-content.ts +294 -294
  411. package/src/payment-flow-handlers/donation-flow-modal-manager.ts +450 -450
  412. package/src/payment-flow-handlers/handlers/applepay-flow-handler.ts +108 -108
  413. package/src/payment-flow-handlers/handlers/creditcard-flow-handler.ts +231 -231
  414. package/src/payment-flow-handlers/handlers/googlepay-flow-handler.ts +113 -113
  415. package/src/payment-flow-handlers/handlers/paypal-flow-handler.ts +332 -332
  416. package/src/payment-flow-handlers/handlers/venmo-flow-handler.ts +118 -118
  417. package/src/payment-flow-handlers/handlers/venmo-restoration-state-handler.ts +127 -127
  418. package/src/payment-flow-handlers/payment-flow-handlers.ts +218 -218
  419. package/src/recaptcha-manager/recaptcha-manager.ts +123 -123
  420. package/src/util/promisedSleep.ts +3 -3
@@ -1,118 +1,118 @@
1
- import { BraintreeManagerInterface } from '../../braintree-manager/braintree-interfaces';
2
- import {
3
- DonorContactInfo,
4
- DonationPaymentInfo,
5
- PaymentProvider,
6
- } from '@internetarchive/donation-form-data-models';
7
- import {
8
- VenmoRestorationStateHandlerInterface,
9
- VenmoRestorationStateHandler,
10
- } from './venmo-restoration-state-handler';
11
- import { DonationFlowModalManagerInterface } from '../donation-flow-modal-manager';
12
-
13
- export interface VenmoFlowHandlerInterface {
14
- startup(): Promise<void>;
15
- paymentInitiated(contactInfo: DonorContactInfo, donationInfo: DonationPaymentInfo): Promise<void>;
16
- }
17
-
18
- export class VenmoFlowHandler implements VenmoFlowHandlerInterface {
19
- private donationFlowModalManager: DonationFlowModalManagerInterface;
20
-
21
- private braintreeManager: BraintreeManagerInterface;
22
-
23
- private restorationStateHandler: VenmoRestorationStateHandlerInterface;
24
-
25
- constructor(options: {
26
- braintreeManager: BraintreeManagerInterface;
27
- donationFlowModalManager: DonationFlowModalManagerInterface;
28
- restorationStateHandler?: VenmoRestorationStateHandlerInterface;
29
- }) {
30
- this.braintreeManager = options.braintreeManager;
31
- this.donationFlowModalManager = options.donationFlowModalManager;
32
- this.restorationStateHandler =
33
- options.restorationStateHandler ?? new VenmoRestorationStateHandler();
34
- }
35
-
36
- /**
37
- * Check if we have any results from Venmo on startup.
38
- *
39
- * This happens if the app redirects to us in a new tab so we can resume the session.
40
- *
41
- * @returns {Promise<void>}
42
- * @memberof VenmoFlowHandler
43
- */
44
- async startup(): Promise<void> {
45
- const handler = await this.braintreeManager.paymentProviders.venmoHandler.get();
46
- const instance = await handler?.instance.get();
47
- if (instance?.hasTokenizationResult()) {
48
- // if we get redirected back from venmo in a different tab, we need to restore the data
49
- // that was persisted when the payment was initiated
50
- const restoredInfo = await this.restorationStateHandler.getRestorationState();
51
- if (restoredInfo) {
52
- this.paymentInitiated(restoredInfo.contactInfo, restoredInfo.donationInfo);
53
- } else {
54
- console.error('no restoration info');
55
- this.donationFlowModalManager.showErrorModal({
56
- message: 'Error restoring donation session',
57
- });
58
- }
59
- }
60
- }
61
-
62
- // VenmoFlowHandlerInterface conformance
63
- async paymentInitiated(
64
- contactInfo: DonorContactInfo,
65
- donationInfo: DonationPaymentInfo,
66
- ): Promise<void> {
67
- // if we get redirected back from venmo in a different tab, we need to restore the data
68
- // that was persisted when the payment was initiated so persist it here
69
- this.restorationStateHandler.persistState(contactInfo, donationInfo);
70
-
71
- try {
72
- const handler = await this.braintreeManager.paymentProviders.venmoHandler.get();
73
- const result = await handler?.startPayment();
74
- if (!result) {
75
- this.restorationStateHandler.clearState();
76
- this.donationFlowModalManager.showErrorModal({
77
- message: 'Error setting up the donation',
78
- });
79
- return;
80
- }
81
- this.handleTokenizationResult(result, contactInfo, donationInfo);
82
- } catch (tokenizeError) {
83
- this.restorationStateHandler.clearState();
84
- this.handleTokenizationError(tokenizeError);
85
- this.donationFlowModalManager.showErrorModal({
86
- message: `There was a problem loading your donation information. Please try again.`,
87
- });
88
- }
89
- }
90
-
91
- private async handleTokenizationResult(
92
- payload: braintree.VenmoTokenizePayload,
93
- contactInfo: DonorContactInfo,
94
- donationInfo: DonationPaymentInfo,
95
- ): Promise<void> {
96
- this.restorationStateHandler.clearState();
97
-
98
- this.donationFlowModalManager.startDonationSubmissionFlow({
99
- nonce: payload.nonce,
100
- paymentProvider: PaymentProvider.Venmo,
101
- donationInfo: donationInfo,
102
- customerInfo: contactInfo.customer,
103
- billingInfo: contactInfo.billing,
104
- });
105
- }
106
-
107
- private handleTokenizationError(tokenizeError: braintree.BraintreeError): void {
108
- // Handle flow errors or premature flow closure
109
- switch (tokenizeError.code) {
110
- case 'VENMO_APP_CANCELED':
111
- break;
112
- case 'VENMO_CANCELED':
113
- break;
114
- default:
115
- console.error('Error!', tokenizeError);
116
- }
117
- }
118
- }
1
+ import { BraintreeManagerInterface } from '../../braintree-manager/braintree-interfaces';
2
+ import {
3
+ DonorContactInfo,
4
+ DonationPaymentInfo,
5
+ PaymentProvider,
6
+ } from '@internetarchive/donation-form-data-models';
7
+ import {
8
+ VenmoRestorationStateHandlerInterface,
9
+ VenmoRestorationStateHandler,
10
+ } from './venmo-restoration-state-handler';
11
+ import { DonationFlowModalManagerInterface } from '../donation-flow-modal-manager';
12
+
13
+ export interface VenmoFlowHandlerInterface {
14
+ startup(): Promise<void>;
15
+ paymentInitiated(contactInfo: DonorContactInfo, donationInfo: DonationPaymentInfo): Promise<void>;
16
+ }
17
+
18
+ export class VenmoFlowHandler implements VenmoFlowHandlerInterface {
19
+ private donationFlowModalManager: DonationFlowModalManagerInterface;
20
+
21
+ private braintreeManager: BraintreeManagerInterface;
22
+
23
+ private restorationStateHandler: VenmoRestorationStateHandlerInterface;
24
+
25
+ constructor(options: {
26
+ braintreeManager: BraintreeManagerInterface;
27
+ donationFlowModalManager: DonationFlowModalManagerInterface;
28
+ restorationStateHandler?: VenmoRestorationStateHandlerInterface;
29
+ }) {
30
+ this.braintreeManager = options.braintreeManager;
31
+ this.donationFlowModalManager = options.donationFlowModalManager;
32
+ this.restorationStateHandler =
33
+ options.restorationStateHandler ?? new VenmoRestorationStateHandler();
34
+ }
35
+
36
+ /**
37
+ * Check if we have any results from Venmo on startup.
38
+ *
39
+ * This happens if the app redirects to us in a new tab so we can resume the session.
40
+ *
41
+ * @returns {Promise<void>}
42
+ * @memberof VenmoFlowHandler
43
+ */
44
+ async startup(): Promise<void> {
45
+ const handler = await this.braintreeManager.paymentProviders.venmoHandler.get();
46
+ const instance = await handler?.instance.get();
47
+ if (instance?.hasTokenizationResult()) {
48
+ // if we get redirected back from venmo in a different tab, we need to restore the data
49
+ // that was persisted when the payment was initiated
50
+ const restoredInfo = await this.restorationStateHandler.getRestorationState();
51
+ if (restoredInfo) {
52
+ this.paymentInitiated(restoredInfo.contactInfo, restoredInfo.donationInfo);
53
+ } else {
54
+ console.error('no restoration info');
55
+ this.donationFlowModalManager.showErrorModal({
56
+ message: 'Error restoring donation session',
57
+ });
58
+ }
59
+ }
60
+ }
61
+
62
+ // VenmoFlowHandlerInterface conformance
63
+ async paymentInitiated(
64
+ contactInfo: DonorContactInfo,
65
+ donationInfo: DonationPaymentInfo,
66
+ ): Promise<void> {
67
+ // if we get redirected back from venmo in a different tab, we need to restore the data
68
+ // that was persisted when the payment was initiated so persist it here
69
+ this.restorationStateHandler.persistState(contactInfo, donationInfo);
70
+
71
+ try {
72
+ const handler = await this.braintreeManager.paymentProviders.venmoHandler.get();
73
+ const result = await handler?.startPayment();
74
+ if (!result) {
75
+ this.restorationStateHandler.clearState();
76
+ this.donationFlowModalManager.showErrorModal({
77
+ message: 'Error setting up the donation',
78
+ });
79
+ return;
80
+ }
81
+ this.handleTokenizationResult(result, contactInfo, donationInfo);
82
+ } catch (tokenizeError) {
83
+ this.restorationStateHandler.clearState();
84
+ this.handleTokenizationError(tokenizeError);
85
+ this.donationFlowModalManager.showErrorModal({
86
+ message: `There was a problem loading your donation information. Please try again.`,
87
+ });
88
+ }
89
+ }
90
+
91
+ private async handleTokenizationResult(
92
+ payload: braintree.VenmoTokenizePayload,
93
+ contactInfo: DonorContactInfo,
94
+ donationInfo: DonationPaymentInfo,
95
+ ): Promise<void> {
96
+ this.restorationStateHandler.clearState();
97
+
98
+ this.donationFlowModalManager.startDonationSubmissionFlow({
99
+ nonce: payload.nonce,
100
+ paymentProvider: PaymentProvider.Venmo,
101
+ donationInfo: donationInfo,
102
+ customerInfo: contactInfo.customer,
103
+ billingInfo: contactInfo.billing,
104
+ });
105
+ }
106
+
107
+ private handleTokenizationError(tokenizeError: braintree.BraintreeError): void {
108
+ // Handle flow errors or premature flow closure
109
+ switch (tokenizeError.code) {
110
+ case 'VENMO_APP_CANCELED':
111
+ break;
112
+ case 'VENMO_CANCELED':
113
+ break;
114
+ default:
115
+ console.error('Error!', tokenizeError);
116
+ }
117
+ }
118
+ }
@@ -1,127 +1,127 @@
1
- import { DonorContactInfo, DonationPaymentInfo } from '@internetarchive/donation-form-data-models';
2
-
3
- export interface VenmoRestorationStateHandlerInterface {
4
- /**
5
- * Persist the session state
6
- *
7
- * @param {DonorContactInfo} contactInfo
8
- * @param {DonationPaymentInfo} donationInfo
9
- * @memberof VenmoRestorationStateHandlerInterface
10
- */
11
- persistState(contactInfo: DonorContactInfo, donationInfo: DonationPaymentInfo): void;
12
-
13
- /**
14
- * Get the session restoration state
15
- *
16
- * @returns {(Promise<VenmoRestorationState | undefined>)}
17
- * @memberof VenmoRestorationStateHandlerInterface
18
- */
19
- getRestorationState(): Promise<VenmoRestorationState | undefined>;
20
-
21
- /**
22
- * Clear the restoration state
23
- *
24
- * @memberof VenmoRestorationStateHandlerInterface
25
- */
26
- clearState(): void;
27
- }
28
-
29
- /**
30
- * Structure to store the session restoration state
31
- *
32
- * @export
33
- * @class VenmoRestorationState
34
- */
35
- export class VenmoRestorationState {
36
- contactInfo: DonorContactInfo;
37
- donationInfo: DonationPaymentInfo;
38
-
39
- // TODO: Add restoration state expiration
40
- constructor(params: { contactInfo: DonorContactInfo; donationInfo: DonationPaymentInfo }) {
41
- this.contactInfo = params.contactInfo;
42
- this.donationInfo = params.donationInfo;
43
- }
44
- }
45
-
46
- /**
47
- * The VenmoRestorationStateHandler is used to persist and restore a Venmo checkout session.
48
- *
49
- * Venmo takes the user out of the web browser and into their app to authorize the purchase.
50
- * It then redirects the user back to the website to finish the transaction. The problem is
51
- * it may open a new browser tab so it's like starting a new session. We need to persist
52
- * the session information from the start of the Venmo session and restore it when it resumes.
53
- *
54
- * This class stores the session information in localStorage when the Venmo session is started
55
- * and retrieves it when the session is restored.
56
- *
57
- * @export
58
- * @class VenmoRestorationStateHandler
59
- * @implements {VenmoRestorationStateHandlerInterface}
60
- */
61
- export class VenmoRestorationStateHandler implements VenmoRestorationStateHandlerInterface {
62
- private persistanceKey = 'venmoRestorationStateInfo';
63
-
64
- private storageSystem?: Storage;
65
-
66
- constructor(options?: { storageSystem?: Storage }) {
67
- if (options?.storageSystem) {
68
- this.storageSystem = options.storageSystem;
69
- } else if (this.storageSystemAvailable(localStorage)) {
70
- this.storageSystem = localStorage;
71
- } else if (this.storageSystemAvailable(sessionStorage)) {
72
- this.storageSystem = sessionStorage;
73
- }
74
- }
75
-
76
- /** @inheritdoc */
77
- clearState(): void {
78
- this.storageSystem?.removeItem(this.persistanceKey);
79
- }
80
-
81
- /** @inheritdoc */
82
- persistState(contactInfo: DonorContactInfo, donationInfo: DonationPaymentInfo): void {
83
- const venmoRestoration = new VenmoRestorationState({
84
- contactInfo,
85
- donationInfo,
86
- });
87
- const serialized = JSON.stringify(venmoRestoration);
88
- this.storageSystem?.setItem(this.persistanceKey, serialized);
89
- }
90
-
91
- /** @inheritdoc */
92
- async getRestorationState(): Promise<VenmoRestorationState | undefined> {
93
- const stored = this.storageSystem?.getItem(this.persistanceKey);
94
- if (!stored) {
95
- console.error('restoreState: No stored data');
96
- return undefined;
97
- }
98
-
99
- const deserialized = JSON.parse(stored);
100
- if (!deserialized) {
101
- console.error('restoreState: Data could not be deserialized');
102
- return undefined;
103
- }
104
-
105
- const donationInfo = new VenmoRestorationState(deserialized);
106
-
107
- return donationInfo;
108
- }
109
-
110
- /**
111
- * Check if a particular storage system (localStorage/sessionStorage) is availble
112
- *
113
- * @private
114
- * @param {Storage} system
115
- * @returns {boolean}
116
- * @memberof VenmoRestorationStateHandler
117
- */
118
- private storageSystemAvailable(system: Storage): boolean {
119
- try {
120
- system.setItem('foo', 'bar');
121
- system.removeItem('foo');
122
- return true;
123
- } catch (exception) {
124
- return false;
125
- }
126
- }
127
- }
1
+ import { DonorContactInfo, DonationPaymentInfo } from '@internetarchive/donation-form-data-models';
2
+
3
+ export interface VenmoRestorationStateHandlerInterface {
4
+ /**
5
+ * Persist the session state
6
+ *
7
+ * @param {DonorContactInfo} contactInfo
8
+ * @param {DonationPaymentInfo} donationInfo
9
+ * @memberof VenmoRestorationStateHandlerInterface
10
+ */
11
+ persistState(contactInfo: DonorContactInfo, donationInfo: DonationPaymentInfo): void;
12
+
13
+ /**
14
+ * Get the session restoration state
15
+ *
16
+ * @returns {(Promise<VenmoRestorationState | undefined>)}
17
+ * @memberof VenmoRestorationStateHandlerInterface
18
+ */
19
+ getRestorationState(): Promise<VenmoRestorationState | undefined>;
20
+
21
+ /**
22
+ * Clear the restoration state
23
+ *
24
+ * @memberof VenmoRestorationStateHandlerInterface
25
+ */
26
+ clearState(): void;
27
+ }
28
+
29
+ /**
30
+ * Structure to store the session restoration state
31
+ *
32
+ * @export
33
+ * @class VenmoRestorationState
34
+ */
35
+ export class VenmoRestorationState {
36
+ contactInfo: DonorContactInfo;
37
+ donationInfo: DonationPaymentInfo;
38
+
39
+ // TODO: Add restoration state expiration
40
+ constructor(params: { contactInfo: DonorContactInfo; donationInfo: DonationPaymentInfo }) {
41
+ this.contactInfo = params.contactInfo;
42
+ this.donationInfo = params.donationInfo;
43
+ }
44
+ }
45
+
46
+ /**
47
+ * The VenmoRestorationStateHandler is used to persist and restore a Venmo checkout session.
48
+ *
49
+ * Venmo takes the user out of the web browser and into their app to authorize the purchase.
50
+ * It then redirects the user back to the website to finish the transaction. The problem is
51
+ * it may open a new browser tab so it's like starting a new session. We need to persist
52
+ * the session information from the start of the Venmo session and restore it when it resumes.
53
+ *
54
+ * This class stores the session information in localStorage when the Venmo session is started
55
+ * and retrieves it when the session is restored.
56
+ *
57
+ * @export
58
+ * @class VenmoRestorationStateHandler
59
+ * @implements {VenmoRestorationStateHandlerInterface}
60
+ */
61
+ export class VenmoRestorationStateHandler implements VenmoRestorationStateHandlerInterface {
62
+ private persistanceKey = 'venmoRestorationStateInfo';
63
+
64
+ private storageSystem?: Storage;
65
+
66
+ constructor(options?: { storageSystem?: Storage }) {
67
+ if (options?.storageSystem) {
68
+ this.storageSystem = options.storageSystem;
69
+ } else if (this.storageSystemAvailable(localStorage)) {
70
+ this.storageSystem = localStorage;
71
+ } else if (this.storageSystemAvailable(sessionStorage)) {
72
+ this.storageSystem = sessionStorage;
73
+ }
74
+ }
75
+
76
+ /** @inheritdoc */
77
+ clearState(): void {
78
+ this.storageSystem?.removeItem(this.persistanceKey);
79
+ }
80
+
81
+ /** @inheritdoc */
82
+ persistState(contactInfo: DonorContactInfo, donationInfo: DonationPaymentInfo): void {
83
+ const venmoRestoration = new VenmoRestorationState({
84
+ contactInfo,
85
+ donationInfo,
86
+ });
87
+ const serialized = JSON.stringify(venmoRestoration);
88
+ this.storageSystem?.setItem(this.persistanceKey, serialized);
89
+ }
90
+
91
+ /** @inheritdoc */
92
+ async getRestorationState(): Promise<VenmoRestorationState | undefined> {
93
+ const stored = this.storageSystem?.getItem(this.persistanceKey);
94
+ if (!stored) {
95
+ console.error('restoreState: No stored data');
96
+ return undefined;
97
+ }
98
+
99
+ const deserialized = JSON.parse(stored);
100
+ if (!deserialized) {
101
+ console.error('restoreState: Data could not be deserialized');
102
+ return undefined;
103
+ }
104
+
105
+ const donationInfo = new VenmoRestorationState(deserialized);
106
+
107
+ return donationInfo;
108
+ }
109
+
110
+ /**
111
+ * Check if a particular storage system (localStorage/sessionStorage) is availble
112
+ *
113
+ * @private
114
+ * @param {Storage} system
115
+ * @returns {boolean}
116
+ * @memberof VenmoRestorationStateHandler
117
+ */
118
+ private storageSystemAvailable(system: Storage): boolean {
119
+ try {
120
+ system.setItem('foo', 'bar');
121
+ system.removeItem('foo');
122
+ return true;
123
+ } catch (exception) {
124
+ return false;
125
+ }
126
+ }
127
+ }