@silasfmartins/testhub 1.0.0

package/dist/src/api/Certificate.d.ts

@@ -0,0 +1,60 @@
+/**
+ * ✅ Interface para Certificados Digitais
+ * Compatível com a implementação Java do AutoCore
+ */
+export interface Certificate {
+    /** Nome do arquivo de certificado (ex: "cert.p12") */
+    name: string;
+    /** Senha do certificado (opcional, muitos certificados não precisam) */
+    password?: string;
+    /** Caminho completo para o certificado (opcional, será resolvido automaticamente) */
+    path?: string;
+    /** Tipo de certificado: 'pfx' para .p12/.pfx, 'pem' para .crt/.pem */
+    type?: 'pfx' | 'pem';
+    /** Caminho para a chave privada (apenas para certificados PEM) */
+    keyPath?: string;
+}
+/**
+ * ✅ Classe utilitária para criar certificados
+ * Espelha a funcionalidade da classe Certificate do Java
+ */
+export declare class CertificateBuilder {
+    private certificate;
+    constructor();
+    /**
+     * Define o nome do certificado
+     * @param name Nome do arquivo de certificado
+     */
+    setName(name: string): CertificateBuilder;
+    /**
+     * Define a senha do certificado
+     * @param password Senha do certificado
+     */
+    setPassword(password: string): CertificateBuilder;
+    /**
+     * Define o caminho completo do certificado
+     * @param path Caminho para o arquivo de certificado
+     */
+    setPath(path: string): CertificateBuilder;
+    /**
+     * Define o tipo de certificado
+     * @param type Tipo do certificado
+     */
+    setType(type: 'pfx' | 'pem'): CertificateBuilder;
+    /**
+     * Define o caminho da chave privada (para certificados PEM)
+     * @param keyPath Caminho para a chave privada
+     */
+    setKeyPath(keyPath: string): CertificateBuilder;
+    /**
+     * Constrói o objeto Certificate
+     */
+    build(): Certificate;
+}
+/**
+ * ✅ Função de conveniência para criar certificado (compatível com Java)
+ * @param name Nome do certificado
+ * @param password Senha do certificado (opcional)
+ * @returns Certificate configurado
+ */
+export declare function createCertificate(name: string, password?: string): Certificate;

package/dist/src/api/Certificate.js

@@ -0,0 +1,79 @@
+import { Logger } from '../utils/Logger.js';
+/**
+ * ✅ Classe utilitária para criar certificados
+ * Espelha a funcionalidade da classe Certificate do Java
+ */
+export class CertificateBuilder {
+    certificate;
+    constructor() {
+        this.certificate = {
+            name: '',
+        };
+    }
+    /**
+     * Define o nome do certificado
+     * @param name Nome do arquivo de certificado
+     */
+    setName(name) {
+        this.certificate.name = name;
+        return this;
+    }
+    /**
+     * Define a senha do certificado
+     * @param password Senha do certificado
+     */
+    setPassword(password) {
+        this.certificate.password = password;
+        return this;
+    }
+    /**
+     * Define o caminho completo do certificado
+     * @param path Caminho para o arquivo de certificado
+     */
+    setPath(path) {
+        this.certificate.path = path;
+        return this;
+    }
+    /**
+     * Define o tipo de certificado
+     * @param type Tipo do certificado
+     */
+    setType(type) {
+        this.certificate.type = type;
+        return this;
+    }
+    /**
+     * Define o caminho da chave privada (para certificados PEM)
+     * @param keyPath Caminho para a chave privada
+     */
+    setKeyPath(keyPath) {
+        this.certificate.keyPath = keyPath;
+        return this;
+    }
+    /**
+     * Constrói o objeto Certificate
+     */
+    build() {
+        if (!this.certificate.name) {
+            throw new Error('Nome do certificado é obrigatório');
+        }
+        return { ...this.certificate };
+    }
+}
+/**
+ * ✅ Função de conveniência para criar certificado (compatível com Java)
+ * @param name Nome do certificado
+ * @param password Senha do certificado (opcional)
+ * @returns Certificate configurado
+ */
+export function createCertificate(name, password) {
+    const builder = new CertificateBuilder().setName(name);
+    if (password) {
+        builder.setPassword(password);
+    }
+    else {
+        Logger.info('⚠️ DEBUG: Senha não fornecida ou vazia');
+    }
+    const certificate = builder.build();
+    return certificate;
+}

