keep 0.2.14

keep: ^0.2.14 copied to clipboard

Changed #

• SubKeyManager.exists is now async and ensures initialization before checking.

Added #

• Added SubKeyEvent enum (added, removed, cleared) for tracking sub-key changes.
• Added stream getter to SubKeyManager for reactive sub-key monitoring.
• SubKeyManager now extends ChangeNotifier for Flutter widget integration.
• Added dispose() method to SubKeyManager for proper resource cleanup.

Changed #

• Renamed SubKeyManager.keys getter to toList() method for better API clarity.

Changed #

• Added documentation to SubKeyManager.keys getter.

Fixed #

• Fixed race condition in SubKeyManager._ensureInitialized() that could cause concurrent calls to run multiple _performLoad() operations.
• Added _ensureInitialized() call to SubKeyManager.remove() to prevent data loss.
• Errors in _performLoad() now properly complete the completer with error, preventing infinite waits.

Fixed #

• KeepType.fromByte now returns tNull instead of null for unknown bytes, preventing encoding crashes.

Changed #

• KeepKey no longer extends Stream. Use stream getter instead.
• Added exists getter to SubKeyManager.

Fixed #

• Added try-catch blocks to KeepCodec.encodeAll, decodeAll, and encodePayload methods.

Fixed #

• Internal storage now deletes corrupted files on decode failure instead of deadlocking.

Fixed #

• Added missing try-catch blocks to SubKeyManager I/O operations.
• Disabled avoid_catches_without_on_clauses lint rule for broader exception handling.

Added #

• Added memory cache for KeepKeyPlain and KeepKeySecure read operations.
• Added clear() and remove() methods to SubKeyManager.

Changed #

• Renamed KeepValueType to KeepType.
• Replaced tUnknown with tNull and added tBytes for Uint8List support.

Performance #

• Read operations now return cached values, significantly improving throughput.
• See test/stress_test.dart for benchmarks.

Changed #

• Added @mustCallSuper annotation to Keep.init() method.

Added #

• Added KeepValueType enum for type-safe binary encoding.
• Type byte now stored in binary format header.
• Added KeepValueType.parse<T>() for default type conversions.

Changed #

• Optimized sub-key registration and disk synchronization (synchronous registration, smart background sync).

Fixed #

• Resolved issues with sub-key hierarchy and traversal logic.

Changed #

• Improved global exception handling and error propagation stability.
• read methods now return null instead of throwing on corruption, ensuring graceful degradation.
• write methods now consistently fail-fast on errors.

Fixed #

• Fixed duplicate onError callbacks.

Added #

• Introduced binary format versioning and migration infrastructure (V1).
• Improved storage key hashing and internal data obfuscation.

Changed #

• Breaking: KeepKeySecure now stores raw encrypted values directly for better efficiency.
• Standardized code structure and return patterns.

Fixed #

• Fixed crash when handling empty external storage files.
• Added legacy format support during migration.

Added #

• Added Keep.custom for plain custom storage keys.

Changed #

• Renamed custom to customSecure for consistency.

Added #

• Exported KeepBuilder and KeepException.

Changed #

• Renamed useExternalStorage to useExternal.

Added #

• Added fromStorage/toStorage converters to KeepKeyPlain.
• Enhanced type safety for Keep.list and Keep.map factories.

Added #

• Providing a custom storage adapter now automatically enables useExternal.

Added #

• Support for per-key custom KeepStorage adapters.

Added #

• Added static key factories (Keep.integer, Keep.stringSecure, etc.).
• Added decimal and decimalSecure factories.

Changed #

• Keep.keys now uses internal registry for faster access.
• clearRemovable() automatically notifies listeners.

Fixed #

• Improved num to double conversion.
• Fixed boolean parsing support.

• Internal build stabilization.

• Initial release