Feature remote config

analysis_options.yaml

@@ -1,6 +1,8 @@
 analyzer:
   errors:
     avoid_print: ignore
+    document_ignores: ignore
+    lines_longer_than_80_chars: ignore
 include: package:very_good_analysis/analysis_options.9.0.0.yaml
 linter:
   rules:

lib/app/bloc/app_bloc.dart

@@ -3,8 +3,8 @@ import 'dart:async';
 import 'package:bloc/bloc.dart';
 import 'package:equatable/equatable.dart';
 import 'package:ht_auth_repository/ht_auth_repository.dart';
-import 'package:ht_data_repository/ht_data_repository.dart';
 import 'package:ht_dashboard/app/config/config.dart' as local_config;
+import 'package:ht_data_repository/ht_data_repository.dart';
 import 'package:ht_shared/ht_shared.dart';
 
 part 'app_event.dart';
@@ -21,11 +21,7 @@ class AppBloc extends Bloc<AppEvent, AppState> {
        _appConfigRepository = appConfigRepository,
        _environment = environment,
        super(
-         const AppState(
-           user: null,
-           status: AppStatus.initial,
-           environment: null,
-         ),
+         const AppState(),
        ) {
     on<AppUserChanged>(_onAppUserChanged);
     on<AppLogoutRequested>(_onLogoutRequested);
@@ -56,7 +52,8 @@ class AppBloc extends Bloc<AppEvent, AppState> {
         status = AppStatus.authenticated;
       // ignore: no_default_cases
       default: // Fallback for any other roles not explicitly handled
-        status = AppStatus.unauthenticated; // Treat other roles as unauthenticated for dashboard
+        status = AppStatus
+            .unauthenticated; // Treat other roles as unauthenticated for dashboard
     }
 
     // Emit user and status update

lib/app/bloc/app_state.dart

@@ -48,8 +48,8 @@ class AppState extends Equatable {
 
   @override
   List<Object?> get props => [
-        status,
-        user,
-        environment,
-      ];
+    status,
+    user,
+    environment,
+  ];
 }

lib/app/view/app.dart

@@ -5,14 +5,13 @@ import 'package:flutter/material.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:go_router/go_router.dart';
 import 'package:ht_auth_repository/ht_auth_repository.dart';
-import 'package:ht_data_repository/ht_data_repository.dart';
-import 'package:ht_kv_storage_service/ht_kv_storage_service.dart';
 import 'package:ht_dashboard/app/bloc/app_bloc.dart';
 import 'package:ht_dashboard/app/config/app_environment.dart';
 import 'package:ht_dashboard/authentication/bloc/authentication_bloc.dart';
 import 'package:ht_dashboard/l10n/app_localizations.dart';
-import 'package:ht_dashboard/l10n/l10n.dart';
 import 'package:ht_dashboard/router/router.dart';
+import 'package:ht_data_repository/ht_data_repository.dart';
+import 'package:ht_kv_storage_service/ht_kv_storage_service.dart';
 import 'package:ht_shared/ht_shared.dart';
 
 class App extends StatelessWidget {
@@ -24,7 +23,7 @@ class App extends StatelessWidget {
     required HtDataRepository<Source> htSourcesRepository,
     required HtDataRepository<UserAppSettings> htUserAppSettingsRepository,
     required HtDataRepository<UserContentPreferences>
-        htUserContentPreferencesRepository,
+    htUserContentPreferencesRepository,
     required HtDataRepository<AppConfig> htAppConfigRepository,
     required HtKVStorageService kvStorageService,
     required AppEnvironment environment,
@@ -47,7 +46,7 @@ class App extends StatelessWidget {
   final HtDataRepository<Source> _htSourcesRepository;
   final HtDataRepository<UserAppSettings> _htUserAppSettingsRepository;
   final HtDataRepository<UserContentPreferences>
-      _htUserContentPreferencesRepository;
+  _htUserContentPreferencesRepository;
   final HtDataRepository<AppConfig> _htAppConfigRepository;
   final HtKVStorageService _kvStorageService;
   final AppEnvironment _environment;
@@ -71,8 +70,8 @@ class App extends StatelessWidget {
           BlocProvider(
             create: (context) => AppBloc(
               authenticationRepository: context.read<HtAuthRepository>(),
-              userAppSettingsRepository:
-                  context.read<HtDataRepository<UserAppSettings>>(),
+              userAppSettingsRepository: context
+                  .read<HtDataRepository<UserAppSettings>>(),
               appConfigRepository: context.read<HtDataRepository<AppConfig>>(),
               environment: _environment,
             ),

lib/app/view/app_shell.dart

@@ -2,7 +2,6 @@ import 'package:flutter/material.dart';
 import 'package:flutter_adaptive_scaffold/flutter_adaptive_scaffold.dart';
 import 'package:go_router/go_router.dart';
 import 'package:ht_dashboard/l10n/l10n.dart';
-import 'package:ht_dashboard/router/routes.dart';
 
 /// A responsive scaffold shell for the main application sections.
 ///

lib/app_configuration/bloc/app_configuration_bloc.dart

@@ -0,0 +1,99 @@
+import 'package:bloc/bloc.dart';
+import 'package:equatable/equatable.dart';
+import 'package:ht_data_repository/ht_data_repository.dart';
+import 'package:ht_shared/ht_shared.dart'; // Use AppConfig from ht_shared
+
+part 'app_configuration_event.dart';
+part 'app_configuration_state.dart';
+
+class AppConfigurationBloc
+    extends Bloc<AppConfigurationEvent, AppConfigurationState> {
+  AppConfigurationBloc({
+    required HtDataRepository<AppConfig> appConfigRepository,
+  }) : _appConfigRepository = appConfigRepository,
+       super(const AppConfigurationState()) {
+    on<AppConfigurationLoaded>(_onAppConfigurationLoaded);
+    on<AppConfigurationUpdated>(_onAppConfigurationUpdated);
+    on<AppConfigurationFieldChanged>(_onAppConfigurationFieldChanged);
+  }
+
+  final HtDataRepository<AppConfig> _appConfigRepository;
+
+  Future<void> _onAppConfigurationLoaded(
+    AppConfigurationLoaded event,
+    Emitter<AppConfigurationState> emit,
+  ) async {
+    emit(state.copyWith(status: AppConfigurationStatus.loading));
+    try {
+      final appConfig = await _appConfigRepository.read(id: 'app_config');
+      emit(
+        state.copyWith(
+          status: AppConfigurationStatus.success,
+          appConfig: appConfig,
+          isDirty: false,
+        ),
+      );
+    } on HtHttpException catch (e) {
+      emit(
+        state.copyWith(
+          status: AppConfigurationStatus.failure,
+          errorMessage: e.message,
+        ),
+      );
+    } catch (e) {
+      emit(
+        state.copyWith(
+          status: AppConfigurationStatus.failure,
+          errorMessage: 'An unknown error occurred: $e',
+        ),
+      );
+    }
+  }
+
+  Future<void> _onAppConfigurationUpdated(
+    AppConfigurationUpdated event,
+    Emitter<AppConfigurationState> emit,
+  ) async {
+    emit(state.copyWith(status: AppConfigurationStatus.loading));
+    try {
+      final updatedConfig = await _appConfigRepository.update(
+        id: event.appConfig.id,
+        item: event.appConfig,
+      );
+      emit(
+        state.copyWith(
+          status: AppConfigurationStatus.success,
+          appConfig: updatedConfig,
+          isDirty: false,
+        ),
+      );
+    } on HtHttpException catch (e) {
+      emit(
+        state.copyWith(
+          status: AppConfigurationStatus.failure,
+          errorMessage: e.message,
+        ),
+      );
+    } catch (e) {
+      emit(
+        state.copyWith(
+          status: AppConfigurationStatus.failure,
+          errorMessage: 'An unknown error occurred: $e',
+        ),
+      );
+    }
+  }
+
+  void _onAppConfigurationFieldChanged(
+    AppConfigurationFieldChanged event,
+    Emitter<AppConfigurationState> emit,
+  ) {
+    emit(
+      state.copyWith(
+        appConfig: event.appConfig,
+        isDirty: true,
+        clearErrorMessage: true, // Clear any previous error messages
+      ),
+    );
+  }
+}

lib/app_configuration/bloc/app_configuration_event.dart

@@ -0,0 +1,53 @@
+part of 'app_configuration_bloc.dart';
+
+/// Abstract base class for all events in the AppConfigurationBloc.
+abstract class AppConfigurationEvent extends Equatable {
+  /// {@macro app_configuration_event}
+  const AppConfigurationEvent();
+
+  @override
+  List<Object?> get props => [];
+}
+
+/// {@template app_configuration_loaded}
+/// Event to request the loading of the application configuration.
+/// {@endtemplate}
+class AppConfigurationLoaded extends AppConfigurationEvent {
+  /// {@macro app_configuration_loaded}
+  const AppConfigurationLoaded();
+}
+
+/// {@template app_configuration_updated}
+/// Event to request the update of the application configuration.
+///
+/// Carries the new [appConfig] object to be saved.
+/// {@endtemplate}
+class AppConfigurationUpdated extends AppConfigurationEvent {
+  /// {@macro app_configuration_updated}
+  const AppConfigurationUpdated(this.appConfig);
+
+  /// The updated application configuration.
+  final AppConfig appConfig;
+
+  @override
+  List<Object?> get props => [appConfig];
+}
+
+/// {@template app_configuration_field_changed}
+/// Event to notify that a field in the application configuration has changed.
+///
+/// This event is used to update the local state and mark it as dirty,
+/// without immediately triggering a backend save.
+/// {@endtemplate}
+class AppConfigurationFieldChanged extends AppConfigurationEvent {
+  /// {@macro app_configuration_field_changed}
+  const AppConfigurationFieldChanged({
+    this.appConfig,
+  });
+
+  /// The partially or fully updated AppConfig object.
+  final AppConfig? appConfig;
+
+  @override
+  List<Object?> get props => [appConfig];
+}

lib/app_configuration/bloc/app_configuration_state.dart

@@ -0,0 +1,67 @@
+part of 'app_configuration_bloc.dart';
+
+/// Represents the status of the AppConfigurationBloc.
+enum AppConfigurationStatus {
+  /// The configuration is in its initial state.
+  initial,
+
+  /// The configuration is currently being loaded.
+  loading,
+
+  /// The configuration has been successfully loaded or updated.
+  success,
+
+  /// An error occurred during loading or updating the configuration.
+  failure,
+}
+
+/// {@template app_configuration_state}
+/// State for the AppConfigurationBloc.
+/// {@endtemplate}
+class AppConfigurationState extends Equatable {
+  /// {@macro app_configuration_state}
+  const AppConfigurationState({
+    this.status = AppConfigurationStatus.initial,
+    this.appConfig,
+    this.errorMessage,
+    this.isDirty = false,
+  });
+
+  /// The current status of the application configuration.
+  final AppConfigurationStatus status;
+
+  /// The loaded or updated application configuration.
+  final AppConfig? appConfig;
+
+  /// An error message if an operation failed.
+  final String? errorMessage;
+
+  /// Indicates if there are unsaved changes to the configuration.
+  final bool isDirty;
+
+  /// Creates a copy of the current state with updated values.
+  AppConfigurationState copyWith({
+    AppConfigurationStatus? status,
+    AppConfig? appConfig,
+    String? errorMessage,
+    bool? isDirty,
+    bool clearErrorMessage = false,
+  }) {
+    return AppConfigurationState(
+      status: status ?? this.status,
+      appConfig: appConfig ?? this.appConfig,
+      errorMessage: clearErrorMessage
+          ? null
+          : errorMessage ?? this.errorMessage,
+      isDirty: isDirty ?? this.isDirty,
+    );
+  }
+
+  @override
+  List<Object?> get props => [
+    status,
+    appConfig,
+    errorMessage,
+    isDirty,
+  ];
+}