Skip to content

EventFlux 3.0.2

Latest

Choose a tag to compare

@Imgkl Imgkl released this 25 Sep 18:24
7fe2445

First stable EventFlux v3 release, including the disconnect fix previously available in 3.0.2-dev.

Fixes

  • Prevent Bad state: Cannot add event after closing during disconnect by guarding event delivery and clearing the controller reference before closing it (#47).
  • Fix reconnection on web, exponential backoff calculation, and connection lifecycle race conditions.
  • Add the missing return type annotation for the logging helper.

New in v3

  • Web transport with WebConfig and fetch_client.
  • WHATWG-compliant SSE parsing, persistent Last-Event-ID, server retry: support, and event filtering.
  • Request, response, and error interceptors; mid-flight abort; idle timeout detection.
  • Exponential backoff with jitter and maxBackoff, plus retryable HTTP error classification.
  • EventFluxStatus.reconnecting and original error/stack-trace details.
  • Bundled eventflux-usage agent skill, AI-assisted installation guidance, and package architecture documentation.

Breaking changes from v2

  • onReconnect now receives (int attempt, Duration delay).
  • Web connections require WebConfig.
  • Minimum Dart SDK is 3.4.0; minimum Flutter SDK is 3.0.0.
  • Native default headers include Cache-Control: no-store; browsers use WebConfig.cache.
  • SSE payloads no longer include the parser-added trailing newline.

Install

flutter pub add 'eventflux:^3.0.2'

To install the bundled agent skill (skills CLI requires Dart 3.10 or later):

dart run skills@ get -p eventflux

Thanks to Peter Trost, Felippe, Michał Król, and everyone listed in the contributor credits.

Full changelog · Migration guide