@internetarchive/donation-form 1.0.2 → 1.0.3-alpha-webdev7960.0

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 (210) hide show
  1. package/LICENSE +661 -661
  2. package/README.md +115 -115
  3. package/dist/demo/braintree-endpoint-manager.js.map +1 -1
  4. package/dist/demo/demo-analytics-handler.js.map +1 -1
  5. package/dist/demo/submit-form-with.js.map +1 -1
  6. package/dist/index.js.map +1 -1
  7. package/dist/src/braintree-manager/braintree-interfaces.js.map +1 -1
  8. package/dist/src/braintree-manager/braintree-manager.js.map +1 -1
  9. package/dist/src/braintree-manager/payment-clients.js.map +1 -1
  10. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-interface.js.map +1 -1
  11. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-delegate.js.map +1 -1
  12. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-interface.js.map +1 -1
  13. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource.js.map +1 -1
  14. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-manager.js.map +1 -1
  15. package/dist/src/braintree-manager/payment-providers/apple-pay/apple-pay.js.map +1 -1
  16. package/dist/src/braintree-manager/payment-providers/credit-card/credit-card-interface.js.map +1 -1
  17. package/dist/src/braintree-manager/payment-providers/credit-card/credit-card.js.map +1 -1
  18. package/dist/src/braintree-manager/payment-providers/credit-card/hosted-field-configuration.js.map +1 -1
  19. package/dist/src/braintree-manager/payment-providers/credit-card/hosted-field-container.js.map +1 -1
  20. package/dist/src/braintree-manager/payment-providers/google-pay-interface.js.map +1 -1
  21. package/dist/src/braintree-manager/payment-providers/google-pay.js.map +1 -1
  22. package/dist/src/braintree-manager/payment-providers/paypal/paypal-button-datasource.js.map +1 -1
  23. package/dist/src/braintree-manager/payment-providers/paypal/paypal-interface.js.map +1 -1
  24. package/dist/src/braintree-manager/payment-providers/paypal/paypal.js.map +1 -1
  25. package/dist/src/braintree-manager/payment-providers/venmo-interface.js.map +1 -1
  26. package/dist/src/braintree-manager/payment-providers/venmo.js.map +1 -1
  27. package/dist/src/braintree-manager/payment-providers-interface.js.map +1 -1
  28. package/dist/src/braintree-manager/payment-providers.js.map +1 -1
  29. package/dist/src/donation-form-controller.js +123 -123
  30. package/dist/src/donation-form-controller.js.map +1 -1
  31. package/dist/src/donation-form-error.js.map +1 -1
  32. package/dist/src/donation-form.js +107 -107
  33. package/dist/src/donation-form.js.map +1 -1
  34. package/dist/src/form-elements/badged-input.js +47 -47
  35. package/dist/src/form-elements/badged-input.js.map +1 -1
  36. package/dist/src/form-elements/contact-form/autocomplete-field-options.js.map +1 -1
  37. package/dist/src/form-elements/contact-form/contact-form.js +157 -157
  38. package/dist/src/form-elements/contact-form/contact-form.js.map +1 -1
  39. package/dist/src/form-elements/contact-form/countries.js.map +1 -1
  40. package/dist/src/form-elements/header/donation-form-header.js +14 -14
  41. package/dist/src/form-elements/header/donation-form-header.js.map +1 -1
  42. package/dist/src/form-elements/header/donation-summary.js +15 -15
  43. package/dist/src/form-elements/header/donation-summary.js.map +1 -1
  44. package/dist/src/form-elements/payment-selector.js +164 -164
  45. package/dist/src/form-elements/payment-selector.js.map +1 -1
  46. package/dist/src/form-elements/total-amount.js +16 -16
  47. package/dist/src/form-elements/total-amount.js.map +1 -1
  48. package/dist/src/modals/confirm-donation-modal-content.js +51 -51
  49. package/dist/src/modals/confirm-donation-modal-content.js.map +1 -1
  50. package/dist/src/modals/error-modal-content.js +22 -22
  51. package/dist/src/modals/error-modal-content.js.map +1 -1
  52. package/dist/src/modals/upsell-modal-content.js +182 -182
  53. package/dist/src/modals/upsell-modal-content.js.map +1 -1
  54. package/dist/src/payment-flow-handlers/donation-flow-modal-manager.js +20 -20
  55. package/dist/src/payment-flow-handlers/donation-flow-modal-manager.js.map +1 -1
  56. package/dist/src/payment-flow-handlers/handlers/applepay-flow-handler.js.map +1 -1
  57. package/dist/src/payment-flow-handlers/handlers/creditcard-flow-handler.js.map +1 -1
  58. package/dist/src/payment-flow-handlers/handlers/googlepay-flow-handler.js.map +1 -1
  59. package/dist/src/payment-flow-handlers/handlers/paypal-flow-handler.js.map +1 -1
  60. package/dist/src/payment-flow-handlers/handlers/venmo-flow-handler.js.map +1 -1
  61. package/dist/src/payment-flow-handlers/handlers/venmo-restoration-state-handler.js.map +1 -1
  62. package/dist/src/payment-flow-handlers/payment-flow-handlers.js.map +1 -1
  63. package/dist/src/recaptcha-manager/recaptcha-manager.js.map +1 -1
  64. package/dist/src/util/promisedSleep.js.map +1 -1
  65. package/dist/test/helpers/fillInContactForm.js.map +1 -1
  66. package/dist/test/mocks/flow-handlers/individual-handlers/mock-applepay-flow-handler.js.map +1 -1
  67. package/dist/test/mocks/flow-handlers/individual-handlers/mock-creditcard-flow-handler.js.map +1 -1
  68. package/dist/test/mocks/flow-handlers/individual-handlers/mock-googlepay-flow-handler.js.map +1 -1
  69. package/dist/test/mocks/flow-handlers/individual-handlers/mock-paypal-flow-handler.js.map +1 -1
  70. package/dist/test/mocks/flow-handlers/individual-handlers/mock-venmo-flow-handler.js.map +1 -1
  71. package/dist/test/mocks/flow-handlers/mock-payment-flow-handlers.js.map +1 -1
  72. package/dist/test/mocks/mock-braintree-manager.js.map +1 -1
  73. package/dist/test/mocks/mock-donation-info.js.map +1 -1
  74. package/dist/test/mocks/mock-endpoint-manager.js.map +1 -1
  75. package/dist/test/mocks/mock-hosted-fields-config.js.map +1 -1
  76. package/dist/test/mocks/mock-hosted-fields-container.js.map +1 -1
  77. package/dist/test/mocks/mock-lazy-loader.js.map +1 -1
  78. package/dist/test/mocks/mock-modal-manager.js.map +1 -1
  79. package/dist/test/mocks/mock-payment-clients.js.map +1 -1
  80. package/dist/test/mocks/mock-paypal-button-renderer.js.map +1 -1
  81. package/dist/test/mocks/mock-recaptcha-manager.js.map +1 -1
  82. package/dist/test/mocks/models/mock-billing-info.js.map +1 -1
  83. package/dist/test/mocks/models/mock-custom-fields.js.map +1 -1
  84. package/dist/test/mocks/models/mock-customer-info.js.map +1 -1
  85. package/dist/test/mocks/models/mock-donation-request.js.map +1 -1
  86. package/dist/test/mocks/models/mock-success-response.js.map +1 -1
  87. package/dist/test/mocks/payment-clients/mock-applepay-client.js.map +1 -1
  88. package/dist/test/mocks/payment-clients/mock-applepay-payment.js.map +1 -1
  89. package/dist/test/mocks/payment-clients/mock-applepay-paymentauthorizedevent.js.map +1 -1
  90. package/dist/test/mocks/payment-clients/mock-applepay-session.js.map +1 -1
  91. package/dist/test/mocks/payment-clients/mock-applepay-sessionmanager.js.map +1 -1
  92. package/dist/test/mocks/payment-clients/mock-applepay-validatemerchantevent.js.map +1 -1
  93. package/dist/test/mocks/payment-clients/mock-braintree-client.js.map +1 -1
  94. package/dist/test/mocks/payment-clients/mock-data-collector.js.map +1 -1
  95. package/dist/test/mocks/payment-clients/mock-googlepay-client.js.map +1 -1
  96. package/dist/test/mocks/payment-clients/mock-googlepay-library.js.map +1 -1
  97. package/dist/test/mocks/payment-clients/mock-grecaptcha.js.map +1 -1
  98. package/dist/test/mocks/payment-clients/mock-hostedfields-client.js.map +1 -1
  99. package/dist/test/mocks/payment-clients/mock-hostedfieldstateobject-generator.js.map +1 -1
  100. package/dist/test/mocks/payment-clients/mock-hostedfieldtokenizepayload.js.map +1 -1
  101. package/dist/test/mocks/payment-clients/mock-paypal-client.js.map +1 -1
  102. package/dist/test/mocks/payment-clients/mock-paypal-library.js.map +1 -1
  103. package/dist/test/mocks/payment-clients/mock-venmo-client.js.map +1 -1
  104. package/dist/test/mocks/payment-providers/individual-providers/mock-applepay-datasource-delegate.js.map +1 -1
  105. package/dist/test/mocks/payment-providers/individual-providers/mock-applepay-handler.js.map +1 -1
  106. package/dist/test/mocks/payment-providers/individual-providers/mock-creditcard-handler.js.map +1 -1
  107. package/dist/test/mocks/payment-providers/individual-providers/mock-googlepay-handler.js.map +1 -1
  108. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-button-datasource-delegate.js.map +1 -1
  109. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-button-datasource.js.map +1 -1
  110. package/dist/test/mocks/payment-providers/individual-providers/mock-paypal-handler.js.map +1 -1
  111. package/dist/test/mocks/payment-providers/individual-providers/mock-venmo-handler.js.map +1 -1
  112. package/dist/test/mocks/payment-providers/mock-payment-providers.js.map +1 -1
  113. package/dist/test/tests/braintree-manager.test.js.map +1 -1
  114. package/dist/test/tests/donation-form-controller.test.js +39 -39
  115. package/dist/test/tests/donation-form-controller.test.js.map +1 -1
  116. package/dist/test/tests/donation-form.test.js +4 -4
  117. package/dist/test/tests/donation-form.test.js.map +1 -1
  118. package/dist/test/tests/flow-handlers/donation-flow-modal-manager.test.js +14 -14
  119. package/dist/test/tests/flow-handlers/donation-flow-modal-manager.test.js.map +1 -1
  120. package/dist/test/tests/form-elements/donation-summary.test.js.map +1 -1
  121. package/dist/test/tests/form-elements/payment-selector.test.js.map +1 -1
  122. package/dist/test/tests/modals/error-modal-content.test.js +2 -2
  123. package/dist/test/tests/modals/error-modal-content.test.js.map +1 -1
  124. package/dist/test/tests/modals/upsell-modal-content.test.js +31 -31
  125. package/dist/test/tests/modals/upsell-modal-content.test.js.map +1 -1
  126. package/dist/test/tests/models/donation-payment-info.test.js.map +1 -1
  127. package/dist/test/tests/payment-clients.test.js.map +1 -1
  128. package/dist/test/tests/payment-providers/applepay-sessiondatasource.test.js.map +1 -1
  129. package/dist/test/tests/payment-providers/applepay-sessionmanager.test.js.map +1 -1
  130. package/dist/test/tests/payment-providers/applepay.test.js.map +1 -1
  131. package/dist/test/tests/payment-providers/creditcard.test.js.map +1 -1
  132. package/dist/test/tests/payment-providers/googlepay.test.js.map +1 -1
  133. package/dist/test/tests/payment-providers/payment-providers.test.js.map +1 -1
  134. package/dist/test/tests/payment-providers/paypal-button-datasource.test.js.map +1 -1
  135. package/dist/test/tests/payment-providers/paypal.test.js.map +1 -1
  136. package/dist/test/tests/payment-providers/venmo.test.js.map +1 -1
  137. package/dist/test/tests/recaptcha-manager.test.js.map +1 -1
  138. package/package.json +107 -107
  139. package/src/@types/analytics-handler/index.d.ts +8 -8
  140. package/src/@types/braintree-web/LICENSE +21 -21
  141. package/src/@types/braintree-web/index.d.ts +93 -93
  142. package/src/@types/braintree-web/modules/american-express.d.ts +50 -50
  143. package/src/@types/braintree-web/modules/apple-pay.d.ts +213 -213
  144. package/src/@types/braintree-web/modules/client.d.ts +103 -103
  145. package/src/@types/braintree-web/modules/core.d.ts +34 -34
  146. package/src/@types/braintree-web/modules/data-collector.d.ts +13 -13
  147. package/src/@types/braintree-web/modules/google-payment.d.ts +269 -269
  148. package/src/@types/braintree-web/modules/hosted-fields.d.ts +366 -366
  149. package/src/@types/braintree-web/modules/paypal-checkout.d.ts +262 -262
  150. package/src/@types/braintree-web/modules/paypal.d.ts +177 -177
  151. package/src/@types/braintree-web/modules/three-d-secure.d.ts +141 -141
  152. package/src/@types/braintree-web/modules/unionpay.d.ts +224 -224
  153. package/src/@types/braintree-web/modules/us-bank-account.d.ts +81 -81
  154. package/src/@types/braintree-web/modules/venmo.d.ts +110 -110
  155. package/src/@types/braintree-web/package.json +64 -64
  156. package/src/@types/paypal-checkout-components/LICENSE +21 -21
  157. package/src/@types/paypal-checkout-components/index.d.ts +67 -67
  158. package/src/@types/paypal-checkout-components/modules/button.d.ts +50 -50
  159. package/src/@types/paypal-checkout-components/modules/callback-data.d.ts +244 -244
  160. package/src/@types/paypal-checkout-components/modules/configuration.d.ts +114 -114
  161. package/src/@types/paypal-checkout-components/package.json +58 -58
  162. package/src/braintree-manager/braintree-interfaces.ts +172 -172
  163. package/src/braintree-manager/braintree-manager.ts +281 -281
  164. package/src/braintree-manager/payment-clients.ts +146 -146
  165. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-interface.ts +13 -13
  166. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-delegate.ts +8 -8
  167. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource-interface.ts +10 -10
  168. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-datasource.ts +119 -119
  169. package/src/braintree-manager/payment-providers/apple-pay/apple-pay-session-manager.ts +21 -21
  170. package/src/braintree-manager/payment-providers/apple-pay/apple-pay.ts +97 -97
  171. package/src/braintree-manager/payment-providers/credit-card/credit-card-interface.ts +21 -21
  172. package/src/braintree-manager/payment-providers/credit-card/credit-card.ts +130 -130
  173. package/src/braintree-manager/payment-providers/credit-card/hosted-field-configuration.ts +19 -19
  174. package/src/braintree-manager/payment-providers/credit-card/hosted-field-container.ts +85 -85
  175. package/src/braintree-manager/payment-providers/google-pay-interface.ts +8 -8
  176. package/src/braintree-manager/payment-providers/google-pay.ts +59 -59
  177. package/src/braintree-manager/payment-providers/paypal/paypal-button-datasource.ts +218 -218
  178. package/src/braintree-manager/payment-providers/paypal/paypal-interface.ts +13 -13
  179. package/src/braintree-manager/payment-providers/paypal/paypal.ts +78 -78
  180. package/src/braintree-manager/payment-providers/venmo-interface.ts +8 -8
  181. package/src/braintree-manager/payment-providers/venmo.ts +67 -67
  182. package/src/braintree-manager/payment-providers-interface.ts +25 -25
  183. package/src/braintree-manager/payment-providers.ts +147 -147
  184. package/src/donation-form-controller.ts +623 -623
  185. package/src/donation-form-error.ts +6 -6
  186. package/src/donation-form.ts +576 -576
  187. package/src/form-elements/badged-input.ts +109 -109
  188. package/src/form-elements/contact-form/autocomplete-field-options.ts +63 -63
  189. package/src/form-elements/contact-form/contact-form.ts +434 -434
  190. package/src/form-elements/contact-form/countries.ts +252 -252
  191. package/src/form-elements/header/donation-form-header.ts +98 -98
  192. package/src/form-elements/header/donation-summary.ts +61 -61
  193. package/src/form-elements/payment-selector.ts +365 -365
  194. package/src/form-elements/total-amount.ts +46 -46
  195. package/src/modals/confirm-donation-modal-content.ts +168 -168
  196. package/src/modals/error-modal-content.ts +48 -48
  197. package/src/modals/upsell-modal-content.ts +284 -284
  198. package/src/payment-flow-handlers/donation-flow-modal-manager.ts +439 -439
  199. package/src/payment-flow-handlers/handlers/applepay-flow-handler.ts +109 -109
  200. package/src/payment-flow-handlers/handlers/creditcard-flow-handler.ts +232 -232
  201. package/src/payment-flow-handlers/handlers/googlepay-flow-handler.ts +111 -111
  202. package/src/payment-flow-handlers/handlers/paypal-flow-handler.ts +331 -331
  203. package/src/payment-flow-handlers/handlers/venmo-flow-handler.ts +119 -119
  204. package/src/payment-flow-handlers/handlers/venmo-restoration-state-handler.ts +127 -127
  205. package/src/payment-flow-handlers/payment-flow-handlers.ts +218 -218
  206. package/src/recaptcha-manager/recaptcha-manager.ts +123 -123
  207. package/src/util/promisedSleep.ts +3 -3
  208. package/dist/demo/app-root.d.ts +0 -0
  209. package/dist/demo/app-root.js +0 -2
  210. package/dist/demo/app-root.js.map +0 -1
