Refactor book status handling and improve notification service

- Introduced BookStatusExtension to encapsulate color and label logic for book statuses.
- Updated BookDetailBloc to use the new label method for error messages.
- Refactored BookStateWidget to utilize the new extension for color and label.
- Enhanced NotificationsServiceImpl to use named parameters for better readability.
- Modified PlayAlarmSoundService to make dispose method asynchronous.
- Cleaned up SnackbarService by removing unnecessary toString method.
- Updated BookcaseInsertionPage to support both create and edit modes with factory constructors.
- Improved route handling for BookcaseInsertionPage to differentiate between create and edit.
- Fixed various error handling and widget building issues across multiple files.
- Updated pubspec.yaml and pubspec.lock for dependency upgrades and version changes.

Author: EdoTXp

coverage/lcov.info

@@ -0,0 +1,22 @@
+import 'package:bookify/src/core/models/book_model.dart';
+import 'package:bookify/src/shared/theme/colors.dart';
+import 'package:flutter/material.dart';
+import 'package:localization/localization.dart';
+
+extension BookStatusExtension on BookStatus {
+  Color get color {
+    return switch (this) {
+      BookStatus.library => AppColor.bookifyBookLibraryColor,
+      BookStatus.reading => AppColor.bookifyBookReadingColor,
+      BookStatus.loaned => AppColor.bookifyBookLoanedColor,
+    };
+  }
+
+  String get label {
+    return switch (this) {
+      BookStatus.library => 'book-on-the-bookcase-label'.i18n(),
+      BookStatus.reading => 'book-on-reading-label'.i18n(),
+      BookStatus.loaned => 'book-on-loan-label'.i18n(),
+    };
+  }
+}

lib/src/core/helpers/book_status/book_status_extension.dart

@@ -62,7 +62,7 @@ class NotificationsServiceImpl implements NotificationsService {
     );
 
     await _notifications.initialize(
-      initializationSettings,
+      settings: initializationSettings,
       onDidReceiveNotificationResponse: _onTapOnNotification,
     );
     tz.initializeTimeZones();
