feat(feed): implement feed pagination

- Added cursor based pagination
- Implemented scroll listener
- Handled initial refresh

Author: fulleni

lib/headlines-feed/bloc/headlines_feed_event.dart

@@ -14,7 +14,16 @@ sealed class HeadlinesFeedEvent extends Equatable {
 /// {@template headlines_feed_fetch_requested}
 /// Event triggered when the headlines feed needs to be fetched.
 /// {@endtemplate}
-final class HeadlinesFeedFetchRequested extends HeadlinesFeedEvent {}
+final class HeadlinesFeedFetchRequested extends HeadlinesFeedEvent {
+  /// {@macro headlines_feed_fetch_requested}
+  const HeadlinesFeedFetchRequested({this.cursor});
+
+  /// The cursor for pagination.
+  final String? cursor;
+
+  @override
+  List<Object> get props => [cursor ?? ''];
+}
 
 /// {@template headlines_feed_refresh_requested}
 /// Event triggered when the headlines feed needs to be refreshed.

lib/headlines-feed/view/headlines_feed_page.dart

@@ -1,25 +1,41 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
+import 'package:ht_headlines_repository/ht_headlines_repository.dart';
 import 'package:ht_main/headlines-feed/bloc/headlines_feed_bloc.dart';
 import 'package:ht_main/headlines-feed/widgets/headline_item_widget.dart';
 import 'package:ht_main/shared/widgets/failure_state_widget.dart';
 import 'package:ht_main/shared/widgets/initial_state_widget.dart';
 import 'package:ht_main/shared/widgets/loading_state_widget.dart';
 
-class HeadlinesFeedPage extends StatefulWidget {
+class HeadlinesFeedPage extends StatelessWidget {
   const HeadlinesFeedPage({super.key});
 
   @override
-  State<HeadlinesFeedPage> createState() => _HeadlinesFeedPageState();
+  Widget build(BuildContext context) {
+    return BlocProvider(
+      create: (context) => HeadlinesFeedBloc(
+        headlinesRepository: context.read<HtHeadlinesRepository>(),
+      )..add(const HeadlinesFeedFetchRequested()),
+      child: const _HeadlinesFeedView(),
+    );
+  }
+}
+
+class _HeadlinesFeedView extends StatefulWidget {
+  const _HeadlinesFeedView();
+
+  @override
+  State<_HeadlinesFeedView> createState() => _HeadlinesFeedViewState();
 }
 
-class _HeadlinesFeedPageState extends State<HeadlinesFeedPage> {
+class _HeadlinesFeedViewState extends State<_HeadlinesFeedView> {
   final _scrollController = ScrollController();
 
   @override
   void initState() {
     super.initState();
     _scrollController.addListener(_onScroll);
+    context.read<HeadlinesFeedBloc>().add(HeadlinesFeedRefreshRequested());
   }
 
   @override
@@ -32,7 +48,12 @@ class _HeadlinesFeedPageState extends State<HeadlinesFeedPage> {
 
   void _onScroll() {
     if (_isBottom) {
-      context.read<HeadlinesFeedBloc>().add(HeadlinesFeedFetchRequested());
+      final state = context.read<HeadlinesFeedBloc>().state;
+      if (state is HeadlinesFeedLoaded) {
+        context
+            .read<HeadlinesFeedBloc>()
+            .add(HeadlinesFeedFetchRequested(cursor: state.cursor));
+      }
     }
   }
 

lib/headlines-feed/widgets/headline_item_widget.dart

@@ -18,7 +18,7 @@ class HeadlineItemWidget extends StatelessWidget {
         crossAxisAlignment: CrossAxisAlignment.start,
         children: [
           Text(
-            headline.title ?? 'No Title',
+            headline.title,
             style: Theme.of(context).textTheme.titleMedium,
           ),
           if (headline.description != null)

lib/shared/widgets/failure_state_widget.dart

@@ -5,9 +5,12 @@ class FailureStateWidget extends StatelessWidget {
   /// Creates a [FailureStateWidget].
   ///
   /// The [message] is the error message to display.
-  /// The [onRetry] is an optional callback to be called when the retry button is pressed.
+  /// 
+  /// The [onRetry] is an optional callback to be called 
+  /// when the retry button is pressed.
   const FailureStateWidget({
-    required this.message, super.key,
+    required this.message,
+    super.key,
     this.onRetry,
   });
 

pubspec.yaml

@@ -1,6 +1,6 @@
 name: ht_main
 description: main headlines toolkit mobile app.
-version: 0.7.5
+version: 0.8.5
 publish_to: none
 repository: https://github.com/headlines-toolkit/ht-main
 environment: