http_nexus 1.0.0

A lightweight but powerful HTTP client wrapper that simplifies API handling with automatic retries, error management, and network failure handling.

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.

1.0.0 - 2026-03-06

Added

• Initial release of Smart API Client
• HTTP methods support (GET, POST, PUT, PATCH, DELETE)
• Automatic retry mechanism with exponential backoff
• Configurable retry policy
• Timeout handling for all requests
• Unified error handling system with typed exceptions
• Request cancellation support
• Request and response interceptors
• Automatic JSON encoding/decoding
• Offline request queue for storing failed requests
• Built-in logging system with LoggingInterceptor
• Rate limiting protection
• Global configuration for base URL, headers, and timeout
• Authentication token provider support
• AuthInterceptor for automatic token attachment
• Network connectivity checker utility
• Comprehensive documentation and examples
• Unit tests for core functionality
• Example Flutter app demonstrating all features

Exception Classes

• NetworkException - Network connectivity errors
• TimeoutException - Request timeout errors
• ServerException - Server-side errors with status codes
• ParseException - JSON parsing errors
• CancelledException - Cancelled request errors
• RateLimitException - Rate limit exceeded errors
• AuthenticationException - Authentication failures (401)
• AuthorizationException - Authorization failures (403)

Features

• Exponential backoff with configurable multiplier
• Custom retry decision logic
• Per-request timeout override
• Query parameter support
• Custom headers per request
• Request/response logging
• Network status monitoring
• Offline queue management
• Rate limit tracking

[Unreleased]

Planned

• GraphQL support
• WebSocket support
• Response caching
• Request deduplication
• Upload/download progress tracking
• Multipart form data support
• Cookie management
• Certificate pinning
• Token refresh interceptor
• Request priority queue