chore: update CHANGELOG for version 0.0.6, fix async/await issues in LocalStorageHelper, enhance HiveCE storage retrieval, and improve UI feedback in example app

Author: gurkanfikretgunak

CHANGELOG.md

@@ -5,6 +5,21 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [0.0.6] - 2026-01-07
+
+### Fixed
+- Fixed async/await issue in `LocalStorageHelper.getByKey()` method
+- `getByKey()` now properly awaits initialization before retrieving values from HiveCE
+- Fixed HiveCE storage retrieval to properly handle async operations
+- Improved error handling in `HiveCeStorageCubit.getByKey()` method
+
+### Changed
+- `LocalStorageHelper.getByKey()` is now async and properly initializes storage before access
+- Updated HiveCE example view to show "Key Not Found" message when value is null
+- Improved UI feedback in Get by Key section with color-coded success/error states
+
+[0.0.6]: https://github.com/gurkanfikretgunak/masterfabric_core/releases/tag/v0.0.6
+
 ## [0.0.5] - 2026-01-07
 
 ### Added

README.md

@@ -70,7 +70,7 @@ Add this to your package's `pubspec.yaml` file:
 
 ```yaml
 dependencies:
-  masterfabric_core: ^0.0.5
+  masterfabric_core: ^0.0.6
 ```
 
 Then run:
@@ -237,9 +237,15 @@ LocalStorageHelper.setStorageType(LocalStorageType.hiveCe); // or LocalStorageTy
 await LocalStorageHelper.setString('key', 'value');
 final value = LocalStorageHelper.getString('key');
 
+// Get value by key (supports any type, async)
+final dynamicValue = await LocalStorageHelper.getByKey('key');
+
 // Get all items from database
 final allItems = await LocalStorageHelper.getAllItems();
 
+// Check if key exists
+final exists = LocalStorageHelper.hasKey('key');
+
 // Permissions
 final permissionHelper = PermissionHandlerHelper();
 final granted = await permissionHelper.requestPermission(Permission.camera);
