sonic 1.1.0

sonic: ^1.1.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

New: Per-request API Versioning with placeholders and custom resolvers

• Per-request API version switching via SonicRequestBuilder.useApiVersion('v2').
• BaseConfiguration.apiVersions supports placeholders: {baseUrl}, {origin}, {scheme}, {host}, {port}, {basePath}, {version}.
• Custom placeholder resolver: apiVersionPlaceholderResolver(name, arg, baseUri, version).
• Optional environment-based resolution for {env:NAME} (disabled by default):
  • envPlaceholdersFromDartDefines: read from String.fromEnvironment(NAME).
  • envPlaceholdersFromProcessEnv: read from Platform.environment[NAME].
• URL resolution, caching/deduplication, and rate-limiting/circuit selection honor the resolved absolute URL.
• Download path and onRequest hooks use the effective baseUrl.

Docs

• README: Feature bullet, API Versioning section with placeholders.
• Wiki: API-Versioning page with configuration, placeholders, custom resolver, env flags, and examples.

Tests

• Added tests for {baseUrl}, {origin}/{version}, custom resolver, and general request wiring.

Internal

• Minor lint cleanups and consistency tweaks around control bodies and import ordering.

• Documentation Update

• Initial version.