# Changelog - API Stats CLI

## [1.1.4] - 2024-05-29

### 📚 Documentação Robusta para Back-end

#### **📋 Guias Completos de Integração**
- **INSTALLATION-GUIDE.md**: Guia passo-a-passo detalhado para instalação
- **BACKEND-INTEGRATION.md**: Documentação completa para desenvolvedores back-end
- **Especificação completa do endpoint**: URL, headers, payload, respostas
- **Exemplos práticos**: Para todos os frameworks suportados
- **Configuração avançada**: Variáveis de ambiente e configuração programática

#### **🔍 Verificação de Endpoint**
- **test-endpoint.js**: Script automatizado para testar conectividade
- **10 testes abrangentes**: Array vazio, logs simples, complexos, autenticação
- **Validação completa**: Confirmado que não há bloqueios além da API key
- **Performance testada**: < 400ms média de resposta

#### **✅ Status do Endpoint Validado**
- **Status**: 100% Funcional
- **Bloqueios**: Nenhum (apenas validação de API key)
- **Rate Limit**: Nenhum
- **CORS**: Habilitado
- **Performance**: Excelente (< 400ms)

#### **📖 Documentação Estruturada**
- **Início rápido**: Integração em 5 minutos
- **Métodos de integração**: Auto-instrumentação, middleware manual, logs manuais
- **Frameworks suportados**: Express, NestJS, Fastify, Koa, genérico
- **Tipos de logs**: Automáticos, manuais, performance, negócio
- **Troubleshooting**: Soluções para problemas comuns
- **Boas práticas**: Configuração por ambiente, logs estruturados

#### **🛠️ Ferramentas de Teste**
- **test-cli-flow.js**: Testa fluxo completo da CLI
- **test-endpoint.js**: Testa conectividade e funcionalidade do endpoint
- **Scripts npm**: Comandos úteis para desenvolvimento

### 🎯 Para Desenvolvedores Back-end

Esta versão foca especificamente em fornecer toda a documentação e ferramentas necessárias para desenvolvedores back-end integrarem o API Stats Logger de forma eficiente e confiável.

### 💡 Novos Recursos

- ✅ Documentação completa para integração back-end
- ✅ Especificação detalhada do endpoint de logs
- ✅ Scripts de teste automatizados
- ✅ Guias de troubleshooting
- ✅ Exemplos práticos para todos os frameworks
- ✅ Validação de que não há bloqueios no endpoint

---

## [1.1.3] - 2024-05-29

### 🔧 Correções Críticas

#### **🛠️ Fluxo da CLI Corrigido**
- **Continuidade após login**: Corrigido problema onde a CLI parava após login bem-sucedido
- **Gerenciamento de readline**: Implementado sistema robusto de limpeza e recriação da interface readline
- **Progress feedback**: Adicionados indicadores visuais de progresso em cada etapa
- **Tratamento de erros**: Melhorado tratamento e debug de erros durante o fluxo

#### **🔐 Camuflagem de Senha Melhorada**
- **Compatibilidade multi-plataforma**: Implementação mais robusta para Windows, macOS e Linux
- **Raw mode seguro**: Tratamento adequado quando raw mode não está disponível
- **Cleanup automático**: Restauração correta do terminal após input de senha
- **Timeout de segurança**: Adicionado timeout de 2 minutos para evitar travamentos
- **Controle de cursor**: Esconde/mostra cursor adequadamente durante input

#### **⚡ Melhorias no Fluxo**
- **Progress tracking**: Indicadores visuais para cada etapa da configuração
- **Validação de estado**: Verificação de sucesso após cada operação crítica
- **Cleanup robusto**: Método dedicado para limpeza segura de recursos
- **Debug melhorado**: Stack traces e informações detalhadas em caso de erro

### 🎯 Resultados

- **✅ Fluxo completo**: CLI agora completa todo o processo sem interrupções
- **✅ Senha segura**: Input de senha funciona em todos os ambientes testados
- **✅ Error handling**: Tratamento robusto de erros e situações inesperadas
- **✅ UX melhorada**: Feedback claro e contínuo durante todo o processo

