Added #

• Added EncryptionService class for AES-256 encryption of cached data

Added #

• Added CacheTtlEtagConfig class for better configuration management
• Added copyWith() method to CacheTtlEtagConfig for easy configuration modification

Changed #

• BREAKING: CachedTtlEtagRepository now accepts a single CacheTtlEtagConfig parameter instead of multiple individual parameters
• Improved repository configuration pattern for better code organization and reusability

Migration Guide #

// Before (v1.0.x)
final repository = CachedTtlEtagRepository<MyModel>(
  url: 'https://api.example.com/data',
  fromJson: (json) => MyModel.fromJson(json),
  method: 'GET',
  headers: {'Authorization': 'Bearer token'},
  defaultTtl: Duration(minutes: 5),
);

// After (v1.0.2)
final config = CacheTtlEtagConfig<MyModel>(
  url: 'https://api.example.com/data',
  fromJson: (json) => MyModel.fromJson(json),
  method: 'GET',
  headers: {'Authorization': 'Bearer token'},
  defaultTtl: Duration(minutes: 5),
);
final repository = CachedTtlEtagRepository<MyModel>(config);

Added #

• Added support for interceptor pattern

Added #

• Initial release of TTL/ETag Cache
• TTL (Time To Live) based cache expiration
• ETag support for conditional HTTP requests
• Optional AES-256 encryption for cached data
• Reactive stream-based architecture with RxDart
• Repository pattern implementation
• Isar database for persistent storage
• CacheTtlEtagState for comprehensive UI state management
• Support for custom cache keys
• Support for nested response data extraction
• GET and POST request support
• Cache migration between encryption modes
• Cache statistics and monitoring
• Automatic stale cache marking
• Network optimization with 304 Not Modified
• Offline-first capabilities
• Comprehensive documentation and examples
• Type-safe generic implementation
• BroadcastStream for multi-listener support

Features #

• TtlEtagCache.init() - Initialize cache system
• TtlEtagCache.refetch() - Fetch with caching
• TtlEtagCache.invalidate() - Delete cache entries
• TtlEtagCache.clearAll() - Clear all cache
• TtlEtagCache.clearAndResetEncryption() - Reset encryption
• TtlEtagCache.migrateEncryption() - Migrate encryption mode
• CachedTtlEtagRepository - Repository pattern implementation
• CacheTtlEtagState - Comprehensive state management
• EncryptionService - AES-256 encryption service
• ReactiveCacheDio - Core caching service

Documentation #

• Complete README with examples
• API reference documentation
• Advanced usage patterns
• Security best practices
• Troubleshooting guide
• Performance optimization tips
• Testing guidelines

[Unreleased] #

Planned Features #

• Background cache refresh
• Batch cache operations
• Cache compression
• Cache size limits
• Multi-level cache (memory + disk)
• Custom cache strategies
• Cache analytics and metrics
• WebSocket support
• GraphQL support

For migration guides and breaking changes, see MIGRATION.md