juice_storage 0.9.0

Local storage, caching, and secure storage for the Juice framework. Supports Hive, SharedPreferences, SQLite, and flutter_secure_storage.

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.

0.9.0 - 2025-01-12

Release Candidate

Feature-complete release with comprehensive test coverage. API is stabilizing; 1.0.0 will follow after production validation.

Added

• SQLite Use Case Tests - Comprehensive test coverage for SQLite operations (27 new tests)
• Platform Support Documentation - Added platform compatibility table to README

Changed

• Updated dependency: juice: ^1.2.0

Breaking Changes

• Renamed ResultEvent to StorageResultEvent - Resolves naming conflict with juice core's ResultEvent. If you subclassed ResultEvent, update to extend StorageResultEvent instead.
• Standardized Hive event parameters - HiveOpenBoxEvent and HiveCloseBoxEvent now use box parameter instead of boxName for consistency with other Hive events.
  • Before: HiveOpenBoxEvent(boxName: 'cache')
  • After: HiveOpenBoxEvent(box: 'cache')
• Helper method parameter renamed - hiveOpenBox(String boxName) is now hiveOpenBox(String box)

Documentation

• Added platform support matrix showing backend availability per platform
• Web limitations documented for SQLite and Secure Storage

---

0.8.0 - 2025-01-10

Added

• StorageBloc - Unified BLoC for managing multiple storage backends
• Hive Support - Structured key-value storage with box management
  • TTL-based caching with automatic lazy eviction on read
  • Lazy box initialization
• SharedPreferences Support - Simple key-value storage
  • TTL-based caching with lazy eviction
  • Configurable key prefix
• SQLite Support - Relational database operations
  • Raw SQL execution
  • Typed insert/update/delete/query methods
  • Per-table rebuild groups
• Secure Storage Support - Encrypted storage for sensitive data
  • flutter_secure_storage integration
  • No TTL (by design for security)
• Background Cleanup - Optional background task for proactive cache eviction
• Cache Index - Centralized TTL metadata tracking across backends
• Helper Methods - Convenient async methods on StorageBloc
• Rebuild Groups - Targeted widget rebuilds per backend/entity
• Event-Driven Architecture - Full Juice framework integration
• Cumulative Eviction Tracking - Track evictions by backend type

Documentation

• Comprehensive README with badges and examples
• Complete documentation in doc/ folder:
  • Getting Started guide
  • Storage Backends reference
  • Events Reference
  • Caching and TTL guide
  • Testing guide

Package Publishing

• Added LICENSE (MIT)
• Added pub.dev metadata (topics, funding, issue tracker)
• Added GitHub Sponsors funding link