LibraryViewModel, State & Combine Architecture
Sumber kode:
Source/Features/Library/ViewModel/LibraryViewModel.swiftSource/Features/Library/ViewModel/Extensions/ObserversLibrary.swiftFilterLibrary.swiftPaginationLibrary.swiftSelectionLibrary.swiftBulkActionLibrary.swift
1. Arsitektur State @Observable
LibraryViewModel mengadopsi kerangka kerja observasi modern Swift (@Observable) dan mengimplementasikan protocol ViewModelBase. ViewModel ini bertindak sebagai koordinator state terpusat untuk katalog kitab di kedua platform.
@Observable
final class LibraryViewModel: ViewModelBase {
// Singletons
let dataManager: LibraryDataManager = .shared
let historyManager: HistoryViewModel = .shared
// State Display
var displayedCategories: [CategoryData] = []
var rootCategories: [CategoryData] = []
var filterMode: LibraryFilterMode = .all
var viewMode: LibraryViewMode = .category // .category vs .author
var showOnlyDownloaded: Bool = false
var searchQuery: String = ""
// Multi-Selection & Bulk Operations
var selectedBookIds: Set<Int> = []
var isSelectionMode = false
var isBulkDownloading = false
var availableUpdateCount: Int = 0
// Lifecycle State
var state: ViewModelState = .loading
let reloadTask = Mutex<Task<Void, Never>?>(nil)
}
2. Event Streaming & Notifikasi Combine
Pengamatan mutasi sistem dikelola secara terpisah di ObserversLibrary.swift untuk menjaga prinsip Single Responsibility:
[ NotificationCenter / Background Events ]
│
├── .libraryFolderChanged ────────► Reload Library Task (Mutex Protected)
│
├── .bookIntegrated (iOS) ────────► Update Displayed Categories
│
├── .booksChanged ────────────────► Refresh Categories & Trigger Update Check
│
└── refreshSubject (Combine) ─────► Debounce 300ms ──► Apply Filter
A. Debounced Streams (refreshSubject)
Saat katalog mengalami mutasi beruntun (misalnya pengunduhan batch beberapa kitab sekaligus), event dipancarkan ke refreshSubject dan di-debounce selama 300 milidetik pada RunLoop.main sebelum memicu pembangunan ulang hierarki kategori:
refreshSubject
.debounce(for: .seconds(0.3), scheduler: RunLoop.main)
.sink { [weak self] in
MainActor.assumeIsolated { [weak self] in
guard let self else { return }
rootCategories = Array(dataManager.allRootCategories)
if viewMode == .author {
_authorHierarchy = dataManager.buildAuthorHierarchy()
}
applyFilter(filterMode)
}
}
.store(in: &cancellables)
B. Proteksi Konkurensi Reload Task (Mutex)
Saat pengguna mengubah folder direktori perpustakaan (.libraryFolderChanged), mutasi state dilindungi oleh Mutex<Task<Void, Never>?>:
reloadTask.withLock { currentTask in
if currentTask == nil {
currentTask = Task { [weak self] in
guard let self, !Task.isCancelled else { return }
await refreshLibrary()
reloadTask.withLock { $0 = nil }
}
}
}
3. Fitur View-Model Extensions
Fungsionalitas LibraryViewModel dibagi menjadi modul-modul extension:
FilterLibrary.swift: Menangani logika filter pencarian kitab (searchQuery), penyaringan kitab yang telah diunduh (showOnlyDownloaded), dan mode tampilan (.categoryvs.author). Pencarian teks memanfaatkan debounce task 300ms untuk membatalkan kueri lama saat pengguna masih mengetik.PaginationLibrary.swift: Mengatur lazy loading dan batching item pada mode daftar pengarang (Author Hierarchy) untuk mencegah beban memori berlebih pada ribuan data pengarang.SelectionLibrary.swift: Menyimpan dan memvalidasiSet<Int>ID buku yang dipilih pengguna untuk operasi multi-seleksi, serta mencatat buku terpilih ke basis data riwayat bacaan (historyManager.addBookToHistory(book.id)) secara instan agar tidak terjadi kehilangan riwayat saat navigasi cepat.BulkActionLibrary.swift: Mengoordinasikan penghapusan massal (bulk deletion), pengunduhan massal (bulk download), serta pembaruan katalog massal.