feat: implement account management feature

- Added account page and linking
- Implemented logout functionality
- Handle anonymous account linking

Author: fulleni

lib/account/bloc/account_bloc.dart

@@ -0,0 +1,52 @@
+import 'package:bloc/bloc.dart';
+import 'package:equatable/equatable.dart';
+import 'package:ht_authentication_repository/ht_authentication_repository.dart';
+
+part 'account_event.dart';
+part 'account_state.dart';
+
+/// {@template account_bloc}
+/// BLoC responsible for managing the state and logic for the Account feature.
+/// {@endtemplate}
+class AccountBloc extends Bloc<AccountEvent, AccountState> {
+  /// {@macro account_bloc}
+  AccountBloc({required HtAuthenticationRepository authenticationRepository})
+    : _authenticationRepository = authenticationRepository,
+      super(const AccountState()) {
+    on<AccountLogoutRequested>(_onLogoutRequested);
+    // Handlers for AccountSettingsNavigationRequested and
+    // AccountBackupNavigationRequested are typically handled in the UI layer
+    // (e.g., BlocListener navigating) or could emit specific states if needed.
+    // For now, we only need the logout logic here.
+  }
+
+  final HtAuthenticationRepository _authenticationRepository;
+
+  /// Handles the [AccountLogoutRequested] event.
+  ///
+  /// Attempts to sign out the user using the [HtAuthenticationRepository].
+  /// Emits [AccountStatus.loading] before the operation and updates to
+  /// [AccountStatus.success] or [AccountStatus.failure] based on the outcome.
+  Future<void> _onLogoutRequested(
+    AccountLogoutRequested event,
+    Emitter<AccountState> emit,
+  ) async {
+    emit(state.copyWith(status: AccountStatus.loading));
+    try {
+      await _authenticationRepository.signOut();
+      // No need to emit success here. The AppBloc listening to the
+      // repository's user stream will handle the global state change
+      // and trigger the necessary UI updates/redirects.
+      // We can emit an initial state again if needed for this BLoC's
+      // local state.
+      emit(state.copyWith(status: AccountStatus.initial));
+    } catch (e) {
+      emit(
+        state.copyWith(
+          status: AccountStatus.failure,
+          errorMessage: 'Logout failed: $e',
+        ),
+      );
+    }
+  }
+}

lib/account/bloc/account_event.dart

@@ -0,0 +1,24 @@
+part of 'account_bloc.dart';
+
+/// Base class for all events related to the Account feature.
+abstract class AccountEvent extends Equatable {
+  const AccountEvent();
+
+  @override
+  List<Object> get props => [];
+}
+
+/// Event triggered when the user requests to navigate to the settings page.
+class AccountSettingsNavigationRequested extends AccountEvent {
+  const AccountSettingsNavigationRequested();
+}
+
+/// Event triggered when the user requests to log out.
+class AccountLogoutRequested extends AccountEvent {
+  const AccountLogoutRequested();
+}
+
+/// Event triggered when the user (anonymous) requests to backup/link account.
+class AccountBackupNavigationRequested extends AccountEvent {
+  const AccountBackupNavigationRequested();
+}

lib/account/bloc/account_linking_bloc.dart

@@ -0,0 +1,64 @@
+import 'package:bloc/bloc.dart';
+import 'package:equatable/equatable.dart';
+import 'package:ht_authentication_repository/ht_authentication_repository.dart';
+
+part 'account_linking_event.dart';
+part 'account_linking_state.dart';
+
+/// {@template account_linking_bloc}
+/// BLoC responsible for handling the logic for linking an anonymous account
+/// to a permanent one (e.g., Google, Email Link).
+/// {@endtemplate}
+class AccountLinkingBloc
+    extends Bloc<AccountLinkingEvent, AccountLinkingState> {
+  /// {@macro account_linking_bloc}
+  AccountLinkingBloc({
+    required HtAuthenticationRepository authenticationRepository,
+  }) : _authenticationRepository = authenticationRepository,
+       super(const AccountLinkingState()) {
+    on<AccountLinkingGoogleSignInRequested>(_onGoogleSignInRequested);
+    on<AccountLinkingEmailLinkSignInRequested>(_onEmailLinkSignInRequested);
+  }
+
+  final HtAuthenticationRepository _authenticationRepository;
+
+  /// Handles the [AccountLinkingGoogleSignInRequested] event.
+  Future<void> _onGoogleSignInRequested(
+    AccountLinkingGoogleSignInRequested event,
+    Emitter<AccountLinkingState> emit,
+  ) async {
+    emit(state.copyWith(status: AccountLinkingStatus.loading));
+    try {
+      await _authenticationRepository.signInWithGoogle();
+      // Success is implicit via AppBloc observing the user stream change.
+      // Reset state locally or emit success if specific UI feedback needed.
+      emit(state.copyWith(status: AccountLinkingStatus.success));
+    } catch (e) {
+      emit(
+        state.copyWith(
+          status: AccountLinkingStatus.failure,
+          errorMessage: 'Google Sign-In failed: $e',
+        ),
+      );
+    }
+  }
+
+  /// Handles the [AccountLinkingEmailLinkSignInRequested] event.
+  Future<void> _onEmailLinkSignInRequested(
+    AccountLinkingEmailLinkSignInRequested event,
+    Emitter<AccountLinkingState> emit,
+  ) async {
+    emit(state.copyWith(status: AccountLinkingStatus.loading));
+    try {
+      await _authenticationRepository.sendSignInLinkToEmail(email: event.email);
+      emit(state.copyWith(status: AccountLinkingStatus.emailLinkSent));
+    } catch (e) {
+      emit(
+        state.copyWith(
+          status: AccountLinkingStatus.failure,
+          errorMessage: 'Failed to send email link: $e',
+        ),
+      );
+    }
+  }
+}

