flutter_qora 0.2.0

A Flutter wrapper around the Qora async state management library, providing seamless integration with Flutter's widget tree and lifecycle

Changelog

All notable changes to this project will be documented in this file.

The format is based on Keep a Changelog, and this project adheres to Semantic Versioning.

Unreleased

0.2.0 - 2026-02-22

Added

• FlutterConnectivityManager — invalidates all queries when the device reconnects after being offline; powered by connectivity_plus (bundled as a direct dependency)
• FlutterConnectivityManager and FlutterLifecycleManager exported from the main flutter_qora library barrel
• QoraScope now accepts an optional connectivityManager parameter alongside lifecycleManager

Changed

• queryKey accepts Object — both QoraBuilder and QoraStateBuilder now accept a plain List<dynamic> or a QoraKey; no wrapping in QoraKey(...) required
• FlutterLifecycleManager.refetchInterval is now public (was _refetchInterval); configures the minimum background duration before queries are invalidated on app resume (default: 5 s)
• Internal refetch mechanism uses client.invalidateWhere((_) => true) instead of direct stream manipulation; active QoraBuilder widgets detect the resulting Loading(previousData: …) state and re-fetch automatically

0.1.0 - 2026-02-11

Added

• QoraScope (InheritedWidget) — provides QoraClient to the widget tree
• QoraBuilder<T> — fetches on mount, subscribes to all state transitions, re-fetches on invalidation, and cleans up on dispose
• QoraStateBuilder<T> — observe-only variant; subscribes to state without triggering a fetch
• BuildContext extensions: context.qora, context.qoraOrNull
• FlutterLifecycleManager — invalidates all queries when the app resumes after a configurable background pause