feat: Introduce DashboardRefreshService to manage dashboard refresh logic and update Nutrition and Workout dashboard cubits to utilize the new service

Author: albinson-arias

fitbodyrd_flutter/lib/features/nutrition/presentation/cubits/nutrition_dashboard_cubit.dart

@@ -1,12 +1,17 @@
 import 'package:fitbodyrd_client/fitbodyrd_client.dart';
 import 'package:fitbodyrd_flutter/features/nutrition/domain/repositories/nutrition_repository.dart';
 import 'package:fitbodyrd_flutter/features/nutrition/presentation/cubits/nutrition_dashboard_state.dart';
+import 'package:fitbodyrd_flutter/src/core/services/dashboard_refresh_service.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:record_result/record_result.dart';
 
 class NutritionDashboardCubit extends Cubit<NutritionDashboardState> {
-  NutritionDashboardCubit(this.repository) : super(NutritionDashboardInitial());
+  NutritionDashboardCubit(
+    this.repository,
+    this.refreshService,
+  ) : super(NutritionDashboardInitial());
   final NutritionRepository repository;
+  final DashboardRefreshService refreshService;
 
   Future<void> loadDashboard() async {
     emit(NutritionDashboardLoading());
@@ -201,6 +206,7 @@ class NutritionDashboardCubit extends Cubit<NutritionDashboardState> {
             consumedFat: consumed.fat,
           ),
         );
+        refreshService.refreshDashboard();
       }
     } else {
       final log = currentState.intakeLogs.firstWhere(
@@ -223,6 +229,7 @@ class NutritionDashboardCubit extends Cubit<NutritionDashboardState> {
               consumedFat: consumed.fat,
             ),
           );
+          refreshService.refreshDashboard();
         }
       }
     }

fitbodyrd_flutter/lib/features/workouts/presentation/cubits/workout_dashboard_cubit.dart

@@ -1,16 +1,20 @@
 import 'package:equatable/equatable.dart';
 import 'package:fitbodyrd_client/fitbodyrd_client.dart';
 import 'package:fitbodyrd_flutter/features/workouts/domain/repositories/workout_repository.dart';
+import 'package:fitbodyrd_flutter/src/core/services/dashboard_refresh_service.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:record_result/record_result.dart';
 
 part 'workout_dashboard_state.dart';
 
 class WorkoutDashboardCubit extends Cubit<WorkoutDashboardState> {
-  WorkoutDashboardCubit(this._repository)
-      : super(const WorkoutDashboardInitial());
+  WorkoutDashboardCubit(
+    this._repository,
+    this._refreshService,
+  ) : super(const WorkoutDashboardInitial());
 
   final WorkoutRepository _repository;
+  final DashboardRefreshService _refreshService;
 
   Future<void> loadDashboard() async {
     emit(const WorkoutDashboardLoading());
@@ -160,6 +164,7 @@ class WorkoutDashboardCubit extends Cubit<WorkoutDashboardState> {
         sessionJustCompleted: sessionJustCompleted,
       ),
     );
+    _refreshService.refreshDashboard();
   }
 
   Future<void> deleteLogForExercise(ExerciseLog log) async {
@@ -192,6 +197,7 @@ class WorkoutDashboardCubit extends Cubit<WorkoutDashboardState> {
     // In case of failure, the server will surface an AppException that
     // can be handled globally (e.g., via a snackbar interceptor).
     await _repository.deleteExerciseLog(log.id!);
+    _refreshService.refreshDashboard();
   }
 
   bool _isSessionFullyCompleted(

fitbodyrd_flutter/lib/src/core/injections/injection_container.dart

@@ -24,6 +24,7 @@ import 'package:fitbodyrd_flutter/features/workouts/presentation/cubits/workout_
 import 'package:fitbodyrd_flutter/features/workouts/presentation/cubits/workout_generation_cubit.dart';
 import 'package:fitbodyrd_flutter/src/core/env/app_env.dart';
 import 'package:fitbodyrd_flutter/src/core/routing/app_router.dart';
+import 'package:fitbodyrd_flutter/src/core/services/dashboard_refresh_service.dart';
 import 'package:fitbodyrd_flutter/src/core/services/device_id_service.dart';
 import 'package:fitbodyrd_flutter/src/core/services/preferences_helper.dart';
 import 'package:fitbodyrd_flutter/src/core/services/refresh_helper.dart';
@@ -62,6 +63,10 @@ Future<void> initCore() async {
       RefreshHelper.new,
       dispose: (param) => param.dispose(),
     )
+    ..registerLazySingleton(
+      DashboardRefreshService.new,
+      dispose: (param) => param.dispose(),
+    )
     ..registerLazySingleton(() => getRouter(sl()))
     ..registerLazySingleton<Client>(
       () => Client(
@@ -134,7 +139,10 @@ Future<void> initNutrition() async {
       () => NutritionGenerationCubit(nutritionRepository: sl()),
     )
     ..registerLazySingleton(
-      () => NutritionDashboardCubit(sl<NutritionRepository>()),
+      () => NutritionDashboardCubit(
+        sl<NutritionRepository>(),
+        sl<DashboardRefreshService>(),
+      ),
     );
 }
 
@@ -153,7 +161,10 @@ Future<void> initWorkouts() async {
       () => ExerciseDetailsCubit(sl<WorkoutRepository>()),
     )
     ..registerLazySingleton(
-      () => WorkoutDashboardCubit(sl<WorkoutRepository>()),
+      () => WorkoutDashboardCubit(
+        sl<WorkoutRepository>(),
+        sl<DashboardRefreshService>(),
+      ),
     );
 }
 

fitbodyrd_flutter/lib/src/core/services/dashboard_refresh_service.dart

@@ -0,0 +1,31 @@
+import 'dart:async';
+
+import 'package:fitbodyrd_flutter/features/home/presentation/cubits/home_dashboard_cubit.dart';
+import 'package:fitbodyrd_flutter/src/core/injections/injection_container.dart';
+
+class DashboardRefreshService {
+  Timer? _debounceTimer;
+  static const Duration _debounceDuration = Duration(milliseconds: 1000);
+
+  /// Triggers a debounced refresh of the home dashboard.
+  /// If a refresh is already pending,
+  /// it cancels the previous one and starts a new timer.
+  void refreshDashboard() {
+    // Cancel any existing timer
+    _debounceTimer?.cancel();
+
+    // Start a new debounce timer
+    _debounceTimer = Timer(_debounceDuration, () {
+      // Get the HomeDashboardCubit from service locator
+      // and refresh without showing loading
+
+      sl<HomeDashboardCubit>().loadDashboard(showLoading: false).ignore();
+    });
+  }
+
+  /// Disposes the service and cancels any pending timers.
+  void dispose() {
+    _debounceTimer?.cancel();
+    _debounceTimer = null;
+  }
+}