@silasfmartins/testhub 1.0.0

package/dist/src/testhub/TestHubVars.d.ts

@@ -0,0 +1,116 @@
+/**
+ * TestHubVars: Acesso simplificado às variáveis de ambiente do TestHub
+ *
+ * Permite acessar variáveis cadastradas no AutoCore Hub de forma similar ao padrão Java:
+ * - Java: SFAConstants.URLSALESFORCE.getItem()
+ * - TypeScript: await TestHubVars.get('URLSALESFORCE')
+ *
+ * O sistema e ambiente são detectados automaticamente a partir de:
+ * - TestAnnotations.setSystem() - define o sistema atual
+ * - process.env.NODE_ENV ou process.env.ENV - define o ambiente
+ */
+/**
+ * Classe para acesso simplificado às variáveis do TestHub
+ *
+ * @example
+ * // No .spec.ts
+ * await TestAnnotations.setSystem('SALESFORCE')
+ *
+ * // Na Page/Statement
+ * const url = await TestHubVars.get('URLSALESFORCE')
+ * await WebActions.navegarPara(url, 'Navegando para Salesforce', false)
+ *
+ * // Ou de forma mais direta
+ * await WebActions.navegarPara(
+ *   await TestHubVars.get('URLSALESFORCE'),
+ *   'Navegando para Salesforce',
+ *   false
+ * )
+ */
+export declare class TestHubVars {
+    private static cache;
+    private static cacheDuration;
+    private static loadedEnvKeys;
+    /**
+     * 🔑 Obtém o valor de uma variável de ambiente do sistema atual
+     *
+     * @param variableKey Nome da variável (ex: 'URLSALESFORCE', 'API_TOKEN')
+     * @param defaultValue Valor padrão se a variável não existir
+     * @returns Valor da variável ou defaultValue
+     *
+     * @example
+     * // Uso básico
+     * const url = await TestHubVars.get('URLSALESFORCE')
+     *
+     * // Com valor padrão
+     * const timeout = await TestHubVars.get('TIMEOUT', '30000')
+     *
+     * // Em navegação - usar assim:
+     * const baseUrl = await TestHubVars.get('BASE_URL')
+     * await WebActions.navegarPara(baseUrl, 'Navegando', false)
+     */
+    static get(variableKey: string, defaultValue?: string): Promise<string>;
+    /**
+     * 🔑 Obtém múltiplas variáveis de uma vez
+     *
+     * @param variableKeys Array de nomes de variáveis
+     * @returns Objeto com chave-valor das variáveis
+     *
+     * @example
+     * const vars = await TestHubVars.getMany(['BASE_URL', 'API_TOKEN', 'TIMEOUT'])
+     * Logger.info(vars.BASE_URL)
+     */
+    static getMany(variableKeys: string[]): Promise<Record<string, string>>;
+    /**
+     * 🌍 Carrega todas as variáveis em process.env
+     *
+     * @param prefix Prefixo opcional (ex: 'TESTHUB_')
+     * @returns Número de variáveis carregadas
+     *
+     * @example
+     * await TestHubVars.loadToEnv()
+     * Logger.info(process.env.BASE_URL)
+     *
+     * await TestHubVars.loadToEnv('TESTHUB_')
+     * Logger.info(process.env.TESTHUB_BASE_URL)
+     */
+    static loadToEnv(prefix?: string): Promise<number>;
+    /**
+     * 🧹 Limpa o cache de variáveis
+     */
+    static clearCache(): void;
+    /**
+     * 🔄 Força recarregamento das variáveis
+     */
+    static refresh(): Promise<void>;
+    /**
+     * Obtém informações do sistema atual configurado
+     */
+    private static getCurrentSystemInfo;
+    /**
+     * Detecta o ambiente atual baseado em variáveis de ambiente
+     */
+    private static detectEnvironment;
+    /**
+     * Verifica se o cache é válido
+     */
+    private static isCacheValid;
+    /**
+     * Carrega variáveis do TestHub para o cache
+     */
+    private static loadVariables;
+}
+/**
+ * Alias curto para TestHubVars.get()
+ *
+ * @example
+ * import { getVar } from '@silasfmartins/testhub'
+ *
+ * const url = await getVar('URLSALESFORCE')
+ */
+export declare const getVar: typeof TestHubVars.get;
+/**
+ * Alias curto para TestHubVars
+ */
+export declare const Vars: typeof TestHubVars;
+export default TestHubVars;

