feat(reader): add bookmark and highlight model, service, state, and list sheet

Author: logan676

lib/features/reader/data/bookmark_service.dart

@@ -0,0 +1,59 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:readmigo/core/network/api_client.dart';
+import 'package:readmigo/models/bookmark.dart';
+
+final bookmarkServiceProvider = Provider<BookmarkService>((ref) {
+  return BookmarkService(apiClient: ref.watch(apiClientProvider));
+});
+
+class BookmarkService {
+  final ApiClient _apiClient;
+
+  BookmarkService({required ApiClient apiClient}) : _apiClient = apiClient;
+
+  Future<List<Bookmark>> getBookmarks(String bookId) async {
+    final response = await _apiClient.get('/books/$bookId/bookmarks');
+    final list = response.data is List
+        ? response.data as List
+        : (response.data as Map)['bookmarks'] as List? ?? [];
+    return list
+        .map((e) => Bookmark.fromJson(e as Map<String, dynamic>))
+        .toList();
+  }
+
+  Future<List<Bookmark>> getHighlights(String bookId) async {
+    final response = await _apiClient.get('/books/$bookId/highlights');
+    final list = response.data is List
+        ? response.data as List
+        : (response.data as Map)['highlights'] as List? ?? [];
+    return list
+        .map((e) => Bookmark.fromJson(e as Map<String, dynamic>))
+        .toList();
+  }
+
+  Future<Bookmark> createBookmark(
+    String bookId,
+    Map<String, dynamic> data,
+  ) async {
+    final response = await _apiClient.post(
+      '/bookmarks',
+      data: {'bookId': bookId, ...data},
+    );
+    return Bookmark.fromJson(response.data as Map<String, dynamic>);
+  }
+
+  Future<Bookmark> createHighlight(
+    String bookId,
+    Map<String, dynamic> data,
+  ) async {
+    final response = await _apiClient.post(
+      '/books/$bookId/highlights',
+      data: data,
+    );
+    return Bookmark.fromJson(response.data as Map<String, dynamic>);
+  }
+
+  Future<void> deleteBookmark(String bookmarkId) async {
+    await _apiClient.delete('/bookmarks/$bookmarkId');
+  }
+}

lib/features/reader/domain/bookmark_state.dart

@@ -0,0 +1,118 @@
+import 'package:flutter_riverpod/flutter_riverpod.dart';
+import 'package:readmigo/features/reader/data/bookmark_service.dart';
+import 'package:readmigo/models/bookmark.dart';
+
+class BookmarkState {
+  final List<Bookmark> bookmarks;
+  final List<Bookmark> highlights;
+  final bool isLoading;
+
+  const BookmarkState({
+    this.bookmarks = const [],
+    this.highlights = const [],
+    this.isLoading = false,
+  });
+
+  List<Bookmark> get all =>
+      [...bookmarks, ...highlights]
+        ..sort((a, b) => b.createdAt.compareTo(a.createdAt));
+
+  BookmarkState copyWith({
+    List<Bookmark>? bookmarks,
+    List<Bookmark>? highlights,
+    bool? isLoading,
+  }) {
+    return BookmarkState(
+      bookmarks: bookmarks ?? this.bookmarks,
+      highlights: highlights ?? this.highlights,
+      isLoading: isLoading ?? this.isLoading,
+    );
+  }
+}
+
+class BookmarkNotifier extends FamilyNotifier<BookmarkState, String> {
+  @override
+  BookmarkState build(String arg) => const BookmarkState();
+
+  String get bookId => arg;
+
+  BookmarkService get _service => ref.read(bookmarkServiceProvider);
+
+  Future<void> loadAll() async {
+    state = state.copyWith(isLoading: true);
+    try {
+      final results = await Future.wait([
+        _service.getBookmarks(bookId),
+        _service.getHighlights(bookId),
+      ]);
+      state = state.copyWith(
+        bookmarks: results[0],
+        highlights: results[1],
+        isLoading: false,
+      );
+    } catch (_) {
+      state = state.copyWith(isLoading: false);
+    }
+  }
+
+  Future<void> addBookmark({
+    required String chapterId,
+    int? paragraphIndex,
+  }) async {
+    try {
+      final bm = await _service.createBookmark(bookId, {
+        'chapterId': chapterId,
+        if (paragraphIndex != null) 'paragraphIndex': paragraphIndex,
+        'type': 'bookmark',
+      });
+      state = state.copyWith(bookmarks: [...state.bookmarks, bm]);
+    } catch (_) {
+      // Silently ignore errors
+    }
+  }
+
+  Future<void> addHighlight({
+    required String chapterId,
+    required int paragraphIndex,
+    required int charOffset,
+    required int charLength,
+    required String selectedText,
+    HighlightColor color = HighlightColor.yellow,
+    HighlightStyle style = HighlightStyle.background,
+    String? note,
+  }) async {
+    try {
+      final hl = await _service.createHighlight(bookId, {
+        'chapterId': chapterId,
+        'paragraphIndex': paragraphIndex,
+        'charOffset': charOffset,
+        'charLength': charLength,
+        'selectedText': selectedText,
+        'color': color.name,
+        'style': style.name,
+        'type': note != null ? 'annotation' : 'highlight',
+        if (note != null) 'note': note,
+      });
+      state = state.copyWith(highlights: [...state.highlights, hl]);
+    } catch (_) {
+      // Silently ignore errors
+    }
+  }
+
+  Future<void> deleteBookmark(String bookmarkId) async {
+    state = state.copyWith(
+      bookmarks: state.bookmarks.where((b) => b.id != bookmarkId).toList(),
+      highlights: state.highlights.where((b) => b.id != bookmarkId).toList(),
+    );
+    try {
+      await _service.deleteBookmark(bookmarkId);
+    } catch (_) {
+      await loadAll();
+    }
+  }
+}
+
+final bookmarkProvider =
+    NotifierProvider.family<BookmarkNotifier, BookmarkState, String>(
+  BookmarkNotifier.new,
+);