Aus öffentlichen Paketdaten erstellte Orientierung.
EventFlux ist ein Flutter/Dart-Paket zur effizienten Verwaltung von Server-Sent-Event-(SSE)-Streams. Es vereinfacht die Echtzeitkommunikation durch nahtlose Anbindung an SSE-Endpunkte, automatische Wiederherstellung der Verbindung und strukturierte Datenverarbeitung. Ideal für Anwendungen, die Live-Updates wie Benachrichtigungen, Dashboards oder Live-Feeds erfordern, stellt EventFlux zuverlässige Ereignisübertragung mit minimalem Boilerplate sicher. Das Paket unterstützt mehrere Plattformen wie Android, iOS, macOS, Windows und Linux und ist somit für plattformübergreifende Echtzeitanwendungen geeignet.
Anwendungsfälle
Echtzeit-Benachrichtigungen
Live-Dashboard-Updates
Streaming-Datenfeeds
Chat-Anwendungen
Überwachungssysteme
Hauptmerkmale
Automatische Wiederherstellung der Verbindung
Stream-Lebenszyklus-Management
Plattformübergreifende Unterstützung
Einfache API für Ereignisbehandlung
Eingebaute Fehlerwiederherstellung
Geeignet für
Entwickler von Echtzeit-Apps
Backend-integrierte Flutter-Apps
Apps, die Live-Datenaktualisierungen benötigen
Teams, die servergesendete Ereignisse verwenden
Multiplattform-Projekte
Hinweise
Erfordert SSE-kompatible Backend
Beschränkt auf Server-zu-Klient-Streaming
Keine integrierte Authentifizierungsverwaltung
Abhängig von der Netzwerkstabilität
Möglicherweise ist eine benutzerdefinierte Analyse für komplexe Payloads erforderlich
Original-README
Originaler README-Schnappschuss aus dem verknüpften Quell-Repository. Aktuelle Inhalte finden Sie im Repository.
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