s_client 1.0.0

Safe-by-default HTTP client with dual backend support (http/dio), never throws exceptions, returns result tuples, supports interceptors, retry logic, and type-safe JSON parsing.

1.0.0

• Initial release
• Safe by Default: All requests wrapped in internal try-catch blocks
  • Never throws unhandled exceptions - guaranteed safe execution
  • All errors captured and returned as ClientException in tuple
  • No need for manual try-catch blocks around HTTP requests
• Unified API: All HTTP methods return result tuples AND support optional callbacks
  • Every method returns (ClientResponse?, ClientException?) tuple for structured error handling
  • Optional callbacks (onSuccess, onError, onHttpError, onStatus, onProgress) for reactive programming
  • Use tuple-only, callbacks-only, or BOTH approaches simultaneously
  • Callbacks and tuple results receive the same response object
• Dual backend support (http and dio packages)
  • Switch between lightweight http or feature-rich dio at runtime
  • Identical API regardless of backend
• Type-safe JSON parsing
  • getJson<T>, getJsonList<T>, postJson<T> with automatic deserialization
  • Custom fromJson functions for type safety
• Customizable success and error status codes
  • Define which HTTP status codes are success vs error
  • Per-request or global configuration
• Built-in interceptors:
  • LoggingInterceptor: Request/response logging with pretty-print JSON
  • AuthInterceptor: Bearer, API Key, Basic, Custom authentication
  • CacheInterceptor: In-memory response caching
  • ClientInterceptor: Base class for custom interceptors
• Automatic retry logic with exponential backoff
  • Configurable retry attempts, delays, and status codes
  • Per-request cancellation support
• File operations
  • Upload files with progress callbacks
  • Download files with progress callbacks
• Request cancellation
  • Cancel individual requests by key
  • Cancel all pending requests
• Comprehensive test coverage
• Clean, modern Dart 3+ API with records (tuples), sealed classes, and pattern matching