import type { SettingData } from "./interfaces/common";
import type { ThemeSettings } from "./interfaces/theme";
import type { PaymentResult } from "./interfaces/payment";
export default class TapOn {
    /**
    * Inicializa o serviço Tap On.
    *
    * Deve ser chamado **uma única vez** no ciclo de vida do aplicativo,
    * preferencialmente no início (ex: App.tsx ou splash screen).
    *
    * @param data Configurações do aplicativo. O campo `theme` é opcional e pode ser passado aqui ou via `set_theme()`.
    * @throws {SetupError} Se algum parâmetro obrigatório estiver inválido ou se as cores do tema forem inválidas(caso existam)
    */
    static initialize(data: SettingData): void;
    /**
    * Define as configurações de tema visual para as telas exibidas pela extensão Tap On.
    *
    * Pode ser chamado **a qualquer momento após** a inicialização.
    * As cores devem estar no formato hexadecimal `#RRGGBB` ou `#RRGGBBAA` (case insensitive).
    * Campos omitidos mantêm o tema padrão da extensão.
    *
    * @param data Configurações de tema (todas as propriedades são opcionais)
    * @throws {SetupError} Se alguma cor estiver em formato inválido
    *
    * @example
    * TapOn.set_theme({
    *   toolbar_color: "#1E40AF",
    *   toolbar_text_color: "#FFFFFF",
    *   button_background_color: "#3B82F6",
    *   button_text_color: "#FFFFFF",
    *   status_bar_color: "#1E3A8A"
    * });
    */
    static set_theme(data: ThemeSettings): void;
    /**
    * Verifica se o dispositivo possui hardware compatível com NFC.
    *
    * **Não requer inicialização prévia.**
    *
    * > Este método verifica a **capacidade física** do dispositivo para realizar pagamentos por aproximação (NFC).
    * > Mesmo que retorne `true`, ainda é necessário verificar se a extensão Tap On é compativel
    * > (`is_extension_suported()`) e se o NFC está ativado (`is_nfc_enabled()`).
    *
    * @example
    * if (!TapOn.is_nfc_supported()) {
    *   alert("Seu dispositivo não suporta pagamentos por aproximação (NFC).");
    *   return;
    * }
    */
    static is_nfc_supported(): boolean;
    /**
    * Verifica se o NFC está ativado nas configurações do dispositivo.
    *
    * **Não requer inicialização prévia.**
    *
    * > Retorna `true` apenas se o usuário tiver ativado o NFC manualmente nas configurações do Android.
    * > Se retornar `false`, você pode orientar o usuário a ativar o NFC antes de prosseguir com pagamentos por aproximação.
    * @example
    * if (TapOn.is_nfc_supported() && !TapOn.is_nfc_enabled()) {
    *   // Mostrar tela ou toast pedindo para ativar NFC
    *   alert("Por favor, ative o NFC nas configurações do dispositivo para continuar.");
    * }
    */
    static is_nfc_enabled(): boolean;
    /**
    * Verifica se o dispositivo suporta a funcionalidade Tap On (NFC + hardware compatível).
    *
    * **Não requer inicialização prévia.**
    *
    * > Diferente de `is_extension_available()`, que verifica apenas se o pacote está instalado,
    * > este método verifica se o hardware do dispositivo é compatível com pagamentos por aproximação via Tap On.
    */
    static is_extension_suported(): boolean;
    /**
     * Verifica se o pacote da extensão Tap On está instalado no dispositivo.
     *
     * **Não requer inicialização prévia.**
     *
     * > Utilize este método para detectar se o usuário já possui a extensão antes de tentar realizar uma transação.
     *
     * > Se não estiver disponível, chame {@link get_extension_on_playstore} para redirecionar.
     *
     * @example
     * if (!TapOn.is_extension_available()) {
     *   // Redirecionar o usuário para pagina da extenção na loja.
     *   TapOn.get_extension_on_playstore();
     * }
     */
    static is_extension_available(): boolean;
    /**
     * Redireciona o usuário para a página da extensão Tap On na Google Play Store.
     *
     * **Não requer inicialização prévia.**
     *
     * > **Prática recomendada (PagBank):** Crie um fluxo no seu app que
     * > oriente o usuário a baixar a extensão e fazer login antes de efetuar as primeiras vendas.
     */
    static get_extension_on_playstore(): void;
    /**
     * Inicia uma transação de pagamento por aproximação (NFC) via Tap On.
     *
     * > **Nota:** Na primeira venda o Tap On inicia automaticamente o
     * > fluxo de login do vendedor.
     *
     * @param amount - Valor da transação em centavos. Deve estar entre R$ 1,00 (100 centavos) e R$ 10.000,00 (1000000 centavos).
     * @throws {PaymentError} Em caso de recusa, erro de comunicação, timeout, etc.
     * @throws {SetupError} Em caso de campo inválido.
     * @example
     * try {
     *   const resultado = await TapOn.request_payment(25000); // R$250.00
     *   console.log('Código da transação:', resultado.transaction_code);
     *   console.log('Bandeira:', resultado.card_brand);
     * } catch (e) {
     *   if (e instanceof PaymentError) {
     *     console.error(`[${e.code}] ${e.message}`);
     *   }
     * }
     */
    static request_payment(amount: number): Promise<PaymentResult>;
    /**
    * Solicita o reembolso (estorno) total ou parcial de uma transação anterior.
    *
    * @param transaction_code Código único da transação original (obtido em `PaymentResult`)
    * @param amount Valor a ser estornado (deve ser ≤ valor original da transação)
    *
    * @throws {RefundError} Em caso de falha no extorno
    * @throws {SetupError} Em caso de campos inválidos.
    */
    static request_refund(transaction_code: string, amount: number): Promise<boolean>;
}
//# sourceMappingURL=tap_on_pagseguro.d.ts.map