import { Client } from "./client";
import { BraintreeError, callback } from "./core";

export interface VenmoAccountDetails {
    username: string;
}

export interface VenmoTokenizePayload {
    nonce: string;
    type: string;
    details: VenmoAccountDetails;
}

export interface Venmo {
    /**
     * Returns a boolean indicating whether the current browser supports Venmo as a payment method.
     *
     * If `options.allowNewBrowserTab` is false when calling {@link module:braintree-web/venmo.create|venmo.create},
     * this method will return true only for browsers known to support returning from the Venmo app to the same browser tab.
     * Currently, this is limited to iOS Safari and Android Chrome.
     */
    isBrowserSupported(): boolean;

    /**
     * Returns a boolean indicating whether a Venmo tokenization result is ready to be processed immediately.
     *
     * This method should be called after initialization to see if the result of Venmo authorization is available.
     * If it returns true, call {@link Venmo#tokenize|tokenize} immediately to process the results.
     */
    hasTokenizationResult(): boolean;

    /**
     * Launches the Venmo flow and returns a nonce payload.
     *
     * If {@link Venmo#hasTokenizationResult|hasTokenizationResult} returns true, calling tokenize will immediately
     * process and return the results without initiating the Venmo payment authorization flow.
     *
     * Only one Venmo flow can be active at a time. One way to achieve this is to disable your Venmo button while
     * the flow is open.
     * @example
     * button.addEventListener('click', function () {
     *   // Disable the button so that we don't attempt to open multiple popups.
     *   button.setAttribute('disabled', 'disabled');
     *
     *   // Because tokenize opens a new window, this must be called
     *   // as a result of a user action, such as a button click.
     *   venmoInstance.tokenize().then(function (payload) {
     *     // Submit payload.nonce to your server
     *     // Use payload.username to get the Venmo username and display any UI
     *   }).catch(function (tokenizeError) {
     *     // Handle flow errors or premature flow closure
     *     switch (tokenizeErr.code) {
     *       case 'VENMO_APP_CANCELED':
     *         console.log('User canceled Venmo flow.');
     *         break;
     *       case 'VENMO_CANCELED':
     *         console.log('User canceled Venmo, or Venmo app is not available.');
     *         break;
     *       default:
     *         console.error('Error!', tokenizeErr);
     *     }
     *   }).then(function () {
     *     button.removeAttribute('disabled');
     *   });
     * });
     */
    tokenize(options?: { processResultsDelay?: number | undefined }): Promise<VenmoTokenizePayload>;
    tokenize(
        options?: { processResultsDelay?: number | undefined },
        callback?: (error?: BraintreeError, payload?: VenmoTokenizePayload) => void,
    ): void;

    /**
     * Cleanly tear down anything set up by {@link module:braintree-web/venmo.create|create}.         * @example
     * venmoInstance.teardown();
     * @example <caption>With callback</caption>
     * venmoInstance.teardown(function () {
     *   // teardown is complete
     * });
     */
    teardown(callback?: () => void): void;
    teardown(): Promise<void>;
}

/**
 * Venmo Payment Method Usage
 * multi_use: Request authorization for future payments (vaulting allowed)
 * single_use: Request authorization for a one-time payment (vaulting not allowed)
 */
export type VenmoPaymentMethodUsage = "single_use" | "multi_use";

/**
 * braintree.venmo.create({
 *   client: clientInstance
 * }).then(function (venmoInstance) {
 *   // venmoInstance is ready to be used.
 * }).catch(function (createErr) {
 *   console.error('Error creating Venmo instance', createErr);
 * });
 */
export function create(options: {
    client?: Client | undefined;
    authorization?: string | undefined;
    allowNewBrowserTab?: boolean | undefined;
    ignoreHistoryChanges?: boolean | undefined;
    profileId?: string | undefined;
    deepLinkReturnUrl?: string | undefined;
    allowDesktopWebLogin?: boolean;
    allowDesktop?: boolean;
    mobileWebFallBack?: boolean;
    paymentMethodUsage?: VenmoPaymentMethodUsage;
}): Promise<Venmo>;

export function create(
    options: {
        client?: Client | undefined;
        authorization?: string | undefined;
        allowNewBrowserTab?: boolean | undefined;
        ignoreHistoryChanges?: boolean | undefined;
        profileId?: string | undefined;
        deepLinkReturnUrl?: string | undefined;
        allowDesktopWebLogin?: boolean;
        allowDesktop?: boolean;
        mobileWebFallBack?: boolean;
        paymentMethodUsage?: VenmoPaymentMethodUsage;
    },
    callback?: callback<Venmo>,
): void;