v1.6.0

What's Changed

• docs: add public API documentation and fix deprecated userId warning by @moreirawebmaster in #7
• feat: remove irrelevant withConfig and withModel methods by @moreirawebmaster in #8

Full Changelog: v1.5.0...v1.6.0

v1.5.1

Full Changelog: v1.5.0...v1.5.1

v1.5.0

v1.5.0

Added

• EngineTrackingInitialize: Central initializer for analytics and bug tracking services
• Nullable Parameters: Optional initialization of analytics or bug tracking individually
• Dartdoc Documentation: Complete public API documentation for all methods and parameters

Enhanced

• Flexible Initialization: Initialize both services, only analytics, or only bug tracking
• Parallel Execution: Optimized Future.wait for maximum performance

v1.4.1

fix: update tests and changelog for v1.4.1

Fix enum test count and add v1.4.1 changelog entry

v1.4.0

🚀 Engine Tracking v1.4.0

✨ New Features

• Direct Microsoft Clarity Integration: Removed adapter pattern, now integrated directly via EngineWidget for better performance
• STMR Brand Integration: Added official STMR logo and enhanced brand presence
• Enhanced Widget System: New EngineWidget and EngineMaskWidget components
• Clarity Configuration: New EngineClarityConfig for direct integration settings

�� Technical Improvements

• Modern Lint Standards: Updated to flutter_lints 6.0.0 with 350+ strict rules for Dart/Flutter 2025
• Architecture Cleanup: Streamlined analytics adapters architecture
• Performance Optimization: Removed unnecessary adapter layer for Clarity
• Code Quality: Implemented strict-casts, strict-inference, and security rules

📚 Documentation & Structure

• Complete README Restructure: Organized into 7 clear sections with comprehensive examples
• Architecture Mind Maps: 5 detailed Mermaid diagrams showing system architecture
• Development Guidelines: Moved technical rules to .cursor/rules.md for cleaner documentation
• Enhanced Examples: Updated all usage examples with latest patterns

🎯 Key Architectural Changes

• Session Management: Enhanced EngineSession with improved UUID v4 generation
• Widget Hierarchy: New base classes for consistent widget development
• Configuration System: Centralized config management with mandatory masking
• Testing Coverage: Maintained 100% test coverage with updated test patterns

🚀 Ready for Production

This release includes significant improvements to performance, maintainability, and developer experience while maintaining full backward compatibility.

Minimum Requirements:

• Flutter 3.24.0+
• Dart 3.5.0+

Breaking Changes: None - fully backward compatible

v1.3.0

What's Changed

• 🆔 feat: Implementa Sistema de Session ID Automático v1.3.0 by @moreirawebmaster in #2

Full Changelog: v1.2.1...v1.3.0

v1.2.1

📋 Documentação de Arquitetura Completa

Esta versão adiciona documentação abrangente da arquitetura do Engine Tracking com diagramas Mermaid visuais.

✨ Principais Adições:

🎯 Diagramas Mermaid Completos:

• Widgets Stateless/Stateful: Mostra execução de métodos e lifecycle tracking automático
• Sistema de Logging (EngineLog): Fluxo detalhado com condicionais de Analytics e Bug Tracking
• Sistema de Analytics: Arquitetura de adapters e integração com dashboards externos
• Sistema de Bug Tracking: Fluxo de captura de erros e crash reporting

🔧 Melhorias no Diagrama EngineLog:

• Condicionais Claras: Representação visual das condições EngineAnalytics.isEnabled && includeInAnalytics
• Fluxo de Erro: Mostra que logs de level error e fatal geram crash reporting adicional
• Nomenclatura Melhorada: Parâmetro includeInAnalytics mais descritivo que hasAnalytics
• Estilização Visual: Condicionais destacadas com cores para melhor legibilidade

🎨 Recursos Visuais:

• Cores Organizadas: Paleta de cores consistente por tipo de componente
• Formas Diferenciadas: Losangos para condicionais, retângulos para componentes
• Legenda Incluída: Facilita compreensão da arquitetura
• Fluxo Hierárquico: Visualização clara do fluxo de dados de cima para baixo

📚 Benefícios:

