Orientação gerada a partir de informações públicas. Apenas para referência.
EventFlux é um pacote Flutter/Dart projetado para gerenciar de forma eficiente fluxos de eventos enviados pelo servidor (SSE). Simplifica a comunicação de dados em tempo real ao fornecer conectividade sem interrupções com pontos finais SSE, tratamento automático de reconexão e processamento estruturado de dados. Ideal para aplicativos que exigem atualizações em tempo real, como notificações, painéis ou feeds ao vivo, o EventFlux garante entrega confiável de eventos com mínimo boilerplate. O pacote suporta múltiplas plataformas, incluindo Android, iOS, macOS, Windows e Linux, tornando-o adequado para aplicativos em tempo real multiplataforma.
Casos de uso
Notificações em tempo real
Atualizações ao vivo do painel
Alimentação de dados em streaming
Aplicativos de bate-papo
Sistemas de monitoramento
Principais recursos
Reconexão automática
Gerenciamento do ciclo de vida do fluxo
Suporte multiplataforma
API simples para manipulação de eventos
Recuperação de erro embutida
Indicado para
desenvolvedores de aplicativos em tempo real
Aplicativos Flutter integrados ao backend
Aplicativos que precisam de atualizações de dados em tempo real
Equipes usando eventos enviados pelo servidor
Projetos multiplataforma
Considerações
Requer backend compatível com SSE
Limitado à transmissão do servidor para o cliente
Nenhuma manipulação de autenticação embutida
Depende da estabilidade da rede
Pode ser necessário análise personalizada para cargas complexas
README original
Snapshot do README original do repositório-fonte vinculado. Consulte o repositório para o conteúdo mais recente.
EventFlux
A Dart package for Server-Sent Events done right — WHATWG spec-compliant parsing, auto-reconnect with exponential backoff, request/response interceptors, mid-flight abort, idle timeout detection, and web platform support out of the box.
Platform Support
Android
iOS
Web
MacOS
Windows
Linux
✅
✅
✅
✅
❓
❓
Windows and Linux should work but haven't been battle-tested yet — PRs welcome if you get there first.
Features 🌟
📜 WHATWG SSE spec-compliant event stream parsing with persistent lastEventId and retry: field support
🔄 Auto-reconnect with linear or exponential backoff, random jitter, and configurable maxBackoff cap
🔗 Interceptor chain — hook into request, response, and error lifecycle stages
🛑 Mid-flight abort via a Future<void> trigger
⏱️ Idle timeout detection — drops the connection if no data arrives within a configured duration
🌐 Web platform support with CORS, credentials, and caching configuration via WebConfig
🔍 Event filtering by type using response.where()
📎 Multipart request support
🏗️ Singleton (EventFlux.instance) and multiple independent connections (EventFlux.spawn())
🔌 Pluggable HTTP clients via HttpClientAdapter
🧠 Smart error classification — only 5xx, 408, and 429 trigger auto-reconnect
Migrating from v2? FYI. 🔄
Here
If you're upgrading from v2, here's what changed:
Breaking
onReconnect callback signature changed from () to (int attempt, Duration delay)
Default request headers now include Cache-Control: no-store
Minimum Dart SDK raised to >=3.4.0, Flutter >=3.0.0
webConfig is now required when running on web
New in v3
EventFluxStatus.reconnecting status value
originalError and stackTrace fields on EventFluxException
Request/response/error interceptor chain via interceptors parameter
Mid-flight abort support via abortTrigger parameter
Idle timeout detection via connectionTimeout on ReconnectConfig
maxBackoff on ReconnectConfig to cap exponential backoff
WHATWG-compliant SSE parser with persistent lastEventId, retry: field support, and U+2028 sanitization
Installation 📦
dependencies:eventflux:^3.0.2-dev
Requires Dart SDK >=3.4.0 and Flutter >=3.0.0.
Usage 🔧
Basic Connection — Connect to an SSE endpoint in a few lines