package/dist/src/api/JsonResponse.d.ts

@@ -0,0 +1,116 @@
+/**
+ * Wrapper utilitário para manipulação de respostas JSON e XML.
+ */
+export declare class JsonResponse {
+    private data;
+    private statusCode?;
+    /**
+     * Cria uma instância de JsonResponse.
+     * @param data Dados da resposta (JSON ou XML em string).
+     */
+    constructor(data: unknown);
+    /**
+     * Define o status HTTP da resposta.
+     * @param status Código de status HTTP.
+     */
+    setStatus(status: number): void;
+    /**
+     * Obtém o status HTTP da resposta.
+     * @returns Código de status HTTP.
+     */
+    getStatus(): number;
+    /**
+     * Retorna um item do array como JsonResponse.
+     * @param index Índice do array.
+     * @returns Instância de JsonResponse para o item.
+     * @throws {Error} Se o índice não existir.
+     */
+    getFromArray(index: number): JsonResponse;
+    /**
+     * Retorna o valor de um campo de um item do array como string.
+     * @param index Índice do array.
+     * @param field Nome do campo.
+     * @returns Valor do campo como string.
+     * @throws {Error} Se o campo não existir no índice.
+     */
+    getStringFromArray(index: number, field: string): string;
+    /**
+     * Navega por um caminho aninhado nos dados.
+     * @param path Sequência de chaves ou índices.
+     * @returns Valor encontrado no caminho.
+     * @throws {Error} Se o caminho não existir.
+     */
+    getPath(...path: (string | number)[]): unknown;
+    /**
+     * Obtém o valor de uma chave como string.
+     * @param key Nome da chave.
+     * @returns Valor como string.
+     * @throws {Error} Se o campo não existir.
+     */
+    getString(key: string): string;
+    /**
+     * Obtém o valor de uma chave.
+     * @param key Nome da chave.
+     * @returns Valor da chave.
+     */
+    get(key: string): unknown;
+    /**
+     * Obtém um array de JsonResponse a partir de uma chave ou do root.
+     * @param key Nome da chave (opcional).
+     * @returns Array de JsonResponse.
+     * @throws {Error} Se o campo não for um array.
+     */
+    getArray(key?: string): JsonResponse[];
+    /**
+     * Obtém um objeto JsonResponse a partir de uma chave.
+     * @param key Nome da chave.
+     * @returns Instância de JsonResponse para o objeto.
+     * @throws {Error} Se o campo não for um objeto.
+     */
+    getObject(key: string): JsonResponse;
+    /**
+     * Retorna os dados brutos da resposta.
+     * @returns Dados originais.
+     */
+    raw(): unknown;
+    /**
+     * Verifica se os dados são XML.
+     * @returns True se for XML, false caso contrário.
+     */
+    isXml(): boolean;
+    /**
+     * Tenta navegar pelo caminho, retornando valor padrão se não encontrar.
+     * @param defaultValue Valor padrão.
+     * @param path Sequência de chaves ou índices.
+     * @returns Valor encontrado ou valor padrão.
+     */
+    getPathOrDefault(defaultValue: unknown, ...path: (string | number)[]): unknown;
+    /**
+     * Retorna os dados como string formatada (JSON).
+     * @returns String JSON formatada.
+     */
+    toString(): string;
+    /**
+     * Compara se os dados são iguais a outro JsonResponse.
+     * @param other Outra instância de JsonResponse.
+     * @returns True se forem iguais.
+     */
+    equals(other: JsonResponse): boolean;
+    /**
+     * Verifica se uma chave existe nos dados.
+     * @param key Nome da chave.
+     * @returns True se existir.
+     */
+    hasKey(key: string): boolean;
+    /**
+     * Verifica se os dados estão vazios.
+     * @returns True se estiver vazio.
+     */
+    isEmpty(): boolean;
+    /**
+     * Extrai XML do corpo da resposta (async).
+     * @returns Objeto convertido do XML.
+     * @throws {Error} Se os dados não forem XML.
+     */
+    extractXml(): Promise<unknown>;
+}

package/dist/src/api/JsonResponse.js