• 100% Alinhado com o Código: Diagramas refletem exatamente a implementação real
• Facilita Onboarding: Novos desenvolvedores entendem rapidamente a arquitetura
• Documentação Viva: Diagramas servem como referência técnica permanente
• Apresentações: Material visual pronto para demos e apresentações

---

Veja o CHANGELOG.md completo para todos os detalhes técnicos.

v1.1.1

🌐 HTTP Tracking Example - Demonstração Completa

Esta release adiciona um exemplo completo demonstrando tracking de requisições HTTPS usando APIs públicas gratuitas.

✨ Principais Funcionalidades

🎯 APIs Integradas

• 🐾 PokéAPI: Requisições GET para dados de pokémons

  • Lista interativa de 20 pokémons
  • Modal com detalhes completos (sprites, stats, etc.)
  • Tracking de requisições individuais para detalhes

• 📝 JSONPlaceholder: GET e POST para posts e usuários

  • Visualização de posts existentes
  • Criação de novos posts com formulário
  • Lista completa de usuários com informações detalhadas

• 🎮 Interface Unificada: Navegação centralizada para todos os exemplos

📊 Sistema de Tracking Avançado

• ⏱️ Métricas de Performance:

  • Tempo de resposta em milissegundos
  • Códigos de status HTTP
  • Tamanho das respostas em bytes
  • Timestamps completos

• 🎯 Eventos Específicos:

  • api_request_started / api_request_completed
  • pokemon_detail_request_* para requisições de detalhes
  • navigate_to_*_api para rastreamento de navegação
  • *_item_tapped para interações do usuário
  • create_post_* para operações de criação

• 🚨 Tratamento Robusto de Erros:

  • Captura de timeouts e erros de rede
  • Logging contextualizado por tela
  • Stack traces para debugging

🎨 Melhorias de Interface

• 📱 Design Responsivo:

  • SingleChildScrollView para evitar overflow
  • Cards informativos com ícones e descrições
  • Interface moderna e intuitiva

• 🎯 Consistência Visual:

  • Cores uniformes nos botões de navegação
  • Padronização de elementos UI
  • Loading states e error handling

📚 Atualizações de Documentação

✅ README Corrigido

• Nomes de Classes: EngineStatelessWidgetBase → EngineStatelessWidget
• Terminologia: 'Classes Base' → 'Classes Engine'
• Seção de Exemplos: Guia completo de uso
• Características: HTTP e View Tracking documentados

✅ CHANGELOG Atualizado

• Versão 1.2.0: Entrada completa com funcionalidades
• Dependências: http: ^1.1.0 documentada
• Correções: Layout, botões e documentação

🚀 Como Usar

1. Execute o exemplo:

   cd example && flutter run

2. Acesse HTTP Tracking: Na tela principal, toque em 'HTTP Tracking'

3. Explore as APIs:

   • 🐾 Ver Pokémons: Lista interativa da PokéAPI
   • 📝 Ver Posts: Posts do JSONPlaceholder + criação
   • 👥 Ver Usuários: Informações detalhadas de usuários

🔧 Correções Técnicas

• Layout: Corrigido overflow com scroll automático
• Botões: Cores uniformes na navegação
• Código: Otimização e redução de complexidade
• Dependencies: Adicionado http: ^1.1.0

📦 Estrutura do Exemplo

example/lib/
├── main.dart                    # App principal com navegação
├── http_tracking_example.dart   # 🆕 Exemplo HTTP completo
└── view_tracking_example.dart   # Exemplo View Tracking existente

🎯 Casos de Uso Demonstrados

• ✅ GET Requests: PokéAPI e JSONPlaceholder
• ✅ POST Requests: Criação de posts
• ✅ Error Handling: Timeouts e erros de rede
• ✅ Performance Metrics: Tempo de resposta e tamanhos
• ✅ User Interactions: Tracking de toques e navegação
• ✅ State Management: Mudanças de estado com tracking

Este exemplo é perfeito para demonstrar o tracking HTTP em aplicações Flutter reais! 🎯

💡 Próximos Passos

• Teste com suas próprias APIs
• Customize os eventos de tracking
• Adapte as métricas para suas necessidades
• Use como base para implementações reais