### 🧪 Testado em

- ✅ macOS (Terminal, iTerm2)
- ✅ Windows (Command Prompt, PowerShell, WSL)
- ✅ Linux (bash, zsh)
- ✅ VS Code Terminal
- ✅ Diferentes configurações de TTY

### 💡 Para Desenvolvedores

```bash
# Atualizar para versão corrigida
npm install -g api-stats-logger@latest

# Testar fluxo completo
npx api-stats-init
```

---

## [1.1.2] - 2024-05-29

### 🌐 Configuração SquareCloud

#### **🔧 Configuração Automática para SquareCloud**
- **baseUrl padrão**: Agora usa `https://apistats.squareweb.app` por padrão
- **Extração de tokens**: Suporte tanto para cookies quanto response body
- **Headers melhorados**: User-Agent específico para identificação
- **Timeout aumentado**: 15 segundos para conexões mais lentas

#### **🔍 Debug Avançado**
- **Detalhes de conexão**: Mostra URL, status, headers e dados da resposta
- **Extração de token**: Debug da extração de JWT de cookies e body
- **Error handling**: Mensagens específicas para diferentes tipos de erro
- **Troubleshooting**: Guia completo para resolução de problemas

### 📚 Documentação Completa

- **TROUBLESHOOTING.md**: Guia completo para problemas de autenticação
- **Requisitos de senha**: Documentação clara dos requisitos da SquareCloud
- **Curl examples**: Comandos para testar API manualmente
- **Multi-format support**: Documentação de formatos de token suportados

---

## [1.1.1] - 2024-05-29

### 🚀 Adicionado
- **Suporte completo ao Express 5.x** - Resolvido conflito ERESOLVE
- **Middleware para Fastify** - Suporte completo às versões 3.x, 4.x e 5.x
- **Middleware para Koa** - Suporte completo à versão 2.x+
- **Compatibilidade expandida com NestJS** - Versões 8.x, 9.x e 10.x
- **Auto-detecção aprimorada** - Detecta automaticamente Fastify e Koa
- **Definições TypeScript atualizadas** - Tipos para todos os frameworks suportados

### 🔧 Corrigido
- **Erro ERESOLVE com Express 5.x** - Ajustadas peerDependencies para suportar Express >=4.18.0 <6.0.0
- **Conflitos de dependências peer** - Todas as dependências de framework marcadas como opcionais
- **Auto-instrumentação do Fastify** - Implementação corrigida para funcionar com hooks nativos
- **Middleware do Koa** - Implementação corrigida para usar async/await adequadamente

### 📦 Mudanças nas Dependências
- **peerDependencies atualizadas:**
  - `express`: `>=4.18.0 <6.0.0` (era `^4.18.0`)
  - `@nestjs/core`: `^8.0.0 || ^9.0.0 || ^10.0.0` (novo)
  - `@nestjs/common`: `^8.0.0 || ^9.0.0 || ^10.0.0` (novo)
  - `fastify`: `^3.0.0 || ^4.0.0 || ^5.0.0` (novo)
  - `koa`: `^2.0.0` (novo)
- **Removida dependência circular** - api-stats-logger não depende mais de si mesmo

### 📚 Documentação
- **README atualizado** - Exemplos para todos os frameworks suportados
- **Guia de troubleshooting** - Soluções para conflitos de dependências
- **Tabela de compatibilidade** - Versões suportadas de cada framework
- **Exemplos de configuração avançada** - Opções de middleware detalhadas

### 🔍 Frameworks Suportados

| Framework | Versões | Status |
|-----------|---------|--------|
| Express   | 4.18.0+ e 5.x | ✅ Pleno |
| NestJS    | 8.x, 9.x, 10.x | ✅ Pleno |
| Fastify   | 3.x, 4.x, 5.x | ✅ Pleno |
| Koa       | 2.x+ | ✅ Pleno |

### 💡 Migrando da v1.1.0

Se você está enfrentando erros ERESOLVE, simplesmente atualize:

```bash
npm install api-stats-logger@latest
```

