@silasfmartins/testhub 1.0.0

package/scripts/init-mobile.ts

@@ -0,0 +1,558 @@
+#!/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')) as any
+const projectName = catalog?.metadata?.name || 'meu-projeto'
+const projectNameUnderscore = projectName.replace(/-/g, '_')
+
+const write = (filePath: string, content: string) => {
+  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)
+})