@@ -113,14 +113,14 @@ class NotificationsServiceImpl implements NotificationsService {
     CustomNotificationModel notification,
   ) async {
     await _notifications.zonedSchedule(
-      notification.id,
-      notification.title,
-      notification.body,
-      tz.TZDateTime.from(
+      id: notification.id,
+      title: notification.title,
+      body: notification.body,
+      scheduledDate: tz.TZDateTime.from(
         notification.scheduledDate,
         tz.local,
       ),
-      _getNotificationDetails(
+      notificationDetails: _getNotificationDetails(
         notification.notificationChannel,
         notification.body,
       ),
@@ -144,14 +144,14 @@ class NotificationsServiceImpl implements NotificationsService {
     };
 
     await _notifications.zonedSchedule(
-      id,
-      title,
-      body,
-      tz.TZDateTime.from(
+      id: id,
+      title: title,
+      body: body,
+      scheduledDate: tz.TZDateTime.from(
         scheduledDate,
         tz.local,
       ),
-      _getNotificationDetails(
+      notificationDetails: _getNotificationDetails(
         notificationChannel,
         body,
       ),
@@ -162,7 +162,7 @@ class NotificationsServiceImpl implements NotificationsService {
 
   @override
   Future<void> cancelNotificationById({required int id}) async {
-    await _notifications.cancel(id);
+    await _notifications.cancel(id: id);
   }
 
   @override

lib/src/core/services/app_services/notifications_service/notifications_service_impl.dart

@@ -41,8 +41,8 @@ class PlayAlarmSoundService {
     await player.stop();
   }
 
-  void dispose() {
-    player.dispose();
+  Future<void> dispose() async {
+    await player.dispose();
   }
 
   Future<void> _playSound(double volume) async {

lib/src/core/services/app_services/play_alarm_sound_service/play_alarm_sound_service.dart

@@ -24,16 +24,6 @@ enum SnackBarType {
       SnackBarType.success => AppColor.bookifySuccessColor,
     };
   }
-
-  @override
-  String toString() {
-    return switch (this) {
-      SnackBarType.info => 'Informação',
-      SnackBarType.warning => 'Atenção',
-      SnackBarType.error => 'Erro',
-      SnackBarType.success => 'Sucesso',
-    };
-  }
 }
 
 class SnackbarService {

lib/src/core/services/app_services/snackbar_service/snackbar_service.dart

@@ -1,4 +1,5 @@
 import 'package:bookify/src/core/errors/local_database_exception/local_database_exception.dart';
+import 'package:bookify/src/core/helpers/book_status/book_status_extension.dart';
 import 'package:bookify/src/core/models/book_model.dart';
 import 'package:flutter_bloc/flutter_bloc.dart';
 
@@ -81,7 +82,7 @@ class BookDetailBloc extends Bloc<BookDetailEvent, BookDetailState> {
         emit(
           BookDetailErrorState(
             errorMessage:
-                'Impossível remover o livro porque está ${bookStatus.toString()}.',
+                'Impossível remover o livro porque está ${bookStatus.label}.',
           ),
         );
         return;

lib/src/features/book_detail/bloc/book_detail_bloc.dart

@@ -1,7 +1,6 @@
+import 'package:bookify/src/core/helpers/book_status/book_status_extension.dart';
 import 'package:bookify/src/core/models/book_model.dart';
-import 'package:bookify/src/shared/theme/colors.dart';
 import 'package:flutter/material.dart';
-import 'package:localization/localization.dart';
 
 class BookStateWidget extends StatelessWidget {
   final BookStatus bookStatus;
@@ -11,32 +10,16 @@ class BookStateWidget extends StatelessWidget {
     required this.bookStatus,
   });
 
-  Color _getColor() {
-    return switch (bookStatus) {
-      BookStatus.library => AppColor.bookifyBookLibraryColor,
-      BookStatus.reading => AppColor.bookifyBookReadingColor,
-      BookStatus.loaned => AppColor.bookifyBookLoanedColor,
-    };
-  }
-
-  String _getBookStatusToString() {
-    return switch (bookStatus) {
-      BookStatus.library => 'book-on-the-bookcase-label'.i18n(),
-      BookStatus.reading => 'book-on-reading-label'.i18n(),
-      BookStatus.loaned => 'book-on-loan-label'.i18n(),
-    };
-  }
-
   @override
   Widget build(BuildContext context) {
     return Container(
       padding: const EdgeInsets.all(8.0),
       decoration: BoxDecoration(
-        color: _getColor(),
+        color: bookStatus.color,
         borderRadius: BorderRadius.circular(22),
       ),
       child: Text(
-        _getBookStatusToString(),
+        bookStatus.label,
         textAlign: TextAlign.center,
         overflow: TextOverflow.ellipsis,
         textScaler: TextScaler.noScaling,

lib/src/features/book_on_bookcase_detail/views/widgets/book_state_widget.dart

@@ -152,13 +152,13 @@ class _BookcaseDetailPageState extends State<BookcaseDetailPage> {
 
   Future<void> _popupMenuOnSelected(String value, BuildContext context) async {
     if (value == _popupMenuItemsSet.first) {
-      var bookcaseList = await Navigator.pushNamed(
+      final result = await Navigator.pushNamed(
         context,
         BookcaseInsertionPage.routeName,
         arguments: _actualBookcase,
       ) as List<Object?>?;
 
-      final bookcaseUpdated = bookcaseList?[1] as BookcaseModel?;
+      final bookcaseUpdated = result?[1] as BookcaseModel?;
 
       if (bookcaseUpdated != null) {
         setState(() {

lib/src/features/bookcase_detail/views/bookcase_detail_page.dart

@@ -9,17 +9,58 @@ import 'package:flutter_bloc/flutter_bloc.dart';
 import 'package:localization/localization.dart';
 import 'package:validatorless/validatorless.dart';
 
+/// Page for creating or updating a [BookcaseModel].
+///
+/// This page provides a form to input bookcase details such as name, description,
+/// and color. It supports two modes:
+/// - **Create mode**: For adding a new bookcase (see [newBookcase])
+/// - **Edit mode**: For modifying an existing bookcase (see [updateBookcase])
+///
+/// The page returns a list containing:
+/// - `result[0]`: A boolean indicating success
+/// - `result[1]`: The updated or newly created [BookcaseModel]
 class BookcaseInsertionPage extends StatefulWidget {
   /// The Route Name = '/bookcase_insertion'
   static const routeName = '/bookcase_insertion';
 
+  /// The bookcase model to edit, or `null` if creating a new bookcase.
   final BookcaseModel? bookcaseModel;
 
-  const BookcaseInsertionPage({
+  /// Private constructor for internal use only.
+  ///
+  /// Use [newBookcase] or [updateBookcase] factory constructors instead.
+  const BookcaseInsertionPage._({
     super.key,
-    this.bookcaseModel,
+    required this.bookcaseModel,
   });
 
+  /// Creates a new bookcase insertion page in create mode.
+  ///
+  /// Returns a page where the user can create a new bookcase with an empty form.
+  factory BookcaseInsertionPage.newBookcase({Key? key}) {
+    return BookcaseInsertionPage._(
+      key: key,
+      bookcaseModel: null,
+    );
+  }
+
+  /// Creates a new bookcase insertion page in edit mode.
+  ///
+  /// The form will be pre-populated with the [bookcaseModel] data.
+  ///
+  /// Parameters:
+  ///   - [bookcaseModel]: The bookcase to edit (required)
+  ///   - [key]: Optional widget key
+  factory BookcaseInsertionPage.updateBookcase({
+    required BookcaseModel bookcaseModel,
+    Key? key,
+  }) {
+    return BookcaseInsertionPage._(
+      key: key,
+      bookcaseModel: bookcaseModel,
+    );
+  }
+
   @override
   State<BookcaseInsertionPage> createState() => _BookcaseInsertionPageState();
 }
@@ -54,6 +95,9 @@ class _BookcaseInsertionPageState extends State<BookcaseInsertionPage> {
     super.dispose();
   }
 
+  /// Clears all text fields and resets the color to white.
+  ///
+  /// This resets the form to its initial state, useful for the user to start over.
   void _clearAllTextField() {
     _formKey.currentState!.reset();
     _bookcaseNameEC.clear();
@@ -64,11 +108,23 @@ class _BookcaseInsertionPageState extends State<BookcaseInsertionPage> {
     });
   }
 
+  /// Validates the form and processes the bookcase insertion or update.
+  ///
+  /// In **create mode**: Emits an [InsertedBookcaseEvent] to add a new bookcase.
+  /// In **edit mode**: Emits an [UpdatedBookcaseEvent] to modify the existing bookcase.
+  ///
+  /// The [bookcaseUpdated] will be populated with the updated bookcase data in edit mode,
+  /// which is then passed back through the navigation result.
+  ///
+  /// Sets [_canPopPage] to `false` to indicate the form is being processed
+
   /// Checks whether all fields are valid,
   /// then enters the new or update bookcase.
-  void _onPressedButton(BookcaseModel? bookcaseModel) {
+  void _onPressedButton() {
     if (_formKey.currentState!.validate()) {
-      if (bookcaseModel == null) {
+      final isEditMode = widget.bookcaseModel != null;
+
+      if (!isEditMode) {
         _bloc.add(
           InsertedBookcaseEvent(
             name: _bookcaseNameEC.value.text,
@@ -79,6 +135,7 @@ class _BookcaseInsertionPageState extends State<BookcaseInsertionPage> {
           ),
         );
       } else {
+        final bookcaseModel = widget.bookcaseModel!;
         _bloc.add(
           UpdatedBookcaseEvent(
             id: bookcaseModel.id!,
@@ -274,7 +331,7 @@ class _BookcaseInsertionPageState extends State<BookcaseInsertionPage> {
                     BookifyOutlinedButton.expanded(
                       key: const Key('ConfirmBookcaseInsertionButton'),
                       text: 'confirm-button-normal'.i18n(),
-                      onPressed: () => _onPressedButton(bookcaseModel),
+                      onPressed: _onPressedButton,
                     ),
                   ],
                 ),

lib/src/features/bookcase_insertion/views/bookcase_insertion_page.dart

@@ -35,7 +35,7 @@ class UserCircleAvatar extends StatelessWidget {
           );
         },
         placeholder: (context, _) => const CenterCircularProgressIndicator(),
-        errorWidget: (_, __, ___) => Icon(
+        errorWidget: (_, _, _) => Icon(
           Icons.error_rounded,
           color: Theme.of(context).colorScheme.error,
         ),