package/dist/src/testhub/TestHubVars.js

@@ -0,0 +1,273 @@
+/**
+ * TestHubVars: Acesso simplificado às variáveis de ambiente do TestHub
+ *
+ * Permite acessar variáveis cadastradas no AutoCore Hub de forma similar ao padrão Java:
+ * - Java: SFAConstants.URLSALESFORCE.getItem()
+ * - TypeScript: await TestHubVars.get('URLSALESFORCE')
+ *
+ * O sistema e ambiente são detectados automaticamente a partir de:
+ * - TestAnnotations.setSystem() - define o sistema atual
+ * - process.env.NODE_ENV ou process.env.ENV - define o ambiente
+ */
+import { TestHubClient } from './TestHubClient.js';
+import SystemsManager from './SystemsManager.js';
+import { Logger } from '../utils/Logger.js';
+/**
+ * Classe para acesso simplificado às variáveis do TestHub
+ *
+ * @example
+ * // No .spec.ts
+ * await TestAnnotations.setSystem('SALESFORCE')
+ *
+ * // Na Page/Statement
+ * const url = await TestHubVars.get('URLSALESFORCE')
+ * await WebActions.navegarPara(url, 'Navegando para Salesforce', false)
+ *
+ * // Ou de forma mais direta
+ * await WebActions.navegarPara(
+ *   await TestHubVars.get('URLSALESFORCE'),
+ *   'Navegando para Salesforce',
+ *   false
+ * )
+ */
+export class TestHubVars {
+    static cache = null;
+    static cacheDuration = 5 * 60 * 1000; // 5 minutos
+    // keys that were loaded into process.env by TestHubVars.loadToEnv (full key names, including prefix if used)
+    static loadedEnvKeys = new Set();
+    /**
+     * 🔑 Obtém o valor de uma variável de ambiente do sistema atual
+     *
+     * @param variableKey Nome da variável (ex: 'URLSALESFORCE', 'API_TOKEN')
+     * @param defaultValue Valor padrão se a variável não existir
+     * @returns Valor da variável ou defaultValue
+     *
+     * @example
+     * // Uso básico
+     * const url = await TestHubVars.get('URLSALESFORCE')
+     *
+     * // Com valor padrão
+     * const timeout = await TestHubVars.get('TIMEOUT', '30000')
+     *
+     * // Em navegação - usar assim:
+     * const baseUrl = await TestHubVars.get('BASE_URL')
+     * await WebActions.navegarPara(baseUrl, 'Navegando', false)
+     */
+    static async get(variableKey, defaultValue) {
+        try {
+            // Prioridade 1: apenas considerar valores em process.env se foram carregados pelo TestHubVars.loadToEnv()
+            // Isso evita pegar variáveis locais do usuário (ex: USERNAME) quando não vieram do Hub.
+            const upKey = variableKey.toUpperCase();
+            if (this.loadedEnvKeys.has(variableKey) || this.loadedEnvKeys.has(upKey)) {
+                const envValue = process.env[variableKey] || process.env[upKey];
+                if (envValue) {
+                    Logger.info(`🔎 TestHubVars: variável ${variableKey} encontrada em process.env (carregada do Hub)`);
+                    return envValue;
+                }
+            }
+            // Obter sistema e ambiente atuais
+            const { systemName, environmentName } = this.getCurrentSystemInfo();
+            if (!systemName || !environmentName) {
+                // 🆕 Se não tem sistema, ainda tenta process.env
+                Logger.error(`⚠️ Sistema não configurado. Use TestAnnotations.setSystem() primeiro.`);
+                return defaultValue || '';
+            }
+            // Verificar cache
+            if (this.isCacheValid(systemName, environmentName)) {
+                const cachedValue = this.cache.variables.get(variableKey.toUpperCase());
+                if (cachedValue !== undefined) {
+                    return cachedValue;
+                }
+            }
+            // Buscar variáveis do TestHub
+            await this.loadVariables(systemName, environmentName);
+            // Retornar valor
+            const value = this.cache?.variables.get(variableKey.toUpperCase());
+            if (value !== undefined) {
+                Logger.info(`🔎 TestHubVars: variável ${variableKey} obtida do Portal Hub (${systemName}/${environmentName})`);
+                return value;
+            }
+            // Se não encontrou, tentar busca case-insensitive
+            for (const [key, val] of this.cache?.variables || []) {
+                if (key.toLowerCase() === variableKey.toLowerCase()) {
+                    return val;
+                }
+            }
+            Logger.error(`⚠️ Variável "${variableKey}" não encontrada em ${systemName}/${environmentName}`);
+            return defaultValue || '';
+        }
+        catch (error) {
+            Logger.error(`❌ Erro ao obter variável "${variableKey}":`, error);
+            return defaultValue || '';
+        }
+    }
+    /**
+     * 🔑 Obtém múltiplas variáveis de uma vez
+     *
+     * @param variableKeys Array de nomes de variáveis
+     * @returns Objeto com chave-valor das variáveis
+     *
+     * @example
+     * const vars = await TestHubVars.getMany(['BASE_URL', 'API_TOKEN', 'TIMEOUT'])
+     * Logger.info(vars.BASE_URL)
+     */
+    static async getMany(variableKeys) {
+        const result = {};
+        for (const key of variableKeys) {
+            result[key] = await this.get(key);
+        }
+        return result;
+    }
+    /**
+     * 🌍 Carrega todas as variáveis em process.env
+     *
+     * @param prefix Prefixo opcional (ex: 'TESTHUB_')
+     * @returns Número de variáveis carregadas
+     *
+     * @example
+     * await TestHubVars.loadToEnv()
+     * Logger.info(process.env.BASE_URL)
+     *
+     * await TestHubVars.loadToEnv('TESTHUB_')
+     * Logger.info(process.env.TESTHUB_BASE_URL)
+     */
+    static async loadToEnv(prefix = '') {
+        const { systemName, environmentName } = this.getCurrentSystemInfo();
+        if (!systemName || !environmentName) {
+            Logger.error('⚠️ Sistema não configurado');
+            return 0;
+        }
+        const client = TestHubClient.getInstance();
+        const variables = await client.getEnvironmentVariables(systemName, environmentName);
+        let loaded = 0;
+        for (const variable of variables) {
+            const envKey = prefix ? `${prefix}${variable.key}` : variable.key;
+            process.env[envKey] = variable.value;
+            this.loadedEnvKeys.add(envKey);
+            this.loadedEnvKeys.add(envKey.toUpperCase());
+            loaded++;
+            Logger.info(`   ✅ ${envKey} carregada`);
+        }
+        Logger.info(`📦 ${loaded} variável(is) carregada(s) em process.env`);
+        return loaded;
+    }
+    /**
+     * 🧹 Limpa o cache de variáveis
+     */
+    static clearCache() {
+        this.cache = null;
+        Logger.info('🧹 Cache de variáveis limpo');
+    }
+    /**
+     * 🔄 Força recarregamento das variáveis
+     */
+    static async refresh() {
+        this.clearCache();
+        const { systemName, environmentName } = this.getCurrentSystemInfo();
+        if (systemName && environmentName) {
+            await this.loadVariables(systemName, environmentName);
+            Logger.info('🔄 Variáveis recarregadas');
+        }
+    }
+    // ============================================
+    // Métodos privados
+    // ============================================
+    /**
+     * Obtém informações do sistema atual configurado
+     */
+    static getCurrentSystemInfo() {
+        try {
+            const systemsManager = SystemsManager.getInstance();
+            const selectedSystem = systemsManager.getSelectedSystem();
+            if (selectedSystem) {
+                return {
+                    systemName: selectedSystem.name,
+                    environmentName: selectedSystem.environmentName,
+                };
+            }
+            // Do NOT fallback to process.env here. The env.ts module is responsible for local env variables.
+            // Require explicit selection via SystemsManager (e.g. TestAnnotations.setSystem()).
+            return { systemName: '', environmentName: '' };
+        }
+        catch {
+            return { systemName: '', environmentName: '' };
+        }
+    }
+    /**
+     * Detecta o ambiente atual baseado em variáveis de ambiente
+     */
+    static detectEnvironment() {
+        // Ordem de precedência
+        const env = process.env.AUTOCORE_ENVIRONMENT ||
+            process.env.ENV ||
+            process.env.NODE_ENV ||
+            'preprod';
+        // Mapear nomes comuns para nomes do TestHub
+        const envMap = {
+            'production': 'Prod',
+            'prod': 'Prod',
+            'staging': 'Homolog',
+            'homolog': 'Homolog',
+            'hml': 'Homolog',
+            'development': 'Dev',
+            'dev': 'Dev',
+            'preprod': 'Preprod',
+            'uat': 'UAT',
+            'esteira1': 'Esteira1',
+            'esteira2': 'Esteira2',
+        };
+        return envMap[env.toLowerCase()] || env;
+    }
+    /**
+     * Verifica se o cache é válido
+     */
+    static isCacheValid(systemName, environmentName) {
+        if (!this.cache)
+            return false;
+        const isSameSystem = this.cache.systemName === systemName &&
+            this.cache.environmentName === environmentName;
+        const isNotExpired = Date.now() - this.cache.timestamp < this.cacheDuration;
+        return isSameSystem && isNotExpired;
+    }
+    /**
+     * Carrega variáveis do TestHub para o cache
+     */
+    static async loadVariables(systemName, environmentName) {
+        if (this.isCacheValid(systemName, environmentName)) {
+            return;
+        }
+        Logger.info(`📥 Carregando variáveis de ${systemName}/${environmentName}...`);
+        const client = TestHubClient.getInstance();
+        const variables = await client.getEnvironmentVariables(systemName, environmentName);
+        // Criar novo cache
+        this.cache = {
+            systemName,
+            environmentName,
+            variables: new Map(),
+            timestamp: Date.now(),
+        };
+        // Popular cache
+        for (const variable of variables) {
+            this.cache.variables.set(variable.key.toUpperCase(), variable.value);
+        }
+        Logger.info(`✅ ${variables.length} variável(is) carregada(s) no cache`);
+        Logger.info(`ℹ️ TestHubVars: variáveis carregadas do Portal Hub para ${systemName}/${environmentName}`);
+    }
+}
+// ============================================
+// Alias para uso mais simples
+// ============================================
+/**
+ * Alias curto para TestHubVars.get()
+ *
+ * @example
+ * import { getVar } from '@silasfmartins/testhub'
+ *
+ * const url = await getVar('URLSALESFORCE')
+ */
+export const getVar = TestHubVars.get.bind(TestHubVars);
+/**
+ * Alias curto para TestHubVars
+ */
+export const Vars = TestHubVars;
+export default TestHubVars;

