feat(filters): add followed items filter

- Added checkbox for followed items
- Fetches and applies user preferences
- Disables manual filters when checked

Author: fulleni

lib/headlines-feed/view/headlines_filter_page.dart

@@ -4,12 +4,22 @@
 import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:go_router/go_router.dart';
+import 'package:ht_data_repository/ht_data_repository.dart'; // Added
+import 'package:ht_main/app/bloc/app_bloc.dart'; // Added
 import 'package:ht_main/headlines-feed/bloc/headlines_feed_bloc.dart';
 import 'package:ht_main/headlines-feed/models/headline_filter.dart';
 import 'package:ht_main/l10n/l10n.dart';
 import 'package:ht_main/router/routes.dart';
 import 'package:ht_main/shared/constants/constants.dart';
-import 'package:ht_shared/ht_shared.dart' show Category, Source, SourceType;
+import 'package:ht_shared/ht_shared.dart'
+    show
+        Category,
+        Source,
+        SourceType,
+        UserContentPreferences,
+        User,
+        HtHttpException, // Added
+        NotFoundException; // Added
 
 // Keys for passing data to/from SourceFilterPage
 const String keySelectedSources = 'selectedSources';
@@ -39,34 +49,129 @@ class _HeadlinesFilterPageState extends State<HeadlinesFilterPage> {
   /// and are only applied back to the BLoC when the user taps 'Apply'.
   late List<Category> _tempSelectedCategories;
   late List<Source> _tempSelectedSources;
-  // State for source filter capsules, to be passed to and from SourceFilterPage
   late Set<String> _tempSelectedSourceCountryIsoCodes;
   late Set<SourceType> _tempSelectedSourceSourceTypes;
 
+  // New state variables for the "Apply my followed items" feature
+  bool _useFollowedFilters = false;
+  bool _isLoadingFollowedFilters = false;
+  String? _loadFollowedFiltersError;
+  UserContentPreferences? _currentUserPreferences;
+
   @override
   void initState() {
     super.initState();
-    // Initialize the temporary selection state based on the currently
-    // active filters held within the HeadlinesFeedBloc. This ensures that
-    // when the filter page opens, it reflects the filters already applied.
-    final currentState = BlocProvider.of<HeadlinesFeedBloc>(context).state;
-    if (currentState is HeadlinesFeedLoaded) {
-      // Create copies of the lists to avoid modifying the BLoC state directly.
-      _tempSelectedCategories = List.from(currentState.filter.categories ?? []);
-      _tempSelectedSources = List.from(currentState.filter.sources ?? []);
-      // Initialize source capsule states from the BLoC's current filter
-      _tempSelectedSourceCountryIsoCodes = Set.from(
-        currentState.filter.selectedSourceCountryIsoCodes ?? {},
-      );
-      _tempSelectedSourceSourceTypes = Set.from(
-        currentState.filter.selectedSourceSourceTypes ?? {},
-      );
+    final headlinesFeedState =
+        BlocProvider.of<HeadlinesFeedBloc>(context).state;
+
+    bool initialUseFollowedFilters = false;
+
+    if (headlinesFeedState is HeadlinesFeedLoaded) {
+      final currentFilter = headlinesFeedState.filter;
+      _tempSelectedCategories = List.from(currentFilter.categories ?? []);
+      _tempSelectedSources = List.from(currentFilter.sources ?? []);
+      _tempSelectedSourceCountryIsoCodes =
+          Set.from(currentFilter.selectedSourceCountryIsoCodes ?? {});
+      _tempSelectedSourceSourceTypes =
+          Set.from(currentFilter.selectedSourceSourceTypes ?? {});
+
+      // Use the new flag from the filter to set the checkbox state
+      initialUseFollowedFilters = currentFilter.isFromFollowedItems;
     } else {
       _tempSelectedCategories = [];
       _tempSelectedSources = [];
       _tempSelectedSourceCountryIsoCodes = {};
       _tempSelectedSourceSourceTypes = {};
     }
+
+    _useFollowedFilters = initialUseFollowedFilters;
+    _isLoadingFollowedFilters = false;
+    _loadFollowedFiltersError = null;
+    _currentUserPreferences = null;
+
+    // If the checkbox should be initially checked, fetch the followed items
+    // to ensure the _temp lists are correctly populated with the *latest*
+    // followed items, and to correctly disable the manual filter tiles.
+    if (_useFollowedFilters) {
+      WidgetsBinding.instance.addPostFrameCallback((_) {
+        // Ensure context is available for l10n and BLoC access
+        if (mounted) {
+          _fetchAndApplyFollowedFilters();
+        }
+      });
+    }
+  }
+
+  Future<void> _fetchAndApplyFollowedFilters() async {
+    setState(() {
+      _isLoadingFollowedFilters = true;
+      _loadFollowedFiltersError = null;
+    });
+
+    final appState = context.read<AppBloc>().state;
+    final User? currentUser = appState.user;
+
+    if (currentUser == null) {
+      setState(() {
+        _isLoadingFollowedFilters = false;
+        _useFollowedFilters = false; // Uncheck the box
+        _loadFollowedFiltersError =
+            context.l10n.mustBeLoggedInToUseFeatureError;
+      });
+      return;
+    }
+
+    try {
+      final preferencesRepo =
+          context.read<HtDataRepository<UserContentPreferences>>();
+      final preferences = await preferencesRepo.read(
+        id: currentUser.id,
+        userId: currentUser.id,
+      ); // Assuming read by user ID
+
+      setState(() {
+        _currentUserPreferences = preferences;
+        _tempSelectedCategories = List.from(preferences.followedCategories);
+        _tempSelectedSources = List.from(preferences.followedSources);
+        // We don't auto-apply source country/type filters from user preferences here
+        // as the "Apply my followed" checkbox is primarily for categories/sources.
+        // If needed, this logic could be expanded.
+        _isLoadingFollowedFilters = false;
+      });
+    } on NotFoundException {
+      setState(() {
+        _currentUserPreferences =
+            UserContentPreferences(id: currentUser.id); // Empty prefs
+        _tempSelectedCategories = [];
+        _tempSelectedSources = [];
+        _isLoadingFollowedFilters = false;
+        // Optionally, inform user they have no followed items:
+        // _loadFollowedFiltersError = context.l10n.noFollowedItemsFound;
+      });
+    } on HtHttpException catch (e) {
+      setState(() {
+        _isLoadingFollowedFilters = false;
+        _useFollowedFilters = false; // Uncheck the box
+        _loadFollowedFiltersError =
+            e.message; // Or a generic "Failed to load"
+      });
+    } catch (e) {
+      setState(() {
+        _isLoadingFollowedFilters = false;
+        _useFollowedFilters = false; // Uncheck the box
+        _loadFollowedFiltersError = context.l10n.unknownError;
+      });
+    }
+  }
+
+  void _clearTemporaryFilters() {
+    setState(() {
+      _tempSelectedCategories = [];
+      _tempSelectedSources = [];
+      // Keep source country/type filters as they are not part of this quick filter
+      // _tempSelectedSourceCountryIsoCodes = {};
+      // _tempSelectedSourceSourceTypes = {};
+    });
   }
 
   /// Builds a [ListTile] representing a filter criterion (e.g., Categories).
@@ -88,6 +193,7 @@ class _HeadlinesFilterPageState extends State<HeadlinesFilterPage> {
     // For sources, currentSelection will be a Map
     required dynamic currentSelectionData,
     required void Function(dynamic)? onResult, // Result can also be a Map
+    bool enabled = true,
   }) {
     final l10n = context.l10n;
     final allLabel = l10n.headlinesFeedFilterAllLabel;
@@ -101,22 +207,25 @@ class _HeadlinesFilterPageState extends State<HeadlinesFilterPage> {
       title: Text(title),
       subtitle: Text(subtitle),
       trailing: const Icon(Icons.chevron_right),
-      onTap: () async {
-        final result = await context.pushNamed<dynamic>(
-          routeName,
-          extra: currentSelectionData, // Pass the map or list
-        );
-        if (result != null && onResult != null) {
-          onResult(result);
-        }
-      },
+      enabled: enabled, // Use the enabled parameter
+      onTap: enabled // Only allow tap if enabled
+          ? () async {
+              final result = await context.pushNamed<dynamic>(
+                routeName,
+                extra: currentSelectionData, // Pass the map or list
+              );
+              if (result != null && onResult != null) {
+                onResult(result);
+              }
+            }
+          : null,
     );
   }
 
-  @override
   @override
   Widget build(BuildContext context) {
     final l10n = context.l10n;
+    final theme = Theme.of(context);
 
     return Scaffold(
       appBar: AppBar(
@@ -127,35 +236,34 @@ class _HeadlinesFilterPageState extends State<HeadlinesFilterPage> {
         ),
         title: Text(l10n.headlinesFeedFilterTitle),
         actions: [
-          // Clear Button
           IconButton(
             icon: const Icon(Icons.clear_all),
             tooltip: l10n.headlinesFeedFilterResetButton,
             onPressed: () {
-              // Dispatch clear event immediately and pop
               context.read<HeadlinesFeedBloc>().add(
-                HeadlinesFeedFiltersCleared(),
-              );
+                    HeadlinesFeedFiltersCleared(),
+                  );
+              // Also reset local state for the checkbox
+              setState(() {
+                _useFollowedFilters = false;
+                _isLoadingFollowedFilters = false;
+                _loadFollowedFiltersError = null;
+                _clearTemporaryFilters();
+              });
               context.pop();
             },
           ),
-          // Apply Button
           IconButton(
             icon: const Icon(Icons.check),
             tooltip: l10n.headlinesFeedFilterApplyButton,
             onPressed: () {
-              // When the user confirms their filter choices on this page,
-              // create a new HeadlineFilter object using the final temporary
-              // selections gathered from the sub-pages.
               final newFilter = HeadlineFilter(
-                categories:
-                    _tempSelectedCategories.isNotEmpty
-                        ? _tempSelectedCategories
-                        : null,
-                sources:
-                    _tempSelectedSources.isNotEmpty
-                        ? _tempSelectedSources
-                        : null,
+                categories: _tempSelectedCategories.isNotEmpty
+                    ? _tempSelectedCategories
+                    : null,
+                sources: _tempSelectedSources.isNotEmpty
+                    ? _tempSelectedSources
+                    : null,
                 selectedSourceCountryIsoCodes:
                     _tempSelectedSourceCountryIsoCodes.isNotEmpty
                         ? _tempSelectedSourceCountryIsoCodes
@@ -164,24 +272,65 @@ class _HeadlinesFilterPageState extends State<HeadlinesFilterPage> {
                     _tempSelectedSourceSourceTypes.isNotEmpty
                         ? _tempSelectedSourceSourceTypes
                         : null,
+                isFromFollowedItems:
+                    _useFollowedFilters, // Set the new flag
               );
-
-              // Add an event to the main HeadlinesFeedBloc to apply the
-              // newly constructed filter and trigger a data refresh.
               context.read<HeadlinesFeedBloc>().add(
-                HeadlinesFeedFiltersApplied(filter: newFilter),
-              );
-              context.pop(); // Close the filter page
+                    HeadlinesFeedFiltersApplied(filter: newFilter),
+                  );
+              context.pop();
             },
           ),
         ],
       ),
       body: ListView(
         padding: const EdgeInsets.symmetric(vertical: AppSpacing.md),
         children: [
+          Padding(
+            padding: const EdgeInsets.symmetric(
+              horizontal: AppSpacing.paddingSmall, // Consistent with ListTiles
+            ),
+            child: CheckboxListTile(
+              title: Text(l10n.headlinesFeedFilterApplyFollowedLabel),
+              value: _useFollowedFilters,
+              onChanged: (bool? newValue) {
+                setState(() {
+                  _useFollowedFilters = newValue ?? false;
+                  if (_useFollowedFilters) {
+                    _fetchAndApplyFollowedFilters();
+                  } else {
+                    _isLoadingFollowedFilters = false;
+                    _loadFollowedFiltersError = null;
+                    _clearTemporaryFilters(); // Clear auto-applied filters
+                  }
+                });
+              },
+              secondary: _isLoadingFollowedFilters
+                  ? const SizedBox(
+                      width: 24,
+                      height: 24,
+                      child: CircularProgressIndicator(strokeWidth: 2),
+                    )
+                  : null,
+              controlAffinity: ListTileControlAffinity.leading,
+            ),
+          ),
+          if (_loadFollowedFiltersError != null)
+            Padding(
+              padding: const EdgeInsets.symmetric(
+                horizontal: AppSpacing.paddingLarge,
+                vertical: AppSpacing.sm,
+              ),
+              child: Text(
+                _loadFollowedFiltersError!,
+                style: TextStyle(color: theme.colorScheme.error),
+              ),
+            ),
+          const Divider(),
           _buildFilterTile(
             context: context,
             title: l10n.headlinesFeedFilterCategoryLabel,
+            enabled: !_useFollowedFilters && !_isLoadingFollowedFilters,
             selectedCount: _tempSelectedCategories.length,
             routeName: Routes.feedFilterCategoriesName,
             currentSelectionData: _tempSelectedCategories,
@@ -194,6 +343,7 @@ class _HeadlinesFilterPageState extends State<HeadlinesFilterPage> {
           _buildFilterTile(
             context: context,
             title: l10n.headlinesFeedFilterSourceLabel,
+            enabled: !_useFollowedFilters && !_isLoadingFollowedFilters,
             selectedCount: _tempSelectedSources.length,
             routeName: Routes.feedFilterSourcesName,
             currentSelectionData: {
@@ -214,7 +364,6 @@ class _HeadlinesFilterPageState extends State<HeadlinesFilterPage> {
               }
             },
           ),
-          // _buildFilterTile for eventCountries removed
         ],
       ),
     );