gt_secure 1.1.0

A production-ready Flutter package for secure local storage with AES-256-CBC encryption, automatic key management, in-memory caching, and comprehensive error handling. Perfect for storing sensitive da [...]

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.1.0 - 2026-03-28

Added

• Default Value Support: All getter methods (getString, getInt, etc.) now support an optional defaultValue parameter.
• Improved Key Validation: Added checks for empty or whitespace-only keys to prevent invalid storage operations.
• Enhanced Documentation: Updated doc comments for better clarity and API usage guidance.

Changed

• Flutter SDK Upgrade: Upgraded to latest stable Flutter (3.41.0+) and Dart (3.11.0+) constraints.
• Dependency Updates: Upgraded flutter_lints to version 6.0.0 and ensured compatibility with the latest secure storage plugins.

Fixed

• Empty String Handling Bug: Resolved an issue where storing or retrieving empty strings ("") could throw a SecureStorageException.
• Graceful Error Recovery: Decryption failures or malformed data now return an empty string or the specified defaultValue instead of throwing exceptions, improving app stability.

1.0.0 - 2024-12-27

Added

• AES-256-CBC Encryption: Military-grade encryption with unique IVs per encryption operation
• Type-Safe Storage: Support for String, int, bool, double, Map, List, and custom objects
• SecureStorageUtil class: Singleton pattern for global access
• Automatic Key Management: Secure key generation and storage
• Key Rotation Support: rotateEncryptionKey() method for enhanced security
• In-Memory LRU Cache: Caching for frequently accessed data with automatic eviction
• Thread-Safe Operations: Lock mechanism for concurrent access protection
• App Reinstall Detection: Automatic cleanup of stale data after app reinstallation
• Batch Operations: batchWrite() and batchRead() for efficient bulk operations
• Data Backup/Restore: exportData() and importData() methods
• Storage Statistics: getStorageStats() for monitoring storage usage
• Data Validation: validateKey() and validateAllData() for integrity checks
• Custom Exceptions: SecureStorageException with detailed error messages
• Retry Logic: Automatic retry for transient failures
• Version Migration: Built-in support for data migration between versions

Platform Support

• Android (EncryptedSharedPreferences)
• iOS (Keychain)
• macOS
• Linux
• Windows
• Web (localStorage with limitations)