@silasfmartins/testhub 1.0.0

package/dist/src/appium/MobileActions.d.ts

@@ -0,0 +1,347 @@
+import '../hubdocs/StatementTracker.js';
+/**
+ * Enum para direções de swipe
+ */
+export declare enum Direcao {
+    CIMA = "CIMA",
+    BAIXO = "BAIXO",
+    ESQUERDA = "ESQUERDA",
+    DIREITA = "DIREITA"
+}
+/**
+ * Interface para coordenadas de ponto na tela
+ */
+export interface Point {
+    x: number;
+    y: number;
+}
+/**
+ * Classe utilitária para interações com aplicativos mobile via Appium
+ * Fornece métodos para manipulação de elementos, gestos e validações
+ * Baseada nos padrões Actions do framework mobile
+ */
+export declare class MobileActions {
+    /**
+     * 🧹 Limpa pasta de screenshots mobile no início da execução
+     */
+    static cleanMobileScreenshots(): Promise<void>;
+    /**
+     * 🚫 ULTRA-RADICAL SSL KILLER: Initialize before any mobile operation
+     */
+    private static initializeSSLKillerForMobile;
+    /**
+     * ✅ NOVO: Detecta o tipo do seletor mobile
+     * @private
+     * @param {string} selector Seletor a analisar
+     * @returns {string} Tipo do seletor
+     */
+    private static detectMobileSelectorType;
+    /**
+     * ✅ NOVO: Função auxiliar para criar objeto de ação mobile para o AutoDocs
+     * @private
+     * @param {string} action Nome da ação
+     * @param {string} selector Seletor do elemento
+     * @param {string} description Descrição da ação
+     * @param {any} [value] Valor da ação (opcional)
+     * @param {boolean} [captureScreenshot] Se deve capturar screenshot
+     * @returns {object} Objeto de ação mobile
+     */
+    private static createMobileAction;
+    /**
+     * ✅ HELPER: Garante que o driver existe e não é null
+     * @private
+     */
+    private static ensureDriverExists;
+    /**
+     * Executa um método específico no contexto mobile com logs unificados.
+     * @param nomeMetodo Nome do método para identificação nos logs.
+     * @param executarAcao Função que executa a ação específica.
+     * @returns Resultado da execução da ação.
+     * @private
+     */
+    private static executarComLog;
+    /**
+     * Garante que a limpeza automática está configurada para o teste mobile.
+     * @private
+     */
+    private static ensureAutoCleanupConfigured;
+    /**
+     * Realiza clique inteligente em elemento mobile, com fallback para coordenadas.
+     * @param seletor Seletor do elemento.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param timeout Tempo máximo de espera em ms.
+     */
+    static click(seletor: string, descriptionToAction: string, getSnapshot?: boolean, // 🔧 MUDANÇA: Agora captura screenshot por padrão
+    timeout?: number): Promise<void>;
+    /**
+     * Realiza clique robusto em elemento mobile, com múltiplas tentativas.
+     * @param seletor Seletor do elemento.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param timeout Tempo máximo de espera em ms.
+     * @param retry Número de tentativas.
+     */
+    static clickNative(seletor: string, descriptionToAction: string, getSnapshot?: boolean, timeout?: number, retry?: number): Promise<void>;
+    /**
+     * Realiza clique por coordenadas no centro do elemento.
+     * @param seletor Seletor do elemento.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param timeout Tempo máximo de espera em ms.
+     */
+    static clickByCoordinates(seletor: string, descriptionToAction: string, getSnapshot?: boolean, timeout?: number): Promise<void>;
+    /**
+     * Realiza um clique em uma coordenada específica na tela.
+     * @param point Coordenada {x, y}.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     */
+    static clickPoint(point: Point, descriptionToAction: string, getSnapshot?: boolean): Promise<void>;
+    /**
+     * Valida se um elemento está presente na tela.
+     * @param seletor Seletor do elemento.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param timeout Tempo máximo de espera em ms.
+     * @returns True se o elemento está presente.
+     */
+    static validateObject(seletor: string, descriptionToAction: string, getSnapshot?: boolean, timeout?: number): Promise<boolean>;
+    /**
+     * Valida que um elemento não está presente na tela.
+     * @param seletor Seletor do elemento.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param timeout Tempo máximo de espera em ms.
+     * @returns True se o elemento não está presente.
+     */
+    static validateObjectNotExist(seletor: string, descriptionToAction: string, getSnapshot?: boolean, timeout?: number): Promise<boolean>;
+    /**
+     * Define um texto em um campo de entrada.
+     * @param seletor Seletor do campo.
+     * @param text Texto a ser inserido.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param timeout Tempo máximo de espera em ms.
+     */
+    static setText(seletor: string, text: string, descriptionToAction: string, getSnapshot?: boolean, timeout?: number): Promise<void>;
+    /**
+     * Envia caracteres individualmente para um elemento.
+     * @param seletor Seletor do campo.
+     * @param text Texto a ser inserido.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param timeout Tempo máximo de espera em ms.
+     * @param delayBetweenChars Delay entre caracteres em ms.
+     */
+    static setChar(seletor: string, text: string, descriptionToAction: string, getSnapshot?: boolean, timeout?: number, delayBetweenChars?: number): Promise<void>;
+    /**
+     * Obtém o texto presente em um elemento.
+     * @param seletor Seletor do elemento.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param timeout Tempo máximo de espera em ms.
+     * @returns Texto do elemento.
+     */
+    static getText(seletor: string, descriptionToAction: string, getSnapshot?: boolean, timeout?: number): Promise<string>;
+    /**
+     * Alterna o contexto da aplicação (ex: Nativo/Webview).
+     * @param contextName Nome do contexto.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     */
+    static switchToContext(contextName: string, descriptionToAction: string, getSnapshot?: boolean): Promise<void>;
+    /**
+     * Verifica se um elemento está presente na tela.
+     * @param seletor Seletor do elemento.
+     * @param timeout Tempo máximo de espera em ms.
+     * @returns True se o elemento está presente.
+     */
+    static isPresent(seletor: string, timeout?: number): Promise<boolean>;
+    /**
+     * Realiza a ação de voltar na navegação.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     */
+    static back(descriptionToAction: string, getSnapshot?: boolean): Promise<void>;
+    /**
+     * Realiza um gesto de swipe na tela.
+     * @param xInit Coordenada X inicial.
+     * @param yInit Coordenada Y inicial.
+     * @param xFinal Coordenada X final.
+     * @param yFinal Coordenada Y final.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param duracao Duração do swipe em ms.
+     */
+    static swipe(xInit: number, yInit: number, xFinal: number, yFinal: number, descriptionToAction: string, getSnapshot?: boolean, duracao?: number): Promise<void>;
+    /**
+     * Executa swipes até encontrar elemento.
+     * @param xInit Coordenada X inicial.
+     * @param yInit Coordenada Y inicial.
+     * @param xFinal Coordenada X final.
+     * @param yFinal Coordenada Y final.
+     * @param seletorElementoEsperado Seletor do elemento esperado.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param maxTentativas Número máximo de tentativas.
+     * @param duracao Duração do swipe em ms.
+     * @returns True se o elemento foi encontrado.
+     */
+    static swipeUntilFind(xInit: number, yInit: number, xFinal: number, yFinal: number, seletorElementoEsperado: string, descriptionToAction: string, getSnapshot?: boolean, maxTentativas?: number, duracao?: number): Promise<boolean>;
+    /**
+     * Obtém valor de atributo de um elemento.
+     * @param seletor Seletor do elemento.
+     * @param attributeName Nome do atributo.
+     * @param timeout Tempo máximo de espera em ms.
+     * @returns Valor do atributo.
+     */
+    static getAttribute(seletor: string, attributeName: string, timeout?: number): Promise<string>;
+    /**
+     * Simula cliques no teclado numérico.
+     * @param number Número a ser digitado.
+     * @param getSnapshot Se deve capturar screenshot.
+     */
+    static clickNumberPad(number: string, getSnapshot?: boolean): Promise<void>;
+    /**
+     * Executa script personalizado no driver.
+     * @param scriptType Tipo do script.
+     * @param jsonParams Parâmetros do script.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @returns Resultado do script.
+     */
+    static executeScript(scriptType: string, jsonParams: Record<string, any>, descriptionToAction: string, getSnapshot?: boolean): Promise<any>;
+    /**
+     * Executa swipe genérico Android.
+     * @param direcao Direção do swipe.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param distancia Distância do swipe (0 a 1).
+     */
+    static genericSwipeAndroid(direcao: Direcao, descriptionToAction: string, getSnapshot?: boolean, distancia?: number): Promise<void>;
+    /**
+     * Executa swipe genérico iOS.
+     * @param direcao Direção do swipe.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param distancia Distância do swipe (0 a 1).
+     */
+    static genericSwipeIOS(direcao: Direcao, descriptionToAction: string, getSnapshot?: boolean, distancia?: number): Promise<void>;
+    /**
+     * Executa swipe genérico Android até encontrar elemento.
+     * @param direcao Direção do swipe.
+     * @param seletorElementoEsperado Seletor do elemento esperado.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param maxTentativas Número máximo de tentativas.
+     * @param distancia Distância do swipe (0 a 1).
+     * @returns True se o elemento foi encontrado.
+     */
+    static genericSwipeUntilFindAndroid(direcao: Direcao, seletorElementoEsperado: string, descriptionToAction: string, getSnapshot?: boolean, maxTentativas?: number, distancia?: number): Promise<boolean>;
+    /**
+     * Executa swipe genérico iOS até encontrar elemento.
+     * @param direcao Direção do swipe.
+     * @param seletorElementoEsperado Seletor do elemento esperado.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param maxTentativas Número máximo de tentativas.
+     * @param distancia Distância do swipe (0 a 1).
+     * @returns True se o elemento foi encontrado.
+     */
+    static genericSwipeUntilFindIOS(direcao: Direcao, seletorElementoEsperado: string, descriptionToAction: string, getSnapshot?: boolean, maxTentativas?: number, distancia?: number): Promise<boolean>;
+    /**
+     * Realiza clique em elemento com verificação de presença.
+     * @param seletor Seletor do elemento.
+     * @param descriptionToAction Descrição da ação.
+     * @param getSnapshot Se deve capturar screenshot.
+     * @param timeout Tempo máximo de espera em ms.
+     */
+    static clickOnObjectPresence(seletor: string, descriptionToAction: string, getSnapshot?: boolean, timeout?: number): Promise<void>;
+    /**
+     * Copia texto para o clipboard (Android/iOS).
+     * @param text Texto a ser copiado.
+     * @param descriptionToAction Descrição da ação.
+     */
+    static setClipboardText(text: string, descriptionToAction?: string): Promise<void>;
+    /**
+     * Obtém texto do clipboard (Android/iOS).
+     * @param descriptionToAction Descrição da ação.
+     * @returns Texto do clipboard.
+     */
+    static getClipboardText(descriptionToAction?: string): Promise<string>;
+    /**
+     * Executa comando shell (Android).
+     * @param command Comando shell.
+     * @param args Argumentos do comando.
+     * @param descriptionToAction Descrição da ação.
+     * @returns Resultado do comando.
+     */
+    static executeShellCommand(command: string, args?: string[], descriptionToAction?: string): Promise<any>;
+    /**
+     * Fecha o app e relança (forceAppLaunch).
+     * @param descriptionToAction Descrição da ação.
+     */
+    static relaunchApp(descriptionToAction?: string): Promise<void>;
+    /**
+     * ✅ MELHORADO: Captura screenshot robusto com múltiplas tentativas
+     * @param nome Nome do screenshot
+     * @returns Buffer da imagem ou null
+     */
+    static capturarScreenshot(nome: string): Promise<Buffer | null>;
+    /**
+     * Salva screenshot como arquivo local e integra com DeviceFarmViewer
+     */
+    private static saveScreenshotFile;
+    /**
+     * Anexa screenshot ao relatório Playwright
+     */
+    private static attachScreenshotToReport;
+    /**
+     * Registra screenshot no sistema unificado
+     */
+    private static logScreenshotToUnified;
+    /**
+     * ✅ MELHORADO: Captura screenshot forçado com verificação DeviceFarm
+     * @param nome Nome do screenshot
+     * @returns Promise<boolean> True se conseguiu capturar
+     */
+    static capturarScreenshotForcado(nome: string): Promise<boolean>;
+    /**
+     * Valida se dois valores são iguais.
+     * @param atual Valor atual.
+     * @param esperado Valor esperado.
+     * @param descricao Descrição da validação.
+     */
+    static validateEquals(atual: any, esperado: any, descricao: string): Promise<void>;
+    /**
+     * 🎯 SELETOR PARA O ELEMENTO Wi-Fi (iOS DeviceFarm)
+     * Baseado nas propriedades: type=XCUIElementTypeCell, name=Wi‑Fi, value=VivoQA_5G
+     */
+    static getWiFiSettingSelector(): string;
+    /**
+     * 🎯 SELETORES ALTERNATIVOS para fallback (iOS)
+     */
+    static getWiFiFallbackSelectors(): string[];
+    /**
+     * 🔍 CLIQUE INTELIGENTE no elemento Wi-Fi com múltiplas estratégias (iOS)
+     */
+    static clickWiFiSetting(descriptionToAction?: string, getSnapshot?: boolean): Promise<boolean>;
+    /**
+     * 🔍 CLIQUE POR COORDENADAS do elemento Wi-Fi (iOS)
+     * Baseado nas propriedades: x=20, y=526, width=390, height=45
+     */
+    static clickWiFiByCoordinates(descriptionToAction?: string, getSnapshot?: boolean): Promise<boolean>;
+    /**
+     * 🔍 ESTRATÉGIA COMBINADA: Tentar seletores primeiro, depois coordenadas (iOS)
+     */
+    static clickWiFiCombined(descriptionToAction?: string, getSnapshot?: boolean): Promise<boolean>;
+    /**
+     * 🔍 VERIFICAR se elemento Wi-Fi está presente na tela (iOS)
+     */
+    static isWiFiSettingVisible(): Promise<boolean>;
+    /**
+     * 🔍 OBTER informações do elemento Wi-Fi (iOS)
+     */
+    static getWiFiElementInfo(): Promise<any>;
+}