@@ -0,0 +1,206 @@
+import { parseStringPromise } from 'xml2js';
+/**
+ * Wrapper utilitário para manipulação de respostas JSON e XML.
+ */
+export class JsonResponse {
+    data;
+    statusCode;
+    /**
+     * Cria uma instância de JsonResponse.
+     * @param data Dados da resposta (JSON ou XML em string).
+     */
+    constructor(data) {
+        this.data = data;
+    }
+    /**
+     * Define o status HTTP da resposta.
+     * @param status Código de status HTTP.
+     */
+    setStatus(status) {
+        this.statusCode = status;
+    }
+    /**
+     * Obtém o status HTTP da resposta.
+     * @returns Código de status HTTP.
+     */
+    getStatus() {
+        return this.statusCode || 0;
+    }
+    /**
+     * Retorna um item do array como JsonResponse.
+     * @param index Índice do array.
+     * @returns Instância de JsonResponse para o item.
+     * @throws {Error} Se o índice não existir.
+     */
+    getFromArray(index) {
+        if (Array.isArray(this.data) && this.data[index] !== undefined) {
+            return new JsonResponse(this.data[index]);
+        }
+        throw new Error(`Índice ${index} não encontrado no array`);
+    }
+    /**
+     * Retorna o valor de um campo de um item do array como string.
+     * @param index Índice do array.
+     * @param field Nome do campo.
+     * @returns Valor do campo como string.
+     * @throws {Error} Se o campo não existir no índice.
+     */
+    getStringFromArray(index, field) {
+        if (Array.isArray(this.data) && this.data[index]) {
+            const item = this.data[index];
+            const value = item[field];
+            return value ? String(value) : '';
+        }
+        throw new Error(`Campo '${field}' não encontrado no índice ${index}`);
+    }
+    /**
+     * Navega por um caminho aninhado nos dados.
+     * @param path Sequência de chaves ou índices.
+     * @returns Valor encontrado no caminho.
+     * @throws {Error} Se o caminho não existir.
+     */
+    getPath(...path) {
+        let current = this.data;
+        for (const segment of path) {
+            if (current == null) {
+                throw new Error(`Caminho ${path.join('.')} não encontrado`);
+            }
+            if (typeof segment === 'number' && Array.isArray(current)) {
+                current = current[segment];
+            }
+            else if (typeof segment === 'string' && typeof current === 'object' && current !== null) {
+                current = current[segment];
+            }
+            else {
+                throw new Error(`Não foi possível navegar para ${segment} em ${path.join('.')}`);
+            }
+        }
+        return current;
+    }
+    /**
+     * Obtém o valor de uma chave como string.
+     * @param key Nome da chave.
+     * @returns Valor como string.
+     * @throws {Error} Se o campo não existir.
+     */
+    getString(key) {
+        const obj = this.data;
+        const value = obj[key];
+        if (value === undefined || value === null) {
+            throw new Error(`Campo '${key}' não encontrado no JSON`);
+        }
+        return String(value);
+    }
+    /**
+     * Obtém o valor de uma chave.
+     * @param key Nome da chave.
+     * @returns Valor da chave.
+     */
+    get(key) {
+        const obj = this.data;
+        return obj[key];
+    }
+    /**
+     * Obtém um array de JsonResponse a partir de uma chave ou do root.
+     * @param key Nome da chave (opcional).
+     * @returns Array de JsonResponse.
+     * @throws {Error} Se o campo não for um array.
+     */
+    getArray(key) {
+        const obj = this.data;
+        const targetData = key ? obj[key] : this.data;
+        if (!Array.isArray(targetData)) {
+            throw new Error(`Campo '${key || 'root'}' não é um array`);
+        }
+        return targetData.map((item) => new JsonResponse(item));
+    }
+    /**
+     * Obtém um objeto JsonResponse a partir de uma chave.
+     * @param key Nome da chave.
+     * @returns Instância de JsonResponse para o objeto.
+     * @throws {Error} Se o campo não for um objeto.
+     */
+    getObject(key) {
+        const obj = this.data;
+        const value = obj[key];
+        if (!value || typeof value !== 'object') {
+            throw new Error(`Campo '${key}' não é um objeto`);
+        }
+        return new JsonResponse(value);
+    }
+    /**
+     * Retorna os dados brutos da resposta.
+     * @returns Dados originais.
+     */
+    raw() {
+        return this.data;
+    }
+    /**
+     * Verifica se os dados são XML.
+     * @returns True se for XML, false caso contrário.
+     */
+    isXml() {
+        return typeof this.data === 'string' && this.data.trim().startsWith('<');
+    }
+    /**
+     * Tenta navegar pelo caminho, retornando valor padrão se não encontrar.
+     * @param defaultValue Valor padrão.
+     * @param path Sequência de chaves ou índices.
+     * @returns Valor encontrado ou valor padrão.
+     */
+    getPathOrDefault(defaultValue, ...path) {
+        try {
+            return this.getPath(...path);
+        }
+        catch {
+            return defaultValue;
+        }
+    }
+    /**
+     * Retorna os dados como string formatada (JSON).
+     * @returns String JSON formatada.
+     */
+    toString() {
+        return JSON.stringify(this.data, null, 2);
+    }
+    /**
+     * Compara se os dados são iguais a outro JsonResponse.
+     * @param other Outra instância de JsonResponse.
+     * @returns True se forem iguais.
+     */
+    equals(other) {
+        return JSON.stringify(this.data) === JSON.stringify(other.data);
+    }
+    /**
+     * Verifica se uma chave existe nos dados.
+     * @param key Nome da chave.
+     * @returns True se existir.
+     */
+    hasKey(key) {
+        return typeof this.data === 'object' && this.data !== null && key in this.data;
+    }
+    /**
+     * Verifica se os dados estão vazios.
+     * @returns True se estiver vazio.
+     */
+    isEmpty() {
+        if (Array.isArray(this.data)) {
+            return this.data.length === 0;
+        }
+        if (typeof this.data === 'object' && this.data !== null) {
+            return Object.keys(this.data).length === 0;
+        }
+        return this.data === null || this.data === undefined;
+    }
+    /**
+     * Extrai XML do corpo da resposta (async).
+     * @returns Objeto convertido do XML.
+     * @throws {Error} Se os dados não forem XML.
+     */
+    async extractXml() {
+        if (typeof this.data === 'string' && this.data.trim().startsWith('<')) {
+            return await parseStringPromise(this.data);
+        }
+        throw new Error('Dados não são XML');
+    }
+}