@@ -1,119 +1,119 @@
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
- import { BraintreeError } from '../../@types/braintree-web';
13
-
14
- export interface VenmoFlowHandlerInterface {
15
- startup(): Promise<void>;
16
- paymentInitiated(contactInfo: DonorContactInfo, donationInfo: DonationPaymentInfo): Promise<void>;
17
- }
18
-
19
- export class VenmoFlowHandler implements VenmoFlowHandlerInterface {
20
- private donationFlowModalManager: DonationFlowModalManagerInterface;
21
-
22
- private braintreeManager: BraintreeManagerInterface;
23
-
24
- private restorationStateHandler: VenmoRestorationStateHandlerInterface;
25
-
26
- constructor(options: {
27
- braintreeManager: BraintreeManagerInterface;
28
- donationFlowModalManager: DonationFlowModalManagerInterface;
29
- restorationStateHandler?: VenmoRestorationStateHandlerInterface;
30
- }) {
31
- this.braintreeManager = options.braintreeManager;
32
- this.donationFlowModalManager = options.donationFlowModalManager;
33
- this.restorationStateHandler =
34
- options.restorationStateHandler ?? new VenmoRestorationStateHandler();
35
- }
36
-
37
- /**
38
- * Check if we have any results from Venmo on startup.
39
- *
40
- * This happens if the app redirects to us in a new tab so we can resume the session.
41
- *
42
- * @returns {Promise<void>}
43
- * @memberof VenmoFlowHandler
44
- */
45
- async startup(): Promise<void> {
46
- const handler = await this.braintreeManager.paymentProviders.venmoHandler.get();
47
- const instance = await handler?.instance.get();
48
- if (instance?.hasTokenizationResult()) {
49
- // if we get redirected back from venmo in a different tab, we need to restore the data
50
- // that was persisted when the payment was initiated
51
- const restoredInfo = await this.restorationStateHandler.getRestorationState();
52
- if (restoredInfo) {
53
- this.paymentInitiated(restoredInfo.contactInfo, restoredInfo.donationInfo);
54
- } else {
55
- console.error('no restoration info');
56
- this.donationFlowModalManager.showErrorModal({
57
- message: 'Error restoring donation session',
58
- });
59
- }
60
- }
61
- }
62
-
63
- // VenmoFlowHandlerInterface conformance
64
- async paymentInitiated(
65
- contactInfo: DonorContactInfo,
66
- donationInfo: DonationPaymentInfo,
67
- ): Promise<void> {
68
- // if we get redirected back from venmo in a different tab, we need to restore the data
69
- // that was persisted when the payment was initiated so persist it here
70
- this.restorationStateHandler.persistState(contactInfo, donationInfo);
71
-
72
- try {
73
- const handler = await this.braintreeManager.paymentProviders.venmoHandler.get();
74
- const result = await handler?.startPayment();
75
- if (!result) {
76
- this.restorationStateHandler.clearState();
77
- this.donationFlowModalManager.showErrorModal({
78
- message: 'Error setting up the donation',
79
- });
80
- return;
81
- }
82
- this.handleTokenizationResult(result, contactInfo, donationInfo);
83
- } catch (tokenizeError) {
84
- this.restorationStateHandler.clearState();
85
- this.handleTokenizationError(tokenizeError as BraintreeError);
86
- this.donationFlowModalManager.showErrorModal({
87
- message: `There was a problem loading your donation information. Please try again.`,
88
- });
89
- }
90
- }
91
-
92
- private async handleTokenizationResult(
93
- payload: braintree.VenmoTokenizePayload,
94
- contactInfo: DonorContactInfo,
95
- donationInfo: DonationPaymentInfo,
96
- ): Promise<void> {
97
- this.restorationStateHandler.clearState();
98
-
99
- this.donationFlowModalManager.startDonationSubmissionFlow({
100
- nonce: payload.nonce,
101
- paymentProvider: PaymentProvider.Venmo,
102
- donationInfo: donationInfo,
103
- customerInfo: contactInfo.customer,
104
- billingInfo: contactInfo.billing,
105
- });
106
- }
107
-
108
- private handleTokenizationError(tokenizeError: braintree.BraintreeError): void {
109
- // Handle flow errors or premature flow closure
110
- switch (tokenizeError.code) {
111
- case 'VENMO_APP_CANCELED':
112
- break;
113
- case 'VENMO_CANCELED':
114
- break;
115
- default:
116
- console.error('Error!', tokenizeError);
117
- }
118
- }
119
- }
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
+ import { BraintreeError } from '../../@types/braintree-web';
13
+
14
+ export interface VenmoFlowHandlerInterface {
15
+ startup(): Promise<void>;
16
+ paymentInitiated(contactInfo: DonorContactInfo, donationInfo: DonationPaymentInfo): Promise<void>;
17
+ }
18
+
19
+ export class VenmoFlowHandler implements VenmoFlowHandlerInterface {
20
+ private donationFlowModalManager: DonationFlowModalManagerInterface;
21
+
22
+ private braintreeManager: BraintreeManagerInterface;
23
+
24
+ private restorationStateHandler: VenmoRestorationStateHandlerInterface;
25
+
26
+ constructor(options: {
27
+ braintreeManager: BraintreeManagerInterface;
28
+ donationFlowModalManager: DonationFlowModalManagerInterface;
29
+ restorationStateHandler?: VenmoRestorationStateHandlerInterface;
30
+ }) {
31
+ this.braintreeManager = options.braintreeManager;
32
+ this.donationFlowModalManager = options.donationFlowModalManager;
33
+ this.restorationStateHandler =
34
+ options.restorationStateHandler ?? new VenmoRestorationStateHandler();
35
+ }
36
+
37
+ /**
38
+ * Check if we have any results from Venmo on startup.
39
+ *
40
+ * This happens if the app redirects to us in a new tab so we can resume the session.
41
+ *
42
+ * @returns {Promise<void>}
43
+ * @memberof VenmoFlowHandler
44
+ */
45
+ async startup(): Promise<void> {
46
+ const handler = await this.braintreeManager.paymentProviders.venmoHandler.get();
47
+ const instance = await handler?.instance.get();
48
+ if (instance?.hasTokenizationResult()) {
49
+ // if we get redirected back from venmo in a different tab, we need to restore the data
50
+ // that was persisted when the payment was initiated
51
+ const restoredInfo = await this.restorationStateHandler.getRestorationState();
52
+ if (restoredInfo) {
53
+ this.paymentInitiated(restoredInfo.contactInfo, restoredInfo.donationInfo);
54
+ } else {
55
+ console.error('no restoration info');
56
+ this.donationFlowModalManager.showErrorModal({
57
+ message: 'Error restoring donation session',
58
+ });
59
+ }
60
+ }
61
+ }
62
+
63
+ // VenmoFlowHandlerInterface conformance
64
+ async paymentInitiated(
65
+ contactInfo: DonorContactInfo,
66
+ donationInfo: DonationPaymentInfo,
67
+ ): Promise<void> {
68
+ // if we get redirected back from venmo in a different tab, we need to restore the data
69
+ // that was persisted when the payment was initiated so persist it here
70
+ this.restorationStateHandler.persistState(contactInfo, donationInfo);
71
+
72
+ try {
73
+ const handler = await this.braintreeManager.paymentProviders.venmoHandler.get();
74
+ const result = await handler?.startPayment();
75
+ if (!result) {
76
+ this.restorationStateHandler.clearState();
77
+ this.donationFlowModalManager.showErrorModal({
78
+ message: 'Error setting up the donation',
79
+ });
80
+ return;
81
+ }
82
+ this.handleTokenizationResult(result, contactInfo, donationInfo);
83
+ } catch (tokenizeError) {
84
+ this.restorationStateHandler.clearState();
85
+ this.handleTokenizationError(tokenizeError as BraintreeError);
86
+ this.donationFlowModalManager.showErrorModal({
87
+ message: `There was a problem loading your donation information. Please try again.`,
88
+ });
89
+ }
90
+ }
91
+
92
+ private async handleTokenizationResult(
93
+ payload: braintree.VenmoTokenizePayload,
94
+ contactInfo: DonorContactInfo,
95
+ donationInfo: DonationPaymentInfo,
96
+ ): Promise<void> {
97
+ this.restorationStateHandler.clearState();
98
+
99
+ this.donationFlowModalManager.startDonationSubmissionFlow({
100
+ nonce: payload.nonce,
101
+ paymentProvider: PaymentProvider.Venmo,
102
+ donationInfo: donationInfo,
103
+ customerInfo: contactInfo.customer,
104
+ billingInfo: contactInfo.billing,
105
+ });
106
+ }
107
+
108
+ private handleTokenizationError(tokenizeError: braintree.BraintreeError): void {
109
+ // Handle flow errors or premature flow closure
110
+ switch (tokenizeError.code) {
111
+ case 'VENMO_APP_CANCELED':
112
+ break;
113
+ case 'VENMO_CANCELED':
114
+ break;
115
+ default:
116
+ console.error('Error!', tokenizeError);
117
+ }
118
+ }
119
+ }
@@ -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
+ }