[shared_preferences] Platform interface for new shared preferences async

packages/shared_preferences/shared_preferences_platform_interface/CHANGELOG.md

@@ -1,5 +1,6 @@
-## NEXT
+## 2.4.0
 
+* Adds `SharedPreferencesAsyncPlatform` API.
 * Updates minimum supported SDK version to Flutter 3.16/Dart 3.2.
 
 ## 2.3.2

packages/shared_preferences/shared_preferences_platform_interface/README.md

@@ -1,17 +1,26 @@
 # shared_preferences_platform_interface
 
-A common platform interface for the [`shared_preferences`][1] plugin.
+A common platform interface for the [`shared_preferences`][1] plugins.
 
 This interface allows platform-specific implementations of the `shared_preferences`
 plugin, as well as the plugin itself, to ensure they are supporting the
 same interface.
 
 # Usage
 
-To implement a new platform-specific implementation of `shared_preferences`, extend
-[`SharedPreferencesPlatform`][2] with an implementation that performs the
-platform-specific behavior, and when you register your plugin, set the default
-`SharedPreferencesLoader` by calling the `SharedPreferencesPlatform.loader` setter.
+To implement a new platform-specific implementation of `shared_preferences`, 
+extend [`SharedPreferencesPlatform`][2] with an implementation that performs 
+the platform-specific behavior, and when you register your plugin, set the default
+`SharedPreferencesStorePlatform` by calling the `SharedPreferencesPlatform.instance` setter.
+
+To implement a new platform-specific implementation of `shared_preferences_async`, 
+extend [`SharedPreferencesAsyncPlatform`][3] with an implementation that performs 
+the platform-specific behavior, and when you register your plugin, set the default
+`SharedPreferencesAsyncPlatform` by calling the `SharedPreferencesAsyncPlatform.instance` setter.
+
+Please note that the current tooling for platform communication only registers `SharedPreferencesPlugin`
+so if you intend to implement more than one plugin (as can be seen in the Android and iOS implementations)
+you will need to manually register the second plugin.
 
 # Note on breaking changes
 
@@ -23,3 +32,4 @@ on why a less-clean interface is preferable to a breaking change.
 
 [1]: ../shared_preferences
 [2]: lib/shared_preferences_platform_interface.dart
+[3]: lib/shared_preferences_async_platform_interface.dart

packages/shared_preferences/shared_preferences_platform_interface/lib/in_memory_shared_preferences_async.dart

@@ -0,0 +1,158 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'dart:async';
+
+import 'shared_preferences_async_platform_interface.dart';
+import 'types.dart';
+
+/// Stores data in memory.
+///
+/// Data does not persist across application restarts. This is useful in unit tests.
+base class InMemorySharedPreferencesAsync
+    extends SharedPreferencesAsyncPlatform {
+  /// Instantiates an empty in-memory preferences store.
+  InMemorySharedPreferencesAsync.empty() : _data = <String, Object>{};
+
+  /// Instantiates an in-memory preferences store containing a copy of [data].
+  InMemorySharedPreferencesAsync.withData(Map<String, Object> data)
+      : _data = Map<String, Object>.from(data);
+
+  final Map<String, Object> _data;
+
+  @override
+  Future<bool> clear(
+    ClearPreferencesParameters parameters,
+    SharedPreferencesOptions options,
+  ) async {
+    final PreferencesFilters filter = parameters.filter;
+    if (filter.allowList != null) {
+      _data.removeWhere((String key, _) => filter.allowList!.contains(key));
+    } else {
+      _data.clear();
+    }
+    return true;
+  }
+
+  @override
+  Future<Map<String, Object>> getPreferences(
+    GetPreferencesParameters parameters,
+    SharedPreferencesOptions options,
+  ) async {
+    final PreferencesFilters filter = parameters.filter;
+    final Map<String, Object> preferences = Map<String, Object>.from(_data);
+    preferences.removeWhere((String key, _) =>
+        filter.allowList != null && !filter.allowList!.contains(key));
+    return preferences;
+  }
+
+  Future<bool> _setValue(
+    String key,
+    Object value,
+    SharedPreferencesOptions options,
+  ) async {
+    _data[key] = value;
+    return true;
+  }
+
+  @override
+  Future<bool> setString(
+    String key,
+    String value,
+    SharedPreferencesOptions options,
+  ) async {
+    return _setValue(key, value, options);
+  }
+
+  @override
+  Future<bool> setInt(
+    String key,
+    int value,
+    SharedPreferencesOptions options,
+  ) async {
+    return _setValue(key, value, options);
+  }
+
+  @override
+  Future<bool> setDouble(
+    String key,
+    double value,
+    SharedPreferencesOptions options,
+  ) async {
+    return _setValue(key, value, options);
+  }
+
+  @override
+  Future<bool> setBool(
+    String key,
+    bool value,
+    SharedPreferencesOptions options,
+  ) async {
+    return _setValue(key, value, options);
+  }
+
+  @override
+  Future<bool> setStringList(
+    String key,
+    List<String> value,
+    SharedPreferencesOptions options,
+  ) async {
+    return _setValue(key, value, options);
+  }
+
+  @override
+  Future<String?> getString(
+    String key,
+    SharedPreferencesOptions options,
+  ) async {
+    return _data[key] as String?;
+  }
+
+  @override
+  Future<bool?> getBool(
+    String key,
+    SharedPreferencesOptions options,
+  ) async {
+    return _data[key] as bool?;
+  }
+
+  @override
+  Future<double?> getDouble(
+    String key,
+    SharedPreferencesOptions options,
+  ) async {
+    return _data[key] as double?;
+  }
+
+  @override
+  Future<int?> getInt(
+    String key,
+    SharedPreferencesOptions options,
+  ) async {
+    return _data[key] as int?;
+  }
+
+  @override
+  Future<List<String>?> getStringList(
+    String key,
+    SharedPreferencesOptions options,
+  ) async {
+    final List<Object?>? data = _data[key] as List<Object?>?;
+    return data?.cast<String>();
+  }
+
+  @override
+  Future<Set<String>> getKeys(
+    GetPreferencesParameters parameters,
+    SharedPreferencesOptions options,
+  ) async {
+    final Set<String> keys = _data.keys.toSet();
+    if (parameters.filter.allowList != null) {
+      keys.retainWhere(
+          (String element) => parameters.filter.allowList!.contains(element));
+    }
+
+    return keys;
+  }
+}

