prepare for v2.1.0

Author: hoc081098

CHANGELOG.md

@@ -1,9 +1,8 @@
-## 2.1.0-dev.0 - TODO
+## 2.1.0 - TODO
 
 - Accept `Dart SDK` versions above 3.0.
 
-- Refactor `executeUpdate`
-  - Rename to `update` and convert its parameters to named parameters
+- Deprecated `RxStorage.executeUpdate`. It has been replaced by `update` method.
     ```dart
     Future<void> update<T extends Object>({
       required Key key,
@@ -13,8 +12,8 @@
       Options? options,
     })
     ```
-  - Move `update` method from `RxStorage` interface to a new `TransactionallyStorage` interface.
-  - `Transformer<T>` can return a `Future<T>`.
+
+- `Transformer<T>` can return a `Future<T>`.
 
 - Update dependencies
   - `disposebag` to `^1.5.1`.

lib/src/impl/real_storage.dart

@@ -332,6 +332,23 @@ class RealRxStorage<Key extends Object, Options,
   // Get streams (implements [RxStorage])
   //
 
+  @nonVirtual
+  @experimental
+  @override
+  Future<void> executeUpdate<T extends Object>(
+    Key key,
+    Decoder<T?> decoder,
+    Transformer<T?> transformer,
+    Encoder<T?> encoder, [
+    Options? options,
+  ]) =>
+      update(
+        key: key,
+        decoder: decoder,
+        transformer: transformer,
+        encoder: encoder,
+      );
+
   @experimental
   @nonVirtual
   @override

lib/src/interface/rx_storage.dart

@@ -1,5 +1,7 @@
 import 'dart:async';
 
+import 'package:meta/meta.dart';
+
 import '../impl/real_storage.dart';
 import '../logger/logger.dart';
 import 'storage.dart';
@@ -20,6 +22,24 @@ abstract class RxStorage<Key extends Object, Options>
         onDispose,
       );
 
+  /// `Read–modify–write`.
+  ///
+  /// Read value by [key], then decode with [decoder],
+  /// then transform by [transformer],
+  /// then encode with [encoder]
+  /// and finally save decoded value to persistent storage.
+  ///
+  /// Use [update] instead. It will be removed in v3.0.0.
+  @experimental
+  @Deprecated('Use update instead. It will be removed in v3.0.0')
+  Future<void> executeUpdate<T extends Object>(
+    Key key,
+    Decoder<T?> decoder,
+    Transformer<T?> transformer,
+    Encoder<T?> encoder, [
+    Options? options,
+  ]);
+
   /// Return [Stream] that will emit value read from persistent storage.
   /// It will automatic emit value when value associated with key was changed.
   Stream<T?> observe<T extends Object>(Key key, Decoder<T?> decoder,

pubspec.yaml

@@ -1,6 +1,6 @@
 name: rx_storage
 description: Reactive storage for Dart/Flutter. RxDart Storage for Dart/Flutter.
-version: 2.1.0-dev.0
+version: 2.1.0
 homepage: https://github.com/Flutter-Dart-Open-Source/rx_storage.git
 repository: https://github.com/Flutter-Dart-Open-Source/rx_storage.git
 issue_tracker: https://github.com/Flutter-Dart-Open-Source/rx_storage/issues