feat: Add rated category snaps to the Games tab

packages/app_center/lib/games/games_page.dart

@@ -39,8 +39,16 @@ class GamesPage extends ConsumerWidget {
             const SizedBox(height: kPagePadding),
           ],
         ),
-        const CategorySnapList(
-          category: SnapCategoryEnum.games,
+        const RatedCategorySnapList(
+          categories: [
+            SnapCategoryEnum.games,
+            SnapCategoryEnum.kdeGames,
+            SnapCategoryEnum.gnomeGames,
+            SnapCategoryEnum.gameLaunchers,
+            SnapCategoryEnum.gameEmulators,
+            SnapCategoryEnum.gameContentCreation,
+            SnapCategoryEnum.gameDev,
+          ],
         ),
         SliverList.list(
           children: [

packages/app_center/lib/games/games_page_featured.dart

@@ -22,7 +22,7 @@ class FeaturedCarousel extends ConsumerStatefulWidget {
 
 class _FeaturedCarouselState extends ConsumerState<FeaturedCarousel> {
   late YaruCarouselController controller;
-  late Iterable<Snap> snaps;
+  Iterable<Snap> snaps = [];
 
   @override
   Widget build(BuildContext context) {

packages/app_center/lib/ratings/rated_category_model.dart

@@ -0,0 +1,33 @@
+import 'package:app_center/ratings/ratings_service.dart';
+import 'package:app_center/snapd/snapd.dart';
+import 'package:riverpod_annotation/riverpod_annotation.dart';
+import 'package:snapd/snapd.dart';
+import 'package:ubuntu_service/ubuntu_service.dart';
+
+part 'rated_category_model.g.dart';
+
+@riverpod
+class RatedCategoryModel extends _$RatedCategoryModel {
+  late final _ratings = getService<RatingsService>();
+  late final _snapd = getService<SnapdService>();
+
+  @override
+  Future<List<Snap>> build(
+    List<SnapCategoryEnum> categories,
+    int numberOfSnaps,
+  ) async {
+    final snaps = <Snap>[];
+
+    for (final category in categories) {
+      final chart = await _ratings.getChart(category);
+      for (var i = 0; snaps.length < numberOfSnaps && i < chart.length; i++) {
+        final snap = await _snapd.findById(chart[i].rating.snapId);
+        if (snap != null && snap.screenshotUrls.isNotEmpty) {
+          snaps.add(snap);
+        }
+      }
+    }
+
+    return snaps;
+  }
+}

packages/app_center/lib/ratings/ratings_service.dart

@@ -1,8 +1,11 @@
 import 'dart:convert';
 import 'dart:io';
 
-import 'package:app_center_ratings_client/app_center_ratings_client.dart';
+import 'package:app_center/snapd/snap_category_enum.dart';
+import 'package:app_center_ratings_client/app_center_ratings_client.dart'
+    as ratings;
 import 'package:crypto/crypto.dart';
+import 'package:flutter/foundation.dart';
 import 'package:flutter/material.dart';
 import 'package:glib/glib.dart';
 import 'package:jwt_decode/jwt_decode.dart';
@@ -11,7 +14,7 @@ class RatingsService {
   RatingsService(this.client, {@visibleForTesting String? id})
       : _id = id ?? _generateId();
 
-  final RatingsClient client;
+  final ratings.RatingsClient client;
   String? _jwt;
   final String _id;
 
@@ -27,12 +30,21 @@ class RatingsService {
     }
   }
 
-  Future<Rating?> getRating(String snapId) async {
+  Future<ratings.Rating?> getRating(String snapId) async {
     await _ensureValidToken();
     return client.getRating(snapId, _jwt!);
   }
 
-  Future<void> vote(Vote vote) async {
+  Future<List<ratings.ChartData>> getChart(SnapCategoryEnum category) async {
+    await _ensureValidToken();
+    return client.getChart(
+      ratings.Timeframe.unspecified,
+      _jwt!,
+      category.toProto(),
+    );
+  }
+
+  Future<void> vote(ratings.Vote vote) async {
     await _ensureValidToken();
     await client.vote(vote.snapId, vote.snapRevision, vote.voteUp, _jwt!);
   }
@@ -42,13 +54,50 @@ class RatingsService {
     await client.delete(_jwt!);
   }
 
-  Future<List<Vote>> listMyVotes(String snapFilter) async {
+  Future<List<ratings.Vote>> listMyVotes(String snapFilter) async {
     await _ensureValidToken();
     return client.listMyVotes(snapFilter, _jwt!);
   }
 
-  Future<List<Vote>> getSnapVotes(String snapId) async {
+  Future<List<ratings.Vote>> getSnapVotes(String snapId) async {
     await _ensureValidToken();
     return client.getSnapVotes(snapId, _jwt!);
   }
 }
+
+extension CategoryToChartConversion on SnapCategoryEnum {
+  ratings.Category toProto() => switch (this) {
+        SnapCategoryEnum.artAndDesign => ratings.Category.ART_AND_DESIGN,
+        SnapCategoryEnum.booksAndReference =>
+          ratings.Category.BOOK_AND_REFERENCE,
+        SnapCategoryEnum.development => ratings.Category.DEVELOPMENT,
+        SnapCategoryEnum.devicesAndIot => ratings.Category.DEVICES_AND_IOT,
+        SnapCategoryEnum.education => ratings.Category.EDUCATION,
+        SnapCategoryEnum.entertainment => ratings.Category.ENTERTAINMENT,
+        SnapCategoryEnum.featured => ratings.Category.FEATURED,
+        SnapCategoryEnum.finance => ratings.Category.FINANCE,
+        SnapCategoryEnum.gameDev => ratings.Category.GAMES,
+        SnapCategoryEnum.gameEmulators => ratings.Category.GAMES,
+        SnapCategoryEnum.games => ratings.Category.GAMES,
+        SnapCategoryEnum.gnomeGames => ratings.Category.GAMES,
+        SnapCategoryEnum.kdeGames => ratings.Category.GAMES,
+        SnapCategoryEnum.gameLaunchers => ratings.Category.GAMES,
+        SnapCategoryEnum.gameContentCreation => ratings.Category.GAMES,
+        SnapCategoryEnum.healthAndFitness =>
+          ratings.Category.HEALTH_AND_FITNESS,
+        SnapCategoryEnum.musicAndAudio => ratings.Category.MUSIC_AND_AUDIO,
+        SnapCategoryEnum.newsAndWeather => ratings.Category.NEWS_AND_WEATHER,
+        SnapCategoryEnum.personalisation => ratings.Category.PERSONALISATION,
+        SnapCategoryEnum.photoAndVideo => ratings.Category.PHOTO_AND_VIDEO,
+        SnapCategoryEnum.productivity => ratings.Category.PRODUCTIVITY,
+        SnapCategoryEnum.science => ratings.Category.SCIENCE,
+        SnapCategoryEnum.security => ratings.Category.SECURITY,
+        SnapCategoryEnum.serverAndCloud => ratings.Category.SERVER_AND_CLOUD,
+        SnapCategoryEnum.social => ratings.Category.SOCIAL,
+        SnapCategoryEnum.utilities => ratings.Category.UTILITIES,
+        SnapCategoryEnum.unknown =>
+          throw ArgumentError('Category $this cannot be converted'),
+        SnapCategoryEnum.ubuntuDesktop =>
+          throw ArgumentError('Category $this cannot be converted'),
+      };
+}

packages/app_center/lib/snapd/snapd_service.dart

@@ -1,8 +1,23 @@
 import 'package:app_center/snapd/snapd_cache.dart';
 import 'package:app_center/snapd/snapd_watcher.dart';
+import 'package:collection/collection.dart';
 import 'package:snapd/snapd.dart';
 
 class SnapdService extends SnapdClient with SnapdCache, SnapdWatcher {
   Future<void> waitChange(String changeId) =>
       watchChange(changeId).firstWhere((change) => change.ready);
+
+  Future<Snap?> findById(String snapId) async {
+    final queryParams = {
+      'series': '16',
+      'remote': 'true',
+      'snap-id': snapId,
+    };
+    final result =
+        await getAssertions(assertion: 'snap-declaration', params: queryParams);
+    final declaration = SnapDeclaration.fromJson(result);
+    final findResult = await find(name: declaration.snapName);
+    return findResult
+        .singleWhereOrNull((element) => element.id == declaration.snapId);
+  }
 }

packages/app_center/lib/src/l10n/app_en.arb

@@ -118,7 +118,7 @@
     "developmentPageLabel": "Development",
     "gamesPageLabel": "Games",
     "gamesPageTitle": "What's Hot",
-    "gamesPageTop": "Top Games",
+    "gamesPageTop": "Top Rated",
     "gamesPageFeatured": "Featured Titles",
     "gamesPageBundles": "App Bundles",
     "unknownPublisher": "Unknown publisher",