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

package/src/@types/braintree-web/modules/paypal-checkout.d.ts

@@ -1,262 +1,262 @@
-import { callback } from './core';
-import { Client } from './client';
-
-export interface PayPalCheckoutCreatePaymentOptions {
-  flow: paypal.FlowType;
-  intent?: paypal.Intent;
-  offerCredit?: boolean;
-  amount?: string | number;
-  currency?: string;
-  displayName?: string;
-  locale?: string;
-  vaultInitiatedCheckoutPaymentMethodToken?: string;
-  shippingOptions?: paypal.ShippingOption[];
-  enableShippingAddress?: boolean;
-  shippingAddressOverride?: paypal.Address;
-  shippingAddressEditable?: boolean;
-  billingAgreementDescription?: string;
-  landingPageType?: string;
-  lineItems?: paypal.LineItem[];
-}
-
-export interface PayPalCheckoutTokenizationOptions {
-  payerId: string;
-  paymentId?: string;
-  billingToken?: string;
-  vault?: boolean;
-}
-
-export interface PayPalCheckout {
-  /**
-   * @description There are two ways to integrate the PayPal Checkout component.
-   * See the [PayPal Checkout constructor documentation](PayPalCheckout.html#PayPalCheckout) for more information and examples.
-   * @example
-   * braintree.client.create({
-   *   authorization: 'authorization'
-   * }).then(function (clientInstance) {
-   *   return braintree.paypalCheckout.create({
-   *     client: clientInstance
-   *   });
-   * }).then(function (paypalCheckoutInstance) {
-   *   // set up checkout.js
-   * }).catch(function (err) {
-   *   console.error('Error!', err);
-   * });
-   */
-  create(options: {
-    client?: Client;
-    authorization?: string;
-    merchantAccountId?: string;
-  }): Promise<PayPalCheckout>;
-  create(
-    options: { client?: Client; authorization?: string; merchantAccountId?: string },
-    callback?: callback,
-  ): void;
-
-  /**
-   * @description The current version of the SDK, i.e. `3.0.2`.
-   */
-  VERSION: string;
-
-  /**
-   * Creates a PayPal payment ID or billing token using the given options. This is meant to be passed to PayPal's checkout.js library.
-   * When a {@link callback} is defined, the function returns undefined and invokes the callback with the id to be used with the checkout.js
-   * library. Otherwise, it returns a Promise that resolves with the id.
-   * `authorize` - Submits the transaction for authorization but not settlement.
-   * `order` - Validates the transaction without an authorization (i.e. without holding funds).
-   *           Useful for authorizing and capturing funds up to 90 days after the order has been placed. Only available for Checkout flow.
-   * `capture` - Payment will be immediately submitted for settlement upon creating a transaction.
-   * `sale` can be used as an alias for this value.
-   * Supported locales are:
-   * `da_DK`,
-   * `de_DE`,
-   * `en_AU`,
-   * `en_GB`,
-   * `en_US`,
-   * `es_ES`,
-   * `fr_CA`,
-   * `fr_FR`,
-   * `id_ID`,
-   * `it_IT`,
-   * `ja_JP`,
-   * `ko_KR`,
-   * `nl_NL`,
-   * `no_NO`,
-   * `pl_PL`,
-   * `pt_BR`,
-   * `pt_PT`,
-   * `ru_RU`,
-   * `sv_SE`,
-   * `th_TH`,
-   * `zh_CN`,
-   * `zh_HK`,
-   * and `zh_TW`.
-   *     * * `login` - A PayPal account login page is used.
-   * * `billing` - A non-PayPal account landing page is used.
-   * // this paypal object is created by checkout.js
-   * // see https://github.com/paypal/paypal-checkout
-   * paypal.Buttons({
-   *   createOrder: function () {
-   *     // when createPayment resolves, it is automatically passed to checkout.js
-   *     return paypalCheckoutInstance.createPayment({
-   *       flow: 'checkout',
-   *       amount: '10.00',
-   *       currency: 'USD',
-   *       intent: 'capture' // this value must either be `capture` or match the intent passed into the PayPal SDK intent query parameter
-   *     });
-   *   },
-   *   // Add other options, e.g. onApproved, onCancel, onError
-   * }).render('#paypal-button');
-   *
-   * @example
-   * // shippingOptions are passed to createPayment. You can review the result from onAuthorize to determine which shipping option id was selected.
-   * ```javascript
-   * braintree.client.create({
-   *   authorization: 'authorization'
-   * }).then(function (clientInstance) {
-   *   return braintree.paypalCheckout.create({
-   *     client: clientInstance
-   *   });
-   * }).then(function (paypalCheckoutInstance) {
-   *   return paypal.Button.render({
-   *     env: 'production'
-   *
-   *     payment: function () {
-   *       return paypalCheckoutInstance.createPayment({
-   *         flow: 'checkout',
-   *         amount: '10.00',
-   *         currency: 'USD',
-   *         shippingOptions: [
-   *           {
-   *             id: 'UUID-9',
-   *             type: 'PICKUP',
-   *             label: 'Store Location Five',
-   *             selected: true,
-   *             amount: {
-   *               value: '1.00',
-   *               currency: 'USD'
-   *             }
-   *           },
-   *           {
-   *             id: 'shipping-speed-fast',
-   *             type: 'SHIPPING',
-   *             label: 'Fast Shipping',
-   *             selected: false,
-   *             amount: {
-   *               value: '1.00',
-   *               currency: 'USD'
-   *             }
-   *           },
-   *           {
-   *             id: 'shipping-speed-slow',
-   *             type: 'SHIPPING',
-   *             label: 'Slow Shipping',
-   *             selected: false,
-   *             amount: {
-   *               value: '1.00',
-   *               currency: 'USD'
-   *             }
-   *           }
-   *         ]
-   *       });
-   *     },
-   *
-   *     onAuthorize: function (data, actions) {
-   *       return paypalCheckoutInstance.tokenizePayment(data).then(function (payload) {
-   *         // Submit payload.nonce to your server
-   *       });
-   *     }
-   *   }, '#paypal-button');
-   * }).catch(function (err) {
-   *  console.error('Error!', err);
-   * });
-   * ```
-   *
-   */
-  createPayment(options: PayPalCheckoutCreatePaymentOptions, callback?: callback): Promise<string>;
-
-  /**
-   * Tokenizes the authorize data from PayPal's checkout.js library when completing a buyer approval flow.
-   * When a {@link callback} is defined, invokes the callback with {@link PayPalCheckout~tokenizePayload|tokenizePayload} and returns undefined.
-   * Otherwise, returns a Promise that resolves with a {@link PayPalCheckout~tokenizePayload|tokenizePayload}.
-   * @example <caption>Opt out of auto-vaulting behavior</caption>
-   * // create the paypalCheckoutInstance with a client token generated with a customer id
-   * paypal.Buttons({
-   *   createBillingAgreement: function () {
-   *     return paypalCheckoutInstance.createPayment({
-   *       flow: 'vault'
-   *       // your other createPayment options here
-   *     });
-   *   },
-   *   onApproved: function (data) {
-   *     data.vault = false;
-   *
-   *     return paypalCheckoutInstance.tokenizePayment(data);
-   *   },
-   *   // Add other options, e.g. onCancel, onError
-   * }).render('#paypal-button');
-   *
-   */
-  tokenizePayment(
-    tokenizeOptions: PayPalCheckoutTokenizationOptions,
-  ): Promise<paypal.TokenizePayload>;
-  tokenizePayment(tokenizeOptions: PayPalCheckoutTokenizationOptions, callback?: callback): void;
-
-  /**
-   * Resolves with the PayPal client id to be used when loading the PayPal SDK.     * @example
-   * paypalCheckoutInstance.getClientId().then(function (id) {
-   *  var script = document.createElement('script');
-   *
-   *  script.src = 'https://www.paypal.com/sdk/js?client-id=' + id;
-   *  script.onload = function () {
-   *    // setup the PayPal SDK
-   *  };
-   *
-   *  document.body.appendChild(script);
-   * });
-   */
-  getClientId(): Promise<string>;
-  getClientId(callback: (id: string) => void): void;
-
-  /**
-   * Initializes the PayPal checkout flow with a payment method nonce that represents a vaulted PayPal account.
-   * When a {@link callback} is defined, the function returns undefined and invokes the callback with the id to be used with the checkout.js library.
-   * Otherwise, it returns a Promise that resolves with the id.
-   * `flow` cannot be set (will always be `'checkout'`)
-   * `amount`, `currency`, and `vaultInitiatedCheckoutPaymentMethodToken` are required instead of optional
-   * * Additional configuration is available (listed below)
-   * @example
-   * paypalCheckoutInstance.startVaultInitiatedCheckout({
-   *   vaultInitiatedCheckoutPaymentMethodToken: 'nonce-that-represents-a-vaulted-paypal-account',
-   *   amount: '10.00',
-   *   currency: 'USD'
-   * }).then(function (payload) {
-   *   // send payload.nonce to your server
-   * }).catch(function (err) {
-   *   if (err.code === 'PAYPAL_POPUP_CLOSED') {
-   *     // indicates that customer canceled by
-   *     // manually closing the PayPal popup
-   *   }
-   *
-   *   // handle other errors
-   * });
-   *
-   */
-  startVaultInitiatedCheckout(options: { optOutOfModalBackdrop: boolean }): Promise<void>;
-  startVaultInitiatedCheckout(
-    options: { optOutOfModalBackdrop: boolean },
-    callback: callback,
-  ): void;
-
-  /**
-   * Cleanly tear down anything set up by {@link module:braintree-web/paypal-checkout.create|create}.
-   * @example
-   * paypalCheckoutInstance.teardown();
-   * @example <caption>With callback</caption>
-   * paypalCheckoutInstance.teardown(function () {
-   *   // teardown is complete
-   * });
-   */
-  teardown(callback: () => void): void;
-  teardown(): Promise<void>;
-}
+import { callback } from './core';
+import { Client } from './client';
+
+export interface PayPalCheckoutCreatePaymentOptions {
+  flow: paypal.FlowType;
+  intent?: paypal.Intent;
+  offerCredit?: boolean;
+  amount?: string | number;
+  currency?: string;
+  displayName?: string;
+  locale?: string;
+  vaultInitiatedCheckoutPaymentMethodToken?: string;
+  shippingOptions?: paypal.ShippingOption[];
+  enableShippingAddress?: boolean;
+  shippingAddressOverride?: paypal.Address;
+  shippingAddressEditable?: boolean;
+  billingAgreementDescription?: string;
+  landingPageType?: string;
+  lineItems?: paypal.LineItem[];
+}
+
+export interface PayPalCheckoutTokenizationOptions {
+  payerId: string;
+  paymentId?: string;
+  billingToken?: string;
+  vault?: boolean;
+}
+
+export interface PayPalCheckout {
+  /**
+   * @description There are two ways to integrate the PayPal Checkout component.
+   * See the [PayPal Checkout constructor documentation](PayPalCheckout.html#PayPalCheckout) for more information and examples.
+   * @example
+   * braintree.client.create({
+   *   authorization: 'authorization'
+   * }).then(function (clientInstance) {
+   *   return braintree.paypalCheckout.create({
+   *     client: clientInstance
+   *   });
+   * }).then(function (paypalCheckoutInstance) {
+   *   // set up checkout.js
+   * }).catch(function (err) {
+   *   console.error('Error!', err);
+   * });
+   */
+  create(options: {
+    client?: Client;
+    authorization?: string;
+    merchantAccountId?: string;
+  }): Promise<PayPalCheckout>;
+  create(
+    options: { client?: Client; authorization?: string; merchantAccountId?: string },
+    callback?: callback,
+  ): void;
+
+  /**
+   * @description The current version of the SDK, i.e. `3.0.2`.
+   */
+  VERSION: string;
+
+  /**
+   * Creates a PayPal payment ID or billing token using the given options. This is meant to be passed to PayPal's checkout.js library.
+   * When a {@link callback} is defined, the function returns undefined and invokes the callback with the id to be used with the checkout.js
+   * library. Otherwise, it returns a Promise that resolves with the id.
+   * `authorize` - Submits the transaction for authorization but not settlement.
+   * `order` - Validates the transaction without an authorization (i.e. without holding funds).
+   *           Useful for authorizing and capturing funds up to 90 days after the order has been placed. Only available for Checkout flow.
+   * `capture` - Payment will be immediately submitted for settlement upon creating a transaction.
+   * `sale` can be used as an alias for this value.
+   * Supported locales are:
+   * `da_DK`,
+   * `de_DE`,
+   * `en_AU`,
+   * `en_GB`,
+   * `en_US`,
+   * `es_ES`,
+   * `fr_CA`,
+   * `fr_FR`,
+   * `id_ID`,
+   * `it_IT`,
+   * `ja_JP`,
+   * `ko_KR`,
+   * `nl_NL`,
+   * `no_NO`,
+   * `pl_PL`,
+   * `pt_BR`,
+   * `pt_PT`,
+   * `ru_RU`,
+   * `sv_SE`,
+   * `th_TH`,
+   * `zh_CN`,
+   * `zh_HK`,
+   * and `zh_TW`.
+   *     * * `login` - A PayPal account login page is used.
+   * * `billing` - A non-PayPal account landing page is used.
+   * // this paypal object is created by checkout.js
+   * // see https://github.com/paypal/paypal-checkout
+   * paypal.Buttons({
+   *   createOrder: function () {
+   *     // when createPayment resolves, it is automatically passed to checkout.js
+   *     return paypalCheckoutInstance.createPayment({
+   *       flow: 'checkout',
+   *       amount: '10.00',
+   *       currency: 'USD',
+   *       intent: 'capture' // this value must either be `capture` or match the intent passed into the PayPal SDK intent query parameter
+   *     });
+   *   },
+   *   // Add other options, e.g. onApproved, onCancel, onError
+   * }).render('#paypal-button');
+   *
+   * @example
+   * // shippingOptions are passed to createPayment. You can review the result from onAuthorize to determine which shipping option id was selected.
+   * ```javascript
+   * braintree.client.create({
+   *   authorization: 'authorization'
+   * }).then(function (clientInstance) {
+   *   return braintree.paypalCheckout.create({
+   *     client: clientInstance
+   *   });
+   * }).then(function (paypalCheckoutInstance) {
+   *   return paypal.Button.render({
+   *     env: 'production'
+   *
+   *     payment: function () {
+   *       return paypalCheckoutInstance.createPayment({
+   *         flow: 'checkout',
+   *         amount: '10.00',
+   *         currency: 'USD',
+   *         shippingOptions: [
+   *           {
+   *             id: 'UUID-9',
+   *             type: 'PICKUP',
+   *             label: 'Store Location Five',
+   *             selected: true,
+   *             amount: {
+   *               value: '1.00',
+   *               currency: 'USD'
+   *             }
+   *           },
+   *           {
+   *             id: 'shipping-speed-fast',
+   *             type: 'SHIPPING',
+   *             label: 'Fast Shipping',
+   *             selected: false,
+   *             amount: {
+   *               value: '1.00',
+   *               currency: 'USD'
+   *             }
+   *           },
+   *           {
+   *             id: 'shipping-speed-slow',
+   *             type: 'SHIPPING',
+   *             label: 'Slow Shipping',
+   *             selected: false,
+   *             amount: {
+   *               value: '1.00',
+   *               currency: 'USD'
+   *             }
+   *           }
+   *         ]
+   *       });
+   *     },
+   *
+   *     onAuthorize: function (data, actions) {
+   *       return paypalCheckoutInstance.tokenizePayment(data).then(function (payload) {
+   *         // Submit payload.nonce to your server
+   *       });
+   *     }
+   *   }, '#paypal-button');
+   * }).catch(function (err) {
+   *  console.error('Error!', err);
+   * });
+   * ```
+   *
+   */
+  createPayment(options: PayPalCheckoutCreatePaymentOptions, callback?: callback): Promise<string>;
+
+  /**
+   * Tokenizes the authorize data from PayPal's checkout.js library when completing a buyer approval flow.
+   * When a {@link callback} is defined, invokes the callback with {@link PayPalCheckout~tokenizePayload|tokenizePayload} and returns undefined.
+   * Otherwise, returns a Promise that resolves with a {@link PayPalCheckout~tokenizePayload|tokenizePayload}.
+   * @example <caption>Opt out of auto-vaulting behavior</caption>
+   * // create the paypalCheckoutInstance with a client token generated with a customer id
+   * paypal.Buttons({
+   *   createBillingAgreement: function () {
+   *     return paypalCheckoutInstance.createPayment({
+   *       flow: 'vault'
+   *       // your other createPayment options here
+   *     });
+   *   },
+   *   onApproved: function (data) {
+   *     data.vault = false;
+   *
+   *     return paypalCheckoutInstance.tokenizePayment(data);
+   *   },
+   *   // Add other options, e.g. onCancel, onError
+   * }).render('#paypal-button');
+   *
+   */
+  tokenizePayment(
+    tokenizeOptions: PayPalCheckoutTokenizationOptions,
+  ): Promise<paypal.TokenizePayload>;
+  tokenizePayment(tokenizeOptions: PayPalCheckoutTokenizationOptions, callback?: callback): void;
+
+  /**
+   * Resolves with the PayPal client id to be used when loading the PayPal SDK.     * @example
+   * paypalCheckoutInstance.getClientId().then(function (id) {
+   *  var script = document.createElement('script');
+   *
+   *  script.src = 'https://www.paypal.com/sdk/js?client-id=' + id;
+   *  script.onload = function () {
+   *    // setup the PayPal SDK
+   *  };
+   *
+   *  document.body.appendChild(script);
+   * });
+   */
+  getClientId(): Promise<string>;
+  getClientId(callback: (id: string) => void): void;
+
+  /**
+   * Initializes the PayPal checkout flow with a payment method nonce that represents a vaulted PayPal account.
+   * When a {@link callback} is defined, the function returns undefined and invokes the callback with the id to be used with the checkout.js library.
+   * Otherwise, it returns a Promise that resolves with the id.
+   * `flow` cannot be set (will always be `'checkout'`)
+   * `amount`, `currency`, and `vaultInitiatedCheckoutPaymentMethodToken` are required instead of optional
+   * * Additional configuration is available (listed below)
+   * @example
+   * paypalCheckoutInstance.startVaultInitiatedCheckout({
+   *   vaultInitiatedCheckoutPaymentMethodToken: 'nonce-that-represents-a-vaulted-paypal-account',
+   *   amount: '10.00',
+   *   currency: 'USD'
+   * }).then(function (payload) {
+   *   // send payload.nonce to your server
+   * }).catch(function (err) {
+   *   if (err.code === 'PAYPAL_POPUP_CLOSED') {
+   *     // indicates that customer canceled by
+   *     // manually closing the PayPal popup
+   *   }
+   *
+   *   // handle other errors
+   * });
+   *
+   */
+  startVaultInitiatedCheckout(options: { optOutOfModalBackdrop: boolean }): Promise<void>;
+  startVaultInitiatedCheckout(
+    options: { optOutOfModalBackdrop: boolean },
+    callback: callback,
+  ): void;
+
+  /**
+   * Cleanly tear down anything set up by {@link module:braintree-web/paypal-checkout.create|create}.
+   * @example
+   * paypalCheckoutInstance.teardown();
+   * @example <caption>With callback</caption>
+   * paypalCheckoutInstance.teardown(function () {
+   *   // teardown is complete
+   * });
+   */
+  teardown(callback: () => void): void;
+  teardown(): Promise<void>;
+}