flutter_network_plus 0.1.0

An enterprise-grade, Dio-free networking foundation for Flutter: pluggable transport adapters, JWT auto-refresh with request queueing, smart retries, circuit breaker, TTL cache with stale-while-revali [...]

Changelog

All notable changes to this project are documented in this file. The format is based on Keep a Changelog and this project adheres to Semantic Versioning.

0.1.0

Initial release.

Added

• Transport — a Dio-free HttpClientAdapter abstraction with a dart:io default (IoHttpClientAdapter) and a MockHttpClientAdapter for tests.
• Typed results — sealed NetworkResult<T> (NetworkSuccess / NetworkFailure) and a sealed NetworkException hierarchy for exhaustive pattern matching.
• Verbs — get, post, put, patch, delete, send, plus multipart upload with progress and a resumable download manager.
• Interceptor pipeline with short-circuit control (next/resolve/reject/retry).
• Auth — JWT/OAuth refresh-token flow with single-flight refresh, pending-request queueing, proactive expiry refresh, and pluggable secure token storage.
• Reliability — smart retry policy with exponential backoff and jitter, Retry-After support, a circuit breaker, and per-phase timeouts.
• Caching — memory and disk stores with TTL and five cache policies including stale-while-revalidate.
• Offline — a persistent request queue with connectivity-aware automatic replay.
• Security — SSL pinning (certificate and SPKI), HMAC request signing, and a credential-redacting cURL generator.
• Observability — a network inspector timeline, analytics / Crashlytics / OpenTelemetry-style observer hooks, and pluggable logging.
• Environments — named environments with runtime switching.

Known limitations

• Web is not supported in this release (the transport, disk cache, and offline queue depend on dart:io).
• OAuth covers the refresh-token flow only; authorization-code/PKCE is out of scope.