@silasfmartins/testhub 1.0.0

package/dist/src/hubdocs/StatementTracker.d.ts

@@ -0,0 +1,417 @@
+/**
+ * 🎯 INTERCEPTADOR AUTOMÁTICO DE STATEMENTS
+ * Sistema 100% automático - detecta tudo pelos logs existentes
+ * Integrado com ExecutionTracker e relatórios HTML
+ * @version 3.1.0 - PERSISTÊNCIA AUTOMÁTICA ANTI-PERDA
+ */
+type Statement = {
+    name: string;
+    className: string;
+    methodName: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    status: 'running' | 'passed' | 'failed';
+    error?: string;
+    executedActions?: Array<{
+        type: 'API' | 'SSH' | 'DB' | 'UI' | 'MOBILE' | 'OTHER';
+        description: string;
+        timestamp: string;
+        duration?: number;
+        success?: boolean;
+        details?: {
+            method?: string;
+            url?: string;
+            statusCode?: number;
+            command?: string;
+            query?: string;
+            selector?: string;
+            selectorType?: string;
+            action?: string;
+            requestHeaders?: Record<string, string>;
+            requestBody?: string;
+            responseHeaders?: Record<string, string>;
+            responseBody?: string;
+        };
+    }>;
+};
+type AutoCT = {
+    name: string;
+    startTime: number;
+    endTime?: number;
+    duration?: number;
+    status: 'running' | 'passed' | 'failed' | 'skipped';
+    error?: string;
+    systemName?: string;
+    statements: Statement[];
+    actions?: string[];
+    executedActions?: Array<{
+        type: 'API' | 'SSH' | 'DB' | 'UI' | 'MOBILE' | 'OTHER';
+        description: string;
+        timestamp: string;
+        duration?: number;
+        success?: boolean;
+        details?: {
+            method?: string;
+            url?: string;
+            statusCode?: number;
+            command?: string;
+            query?: string;
+            selector?: string;
+            selectorType?: string;
+            action?: string;
+            requestHeaders?: Record<string, string>;
+            requestBody?: string;
+            responseHeaders?: Record<string, string>;
+            responseBody?: string;
+        };
+    }>;
+    logs?: string[];
+    logStartIndex?: number;
+    logEndIndex?: number;
+    ctId?: string;
+    ctName?: string;
+    ctOrder?: number;
+    className?: string;
+    methodName?: string;
+    timestamp?: string;
+    parentTest?: string;
+};
+type AutoCTExecutionData = {
+    testName: string;
+    cts: AutoCT[];
+    totalDuration: number;
+    totalCTs: number;
+    passedCTs: number;
+    failedCTs: number;
+    systemName?: string;
+    parentTest?: string;
+    ctId?: string;
+    ctName?: string;
+    ctOrder?: number;
+    status?: 'running' | 'passed' | 'failed' | 'skipped';
+    duration?: number;
+    timestamp?: string | number;
+    error?: string;
+    className?: string;
+    methodName?: string;
+};
+/**
+ * 📊 RASTREADOR AUTOMÁTICO DE CTs
+ * ZERO CONFIGURAÇÃO - DETECÇÃO AUTOMÁTICA + INTEGRAÇÃO COM RELATÓRIOS
+ */
+export declare class StatementTracker {
+    /**
+     * 🛑 Flag global para indicar que algum CT falhou com stopOnFailure ativo
+     * Quando true, todos os próximos CTs devem ser pulados
+     */
+    private static hasFailedWithStopOnFailure;
+    /**
+     * 🔒 Controle de duplicação de logs - evita logs repetidos
+     */
+    private static lastLoggedCT;
+    private static lastLoggedRequest;
+    private static lastRequestTimestamp;
+    private static ctLogStreams;
+    /**
+     * ✅ CORRIGIDO: Criar CT automaticamente se não existir - VERSÃO ROBUSTA
+     * Um CT é criado por test(), não por statement!
+     * 🔧 FIX: Verificar se já existe CT com o MESMO NOME, não apenas status='running'
+     * ✅ AGORA COM FALLBACKS ROBUSTOS PARA PROJETOS CONSUMIDORES
+     */
+    static ensureCTCreated(): void;
+    /**
+     * 🎯 MÉTODO AUXILIAR: Detectar CT via análise de contexto de execução
+     * Para projetos consumidores onde TestContext pode não estar disponível
+     */
+    private static detectCTFromExecutionContext;
+    private static getCTStreamKey;
+    private static startCTLogStream;
+    private static stopCTLogStream;
+    /**
+     * 🚫 PADRÕES DE LOGS INTERNOS QUE NÃO DEVEM SER ENVIADOS PARA O TESTHUB
+     * Estes são logs do próprio framework, não logs úteis do teste
+     */
+    private static readonly INTERNAL_LOG_PATTERNS;
+    /**
+     * 🔍 Verifica se um log é interno do framework e deve ser filtrado
+     */
+    private static isInternalLog;
+    private static hydrateCTLogs;
+    /**
+     * ✅ CORRIGIDO: Pegar nome do CT atual (test()) - VERSÃO ROBUSTA COM MÚLTIPLOS FALLBACKS
+     * ES MODULES PURO + COMPATIBILIDADE TOTAL COM PROJETOS CONSUMIDORES
+     */
+    static getCurrentCTName(): string | null;
+    /**
+     * ✅ CORRIGIDO: Registrar início de um Statement (método)
+     * 🔧 FIX: Buscar CT pelo NOME, não pelo último índice
+     * 🆕 AGORA COM CRIAÇÃO AUTOMÁTICA DE CT SE NÃO EXISTIR
+     */
+    static startStatement(className: string, methodName: string): number;
+    /**
+     * ✅ CORRIGIDO: Registrar fim de um Statement
+     * 🔧 FIX: Buscar CT pelo NOME, não pelo último índice
+     */
+    static finishStatement(timestamp: number, success: boolean, error?: string): void;
+    static waitForDataReady(): Promise<void>;
+    /**
+     * ✅ NOVO: Finalizar e persistir todos os dados
+     * Salva ct-execution-data.json com dados completos
+     */
+    static finalize(): Promise<void>;
+    private static get executions();
+    private static get currentTest();
+    private static set currentTest(value);
+    private static get ctCounter();
+    private static set ctCounter(value);
+    private static get currentCTName();
+    private static set currentCTName(value);
+    private static get ctAutoCreated();
+    private static set ctAutoCreated(value);
+    /**
+     * 🆕 Define o sistema atual (chamado por TestAnnotations.setSystem)
+     */
+    static setCurrentSystem(systemName: string): void;
+    /**
+     * 🆕 Obtém o sistema atual
+     */
+    private static getCurrentSystem;
+    /**
+     * � Obtém referência segura dos logs capturados globalmente
+     */
+    /**
+     * 🆕 Obtém o sistema do CT em execução (público para uso externo)
+     * Retorna o sistema configurado via setSystem() para o CT atual
+     * @returns {string | null} Nome do sistema ou null se não configurado
+     */
+    static getCurrentCTSystem(): string | null;
+    /**
+     * 📝 Obtém logs globais normalizados (com índice + nível)
+     * 🔧 ATUALIZADO: Trabalha com índices globais para permitir fatiamento preciso por CT
+     */
+    private static getGlobalLogs;
+    private static gatherLogsFromTerminalCapture;
+    private static gatherLogsFromSharedFile;
+    private static gatherLegacyLogs;
+    private static normalizeLogs;
+    private static normalizeSingleLog;
+    private static formatLogEntry;
+    private static captureLogsBetweenIndices;
+    private static getLogsFromTestScope;
+    private static buildFallbackLogs;
+    private static getCurrentGlobalLogIndex;
+    /**
+     * 📊 Recalcula estatísticas derivadas com base nos CTs registrados
+     */
+    private static recomputeTestStats;
+    /**
+     * ��🔄 Obtém caminho do arquivo de persistência
+     */
+    private static getDataFilePath;
+    /**
+     * ⏱️ Formatar duração em formato legível
+     */
+    private static formatDuration;
+    /**
+     * 💾 Salva dados automaticamente no arquivo
+     * 🛡️ CORRIGIDO: Mescla com dados existentes antes de salvar (multi-worker safe)
+     */
+    private static saveDataToFile;
+    /**
+     * 🔄 FORÇA CARREGAMENTO DOS DADOS DO ARQUIVO
+     * Usado pelo CustomReporter que roda em processo separado dos testes
+     * Garante que os CTs criados pelos testes estejam disponíveis no Reporter
+     * 🆕 AGORA SUPORTA MÚLTIPLOS ARQUIVOS DE WORKERS
+     */
+    static forceLoadFromFile(): void;
+    /**
+     * 📂 Carrega dados do arquivo de persistência
+     */
+    private static loadDataFromFile;
+    /**
+     * 🚫 LISTA DE MÉTODOS QUE NÃO SÃO CTs
+     * Métodos de validação, assertions e utilitários não devem ser tratados como CTs
+     * ✅ CORRIGIDO: Incluir métodos do BancoActions que são AÇÕES, não CTs
+     * 🎯 NOVO: Lista de métodos que são apenas ações internas, não CTs completos
+     *
+     * ⚠️ IMPORTANTE: Métodos como validateCep, processOrder são CTs REAIS!
+     * Apenas métodos auxiliares como assert, log, setup devem estar aqui.
+     */
+    private static readonly NON_CT_METHODS;
+    /**
+     * 🎯 LISTA DE MÉTODOS QUE SÃO APENAS AÇÕES INTERNAS (NÃO CTs)
+     * Estes métodos são chamados DENTRO de um CT real, mas não são CTs por si só
+     */
+    private static readonly INTERNAL_ACTION_METHODS;
+    /**
+     * 🔍 VERIFICA SE MÉTODO É UM CT OU AÇÃO INTERNA
+     * ✅ NOVA LÓGICA: CT real vs Ação interna
+     *
+     * Um CT REAL é um método da classe Statement que:
+     * 1. Não está na lista NON_CT_METHODS (utilitários)
+     * 2. Não está na lista INTERNAL_ACTION_METHODS (ações como select, execute, click, etc.)
+     * 3. Não é método privado (_method)
+     * 4. É o método PRINCIPAL da classe (como validateCep, processOrder, etc.)
+     */
+    private static isValidCTMethod;
+    /**
+     * 🎯 INTERCEPTAR CLASSE AUTOMATICAMENTE
+     * ✅ CORRIGIDO: Apenas interceptar classes Statement, não Actions
+     */
+    static interceptStatement<T extends object>(StatementClass: new () => T): new () => T;
+    /**
+     * 🚀 INICIAR CT (CASO DE TESTE) AUTOMATICAMENTE
+     */
+    static startCT(ctName: string): void;
+    /**
+     * 🏁 FINALIZAR CT (CASO DE TESTE) AUTOMATICAMENTE
+     */
+    static endCT(ctName: string, success: boolean, errorMessage?: string): void;
+    /**
+     * 🎯 REGISTRAR AÇÃO EXECUTADA DURANTE STATEMENT (DENTRO DO CT)
+     * @param type Tipo da ação (API, SSH, DB, UI, MOBILE, OTHER)
+     * @param description Descrição da ação executada
+     * @param success Se a ação foi bem-sucedida
+     * @param duration Duração em milissegundos
+     * @param details Detalhes específicos da ação (método, url, statusCode, command, query, selector, etc.)
+     */
+    static recordAction(type: 'API' | 'SSH' | 'DB' | 'UI' | 'MOBILE' | 'OTHER', description: string, success?: boolean, duration?: number, details?: {
+        method?: string;
+        url?: string;
+        statusCode?: number;
+        command?: string;
+        query?: string;
+        selector?: string;
+        selectorType?: string;
+        action?: string;
+        timeHold?: number;
+        requestHeaders?: Record<string, string>;
+        requestBody?: string;
+        responseHeaders?: Record<string, string>;
+        responseBody?: string;
+    }): void;
+    /**
+     * 📊 OBTER DADOS FORMATADOS PARA INTEGRAÇÃO COM RELATÓRIOS HTML
+     */
+    static getReportData(): any;
+    /**
+     * 📊 OBTER RELATÓRIO COMPLETO
+     */
+    static getFullReport(): AutoCTExecutionData[];
+    /**
+     * 🔢 OBTER TOTAL DE CTs
+     */
+    static getTotalCTs(): number;
+    /**
+     * 📈 OBTER ESTATÍSTICAS
+     */
+    static getStats(): {
+        totalCTs: number;
+        passedCTs: number;
+        failedCTs: number;
+        totalDuration: number;
+    };
+    /**
+     * 🔍 DETECTAR NOME DO TESTE AUTOMATICAMENTE - VERSÃO ROBUSTA COM MÚLTIPLOS FALLBACKS
+     * CORRIGIDO: Pega o CN (test.describe) com compatibilidade total para projetos consumidores
+     * ✅ ACEITA qualquer nome no test.describe, com ou sem prefixo "CN"
+     * ES MODULES PURO + COMPATIBILIDADE UNIVERSAL
+     */
+    private static getCurrentTestName;
+    /**
+     * 🏷️ DEFINIR NOME DO TESTE MANUALMENTE
+     * Use este método para garantir que o nome correto do teste seja usado
+     */
+    static setTestName(testName: string): void;
+    /**
+     * 🔍 OBTER NOME DO TESTE ATUAL (PÚBLICO)
+     * Retorna o nome do teste atual sendo executado
+     */
+    static getCurrentTest(): string;
+    /**
+     * ❌ FINALIZAR APENAS CTs "RUNNING" COMO "FAILED"
+     * ✅ PRESERVA CTs que já passaram (status='passed')
+     * ❌ Marca apenas CTs em execução (status='running') como failed
+     * 📊 Preserva duração, logs e ações de todos os CTs
+     */
+    /**
+     * ✅ NOVO: Finaliza CTs "running" como PASSED quando teste PASSOU
+     */
+    static finalizeRunningCTsAsPassed(testName?: string, ctName?: string): void;
+    /**
+     * ❌ Finaliza CTs "running" como FAILED quando teste FALHOU
+     */
+    static finalizeRunningCTsAsFailed(testName?: string, reason?: string, ctName?: string): void;
+    /**
+     * 🧹 LIMPAR DADOS
+     */
+    static clear(): void;
+    /**
+     * 📡 LOG DE REQUEST COM PROTEÇÃO ANTI-DUPLICAÇÃO
+     * Evita logs duplicados de requisições consecutivas idênticas
+     * @param method Método HTTP (POST, GET, PUT, DELETE)
+     * @param descricao Descrição da requisição
+     */
+    static logRequest(method: string, descricao: string): void;
+    /**
+     * 📋 IMPRIMIR RELATÓRIO
+     */
+    static printReport(): void;
+    /**
+     * 🚨 MÉTODO DE EMERGÊNCIA: Força criação de CT quando detecção falha
+     * Para projetos consumidores onde a detecção automática não funciona
+     */
+    static forceCreateCT(ctName?: string): void;
+    /**
+     * ✅ NOVO: Finaliza CT individual com status específico
+     * Chamado pelo CustomReporter quando cada test() termina
+     */
+    static finalizarCT(ctName: string, status: 'passed' | 'failed' | 'skipped', options?: {
+        testName?: string;
+        errorMessage?: string;
+    }): void;
+    /**
+     * 🎯 OBTER CT ATUAL
+     */
+    static getCurrentCT(): string | null;
+    /**
+     * 🛑 Marca que um CT falhou com stopOnFailure ativo
+     */
+    static markFailedWithStopOnFailure(): void;
+    /**
+     * 🛑 Verifica se algum CT já falhou com stopOnFailure ativo
+     */
+    static hasAnyTestFailedWithStopOnFailure(): boolean;
+    /**
+     * 🛑 Reseta a flag de falha (útil para novos describes)
+     */
+    static resetStopOnFailureFlag(): void;
+    /**
+     * 🛑 Carrega a flag de stopOnFailure do arquivo JSON (para comunicação entre processos)
+     * Retorna true se a flag foi encontrada e está ativa
+     */
+    static loadStopOnFailureFlagFromFile(): boolean;
+    /**
+     * 🛑 Verificar se stopOnFailure está ativo
+     * Esta função permite ao StatementTracker acessar a configuração do TestAnnotations
+     */
+    static isStopOnFailureEnabled(): boolean;
+    /**
+     * 💾 SALVAR DADOS DOS CTS EM ARQUIVO
+     */
+    static saveExecutionData(outputPath?: string): Promise<void>;
+    /**
+     * � OBTER EXECUÇÕES (GETTER PÚBLICO)
+     */
+    static getExecutions(): Map<string, AutoCTExecutionData>;
+    /**
+     * �🔗 INTEGRAR COM EXECUTION TRACKER
+     */
+    static integrateWithExecutionTracker(): void;
+}
+/**
+ * 🌐 FUNÇÃO AUTOMÁTICA PARA FÁCIL USO
+ */
+export declare const interceptStatement: typeof StatementTracker.interceptStatement;
+export {};