@silasfmartins/testhub 1.0.0

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

@@ -0,0 +1,395 @@
+/**
+ * 📚 HubDocs - Sistema Principal de Documentação Automática (Versão Funcional)
+ * @silasfmartins/testhub - Auto Documentation System v1.1.51
+ */
+export interface DocsConfig {
+    enabled: boolean;
+    categories: string[];
+    outputDir: string;
+    includeRequestBody: boolean;
+    includeResponseBody: boolean;
+    generateSwagger: boolean;
+    includeScreenshots: boolean;
+    maxScreenshotSize?: number;
+    projectName?: string;
+}
+export declare class AutoDocs {
+    private static initialized;
+    private static finalizationExecuted;
+    private static config;
+    /**
+     * 🚀 Inicializar o sistema AutoDocs
+     */
+    static initialize(options?: {
+        projectName?: string;
+        outputDir?: string;
+        config?: Partial<DocsConfig>;
+    }): Promise<void>;
+    /**
+     * 📖 Gerar documentação completa
+     */
+    static generateDocs(): Promise<void>;
+    /**
+     * 📄 Gerar relatório HTML principal
+     */
+    private static generateHTMLReport;
+    /**
+     * 📄 Gerar documentação básica quando não há dados
+     */
+    private static generateEmptyDocsReport;
+    /**
+     * 🔄 Reset do sistema (APENAS EM DESENVOLVIMENTO)
+     */
+    static reset(): void;
+    /**
+     * 🌐 Interceptar chamada de API
+     * DESABILITADO: Evita duplicação com ApiActions que já faz interceptação
+     */
+    static interceptAPI(operation: string, endpoint?: string, config?: any): Promise<string>;
+    /**
+     * 🔄 Atualizar resultado de API
+     * DESABILITADO: Evita duplicação com ExecutionTracker
+     */
+    static updateAPIResult(docId: string, response?: any, statusCode?: number, error?: any): Promise<void>;
+    /**
+     * 🎯 Registrar AutoDocs globalmente para ApiActions
+     */
+    private static registerGlobally;
+    /**
+     * 🔗 Configurar interceptação automática de fetch
+     * DESABILITADO: Para evitar duplicação com ApiActions
+     */
+    private static setupFetchInterception;
+    /**
+     * 🎯 Verificar se URL deve ser interceptada
+     * CORRIGIDO: Não interceptar URLs que já são processadas pelo ApiActions
+     */
+    private static shouldInterceptURL;
+    /**
+     * 🔄 Processar fetch interceptado
+     */
+    private static handleInterceptedFetch;
+    /**
+     * 📥 Atualizar resposta do fetch
+     */
+    private static updateFetchResponse;
+    /**
+     * ❌ Atualizar erro do fetch
+     */
+    private static updateFetchError;
+    /**
+     * 🔧 NOVO: Método para forçar geração da documentação
+     */
+    static forceGenerate(): Promise<void>;
+    /**
+     * 🖥️ Interceptar comando SSH
+     */
+    static interceptSSH(command: string, host?: string, details?: any): Promise<void>;
+    /**
+     * 🗄️ Interceptar query de banco
+     */
+    static interceptDB(query: string, params?: any[], dbType?: string, description?: string, serviceName?: string): void;
+    /**
+     * 🔄 Atualizar resultado de query de banco
+     */
+    static updateDBResult(query: string, timestamp: string, success: boolean, duration: number, error?: string, resultCount?: number): void;
+    /**
+     * 🔄 Atualizar resultado de comando SSH
+     */
+    static updateSSHResult(command: string, timestamp: string, success: boolean, duration: number, exitCode?: number, error?: string): void;
+    /**
+     * 🎨 Interceptar ação de UI
+     */
+    static interceptUI(action: string, element?: string, url?: string, details?: any): Promise<void>;
+    /**
+     * 🆕 Atualizar status de sucesso de uma ação UI
+     */
+    static updateActionSuccess(action: string, element: string, success: boolean, duration: number, error?: string): void;
+    /**
+     * 📱 Interceptar ação mobile
+     */
+    static interceptMobile(action: string, element?: string, platform?: string, details?: any): Promise<void>;
+    /**
+     * 🧹 Extrair nome limpo do CT removendo logs excessivos
+     */
+    private static extractCleanCTName;
+    /**
+     * 🔐 Escapar HTML para segurança
+     */
+    private static escapeHtml;
+    /**
+     * 🖼️ Resolve caminho de imagem para data URI quando possível
+     */
+    private static resolveImageSource;
+    /**
+     * 🧪 Converte buffer de imagem em data URI
+     */
+    private static toDataUri;
+    /**
+     * 🎨 Detecta MIME-Type básico pelo sufixo do arquivo
+     */
+    private static detectMimeType;
+    /**
+     * 🔍 Detectar versão do AutoCore instalada dinamicamente
+     */
+    private static getProjectVersion;
+    /**
+     * 🎨 Gerar conteúdo HTML com dados usando TailwindCSS e funcionalidades completas
+     */
+    private static generateHTMLContent;
+    /**
+     * 🤖 Detectar tipo de projeto automaticamente
+     */
+    private static detectProjectType;
+    /**
+     * 🔧 Detectar tipo de query SQL
+     */
+    private static detectQueryType;
+    /**
+     * 🔧 Verificar se há dados para gerar
+     */
+    private static hasDataToGenerate;
+    /**
+     * 📝 Obter nome do teste atual
+     */
+    private static getCurrentTestName;
+    /**
+     * 📊 Gerar seções agrupadas inteligentemente
+     */
+    private static generateGroupedSections;
+    /**
+     * 🎨 Obter cor do grupo
+     */
+    private static getGroupColor;
+    /**
+     * 📊 Gerar overview do projeto
+     */
+    private static generateProjectOverview;
+    /**
+     * 🧭 Gerar menu de navegação
+     */
+    private static generateNavigationMenu;
+    /**
+     * 📊 Gerar estatísticas gerais
+     */
+    private static generateOverallStats;
+    /**
+          <div class="grid grid-cols-1 md:grid-cols-2 lg:grid-cols-5 gap-6 mb-8">
+              <div class="card bg-gradient-to-br from-green-600 to-green-700">
+                  <h3 class="text-3xl font-bold text-white">${data.apis.length}</h3>
+                  <p class="text-green-100">🌐 APIs Documentadas</p>
+              </div>
+              <div class="card bg-gradient-to-br from-blue-600 to-blue-700">
+                  <h3 class="text-3xl font-bold text-white">${data.ssh.length}</h3>
+                  <p class="text-blue-100">🖥️ Comandos SSH</p>
+              </div>
+              <div class="card bg-gradient-to-br from-purple-600 to-purple-700">
+                  <h3 class="text-3xl font-bold text-white">${data.db.length}</h3>
+                  <p class="text-purple-100">🗄️ Queries Database</p>
+              </div>
+              <div class="card bg-gradient-to-br from-orange-600 to-orange-700">
+                  <h3 class="text-3xl font-bold text-white">${data.ui.length}</h3>
+                  <p class="text-orange-100">🎨 Ações UI</p>
+              </div>
+              <div class="card bg-gradient-to-br from-pink-600 to-pink-700">
+                  <h3 class="text-3xl font-bold text-white">${data.mobile.length}</h3>
+                  <p class="text-pink-100">📱 Ações Mobile</p>
+              </div>
+          </div>
+  
+          ${AutoDocs.generateAPISection(data.apis)}
+          ${AutoDocs.generateSSHSection(data.ssh)}
+          ${AutoDocs.generateDBSection(data.db)}
+          ${AutoDocs.generateUISection(data.ui)}
+          ${AutoDocs.generateMobileSection(data.mobile)}
+  
+          <!-- Footer -->
+          <div class="footer-bar">
+              <p>Documentação gerada automaticamente pelo AutoDocs (${projectVersion}) em ${new Date().toLocaleString('pt-BR')}</p>
+          </div>
+      </div>
+  
+      <script>
+          function toggleTheme() {
+              document.body.classList.toggle('light-mode');
+              localStorage.setItem('theme', document.body.classList.contains('light-mode') ? 'light' : 'dark');
+          }
+  
+          function exportData(format) {
+              const data = ${JSON.stringify(data)};
+              
+              if (format === 'pdf') {
+                  const element = document.querySelector('.container');
+                  
+                  html2canvas(element, {
+                      scale: 2,
+                      useCORS: false,
+                      allowTaint: true,
+                      backgroundColor: '#fff'
+                  }).then(canvas => {
+                      const { jsPDF } = jspdf;
+                      const pdf = new jsPDF({
+                          orientation: 'portrait',
+                          unit: 'in',
+                          format: 'letter'
+                      });
+                      
+                      const imgData = canvas.toDataURL('image/jpeg', 0.98);
+                      const imgWidth = 8.5;
+                      const pageHeight = 11;
+                      const imgHeight = (canvas.height * imgWidth) / canvas.width;
+                      let heightLeft = imgHeight;
+                      let position = 0;
+                      
+                      pdf.addImage(imgData, 'JPEG', 0, position, imgWidth, imgHeight);
+                      heightLeft -= pageHeight;
+                      
+                      while (heightLeft > 0) {
+                          position = heightLeft - imgHeight;
+                          pdf.addPage();
+                          pdf.addImage(imgData, 'JPEG', 0, position, imgWidth, imgHeight);
+                          heightLeft -= pageHeight;
+                      }
+                      
+                      pdf.save('${AutoDocs.config.projectName}_autodocs.pdf');
+                  });
+              } else if (format === 'json') {
+                  const dataStr = JSON.stringify(data, null, 2);
+                  const dataBlob = new Blob([dataStr], {type: 'application/json'});
+                  const url = URL.createObjectURL(dataBlob);
+                  const link = document.createElement('a');
+                  link.href = url;
+                  link.download = '${AutoDocs.config.projectName}_autodocs.json';
+                  link.click();
+              }
+          }
+  
+          // Load saved theme
+          const savedTheme = localStorage.getItem('theme');
+          if (savedTheme === 'light') {
+              document.body.classList.add('light-mode');
+          }
+      </script>
+  </body>
+  </html>`
+    }
+  
+    /**
+     * 📊 Gerar visualização por CTs (Cenários de Teste)
+     * CORRIGIDO: Usar a mesma estratégia do UnifiedReportManager
+     */
+    private static generateCTViewHTMLContent;
+    /**
+     * �🎨 Gerar conteúdo HTML vazio
+     */
+    private static generateEmptyHTMLContent;
+    /**
+     * 🌐 Gerar seção de APIs com detalhes completos
+     */
+    private static generateAPISection;
+    /**
+     * 🖥️ Gerar seção SSH com detalhes completos
+     */
+    private static generateSSHSection;
+    /**
+     * 🎨 Obter classe TailwindCSS para tipo de query
+     */
+    private static getQueryTypeBadgeClass;
+    /**
+     * 🗄️ Gerar seção Database com detalhes completos
+     */
+    private static generateDBSection;
+    /**
+     * 🎨 Obter classe TailwindCSS para ação de UI
+     */
+    private static getUIActionBadgeClass;
+    /**
+     * 🎨 Gerar seção UI com detalhes completos
+     */
+    private static generateUISection;
+    /**
+     * 📱 Gerar seção Mobile com detalhes completos
+     */
+    private static generateMobileSection;
+    /**
+     * 🎨 Obter classe TailwindCSS para ação mobile
+     */
+    private static getMobileActionBadgeClass;
+    /**
+     * 🎨 Obter cor do tipo de query
+     */
+    private static getQueryTypeColor;
+    /**
+     * 🎨 Obter cor da ação UI
+     */
+    private static getUIActionColor;
+    /**
+     * 🎨 Obter cor da ação mobile
+     */
+    private static getMobileActionColor;
+    /**
+     * 📋 Gerar documentação Swagger detalhada
+     */
+    private static generateSwaggerDocs;
+    /**
+     * 🖥️ Extrair servidores das URLs das APIs
+     */
+    private static extractServers;
+    /**
+     * 🛤️ Gerar paths detalhados do Swagger
+     */
+    private static generateDetailedSwaggerPaths;
+    /**
+     * 📊 Gerar schemas do Swagger baseado nos dados
+     */
+    private static generateSwaggerSchemas;
+    /**
+     * 🏷️ Gerar tags do Swagger
+     */
+    private static generateSwaggerTags;
+    /**
+     * 🤖 Detectar categorias automaticamente baseado nos endpoints executados
+     */
+    private static detectProjectCategories;
+    /**
+     * 🏷️ Categorizar endpoint com base nas categorias detectadas dinamicamente
+     */
+    private static categorizeEndpointDynamic;
+    /**
+     * 🎯 Categorizar endpoint
+     */
+    private static categorizeEndpoint;
+    /**
+     * 📄 Converter para YAML
+     */
+    private static convertToYaml;
+    /**
+     * 🧹 Limpar objeto para conversão YAML
+     */
+    private static cleanObjectForYaml;
+    /**
+     * 🔍 Inferir schema de um objeto
+     * ✅ CORRIGIDO: Tipos válidos OpenAPI 3.0 (array, boolean, integer, number, object, string)
+     * ✅ CORRIGIDO: required só é adicionado se tiver pelo menos 1 item
+     */
+    private static inferSchema;
+    /**
+     * 📝 Gerar nome de schema
+     * ✅ CORRIGIDO: Sanitiza caracteres inválidos (OpenAPI só permite A-Z a-z 0-9 - . _)
+     */
+    private static generateSchemaName;
+    /**
+     * 🔧 Sanitizar nome de schema para OpenAPI
+     * OpenAPI só permite: A-Z a-z 0-9 - . _
+     */
+    private static sanitizeSchemaName;
+    /**
+     * 🔧 Extrair parâmetros da API
+     */
+    private static extractParameters;
+    /**
+     * 🛤️ Gerar paths do Swagger
+     */
+    private static generateSwaggerPaths;
+    private static ensureOutputDir;
+}