import { Client } from "./client";
import { callback } from "./core";
export interface PayPalTokenizeReturn {
    close: () => any;
}

/**
 * Not available to all merchants; [contact PayPal](https://developers.braintreepayments.com/support/guides/paypal/setup-guide#contacting-paypal-support)
 * for details on eligibility and enabling this feature.
 * To enable this feature, [contact PayPal](https://developers.braintreepayments.com/support/guides/paypal/setup-guide#contacting-paypal-support).
 * Alternatively, see `shippingAddress` above as an available client opt
 * To enable this feature, [contact PayPal](https://developers.braintreepayments.com/support/guides/paypal/setup-guide#contacting-paypal-support).
 */
export interface PayPalShippingAddress {
    recipientName: string;
    line1: string;
    line2: string;
    city: string;
    state: string;
    postalCode: string;
    countryCode: string;
}

export interface PayPalBillingAddress {
    line1: string;
    line2: string;
    city: string;
    state: string;
    postalCode: string;
    countryCode: string;
}

export interface PayPalAccountDetails {
    email: string;
    payerId: string;
    firstName: string;
    lastName: string;
    countryCode: string;
    phone: string;
    shippingAddress: PayPalShippingAddress;
    billingAddress: PayPalBillingAddress;
}

export interface PayPalTokenizePayload {
    nonce: string;
    type: string;
    details: PayPalAccountDetails;
}

export interface PayPal {
    /**
     * Launches the PayPal login flow and returns a nonce payload. Only one PayPal login flow should be active at a time.
     * One way to achieve this is to disable your PayPal button while the flow is open.
     * * Checkout flows only.
     * * `authorize` - Submits the transaction for authorization but not settlement.
     * * `sale` - Payment will be immediately submitted for settlement upon creating a transaction.
     * * Changes the call-to-action in the PayPal flow. By default the final button will show the localized
     * word for "Continue" and implies that the final amount billed is not yet known.
     *
     * Setting this option to `commit` changes the button text to "Pay Now" and page text will convey to
     * the user that billing will take place immediately.         *
     * 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`.
     * @example
     * button.addEventListener('click', function () {
     *   // Disable the button so that we don't attempt to open multiple popups.
     *   button.setAttribute('disabled', 'disabled');
     *
     *   // Because PayPal tokenization opens a popup, this must be called
     *   // as a result of a user action, such as a button click.
     *   paypalInstance.tokenize({
     *     flow: 'vault' // Required
     *     // Any other tokenization options
     *   }, function (tokenizeErr, payload) {
     *     button.removeAttribute('disabled');
     *
     *     if (tokenizeErr) {
     *       // Handle tokenization errors or premature flow closure
     *
     *       switch (tokenizeErr.code) {
     *         case 'PAYPAL_POPUP_CLOSED':
     *           console.error('Customer closed PayPal popup.');
     *           break;
     *         case 'PAYPAL_ACCOUNT_TOKENIZATION_FAILED':
     *           console.error('PayPal tokenization failed. See details:', tokenizeErr.details);
     *           break;
     *         case 'PAYPAL_FLOW_FAILED':
     *           console.error('Unable to initialize PayPal flow. Are your options correct?', tokenizeErr.details);
     *           break;
     *         default:
     *           console.error('Error!', tokenizeErr);
     *       }
     *     } else {
     *       // Submit payload.nonce to your server
     *     }
     *   });
     * });
     */
    tokenize(options: {
        flow: string;
        intent?: string | undefined;
        offerCredit?: boolean | undefined;
        useraction?: string | undefined;
        amount?: string | number | undefined;
        currency?: string | undefined;
        displayName?: string | undefined;
        locale?: string | undefined;
        enableShippingAddress?: boolean | undefined;
        shippingAddressOverride?: PayPalShippingAddress | undefined;
        shippingAddressEditable?: boolean | undefined;
        billingAgreementDescription?: string | undefined;
    }): Promise<PayPalTokenizePayload>;
    tokenize(
        options: {
            flow: string;
            intent?: string | undefined;
            offerCredit?: boolean | undefined;
            useraction?: string | undefined;
            amount?: string | number | undefined;
            currency?: string | undefined;
            displayName?: string | undefined;
            locale?: string | undefined;
            enableShippingAddress?: boolean | undefined;
            shippingAddressOverride?: PayPalShippingAddress | undefined;
            shippingAddressEditable?: boolean | undefined;
            billingAgreementDescription?: string | undefined;
        },
        callback: callback<PayPalTokenizePayload>,
    ): PayPalTokenizeReturn;

    /**
     * Cleanly tear down anything set up by `create`.
     */
    teardown(callback?: () => void): void;
}

/**
 * @example
 * braintree.paypal.create({
 *   client: clientInstance
 * }, function (createErr, paypalInstance) {
 *   if (createErr) {
 *     if (createErr.code === 'PAYPAL_BROWSER_NOT_SUPPORTED') {
 *       console.error('This browser is not supported.');
 *     } else {
 *       console.error('Error!', createErr);
 *     }
 *   }
 * });
 */
export function create(options: { client: Client }): Promise<PayPal>;
export function create(options: { client: Client }, callback: callback<PayPal>): void;