Initial implementation of purchase collection.

CHANGELOG.md

@@ -10,6 +10,10 @@ a beta or production release, they must be documented here).
 
 ## [Unreleased]
 
+### Added
+- Creation of the structure for implementing paid decks.
+- Now the deck can be paid for, just add the `productInfo` and also if it is `isPremium`.
+
 ### Added
 - Visually Opinionated Buttons (Primary, Secondary and Text).
 

assets/collections/bdd_fundamentos_01.json

@@ -7,10 +7,6 @@
     "tests",
     "bdd"
   ],
-  "productInfo": {
-    "price": null,
-    "productId": null
-  },
   "contributors": [
     {
       "name": "Nicolas Nascimento",

assets/collections/comecando_com_git.json

@@ -7,10 +7,6 @@
     "git",
     "versionamento"
   ],
-  "productInfo": {
-    "price": null,
-    "productId": null
-  },
   "contributors": [
     {
       "name": "@matuella",

assets/collections/ecossistema_do_flutter.json

@@ -8,10 +8,6 @@
     "framework",
     "cross-platform"
   ],
-  "productInfo": {
-    "price": null,
-    "productId": null
-  },
   "contributors": [
     {
       "name": "@matuella",

assets/collections/fundamentos_scrum.json

@@ -7,10 +7,6 @@
     "agile",
     "scrum"
   ],
-  "productInfo": {
-    "price": null,
-    "productId": null
-  },
   "contributors": [
     {
       "name": "Olympus",

assets/collections/guia_scrum.json

@@ -7,10 +7,6 @@
     "agile",
     "scrum"
   ],
-  "productInfo": {
-    "price": null,
-    "productId": null
-  },
   "contributors": [
     {
       "name": "Daniel Wildt",

assets/collections/kotlin_fundamentos_01.json

@@ -7,10 +7,6 @@
     "kotlin",
     "linguagem de programação"
   ],
-  "productInfo": {
-    "price": null,
-    "productId": null
-  },
   "contributors": [
     {
       "name": "Lucas Montano",

assets/collections/manifesto_agil.json

@@ -6,10 +6,6 @@
   "tags": [
     "agile"
   ],
-  "productInfo": {
-    "price": null,
-    "productId": null
-  },
   "contributors": [
     {
       "name": "Daniel Wildt",

assets/collections/swift_fundamentos_01.json

@@ -7,10 +7,6 @@
     "swift",
     "linguagem de programação"
   ],
-  "productInfo": {
-    "price": null,
-    "productId": null
-  },
   "contributors": [
     {
       "name": "@matuella",

lib/application/constants/strings.dart

@@ -33,8 +33,6 @@ const collectionsStartNow = 'Começar Agora';
 const collectionPurchase = 'Deseja comprar este Deck?';
 const collectionSuccessPurchase = 'Deck comprado com sucesso!';
 String collectionPurchaseDeck(double price) => 'Comprar deck - R\$ ${price.toStringAsFixed(2)}';
-// TODO(joao): check the best place to store the const double.
-const double collectionPrice = 0.99;
 
 String collectionsEmptyTitleSegment(CollectionsSegment segment) {
   switch (segment) {
@@ -100,7 +98,7 @@ const jumpTo = 'Pular para';
 // Tags Component
 //
 const tags = 'Tags';
-const premium = 'PREMIUM';
+const premium = 'Premium';
 const tagsHint = 'Adicione as tags...';
 const suggestions = 'Sugestões';
 const addTags = 'Adicionar Tags';

lib/application/pages/details/collection_details_page.dart

@@ -97,25 +97,29 @@ class CollectionDetailsPage extends ConsumerWidget {
 
       sections.add(resourcesSection);
 
-      final studyNowButton = PrimaryElevatedButton(
-        onPressed: () => readCoordinator(ref).navigateToCollectionExecution(id, isNestedNavigation: false),
-        text: strings.detailsStudyNow.toUpperCase(),
-      );
-
-      final purchaseDeckButton = SecondaryElevatedButton(
-        backgroundColor: memoTheme.secondarySwatch,
-        text: strings.collectionPurchaseDeck(state.metadata.price),
-        onPressed: () async => _collectionPurchaseBottomSheet(
-          context,
-          () => ref.watch(collectionDetailsVM(id).notifier).purchaseCollection(state.metadata.id),
-        ),
-      );
+      Widget actionButton() {
+        if (state.isPurchased) {
+          return PrimaryElevatedButton(
+            onPressed: () => readCoordinator(ref).navigateToCollectionExecution(id, isNestedNavigation: false),
+            text: strings.detailsStudyNow.toUpperCase(),
+          );
+        } else {
+          return SecondaryElevatedButton(
+            backgroundColor: memoTheme.secondarySwatch,
+            text: strings.collectionPurchaseDeck(state.metadata.price!),
+            onPressed: () async => _collectionPurchaseBottomSheet(
+              context,
+              () => ref.watch(collectionDetailsVM(id).notifier).purchaseCollection(state.metadata.id),
+            ),
+          );
+        }
+      }
 
       final fixedBottomAction = ThemedBottomContainer(
         child: ColoredBox(
           color: memoTheme.neutralSwatch.shade800,
           child: SafeArea(
-            child: (state.isPurchased ? studyNowButton : purchaseDeckButton),
+            child: actionButton(),
           ).withSymmetricalPadding(
             context,
             vertical: Spacing.small,

lib/application/view-models/app_vm.dart

@@ -139,9 +139,8 @@ class AppVMImpl extends AppVM {
       splashMinDuration,
     ]);
 
-    await Future.wait<dynamic>([
-      collectionPurchaseServices.updatePurchasesIfNeeded(),
-    ]);
+    // This dependency needs to be loaded after the "dependent dependencies" as it depends on checking purchases that cannot be loaded in parallel.
+    await collectionPurchaseServices.updatePurchasesIfNeeded();
 
     value = AsyncValue.data(appState);
   }

lib/application/view-models/item_metadata.dart

@@ -21,7 +21,7 @@ abstract class CollectionItem extends ItemMetadata {
     required this.category,
     required this.tags,
     required this.isPremium,
-    required this.price,
+    this.price,
   });
 
   final String id;
@@ -30,7 +30,7 @@ abstract class CollectionItem extends ItemMetadata {
   final List<String> tags;
 
   final bool isPremium;
-  final double price;
+  final double? price;
 
   @override
   List<Object?> get props => [id, name, category, tags, isPremium];
@@ -45,7 +45,7 @@ class CompletedCollectionItem extends CollectionItem {
     required String category,
     required List<String> tags,
     required bool isPremium,
-    required double price,
+    double? price,
   }) : super(
           id: id,
           name: name,
@@ -72,7 +72,7 @@ class IncompleteCollectionItem extends CollectionItem {
     required String category,
     required List<String> tags,
     required bool isPremium,
-    required double price,
+    double? price,
   }) : super(
           id: id,
           name: name,
@@ -104,7 +104,7 @@ CollectionItem mapStatusToMetadata(CollectionStatus status) {
       category: collection.category,
       tags: collection.tags,
       isPremium: collection.isPremium,
-      price: collection.productInfo.price,
+      price: collection.productInfo?.price,
     );
   } else {
     return IncompleteCollectionItem(
@@ -115,7 +115,7 @@ CollectionItem mapStatusToMetadata(CollectionStatus status) {
       category: collection.category,
       tags: collection.tags,
       isPremium: collection.isPremium,
-      price: collection.productInfo.price,
+      price: collection.productInfo?.price,
     );
   }
 }

lib/application/widgets/theme/collection_card.dart

@@ -37,7 +37,7 @@ class CollectionCard extends ConsumerWidget {
   /// List of tags associated with this collection.
   final List<String> tags;
 
-  ///
+  /// `true` If the collection is available for purchase.
   final bool isPremium;
 
   /// If this widget should draw a border for this card.

lib/data/repositories/collection_repository.dart

@@ -93,7 +93,7 @@ class CollectionRepositoryImpl implements CollectionRepository {
               CollectionKeys.uniqueMemosAmount: collection.uniqueMemosAmount,
               CollectionKeys.uniqueMemoExecutionsAmount: collection.uniqueMemoExecutionsAmount,
               CollectionKeys.isPremium: collection.isPremium,
-              CollectionKeys.productInfo: _productInfoSerializer.to(collection.productInfo),
+              if (collection.isPremium) CollectionKeys.productInfo: _productInfoSerializer.to(collection.productInfo!),
             },
           )
           .toList(),

lib/data/repositories/purchase_repository.dart

@@ -5,23 +5,31 @@ abstract class PurchaseRepository {
   /// Purchase products in the app with the store ID [storeId] for the local user.
   Future<void> purchaseInApp({required String storeId});
 
-  /// Receives purchase information made by the user.
-  Future<List<String>> getPurchasesInfo();
+  /// Fetches a list of RevenueCat purchase information strings by user id.
+  ///
+  /// This function retrieves purchase information asynchronously
+  /// and returns a list of strings, where each string represents a purchase.
+  Future<List<String>> getUserPurchases();
 
   /// Check which products are available for purchase.
   Future<List<String>> isAvailable();
 
-  /// Updates the collection with the [id] to be premium or not.
+  /// Updates the collection with the [purchaseId] to be premium or not.
   Future<void> updatePurchase({required String purchaseId});
 
-  Future<List<String>> getPurchaseProducts();
+  /// Fetches a list of purchased product IDs from the local database.
+  ///
+  /// This function asynchronously retrieves all the purchases stored in the local database
+  /// and extracts the product IDs from each purchase record.
+  Future<List<String>> getPurchasedProductsIds();
 }
 
 class PurchaseRepositoryImpl implements PurchaseRepository {
   PurchaseRepositoryImpl(this._db, this._purchaseGateway);
 
   final SembastDatabase _db;
   final _purchasesStore = 'purchases';
+  final _purchaseIdKey = 'purchasesId';
 
   final PurchaseGateway _purchaseGateway;
 
@@ -31,7 +39,7 @@ class PurchaseRepositoryImpl implements PurchaseRepository {
       );
 
   @override
-  Future<List<String>> getPurchasesInfo() async {
+  Future<List<String>> getUserPurchases() async {
     final info = await _purchaseGateway.purchasesInfo();
     return info.map((purchase) => purchase).toList();
   }
@@ -46,14 +54,14 @@ class PurchaseRepositoryImpl implements PurchaseRepository {
   Future<void> updatePurchase({required String purchaseId}) => _db.put(
         id: purchaseId,
         object: <String, dynamic>{
-          'purchasesId': purchaseId,
+          _purchaseIdKey: purchaseId,
         },
         store: _purchasesStore,
       );
 
   @override
-  Future<List<String>> getPurchaseProducts() async {
+  Future<List<String>> getPurchasedProductsIds() async {
     final purchases = await _db.getAll(store: _purchasesStore);
-    return purchases.map((purchase) => purchase['purchasesId'] as String).toList();
+    return purchases.map((purchase) => purchase[_purchaseIdKey] as String).toList();
   }
 }

lib/data/serializers/collection_memos_serializer.dart

@@ -29,7 +29,8 @@ class CollectionMemosSerializer implements Serializer<CollectionMemos, Map<Strin
     final category = json[CollectionMemosKeys.category] as String;
     final isPremium = json[CollectionMemosKeys.isPremium] as bool?;
 
-    final productInfo = productInfoSerializer.from(json[CollectionMemosKeys.productInfo] as Map<String, dynamic>);
+    final rawProductInfo = json[CollectionMemosKeys.productInfo] as Map<String, dynamic>?;
+    final productInfo = rawProductInfo != null ? productInfoSerializer.from(rawProductInfo) : null;
 
     final tags = List<String>.from(json[CollectionMemosKeys.tags] as List);
 
@@ -62,6 +63,6 @@ class CollectionMemosSerializer implements Serializer<CollectionMemos, Map<Strin
         CollectionMemosKeys.memosMetadata: collection.memosMetadata.map(memoMetadataSerializer.to).toList(),
         CollectionMemosKeys.contributors: collection.contributors.map(contributorSerializer.to).toList(),
         CollectionMemosKeys.isPremium: collection.isPremium,
-        CollectionMemosKeys.productInfo: productInfoSerializer.to(collection.productInfo),
+        if (collection.isPremium) CollectionMemosKeys.productInfo: productInfoSerializer.to(collection.productInfo!),
       };
 }