@silasfmartins/testhub 1.0.0

package/dist/scripts/init-mobile.js

@@ -0,0 +1,481 @@
+#!/usr/bin/env node
+// @ts-nocheck
+import fs from 'node:fs';
+import { execSync } from 'child_process';
+import yaml from 'js-yaml';
+import path from 'path';
+import { generateBiomeConfigString, generatePackageJson, generateTsConfigForProject, generateVitestConfigString, getLatestVersions, } from './package-versions.js';
+import { setupUltracite } from './ultracite-setup.js';
+const root = process.cwd();
+const catalogPath = path.join(root, 'catalog-info.yaml');
+if (!fs.existsSync(catalogPath)) {
+    console.error('❌ Arquivo catalog-info.yaml não encontrado.');
+    process.exit(1);
+}
+const catalog = yaml.load(fs.readFileSync(catalogPath, 'utf-8'));
+const projectName = catalog?.metadata?.name || 'meu-projeto';
+const projectNameUnderscore = projectName.replace(/-/g, '_');
+const write = (filePath, content) => {
+    const fullPath = path.join(root, filePath);
+    fs.mkdirSync(path.dirname(fullPath), { recursive: true });
+    fs.writeFileSync(fullPath, content);
+};
+async function main() {
+    console.log('🚀 Inicializando projeto Mobile com versões atualizadas...');
+    console.log(`📦 Projeto: ${projectName}`);
+    console.log('');
+    // ✅ Buscar versões mais recentes
+    const versions = await getLatestVersions();
+    // ✅ Gerar package.json com versões atualizadas
+    const packageJsonContent = generatePackageJson(projectName, 'mobile', versions);
+    // ✅ Gerar tsconfig.json baseado no AutoCore
+    const tsconfigContent = generateTsConfigForProject('mobile');
+    // ✅ Gerar vitest.config.ts baseado no AutoCore (NOVO!)
+    const vitestConfigContent = generateVitestConfigString('mobile');
+    // ✅ Gerar biome.json sincronizado com AutoCore
+    const biomeConfigContent = generateBiomeConfigString();
+    console.log('📝 Criando arquivos do projeto...');
+    // package.json com versões dinâmicas
+    write('package.json', JSON.stringify(packageJsonContent, null, 2));
+    // ✅ tsconfig.json sempre sincronizado com o AutoCore
+    write('tsconfig.json', JSON.stringify(tsconfigContent, null, 2));
+    // ✅ vitest.config.ts sempre sincronizado com o AutoCore (NOVO!)
+    write('vitest.config.ts', vitestConfigContent);
+    // ✅ biome.json sincronizado automaticamente com o AutoCore
+    write('biome.json', biomeConfigContent);
+    // playwright.config.ts
+    write('playwright.config.ts', `import { defineConfig } from '@playwright/test';
+export default defineConfig({
+  globalSetup: '@silasfmartins/testhub/setup',
+  reporter: [
+    ['list'],
+    ['html', { open: 'never' }],
+    ['@silasfmartins/testhub/reporter'],
+  ],
+  testDir: './tests',
+  testMatch: ['**/*.spec.ts', '**/*.test.ts'],
+  timeout: 120_000, // 2 minutos para cada teste/hook
+  use: {
+    trace: 'on',
+  },
+});
+`);
+    // .npmrc
+    write('.npmrc', `registry=https://pkgs.dev.azure.com/telefonica-vivo-brasil/_packaging/DevOps/npm/registry/`);
+    // .gitignore otimizado para mobile
+    write('.gitignore', `# Mobile específicos
+node_modules/
+/logs/
+apps/*.app
+apps/*.apk
+apps/*.ipa
+
+# Appium logs
+appium.log
+appium-*.log
+
+# Environment files
+.env
+.env.preprod
+.env.esteira1
+.env.esteira2
+.env.prodlike
+
+.vscode
+.vscode/
+docs
+docs/
+
+# AutoCore específicos
+.test-data-store.json
+.env.lock
+.configlogger.lock
+.rbqa
+.rbqa/
+
+# VS Code
+.vscode/settings.json
+
+# Build
+/dist
+
+# Biome
+.biome.log
+
+# Test results
+/test-results/
+/wdio-logs/
+screenshots/
+videos/
+
+# iOS específicos
+*.xcarchive
+DerivedData/
+
+# Android específicos
+*.keystore
+local.properties`);
+    // Configurações de environment
+    write('.env', `# Configurações de ambiente para preprod - Mobile
+    ENV=preprod`);
+    write('.env.preprod', '# Configurações de ambiente para preprod - Mobile');
+    write('.env.esteira1', '# Configurações de ambiente para esteira1 - Mobile');
+    // ✅ Estrutura de testes
+    console.log('📝 Criando estrutura de testes...');
+    //env.ts
+    write('src/env.ts', `import { config } from 'dotenv'
+
+config()
+
+const rawEnv = {
+  ENV: process.env.ENV,
+}
+export const env = rawEnv
+`);
+    write('.env.esteira2', '# Configurações de ambiente para esteira2 - Mobile');
+    write('.env.prodlike', '# Configurações de ambiente para prodlike - Mobile');
+    // Page Object simples para Login
+    write('src/pages/MobileLoginPage.ts', `import { Logger, MobileActions } from '@silasfmartins/testhub'
+import { AttributesMobile } from '../attributes/MobileLoginAttributes.js'
+
+export default class PageMobile extends AttributesMobile {
+  async searchScreenBlocked() {
+    Logger.info('Executando o método: searchScreenBlocked')
+    await MobileActions.click(
+      this.searchSettings,
+      'Click no ícone de Pesquisar',
+      true
+    )
+  }
+}
+`);
+    // Attributes simples para mobile
+    write('src/attributes/MobileLoginAttributes.ts', `export class AttributesMobile {
+  protected searchSettings = 'android=new UiSelector().className("android.widget.Button")';
+  protected searchSettingsField = 'android=com.android.settings.intelligence:id/search_src_text';
+
+  protected labelBlockScreen() {
+    return '//android.widget.TextView[@resource-id="android:id/title" and @text="Tipo de bloqueio de tela"]';
+  }
+}
+`);
+    // Exemplo de teste mobile simples
+    write('tests/mobile-login.spec.ts', `
+import { type TestInfo, test, TestAnnotations } from '@silasfmartins/testhub';
+import PageMobile from '../src/pages/MobileLoginPage.js';
+
+test.describe('CN001 Cadastro de Cliente - Mobile', () => {
+  TestAnnotations.stopOnFailure(); // opcional: para o runner ao falhar um CT
+
+  test('CT001 - Teste Mobile [octane-123456]', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Mobile.testInfo = testInfo;
+    await TestAnnotations.setSystem('MEU_SISTEMA');
+
+    await TestAnnotations.setupMobileCapabilities({
+      deviceId: '65e899f0b22fda8447c89146',
+      platformName: 'Android',
+      appPackage: 'com.android.settings',
+      appActivity: '.Settings'
+    });
+
+    await new PageMobile().searchScreenBlocked();
+  });
+});
+`);
+    // Azure DevOps pipeline
+    write('.azuredevops/azure-pipeline.yml', `trigger:
+  batch: true
+  branches:
+    include:
+    - 'master'
+  paths:
+    include:
+    - '*'
+    exclude:
+    - .azuredevops/*
+    - docs/*
+    - catalog-info.yaml
+    - mkdocs.yml
+    - scripts.py
+    - catalog/*
+
+resources:
+  repositories:
+    - repository: CodePlay
+      name: DevOps/Vivo.CodePlay.Pipelines
+      type: git
+      ref: refs/heads/test-playwright
+      endpoint: CodePlay
+
+pool:
+  name: GeneralPurposeLinuxAgentsCI
+
+extends:
+  template: tech_products/qa/build/pipeline_node_npm.yml@CodePlay
+  parameters:
+    jobName: 'build_${projectNameUnderscore}_pkg'
+    commitSHA: '$(Build.SourceVersion)'
+    registryServiceConnection: 'ACR-DEVOPS'
+    govAppAcronym: ''
+    skipScan: false
+`);
+    // SonarQube configuration
+    write('.azuredevops/sonar-project.properties', `################### NÃO ALTERAR!!! ###################
+# Informações gerais sobre o projeto.                #
+# Todas as variáveis de ambiente são fornecidas pela #
+# automação, não alterar!                            #
+######################################################
+
+sonar.projectDescription=Projeto de API com AutoCore
+sonar.analysis.orgName=\${env.AZ_ORG_NAME}
+sonar.analysis.buildAuthor=\${env.AZ_BUILD_AUTHOR}
+sonar.scm.exclusions.disabled=false
+sonar.scm.forceReloadAll=true
+sonar.log.level=DEBUG
+sonar.verbose=true
+sonar.sourceEncoding=UTF-8
+
+# Diretórios e arquivos relevantes para Node.js/TypeScript
+sonar.sources=src
+sonar.inclusions=**/*.ts
+sonar.test.inclusions=**/*.spec.ts,**/*.test.ts
+sonar.typescript.lcov.reportPaths=coverage/lcov.info
+sonar.javascript.lcov.reportPaths=coverage/lcov.info
+
+# Exclusões de cobertura e análise
+sonar.exclusions=node_modules/**,dist/**,coverage/**,**/*.config.js,**/*.config.ts
+sonar.coverage.exclusions=**/*.d.ts,node_modules/**,dist/**,coverage/**,**/*.config.js,**/*.config.ts,**/*.spec.ts,**/*.test.ts
+sonar.test.exclusions=node_modules/**,dist/**,coverage/**
+
+# Configurações específicas para projetos API
+sonar.javascript.environments=node
+sonar.typescript.node=true
+`);
+    // README.md
+    write('README.md', `# ${projectName}
+
+Projeto de automação Mobile baseado no AutoCore.
+
+## 🚀 Como usar
+
+### Pré-requisitos
+1. **Node.js**: Versão 24+ instalada
+2. **Android Studio**: Para testes Android (com SDK configurado)
+3. **Xcode**: Para testes iOS (apenas macOS)
+4. **Appium Inspector**: Faça Download aqui (https://github.com/appium/appium-inspector/releases)
+
+### Instalação de dependências
+\`\`\`bash
+npm install
+\`\`\`
+
+### Gerar Artefato para Projetos de Cenários
+npm run build
+
+### Configurar apps
+1. Coloque os arquivos APK (Android) e APP (iOS) na pasta \`apps/\`
+2. Configure os package names corretos nos arquivos \`.env.*\`
+
+### Executar testes
+
+#### Android
+\`\`\`bash
+npm run test:preprod:android
+npm run test:esteira1:android
+npm run test:esteira2:android
+npm run test:prodlike:android
+\`\`\`
+
+#### iOS
+\`\`\`bash
+npm run test:preprod:ios
+npm run test:esteira1:ios
+npm run test:esteira2:ios
+npm run test:prodlike:ios
+\`\`\`
+
+## 📋 Estrutura do projeto
+
+\`\`\`
+${projectName}/
+├── src/
+│   ├── pages/               # Page Objects para mobile
+│   └── attributes/          # Seletores e elementos
+|   └── env.ts                # Configuração de environment
+├── tests/                   # Testes mobile
+├── apps/                    # Arquivos APK e APP
+├── .env.*                  # Variáveis de ambiente por ambiente
+├── tsconfig.json         # Configuração TypeScript (sincronizada)
+├── biome.json          # Configuração Biome (sincronizada)
+└── README.md           # Esta documentação
+\`\`\`
+
+## 🔧 Desenvolvimento
+
+- **TypeScript**: Configurado e sincronizado com AutoCore
+- **AutoCore**: Biblioteca de utilitários para automação
+- **Biome**: Linting e formatação (configuração sincronizada)
+- **Ultracite**: Experiência de desenvolvimento aprimorada
+
+## 📊 Relatórios
+
+Os relatórios são gerados automaticamente em:
+- \`test-results/\` - Resultados detalhados e artifacts
+- Screenshots automáticos em falhas
+- Logs estruturados no console
+
+## 🧪 Exemplos de Uso
+
+### Teste básico de login
+\`\`\`typescript
+import { type TestInfo, test, TestAnnotations } from '@silasfmartins/testhub';
+import PageMobile from '../src/pages/PageMobile.js';
+
+test.describe('CN001 Cadastro de Cliente - Mobile', () => {
+  TestAnnotations.stopOnFailure(); // opcional: para o runner ao falhar um CT
+
+  test('CT001 - Teste Mobile [octane-123456]', async ({}, testInfo: TestInfo) => {
+    TestAnnotations.Mobile.testInfo = testInfo;
+    await TestAnnotations.setSystem('MEU_SISTEMA');
+
+    await TestAnnotations.setupMobileCapabilities({
+      deviceId: '65e899f0b22fda8447c89146',
+      platformName: 'Android',
+      appPackage: 'com.android.settings',
+      appActivity: '.Settings'
+    });
+
+    await new PageMobile().searchScreenBlocked();
+  });
+});
+\`\`\`
+
+## 🔧 Comandos Úteis
+
+\`\`\`bash
+# Desenvolvimento
+npm run test:preprod:android   # Executar testes Android em preprod
+npm run test:preprod:ios       # Executar testes iOS em preprod
+npm run appium:start          # Iniciar servidor Appium
+npm run appium:doctor         # Verificar configuração Appium
+
+# Qualidade de código
+npx biome check               # Verificar código com Biome
+npx biome format              # Formatar código com Biome
+npx biome check --apply       # Aplicar correções automáticas
+\`\`\`
+
+## 🔄 Sincronização com AutoCore
+
+Este projeto mantém sincronização automática com o AutoCore para:
+
+- **tsconfig.json**: Configuração de compilação TypeScript
+- **biome.json**: Configuração de linting e formatação
+- **Versões de dependências**: Sempre atualizadas
+
+## 📈 Métricas e Monitoramento
+
+- **Relatórios**: Visualização rica dos resultados
+- **Logs estruturados**: Para análise e debugging
+- **Screenshots automáticos**: Em caso de falhas
+- **Traces**: Para análise detalhada de execução
+
+## 🆘 Resolução de Problemas
+
+### Verificar ambiente
+\`\`\`bash
+# Verificar Node.js
+node --version
+
+# Verificar Appium
+npm run appium:check
+npm run appium:doctor
+
+# Verificar Android
+adb devices
+
+# Verificar iOS (macOS)
+xcrun simctl list
+\`\`\`
+
+### Problemas comuns
+- **App não instala**: Verifique assinatura e permissões
+- **App não abre**: Verifique package name/bundle ID
+- **Appium não conecta**: Verifique se servidor está rodando
+- **Elementos não encontrados**: Verifique accessibility IDs no app
+
+---
+
+**Gerado automaticamente pelo AutoCore v${versions?.dependencies?.['@silasfmartins/testhub'] || 'latest'}**
+
+## 📚 Referências
+
+- [AutoCore WebSite](http://brtlvlty0559pl:3002/pt/login)
+- [Appium Documentation](https://appium.io/)
+`);
+    console.log('📦 Instalando dependências...');
+    const installLockPath = path.join(root, '.install.lock');
+    if (fs.existsSync(installLockPath)) {
+        // Pula npm install se o lock já existe
+        console.log('🔄 Dependências já instaladas, pulando npm install');
+    }
+    else {
+        // Executa npm install e cria o lock
+        console.log('📦 Instalando dependências...');
+        try {
+            execSync('npm install', {
+                stdio: 'inherit',
+                cwd: root,
+            });
+            fs.writeFileSync(installLockPath, 'ok');
+            console.log('✅ Dependências instaladas com sucesso');
+        }
+        catch (error) {
+            console.warn('⚠️ Erro ao instalar dependências automaticamente');
+            console.log('💡 Execute manualmente: npm install');
+        }
+    }
+    // ✅ Configurar Ultracite automaticamente
+    console.log('🤖 Configurando ambiente de desenvolvimento...');
+    await setupUltracite(root);
+    // ✅ Garantir sincronização final do biome.json
+    console.log('🔧 Sincronizando configuração do Biome...');
+    const finalBiomeConfig = generateBiomeConfigString();
+    write('biome.json', finalBiomeConfig);
+    // Remover o lock após tudo finalizar
+    if (fs.existsSync(installLockPath)) {
+        fs.unlinkSync(installLockPath);
+        console.log('🗑️ Lock de instalação removido');
+    }
+    console.log('');
+    console.log('🎉 Projeto Mobile gerado com sucesso!');
+    console.log('');
+    console.log('📋 Próximos passos:');
+    console.log('   1. Configure os package names nos arquivos .env.*');
+    console.log('   2. Coloque os arquivos APK/APP na pasta apps/');
+    console.log('   3. Execute: npm run appium:start');
+    console.log('   4. Execute: npm run test:preprod:android');
+    console.log('   5. O Ultracite está configurado para VS Code');
+    console.log('');
+    console.log('🛠️ Comandos úteis:');
+    console.log('   npm run test:preprod:android  - Executar testes Android');
+    console.log('   npm run test:preprod:ios      - Executar testes iOS');
+    console.log('   npm run appium:start          - Iniciar servidor Appium');
+    console.log('   npm run appium:doctor         - Verificar configuração');
+    console.log('   npx biome check               - Verificar código');
+    console.log('   npx biome format              - Formatar código');
+    console.log('');
+    console.log('✅ Configurações sincronizadas com AutoCore:');
+    console.log('   📝 tsconfig.json - Compilação TypeScript');
+    console.log('   🎨 biome.json - Linting e formatação (SINCRONIZADO)');
+    console.log('   🤖 Ultracite - Experiência de desenvolvimento');
+    console.log('   📦 Dependências - Versões mais recentes');
+    console.log('   📱 WebdriverIO - Configuração otimizada para mobile');
+    console.log('');
+    console.log('🚀 Projeto pronto para desenvolvimento mobile!');
+}
+// Executar função principal
+main().catch((error) => {
+    console.error('❌ Erro durante inicialização:', error);
+    process.exit(1);
+});

package/dist/scripts/init-scenarios.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};