feat: made resetAdapters public (#1014)

* feat: made resetAdapters public

* chore: run dart format

* docs: improved documentation

* docs: PR suggestion by @themisir

Co-authored-by: Misir Jafarov <[email protected]>

* refactor: included visibleForTesting

Author: alestiago

hive/lib/src/hive.dart

@@ -69,6 +69,18 @@ abstract class HiveInterface implements TypeRegistry {
 
   /// Checks if a box exists
   Future<bool> boxExists(String name, {String? path});
+
+  /// Clears all registered adapters.
+  ///
+  /// To register an adapter use [registerAdapter].
+  ///
+  /// NOTE: [resetAdapters] also clears the default adapters registered
+  /// by Hive.
+  ///
+  /// WARNING: This method is only intended to be used for integration and unit tests
+  /// and SHOULD not be used in production code.
+  @visibleForTesting
+  void resetAdapters();
 }
 
 ///

hive/lib/src/registry/type_registry_impl.dart

@@ -132,7 +132,6 @@ class TypeRegistryImpl implements TypeRegistry {
     return findAdapterForTypeId(typeId) != null;
   }
 
-  /// Not part of public API
   void resetAdapters() {
     _typeAdapters.clear();
   }

hive/test/tests/hive_impl_test.dart

@@ -9,6 +9,19 @@ import 'package:test/test.dart';
 
 import 'common.dart';
 
+class _TestAdapter extends TypeAdapter<int> {
+  _TestAdapter([this.typeId = 0]);
+
+  @override
+  final int typeId;
+
+  @override
+  int read(_) => 5;
+
+  @override
+  void write(_, __) {}
+}
+
 void main() {
   group('HiveImpl', () {
     Future<HiveImpl> initHive() async {
@@ -316,5 +329,24 @@ void main() {
         await hive.close();
       });
     });
+
+    group('.resetAdapters()', () {
+      test('returns normally', () async {
+        final hive = await initHive();
+        expect(hive.resetAdapters, returnsNormally);
+      });
+
+      test('clears an adapter', () async {
+        final hive = await initHive();
+        final adapter = _TestAdapter(1);
+
+        expect(hive.isAdapterRegistered(adapter.typeId), isFalse);
+        hive.registerAdapter(adapter);
+        expect(hive.isAdapterRegistered(adapter.typeId), isTrue);
+
+        hive.resetAdapters();
+        expect(hive.isAdapterRegistered(adapter.typeId), isFalse);
+      });
+    });
   });
 }