package/dist/src/appium/DeviceFarmViewer.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 📱 Sistema de Visualização Integrada para DeviceFarm
+ * @description Integra visualização local com o DeviceFarm remoto com detecção automática de projetos consumidores
+ * @author AutoCore Team
+ * @version 2.0.0
+ */
+/**
+ * 📱 DeviceFarm Viewer com suporte a projetos consumidores
+ */
+export declare class DeviceFarmViewer {
+    private static isActive;
+    private static session;
+    private static stepCounter;
+    private static consumerProjectPath;
+    /**
+     * 🎯 Configura projeto consumidor automaticamente
+     */
+    private static setupConsumerProject;
+    /**
+     * 🔄 Sincroniza screenshots do projeto consumidor para o viewer
+     */
+    private static syncConsumerScreenshots;
+    /**
+     * 📸 Adiciona screenshot sincronizado
+     */
+    private static addScreenshotFromSync;
+    /**
+     * 🚀 Inicia o viewer integrado
+     */
+    static start(deviceId?: string): Promise<string>;
+    /**
+     * 🎨 Gera HTML integrado com DeviceFarm com dados embutidos (SEM SERVIDOR)
+     */
+    private static generateIntegratedHtml;
+    /**
+     * 📄 JavaScript para polling e atualização dinâmica
+     */
+    private static getViewerJavaScript;
+    /**
+     * 📸 Adiciona screenshot (chamado automaticamente por MobileActions)
+     */
+    static addScreenshot(filename: string, description: string): void;
+    /**
+     * 📋 Copia screenshot para pasta do viewer para exibição no HTML
+     */
+    private static copyScreenshotToViewer;
+    /**
+     * � Garante que todos os screenshots possuam dados base64 embutidos
+     */
+    private static ensureBase64ForScreenshots;
+    /**
+     * 🖼️ Converte screenshot em data URI para uso offline
+     */
+    private static loadScreenshotAsDataUri;
+    /**
+     * 🧪 Detecta MIME-Type baseado na extensão do arquivo
+     */
+    private static detectImageMimeType;
+    /**
+     * �🛑 Para o viewer
+     */
+    static stop(): Promise<void>;
+    /**
+     * 📁 Criar diretórios necessários
+     */
+    private static ensureDirectories;
+    /**
+     * 💾 Salva dados da sessão
+     */
+    private static saveSessionData;
+    /**
+     * 📄 Estado atual (para debugging)
+     */
+    static getStatus(): {
+        isActive: boolean;
+        stepCounter: number;
+        consumerProject: string | null;
+    };
+}