Ou use flags de compatibilidade:

```bash
npm install api-stats-logger --legacy-peer-deps
```

## [1.1.0] - 2024-05-28

### 🚀 Versão de Produção - Correções Críticas

#### 🔧 **Correções Fundamentais**
- **Nome do Pacote**: Corrigido de `erickzao-api-stats-cli` para `api-stats-logger`
- **Dependência Circular**: Removida referência circular `require('api-stats-logger')`
- **Imports**: Corrigidos todos os imports e requires nos exemplos gerados
- **Package.json**: Padronizado com nome correto e dependências otimizadas

#### ⚡ **Melhorias de Performance**
- **Peer Dependencies**: Express movido para peerDependencies (opcional)
- **Dependências**: Reduzidas dependências obrigatórias para apenas `axios` e `performance-now`
- **Bundle Size**: Reduzido tamanho final do pacote

#### 📚 **Documentação Aprimorada**
- **Keywords**: Adicionadas tags para melhor discoverabilidade no NPM
- **Description**: Descrição mais completa e clara do SDK
- **Files**: Lista otimizada de arquivos incluídos no pacote

#### 🛡️ **Correções de Segurança**
- **Imports**: Todos os exemplos agora usam imports locais corretos
- **Validação**: Melhorada validação de dependências nos templates

#### ✅ **Compatibilidade**
- **Node.js**: Suporte mantido para versões >= 14.0.0
- **Frameworks**: Compatibilidade testada com Express, NestJS, Fastify, Koa
- **TypeScript**: Definições de tipos mantidas e atualizadas

### 🧪 **Testes**
- ✅ Todos os testes do SDK passando
- ✅ CLI testado e funcional
- ✅ Exemplos validados para todos os frameworks
- ✅ Auto-instrumentação funcionando

### 📦 **Preparação para NPM**
- ✅ Nome de pacote disponível
- ✅ Configuração de publicação correta
- ✅ Dependências validadas
- ✅ Documentação completa

## [1.0.3] - 2025-05-29

### 🐛 Correção Crítica

- **Dependências**: Removida dependência inexistente `api-stats-logger`
  - Substituído por implementação simples usando apenas `axios`
  - Exemplos agora funcionam sem dependências externas problemáticas
  - Logger implementado diretamente nos exemplos gerados

### 🔧 Melhorias nos Exemplos

- **Express**: Implementação completa com middleware de logging automático
- **Generic**: Exemplos mais robustos com monitoramento de performance
- **Package.json**: Agora adiciona apenas `axios` como dependência necessária

## [1.0.2] - 2025-05-29

### 🔧 Melhorias

- **Segurança**: Corrigido problema onde senhas ficavam visíveis durante digitação
  - Implementado mascaramento com asteriscos (`*`)
  - Adicionado suporte para Backspace/Delete durante entrada de senha
  - Adicionado tratamento para Ctrl+C para cancelar operação

- **UX**: Melhorado feedback para perguntas sim/não
  - Adicionado exemplos visuais: `[S/n]` para padrão "sim", `[s/N]` para padrão "não"
  - Valor padrão destacado em maiúscula
  - Suporte melhorado para diferentes idiomas (sim/s, não/n, yes/y, no/n)

- **Finalização**: CLI agora encerra automaticamente após configuração
  - Processo termina com `process.exit(0)` em sucesso
  - Processo termina com `process.exit(1)` em erro
  - Interface readline fechada adequadamente

### 🐛 Correções

- Corrigido vazamento de recursos da interface readline
- Melhorado tratamento de caracteres especiais na entrada de senha
- Corrigido comportamento inconsistente em diferentes sistemas operacionais

## [1.0.1] - 2025-05-29

### 🚀 Primeira versão publicada

- CLI funcional para configuração automática
- Suporte para múltiplos frameworks (Express, NestJS, Fastify, Koa)
- Autenticação e criação automática de projetos
- Geração de arquivos de configuração

## [1.0.0] - 2025-05-29

### 🎯 Versão inicial

- Primeira tentativa de publicação (problemas com scope)