✨ add support for enums.

Author: BirjuVachhani

packages/hyper_storage/lib/src/api/api.dart

@@ -692,6 +692,38 @@ abstract interface class StorageOperationsApi {
   /// * [ArgumentError] if the key invalid.
   Future<void> setDuration(String key, Duration value);
 
+  /// Saves an enum value of type [E] with the given [key].
+  ///
+  /// This method stores an enum value by its name, associating it with the specified key.
+  /// If a value already exists for this key, it will be replaced.
+  ///
+  /// Parameters:
+  /// - [key]: The unique identifier for the enum value.
+  /// - [value]: The enum value to store.
+  ///
+  /// Returns a [Future] that completes when the enum value has been successfully stored.
+  ///
+  /// Throws:
+  /// - [ArgumentError] if the key is invalid.
+  Future<void> setEnum<E extends Enum>(String key, E value);
+
+  /// Retrieves an enum value of type [E] by its [key].
+  ///
+  /// This method fetches an enum value previously stored using [setEnum].
+  /// If no value exists for the given key, or the stored value does not match
+  /// any of the provided enum values, this method returns `null`.
+  ///
+  /// Parameters:
+  /// - [key]: The unique identifier of the enum value to retrieve.
+  /// - [values]: A list of all possible enum values of type [E].
+  ///
+  /// Returns a [Future] that completes with the stored enum value if found,
+  /// or `null` if the key doesn't exist or the value does not match any enum values.
+  ///
+  /// Throws:
+  /// * [ArgumentError] if the key is invalid.
+  Future<E?> getEnum<E extends Enum>(String key, List<E> values);
+
   /// Retrieves a value of type [E] by its [key].
   ///
   /// This is a generic method that attempts to retrieve a value and cast it to
@@ -711,7 +743,7 @@ abstract interface class StorageOperationsApi {
   ///
   /// Throws:
   /// * [ArgumentError] if the key is invalid.
-  Future<E?> get<E extends Object>(String key);
+  Future<E?> get<E extends Object>(String key, {List<Enum>? enumValues});
 
   /// Saves a value of type [E] with the given [key].
   ///

packages/hyper_storage/lib/src/api/backend.dart

@@ -135,6 +135,19 @@ abstract class StorageBackend with GenericStorageOperationsMixin implements Stor
 
   @override
   Future<void> setDuration(String key, Duration value) => setInt(key, value.inMilliseconds);
+
+  @override
+  Future<void> setEnum<E extends Enum>(String key, E value) => setString(key, value.name);
+
+  @override
+  Future<E?> getEnum<E extends Enum>(String key, List<E> values) async {
+    final enumName = await getString(key);
+    if (enumName == null) return null;
+    for (final value in values) {
+      if (value.name == enumName) return value;
+    }
+    return null;
+  }
 }
 
 /// A mixin that provides generic implementations for storage operations.
@@ -170,19 +183,19 @@ mixin GenericStorageOperationsMixin implements StorageOperationsApi {
   }
 
   @override
-  Future<E?> get<E extends Object>(String key) async {
-    return switch (E) {
-      const (String) => await getString(key) as E?,
-      const (int) => await getInt(key) as E?,
-      const (double) => await getDouble(key) as E?,
-      const (bool) => await getBool(key) as E?,
-      const (DateTime) => await getDateTime(key) as E?,
-      const (Duration) => await getDuration(key) as E?,
-      const (List<String>) => await getStringList(key) as E?,
-      const (Map<String, dynamic>) => await getJson(key) as E?,
-      const (List<Map<String, dynamic>>) => await getJsonList(key) as E?,
-      _ => throw UnsupportedError('Type $E is not supported'),
-    };
+  Future<E?> get<E extends Object>(String key, {List<Enum>? enumValues}) async {
+    if (E == String) return await getString(key) as E?;
+    if (E == int) return await getInt(key) as E?;
+    if (E == double) return await getDouble(key) as E?;
+    if (E == bool) return await getBool(key) as E?;
+    if (E == DateTime) return await getDateTime(key) as E?;
+    if (E == Duration) return await getDuration(key) as E?;
+    if (E == List<String>) return await getStringList(key) as E?;
+    if (E == Map<String, dynamic>) return await getJson(key) as E?;
+    if (E == List<Map<String, dynamic>>) return await getJsonList(key) as E?;
+    if (enumValues != null) return await getEnum(key, enumValues) as E?;
+
+    throw UnsupportedError('Type $E is not supported');
   }
 
   @override
@@ -197,6 +210,7 @@ mixin GenericStorageOperationsMixin implements StorageOperationsApi {
       List<String> value => setStringList(key, value),
       Map<String, dynamic> value => setJson(key, value),
       List<Map<String, dynamic>> value => setJsonList(key, value),
+      Enum value => setString(key, value.name),
       _ => throw UnsupportedError('Type ${value.runtimeType} is not supported'),
     };
   }

packages/hyper_storage/lib/src/hyper_storage_container.dart

@@ -214,6 +214,24 @@ final class HyperStorageContainer extends StorageContainer with ItemHolderMixin,
     notifyListeners(key);
   }
 
+  @override
+  Future<E?> getEnum<E extends Enum>(String key, List<E> values) async {
+    validateKey(key);
+    final String? enumName = await backend.getString(encodeKey(key));
+    if (enumName == null) return null;
+    for (final enumValue in values) {
+      if (enumValue.name == enumName) return enumValue;
+    }
+    return null;
+  }
+
+  @override
+  Future<void> setEnum<E extends Enum>(String key, E value) async {
+    validateKey(key);
+    await backend.setString(encodeKey(key), value.name);
+    notifyListeners(key);
+  }
+
   @override
   Future<void> removeAll(Iterable<String> keys) async {
     validateKeys(keys);

packages/hyper_storage/lib/src/storage_base.dart

@@ -192,6 +192,24 @@ abstract class _HyperStorageImpl extends BaseStorage
     notifyListeners(key);
   }
 
+  @override
+  Future<E?> getEnum<E extends Enum>(String key, List<E> values) async {
+    validateKey(key);
+    final String? enumName = await backend.getString(key);
+    if (enumName == null) return null;
+    for (final enumValue in values) {
+      if (enumValue.name == enumName) return enumValue;
+    }
+    return null;
+  }
+
+  @override
+  Future<void> setEnum<E extends Enum>(String key, E value) async {
+    validateKey(key);
+    await backend.setString(key, value.name);
+    notifyListeners(key);
+  }
+
   @override
   Future<void> setInt(String key, int value) async {
     validateKey(key);