@@ -300,7 +306,7 @@ For detailed documentation, see:
 
 - **Pub.dev**: [https://pub.dev/packages/masterfabric_core](https://pub.dev/packages/masterfabric_core)
 - **GitHub**: [https://github.com/gurkanfikretgunak/masterfabric_core](https://github.com/gurkanfikretgunak/masterfabric_core)
-- **Version**: 0.0.5
+- **Version**: 0.0.6
 - **License**: AGPL-3.0
 
 ## Contributing
@@ -331,7 +337,7 @@ Or add it manually to your `pubspec.yaml`:
 
 ```yaml
 dependencies:
-  masterfabric_core: ^0.0.5
+  masterfabric_core: ^0.0.6
 ```
 
 ---

example/lib/features/helpers/helpers_hub_view.dart

@@ -108,7 +108,7 @@ class HelpersHubView extends StatelessWidget {
       ),
       _HelperItem(
         title: 'HiveCE Storage',
-        description: 'HiveCE storage demo',
+        description: 'HiveCE storage cases',
         icon: LucideIcons.database,
         route: app_routes.AppRoutes.hiveCeStorageDemo,
       ),

example/lib/features/helpers/storage/hive_ce/cubit/hive_ce_storage_cubit.dart

@@ -10,15 +10,32 @@ class HiveCeStorageCubit extends BaseViewModelCubit<HiveCeStorageState> {
   Future<void> _loadStoredValues() async {
     final allItems = await LocalStorageHelper.getAllItems();
     stateChanger(HiveCeStorageState(
-      storedString: LocalStorageHelper.getString('hivece_demo_string'),
-      storedInt: LocalStorageHelper.getInt('hivece_demo_int'),
-      storedBool: LocalStorageHelper.getBool('hivece_demo_bool'),
-      storedDouble: LocalStorageHelper.getDouble('hivece_demo_double'),
-      storedStringList: LocalStorageHelper.getStringList('hivece_demo_string_list'),
+      storedString: LocalStorageHelper.getString('hivece_case_string'),
+      storedInt: LocalStorageHelper.getInt('hivece_case_int'),
+      storedBool: LocalStorageHelper.getBool('hivece_case_bool'),
+      storedDouble: LocalStorageHelper.getDouble('hivece_case_double'),
+      storedStringList: LocalStorageHelper.getStringList('hivece_case_string_list'),
       allItems: allItems,
     ));
   }
 
+  /// Get value by key (supports any type)
+  Future<void> getByKey(String key) async {
+    try {
+      final value = await LocalStorageHelper.getByKey(key);
+      stateChanger(state.copyWith(
+        retrievedValue: value,
+        retrievedKey: key,
+      ));
+    } catch (e) {
+      // Handle error if needed
+      stateChanger(state.copyWith(
+        retrievedValue: null,
+        retrievedKey: key,
+      ));
+    }
+  }
+
   Future<void> loadAllItems() async {
     await _loadStoredValues();
   }
@@ -49,11 +66,17 @@ class HiveCeStorageCubit extends BaseViewModelCubit<HiveCeStorageState> {
   }
 
   Future<void> clearStorage() async {
-    await LocalStorageHelper.remove('hivece_demo_string');
-    await LocalStorageHelper.remove('hivece_demo_int');
-    await LocalStorageHelper.remove('hivece_demo_bool');
-    await LocalStorageHelper.remove('hivece_demo_double');
-    await LocalStorageHelper.remove('hivece_demo_string_list');
+    await LocalStorageHelper.remove('hivece_case_string');
+    await LocalStorageHelper.remove('hivece_case_int');
+    await LocalStorageHelper.remove('hivece_case_bool');
+    await LocalStorageHelper.remove('hivece_case_double');
+    await LocalStorageHelper.remove('hivece_case_string_list');
+    await _loadStoredValues();
+  }
+
+  /// Remove item by key
+  Future<void> removeByKey(String key) async {
+    await LocalStorageHelper.remove(key);
     await _loadStoredValues();
   }
 }

example/lib/features/helpers/storage/hive_ce/cubit/hive_ce_storage_state.dart

@@ -8,6 +8,8 @@ class HiveCeStorageState extends Equatable {
   final double? storedDouble;
   final List<String>? storedStringList;
   final Map<String, dynamic>? allItems;
+  final dynamic retrievedValue;
+  final String? retrievedKey;
 
   const HiveCeStorageState({
     this.storedString,
@@ -16,6 +18,8 @@ class HiveCeStorageState extends Equatable {
     this.storedDouble,
     this.storedStringList,
     this.allItems,
+    this.retrievedValue,
+    this.retrievedKey,
   });
 
   const HiveCeStorageState.initial()
@@ -24,7 +28,9 @@ class HiveCeStorageState extends Equatable {
         storedBool = null,
         storedDouble = null,
         storedStringList = null,
-        allItems = null;
+        allItems = null,
+        retrievedValue = null,
+        retrievedKey = null;
 
   HiveCeStorageState copyWith({
     String? storedString,
@@ -33,6 +39,8 @@ class HiveCeStorageState extends Equatable {
     double? storedDouble,
     List<String>? storedStringList,
     Map<String, dynamic>? allItems,
+    dynamic retrievedValue,
+    String? retrievedKey,
   }) {
     return HiveCeStorageState(
       storedString: storedString ?? this.storedString,
@@ -41,6 +49,8 @@ class HiveCeStorageState extends Equatable {
       storedDouble: storedDouble ?? this.storedDouble,
       storedStringList: storedStringList ?? this.storedStringList,
       allItems: allItems ?? this.allItems,
+      retrievedValue: retrievedValue ?? this.retrievedValue,
+      retrievedKey: retrievedKey ?? this.retrievedKey,
     );
   }
 
@@ -52,6 +62,8 @@ class HiveCeStorageState extends Equatable {
         storedDouble,
         storedStringList,
         allItems,
+        retrievedValue,
+        retrievedKey,
       ];
 }