package/dist/src/utils/ActionInterceptor.d.ts

@@ -0,0 +1,59 @@
+/**
+ * 🔧 Sistema de Interceptação para Captura Automática de Evidências
+ * @description Intercepta ações do WebActions, MobileActions e ApiActions para capturar evidências
+ * @author TestHUB Team
+ * @version 1.0.0
+ */
+export declare class ActionInterceptor {
+    private static isInitialized;
+    private static interceptedMethods;
+    /**
+     * ✅ Inicializa os interceptadores
+     */
+    static initialize(): void;
+    /**
+     * ✅ Intercepta WebActions
+     */
+    private static interceptWebActions;
+    /**
+     * ✅ Intercepta DesktopActions
+     */
+    private static interceptDesktopActions;
+    /**
+     * ✅ Intercepta MobileActions
+     */
+    private static interceptMobileActions;
+    /**
+     * 🚫 Intercepta ApiActions - DESABILITADO
+     * Métodos do ApiActions são internos e não devem ser capturados como CTs
+     */
+    private static interceptApiActions;
+    /**
+     * ✅ Intercepta um método específico
+     */
+    private static interceptMethod;
+    /**
+     * ✅ Gera descrição amigável da ação
+     */
+    private static generateActionDescription;
+    /**
+     * ✅ Gera descrição para ações Web
+     */
+    private static generateWebDescription;
+    /**
+     * ✅ Gera descrição para ações Mobile
+     */
+    private static generateMobileDescription;
+    /**
+     * ✅ Gera descrição para ações API
+     */
+    private static generateApiDescription;
+    /**
+     * ✅ Extrai seletor de diferentes tipos
+     */
+    private static extractSelector;
+    /**
+     * ✅ Força o refresh da página
+     */
+    private static forceRefresh;
+}