@silasfmartins/testhub 1.0.0

package/dist/src/helpers/BancoActions.d.ts

@@ -0,0 +1,188 @@
+import '../hubdocs/StatementTracker.js';
+/**
+ * Interface de configuração de conexão Oracle.
+ */
+export type IConnectionConfig = {
+    user: string;
+    password: string;
+    connectString: string;
+    options?: Record<string, unknown>;
+};
+/**
+ * Interface de opções para execução de queries Oracle.
+ */
+export type IExecuteOptions = {
+    autoCommit?: boolean;
+    bindParams?: Record<string, unknown> | unknown[];
+    outFormat?: number;
+};
+/**
+ * Tipos suportados para seleção de coluna.
+ */
+export declare const BancoType: {
+    readonly LONG: "LONG";
+    readonly VARCHAR: "VARCHAR";
+    readonly DOUBLE: "DOUBLE";
+    readonly INTEGER: "INTEGER";
+    readonly DATE: "DATE";
+};
+export type BancoType = (typeof BancoType)[keyof typeof BancoType];
+/**
+ * Classe de ações utilitárias para automação de banco Oracle.
+ * Inspirada no padrão Actions do Qandalf/Java.
+ * Todos métodos registram logs e metadados no UnifiedReportManager.
+ *
+ * ✅ CONSOLIDADO: Funcionalidades de BancoHelper foram integradas aqui.
+ */
+export declare class BancoActions {
+    private static successCount;
+    private static failureCount;
+    private static inicioExecucao;
+    private static fimExecucao;
+    private static queryExecutadas;
+    /**
+     * Registra o início da execução para relatórios.
+     */
+    static registrarInicioExecucao(): void;
+    /**
+     * Registra o fim da execução para relatórios.
+     */
+    static registrarFimExecucao(): void;
+    /**
+     * Registra um evento de log para o teste atual.
+     * @param message Mensagem de log.
+     */
+    static logEvent(message: string): void;
+    /**
+     * Marca que o BancoActions foi utilizado automaticamente.
+     * @private
+     */
+    private static marcarUsoAutomatico;
+    /**
+     * Executa uma query Oracle e retorna os resultados (método base).
+     * Registra logs, métricas e metadados no UnifiedReportManager.
+     * @param query Query SQL a ser executada.
+     * @param options Opções de execução (autoCommit, bindParams, outFormat).
+     * @returns Promise<Array<unknown>> Array de resultados.
+     */
+    static executarQuery(query: string, options?: IExecuteOptions): Promise<unknown[]>;
+    /**
+     * Executa uma instrução SQL (DDL/DML) com descrição.
+     * Registra logs e metadados no UnifiedReportManager.
+     * @param descriptionToAction Descrição da ação.
+     * @param sql SQL a ser executado.
+     * @returns Promise<void>
+     */
+    static execute(descriptionToAction: string, sql: string): Promise<void>;
+    /**
+     * Executa uma instrução SQL de consulta e retorna os resultados.
+     * Registra logs e metadados no UnifiedReportManager.
+     * @param sql SQL de consulta.
+     * @returns Promise<Array<any>> Array de resultados.
+     */
+    static executeQuery(sql: string): Promise<any[]>;
+    /**
+     * Executa uma instrução SQL de atualização com descrição.
+     * Registra logs e metadados no UnifiedReportManager.
+     * @param descriptionToAction Descrição da ação.
+     * @param sql SQL de update.
+     * @returns Promise<number> Número de linhas afetadas.
+     */
+    static update(descriptionToAction: string, sql: string): Promise<number>;
+    /**
+     * Executa uma instrução SQL de seleção e retorna os resultados.
+     * @param sql SQL de seleção.
+     * @returns Promise<Array<any>> Array de resultados.
+     */
+    static select(sql: string): Promise<any[]>;
+    /**
+     * Executa uma instrução SQL de seleção e retorna o valor de uma coluna, convertido para o tipo especificado.
+     * @param sql SQL de seleção.
+     * @param column Nome da coluna.
+     * @param type Tipo do valor (BancoType).
+     * @returns Promise<unknown> Valor da coluna convertido.
+     * @throws {Error} Se não houver resultados.
+     */
+    static selectColumn(sql: string, column: string, type: BancoType): Promise<unknown>;
+    /**
+     * Pausa a execução por um tempo fixo em segundos.
+     * @param time Tempo em segundos.
+     * @returns Promise<void>
+     */
+    static esperarPorTempo(time: number): Promise<void>;
+    /**
+     * Relata uma tabela de resultados no log em formato HTML.
+     * @param registros Array de registros.
+     * @returns void
+     */
+    static reportarTabela(registros: any[]): void;
+    /**
+     * 🆕 NOVO: Obtém informações da conexão atual de forma segura.
+     * @returns String com informações da conexão (sem senha).
+     */
+    static getConnectionInfo(): string;
+    /**
+     * 🆕 NOVO: Exibe detalhes dos resultados de uma consulta.
+     * @param resultado Array de resultados da consulta.
+     */
+    static exibirDetalhesResultados(resultado: any[]): Promise<void>;
+    /**
+     * 🆕 NOVO: Executa um serviço de banco com logs automáticos.
+     * @param descricao Descrição do serviço sendo executado.
+     * @param servico Função que executa o serviço.
+     * @returns Promise com resultado do serviço.
+     */
+    static executarServico<T>(descricao: string, servico: () => Promise<T>): Promise<T>;
+    /**
+     * Valida se dois valores são iguais.
+     * Registra sucesso ou falha nos logs e incrementa métricas.
+     * @param actual Valor atual.
+     * @param expected Valor esperado.
+     * @param message Mensagem descritiva da validação.
+     * @throws {Error} Se os valores não forem iguais.
+     */
+    static validateEquals<T>(actual: T, expected: T, message: string): void;
+    /**
+     * Verifica se o BancoActions foi utilizado.
+     * @returns true se houve queries executadas ou início de execução registrado.
+     */
+    static foiUtilizado(): boolean;
+    /**
+     * Registra duração do teste para relatórios.
+     * @param nome Nome do teste.
+     * @param duracao Duração em segundos.
+     */
+    static registrarDuracaoDoTeste(nome: string, duracao: number): void;
+    /**
+     * Obtém métricas do BancoActions.
+     * @returns Objeto com queryExecutadas, sucessos, erros e duracaoTotal.
+     */
+    static getMetrics(): {
+        queryExecutadas: number;
+        sucessos: number;
+        erros: number;
+        duracaoTotal: number;
+    };
+    /**
+     * Método unificado para anexar relatórios (delegado para UnifiedReportManager).
+     */
+    static anexarRelatorioFinal(): Promise<void>;
+    /**
+     * Limpa todos os dados para nova execução.
+     */
+    static limparTudo(): void;
+    /**
+     * Adiciona log ao UnifiedReportManager para o teste atual.
+     * @private
+     * @param message Mensagem de log a ser registrada.
+     */
+    private static logToUnified;
+    /**
+     * Registra metadados de ação no UnifiedReportManager.
+     * @private
+     * @param actionType Tipo da ação executada.
+     * @param success Indica se a ação foi bem-sucedida.
+     * @param duration Duração da ação em milissegundos.
+     */
+    private static addActionMetadata;
+}