sonic 1.0.0

sonic: ^1.0.0 copied to clipboard

Major release with a production-ready, batteries-included HTTP client on top of Dio. Highlights:

• Safe decoding helpers: DecodeResult
• Typed builder API with cached decoders per type
• Retries with backoff+jitter and Retry-After support; 429 considered retryable
• Per-host rate limiting (token bucket) with RequestPriority (low/normal/high)
• Circuit breaker per-host (Closed/Open/HalfOpen) with event hooks
• Request templates registry for reusable presets
• Caching: in-memory LRU with TTL, SWR (stale-while-revalidate), ETag/Last-Modified validation and Expires fallback; optional composite/file stores
• Request deduplication for identical in-flight GETs
• Observability: response.extra includes timers (durationMs, networkMs, decodeMs, cacheLookupMs, cacheRevalidateMs, rateLimitWaitMs), retryDelaysMs, deduplicated, and requestUrl
• Pagination utilities: RFC Link header parsing, cursor helpers, offset/limit and page adapters; Paged
• Token refresh: SimpleAuthRefreshConfig and AuthRefreshInterceptor
• Fluent uploads with FormData helpers (upload(), field/fields, files, fileFromPath/Bytes/Stream)

Breaking changes:

• Timeout values in constants now use Duration instead of int milliseconds
• Public API surface expanded; ensure imports use package:sonic/sonic.dart

Docs:

• README simplified with links to GitHub Wiki, plus quick examples
• Cookbook added with pagination, templates, circuit breaker, and metrics recipes

Tooling:

• Added GitHub Actions workflows for wiki preview and link checking

• Documentation Update

• Initial version.