@silasfmartins/testhub 1.0.0

package/dist/src/utils/testRecovery/ResilientPlaywright.d.ts

@@ -0,0 +1,152 @@
+import type { Page } from "@playwright/test";
+import { type ActionType, type PageElement } from "./TestRecoveryClient.js";
+/**
+ * Captura o HTML completo da página atual
+ * Use como fallback quando MCP não está disponível
+ *
+ * @example
+ * ```typescript
+ * const html = await capturePageHtml(page)
+ * // Enviar para analyzeFailure({ ..., pageHtml: html })
+ * ```
+ */
+export declare function capturePageHtml(page: Page): Promise<string>;
+/**
+ * Captura screenshot da página em Base64
+ * Útil para auditoria visual
+ *
+ * @example
+ * ```typescript
+ * const screenshot = await captureScreenshotBase64(page)
+ * // Enviar para analyzeFailure({ ..., screenshot })
+ * ```
+ */
+export declare function captureScreenshotBase64(page: Page): Promise<string>;
+/** Contexto adicional para recovery */
+export interface RecoveryContext {
+    text?: string;
+    value?: string;
+    role?: string;
+    ariaLabel?: string;
+    type?: string;
+    nearbyElements?: string[];
+    originalMethod?: string;
+    filledInputs?: string[];
+    filledFields?: string[];
+}
+export declare class ResilientPlaywright {
+    private recovery;
+    private page;
+    constructor(page: Page, sessionId?: string, systemName?: string, environment?: string);
+    private detectErrorType;
+    /** Tracks whether we switched into a frame during recovery */
+    private _inRecoveryFrame;
+    private executeAction;
+    /**
+     * Retorna ao contexto default após switch_frame de recovery
+     */
+    private switchToDefaultIfNeeded;
+    /**
+     * 🔄 Força atualização/estabilização do DOM antes de re-tentar localizar elementos.
+     * Essencial para SPAs (ex.: Salesforce Lightning/Vlocity) que recriam Shadow DOM a cada interação.
+     *
+     * 1. waitForLoadState('domcontentloaded')
+     * 2. Force reflow + aguardar Custom Elements pendentes (whenDefined)
+     * 3. requestAnimationFrame + microtask cycle
+     *
+     * @param {number} [stabilityMs=300] Tempo mínimo em ms para considerar o DOM estável.
+     */
+    /** Timestamp do último refreshDOM (debounce) */
+    private _lastDOMRefreshTime;
+    private refreshDOM;
+    /**
+     * Loop genérico de recovery com ordem recomendada (v2.7.43):
+     * 1. Executar actions[] (incluindo switch_frame)
+     * 2. Tentar suggestedXPath
+     * 3. Tentar alternatives[] (todas, até o limite de retries)
+     * 4. Chamar report-result com sucesso/falha (prioriza logId)
+     * 5. Se sucesso com confiança >= 0.7, chamar auto-fix-local
+     * 6. Gerenciar contexto de frame (switchToDefault quando necessário)
+     */
+    private withRecoveryLoop;
+    /**
+     * Dispara auto-fix-local em background (v2.7.44)
+     * Não bloqueia o fluxo de execução
+     *
+     * Prioriza chamada via MCP local (fix_xpath_in_attributes) quando disponível.
+     * Fallback para HTTP backend se MCP não estiver acessível.
+     */
+    private triggerAutoFixLocal;
+    click(xpath: string, options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<void>;
+    fill(xpath: string, value: string, options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<void>;
+    /**
+     * Select com auto-recovery (dropdown/combobox)
+     */
+    select(xpath: string, value: string | string[], options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<void>;
+    /**
+     * Hover com auto-recovery
+     */
+    hover(xpath: string, options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<void>;
+    /**
+     * Check com auto-recovery (checkbox/radio)
+     */
+    check(xpath: string, options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<void>;
+    /**
+     * Uncheck com auto-recovery (checkbox)
+     */
+    uncheck(xpath: string, options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<void>;
+    /**
+     * Press com auto-recovery (teclas como Enter, Tab, Escape)
+     */
+    press(xpath: string, key: string, options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<void>;
+    /**
+     * Método genérico para qualquer ação com auto-recovery
+     * Útil quando você quer especificar o actionType manualmente
+     */
+    action<T>(actionType: ActionType, xpath: string, executor: (locator: ReturnType<Page["locator"]>) => Promise<T>, options?: {
+        timeout?: number;
+        retries?: number;
+    }): Promise<T>;
+    /**
+     * Captura estrutura da página usando extractBasicPageStructure
+     * Útil para obter estrutura manualmente antes de chamar analyzeFailure
+     */
+    capturePageStructure(): Promise<{
+        buttons: PageElement[];
+        inputs: PageElement[];
+        links: PageElement[];
+        elements: PageElement[];
+    }>;
+    /**
+     * Captura HTML completo da página
+     * Fallback quando MCP não está disponível
+     */
+    capturePageHtml(): Promise<string>;
+    /**
+     * Captura screenshot em Base64
+     * Útil para auditoria visual
+     */
+    captureScreenshotBase64(): Promise<string>;
+}
+export default ResilientPlaywright;