lib/account/bloc/account_linking_event.dart

@@ -0,0 +1,26 @@
+part of 'account_linking_bloc.dart';
+
+/// Base class for all events related to the Account Linking feature.
+abstract class AccountLinkingEvent extends Equatable {
+  const AccountLinkingEvent();
+
+  @override
+  List<Object> get props => [];
+}
+
+/// Event triggered when the user attempts to sign in/link with Google.
+class AccountLinkingGoogleSignInRequested extends AccountLinkingEvent {
+  const AccountLinkingGoogleSignInRequested();
+}
+
+/// Event triggered when the user attempts to sign in/link with Email Link.
+class AccountLinkingEmailLinkSignInRequested extends AccountLinkingEvent {
+  const AccountLinkingEmailLinkSignInRequested({required this.email});
+
+  final String email;
+
+  @override
+  List<Object> get props => [email];
+}
+
+// Add other events if different authentication methods are needed (e.g., Apple)

lib/account/bloc/account_linking_state.dart

@@ -0,0 +1,61 @@
+part of 'account_linking_bloc.dart'; // Renamed part of directive
+
+/// Enum representing the status of the Account Linking operations. // Updated doc
+enum AccountLinkingStatus {
+  // Renamed enum
+  /// Initial state, nothing has happened yet.
+  initial,
+
+  /// An authentication/linking operation is in progress.
+  loading,
+
+  /// An authentication/linking operation succeeded.
+  /// The global AppBloc state change will handle navigation.
+  success,
+
+  /// An authentication/linking operation failed.
+  failure,
+
+  /// Email link has been sent successfully (for email link flow).
+  emailLinkSent,
+}
+
+/// Represents the state of the Account Linking feature.
+class AccountLinkingState extends Equatable {
+  const AccountLinkingState({
+    this.status = AccountLinkingStatus.initial,
+    this.errorMessage,
+  });
+
+  /// The current status of the linking operations.
+  final AccountLinkingStatus status;
+
+  /// An optional error message if an operation failed.
+  final String? errorMessage;
+
+  /// Creates a copy of the current state with updated values.
+  AccountLinkingState copyWith({
+    // Renamed return type
+    AccountLinkingStatus? status,
+    String? errorMessage,
+    bool forceErrorMessage = false,
+  }) {
+    // Determine if the error message should be cleared.
+    // Clear it if the status is changing *unless* the new status is failure
+    // or the forceErrorMessage flag is true.
+    final shouldClearError =
+        status != null &&
+        status != this.status &&
+        status != AccountLinkingStatus.failure &&
+        !forceErrorMessage;
+
+    return AccountLinkingState(
+      status: status ?? this.status,
+      errorMessage:
+          shouldClearError ? null : (errorMessage ?? this.errorMessage),
+    );
+  }
+
+  @override
+  List<Object?> get props => [status, errorMessage];
+}

lib/account/bloc/account_state.dart

@@ -0,0 +1,26 @@
+part of 'account_bloc.dart';
+
+/// Enum representing the status of the Account feature.
+enum AccountStatus { initial, loading, success, failure }
+
+/// Represents the state of the Account feature.
+class AccountState extends Equatable {
+  const AccountState({this.status = AccountStatus.initial, this.errorMessage});
+
+  /// The current status of the account feature operations.
+  final AccountStatus status;
+
+  /// An optional error message if an operation failed.
+  final String? errorMessage;
+
+  /// Creates a copy of the current state with updated values.
+  AccountState copyWith({AccountStatus? status, String? errorMessage}) {
+    return AccountState(
+      status: status ?? this.status,
+      errorMessage: errorMessage ?? this.errorMessage,
+    );
+  }
+
+  @override
+  List<Object?> get props => [status, errorMessage];
+}