flutter_smartdio 1.0.1

A transport-agnostic HTTP wrapper that enhances ANY HTTP client with offline caching, request queuing, retry mechanisms, and comprehensive logging.

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 - 2024-01-01

Added

• Initial release of Flutter SmartDio
• Transport-agnostic HTTP wrapper architecture
• HttpClientAdapter interface for client abstraction
• SmartDioClient with comprehensive request/response handling
• Unified response system with SmartDioSuccess/SmartDioError
• Never-crash philosophy with structured error handling
• Intelligent retry policies:
  • Exponential backoff with jitter
  • Fixed delay retry
  • Custom retry logic
• Offline-first caching system:
  • Network-first, cache-first strategies
  • TTL-based cache expiration
  • Memory and pluggable storage backends
• Request queuing for offline scenarios:
  • Persistent queue storage
  • Automatic sync when connectivity returns
  • Queue management and monitoring
• Native logging system:
  • Sensitive data redaction
  • Configurable log levels
  • Multiple output sinks
• Connectivity management:
  • Real-time network status monitoring
  • Connection quality detection
  • Manual offline mode for testing
• Performance metrics collection:
  • Request timing and success rates
  • Cache hit rates and storage usage
  • Queue processing statistics
• Request deduplication:
  • Signature-based duplicate detection
  • Configurable time windows
  • In-flight request protection
• Interceptor architecture:
  • Pre-request modification
  • Post-response transformation
  • Error handling and recovery
• Built-in implementations:
  • HttpClient adapter for dart:io
  • Memory-based cache store
  • Memory-based queue storage
• Type-safe response transformation
• Comprehensive configuration system
• Request tagging and bulk operations
• Correlation ID tracking
• Rich metadata and debugging information

Security

• Automatic sensitive header redaction
• Configurable sensitive field detection
• Secure credential handling in logs
• No sensitive data exposure in error messages

Performance

• Minimal memory footprint
• Efficient request deduplication
• Smart cache cleanup and eviction
• Connection pooling through underlying clients
• Lazy initialization of optional components

Developer Experience

• Comprehensive documentation and examples
• Type-safe APIs with full generic support
• Rich error messages with context
• Easy testing with mock adapters
• Detailed logging for debugging
• Real-time event streaming for monitoring

Documentation

• Complete API documentation
• Usage examples for all features
• Architecture overview and design principles
• Migration guides and best practices
• Performance tuning recommendations