packages/shared_preferences/shared_preferences_platform_interface/lib/shared_preferences_async_platform_interface.dart

@@ -0,0 +1,109 @@
+// Copyright 2013 The Flutter Authors. All rights reserved.
+// Use of this source code is governed by a BSD-style license that can be
+// found in the LICENSE file.
+
+import 'dart:async';
+
+import 'types.dart';
+
+/// The interface that implementations of shared_preferences_async must implement.
+abstract base class SharedPreferencesAsyncPlatform {
+  /// Constructs a SharedPreferencesAsyncPlatform.
+  SharedPreferencesAsyncPlatform();
+
+  /// The instance of [SharedPreferencesAsyncPlatform] to use.
+  static SharedPreferencesAsyncPlatform? instance;
+
+  /// Stores the String [value] associated with the [key].
+  Future<void> setString(
+    String key,
+    String value,
+    SharedPreferencesOptions options,
+  );
+
+  /// Stores the bool [value] associated with the [key].
+  Future<void> setBool(
+    String key,
+    bool value,
+    SharedPreferencesOptions options,
+  );
+
+  /// Stores the double [value] associated with the [key].
+  Future<void> setDouble(
+    String key,
+    double value,
+    SharedPreferencesOptions options,
+  );
+
+  /// Stores the int [value] associated with the [key].
+  Future<void> setInt(
+    String key,
+    int value,
+    SharedPreferencesOptions options,
+  );
+
+  /// Stores the List<String> [value] associated with the [key].
+  Future<void> setStringList(
+    String key,
+    List<String> value,
+    SharedPreferencesOptions options,
+  );
+
+  /// Retrieves the String [value] associated with the [key], if any.
+  ///
+  /// Throws a [TypeError] if the returned type is not a String.
+  Future<String?> getString(
+    String key,
+    SharedPreferencesOptions options,
+  );
+
+  /// Retrieves the bool [value] associated with the [key], if any.
+  ///
+  /// Throws a [TypeError] if the returned type is not a bool.
+  Future<bool?> getBool(
+    String key,
+    SharedPreferencesOptions options,
+  );
+
+  /// Retrieves the double [value] associated with the [key], if any.
+  ///
+  /// Throws a [TypeError] if the returned type is not a double.
+  Future<double?> getDouble(
+    String key,
+    SharedPreferencesOptions options,
+  );
+
+  /// Retrieves the int [value] associated with the [key], if any.
+  ///
+  /// Throws a [TypeError] if the returned type is not an int.
+  Future<int?> getInt(
+    String key,
+    SharedPreferencesOptions options,
+  );
+
+  /// Retrieves the List<String> [value] associated with the [key], if any.
+  ///
+  /// Throws a [TypeError] if the returned type is not a List<String>.
+  Future<List<String>?> getStringList(
+    String key,
+    SharedPreferencesOptions options,
+  );
+
+  /// Removes all keys and values in the store that match the given [parameters].
+  Future<void> clear(
+    ClearPreferencesParameters parameters,
+    SharedPreferencesOptions options,
+  );
+
+  /// Returns all key/value pairs persisting in this store that match the given [parameters].
+  Future<Map<String, Object>> getPreferences(
+    GetPreferencesParameters parameters,
+    SharedPreferencesOptions options,
+  );
+
+  /// Returns all keys persisting in this store that match the given [parameters].
+  Future<Set<String>> getKeys(
+    GetPreferencesParameters parameters,
+    SharedPreferencesOptions options,
+  );
+}