From 9aa6c87b72eb1c280b9ea3d0d95d44082e0a9e14 Mon Sep 17 00:00:00 2001 From: Joseph Milazzo Date: Sun, 26 Sep 2021 10:33:35 -0700 Subject: [PATCH] v0.4.6 Release (#599) * v0.4.5 Release (#539) * Bump versions by dotnet-bump-version. * Versioning Fix & Improvement (#553) * Fix UpdaterService versioning (#544) * Add "Available" to newer, non-installed updates * Add if...else logic to Available/Installed badge * Change substring to account for bigger versions (#544) * Cache BuildInfo.version into local variable (#544) * Cache BuildInfo.Version.ToString() into local variable (#544) Co-authored-by: Yovarni Yearwood * Bump versions by dotnet-bump-version. * Incognito Reader (#560) * Hooked in incognito mode into the manga reader * Bump versions by dotnet-bump-version. * Reading Lists & More (#564) * Added continous reading to the book reader. Clicking on the max pages to right of progress bar will now go to last page. * Forgot a file for continous book reading * Fixed up some code regarding transitioning between chapters. Arrows now show to represent a chapter transition. * Laid the foundation for reading lists * All foundation is laid out. Actions are wired in the UI. Backend repository is setup. Redid the migration to have ReadingList track modification so we can order them for the user. * Updated add modal to have basic skeleton * Hooked up ability to fetch reading lists from backend * Made a huge performance improvement to GetChapterIdsForSeriesAsync() by reducing a JOIN and an iteration loop. Improvement went from 2 seconds -> 200 ms. * Implemented the ability to add all chapters in a series to a reading list. * Fixed issue with adding new items to reading list not being in a logical order. Lots of work on getting all the information around the reading list view. Added some foreign keys back to chapter so delete should clean up after itself. * Added ability to open directly the series * Reading List Items now have progress attached * Hooked up list deletion and added a case where if doesn't exist on load, then redirect to library. * Lots of changes. Introduced a dashboard component for the main app. This will sit on libraries route for now and will have 3 tabs to show different sections. Moved libraries reel down to bottom as people are more likely to access recently added or in progress than explore their whole library. Note: Bundles are messed up, they need to be reoptimized and routes need to be updated. * Added pagination to the reading lists api and implemented a page to show all lists * Cleaned up old code from all-collections component so now it only handles all collections and doesn't have the old code for an individual collection * Hooked in actions and navigation on reading lists * When the user re-arranges items, they are now persisted * Implemented remove read, but performance is pretty poor. Needs to be optimized. * Lots of API fixes for adding items to a series, returning items, etc. Committing before fixing incorrect fetches of items for a readingListId. * Rewrote the joins for GetReadingListItemDtosByIdAsync() to not return extra records. * Remove bug marker now that it is fixed * Refactor update-by-series to move more of the code to a re-usable function for update-by-volume/chapter APIs * Implemented the ability to add via series, volume or chapter. * Added OPDS support for reading lists. This included adding VolumeId to the ReadingListDto. * Fixed a bug with deleting items * After we create a library inform user that a scan has started * Added some extra help information for users on directory picker, since linux users were getting confused. * Setup for the reading functionality * Fixed an issue where opening the edit series modal and pressing save without doing anything would empty collection tags. Would happen often when editing cover images. * Fixed get-next-chapter for reading list. Refactored all methods to use the new GetUserIdByUsernameAsync(), which is much faster and uses less memory. * Hooked in prev chapter for continuous reading with reading list * Hooked up the read code for manga reader and book reader to have list id passed * Manga reader now functions completely with reading lists * Implemented reading list and incognito mode into book reader * Refactored some common reading code into reader service * Added support for "Series - - Vol. 03 Ch. 023.5 - Volume 3 Extras.cbz" format that can occur with FMD2. * Implemented continuous reading with a reading list between different readers. This incurs a 3x performance hit on the book info api. * style changes. Don't emit an event if position of draggable item hasn't changed * Styling and added the edit reading list flow. * Cleaned up some extra spaces when actionables isn't shown. Lots of cleanup for promoted lists. * Refactored some filter code to a common service * Added an RBS check in getting Items for a given user. * Code smells * More smells * Bump versions by dotnet-bump-version. * Cleanup bookmarks and Reading List Items (#567) * Removed directives, ensured we delete bookmarks and reading list items when chapters are deleted. * Added parsing support for "Kimi no Koto ga Daidaidaidaidaisuki na 100-nin no Kanojo Chapter 11-10" * Bump versions by dotnet-bump-version. * Performance Improvements (#568) * Refactored the performance of GetChapter/BookInfo API to have a 10x speed improvement and to use common code, rather than duplicating code. Removed an api param that is no longer needed. * Book reader now has dedicated buttons to jump to next/prev chapter as well as through page buttons * Bump versions by dotnet-bump-version. * Fixed an issue from perf tuning where I forgot to send Pages to frontend, breaking reader. (#569) * Bump versions by dotnet-bump-version. * Fixed scaling issue (#573) * Bump versions by dotnet-bump-version. * Continuous Reading for Webtoons & I Just Couldn't Stop Coding (#574) * Fixed an issue from perf tuning where I forgot to send Pages to frontend, breaking reader. * Built out continuous reading for webtoon reader. Still has some issues with triggering. * Refactored GetUserByUsernameAsync to have a new flavor and allow the caller to pass in bitwise flags for what to include. This has a get by username or id variant. Code is much cleaner and snappier as we avoid many extra joins when not needed. * Cleanup old code from UserRepository.cs * Refactored OPDS to use faster API lookups for User * Refactored more code to be cleaner and faster. * Refactored GetNext/Prev ChapterIds to ReaderService. * Refactored Repository methods to their correct entity repos. * Refactored DTOs and overall cleanup of the code. * Added ability to press 'b' to bookmark a page * On hitting last page, save progress forcing last page to be read. Adjusted logic for the top and bottom spacers for triggering next/prev chapter load * When at top or moving between chapters, scrolling down then up will now trigger page load. Show a toastr to inform the user of a change in chapter (it can be really fast to switch) * Cleaned up scroll code * Fixed an issue where loading a chapter with last page bookmarked, we'd load lastpage - 1 * Fixed last page of webtoon reader not being resumed on loading said chapter due to a difference in how max page is handled between infinite scroller and manga reader. * Removed some comments * Book reader shouldn't look at left/right tap to paginate elems for position bookmarking. Missed a few areas for saving while in incognito mode * Added a benchmark to test out a sort code * Updated the read status on reading list to use same style as other places * Refactored GetNextChapterId to bring the average response time from 1.2 seconds to 400ms. * Added a filter to add to list when there are more than 5 reading lists * Added download reading list (will be removed, just saving for later). Fixes around styling on reading lists * Removed ability to download reading lists * Tweaked the logic for infinite scroller to be much smoother loading next/prev chapter. Added a bug marker for a concurrency bug. * Updated the top spacer so that when you hit the top, you stay at the page height and can now just scroll up. * Got the logic for scrolling up. Now just need the CSS then cont infinite scroller will be working * More polishing on infinite scroller * Removed IsSpecial on volumeDto, which is not used anywhere. * Cont Reading inf scroller edition is done. * Code smells and fixed package.json explore script * Bump versions by dotnet-bump-version. * Bump versions by dotnet-bump-version. * Bugfix/scanner issue (#576) * Refactored the scanner to hopefully fix a hard to reproduce KeyNotFoundException from GetInfosByName. * Added parsing support for "A Compendium of Ghosts - 031 - The Third Story_ Part 12 (Digital) (Cobalt001)" * Bump versions by dotnet-bump-version. * Bugs, Enhancements, and Performance (#580) * Added parser case for "The Duke of Death and His Black Maid - Ch. 177 - The Ball (3).cbz" * Removed a file that is created and modified every test run. * Fixed a bad parser case for "Batman Beyond 02 (of 6) (1999)" which was consuming too many characters * Removed a lot of "Volume" parsing for Comics that don't make sense. This is prep work for the upcoming Comic Rework release. * Reworked a lot of parsing cases for comics based on naming conventions observed from releases found online. * Added a way for external scripts to use a user api key to authenticate * Fixed an issue if the manga only had one page, the bottom menu would be missing page and chapter controls. * Fixed a bug where on small phones, nav bar could overflow due to scroll to top * Tweaked a lot of regex for manga parsing to handle some cases where poorly named files, like "Vol. 03 Ch. 21" would end up parsing as Series "Vol. 03". * Even more handling of parser cases. Manga parser should be as it was but more robust to handle bad naming. * Fixed: Don't force metadata refresh on Scan Series, only on refresh metadata * Implemented the ability to automatically refresh after a series scan based on when server finishes. Remove a duplicate API call from series detail. * Removed another API call for series metadata that isn't needed. * Refactored Message creation to a factory, hardcoded strings are centralized, and RefreshSeriesMetadata sends an event and is refactored to be async. * Fixed a bug when really poorly named files are within a folder that contains the series name, fallback couldn't occur due to it being taken as root folder. Now we detect said condition and will go one level higher, resulting in potentially more I/O, but the series will not be deleted. * Added the Read in Incognito context item for Chapter cards * Skip an additional check for series summary for series that aren't EPUB or Archive formats. * Fixed an issue where cover image generation could occur due to a bad check on LastWriteTime on the underlying file. * Added some extra comic parser tests * Added a ScanLibrary event (not hooked up in UI) * Performance improvement on metadata service. Now when we scan for cover image changes, we emit when a change occurs and only then do we update parent entities (array copy). * Removed an hr from series detail and ensure we update the cover image for series when scan series finishes. * Updated the infinite scroller to use a Flags pattern for the debug mode. Updated a few logical conditions for mobile. * Removed the concurrency check on row progress as if too many calls hit the DB, it will throw, but it doesn't matter. Fixed a bad logic code which could cause scrolling after hitting the bottom of the chapter. * Ensure prefetching uses totalPages + 1 since we pass in totalPages as - 1 from manga reader * Fixed issue where last page of webtoon wouldn't be prefetched due to a < instead of <= on prefetching code * Implemented ability to send images from archives to the UI without incurring any extra memory pressure. * Dropdown menus now have a darker background * Webtoon reader now works on mobile. * Fixed how keyboard presses for up/down/left/right work with MANGA_UD reading mode. See issue #579 * Fixed cont reader for webtoons on mobile * Fixed a small issue where top spacer would too quickly switch to prev chapter * Updated user preferences to use same slider style. Removed some css that is not used. * Added comic parser case for "Saga 001 (2012) (Digital) (Empire-Zone)" * Added accessibility toggle to reading list order and aligned sliders to all use the same style. * Removed a todo for checking on new image serving code. It works great. * Fixed a missing await * Auth guard will now check if an existing toast is present giving same message before poping the toast. * Fixed alignment on phones for reading lists * Moved sorters so they aren't resused between multiple threads. Slightly higher memory footprint. * Fixed a broken unit test * Code smells * More unit test fixing * Bump versions by dotnet-bump-version. * WebP Support (#581) * Added trackby so when series scan event comes through, cards can update too * Added chapter boundary toasts on book reader * Handle closing the reader when in a reading list * Somehow the trackby save didn't happen * Fixed an issue where after opening a chapter info modal, then trying to open another in specials tab it would fail due to a pass by reference issue with our factory. * When a series update occurs, if we loose specials tab, but we were on it, reselect volumes/chapters tab * Fixed an issue where older releases would show as available, even though they were already installed. * Converted tabs within modals to use vertical orientation (except on mobile) * Implemented webp support. Only Safari does not support this format natively. MacOS users can use an alternative browser. * Refactored ScannerService and MetadataService to be fully async * Bump versions by dotnet-bump-version. * Bugfix/manga reader (#582) * Fixed an issue where you could change paging direction then switch to Up/Down mode and paging direction would still be present * Removed some code for a feature I'm not implementing anymore * Bump versions by dotnet-bump-version. * High Res images breaking due to Canvas limits (#587) * Fixed an issue where on Safari with high resolution images, the canvas wouldn't be able to render them. Now we detect high res that might break canvas on different browsers and scale them. * Removed some code no longer needed * Bump versions by dotnet-bump-version. * Foundational Cover Image Rework (#584) * Updating wording on card item when total pages is 0, to be just "Cannot Read" since it could be a non-archive file * Refactored cover images to be stored on disk. This first commit has the extraction to disk and the metadata service to handle updating when applicable. * Refactored code to have the actual save to cover image directory done by ImageService. * Implemented the ability to override cover images. * Some cleanup on Image service * Implemented the ability to cleanup old covers nightly * Added a migration to migrate existing covers to new cover image format (files). * Refactored all CoverImages to just be the filename, leaving the Join with Cover directory to higher level code. * Ensure when getting user progress, we pick the first. * Added cleanup cover images for deleted tags. Don't pull any cover images that are blank. * After series update, clear out cover image. No change on UI, but just keeps things clear before metadata refresh hits * Refactored image formats for covers to ImageService. * Fixed an issue where after refactoring how images were stored, the cleanup service was deleting them after each scan. * Changed how ShouldUpdateCoverImage works to check if file exists or not even if cover image is locked. * Fixed unit tests * Added caching back to cover images. * Caching on series as well * Code Cleanup items * Ensure when checking if a file exists in MetadataService, that we join for cover image directory. After we scan library, do one last filter to delete any series that have 0 pages total. * Catch exceptions so we don't run cover migration if this is first time run. * After a scan, only clear out the cache directory and not do a deep clean. * Implemented the ability to backup custom locked covers only. * Fixed unit tests * Trying to figure out why GA crashes when running MetadataServiceTests.cs * Some debugging on GA tests not running * Commented out tests that were causing issues in GA. * Fixed an issue where series cover images wouldn't migrate * Fixed the updating of links to actually do all series and not just locked * Bump versions by dotnet-bump-version. * Feature/image rework cleanup (#589) * Added volume migrations. Added parser case for "Chapter 63 - The Promise Made for 520 Cenz.cbr" * Added some info statements for when full library scans occur. For image apis, return the name of the file to aid in caching. * When managing users, show the current logged in user at the top of the list. Added a message when no libraries have been setup but you are trying to add a user to a library. * Bump versions by dotnet-bump-version. * Additional Memory Pressure Enhancements (#590) * Added volume migrations. Added parser case for "Chapter 63 - The Promise Made for 520 Cenz.cbr" * Added some info statements for when full library scans occur. For image apis, return the name of the file to aid in caching. * When managing users, show the current logged in user at the top of the list. Added a message when no libraries have been setup but you are trying to add a user to a library. * Removed an extra stream operation from SharpCompress cover image work. Removed an extra ToArray() from Book Reader for extracting PDF pages. * Removed the left over comment * Added parsing case for "Batman Beyond 04 (of 6) (1999)" * Removed dead code * Bump versions by dotnet-bump-version. * Added ios detection (#591) https://stackoverflow.com/questions/9038625/detect-if-device-is-ios/9039885#9039885 *Note* navigator.platform is deprecated but still seems to work for now. * Bump versions by dotnet-bump-version. * Added entry for persistent covers folder * Bump versions by dotnet-bump-version. * Bulk Operations (#596) * Implemented the ability to perform multi-selections on cards. Basic selection code is done, CSS needed and exposing actions. * Implemented a bulk selection bar. Added logic to the card on when to force show checkboxes. * Fixed some bad parsing groups and cases for Comic Chapters. * Hooked up some bulk actions on series detail page. Not hooked up to backend yet. * Fixes #593. URI Enocde library names as sometimes they can have & in them. * Implemented the ability to mark volume/chapters as read/unread. * Hooked up mark as unread with specials as well. * Add to reading list hooked up for Series Detail * Implemented ability to add multiple series to a reading list. * Implemented bulk selection for series cards * Added comments to the new code in ReaderService.cs * Implemented proper styling on bulk operation bar and integrated for collections. * Fixed an issue with shift clicking * Cleaned up css of bulk operations bar * Code cleanup * Bump versions by dotnet-bump-version. * Feature/release cleanup (#597) * Deselect all after bulk operations complete. * Implemented a way to trigger selection code on mobile. * When selection mode is active, make the clickable area the whole image. * Series detail shouldn't use gutters for card layout as it can cause skewing on mobile * Long press on card items to trigger the selection on mobile * Code cleanup * One more * Misread the code issue * Bump versions by dotnet-bump-version. * v0.4.6 Release (#598) * Bump versions by dotnet-bump-version. * Bump versions by dotnet-bump-version. Co-authored-by: Yovarni Yearwood Co-authored-by: Yovarni Yearwood Co-authored-by: Robbie Davis Co-authored-by: Chris Plaatjes --- .gitignore | 1 + API.Benchmark/ArchiveSerivceBenchmark.cs | 8 + API.Benchmark/ParseScannedFilesBenchmarks.cs | 31 +- API.Benchmark/Program.cs | 1 + API.Benchmark/TestBenchmark.cs | 69 ++ API.Tests/API.Tests.csproj | 4 + .../Extensions/Test Data/modified on run.txt | 3 - API.Tests/Parser/ComicParserTests.cs | 60 +- API.Tests/Parser/MangaParserTests.cs | 30 +- API.Tests/Parser/ParserTest.cs | 1 + API.Tests/Services/ArchiveServiceTests.cs | 67 +- API.Tests/Services/DirectoryServiceTests.cs | 10 + API.Tests/Services/MetadataServiceTests.cs | 53 +- API.Tests/Services/ScannerServiceTests.cs | 8 +- .../Test Data/ImageService/cover.expected.jpg | Bin 0 -> 473476 bytes API/API.csproj | 56 +- API/API.csproj.DotSettings | 2 + API/Comparators/ChapterSortComparer.cs | 9 + API/Comparators/NaturalSortComparer.cs | 17 +- API/Controllers/AccountController.cs | 1 + API/Controllers/BookController.cs | 32 +- API/Controllers/CollectionController.cs | 2 +- API/Controllers/DownloadController.cs | 9 +- API/Controllers/ImageController.cs | 44 +- API/Controllers/LibraryController.cs | 6 +- API/Controllers/OPDSController.cs | 154 ++- API/Controllers/PluginController.cs | 45 + API/Controllers/ReaderController.cs | 395 +++---- API/Controllers/ReadingListController.cs | 503 ++++++++ API/Controllers/SeriesController.cs | 47 +- API/Controllers/SettingsController.cs | 2 +- API/Controllers/UploadController.cs | 30 +- API/Controllers/UsersController.cs | 12 +- API/DTOs/{ => Account}/LoginDto.cs | 0 API/DTOs/{ => Account}/ResetPasswordDto.cs | 4 +- API/DTOs/Downloads/DownloadBookmarkDto.cs | 1 + API/DTOs/ImageDto.cs | 15 - API/DTOs/InProgressChapterDto.cs | 24 - API/DTOs/Reader/BookInfoDto.cs | 18 + API/DTOs/{ => Reader}/BookmarkDto.cs | 2 +- API/DTOs/Reader/ChapterInfoDto.cs | 15 +- API/DTOs/Reader/IChapterInfoDto.cs | 19 + .../Reader/MarkMultipleSeriesAsReadDto.cs | 9 + API/DTOs/{ => Reader}/MarkReadDto.cs | 4 +- API/DTOs/{ => Reader}/MarkVolumeReadDto.cs | 4 +- API/DTOs/Reader/MarkVolumesReadDto.cs | 20 + .../RemoveBookmarkForSeriesDto.cs | 2 +- API/DTOs/ReadingLists/CreateReadingListDto.cs | 7 + API/DTOs/ReadingLists/ReadingListDto.cs | 13 + API/DTOs/ReadingLists/ReadingListItemDto.cs | 25 + .../UpdateReadingListByChapterDto.cs | 9 + .../UpdateReadingListByMultipleDto.cs | 12 + .../UpdateReadingListByMultipleSeriesDto.cs | 10 + .../UpdateReadingListBySeriesDto.cs | 8 + .../UpdateReadingListByVolumeDto.cs | 9 + API/DTOs/ReadingLists/UpdateReadingListDto.cs | 10 + .../ReadingLists/UpdateReadingListPosition.cs | 10 + API/DTOs/{ => Settings}/ServerSettingDTO.cs | 0 API/DTOs/VolumeDto.cs | 4 +- API/Data/BookmarkRepository.cs | 7 - API/Data/ChapterRepository.cs | 23 - API/Data/DataContext.cs | 3 + API/Data/MigrateCoverImages.cs | 180 +++ .../20210901150310_ReadingLists.Designer.cs | 1018 ++++++++++++++++ .../Migrations/20210901150310_ReadingLists.cs | 84 ++ ...01200442_ReadingListsAdditions.Designer.cs | 1022 ++++++++++++++++ .../20210901200442_ReadingListsAdditions.cs | 55 + ...eadingListsExtraRealationships.Designer.cs | 1050 +++++++++++++++++ ...2110705_ReadingListsExtraRealationships.cs | 67 ++ ...0906140845_ReadingListsChanges.Designer.cs | 1046 ++++++++++++++++ .../20210906140845_ReadingListsChanges.cs | 43 + ...0916142418_EntityImageRefactor.Designer.cs | 1042 ++++++++++++++++ .../20210916142418_EntityImageRefactor.cs | 97 ++ .../Migrations/DataContextModelSnapshot.cs | 138 ++- .../AppUserProgressRepository.cs | 33 +- API/Data/Repositories/ChapterRepository.cs | 191 +++ .../CollectionTagRepository.cs | 19 +- API/Data/{ => Repositories}/FileRepository.cs | 4 +- .../{ => Repositories}/LibraryRepository.cs | 4 +- .../Repositories/ReadingListRepository.cs | 178 +++ .../{ => Repositories}/SeriesRepository.cs | 106 +- .../{ => Repositories}/SettingsRepository.cs | 6 +- API/Data/{ => Repositories}/UserRepository.cs | 126 +- API/Data/Repositories/VolumeRepository.cs | 56 + API/Data/UnitOfWork.cs | 7 +- API/Data/VolumeRepository.cs | 116 -- API/Entities/AppUser.cs | 4 + API/Entities/AppUserProgress.cs | 13 +- API/Entities/Chapter.cs | 6 +- API/Entities/CollectionTag.cs | 6 +- API/Entities/MangaFile.cs | 6 +- API/Entities/ReadingList.cs | 29 + API/Entities/ReadingListItem.cs | 25 + API/Entities/Series.cs | 6 +- API/Entities/Volume.cs | 9 +- API/Extensions/FileInfoExtensions.cs | 1 - API/Extensions/HttpExtensions.cs | 21 +- API/Helpers/AutoMapperProfiles.cs | 5 + API/Helpers/SQLHelper.cs | 30 + API/Interfaces/ITaskScheduler.cs | 2 +- API/Interfaces/IUnitOfWork.cs | 1 + API/Interfaces/IVolumeRepository.cs | 19 - .../IAppUserProgressRepository.cs | 7 +- .../Repositories/IChapterRepository.cs | 17 +- .../ICollectionTagRepository.cs | 5 +- .../{ => Repositories}/IFileRepository.cs | 4 +- .../{ => Repositories}/ILibraryRepository.cs | 2 +- .../Repositories/IReadingListRepository.cs | 22 + .../{ => Repositories}/ISeriesRepository.cs | 15 +- .../{ => Repositories}/ISettingsRepository.cs | 6 +- .../{ => Repositories}/IUserRepository.cs | 15 +- .../Repositories/IVolumeRepository.cs | 15 + API/Interfaces/Services/IArchiveService.cs | 2 +- API/Interfaces/Services/IBackupService.cs | 3 +- API/Interfaces/Services/IBookService.cs | 2 +- API/Interfaces/Services/ICleanupService.cs | 9 +- API/Interfaces/Services/IImageService.cs | 11 +- API/Interfaces/Services/IMetadataService.cs | 15 +- API/Interfaces/Services/IReaderService.cs | 10 +- API/Interfaces/Services/IScannerService.cs | 4 +- API/Interfaces/Services/ReaderService.cs | 267 ++++- API/Parser/Parser.cs | 159 ++- API/Program.cs | 30 + API/Services/ArchiveService.cs | 50 +- API/Services/BookService.cs | 64 +- API/Services/CacheService.cs | 4 +- API/Services/DirectoryService.cs | 39 + API/Services/DownloadService.cs | 1 - API/Services/ImageService.cs | 97 +- API/Services/MetadataService.cs | 128 +- API/Services/TaskScheduler.cs | 7 +- API/Services/Tasks/BackupService.cs | 33 +- API/Services/Tasks/CleanupService.cs | 66 +- .../Tasks/Scanner/ParseScannedFiles.cs | 16 +- API/Services/Tasks/ScannerService.cs | 114 +- API/Services/Tasks/VersionUpdaterService.cs | 21 +- API/SignalR/MessageFactory.cs | 56 + API/SignalR/SignalREvents.cs | 11 + API/Startup.cs | 15 +- Kavita.Common/Kavita.Common.csproj | 2 +- UI/Web/package-lock.json | 148 +++ UI/Web/package.json | 4 +- UI/Web/src/app/_guards/admin.guard.ts | 2 +- UI/Web/src/app/_guards/auth.guard.ts | 4 +- .../app/_models/events/scan-library-event.ts | 4 + .../app/_models/events/scan-series-event.ts | 3 + UI/Web/src/app/_models/reading-list.ts | 23 + UI/Web/src/app/_models/series.ts | 1 - .../app/_services/action-factory.service.ts | 89 +- UI/Web/src/app/_services/action.service.ts | 218 +++- UI/Web/src/app/_services/library.service.ts | 2 +- .../src/app/_services/message-hub.service.ts | 31 +- UI/Web/src/app/_services/reader.service.ts | 71 +- .../src/app/_services/reading-list.service.ts | 110 ++ .../directory-picker.component.html | 5 +- .../library-access-modal.component.html | 3 + .../library-editor-modal.component.ts | 5 +- UI/Web/src/app/admin/admin.module.ts | 4 +- .../admin/changelog/changelog.component.html | 7 +- .../admin/dashboard/dashboard.component.html | 2 +- .../manage-users/manage-users.component.html | 2 +- .../manage-users/manage-users.component.ts | 13 +- UI/Web/src/app/app-routing.module.ts | 8 +- UI/Web/src/app/app.module.ts | 14 +- .../src/app/book-reader/_models/book-info.ts | 9 + .../book-reader/book-reader.component.html | 34 +- .../book-reader/book-reader.component.ts | 262 +++- UI/Web/src/app/book-reader/book.service.ts | 3 +- .../card-details-modal.component.html | 4 +- .../edit-collection-tags.component.html | 2 +- .../edit-series-modal.component.html | 13 +- .../edit-series-modal.component.ts | 8 +- .../bulk-operations.component.html | 8 + .../bulk-operations.component.scss | 16 + .../bulk-operations.component.ts | 39 + .../src/app/cards/bulk-selection.service.ts | 147 +++ .../card-detail-layout.component.html | 4 +- .../card-actionables.component.ts | 3 - .../cards/card-item/card-item.component.html | 14 +- .../cards/card-item/card-item.component.scss | 28 + .../cards/card-item/card-item.component.ts | 93 +- UI/Web/src/app/cards/cards.module.ts | 7 +- .../series-card/series-card.component.html | 5 +- .../series-card/series-card.component.ts | 17 +- .../all-collections.component.html | 19 +- .../all-collections.component.ts | 69 +- .../collection-detail.component.html | 13 +- .../collection-detail.component.ts | 49 +- .../src/app/collections/collections.module.ts | 3 + .../app/dashboard/dashboard.component.html | 21 + .../app/dashboard/dashboard.component.scss | 0 .../src/app/dashboard/dashboard.component.ts | 37 + .../library-detail.component.html | 3 +- .../library-detail.component.ts | 46 +- UI/Web/src/app/library/library.component.html | 51 +- UI/Web/src/app/library/library.component.ts | 50 +- .../app/manga-reader/_models/chapter-info.ts | 5 + .../app/manga-reader/_models/reader-enums.ts | 8 +- .../infinite-scroller.component.html | 40 +- .../infinite-scroller.component.scss | 24 + .../infinite-scroller.component.ts | 127 +- .../manga-reader/manga-reader.component.html | 23 +- .../manga-reader/manga-reader.component.scss | 14 - .../manga-reader/manga-reader.component.ts | 154 ++- .../manga-reader.router.module.ts | 7 +- .../app/nav-header/nav-header.component.html | 2 +- .../app/nav-header/nav-header.component.ts | 2 +- UI/Web/src/app/{admin => pipe}/filter.pipe.ts | 0 UI/Web/src/app/pipe/pipe.module.ts | 18 + .../add-to-list-modal.component.html | 46 + .../add-to-list-modal.component.scss | 7 + .../add-to-list-modal.component.ts | 137 +++ .../edit-reading-list-modal.component.html | 31 + .../edit-reading-list-modal.component.scss | 0 .../edit-reading-list-modal.component.ts | 52 + .../dragable-ordered-list.component.html | 23 + .../dragable-ordered-list.component.scss | 47 + .../dragable-ordered-list.component.ts | 63 + .../reading-list-detail.component.html | 73 ++ .../reading-list-detail.component.scss | 4 + .../reading-list-detail.component.ts | 159 +++ .../app/reading-list/reading-list.module.ts | 40 + .../reading-list.router.module.ts | 23 + .../reading-lists.component.html | 11 + .../reading-lists.component.scss | 0 .../reading-lists/reading-lists.component.ts | 96 ++ .../series-detail.component.html | 35 +- .../series-detail.component.scss | 2 +- .../series-detail/series-detail.component.ts | 127 +- .../app/shared/_services/download.service.ts | 4 +- .../app/shared/_services/utility.service.ts | 19 +- UI/Web/src/app/shared/shared.module.ts | 2 - .../user-preferences.component.html | 34 +- .../user-preferences.component.scss | 54 +- UI/Web/src/assets/themes/dark.scss | 7 + UI/Web/src/styles.scss | 48 - UI/Web/tsconfig.json | 1 + entrypoint.sh | 14 + 238 files changed, 12119 insertions(+), 1528 deletions(-) create mode 100644 API.Benchmark/ArchiveSerivceBenchmark.cs create mode 100644 API.Benchmark/TestBenchmark.cs delete mode 100644 API.Tests/Extensions/Test Data/modified on run.txt create mode 100644 API.Tests/Services/Test Data/ImageService/cover.expected.jpg create mode 100644 API/API.csproj.DotSettings create mode 100644 API/Controllers/PluginController.cs create mode 100644 API/Controllers/ReadingListController.cs rename API/DTOs/{ => Account}/LoginDto.cs (100%) rename API/DTOs/{ => Account}/ResetPasswordDto.cs (90%) delete mode 100644 API/DTOs/ImageDto.cs delete mode 100644 API/DTOs/InProgressChapterDto.cs create mode 100644 API/DTOs/Reader/BookInfoDto.cs rename API/DTOs/{ => Reader}/BookmarkDto.cs (89%) create mode 100644 API/DTOs/Reader/IChapterInfoDto.cs create mode 100644 API/DTOs/Reader/MarkMultipleSeriesAsReadDto.cs rename API/DTOs/{ => Reader}/MarkReadDto.cs (73%) rename API/DTOs/{ => Reader}/MarkVolumeReadDto.cs (81%) create mode 100644 API/DTOs/Reader/MarkVolumesReadDto.cs rename API/DTOs/{ => Reader}/RemoveBookmarkForSeriesDto.cs (78%) create mode 100644 API/DTOs/ReadingLists/CreateReadingListDto.cs create mode 100644 API/DTOs/ReadingLists/ReadingListDto.cs create mode 100644 API/DTOs/ReadingLists/ReadingListItemDto.cs create mode 100644 API/DTOs/ReadingLists/UpdateReadingListByChapterDto.cs create mode 100644 API/DTOs/ReadingLists/UpdateReadingListByMultipleDto.cs create mode 100644 API/DTOs/ReadingLists/UpdateReadingListByMultipleSeriesDto.cs create mode 100644 API/DTOs/ReadingLists/UpdateReadingListBySeriesDto.cs create mode 100644 API/DTOs/ReadingLists/UpdateReadingListByVolumeDto.cs create mode 100644 API/DTOs/ReadingLists/UpdateReadingListDto.cs create mode 100644 API/DTOs/ReadingLists/UpdateReadingListPosition.cs rename API/DTOs/{ => Settings}/ServerSettingDTO.cs (100%) delete mode 100644 API/Data/BookmarkRepository.cs delete mode 100644 API/Data/ChapterRepository.cs create mode 100644 API/Data/MigrateCoverImages.cs create mode 100644 API/Data/Migrations/20210901150310_ReadingLists.Designer.cs create mode 100644 API/Data/Migrations/20210901150310_ReadingLists.cs create mode 100644 API/Data/Migrations/20210901200442_ReadingListsAdditions.Designer.cs create mode 100644 API/Data/Migrations/20210901200442_ReadingListsAdditions.cs create mode 100644 API/Data/Migrations/20210902110705_ReadingListsExtraRealationships.Designer.cs create mode 100644 API/Data/Migrations/20210902110705_ReadingListsExtraRealationships.cs create mode 100644 API/Data/Migrations/20210906140845_ReadingListsChanges.Designer.cs create mode 100644 API/Data/Migrations/20210906140845_ReadingListsChanges.cs create mode 100644 API/Data/Migrations/20210916142418_EntityImageRefactor.Designer.cs create mode 100644 API/Data/Migrations/20210916142418_EntityImageRefactor.cs rename API/Data/{ => Repositories}/AppUserProgressRepository.cs (65%) create mode 100644 API/Data/Repositories/ChapterRepository.cs rename API/Data/{ => Repositories}/CollectionTagRepository.cs (87%) rename API/Data/{ => Repositories}/FileRepository.cs (92%) rename API/Data/{ => Repositories}/LibraryRepository.cs (98%) create mode 100644 API/Data/Repositories/ReadingListRepository.cs rename API/Data/{ => Repositories}/SeriesRepository.cs (86%) rename API/Data/{ => Repositories}/SettingsRepository.cs (94%) rename API/Data/{ => Repositories}/UserRepository.cs (56%) create mode 100644 API/Data/Repositories/VolumeRepository.cs delete mode 100644 API/Data/VolumeRepository.cs create mode 100644 API/Entities/ReadingList.cs create mode 100644 API/Entities/ReadingListItem.cs create mode 100644 API/Helpers/SQLHelper.cs delete mode 100644 API/Interfaces/IVolumeRepository.cs rename API/Interfaces/{ => Repositories}/IAppUserProgressRepository.cs (55%) rename API/Interfaces/{ => Repositories}/ICollectionTagRepository.cs (81%) rename API/Interfaces/{ => Repositories}/IFileRepository.cs (81%) rename API/Interfaces/{ => Repositories}/ILibraryRepository.cs (96%) create mode 100644 API/Interfaces/Repositories/IReadingListRepository.cs rename API/Interfaces/{ => Repositories}/ISeriesRepository.cs (85%) rename API/Interfaces/{ => Repositories}/ISettingsRepository.cs (90%) rename API/Interfaces/{ => Repositories}/IUserRepository.cs (58%) create mode 100644 API/Interfaces/Repositories/IVolumeRepository.cs create mode 100644 API/SignalR/MessageFactory.cs create mode 100644 API/SignalR/SignalREvents.cs create mode 100644 UI/Web/src/app/_models/events/scan-library-event.ts create mode 100644 UI/Web/src/app/_models/events/scan-series-event.ts create mode 100644 UI/Web/src/app/_models/reading-list.ts create mode 100644 UI/Web/src/app/_services/reading-list.service.ts create mode 100644 UI/Web/src/app/book-reader/_models/book-info.ts create mode 100644 UI/Web/src/app/cards/bulk-operations/bulk-operations.component.html create mode 100644 UI/Web/src/app/cards/bulk-operations/bulk-operations.component.scss create mode 100644 UI/Web/src/app/cards/bulk-operations/bulk-operations.component.ts create mode 100644 UI/Web/src/app/cards/bulk-selection.service.ts create mode 100644 UI/Web/src/app/dashboard/dashboard.component.html create mode 100644 UI/Web/src/app/dashboard/dashboard.component.scss create mode 100644 UI/Web/src/app/dashboard/dashboard.component.ts rename UI/Web/src/app/{admin => pipe}/filter.pipe.ts (100%) create mode 100644 UI/Web/src/app/pipe/pipe.module.ts create mode 100644 UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.html create mode 100644 UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.scss create mode 100644 UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.ts create mode 100644 UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.html create mode 100644 UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.scss create mode 100644 UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.ts create mode 100644 UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.html create mode 100644 UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.scss create mode 100644 UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.ts create mode 100644 UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.html create mode 100644 UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.scss create mode 100644 UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.ts create mode 100644 UI/Web/src/app/reading-list/reading-list.module.ts create mode 100644 UI/Web/src/app/reading-list/reading-list.router.module.ts create mode 100644 UI/Web/src/app/reading-list/reading-lists/reading-lists.component.html create mode 100644 UI/Web/src/app/reading-list/reading-lists/reading-lists.component.scss create mode 100644 UI/Web/src/app/reading-list/reading-lists/reading-lists.component.ts diff --git a/.gitignore b/.gitignore index 9f28eec22..928e1ee53 100644 --- a/.gitignore +++ b/.gitignore @@ -500,3 +500,4 @@ _output/ API/stats/ UI/Web/dist/ /API.Tests/Extensions/Test Data/modified on run.txt +/API/covers/ diff --git a/API.Benchmark/ArchiveSerivceBenchmark.cs b/API.Benchmark/ArchiveSerivceBenchmark.cs new file mode 100644 index 000000000..c60a4271f --- /dev/null +++ b/API.Benchmark/ArchiveSerivceBenchmark.cs @@ -0,0 +1,8 @@ +namespace API.Benchmark +{ + public class ArchiveSerivceBenchmark + { + // Benchmark to test default GetNumberOfPages from archive + // vs a new method where I try to open the archive and return said stream + } +} diff --git a/API.Benchmark/ParseScannedFilesBenchmarks.cs b/API.Benchmark/ParseScannedFilesBenchmarks.cs index bc0c810ce..d3fd19a4e 100644 --- a/API.Benchmark/ParseScannedFilesBenchmarks.cs +++ b/API.Benchmark/ParseScannedFilesBenchmarks.cs @@ -1,7 +1,9 @@ using System; using System.IO; +using API.Data; using API.Entities.Enums; using API.Interfaces.Services; +using API.Parser; using API.Services; using API.Services.Tasks.Scanner; using BenchmarkDotNet.Attributes; @@ -14,7 +16,7 @@ namespace API.Benchmark [MemoryDiagnoser] [Orderer(SummaryOrderPolicy.FastestToSlowest)] [RankColumn] - [SimpleJob(launchCount: 1, warmupCount: 3, targetCount: 5, invocationCount: 100, id: "Test"), ShortRunJob] + //[SimpleJob(launchCount: 1, warmupCount: 3, targetCount: 5, invocationCount: 100, id: "Test"), ShortRunJob] public class ParseScannedFilesBenchmarks { private readonly ParseScannedFiles _parseScannedFiles; @@ -27,14 +29,37 @@ namespace API.Benchmark _parseScannedFiles = new ParseScannedFiles(bookService, _logger); } + // [Benchmark] + // public void Test() + // { + // var libraryPath = Path.Join(Directory.GetCurrentDirectory(), + // "../../../Services/Test Data/ScannerService/Manga"); + // var parsedSeries = _parseScannedFiles.ScanLibrariesForSeries(LibraryType.Manga, new string[] {libraryPath}, + // out var totalFiles, out var scanElapsedTime); + // } + + /// + /// Generate a list of Series and another list with + /// [Benchmark] - public void Test() + public void MergeName() { var libraryPath = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ScannerService/Manga"); + var p1 = new ParserInfo() + { + Chapters = "0", + Edition = "", + Format = MangaFormat.Archive, + FullFilePath = Path.Join(libraryPath, "A Town Where You Live", "A_Town_Where_You_Live_v01.zip"), + IsSpecial = false, + Series = "A Town Where You Live", + Title = "A Town Where You Live", + Volumes = "1" + }; var parsedSeries = _parseScannedFiles.ScanLibrariesForSeries(LibraryType.Manga, new string[] {libraryPath}, out var totalFiles, out var scanElapsedTime); + _parseScannedFiles.MergeName(p1); } - } } diff --git a/API.Benchmark/Program.cs b/API.Benchmark/Program.cs index 05c296f8b..b308a07b7 100644 --- a/API.Benchmark/Program.cs +++ b/API.Benchmark/Program.cs @@ -13,6 +13,7 @@ namespace API.Benchmark static void Main(string[] args) { BenchmarkRunner.Run(); + //BenchmarkRunner.Run(); } } } diff --git a/API.Benchmark/TestBenchmark.cs b/API.Benchmark/TestBenchmark.cs new file mode 100644 index 000000000..a2aabdd8a --- /dev/null +++ b/API.Benchmark/TestBenchmark.cs @@ -0,0 +1,69 @@ +using System; +using System.Collections.Generic; +using System.Linq; +using API.Comparators; +using API.DTOs; +using BenchmarkDotNet.Attributes; +using BenchmarkDotNet.Order; + +namespace API.Benchmark +{ + /// + /// This is used as a scratchpad for testing + /// + [MemoryDiagnoser] + [Orderer(SummaryOrderPolicy.FastestToSlowest)] + [RankColumn] + public class TestBenchmark + { + private readonly NaturalSortComparer _naturalSortComparer = new (); + + + private static IEnumerable GenerateVolumes(int max) + { + var random = new Random(); + var maxIterations = random.Next(max) + 1; + var list = new List(); + for (var i = 0; i < maxIterations; i++) + { + list.Add(new VolumeDto() + { + Number = random.Next(10) > 5 ? 1 : 0, + Chapters = GenerateChapters() + }); + } + + return list; + } + + private static List GenerateChapters() + { + var list = new List(); + for (var i = 1; i < 40; i++) + { + list.Add(new ChapterDto() + { + Range = i + string.Empty + }); + } + + return list; + } + + private void SortSpecialChapters(IEnumerable volumes) + { + foreach (var v in volumes.Where(vDto => vDto.Number == 0)) + { + v.Chapters = v.Chapters.OrderBy(x => x.Range, _naturalSortComparer).ToList(); + } + } + + [Benchmark] + public void TestSortSpecialChapters() + { + var volumes = GenerateVolumes(10); + SortSpecialChapters(volumes); + } + + } +} diff --git a/API.Tests/API.Tests.csproj b/API.Tests/API.Tests.csproj index 73a19fd5d..e01bab216 100644 --- a/API.Tests/API.Tests.csproj +++ b/API.Tests/API.Tests.csproj @@ -30,4 +30,8 @@ + + + + diff --git a/API.Tests/Extensions/Test Data/modified on run.txt b/API.Tests/Extensions/Test Data/modified on run.txt deleted file mode 100644 index d6a609edc..000000000 --- a/API.Tests/Extensions/Test Data/modified on run.txt +++ /dev/null @@ -1,3 +0,0 @@ -This file should be modified by the unit test08/20/2021 10:26:03 -08/20/2021 10:26:29 -08/22/2021 12:39:58 diff --git a/API.Tests/Parser/ComicParserTests.cs b/API.Tests/Parser/ComicParserTests.cs index a18ea21c9..8d25661ff 100644 --- a/API.Tests/Parser/ComicParserTests.cs +++ b/API.Tests/Parser/ComicParserTests.cs @@ -23,49 +23,63 @@ namespace API.Tests.Parser [InlineData("Amazing Man Comics chapter 25", "Amazing Man Comics")] [InlineData("Amazing Man Comics issue #25", "Amazing Man Comics")] [InlineData("Teen Titans v1 038 (1972) (c2c).cbr", "Teen Titans")] + [InlineData("Batman Beyond 02 (of 6) (1999)", "Batman Beyond")] + [InlineData("Batman Beyond - Return of the Joker (2001)", "Batman Beyond - Return of the Joker")] + [InlineData("Invincible 033.5 - Marvel Team-Up 14 (2006) (digital) (Minutemen-Slayer)", "Invincible")] + [InlineData("Batman Wayne Family Adventures - Ep. 001 - Moving In", "Batman Wayne Family Adventures")] + [InlineData("Saga 001 (2012) (Digital) (Empire-Zone).cbr", "Saga")] + [InlineData("Batman Beyond 04 (of 6) (1999)", "Batman Beyond")] public void ParseComicSeriesTest(string filename, string expected) { Assert.Equal(expected, API.Parser.Parser.ParseComicSeries(filename)); } - [Theory] - [InlineData("01 Spider-Man & Wolverine 01.cbr", "1")] - [InlineData("04 - Asterix the Gladiator (1964) (Digital-Empire) (WebP by Doc MaKS)", "4")] - [InlineData("The First Asterix Frieze (WebP by Doc MaKS)", "0")] - [InlineData("Batman & Catwoman - Trail of the Gun 01", "1")] - [InlineData("Batman & Daredevil - King of New York", "0")] - [InlineData("Batman & Grendel (1996) 01 - Devil's Bones", "1")] - [InlineData("Batman & Robin the Teen Wonder #0", "0")] - [InlineData("Batman & Wildcat (1 of 3)", "0")] - [InlineData("Batman And Superman World's Finest #01", "1")] - [InlineData("Babe 01", "1")] - [InlineData("Scott Pilgrim 01 - Scott Pilgrim's Precious Little Life (2004)", "1")] - [InlineData("Teen Titans v1 001 (1966-02) (digital) (OkC.O.M.P.U.T.O.-Novus)", "1")] - [InlineData("Scott Pilgrim 02 - Scott Pilgrim vs. The World (2005)", "2")] - [InlineData("Superman v1 024 (09-10 1943)", "1")] - [InlineData("Amazing Man Comics chapter 25", "0")] - public void ParseComicVolumeTest(string filename, string expected) - { - Assert.Equal(expected, API.Parser.Parser.ParseComicVolume(filename)); - } - [Theory] [InlineData("01 Spider-Man & Wolverine 01.cbr", "0")] [InlineData("04 - Asterix the Gladiator (1964) (Digital-Empire) (WebP by Doc MaKS)", "0")] [InlineData("The First Asterix Frieze (WebP by Doc MaKS)", "0")] [InlineData("Batman & Catwoman - Trail of the Gun 01", "0")] [InlineData("Batman & Daredevil - King of New York", "0")] + [InlineData("Batman & Grendel (1996) 01 - Devil's Bones", "0")] + [InlineData("Batman & Robin the Teen Wonder #0", "0")] + [InlineData("Batman & Wildcat (1 of 3)", "0")] + [InlineData("Batman And Superman World's Finest #01", "0")] + [InlineData("Babe 01", "0")] + [InlineData("Scott Pilgrim 01 - Scott Pilgrim's Precious Little Life (2004)", "0")] + [InlineData("Teen Titans v1 001 (1966-02) (digital) (OkC.O.M.P.U.T.O.-Novus)", "1")] + [InlineData("Scott Pilgrim 02 - Scott Pilgrim vs. The World (2005)", "0")] + [InlineData("Superman v1 024 (09-10 1943)", "1")] + [InlineData("Amazing Man Comics chapter 25", "0")] + [InlineData("Invincible 033.5 - Marvel Team-Up 14 (2006) (digital) (Minutemen-Slayer)", "0")] + [InlineData("Cyberpunk 2077 - Trauma Team 04.cbz", "0")] + public void ParseComicVolumeTest(string filename, string expected) + { + Assert.Equal(expected, API.Parser.Parser.ParseComicVolume(filename)); + } + + [Theory] + [InlineData("01 Spider-Man & Wolverine 01.cbr", "1")] + [InlineData("04 - Asterix the Gladiator (1964) (Digital-Empire) (WebP by Doc MaKS)", "0")] + [InlineData("The First Asterix Frieze (WebP by Doc MaKS)", "0")] + [InlineData("Batman & Catwoman - Trail of the Gun 01", "1")] + [InlineData("Batman & Daredevil - King of New York", "0")] [InlineData("Batman & Grendel (1996) 01 - Devil's Bones", "1")] [InlineData("Batman & Robin the Teen Wonder #0", "0")] [InlineData("Batman & Wildcat (1 of 3)", "1")] [InlineData("Batman & Wildcat (2 of 3)", "2")] - [InlineData("Batman And Superman World's Finest #01", "0")] - [InlineData("Babe 01", "0")] + [InlineData("Batman And Superman World's Finest #01", "1")] + [InlineData("Babe 01", "1")] [InlineData("Scott Pilgrim 01 - Scott Pilgrim's Precious Little Life (2004)", "1")] [InlineData("Teen Titans v1 001 (1966-02) (digital) (OkC.O.M.P.U.T.O.-Novus)", "1")] [InlineData("Superman v1 024 (09-10 1943)", "24")] [InlineData("Invincible 070.5 - Invincible Returns 1 (2010) (digital) (Minutemen-InnerDemons).cbr", "70.5")] [InlineData("Amazing Man Comics chapter 25", "25")] + [InlineData("Invincible 033.5 - Marvel Team-Up 14 (2006) (digital) (Minutemen-Slayer)", "33.5")] + [InlineData("Batman Wayne Family Adventures - Ep. 014 - Moving In", "14")] + [InlineData("Saga 001 (2012) (Digital) (Empire-Zone)", "1")] + [InlineData("Batman Beyond 04 (of 6) (1999)", "4")] + [InlineData("Invincible 052 (c2c) (2008) (Minutemen-TheCouple)", "52")] + [InlineData("Y - The Last Man #001", "1")] public void ParseComicChapterTest(string filename, string expected) { Assert.Equal(expected, API.Parser.Parser.ParseComicChapter(filename)); diff --git a/API.Tests/Parser/MangaParserTests.cs b/API.Tests/Parser/MangaParserTests.cs index d27f22dd9..917d1f467 100644 --- a/API.Tests/Parser/MangaParserTests.cs +++ b/API.Tests/Parser/MangaParserTests.cs @@ -66,6 +66,7 @@ namespace API.Tests.Parser [InlineData("Noblesse - Episode 406 (52 Pages).7z", "0")] [InlineData("X-Men v1 #201 (September 2007).cbz", "1")] [InlineData("Hentai Ouji to Warawanai Neko. - Vol. 06 Ch. 034.5", "6")] + [InlineData("The 100 Girlfriends Who Really, Really, Really, Really, Really Love You - Vol. 03 Ch. 023.5 - Volume 3 Extras.cbz", "3")] public void ParseVolumeTest(string filename, string expected) { Assert.Equal(expected, API.Parser.Parser.ParseVolume(filename)); @@ -128,7 +129,6 @@ namespace API.Tests.Parser [InlineData("Fullmetal Alchemist chapters 101-108.cbz", "Fullmetal Alchemist")] [InlineData("To Love Ru v09 Uncensored (Ch.071-079).cbz", "To Love Ru")] [InlineData("[dmntsf.net] One Piece - Digital Colored Comics Vol. 20 Ch. 177 - 30 Million vs 81 Million.cbz", "One Piece - Digital Colored Comics")] - //[InlineData("Corpse Party -The Anthology- Sachikos game of love Hysteric Birthday 2U Extra Chapter", "Corpse Party -The Anthology- Sachikos game of love Hysteric Birthday 2U")] [InlineData("Corpse Party -The Anthology- Sachikos game of love Hysteric Birthday 2U Chapter 01", "Corpse Party -The Anthology- Sachikos game of love Hysteric Birthday 2U")] [InlineData("Vol03_ch15-22.rar", "")] [InlineData("Love Hina - Special.cbz", "")] // This has to be a fallback case @@ -157,6 +157,15 @@ namespace API.Tests.Parser [InlineData("Killing Bites - Vol 11 Chapter 050 Save Me, Nunupi!.cbz", "Killing Bites")] [InlineData("Mad Chimera World - Volume 005 - Chapter 026.cbz", "Mad Chimera World")] [InlineData("Hentai Ouji to Warawanai Neko. - Vol. 06 Ch. 034.5", "Hentai Ouji to Warawanai Neko.")] + [InlineData("The 100 Girlfriends Who Really, Really, Really, Really, Really Love You - Vol. 03 Ch. 023.5 - Volume 3 Extras.cbz", "The 100 Girlfriends Who Really, Really, Really, Really, Really Love You")] + [InlineData("Kimi no Koto ga Daidaidaidaidaisuki na 100-nin no Kanojo Chapter 1-10", "Kimi no Koto ga Daidaidaidaidaisuki na 100-nin no Kanojo")] + [InlineData("The Duke of Death and His Black Maid - Ch. 177 - The Ball (3).cbz", "The Duke of Death and His Black Maid")] + [InlineData("A Compendium of Ghosts - 031 - The Third Story_ Part 12 (Digital) (Cobalt001)", "A Compendium of Ghosts")] + [InlineData("The Duke of Death and His Black Maid - Vol. 04 Ch. 054.5 - V4 Omake", "The Duke of Death and His Black Maid")] + [InlineData("Vol. 04 Ch. 054.5", "")] + [InlineData("Great_Teacher_Onizuka_v16[TheSpectrum]", "Great Teacher Onizuka")] + [InlineData("[Renzokusei]_Kimi_wa_Midara_na_Boku_no_Joou_Ch5_Final_Chapter", "Kimi wa Midara na Boku no Joou")] + [InlineData("Battle Royale, v01 (2000) [TokyoPop] [Manga-Sketchbook]", "Battle Royale")] public void ParseSeriesTest(string filename, string expected) { Assert.Equal(expected, API.Parser.Parser.ParseSeries(filename)); @@ -226,6 +235,9 @@ namespace API.Tests.Parser [InlineData("Ijousha No Ai - Vol.01 Chapter 029 8 Years Ago", "29")] [InlineData("Kedouin Makoto - Corpse Party Musume, Chapter 09.cbz", "9")] [InlineData("Hentai Ouji to Warawanai Neko. - Vol. 06 Ch. 034.5", "34.5")] + [InlineData("Kimi no Koto ga Daidaidaidaidaisuki na 100-nin no Kanojo Chapter 1-10", "1-10")] + [InlineData("Deku_&_Bakugo_-_Rising_v1_c1.1.cbz", "1.1")] + [InlineData("Chapter 63 - The Promise Made for 520 Cenz.cbr", "63")] public void ParseChaptersTest(string filename, string expected) { Assert.Equal(expected, API.Parser.Parser.ParseChapter(filename)); @@ -408,6 +420,22 @@ namespace API.Tests.Parser FullFilePath = filepath, IsSpecial = false }); + filepath = @"E:\Manga\Kono Subarashii Sekai ni Bakuen wo!\Vol. 00 Ch. 000.cbz"; + expected.Add(filepath, new ParserInfo + { + Series = "Kono Subarashii Sekai ni Bakuen wo!", Volumes = "0", Edition = "", + Chapters = "0", Filename = "Vol. 00 Ch. 000.cbz", Format = MangaFormat.Archive, + FullFilePath = filepath, IsSpecial = false + }); + + filepath = @"E:\Manga\Toukyou Akazukin\Vol. 01 Ch. 001.cbz"; + expected.Add(filepath, new ParserInfo + { + Series = "Toukyou Akazukin", Volumes = "1", Edition = "", + Chapters = "1", Filename = "Vol. 01 Ch. 001.cbz", Format = MangaFormat.Archive, + FullFilePath = filepath, IsSpecial = false + }); + // If an image is cover exclusively, ignore it filepath = @"E:\Manga\Seraph of the End\cover.png"; expected.Add(filepath, null); diff --git a/API.Tests/Parser/ParserTest.cs b/API.Tests/Parser/ParserTest.cs index 5857a50c9..6830cde0d 100644 --- a/API.Tests/Parser/ParserTest.cs +++ b/API.Tests/Parser/ParserTest.cs @@ -156,6 +156,7 @@ namespace API.Tests.Parser [InlineData("test.png", true)] [InlineData(".test.jpg", false)] [InlineData("!test.jpg", false)] + [InlineData("test.webp", true)] public void IsImageTest(string filename, bool expected) { Assert.Equal(expected, IsImage(filename)); diff --git a/API.Tests/Services/ArchiveServiceTests.cs b/API.Tests/Services/ArchiveServiceTests.cs index 50d2d0673..80f09a144 100644 --- a/API.Tests/Services/ArchiveServiceTests.cs +++ b/API.Tests/Services/ArchiveServiceTests.cs @@ -2,6 +2,7 @@ using System.IO; using System.IO.Compression; using API.Archive; +using API.Interfaces.Services; using API.Services; using Microsoft.Extensions.Logging; using NSubstitute; @@ -17,11 +18,12 @@ namespace API.Tests.Services private readonly ArchiveService _archiveService; private readonly ILogger _logger = Substitute.For>(); private readonly ILogger _directoryServiceLogger = Substitute.For>(); + private readonly IDirectoryService _directoryService = new DirectoryService(Substitute.For>()); public ArchiveServiceTests(ITestOutputHelper testOutputHelper) { _testOutputHelper = testOutputHelper; - _archiveService = new ArchiveService(_logger, new DirectoryService(_directoryServiceLogger)); + _archiveService = new ArchiveService(_logger, _directoryService); } [Theory] @@ -50,7 +52,7 @@ namespace API.Tests.Services var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/Archives"); Assert.Equal(expected, _archiveService.IsValidArchive(Path.Join(testDirectory, archivePath))); } - + [Theory] [InlineData("non existent file.zip", 0)] [InlineData("winrar.rar", 0)] @@ -69,7 +71,7 @@ namespace API.Tests.Services Assert.Equal(expected, _archiveService.GetNumberOfPagesFromArchive(Path.Join(testDirectory, archivePath))); _testOutputHelper.WriteLine($"Processed Original in {sw.ElapsedMilliseconds} ms"); } - + [Theory] @@ -84,12 +86,12 @@ namespace API.Tests.Services { var sw = Stopwatch.StartNew(); var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/Archives"); - + Assert.Equal(expected, _archiveService.CanOpen(Path.Join(testDirectory, archivePath))); _testOutputHelper.WriteLine($"Processed Original in {sw.ElapsedMilliseconds} ms"); } - - + + [Theory] [InlineData("non existent file.zip", 0)] [InlineData("winrar.rar", 0)] @@ -100,18 +102,18 @@ namespace API.Tests.Services [InlineData("file in folder_alt.zip", 1)] public void CanExtractArchive(string archivePath, int expectedFileCount) { - + var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/Archives"); var extractDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/Archives/Extraction"); DirectoryService.ClearAndDeleteDirectory(extractDirectory); - + Stopwatch sw = Stopwatch.StartNew(); _archiveService.ExtractArchive(Path.Join(testDirectory, archivePath), extractDirectory); var di1 = new DirectoryInfo(extractDirectory); Assert.Equal(expectedFileCount, di1.Exists ? di1.GetFiles().Length : 0); _testOutputHelper.WriteLine($"Processed in {sw.ElapsedMilliseconds} ms"); - + DirectoryService.ClearAndDeleteDirectory(extractDirectory); } @@ -142,14 +144,14 @@ namespace API.Tests.Services var foundFile = _archiveService.FirstFileEntry(files); Assert.Equal(expected, string.IsNullOrEmpty(foundFile) ? "" : foundFile); } - - - - [Theory] + + + + // TODO: This is broken on GA due to DirectoryService.CoverImageDirectory + //[Theory] [InlineData("v10.cbz", "v10.expected.jpg")] [InlineData("v10 - with folder.cbz", "v10 - with folder.expected.jpg")] [InlineData("v10 - nested folder.cbz", "v10 - nested folder.expected.jpg")] - //[InlineData("png.zip", "png.PNG")] [InlineData("macos_native.zip", "macos_native.jpg")] [InlineData("v10 - duplicate covers.cbz", "v10 - duplicate covers.expected.jpg")] [InlineData("sorting.zip", "sorting.expected.jpg")] @@ -159,17 +161,29 @@ namespace API.Tests.Services var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/CoverImages"); var expectedBytes = File.ReadAllBytes(Path.Join(testDirectory, expectedOutputFile)); archiveService.Configure().CanOpen(Path.Join(testDirectory, inputFile)).Returns(ArchiveLibrary.Default); - Stopwatch sw = Stopwatch.StartNew(); - Assert.Equal(expectedBytes, archiveService.GetCoverImage(Path.Join(testDirectory, inputFile))); + var sw = Stopwatch.StartNew(); + + var outputDir = Path.Join(testDirectory, "output"); + DirectoryService.ClearAndDeleteDirectory(outputDir); + DirectoryService.ExistOrCreate(outputDir); + + + var coverImagePath = archiveService.GetCoverImage(Path.Join(testDirectory, inputFile), + Path.GetFileNameWithoutExtension(inputFile) + "_output"); + var actual = File.ReadAllBytes(coverImagePath); + + + Assert.Equal(expectedBytes, actual); _testOutputHelper.WriteLine($"Processed in {sw.ElapsedMilliseconds} ms"); + DirectoryService.ClearAndDeleteDirectory(outputDir); } - - - [Theory] + + + // TODO: This is broken on GA due to DirectoryService.CoverImageDirectory + //[Theory] [InlineData("v10.cbz", "v10.expected.jpg")] [InlineData("v10 - with folder.cbz", "v10 - with folder.expected.jpg")] [InlineData("v10 - nested folder.cbz", "v10 - nested folder.expected.jpg")] - //[InlineData("png.zip", "png.PNG")] [InlineData("macos_native.zip", "macos_native.jpg")] [InlineData("v10 - duplicate covers.cbz", "v10 - duplicate covers.expected.jpg")] [InlineData("sorting.zip", "sorting.expected.jpg")] @@ -178,20 +192,21 @@ namespace API.Tests.Services var archiveService = Substitute.For(_logger, new DirectoryService(_directoryServiceLogger)); var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/CoverImages"); var expectedBytes = File.ReadAllBytes(Path.Join(testDirectory, expectedOutputFile)); - + archiveService.Configure().CanOpen(Path.Join(testDirectory, inputFile)).Returns(ArchiveLibrary.SharpCompress); Stopwatch sw = Stopwatch.StartNew(); - Assert.Equal(expectedBytes, archiveService.GetCoverImage(Path.Join(testDirectory, inputFile))); + Assert.Equal(expectedBytes, File.ReadAllBytes(archiveService.GetCoverImage(Path.Join(testDirectory, inputFile), Path.GetFileNameWithoutExtension(inputFile) + "_output"))); _testOutputHelper.WriteLine($"Processed in {sw.ElapsedMilliseconds} ms"); } - [Theory] + // TODO: This is broken on GA due to DirectoryService.CoverImageDirectory + //[Theory] [InlineData("Archives/macos_native.zip")] [InlineData("Formats/One File with DB_Supported.zip")] public void CanParseCoverImage(string inputFile) { var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/"); - Assert.NotEmpty(_archiveService.GetCoverImage(Path.Join(testDirectory, inputFile))); + Assert.NotEmpty(File.ReadAllBytes(_archiveService.GetCoverImage(Path.Join(testDirectory, inputFile), Path.GetFileNameWithoutExtension(inputFile) + "_output"))); } [Fact] @@ -200,9 +215,9 @@ namespace API.Tests.Services var testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/ComicInfos"); var archive = Path.Join(testDirectory, "file in folder.zip"); var summaryInfo = "By all counts, Ryouta Sakamoto is a loser when he's not holed up in his room, bombing things into oblivion in his favorite online action RPG. But his very own uneventful life is blown to pieces when he's abducted and taken to an uninhabited island, where he soon learns the hard way that he's being pitted against others just like him in a explosives-riddled death match! How could this be happening? Who's putting them up to this? And why!? The name, not to mention the objective, of this very real survival game is eerily familiar to Ryouta, who has mastered its virtual counterpart-BTOOOM! Can Ryouta still come out on top when he's playing for his life!?"; - + Assert.Equal(summaryInfo, _archiveService.GetSummaryInfo(archive)); } } -} \ No newline at end of file +} diff --git a/API.Tests/Services/DirectoryServiceTests.cs b/API.Tests/Services/DirectoryServiceTests.cs index 4dcb77dec..db756ebab 100644 --- a/API.Tests/Services/DirectoryServiceTests.cs +++ b/API.Tests/Services/DirectoryServiceTests.cs @@ -89,6 +89,15 @@ namespace API.Tests.Services } + [Theory] + [InlineData(new string[] {"C:/Manga/"}, new string[] {"C:/Manga/Love Hina/Vol. 01.cbz"}, "C:/Manga/Love Hina")] + public void FindHighestDirectoriesFromFilesTest(string[] rootDirectories, string[] folders, string expectedDirectory) + { + var actual = DirectoryService.FindHighestDirectoriesFromFiles(rootDirectories, folders); + var expected = new Dictionary {{expectedDirectory, ""}}; + Assert.Equal(expected, actual); + } + [Theory] [InlineData("C:/Manga/", "C:/Manga/Love Hina/Specials/Omake/", "Omake,Specials,Love Hina")] [InlineData("C:/Manga/", "C:/Manga/Love Hina/Specials/Omake", "Omake,Specials,Love Hina")] @@ -102,6 +111,7 @@ namespace API.Tests.Services [InlineData(@"C:/", @"C://Btooom!/Vol.1 Chapter 2/1.cbz", "Vol.1 Chapter 2,Btooom!")] [InlineData(@"C:\\", @"C://Btooom!/Vol.1 Chapter 2/1.cbz", "Vol.1 Chapter 2,Btooom!")] [InlineData(@"C://mount/gdrive/Library/Test Library/Comics", @"C://mount/gdrive/Library/Test Library/Comics/Dragon Age/Test", "Test,Dragon Age")] + [InlineData(@"M:\", @"M:\Toukyou Akazukin\Vol. 01 Ch. 005.cbz", @"Toukyou Akazukin")] public void GetFoldersTillRoot_Test(string rootPath, string fullpath, string expectedArray) { var expected = expectedArray.Split(","); diff --git a/API.Tests/Services/MetadataServiceTests.cs b/API.Tests/Services/MetadataServiceTests.cs index 796201538..b921f74b7 100644 --- a/API.Tests/Services/MetadataServiceTests.cs +++ b/API.Tests/Services/MetadataServiceTests.cs @@ -4,6 +4,8 @@ using API.Entities; using API.Interfaces; using API.Interfaces.Services; using API.Services; +using API.SignalR; +using Microsoft.AspNetCore.SignalR; using Microsoft.Extensions.Logging; using NSubstitute; using Xunit; @@ -13,16 +15,19 @@ namespace API.Tests.Services public class MetadataServiceTests { private readonly string _testDirectory = Path.Join(Directory.GetCurrentDirectory(), "../../../Services/Test Data/ArchiveService/Archives"); - private readonly MetadataService _metadataService; - private readonly IUnitOfWork _unitOfWork = Substitute.For(); - private readonly IImageService _imageService = Substitute.For(); - private readonly IBookService _bookService = Substitute.For(); - private readonly IArchiveService _archiveService = Substitute.For(); - private readonly ILogger _logger = Substitute.For>(); + private const string TestCoverImageFile = "thumbnail.jpg"; + private readonly string _testCoverImageDirectory = Path.Join(Directory.GetCurrentDirectory(), @"../../../Services/Test Data/ArchiveService/CoverImages"); + //private readonly MetadataService _metadataService; + // private readonly IUnitOfWork _unitOfWork = Substitute.For(); + // private readonly IImageService _imageService = Substitute.For(); + // private readonly IBookService _bookService = Substitute.For(); + // private readonly IArchiveService _archiveService = Substitute.For(); + // private readonly ILogger _logger = Substitute.For>(); + // private readonly IHubContext _messageHub = Substitute.For>(); public MetadataServiceTests() { - _metadataService = new MetadataService(_unitOfWork, _logger, _archiveService, _bookService, _imageService); + //_metadataService = new MetadataService(_unitOfWork, _logger, _archiveService, _bookService, _imageService, _messageHub); } [Fact] @@ -44,7 +49,7 @@ namespace API.Tests.Services } [Fact] - public void ShouldUpdateCoverImage_OnSecondRun_FileModified() + public void ShouldUpdateCoverImage_OnFirstRun_FileModified() { // Represents first run Assert.True(MetadataService.ShouldUpdateCoverImage(null, new MangaFile() @@ -55,10 +60,10 @@ namespace API.Tests.Services } [Fact] - public void ShouldUpdateCoverImage_OnSecondRun_CoverImageLocked() + public void ShouldUpdateCoverImage_OnFirstRun_CoverImageLocked() { // Represents first run - Assert.False(MetadataService.ShouldUpdateCoverImage(null, new MangaFile() + Assert.True(MetadataService.ShouldUpdateCoverImage(null, new MangaFile() { FilePath = Path.Join(_testDirectory, "file in folder.zip"), LastModified = new FileInfo(Path.Join(_testDirectory, "file in folder.zip")).LastWriteTime @@ -99,14 +104,36 @@ namespace API.Tests.Services } [Fact] - public void ShouldUpdateCoverImage_OnSecondRun_CoverImageSet() + public void ShouldNotUpdateCoverImage_OnSecondRun_CoverImageSet() { // Represents first run - Assert.False(MetadataService.ShouldUpdateCoverImage(new byte[] {1}, new MangaFile() + Assert.False(MetadataService.ShouldUpdateCoverImage(TestCoverImageFile, new MangaFile() { FilePath = Path.Join(_testDirectory, "file in folder.zip"), LastModified = new FileInfo(Path.Join(_testDirectory, "file in folder.zip")).LastWriteTime - }, false, false)); + }, false, false, _testCoverImageDirectory)); + } + + [Fact] + public void ShouldNotUpdateCoverImage_OnSecondRun_HasCoverImage_NoForceUpdate_NoLock() + { + + Assert.False(MetadataService.ShouldUpdateCoverImage(TestCoverImageFile, new MangaFile() + { + FilePath = Path.Join(_testDirectory, "file in folder.zip"), + LastModified = DateTime.Now + }, false, false, _testCoverImageDirectory)); + } + + [Fact] + public void ShouldUpdateCoverImage_OnSecondRun_HasCoverImage_NoForceUpdate_HasLock_CoverImageDoesntExist() + { + + Assert.True(MetadataService.ShouldUpdateCoverImage(@"doesn't_exist.jpg", new MangaFile() + { + FilePath = Path.Join(_testDirectory, "file in folder.zip"), + LastModified = DateTime.Now + }, false, true, _testCoverImageDirectory)); } } } diff --git a/API.Tests/Services/ScannerServiceTests.cs b/API.Tests/Services/ScannerServiceTests.cs index 2c7a999f0..93b254c8e 100644 --- a/API.Tests/Services/ScannerServiceTests.cs +++ b/API.Tests/Services/ScannerServiceTests.cs @@ -14,8 +14,10 @@ using API.Parser; using API.Services; using API.Services.Tasks; using API.Services.Tasks.Scanner; +using API.SignalR; using API.Tests.Helpers; using AutoMapper; +using Microsoft.AspNetCore.SignalR; using Microsoft.Data.Sqlite; using Microsoft.EntityFrameworkCore; using Microsoft.EntityFrameworkCore.Infrastructure; @@ -34,6 +36,7 @@ namespace API.Tests.Services private readonly IImageService _imageService = Substitute.For(); private readonly ILogger _metadataLogger = Substitute.For>(); private readonly ICacheService _cacheService = Substitute.For(); + private readonly IHubContext _messageHub = Substitute.For>(); private readonly DbConnection _connection; private readonly DataContext _context; @@ -52,8 +55,8 @@ namespace API.Tests.Services IUnitOfWork unitOfWork = new UnitOfWork(_context, Substitute.For(), null); - IMetadataService metadataService = Substitute.For(unitOfWork, _metadataLogger, _archiveService, _bookService, _imageService); - _scannerService = new ScannerService(unitOfWork, _logger, _archiveService, metadataService, _bookService, _cacheService); + IMetadataService metadataService = Substitute.For(unitOfWork, _metadataLogger, _archiveService, _bookService, _imageService, _messageHub); + _scannerService = new ScannerService(unitOfWork, _logger, _archiveService, metadataService, _bookService, _cacheService, _messageHub); } private async Task SeedDb() @@ -111,6 +114,7 @@ namespace API.Tests.Services Assert.Empty(_scannerService.FindSeriesNotOnDisk(existingSeries, infos)); } + // TODO: Figure out how to do this with ParseScannedFiles // [Theory] // [InlineData(new [] {"Darker than Black"}, "Darker than Black", "Darker than Black")] diff --git a/API.Tests/Services/Test Data/ImageService/cover.expected.jpg b/API.Tests/Services/Test Data/ImageService/cover.expected.jpg new file mode 100644 index 0000000000000000000000000000000000000000..73da78f507cfdcc45ee6db3742e06276e7bd3c9e GIT binary patch literal 473476 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%0DA*Gv3BS2H4l5B2|z&~!Oyza2QGanpt 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�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≫Mx{f%M%i`k%8j7@%6b_P$XJ)lYQMjJ>aU#8OcR| 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≈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 literal 0 HcmV?d00001 diff --git a/API/API.csproj b/API/API.csproj index 74bf6fbbc..fa1bcdfec 100644 --- a/API/API.csproj +++ b/API/API.csproj @@ -22,8 +22,6 @@ kareadita.github.io Copyright 2020-$([System.DateTime]::Now.ToString('yyyy')) kavitareader.com (GNU General Public v3) - - 0.4.1 $(Configuration)-dev false @@ -60,7 +58,7 @@ - + all runtime; build; native; contentfiles; analyzers; buildtransitive @@ -75,42 +73,41 @@ - + - + - + - + - @@ -120,6 +117,7 @@ Always + @@ -244,6 +242,48 @@ <_ContentIncludedByDefault Remove="wwwroot\styles.4bd902bb3037f36f2c64.css.map" /> <_ContentIncludedByDefault Remove="wwwroot\vendor.6b2a0912ae80e6fd297f.js" /> <_ContentIncludedByDefault Remove="wwwroot\vendor.6b2a0912ae80e6fd297f.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\10.b727db78581442412e9a.js" /> + <_ContentIncludedByDefault Remove="wwwroot\10.b727db78581442412e9a.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\2.fcc031071e80d6837012.js" /> + <_ContentIncludedByDefault Remove="wwwroot\2.fcc031071e80d6837012.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\7.c30da7d2e809fa05d1e3.js" /> + <_ContentIncludedByDefault Remove="wwwroot\7.c30da7d2e809fa05d1e3.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\8.d4c77a90c95e9861656a.js" /> + <_ContentIncludedByDefault Remove="wwwroot\8.d4c77a90c95e9861656a.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\9.489b177dd1a6beeb35ad.js" /> + <_ContentIncludedByDefault Remove="wwwroot\9.489b177dd1a6beeb35ad.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\fonts\Spartan\OFL.txt" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\fonts\Spartan\Spartan-VariableFont_wght.ttf" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\icons\android-chrome-192x192.png" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\icons\android-chrome-256x256.png" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\icons\apple-touch-icon.png" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\icons\browserconfig.xml" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\icons\favicon-16x16.png" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\icons\favicon-32x32.png" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\icons\favicon.ico" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\icons\mstile-150x150.png" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\images\image-reset-cover-min.png" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\images\image-reset-cover.png" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\images\kavita-book-cropped.png" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\images\login-bg.jpg" /> + <_ContentIncludedByDefault Remove="wwwroot\assets\images\logo.png" /> + <_ContentIncludedByDefault Remove="wwwroot\common.fbf71de364f5a1f37413.js" /> + <_ContentIncludedByDefault Remove="wwwroot\common.fbf71de364f5a1f37413.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\login-bg.8860e6ff9d2a3598539c.jpg" /> + <_ContentIncludedByDefault Remove="wwwroot\main.a3a1e647a39145accff3.js" /> + <_ContentIncludedByDefault Remove="wwwroot\main.a3a1e647a39145accff3.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\polyfills.3dda3bf3d087e5d131ba.js" /> + <_ContentIncludedByDefault Remove="wwwroot\polyfills.3dda3bf3d087e5d131ba.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\runtime.b9818dfc90f418b3f0a7.js" /> + <_ContentIncludedByDefault Remove="wwwroot\runtime.b9818dfc90f418b3f0a7.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\scripts.7d1c78b2763c483bb699.js" /> + <_ContentIncludedByDefault Remove="wwwroot\scripts.7d1c78b2763c483bb699.js.map" /> + <_ContentIncludedByDefault Remove="wwwroot\site.webmanifest" /> + <_ContentIncludedByDefault Remove="wwwroot\Spartan-VariableFont_wght.0427aac0d980a12ae8ba.ttf" /> + <_ContentIncludedByDefault Remove="wwwroot\styles.85a58cb3e4a4b1add864.css" /> + <_ContentIncludedByDefault Remove="wwwroot\styles.85a58cb3e4a4b1add864.css.map" /> + <_ContentIncludedByDefault Remove="wwwroot\vendor.54bf44a9aa720ff8881d.js" /> + <_ContentIncludedByDefault Remove="wwwroot\vendor.54bf44a9aa720ff8881d.js.map" /> diff --git a/API/API.csproj.DotSettings b/API/API.csproj.DotSettings new file mode 100644 index 000000000..80aad93c5 --- /dev/null +++ b/API/API.csproj.DotSettings @@ -0,0 +1,2 @@ + + True \ No newline at end of file diff --git a/API/Comparators/ChapterSortComparer.cs b/API/Comparators/ChapterSortComparer.cs index a56693fca..3791e05ff 100644 --- a/API/Comparators/ChapterSortComparer.cs +++ b/API/Comparators/ChapterSortComparer.cs @@ -2,8 +2,17 @@ namespace API.Comparators { + ///

+ /// Sorts chapters based on their Number. Uses natural ordering of doubles. + /// public class ChapterSortComparer : IComparer { + /// + /// Normal sort for 2 doubles. 0 always comes before anything else + /// + /// + /// + /// public int Compare(double x, double y) { if (x == 0.0 && y == 0.0) return 0; diff --git a/API/Comparators/NaturalSortComparer.cs b/API/Comparators/NaturalSortComparer.cs index ac10e09ae..9bf79db81 100644 --- a/API/Comparators/NaturalSortComparer.cs +++ b/API/Comparators/NaturalSortComparer.cs @@ -10,7 +10,7 @@ namespace API.Comparators { private readonly bool _isAscending; private Dictionary _table = new(); - + private bool _disposed; @@ -23,9 +23,9 @@ namespace API.Comparators { if (x == y) return 0; + // Should be fixed: Operations that change non-concurrent collections must have exclusive access. A concurrent update was performed on this collection and corrupted its state. The collection's state is no longer correct. if (!_table.TryGetValue(x ?? Empty, out var x1)) { - // .Replace(" ", Empty) x1 = Regex.Split(x ?? Empty, "([0-9]+)"); _table.Add(x ?? Empty, x1); } @@ -33,6 +33,7 @@ namespace API.Comparators if (!_table.TryGetValue(y ?? Empty, out var y1)) { y1 = Regex.Split(y ?? Empty, "([0-9]+)"); + // Should be fixed: EXCEPTION: An item with the same key has already been added. Key: M:\Girls of the Wild's\Girls of the Wild's - Ep. 083 (Season 1) [LINE Webtoon].cbz _table.Add(y ?? Empty, y1); } @@ -50,8 +51,8 @@ namespace API.Comparators returnVal = 1; } else if (x1.Length > y1.Length) - { - returnVal = -1; + { + returnVal = -1; } else { @@ -78,12 +79,12 @@ namespace API.Comparators { if (disposing) { - // called via myClass.Dispose(). + // called via myClass.Dispose(). _table.Clear(); _table = null; } // Release unmanaged resources. - // Set large fields to null. + // Set large fields to null. _disposed = true; } } @@ -93,10 +94,10 @@ namespace API.Comparators Dispose(true); SuppressFinalize(this); } - + ~NaturalSortComparer() // the finalizer { Dispose(false); } } -} \ No newline at end of file +} diff --git a/API/Controllers/AccountController.cs b/API/Controllers/AccountController.cs index 8e108cd28..58478e2f8 100644 --- a/API/Controllers/AccountController.cs +++ b/API/Controllers/AccountController.cs @@ -5,6 +5,7 @@ using System.Reflection; using System.Threading.Tasks; using API.Constants; using API.DTOs; +using API.DTOs.Account; using API.Entities; using API.Errors; using API.Extensions; diff --git a/API/Controllers/BookController.cs b/API/Controllers/BookController.cs index d48b75707..448d45c02 100644 --- a/API/Controllers/BookController.cs +++ b/API/Controllers/BookController.cs @@ -2,6 +2,8 @@ using System.Linq; using System.Threading.Tasks; using API.DTOs; +using API.DTOs.Reader; +using API.Entities.Enums; using API.Extensions; using API.Interfaces; using API.Interfaces.Services; @@ -31,18 +33,36 @@ namespace API.Controllers } [HttpGet("{chapterId}/book-info")] - public async Task> GetBookInfo(int chapterId) + public async Task> GetBookInfo(int chapterId) { - var chapter = await _unitOfWork.VolumeRepository.GetChapterAsync(chapterId); - using var book = await EpubReader.OpenBookAsync(chapter.Files.ElementAt(0).FilePath); + var dto = await _unitOfWork.ChapterRepository.GetChapterInfoDtoAsync(chapterId); + var bookTitle = string.Empty; + if (dto.SeriesFormat == MangaFormat.Epub) + { + var mangaFile = (await _unitOfWork.ChapterRepository.GetFilesForChapterAsync(chapterId)).First(); + using var book = await EpubReader.OpenBookAsync(mangaFile.FilePath); + bookTitle = book.Title; + } - return book.Title; + return Ok(new BookInfoDto() + { + ChapterNumber = dto.ChapterNumber, + VolumeNumber = dto.VolumeNumber, + VolumeId = dto.VolumeId, + BookTitle = bookTitle, + SeriesName = dto.SeriesName, + SeriesFormat = dto.SeriesFormat, + SeriesId = dto.SeriesId, + LibraryId = dto.LibraryId, + IsSpecial = dto.IsSpecial, + Pages = dto.Pages, + }); } [HttpGet("{chapterId}/book-resources")] public async Task GetBookPageResources(int chapterId, [FromQuery] string file) { - var chapter = await _unitOfWork.VolumeRepository.GetChapterAsync(chapterId); + var chapter = await _unitOfWork.ChapterRepository.GetChapterAsync(chapterId); var book = await EpubReader.OpenBookAsync(chapter.Files.ElementAt(0).FilePath); var key = BookService.CleanContentKeys(file); @@ -61,7 +81,7 @@ namespace API.Controllers { // This will return a list of mappings from ID -> pagenum. ID will be the xhtml key and pagenum will be the reading order // this is used to rewrite anchors in the book text so that we always load properly in FE - var chapter = await _unitOfWork.VolumeRepository.GetChapterAsync(chapterId); + var chapter = await _unitOfWork.ChapterRepository.GetChapterAsync(chapterId); using var book = await EpubReader.OpenBookAsync(chapter.Files.ElementAt(0).FilePath); var mappings = await _bookService.CreateKeyToPageMappingAsync(book); diff --git a/API/Controllers/CollectionController.cs b/API/Controllers/CollectionController.cs index 8bf10c09a..6081f7d58 100644 --- a/API/Controllers/CollectionController.cs +++ b/API/Controllers/CollectionController.cs @@ -121,7 +121,7 @@ namespace API.Controllers if (!updateSeriesForTagDto.Tag.CoverImageLocked) { tag.CoverImageLocked = false; - tag.CoverImage = Array.Empty(); + tag.CoverImage = string.Empty; _unitOfWork.CollectionTagRepository.Update(tag); } diff --git a/API/Controllers/DownloadController.cs b/API/Controllers/DownloadController.cs index 416ffbfc5..3000e1f22 100644 --- a/API/Controllers/DownloadController.cs +++ b/API/Controllers/DownloadController.cs @@ -14,7 +14,6 @@ using API.Services; using Kavita.Common; using Microsoft.AspNetCore.Authorization; using Microsoft.AspNetCore.Mvc; -using Microsoft.AspNetCore.StaticFiles; namespace API.Controllers { @@ -49,7 +48,7 @@ namespace API.Controllers [HttpGet("chapter-size")] public async Task> GetChapterSize(int chapterId) { - var files = await _unitOfWork.VolumeRepository.GetFilesForChapterAsync(chapterId); + var files = await _unitOfWork.ChapterRepository.GetFilesForChapterAsync(chapterId); return Ok(DirectoryService.GetTotalSize(files.Select(c => c.FilePath))); } @@ -91,8 +90,8 @@ namespace API.Controllers [HttpGet("chapter")] public async Task DownloadChapter(int chapterId) { - var files = await _unitOfWork.VolumeRepository.GetFilesForChapterAsync(chapterId); - var chapter = await _unitOfWork.VolumeRepository.GetChapterAsync(chapterId); + var files = await _unitOfWork.ChapterRepository.GetFilesForChapterAsync(chapterId); + var chapter = await _unitOfWork.ChapterRepository.GetChapterAsync(chapterId); var volume = await _unitOfWork.SeriesRepository.GetVolumeByIdAsync(chapter.VolumeId); var series = await _unitOfWork.SeriesRepository.GetSeriesByIdAsync(volume.SeriesId); try @@ -155,7 +154,7 @@ namespace API.Controllers var chapterExtractPath = Path.Join(fullExtractPath, $"{series.Id}_bookmark_{chapterId}"); var chapterPages = downloadBookmarkDto.Bookmarks.Where(b => b.ChapterId == chapterId) .Select(b => b.Page).ToList(); - var mangaFiles = await _unitOfWork.VolumeRepository.GetFilesForChapterAsync(chapterId); + var mangaFiles = await _unitOfWork.ChapterRepository.GetFilesForChapterAsync(chapterId); switch (series.Format) { case MangaFormat.Image: diff --git a/API/Controllers/ImageController.cs b/API/Controllers/ImageController.cs index 31da9c54b..f1ddb770e 100644 --- a/API/Controllers/ImageController.cs +++ b/API/Controllers/ImageController.cs @@ -1,7 +1,12 @@ -using System.Threading.Tasks; +using System; +using System.IO; +using System.Net; +using System.Threading.Tasks; using API.Extensions; using API.Interfaces; +using API.Services; using Microsoft.AspNetCore.Mvc; +using Microsoft.Net.Http.Headers; namespace API.Controllers { @@ -10,7 +15,6 @@ namespace API.Controllers /// public class ImageController : BaseApiController { - private const string Format = "jpeg"; private readonly IUnitOfWork _unitOfWork; /// @@ -27,11 +31,12 @@ namespace API.Controllers [HttpGet("chapter-cover")] public async Task GetChapterCoverImage(int chapterId) { - var content = await _unitOfWork.VolumeRepository.GetChapterCoverImageAsync(chapterId); - if (content == null) return BadRequest("No cover image"); + var path = Path.Join(DirectoryService.CoverImageDirectory, await _unitOfWork.ChapterRepository.GetChapterCoverImageAsync(chapterId)); + if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest($"No cover image"); + var format = Path.GetExtension(path).Replace(".", ""); - Response.AddCacheHeader(content); - return File(content, "image/" + Format, $"{chapterId}"); + Response.AddCacheHeader(path); + return PhysicalFile(path, "image/" + format, Path.GetFileName(path)); } /// @@ -42,11 +47,12 @@ namespace API.Controllers [HttpGet("volume-cover")] public async Task GetVolumeCoverImage(int volumeId) { - var content = await _unitOfWork.SeriesRepository.GetVolumeCoverImageAsync(volumeId); - if (content == null) return BadRequest("No cover image"); + var path = Path.Join(DirectoryService.CoverImageDirectory, await _unitOfWork.VolumeRepository.GetVolumeCoverImageAsync(volumeId)); + if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest($"No cover image"); + var format = Path.GetExtension(path).Replace(".", ""); - Response.AddCacheHeader(content); - return File(content, "image/" + Format, $"{volumeId}"); + Response.AddCacheHeader(path); + return PhysicalFile(path, "image/" + format, Path.GetFileName(path)); } /// @@ -57,11 +63,12 @@ namespace API.Controllers [HttpGet("series-cover")] public async Task GetSeriesCoverImage(int seriesId) { - var content = await _unitOfWork.SeriesRepository.GetSeriesCoverImageAsync(seriesId); - if (content == null) return BadRequest("No cover image"); + var path = Path.Join(DirectoryService.CoverImageDirectory, await _unitOfWork.SeriesRepository.GetSeriesCoverImageAsync(seriesId)); + if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest($"No cover image"); + var format = Path.GetExtension(path).Replace(".", ""); - Response.AddCacheHeader(content); - return File(content, "image/" + Format, $"{seriesId}"); + Response.AddCacheHeader(path); + return PhysicalFile(path, "image/" + format, Path.GetFileName(path)); } /// @@ -72,11 +79,12 @@ namespace API.Controllers [HttpGet("collection-cover")] public async Task GetCollectionCoverImage(int collectionTagId) { - var content = await _unitOfWork.CollectionTagRepository.GetCoverImageAsync(collectionTagId); - if (content == null) return BadRequest("No cover image"); + var path = Path.Join(DirectoryService.CoverImageDirectory, await _unitOfWork.CollectionTagRepository.GetCoverImageAsync(collectionTagId)); + if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest($"No cover image"); + var format = Path.GetExtension(path).Replace(".", ""); - Response.AddCacheHeader(content); - return File(content, "image/" + Format, $"{collectionTagId}"); + Response.AddCacheHeader(path); + return PhysicalFile(path, "image/" + format, Path.GetFileName(path)); } } } diff --git a/API/Controllers/LibraryController.cs b/API/Controllers/LibraryController.cs index 53c3953ac..25f224a28 100644 --- a/API/Controllers/LibraryController.cs +++ b/API/Controllers/LibraryController.cs @@ -225,11 +225,11 @@ namespace API.Controllers [HttpGet("search")] public async Task>> Search(string queryString) { - queryString = queryString.Replace(@"%", ""); + queryString = queryString.Trim().Replace(@"%", ""); - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); // Get libraries user has access to - var libraries = (await _unitOfWork.LibraryRepository.GetLibrariesForUserIdAsync(user.Id)).ToList(); + var libraries = (await _unitOfWork.LibraryRepository.GetLibrariesForUserIdAsync(userId)).ToList(); if (!libraries.Any()) return BadRequest("User does not have access to any libraries"); diff --git a/API/Controllers/OPDSController.cs b/API/Controllers/OPDSController.cs index 438dfac77..ef83c2a69 100644 --- a/API/Controllers/OPDSController.cs +++ b/API/Controllers/OPDSController.cs @@ -93,6 +93,19 @@ namespace API.Controllers } }); feed.Entries.Add(new FeedEntry() + { + Id = "readingList", + Title = "Reading Lists", + Content = new FeedEntryContent() + { + Text = "Browse by Reading Lists" + }, + Links = new List() + { + CreateLink(FeedLinkRelation.SubSection, FeedLinkType.AtomNavigation, Prefix + $"{apiKey}/reading-list"), + } + }); + feed.Entries.Add(new FeedEntry() { Id = "allLibraries", Title = "All Libraries", @@ -128,8 +141,8 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); - var libraries = await _unitOfWork.LibraryRepository.GetLibrariesForUserIdAsync(user.Id); + var userId = await GetUser(apiKey); + var libraries = await _unitOfWork.LibraryRepository.GetLibrariesForUserIdAsync(userId); var feed = CreateFeed("All Libraries", $"{apiKey}/libraries", apiKey); @@ -155,7 +168,8 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); + var userId = await GetUser(apiKey); + var user = await _unitOfWork.UserRepository.GetUserByIdAsync(userId); var isAdmin = await _userManager.IsInRoleAsync(user, PolicyConstants.AdminRole); IEnumerable tags; @@ -190,13 +204,15 @@ namespace API.Controllers return CreateXmlResult(SerializeXml(feed)); } + [HttpGet("{apiKey}/collections/{collectionId}")] [Produces("application/xml")] public async Task GetCollection(int collectionId, string apiKey, [FromQuery] int pageNumber = 0) { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); + var userId = await GetUser(apiKey); + var user = await _unitOfWork.UserRepository.GetUserByIdAsync(userId); var isAdmin = await _userManager.IsInRoleAsync(user, PolicyConstants.AdminRole); IEnumerable tags; @@ -215,7 +231,7 @@ namespace API.Controllers return BadRequest("Collection does not exist or you don't have access"); } - var series = await _unitOfWork.SeriesRepository.GetSeriesDtoForCollectionAsync(collectionId, user.Id, new UserParams() + var series = await _unitOfWork.SeriesRepository.GetSeriesDtoForCollectionAsync(collectionId, userId, new UserParams() { PageNumber = pageNumber, PageSize = 20 @@ -230,6 +246,77 @@ namespace API.Controllers } + return CreateXmlResult(SerializeXml(feed)); + } + + [HttpGet("{apiKey}/reading-list")] + [Produces("application/xml")] + public async Task GetReadingLists(string apiKey, [FromQuery] int pageNumber = 0) + { + if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) + return BadRequest("OPDS is not enabled on this server"); + var userId = await GetUser(apiKey); + + var readingLists = await _unitOfWork.ReadingListRepository.GetReadingListDtosForUserAsync(userId, true, new UserParams() + { + PageNumber = pageNumber + }); + + + var feed = CreateFeed("All Reading Lists", $"{apiKey}/reading-list", apiKey); + + foreach (var readingListDto in readingLists) + { + feed.Entries.Add(new FeedEntry() + { + Id = readingListDto.Id.ToString(), + Title = readingListDto.Title, + Summary = readingListDto.Summary, + Links = new List() + { + CreateLink(FeedLinkRelation.SubSection, FeedLinkType.AtomNavigation, Prefix + $"{apiKey}/reading-list/{readingListDto.Id}"), + } + }); + } + + return CreateXmlResult(SerializeXml(feed)); + } + + [HttpGet("{apiKey}/reading-list/{readingListId}")] + [Produces("application/xml")] + public async Task GetReadingListItems(int readingListId, string apiKey) + { + if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) + return BadRequest("OPDS is not enabled on this server"); + var userId = await GetUser(apiKey); + var user = await _unitOfWork.UserRepository.GetUserByIdAsync(userId); + + var userWithLists = await _unitOfWork.UserRepository.GetUserWithReadingListsByUsernameAsync(user.UserName); + var readingList = userWithLists.ReadingLists.SingleOrDefault(t => t.Id == readingListId); + if (readingList == null) + { + return BadRequest("Reading list does not exist or you don't have access"); + } + + var feed = CreateFeed(readingList.Title + " Reading List", $"{apiKey}/reading-list/{readingListId}", apiKey); + + var items = await _unitOfWork.ReadingListRepository.GetReadingListItemDtosByIdAsync(readingListId, userId); + foreach (var item in items) + { + feed.Entries.Add(new FeedEntry() + { + Id = item.ChapterId.ToString(), + Title = "Chapter " + item.ChapterNumber, + Links = new List() + { + CreateLink(FeedLinkRelation.SubSection, FeedLinkType.AtomNavigation, Prefix + $"{apiKey}/series/{item.SeriesId}/volume/{item.VolumeId}/chapter/{item.ChapterId}"), + CreateLink(FeedLinkRelation.Image, FeedLinkType.Image, $"/api/image/chapter-cover?chapterId={item.ChapterId}") + } + }); + } + + + return CreateXmlResult(SerializeXml(feed)); } @@ -239,16 +326,16 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); + var userId = await GetUser(apiKey); var library = - (await _unitOfWork.LibraryRepository.GetLibrariesForUserIdAsync(user.Id)).SingleOrDefault(l => + (await _unitOfWork.LibraryRepository.GetLibrariesForUserIdAsync(userId)).SingleOrDefault(l => l.Id == libraryId); if (library == null) { return BadRequest("User does not have access to this library"); } - var series = await _unitOfWork.SeriesRepository.GetSeriesDtoForLibraryIdAsync(libraryId, user.Id, new UserParams() + var series = await _unitOfWork.SeriesRepository.GetSeriesDtoForLibraryIdAsync(libraryId, userId, new UserParams() { PageNumber = pageNumber, PageSize = 20 @@ -271,8 +358,8 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); - var recentlyAdded = await _unitOfWork.SeriesRepository.GetRecentlyAdded(0, user.Id, new UserParams() + var userId = await GetUser(apiKey); + var recentlyAdded = await _unitOfWork.SeriesRepository.GetRecentlyAdded(0, userId, new UserParams() { PageNumber = pageNumber, PageSize = 20 @@ -296,13 +383,13 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); + var userId = await GetUser(apiKey); var userParams = new UserParams() { PageNumber = pageNumber, PageSize = 20 }; - var results = await _unitOfWork.SeriesRepository.GetInProgress(user.Id, 0, userParams, _filterDto); + var results = await _unitOfWork.SeriesRepository.GetInProgress(userId, 0, userParams, _filterDto); var listResults = results.DistinctBy(s => s.Name).Skip((userParams.PageNumber - 1) * userParams.PageSize) .Take(userParams.PageSize).ToList(); var pagedList = new PagedList(listResults, listResults.Count, userParams.PageNumber, userParams.PageSize); @@ -326,14 +413,14 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); + var userId = await GetUser(apiKey); if (string.IsNullOrEmpty(query)) { return BadRequest("You must pass a query parameter"); } query = query.Replace(@"%", ""); // Get libraries user has access to - var libraries = (await _unitOfWork.LibraryRepository.GetLibrariesForUserIdAsync(user.Id)).ToList(); + var libraries = (await _unitOfWork.LibraryRepository.GetLibrariesForUserIdAsync(userId)).ToList(); if (!libraries.Any()) return BadRequest("User does not have access to any libraries"); @@ -378,9 +465,9 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); - var series = await _unitOfWork.SeriesRepository.GetSeriesDtoByIdAsync(seriesId, user.Id); - var volumes = await _unitOfWork.SeriesRepository.GetVolumesDtoAsync(seriesId, user.Id); + var userId = await GetUser(apiKey); + var series = await _unitOfWork.SeriesRepository.GetSeriesDtoByIdAsync(seriesId, userId); + var volumes = await _unitOfWork.SeriesRepository.GetVolumesDtoAsync(seriesId, userId); var feed = CreateFeed(series.Name + " - Volumes", $"{apiKey}/series/{series.Id}", apiKey); feed.Links.Add(CreateLink(FeedLinkRelation.Image, FeedLinkType.Image, $"/api/image/series-cover?seriesId={seriesId}")); foreach (var volumeDto in volumes) @@ -397,11 +484,11 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); - var series = await _unitOfWork.SeriesRepository.GetSeriesDtoByIdAsync(seriesId, user.Id); + var userId = await GetUser(apiKey); + var series = await _unitOfWork.SeriesRepository.GetSeriesDtoByIdAsync(seriesId, userId); var volume = await _unitOfWork.SeriesRepository.GetVolumeAsync(volumeId); var chapters = - (await _unitOfWork.VolumeRepository.GetChaptersAsync(volumeId)).OrderBy(x => double.Parse(x.Number), + (await _unitOfWork.ChapterRepository.GetChaptersAsync(volumeId)).OrderBy(x => double.Parse(x.Number), _chapterSortComparer); var feed = CreateFeed(series.Name + " - Volume " + volume.Name + " - Chapters ", $"{apiKey}/series/{seriesId}/volume/{volumeId}", apiKey); @@ -428,11 +515,11 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var user = await GetUser(apiKey); - var series = await _unitOfWork.SeriesRepository.GetSeriesDtoByIdAsync(seriesId, user.Id); + var userId = await GetUser(apiKey); + var series = await _unitOfWork.SeriesRepository.GetSeriesDtoByIdAsync(seriesId, userId); var volume = await _unitOfWork.SeriesRepository.GetVolumeAsync(volumeId); - var chapter = await _unitOfWork.VolumeRepository.GetChapterDtoAsync(chapterId); - var files = await _unitOfWork.VolumeRepository.GetFilesForChapterAsync(chapterId); + var chapter = await _unitOfWork.ChapterRepository.GetChapterDtoAsync(chapterId); + var files = await _unitOfWork.ChapterRepository.GetFilesForChapterAsync(chapterId); var feed = CreateFeed(series.Name + " - Volume " + volume.Name + " - Chapters ", $"{apiKey}/series/{seriesId}/volume/{volumeId}/chapter/{chapterId}", apiKey); foreach (var mangaFile in files) @@ -456,7 +543,7 @@ namespace API.Controllers { if (!(await _unitOfWork.SettingsRepository.GetSettingsDtoAsync()).EnableOpds) return BadRequest("OPDS is not enabled on this server"); - var files = await _unitOfWork.VolumeRepository.GetFilesForChapterAsync(chapterId); + var files = await _unitOfWork.ChapterRepository.GetFilesForChapterAsync(chapterId); var (bytes, contentType, fileDownloadName) = await _downloadService.GetFirstFileDownload(files); return File(bytes, contentType, fileDownloadName); } @@ -544,7 +631,7 @@ namespace API.Controllers return new FeedEntry() { Id = volumeDto.Id.ToString(), - Title = volumeDto.IsSpecial ? "Specials" : "Volume " + volumeDto.Name, + Title = "Volume " + volumeDto.Name, Links = new List() { CreateLink(FeedLinkRelation.SubSection, FeedLinkType.AtomNavigation, Prefix + $"{apiKey}/series/{seriesId}/volume/{volumeDto.Id}"), @@ -639,15 +726,18 @@ namespace API.Controllers /// Gets the user from the API key /// /// - private async Task GetUser(string apiKey) + private async Task GetUser(string apiKey) { - var user = await _unitOfWork.UserRepository.GetUserByApiKeyAsync(apiKey); - if (user == null) + try { - throw new KavitaException("User does not exist"); + var user = await _unitOfWork.UserRepository.GetUserIdByApiKeyAsync(apiKey); + return user; } - - return user; + catch + { + /* Do nothing */ + } + throw new KavitaException("User does not exist"); } private static FeedLink CreatePageStreamLink(int seriesId, int volumeId, int chapterId, MangaFile mangaFile, string apiKey) diff --git a/API/Controllers/PluginController.cs b/API/Controllers/PluginController.cs new file mode 100644 index 000000000..b176c0628 --- /dev/null +++ b/API/Controllers/PluginController.cs @@ -0,0 +1,45 @@ +using System.Threading.Tasks; +using API.DTOs; +using API.Interfaces; +using API.Interfaces.Services; +using Microsoft.AspNetCore.Mvc; +using Microsoft.Extensions.Logging; + +namespace API.Controllers +{ + public class PluginController : BaseApiController + { + private readonly IUnitOfWork _unitOfWork; + private readonly ITokenService _tokenService; + private readonly ILogger _logger; + + public PluginController(IUnitOfWork unitOfWork, ITokenService tokenService, ILogger logger) + { + _unitOfWork = unitOfWork; + _tokenService = tokenService; + _logger = logger; + } + + /// + /// Authenticate with the Server given an apiKey. This will log you in by returning the user object and the JWT token. + /// + /// + /// Name of the Plugin + /// + [HttpPost("authenticate")] + public async Task> Authenticate(string apiKey, string pluginName) + { + // NOTE: In order to log information about plugins, we need some Plugin Description information for each request + // Should log into access table so we can tell the user + var userId = await _unitOfWork.UserRepository.GetUserIdByApiKeyAsync(apiKey); + var user = await _unitOfWork.UserRepository.GetUserByIdAsync(userId); + _logger.LogInformation("Plugin {PluginName} has authenticated with {UserName} ({UserId})'s API Key", pluginName, user.UserName, userId); + return new UserDto + { + Username = user.UserName, + Token = await _tokenService.CreateToken(user), + ApiKey = user.ApiKey, + }; + } + } +} diff --git a/API/Controllers/ReaderController.cs b/API/Controllers/ReaderController.cs index 9b112e5da..d1314674e 100644 --- a/API/Controllers/ReaderController.cs +++ b/API/Controllers/ReaderController.cs @@ -3,7 +3,7 @@ using System.Collections.Generic; using System.IO; using System.Linq; using System.Threading.Tasks; -using API.Comparators; +using API.Data.Repositories; using API.DTOs; using API.DTOs.Reader; using API.Entities; @@ -20,20 +20,15 @@ namespace API.Controllers /// public class ReaderController : BaseApiController { - private readonly IDirectoryService _directoryService; private readonly ICacheService _cacheService; private readonly IUnitOfWork _unitOfWork; private readonly ILogger _logger; private readonly IReaderService _readerService; - private readonly ChapterSortComparer _chapterSortComparer = new ChapterSortComparer(); - private readonly ChapterSortComparerZeroFirst _chapterSortComparerForInChapterSorting = new ChapterSortComparerZeroFirst(); - private readonly NaturalSortComparer _naturalSortComparer = new NaturalSortComparer(); /// - public ReaderController(IDirectoryService directoryService, ICacheService cacheService, + public ReaderController(ICacheService cacheService, IUnitOfWork unitOfWork, ILogger logger, IReaderService readerService) { - _directoryService = directoryService; _cacheService = cacheService; _unitOfWork = unitOfWork; _logger = logger; @@ -49,7 +44,7 @@ namespace API.Controllers [HttpGet("image")] public async Task GetImage(int chapterId, int page) { - if (page < 0) return BadRequest("Page cannot be less than 0"); + if (page < 0) page = 0; var chapter = await _cacheService.Ensure(chapterId); if (chapter == null) return BadRequest("There was an issue finding image file for reading"); @@ -57,14 +52,9 @@ namespace API.Controllers { var (path, _) = await _cacheService.GetCachedPagePath(chapter, page); if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest($"No such image for page {page}"); - - var content = await _directoryService.ReadFileAsync(path); var format = Path.GetExtension(path).Replace(".", ""); - // Calculates SHA1 Hash for byte[] - Response.AddCacheHeader(content); - - return File(content, "image/" + format); + return PhysicalFile(path, "image/" + format, Path.GetFileName(path)); } catch (Exception) { @@ -76,30 +66,29 @@ namespace API.Controllers /// /// Returns various information about a Chapter. Side effect: This will cache the chapter images for reading. /// - /// /// /// [HttpGet("chapter-info")] - public async Task> GetChapterInfo(int seriesId, int chapterId) + public async Task> GetChapterInfo(int chapterId) { - // PERF: Write this in one DB call var chapter = await _cacheService.Ensure(chapterId); if (chapter == null) return BadRequest("Could not find Chapter"); - var volume = await _unitOfWork.SeriesRepository.GetVolumeDtoAsync(chapter.VolumeId); - if (volume == null) return BadRequest("Could not find Volume"); - var mangaFile = (await _unitOfWork.VolumeRepository.GetFilesForChapterAsync(chapterId)).First(); - var series = await _unitOfWork.SeriesRepository.GetSeriesByIdAsync(seriesId); + var dto = await _unitOfWork.ChapterRepository.GetChapterInfoDtoAsync(chapterId); + var mangaFile = (await _unitOfWork.ChapterRepository.GetFilesForChapterAsync(chapterId)).First(); return Ok(new ChapterInfoDto() { - ChapterNumber = chapter.Range, - VolumeNumber = volume.Number + string.Empty, - VolumeId = volume.Id, + ChapterNumber = dto.ChapterNumber, + VolumeNumber = dto.VolumeNumber, + VolumeId = dto.VolumeId, FileName = Path.GetFileName(mangaFile.FilePath), - SeriesName = series?.Name, - IsSpecial = chapter.IsSpecial, - Pages = chapter.Pages, + SeriesName = dto.SeriesName, + SeriesFormat = dto.SeriesFormat, + SeriesId = dto.SeriesId, + LibraryId = dto.LibraryId, + IsSpecial = dto.IsSpecial, + Pages = dto.Pages, }); } @@ -107,32 +96,12 @@ namespace API.Controllers [HttpPost("mark-read")] public async Task MarkRead(MarkReadDto markReadDto) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress); var volumes = await _unitOfWork.SeriesRepository.GetVolumes(markReadDto.SeriesId); user.Progresses ??= new List(); foreach (var volume in volumes) { - foreach (var chapter in volume.Chapters) - { - var userProgress = GetUserProgressForChapter(user, chapter); - - if (userProgress == null) - { - user.Progresses.Add(new AppUserProgress - { - PagesRead = chapter.Pages, - VolumeId = volume.Id, - SeriesId = markReadDto.SeriesId, - ChapterId = chapter.Id - }); - } - else - { - userProgress.PagesRead = chapter.Pages; - userProgress.SeriesId = markReadDto.SeriesId; - userProgress.VolumeId = volume.Id; - } - } + _readerService.MarkChaptersAsRead(user, markReadDto.SeriesId, volume.Chapters); } _unitOfWork.UserRepository.Update(user); @@ -146,47 +115,23 @@ namespace API.Controllers return BadRequest("There was an issue saving progress"); } - private static AppUserProgress GetUserProgressForChapter(AppUser user, Chapter chapter) - { - AppUserProgress userProgress = null; - try - { - userProgress = - user.Progresses.SingleOrDefault(x => x.ChapterId == chapter.Id && x.AppUserId == user.Id); - } - catch (Exception) - { - // There is a very rare chance that user progress will duplicate current row. If that happens delete one with less pages - var progresses = user.Progresses.Where(x => x.ChapterId == chapter.Id && x.AppUserId == user.Id).ToList(); - if (progresses.Count > 1) - { - user.Progresses = new List() - { - user.Progresses.First() - }; - userProgress = user.Progresses.First(); - } - } - - return userProgress; - } /// - /// Marks a Chapter as Unread (progress) + /// Marks a Series as Unread (progress) /// /// /// [HttpPost("mark-unread")] public async Task MarkUnread(MarkReadDto markReadDto) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress); var volumes = await _unitOfWork.SeriesRepository.GetVolumes(markReadDto.SeriesId); user.Progresses ??= new List(); foreach (var volume in volumes) { foreach (var chapter in volume.Chapters) { - var userProgress = GetUserProgressForChapter(user, chapter); + var userProgress = ReaderService.GetUserProgressForChapter(user, chapter); if (userProgress == null) continue; userProgress.PagesRead = 0; @@ -206,6 +151,29 @@ namespace API.Controllers return BadRequest("There was an issue saving progress"); } + /// + /// Marks all chapters within a volume as unread + /// + /// + /// + [HttpPost("mark-volume-unread")] + public async Task MarkVolumeAsUnread(MarkVolumeReadDto markVolumeReadDto) + { + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress); + + var chapters = await _unitOfWork.ChapterRepository.GetChaptersAsync(markVolumeReadDto.VolumeId); + _readerService.MarkChaptersAsUnread(user, markVolumeReadDto.SeriesId, chapters); + + _unitOfWork.UserRepository.Update(user); + + if (await _unitOfWork.CommitAsync()) + { + return Ok(); + } + + return BadRequest("Could not save progress"); + } + /// /// Marks all chapters within a volume as Read /// @@ -214,30 +182,122 @@ namespace API.Controllers [HttpPost("mark-volume-read")] public async Task MarkVolumeAsRead(MarkVolumeReadDto markVolumeReadDto) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress); - var chapters = await _unitOfWork.VolumeRepository.GetChaptersAsync(markVolumeReadDto.VolumeId); - foreach (var chapter in chapters) + var chapters = await _unitOfWork.ChapterRepository.GetChaptersAsync(markVolumeReadDto.VolumeId); + _readerService.MarkChaptersAsRead(user, markVolumeReadDto.SeriesId, chapters); + + _unitOfWork.UserRepository.Update(user); + + if (await _unitOfWork.CommitAsync()) { - user.Progresses ??= new List(); - var userProgress = user.Progresses.FirstOrDefault(x => x.ChapterId == chapter.Id && x.AppUserId == user.Id); + return Ok(); + } - if (userProgress == null) - { - user.Progresses.Add(new AppUserProgress - { - PagesRead = chapter.Pages, - VolumeId = markVolumeReadDto.VolumeId, - SeriesId = markVolumeReadDto.SeriesId, - ChapterId = chapter.Id - }); - } - else - { - userProgress.PagesRead = chapter.Pages; - userProgress.SeriesId = markVolumeReadDto.SeriesId; - userProgress.VolumeId = markVolumeReadDto.VolumeId; - } + return BadRequest("Could not save progress"); + } + + + /// + /// Marks all chapters within a list of volumes as Read. All volumes must belong to the same Series. + /// + /// + /// + [HttpPost("mark-multiple-read")] + public async Task MarkMultipleAsRead(MarkVolumesReadDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress); + user.Progresses ??= new List(); + + var chapterIds = await _unitOfWork.VolumeRepository.GetChapterIdsByVolumeIds(dto.VolumeIds); + foreach (var chapterId in dto.ChapterIds) + { + chapterIds.Add(chapterId); + } + var chapters = await _unitOfWork.ChapterRepository.GetChaptersByIdsAsync(chapterIds); + _readerService.MarkChaptersAsRead(user, dto.SeriesId, chapters); + + _unitOfWork.UserRepository.Update(user); + + if (await _unitOfWork.CommitAsync()) + { + return Ok(); + } + + return BadRequest("Could not save progress"); + } + + /// + /// Marks all chapters within a list of volumes as Unread. All volumes must belong to the same Series. + /// + /// + /// + [HttpPost("mark-multiple-unread")] + public async Task MarkMultipleAsUnread(MarkVolumesReadDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress); + user.Progresses ??= new List(); + + var chapterIds = await _unitOfWork.VolumeRepository.GetChapterIdsByVolumeIds(dto.VolumeIds); + foreach (var chapterId in dto.ChapterIds) + { + chapterIds.Add(chapterId); + } + var chapters = await _unitOfWork.ChapterRepository.GetChaptersByIdsAsync(chapterIds); + _readerService.MarkChaptersAsUnread(user, dto.SeriesId, chapters); + + _unitOfWork.UserRepository.Update(user); + + if (await _unitOfWork.CommitAsync()) + { + return Ok(); + } + + return BadRequest("Could not save progress"); + } + + /// + /// Marks all chapters within a list of series as Read. + /// + /// + /// + [HttpPost("mark-multiple-series-read")] + public async Task MarkMultipleSeriesAsRead(MarkMultipleSeriesAsReadDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress); + user.Progresses ??= new List(); + + var volumes = await _unitOfWork.SeriesRepository.GetVolumesForSeriesAsync(dto.SeriesIds.ToArray(), true); + foreach (var volume in volumes) + { + _readerService.MarkChaptersAsRead(user, volume.SeriesId, volume.Chapters); + } + + _unitOfWork.UserRepository.Update(user); + + if (await _unitOfWork.CommitAsync()) + { + return Ok(); + } + + return BadRequest("Could not save progress"); + } + + /// + /// Marks all chapters within a list of series as Unread. + /// + /// + /// + [HttpPost("mark-multiple-series-unread")] + public async Task MarkMultipleSeriesAsUnread(MarkMultipleSeriesAsReadDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress); + user.Progresses ??= new List(); + + var volumes = await _unitOfWork.SeriesRepository.GetVolumesForSeriesAsync(dto.SeriesIds.ToArray(), true); + foreach (var volume in volumes) + { + _readerService.MarkChaptersAsUnread(user, volume.SeriesId, volume.Chapters); } _unitOfWork.UserRepository.Update(user); @@ -258,7 +318,7 @@ namespace API.Controllers [HttpGet("get-progress")] public async Task> GetProgress(int chapterId) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress); var progressBookmark = new ProgressDto() { PageNum = 0, @@ -267,7 +327,7 @@ namespace API.Controllers SeriesId = 0 }; if (user.Progresses == null) return Ok(progressBookmark); - var progress = user.Progresses.SingleOrDefault(x => x.AppUserId == user.Id && x.ChapterId == chapterId); + var progress = user.Progresses.FirstOrDefault(x => x.AppUserId == user.Id && x.ChapterId == chapterId); if (progress != null) { @@ -288,7 +348,8 @@ namespace API.Controllers public async Task BookmarkProgress(ProgressDto progressDto) { var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); - if (await _readerService.SaveReadingProgress(progressDto, user)) return Ok(true); + + if (await _readerService.SaveReadingProgress(progressDto, user.Id)) return Ok(true); return BadRequest("Could not save progress"); } @@ -301,7 +362,7 @@ namespace API.Controllers [HttpGet("get-bookmarks")] public async Task>> GetBookmarks(int chapterId) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks); if (user.Bookmarks == null) return Ok(Array.Empty()); return Ok(await _unitOfWork.UserRepository.GetBookmarkDtosForChapter(user.Id, chapterId)); } @@ -313,7 +374,7 @@ namespace API.Controllers [HttpGet("get-all-bookmarks")] public async Task>> GetAllBookmarks() { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks); if (user.Bookmarks == null) return Ok(Array.Empty()); return Ok(await _unitOfWork.UserRepository.GetAllBookmarkDtos(user.Id)); } @@ -326,7 +387,7 @@ namespace API.Controllers [HttpPost("remove-bookmarks")] public async Task RemoveBookmarks(RemoveBookmarkForSeriesDto dto) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks); if (user.Bookmarks == null) return Ok("Nothing to remove"); try { @@ -356,7 +417,7 @@ namespace API.Controllers [HttpGet("get-volume-bookmarks")] public async Task>> GetBookmarksForVolume(int volumeId) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks); if (user.Bookmarks == null) return Ok(Array.Empty()); return Ok(await _unitOfWork.UserRepository.GetBookmarkDtosForVolume(user.Id, volumeId)); } @@ -369,7 +430,7 @@ namespace API.Controllers [HttpGet("get-series-bookmarks")] public async Task>> GetBookmarksForSeries(int seriesId) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks); if (user.Bookmarks == null) return Ok(Array.Empty()); return Ok(await _unitOfWork.UserRepository.GetBookmarkDtosForSeries(user.Id, seriesId)); @@ -383,45 +444,28 @@ namespace API.Controllers [HttpPost("bookmark")] public async Task BookmarkPage(BookmarkDto bookmarkDto) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); - // Don't let user save past total pages. - var chapter = await _unitOfWork.VolumeRepository.GetChapterAsync(bookmarkDto.ChapterId); - if (bookmarkDto.Page > chapter.Pages) - { - bookmarkDto.Page = chapter.Pages; - } - - if (bookmarkDto.Page < 0) - { - bookmarkDto.Page = 0; - } - + bookmarkDto.Page = await _readerService.CapPageToChapter(bookmarkDto.ChapterId, bookmarkDto.Page); try { - user.Bookmarks ??= new List(); - var userBookmark = - user.Bookmarks.SingleOrDefault(x => x.ChapterId == bookmarkDto.ChapterId && x.AppUserId == user.Id && x.Page == bookmarkDto.Page); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks); + var userBookmark = + await _unitOfWork.UserRepository.GetBookmarkForPage(bookmarkDto.Page, bookmarkDto.ChapterId, user.Id); if (userBookmark == null) { - user.Bookmarks.Add(new AppUserBookmark() - { - Page = bookmarkDto.Page, - VolumeId = bookmarkDto.VolumeId, - SeriesId = bookmarkDto.SeriesId, - ChapterId = bookmarkDto.ChapterId, - }); - } - else - { - userBookmark.Page = bookmarkDto.Page; - userBookmark.SeriesId = bookmarkDto.SeriesId; - userBookmark.VolumeId = bookmarkDto.VolumeId; + user.Bookmarks ??= new List(); + user.Bookmarks.Add(new AppUserBookmark() + { + Page = bookmarkDto.Page, + VolumeId = bookmarkDto.VolumeId, + SeriesId = bookmarkDto.SeriesId, + ChapterId = bookmarkDto.ChapterId, + }); + _unitOfWork.UserRepository.Update(user); } - _unitOfWork.UserRepository.Update(user); if (await _unitOfWork.CommitAsync()) { @@ -444,7 +488,7 @@ namespace API.Controllers [HttpPost("unbookmark")] public async Task UnBookmarkPage(BookmarkDto bookmarkDto) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks); if (user.Bookmarks == null) return Ok(); try { @@ -453,7 +497,6 @@ namespace API.Controllers && x.AppUserId == user.Id && x.Page != bookmarkDto.Page).ToList(); - _unitOfWork.UserRepository.Update(user); if (await _unitOfWork.CommitAsync()) @@ -482,58 +525,10 @@ namespace API.Controllers [HttpGet("next-chapter")] public async Task> GetNextChapter(int seriesId, int volumeId, int currentChapterId) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); - var volumes = await _unitOfWork.SeriesRepository.GetVolumesDtoAsync(seriesId, user.Id); - var currentVolume = await _unitOfWork.SeriesRepository.GetVolumeAsync(volumeId); - var currentChapter = await _unitOfWork.VolumeRepository.GetChapterAsync(currentChapterId); - if (currentVolume.Number == 0) - { - // Handle specials by sorting on their Filename aka Range - var chapterId = GetNextChapterId(currentVolume.Chapters.OrderBy(x => x.Range, _naturalSortComparer), currentChapter.Number); - if (chapterId > 0) return Ok(chapterId); - } - - foreach (var volume in volumes) - { - if (volume.Number == currentVolume.Number && volume.Chapters.Count > 1) - { - // Handle Chapters within current Volume - // In this case, i need 0 first because 0 represents a full volume file. - var chapterId = GetNextChapterId(currentVolume.Chapters.OrderBy(x => double.Parse(x.Number), _chapterSortComparerForInChapterSorting), currentChapter.Number); - if (chapterId > 0) return Ok(chapterId); - } - - if (volume.Number == currentVolume.Number + 1) - { - // Handle Chapters within next Volume - // ! When selecting the chapter for the next volume, we need to make sure a c0 comes before a c1+ - var chapters = volume.Chapters.OrderBy(x => double.Parse(x.Number), _chapterSortComparer).ToList(); - if (currentChapter.Number.Equals("0") && chapters.Last().Number.Equals("0")) - { - return chapters.Last().Id; - } - - return Ok(chapters.FirstOrDefault()?.Id); - } - } - return Ok(-1); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + return await _readerService.GetNextChapterIdAsync(seriesId, volumeId, currentChapterId, userId); } - private static int GetNextChapterId(IEnumerable chapters, string currentChapterNumber) - { - var next = false; - var chaptersList = chapters.ToList(); - foreach (var chapter in chaptersList) - { - if (next) - { - return chapter.Id; - } - if (currentChapterNumber.Equals(chapter.Number)) next = true; - } - - return -1; - } /// /// Returns the previous logical chapter from the series. @@ -548,30 +543,8 @@ namespace API.Controllers [HttpGet("prev-chapter")] public async Task> GetPreviousChapter(int seriesId, int volumeId, int currentChapterId) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); - var volumes = await _unitOfWork.SeriesRepository.GetVolumesDtoAsync(seriesId, user.Id); - var currentVolume = await _unitOfWork.SeriesRepository.GetVolumeAsync(volumeId); - var currentChapter = await _unitOfWork.VolumeRepository.GetChapterAsync(currentChapterId); - - if (currentVolume.Number == 0) - { - var chapterId = GetNextChapterId(currentVolume.Chapters.OrderBy(x => x.Range, _naturalSortComparer).Reverse(), currentChapter.Number); - if (chapterId > 0) return Ok(chapterId); - } - - foreach (var volume in volumes.Reverse()) - { - if (volume.Number == currentVolume.Number) - { - var chapterId = GetNextChapterId(currentVolume.Chapters.OrderBy(x => double.Parse(x.Number), _chapterSortComparerForInChapterSorting).Reverse(), currentChapter.Number); - if (chapterId > 0) return Ok(chapterId); - } - if (volume.Number == currentVolume.Number - 1) - { - return Ok(volume.Chapters.OrderBy(x => double.Parse(x.Number), _chapterSortComparerForInChapterSorting).LastOrDefault()?.Id); - } - } - return Ok(-1); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + return await _readerService.GetPrevChapterIdAsync(seriesId, volumeId, currentChapterId, userId); } } diff --git a/API/Controllers/ReadingListController.cs b/API/Controllers/ReadingListController.cs new file mode 100644 index 000000000..1f22263c7 --- /dev/null +++ b/API/Controllers/ReadingListController.cs @@ -0,0 +1,503 @@ +using System.Collections.Generic; +using System.Linq; +using System.Threading.Tasks; +using API.Comparators; +using API.DTOs.ReadingLists; +using API.Entities; +using API.Extensions; +using API.Helpers; +using API.Interfaces; +using Microsoft.AspNetCore.Mvc; + +namespace API.Controllers +{ + public class ReadingListController : BaseApiController + { + private readonly IUnitOfWork _unitOfWork; + private readonly ChapterSortComparerZeroFirst _chapterSortComparerForInChapterSorting = new ChapterSortComparerZeroFirst(); + + public ReadingListController(IUnitOfWork unitOfWork) + { + _unitOfWork = unitOfWork; + } + + /// + /// Fetches a single Reading List + /// + /// + /// + [HttpGet] + public async Task>> GetList(int readingListId) + { + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + return Ok(await _unitOfWork.ReadingListRepository.GetReadingListDtoByIdAsync(readingListId, userId)); + } + + /// + /// Returns reading lists (paginated) for a given user. + /// + /// Defaults to true + /// + [HttpPost("lists")] + public async Task>> GetListsForUser([FromQuery] UserParams userParams, [FromQuery] bool includePromoted = true) + { + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + var items = await _unitOfWork.ReadingListRepository.GetReadingListDtosForUserAsync(userId, includePromoted, + userParams); + Response.AddPaginationHeader(items.CurrentPage, items.PageSize, items.TotalCount, items.TotalPages); + + return Ok(items); + } + + /// + /// Fetches all reading list items for a given list including rich metadata around series, volume, chapters, and progress + /// + /// This call is expensive + /// + /// + [HttpGet("items")] + public async Task>> GetListForUser(int readingListId) + { + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + var items = await _unitOfWork.ReadingListRepository.GetReadingListItemDtosByIdAsync(readingListId, userId); + + return Ok(await _unitOfWork.ReadingListRepository.AddReadingProgressModifiers(userId, items.ToList())); + } + + /// + /// Updates an items position + /// + /// + /// + [HttpPost("update-position")] + public async Task UpdateListItemPosition(UpdateReadingListPosition dto) + { + // Make sure UI buffers events + var items = (await _unitOfWork.ReadingListRepository.GetReadingListItemsByIdAsync(dto.ReadingListId)).ToList(); + var item = items.Find(r => r.Id == dto.ReadingListItemId); + items.Remove(item); + items.Insert(dto.ToPosition, item); + + for (var i = 0; i < items.Count; i++) + { + items[i].Order = i; + } + + if (_unitOfWork.HasChanges() && await _unitOfWork.CommitAsync()) + { + return Ok("Updated"); + } + + return BadRequest("Couldn't update position"); + } + + /// + /// Deletes a list item from the list. Will reorder all item positions afterwards + /// + /// + /// + [HttpPost("delete-item")] + public async Task DeleteListItem(UpdateReadingListPosition dto) + { + var items = (await _unitOfWork.ReadingListRepository.GetReadingListItemsByIdAsync(dto.ReadingListId)).ToList(); + var item = items.Find(r => r.Id == dto.ReadingListItemId); + items.Remove(item); + + for (var i = 0; i < items.Count; i++) + { + items[i].Order = i; + } + + if (_unitOfWork.HasChanges() && await _unitOfWork.CommitAsync()) + { + return Ok("Updated"); + } + + return BadRequest("Couldn't delete item"); + } + + /// + /// Removes all entries that are fully read from the reading list + /// + /// + /// + [HttpPost("remove-read")] + public async Task DeleteReadFromList([FromQuery] int readingListId) + { + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + var items = await _unitOfWork.ReadingListRepository.GetReadingListItemDtosByIdAsync(readingListId, userId); + items = await _unitOfWork.ReadingListRepository.AddReadingProgressModifiers(userId, items.ToList()); + + // Collect all Ids to remove + var itemIdsToRemove = items.Where(item => item.PagesRead == item.PagesTotal).Select(item => item.Id); + + try + { + var listItems = + (await _unitOfWork.ReadingListRepository.GetReadingListItemsByIdAsync(readingListId)).Where(r => + itemIdsToRemove.Contains(r.Id)); + _unitOfWork.ReadingListRepository.BulkRemove(listItems); + + if (_unitOfWork.HasChanges()) + { + await _unitOfWork.CommitAsync(); + return Ok("Updated"); + } + else + { + return Ok("Nothing to remove"); + } + } + catch + { + await _unitOfWork.RollbackAsync(); + } + + return BadRequest("Could not remove read items"); + } + + /// + /// Deletes a reading list + /// + /// + /// + [HttpDelete] + public async Task DeleteList([FromQuery] int readingListId) + { + var user = await _unitOfWork.UserRepository.GetUserWithReadingListsByUsernameAsync(User.GetUsername()); + var readingList = user.ReadingLists.SingleOrDefault(r => r.Id == readingListId); + if (readingList == null) + { + return BadRequest("User is not associated with this reading list"); + } + + user.ReadingLists.Remove(readingList); + + if (_unitOfWork.HasChanges() && await _unitOfWork.CommitAsync()) + { + return Ok("Deleted"); + } + + return BadRequest("There was an issue deleting reading list"); + } + + /// + /// Creates a new List with a unique title. Returns the new ReadingList back + /// + /// + /// + [HttpPost("create")] + public async Task> CreateList(CreateReadingListDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserWithReadingListsByUsernameAsync(User.GetUsername()); + + // When creating, we need to make sure Title is unique + var hasExisting = user.ReadingLists.Any(l => l.Title.Equals(dto.Title)); + if (hasExisting) + { + return BadRequest("A list of this name already exists"); + } + user.ReadingLists.Add(new ReadingList() + { + Promoted = false, + Title = dto.Title, + Summary = string.Empty + }); + + if (!_unitOfWork.HasChanges()) return BadRequest("There was a problem creating list"); + + await _unitOfWork.CommitAsync(); + + return Ok(await _unitOfWork.ReadingListRepository.GetReadingListDtoByTitleAsync(dto.Title)); + } + + /// + /// Update the properites (title, summary) of a reading list + /// + /// + /// + [HttpPost("update")] + public async Task UpdateList(UpdateReadingListDto dto) + { + var readingList = await _unitOfWork.ReadingListRepository.GetReadingListByIdAsync(dto.ReadingListId); + if (readingList == null) return BadRequest("List does not exist"); + + if (!string.IsNullOrEmpty(dto.Title)) + { + readingList.Title = dto.Title; // Should I check if this is unique? + } + if (!string.IsNullOrEmpty(dto.Title)) + { + readingList.Summary = dto.Summary; + } + + readingList.Promoted = dto.Promoted; + + _unitOfWork.ReadingListRepository.Update(readingList); + + if (await _unitOfWork.CommitAsync()) + { + return Ok("Updated"); + } + return BadRequest("Could not update reading list"); + } + + /// + /// Adds all chapters from a Series to a reading list + /// + /// + /// + [HttpPost("update-by-series")] + public async Task UpdateListBySeries(UpdateReadingListBySeriesDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserWithReadingListsByUsernameAsync(User.GetUsername()); + var readingList = user.ReadingLists.SingleOrDefault(l => l.Id == dto.ReadingListId); + if (readingList == null) return BadRequest("Reading List does not exist"); + var chapterIdsForSeries = + await _unitOfWork.SeriesRepository.GetChapterIdsForSeriesAsync(new [] {dto.SeriesId}); + + // If there are adds, tell tracking this has been modified + if (await AddChaptersToReadingList(dto.SeriesId, chapterIdsForSeries, readingList)) + { + _unitOfWork.ReadingListRepository.Update(readingList); + } + + try + { + if (_unitOfWork.HasChanges()) + { + await _unitOfWork.CommitAsync(); + return Ok("Updated"); + } + } + catch + { + await _unitOfWork.RollbackAsync(); + } + + return Ok("Nothing to do"); + } + + + /// + /// Adds all chapters from a list of volumes and chapters to a reading list + /// + /// + /// + [HttpPost("update-by-multiple")] + public async Task UpdateListByMultiple(UpdateReadingListByMultipleDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserWithReadingListsByUsernameAsync(User.GetUsername()); + var readingList = user.ReadingLists.SingleOrDefault(l => l.Id == dto.ReadingListId); + if (readingList == null) return BadRequest("Reading List does not exist"); + + var chapterIds = await _unitOfWork.VolumeRepository.GetChapterIdsByVolumeIds(dto.VolumeIds); + foreach (var chapterId in dto.ChapterIds) + { + chapterIds.Add(chapterId); + } + + // If there are adds, tell tracking this has been modified + if (await AddChaptersToReadingList(dto.SeriesId, chapterIds, readingList)) + { + _unitOfWork.ReadingListRepository.Update(readingList); + } + + try + { + if (_unitOfWork.HasChanges()) + { + await _unitOfWork.CommitAsync(); + return Ok("Updated"); + } + } + catch + { + await _unitOfWork.RollbackAsync(); + } + + return Ok("Nothing to do"); + } + + /// + /// Adds all chapters from a list of series to a reading list + /// + /// + /// + [HttpPost("update-by-multiple-series")] + public async Task UpdateListByMultipleSeries(UpdateReadingListByMultipleSeriesDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserWithReadingListsByUsernameAsync(User.GetUsername()); + var readingList = user.ReadingLists.SingleOrDefault(l => l.Id == dto.ReadingListId); + if (readingList == null) return BadRequest("Reading List does not exist"); + + var ids = await _unitOfWork.SeriesRepository.GetChapterIdWithSeriesIdForSeriesAsync(dto.SeriesIds.ToArray()); + + foreach (var seriesId in ids.Keys) + { + // If there are adds, tell tracking this has been modified + if (await AddChaptersToReadingList(seriesId, ids[seriesId], readingList)) + { + _unitOfWork.ReadingListRepository.Update(readingList); + } + } + + try + { + if (_unitOfWork.HasChanges()) + { + await _unitOfWork.CommitAsync(); + return Ok("Updated"); + } + } + catch + { + await _unitOfWork.RollbackAsync(); + } + + return Ok("Nothing to do"); + } + + [HttpPost("update-by-volume")] + public async Task UpdateListByVolume(UpdateReadingListByVolumeDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserWithReadingListsByUsernameAsync(User.GetUsername()); + var readingList = user.ReadingLists.SingleOrDefault(l => l.Id == dto.ReadingListId); + if (readingList == null) return BadRequest("Reading List does not exist"); + var chapterIdsForVolume = + (await _unitOfWork.ChapterRepository.GetChaptersAsync(dto.VolumeId)).Select(c => c.Id).ToList(); + + // If there are adds, tell tracking this has been modified + if (await AddChaptersToReadingList(dto.SeriesId, chapterIdsForVolume, readingList)) + { + _unitOfWork.ReadingListRepository.Update(readingList); + } + + try + { + if (_unitOfWork.HasChanges()) + { + await _unitOfWork.CommitAsync(); + return Ok("Updated"); + } + } + catch + { + await _unitOfWork.RollbackAsync(); + } + + return Ok("Nothing to do"); + } + + [HttpPost("update-by-chapter")] + public async Task UpdateListByChapter(UpdateReadingListByChapterDto dto) + { + var user = await _unitOfWork.UserRepository.GetUserWithReadingListsByUsernameAsync(User.GetUsername()); + var readingList = user.ReadingLists.SingleOrDefault(l => l.Id == dto.ReadingListId); + if (readingList == null) return BadRequest("Reading List does not exist"); + + // If there are adds, tell tracking this has been modified + if (await AddChaptersToReadingList(dto.SeriesId, new List() { dto.ChapterId }, readingList)) + { + _unitOfWork.ReadingListRepository.Update(readingList); + } + + try + { + if (_unitOfWork.HasChanges()) + { + await _unitOfWork.CommitAsync(); + return Ok("Updated"); + } + } + catch + { + await _unitOfWork.RollbackAsync(); + } + + return Ok("Nothing to do"); + } + + /// + /// Adds a list of Chapters as reading list items to the passed reading list. + /// + /// + /// + /// + /// True if new chapters were added + private async Task AddChaptersToReadingList(int seriesId, IList chapterIds, + ReadingList readingList) + { + readingList.Items ??= new List(); + var lastOrder = 0; + if (readingList.Items.Any()) + { + lastOrder = readingList.Items.DefaultIfEmpty().Max(rli => rli.Order); + } + + var existingChapterExists = readingList.Items.Select(rli => rli.ChapterId).ToHashSet(); + var chaptersForSeries = (await _unitOfWork.ChapterRepository.GetChaptersByIdsAsync(chapterIds)) + .OrderBy(c => int.Parse(c.Volume.Name)) + .ThenBy(x => double.Parse(x.Number), _chapterSortComparerForInChapterSorting); + + var index = lastOrder + 1; + foreach (var chapter in chaptersForSeries) + { + if (existingChapterExists.Contains(chapter.Id)) continue; + + readingList.Items.Add(new ReadingListItem() + { + Order = index, + ChapterId = chapter.Id, + SeriesId = seriesId, + VolumeId = chapter.VolumeId + }); + index += 1; + } + + return index > lastOrder + 1; + } + + /// + /// Returns the next chapter within the reading list + /// + /// + /// + /// Chapter Id for next item, -1 if nothing exists + [HttpGet("next-chapter")] + public async Task> GetNextChapter(int currentChapterId, int readingListId) + { + var items = (await _unitOfWork.ReadingListRepository.GetReadingListItemsByIdAsync(readingListId)).ToList(); + var readingListItem = items.SingleOrDefault(rl => rl.ChapterId == currentChapterId); + if (readingListItem == null) return BadRequest("Id does not exist"); + var index = items.IndexOf(readingListItem) + 1; + if (items.Count > index) + { + return items[index].ChapterId; + } + + return Ok(-1); + } + + /// + /// Returns the prev chapter within the reading list + /// + /// + /// + /// Chapter Id for next item, -1 if nothing exists + [HttpGet("prev-chapter")] + public async Task> GetPrevChapter(int currentChapterId, int readingListId) + { + var items = (await _unitOfWork.ReadingListRepository.GetReadingListItemsByIdAsync(readingListId)).ToList(); + var readingListItem = items.SingleOrDefault(rl => rl.ChapterId == currentChapterId); + if (readingListItem == null) return BadRequest("Id does not exist"); + var index = items.IndexOf(readingListItem) - 1; + if (0 <= index) + { + return items[index].ChapterId; + } + + return Ok(-1); + } + } +} diff --git a/API/Controllers/SeriesController.cs b/API/Controllers/SeriesController.cs index cce70de6d..ff0fa7587 100644 --- a/API/Controllers/SeriesController.cs +++ b/API/Controllers/SeriesController.cs @@ -3,6 +3,7 @@ using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using API.Data; +using API.Data.Repositories; using API.DTOs; using API.DTOs.Filtering; using API.Entities; @@ -32,14 +33,14 @@ namespace API.Controllers [HttpPost] public async Task>> GetSeriesForLibrary(int libraryId, [FromQuery] UserParams userParams, [FromBody] FilterDto filterDto) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); var series = - await _unitOfWork.SeriesRepository.GetSeriesDtoForLibraryIdAsync(libraryId, user.Id, userParams, filterDto); + await _unitOfWork.SeriesRepository.GetSeriesDtoForLibraryIdAsync(libraryId, userId, userParams, filterDto); // Apply progress/rating information (I can't work out how to do this in initial query) if (series == null) return BadRequest("Could not get series for library"); - await _unitOfWork.SeriesRepository.AddSeriesModifiers(user.Id, series); + await _unitOfWork.SeriesRepository.AddSeriesModifiers(userId, series); Response.AddPaginationHeader(series.CurrentPage, series.PageSize, series.TotalCount, series.TotalPages); @@ -55,10 +56,10 @@ namespace API.Controllers [HttpGet("{seriesId}")] public async Task> GetSeries(int seriesId) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); try { - return Ok(await _unitOfWork.SeriesRepository.GetSeriesDtoByIdAsync(seriesId, user.Id)); + return Ok(await _unitOfWork.SeriesRepository.GetSeriesDtoByIdAsync(seriesId, userId)); } catch (Exception e) { @@ -95,30 +96,28 @@ namespace API.Controllers [HttpGet("volumes")] public async Task>> GetVolumes(int seriesId) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); - return Ok(await _unitOfWork.SeriesRepository.GetVolumesDtoAsync(seriesId, user.Id)); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + return Ok(await _unitOfWork.SeriesRepository.GetVolumesDtoAsync(seriesId, userId)); } [HttpGet("volume")] public async Task> GetVolume(int volumeId) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); - return Ok(await _unitOfWork.SeriesRepository.GetVolumeDtoAsync(volumeId, user.Id)); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + return Ok(await _unitOfWork.SeriesRepository.GetVolumeDtoAsync(volumeId, userId)); } [HttpGet("chapter")] public async Task> GetChapter(int chapterId) { - return Ok(await _unitOfWork.VolumeRepository.GetChapterDtoAsync(chapterId)); + return Ok(await _unitOfWork.ChapterRepository.GetChapterDtoAsync(chapterId)); } - - [HttpPost("update-rating")] public async Task UpdateSeriesRating(UpdateSeriesRatingDto updateSeriesRatingDto) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Ratings); var userRating = await _unitOfWork.UserRepository.GetUserRating(updateSeriesRatingDto.SeriesId, user.Id) ?? new AppUserRating(); @@ -158,10 +157,12 @@ namespace API.Controllers series.Summary = updateSeries.Summary?.Trim(); var needsRefreshMetadata = false; + // This is when you hit Reset if (series.CoverImageLocked && !updateSeries.CoverImageLocked) { // Trigger a refresh when we are moving from a locked image to a non-locked needsRefreshMetadata = true; + series.CoverImage = string.Empty; series.CoverImageLocked = updateSeries.CoverImageLocked; } @@ -182,14 +183,14 @@ namespace API.Controllers [HttpPost("recently-added")] public async Task>> GetRecentlyAdded(FilterDto filterDto, [FromQuery] UserParams userParams, [FromQuery] int libraryId = 0) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); var series = - await _unitOfWork.SeriesRepository.GetRecentlyAdded(libraryId, user.Id, userParams, filterDto); + await _unitOfWork.SeriesRepository.GetRecentlyAdded(libraryId, userId, userParams, filterDto); // Apply progress/rating information (I can't work out how to do this in initial query) if (series == null) return BadRequest("Could not get series"); - await _unitOfWork.SeriesRepository.AddSeriesModifiers(user.Id, series); + await _unitOfWork.SeriesRepository.AddSeriesModifiers(userId, series); Response.AddPaginationHeader(series.CurrentPage, series.PageSize, series.TotalCount, series.TotalPages); @@ -200,8 +201,8 @@ namespace API.Controllers public async Task>> GetInProgress(FilterDto filterDto, [FromQuery] UserParams userParams, [FromQuery] int libraryId = 0) { // NOTE: This has to be done manually like this due to the DistinctBy requirement - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); - var results = await _unitOfWork.SeriesRepository.GetInProgress(user.Id, libraryId, userParams, filterDto); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + var results = await _unitOfWork.SeriesRepository.GetInProgress(userId, libraryId, userParams, filterDto); var listResults = results.DistinctBy(s => s.Name).Skip((userParams.PageNumber - 1) * userParams.PageSize) .Take(userParams.PageSize).ToList(); @@ -316,14 +317,14 @@ namespace API.Controllers [HttpGet("series-by-collection")] public async Task>> GetSeriesByCollectionTag(int collectionId, [FromQuery] UserParams userParams) { - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); var series = - await _unitOfWork.SeriesRepository.GetSeriesDtoForCollectionAsync(collectionId, user.Id, userParams); + await _unitOfWork.SeriesRepository.GetSeriesDtoForCollectionAsync(collectionId, userId, userParams); // Apply progress/rating information (I can't work out how to do this in initial query) if (series == null) return BadRequest("Could not get series for collection"); - await _unitOfWork.SeriesRepository.AddSeriesModifiers(user.Id, series); + await _unitOfWork.SeriesRepository.AddSeriesModifiers(userId, series); Response.AddPaginationHeader(series.CurrentPage, series.PageSize, series.TotalCount, series.TotalPages); @@ -339,8 +340,8 @@ namespace API.Controllers public async Task>> GetAllSeriesById(SeriesByIdsDto dto) { if (dto.SeriesIds == null) return BadRequest("Must pass seriesIds"); - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); - return Ok(await _unitOfWork.SeriesRepository.GetSeriesDtoForIdsAsync(dto.SeriesIds, user.Id)); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + return Ok(await _unitOfWork.SeriesRepository.GetSeriesDtoForIdsAsync(dto.SeriesIds, userId)); } diff --git a/API/Controllers/SettingsController.cs b/API/Controllers/SettingsController.cs index 4d81eb22d..acd1b61e8 100644 --- a/API/Controllers/SettingsController.cs +++ b/API/Controllers/SettingsController.cs @@ -103,7 +103,7 @@ namespace API.Controllers } else { - _taskScheduler.ScheduleStatsTasks(); + await _taskScheduler.ScheduleStatsTasks(); } } } diff --git a/API/Controllers/UploadController.cs b/API/Controllers/UploadController.cs index 0d924c66d..4241a8bc6 100644 --- a/API/Controllers/UploadController.cs +++ b/API/Controllers/UploadController.cs @@ -3,9 +3,11 @@ using System.Threading.Tasks; using API.DTOs.Uploads; using API.Interfaces; using API.Interfaces.Services; +using API.Services; using Microsoft.AspNetCore.Authorization; using Microsoft.AspNetCore.Mvc; using Microsoft.Extensions.Logging; +using NetVips; namespace API.Controllers { @@ -48,12 +50,12 @@ namespace API.Controllers try { - var bytes = _imageService.CreateThumbnailFromBase64(uploadFileDto.Url); + var filePath = _imageService.CreateThumbnailFromBase64(uploadFileDto.Url, ImageService.GetSeriesFormat(uploadFileDto.Id)); var series = await _unitOfWork.SeriesRepository.GetSeriesByIdAsync(uploadFileDto.Id); - if (bytes.Length > 0) + if (!string.IsNullOrEmpty(filePath)) { - series.CoverImage = bytes; + series.CoverImage = filePath; series.CoverImageLocked = true; _unitOfWork.SeriesRepository.Update(series); } @@ -93,12 +95,12 @@ namespace API.Controllers try { - var bytes = _imageService.CreateThumbnailFromBase64(uploadFileDto.Url); + var filePath = _imageService.CreateThumbnailFromBase64(uploadFileDto.Url, $"{ImageService.GetCollectionTagFormat(uploadFileDto.Id)}"); var tag = await _unitOfWork.CollectionTagRepository.GetTagAsync(uploadFileDto.Id); - if (bytes.Length > 0) + if (!string.IsNullOrEmpty(filePath)) { - tag.CoverImage = bytes; + tag.CoverImage = filePath; tag.CoverImageLocked = true; _unitOfWork.CollectionTagRepository.Update(tag); } @@ -138,12 +140,12 @@ namespace API.Controllers try { - var bytes = _imageService.CreateThumbnailFromBase64(uploadFileDto.Url); + var chapter = await _unitOfWork.ChapterRepository.GetChapterAsync(uploadFileDto.Id); + var filePath = _imageService.CreateThumbnailFromBase64(uploadFileDto.Url, $"{ImageService.GetChapterFormat(uploadFileDto.Id, chapter.VolumeId)}"); - if (bytes.Length > 0) + if (!string.IsNullOrEmpty(filePath)) { - var chapter = await _unitOfWork.VolumeRepository.GetChapterAsync(uploadFileDto.Id); - chapter.CoverImage = bytes; + chapter.CoverImage = filePath; chapter.CoverImageLocked = true; _unitOfWork.ChapterRepository.Update(chapter); var volume = await _unitOfWork.SeriesRepository.GetVolumeAsync(chapter.VolumeId); @@ -178,8 +180,9 @@ namespace API.Controllers { try { - var chapter = await _unitOfWork.VolumeRepository.GetChapterAsync(uploadFileDto.Id); - chapter.CoverImage = Array.Empty(); + var chapter = await _unitOfWork.ChapterRepository.GetChapterAsync(uploadFileDto.Id); + var originalFile = chapter.CoverImage; + chapter.CoverImage = string.Empty; chapter.CoverImageLocked = false; _unitOfWork.ChapterRepository.Update(chapter); var volume = await _unitOfWork.SeriesRepository.GetVolumeAsync(chapter.VolumeId); @@ -190,7 +193,8 @@ namespace API.Controllers if (_unitOfWork.HasChanges()) { await _unitOfWork.CommitAsync(); - _taskScheduler.RefreshSeriesMetadata(series.LibraryId, series.Id); + System.IO.File.Delete(originalFile); + _taskScheduler.RefreshSeriesMetadata(series.LibraryId, series.Id, true); return Ok(); } diff --git a/API/Controllers/UsersController.cs b/API/Controllers/UsersController.cs index ee4c9ac66..c35e368cc 100644 --- a/API/Controllers/UsersController.cs +++ b/API/Controllers/UsersController.cs @@ -18,7 +18,7 @@ namespace API.Controllers { _unitOfWork = unitOfWork; } - + [Authorize(Policy = "RequireAdminRole")] [HttpDelete("delete-user")] public async Task DeleteUser(string username) @@ -30,7 +30,7 @@ namespace API.Controllers return BadRequest("Could not delete the user."); } - + [Authorize(Policy = "RequireAdminRole")] [HttpGet] public async Task>> GetUsers() @@ -42,8 +42,8 @@ namespace API.Controllers public async Task> HasReadingProgress(int libraryId) { var library = await _unitOfWork.LibraryRepository.GetLibraryForIdAsync(libraryId); - var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername()); - return Ok(await _unitOfWork.AppUserProgressRepository.UserHasProgress(library.Type, user.Id)); + var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); + return Ok(await _unitOfWork.AppUserProgressRepository.UserHasProgress(library.Type, userId)); } [HttpGet("has-library-access")] @@ -77,8 +77,8 @@ namespace API.Controllers { return Ok(preferencesDto); } - + return BadRequest("There was an issue saving preferences."); } } -} \ No newline at end of file +} diff --git a/API/DTOs/LoginDto.cs b/API/DTOs/Account/LoginDto.cs similarity index 100% rename from API/DTOs/LoginDto.cs rename to API/DTOs/Account/LoginDto.cs diff --git a/API/DTOs/ResetPasswordDto.cs b/API/DTOs/Account/ResetPasswordDto.cs similarity index 90% rename from API/DTOs/ResetPasswordDto.cs rename to API/DTOs/Account/ResetPasswordDto.cs index 4b3ee3580..2e7ef4d66 100644 --- a/API/DTOs/ResetPasswordDto.cs +++ b/API/DTOs/Account/ResetPasswordDto.cs @@ -1,6 +1,6 @@ using System.ComponentModel.DataAnnotations; -namespace API.DTOs +namespace API.DTOs.Account { public class ResetPasswordDto { @@ -10,4 +10,4 @@ namespace API.DTOs [StringLength(32, MinimumLength = 6)] public string Password { get; init; } } -} \ No newline at end of file +} diff --git a/API/DTOs/Downloads/DownloadBookmarkDto.cs b/API/DTOs/Downloads/DownloadBookmarkDto.cs index 5239b4aae..b7ccf9569 100644 --- a/API/DTOs/Downloads/DownloadBookmarkDto.cs +++ b/API/DTOs/Downloads/DownloadBookmarkDto.cs @@ -1,4 +1,5 @@ using System.Collections.Generic; +using API.DTOs.Reader; namespace API.DTOs.Downloads { diff --git a/API/DTOs/ImageDto.cs b/API/DTOs/ImageDto.cs deleted file mode 100644 index e66591001..000000000 --- a/API/DTOs/ImageDto.cs +++ /dev/null @@ -1,15 +0,0 @@ -namespace API.DTOs -{ - public class ImageDto - { - public int Page { get; init; } - public string Filename { get; init; } - public string FullPath { get; init; } - public int Width { get; init; } - public int Height { get; init; } - public string Format { get; init; } - public byte[] Content { get; init; } - public string MangaFileName { get; init; } - public bool NeedsSplitting { get; init; } - } -} \ No newline at end of file diff --git a/API/DTOs/InProgressChapterDto.cs b/API/DTOs/InProgressChapterDto.cs deleted file mode 100644 index 08bce3fc6..000000000 --- a/API/DTOs/InProgressChapterDto.cs +++ /dev/null @@ -1,24 +0,0 @@ -namespace API.DTOs -{ - public class InProgressChapterDto - { - public int Id { get; init; } - /// - /// Range of chapters. Chapter 2-4 -> "2-4". Chapter 2 -> "2". - /// - public string Range { get; init; } - /// - /// Smallest number of the Range. - /// - public string Number { get; init; } - /// - /// Total number of pages in all MangaFiles - /// - public int Pages { get; init; } - public int SeriesId { get; init; } - public int LibraryId { get; init; } - public string SeriesName { get; init; } - public int VolumeId { get; init; } - - } -} \ No newline at end of file diff --git a/API/DTOs/Reader/BookInfoDto.cs b/API/DTOs/Reader/BookInfoDto.cs new file mode 100644 index 000000000..6705c9647 --- /dev/null +++ b/API/DTOs/Reader/BookInfoDto.cs @@ -0,0 +1,18 @@ +using API.Entities.Enums; + +namespace API.DTOs.Reader +{ + public class BookInfoDto : IChapterInfoDto + { + public string BookTitle { get; set; } + public int SeriesId { get; set; } + public int VolumeId { get; set; } + public MangaFormat SeriesFormat { get; set; } + public string SeriesName { get; set; } + public string ChapterNumber { get; set; } + public string VolumeNumber { get; set; } + public int LibraryId { get; set; } + public int Pages { get; set; } + public bool IsSpecial { get; set; } + } +} diff --git a/API/DTOs/BookmarkDto.cs b/API/DTOs/Reader/BookmarkDto.cs similarity index 89% rename from API/DTOs/BookmarkDto.cs rename to API/DTOs/Reader/BookmarkDto.cs index c45a183c3..3653bcaa0 100644 --- a/API/DTOs/BookmarkDto.cs +++ b/API/DTOs/Reader/BookmarkDto.cs @@ -1,4 +1,4 @@ -namespace API.DTOs +namespace API.DTOs.Reader { public class BookmarkDto { diff --git a/API/DTOs/Reader/ChapterInfoDto.cs b/API/DTOs/Reader/ChapterInfoDto.cs index 850149016..ec512670d 100644 --- a/API/DTOs/Reader/ChapterInfoDto.cs +++ b/API/DTOs/Reader/ChapterInfoDto.cs @@ -1,16 +1,21 @@ -namespace API.DTOs.Reader +using API.Entities.Enums; + +namespace API.DTOs.Reader { - public class ChapterInfoDto + public class ChapterInfoDto : IChapterInfoDto { - + public string ChapterNumber { get; set; } public string VolumeNumber { get; set; } public int VolumeId { get; set; } public string SeriesName { get; set; } + public MangaFormat SeriesFormat { get; set; } + public int SeriesId { get; set; } + public int LibraryId { get; set; } public string ChapterTitle { get; set; } = ""; public int Pages { get; set; } public string FileName { get; set; } public bool IsSpecial { get; set; } - + } -} \ No newline at end of file +} diff --git a/API/DTOs/Reader/IChapterInfoDto.cs b/API/DTOs/Reader/IChapterInfoDto.cs new file mode 100644 index 000000000..63b5c9a62 --- /dev/null +++ b/API/DTOs/Reader/IChapterInfoDto.cs @@ -0,0 +1,19 @@ +using API.Entities.Enums; +using Newtonsoft.Json; + +namespace API.DTOs.Reader +{ + public interface IChapterInfoDto + { + public int SeriesId { get; set; } + public int VolumeId { get; set; } + public MangaFormat SeriesFormat { get; set; } + public string SeriesName { get; set; } + public string ChapterNumber { get; set; } + public string VolumeNumber { get; set; } + public int LibraryId { get; set; } + public int Pages { get; set; } + public bool IsSpecial { get; set; } + + } +} diff --git a/API/DTOs/Reader/MarkMultipleSeriesAsReadDto.cs b/API/DTOs/Reader/MarkMultipleSeriesAsReadDto.cs new file mode 100644 index 000000000..7201658fa --- /dev/null +++ b/API/DTOs/Reader/MarkMultipleSeriesAsReadDto.cs @@ -0,0 +1,9 @@ +using System.Collections.Generic; + +namespace API.DTOs.Reader +{ + public class MarkMultipleSeriesAsReadDto + { + public IReadOnlyList SeriesIds { get; init; } + } +} diff --git a/API/DTOs/MarkReadDto.cs b/API/DTOs/Reader/MarkReadDto.cs similarity index 73% rename from API/DTOs/MarkReadDto.cs rename to API/DTOs/Reader/MarkReadDto.cs index 1b39df2a8..3d94e3a9d 100644 --- a/API/DTOs/MarkReadDto.cs +++ b/API/DTOs/Reader/MarkReadDto.cs @@ -1,7 +1,7 @@ -namespace API.DTOs +namespace API.DTOs.Reader { public class MarkReadDto { public int SeriesId { get; init; } } -} \ No newline at end of file +} diff --git a/API/DTOs/MarkVolumeReadDto.cs b/API/DTOs/Reader/MarkVolumeReadDto.cs similarity index 81% rename from API/DTOs/MarkVolumeReadDto.cs rename to API/DTOs/Reader/MarkVolumeReadDto.cs index ffae155a2..757f23aee 100644 --- a/API/DTOs/MarkVolumeReadDto.cs +++ b/API/DTOs/Reader/MarkVolumeReadDto.cs @@ -1,8 +1,8 @@ -namespace API.DTOs +namespace API.DTOs.Reader { public class MarkVolumeReadDto { public int SeriesId { get; init; } public int VolumeId { get; init; } } -} \ No newline at end of file +} diff --git a/API/DTOs/Reader/MarkVolumesReadDto.cs b/API/DTOs/Reader/MarkVolumesReadDto.cs new file mode 100644 index 000000000..7e23e721a --- /dev/null +++ b/API/DTOs/Reader/MarkVolumesReadDto.cs @@ -0,0 +1,20 @@ +using System.Collections.Generic; + +namespace API.DTOs.Reader +{ + /// + /// This is used for bulk updating a set of volume and or chapters in one go + /// + public class MarkVolumesReadDto + { + public int SeriesId { get; set; } + /// + /// A list of Volumes to mark read + /// + public IReadOnlyList VolumeIds { get; set; } + /// + /// A list of additional Chapters to mark as read + /// + public IReadOnlyList ChapterIds { get; set; } + } +} diff --git a/API/DTOs/RemoveBookmarkForSeriesDto.cs b/API/DTOs/Reader/RemoveBookmarkForSeriesDto.cs similarity index 78% rename from API/DTOs/RemoveBookmarkForSeriesDto.cs rename to API/DTOs/Reader/RemoveBookmarkForSeriesDto.cs index 7ec76b081..a269b7095 100644 --- a/API/DTOs/RemoveBookmarkForSeriesDto.cs +++ b/API/DTOs/Reader/RemoveBookmarkForSeriesDto.cs @@ -1,4 +1,4 @@ -namespace API.DTOs +namespace API.DTOs.Reader { public class RemoveBookmarkForSeriesDto { diff --git a/API/DTOs/ReadingLists/CreateReadingListDto.cs b/API/DTOs/ReadingLists/CreateReadingListDto.cs new file mode 100644 index 000000000..c32b62bea --- /dev/null +++ b/API/DTOs/ReadingLists/CreateReadingListDto.cs @@ -0,0 +1,7 @@ +namespace API.DTOs.ReadingLists +{ + public class CreateReadingListDto + { + public string Title { get; init; } + } +} diff --git a/API/DTOs/ReadingLists/ReadingListDto.cs b/API/DTOs/ReadingLists/ReadingListDto.cs new file mode 100644 index 000000000..e3837a2e3 --- /dev/null +++ b/API/DTOs/ReadingLists/ReadingListDto.cs @@ -0,0 +1,13 @@ +namespace API.DTOs.ReadingLists +{ + public class ReadingListDto + { + public int Id { get; init; } + public string Title { get; set; } + public string Summary { get; set; } + /// + /// Reading lists that are promoted are only done by admins + /// + public bool Promoted { get; set; } + } +} diff --git a/API/DTOs/ReadingLists/ReadingListItemDto.cs b/API/DTOs/ReadingLists/ReadingListItemDto.cs new file mode 100644 index 000000000..b58fdcf80 --- /dev/null +++ b/API/DTOs/ReadingLists/ReadingListItemDto.cs @@ -0,0 +1,25 @@ +using API.Entities.Enums; + +namespace API.DTOs.ReadingLists +{ + public class ReadingListItemDto + { + public int Id { get; init; } + public int Order { get; init; } + public int ChapterId { get; init; } + public int SeriesId { get; init; } + public string SeriesName { get; set; } + public MangaFormat SeriesFormat { get; set; } + public int PagesRead { get; set; } + public int PagesTotal { get; set; } + public string ChapterNumber { get; set; } + public string VolumeNumber { get; set; } + public int VolumeId { get; set; } + public int LibraryId { get; set; } + public string Title { get; set; } + /// + /// Used internally only + /// + public int ReadingListId { get; set; } + } +} diff --git a/API/DTOs/ReadingLists/UpdateReadingListByChapterDto.cs b/API/DTOs/ReadingLists/UpdateReadingListByChapterDto.cs new file mode 100644 index 000000000..887850755 --- /dev/null +++ b/API/DTOs/ReadingLists/UpdateReadingListByChapterDto.cs @@ -0,0 +1,9 @@ +namespace API.DTOs.ReadingLists +{ + public class UpdateReadingListByChapterDto + { + public int ChapterId { get; init; } + public int SeriesId { get; init; } + public int ReadingListId { get; init; } + } +} diff --git a/API/DTOs/ReadingLists/UpdateReadingListByMultipleDto.cs b/API/DTOs/ReadingLists/UpdateReadingListByMultipleDto.cs new file mode 100644 index 000000000..02a41a767 --- /dev/null +++ b/API/DTOs/ReadingLists/UpdateReadingListByMultipleDto.cs @@ -0,0 +1,12 @@ +using System.Collections.Generic; + +namespace API.DTOs.ReadingLists +{ + public class UpdateReadingListByMultipleDto + { + public int SeriesId { get; init; } + public int ReadingListId { get; init; } + public IReadOnlyList VolumeIds { get; init; } + public IReadOnlyList ChapterIds { get; init; } + } +} diff --git a/API/DTOs/ReadingLists/UpdateReadingListByMultipleSeriesDto.cs b/API/DTOs/ReadingLists/UpdateReadingListByMultipleSeriesDto.cs new file mode 100644 index 000000000..4b08f95bc --- /dev/null +++ b/API/DTOs/ReadingLists/UpdateReadingListByMultipleSeriesDto.cs @@ -0,0 +1,10 @@ +using System.Collections.Generic; + +namespace API.DTOs.ReadingLists +{ + public class UpdateReadingListByMultipleSeriesDto + { + public int ReadingListId { get; init; } + public IReadOnlyList SeriesIds { get; init; } + } +} diff --git a/API/DTOs/ReadingLists/UpdateReadingListBySeriesDto.cs b/API/DTOs/ReadingLists/UpdateReadingListBySeriesDto.cs new file mode 100644 index 000000000..1040a9218 --- /dev/null +++ b/API/DTOs/ReadingLists/UpdateReadingListBySeriesDto.cs @@ -0,0 +1,8 @@ +namespace API.DTOs.ReadingLists +{ + public class UpdateReadingListBySeriesDto + { + public int SeriesId { get; init; } + public int ReadingListId { get; init; } + } +} diff --git a/API/DTOs/ReadingLists/UpdateReadingListByVolumeDto.cs b/API/DTOs/ReadingLists/UpdateReadingListByVolumeDto.cs new file mode 100644 index 000000000..0d903d48e --- /dev/null +++ b/API/DTOs/ReadingLists/UpdateReadingListByVolumeDto.cs @@ -0,0 +1,9 @@ +namespace API.DTOs.ReadingLists +{ + public class UpdateReadingListByVolumeDto + { + public int VolumeId { get; init; } + public int SeriesId { get; init; } + public int ReadingListId { get; init; } + } +} diff --git a/API/DTOs/ReadingLists/UpdateReadingListDto.cs b/API/DTOs/ReadingLists/UpdateReadingListDto.cs new file mode 100644 index 000000000..a9f6f0d59 --- /dev/null +++ b/API/DTOs/ReadingLists/UpdateReadingListDto.cs @@ -0,0 +1,10 @@ +namespace API.DTOs.ReadingLists +{ + public class UpdateReadingListDto + { + public int ReadingListId { get; set; } + public string Title { get; set; } + public string Summary { get; set; } + public bool Promoted { get; set; } + } +} diff --git a/API/DTOs/ReadingLists/UpdateReadingListPosition.cs b/API/DTOs/ReadingLists/UpdateReadingListPosition.cs new file mode 100644 index 000000000..023849024 --- /dev/null +++ b/API/DTOs/ReadingLists/UpdateReadingListPosition.cs @@ -0,0 +1,10 @@ +namespace API.DTOs.ReadingLists +{ + public class UpdateReadingListPosition + { + public int ReadingListId { get; set; } + public int ReadingListItemId { get; set; } + public int FromPosition { get; set; } + public int ToPosition { get; set; } + } +} diff --git a/API/DTOs/ServerSettingDTO.cs b/API/DTOs/Settings/ServerSettingDTO.cs similarity index 100% rename from API/DTOs/ServerSettingDTO.cs rename to API/DTOs/Settings/ServerSettingDTO.cs diff --git a/API/DTOs/VolumeDto.cs b/API/DTOs/VolumeDto.cs index 3fc165a6d..3e719346f 100644 --- a/API/DTOs/VolumeDto.cs +++ b/API/DTOs/VolumeDto.cs @@ -13,7 +13,7 @@ namespace API.DTOs public int PagesRead { get; set; } public DateTime LastModified { get; set; } public DateTime Created { get; set; } - public bool IsSpecial { get; set; } + public int SeriesId { get; set; } public ICollection Chapters { get; set; } } -} \ No newline at end of file +} diff --git a/API/Data/BookmarkRepository.cs b/API/Data/BookmarkRepository.cs deleted file mode 100644 index af212bc72..000000000 --- a/API/Data/BookmarkRepository.cs +++ /dev/null @@ -1,7 +0,0 @@ -namespace API.Data -{ - public class BookmarkRepository - { - - } -} diff --git a/API/Data/ChapterRepository.cs b/API/Data/ChapterRepository.cs deleted file mode 100644 index e3510adc4..000000000 --- a/API/Data/ChapterRepository.cs +++ /dev/null @@ -1,23 +0,0 @@ -using API.Entities; -using API.Interfaces.Repositories; -using Microsoft.EntityFrameworkCore; - -namespace API.Data -{ - public class ChapterRepository : IChapterRepository - { - private readonly DataContext _context; - - public ChapterRepository(DataContext context) - { - _context = context; - } - - public void Update(Chapter chapter) - { - _context.Entry(chapter).State = EntityState.Modified; - } - - // TODO: Move over Chapter based queries here - } -} diff --git a/API/Data/DataContext.cs b/API/Data/DataContext.cs index 62765f607..8e4dc263e 100644 --- a/API/Data/DataContext.cs +++ b/API/Data/DataContext.cs @@ -35,6 +35,9 @@ namespace API.Data public DbSet SeriesMetadata { get; set; } public DbSet CollectionTag { get; set; } public DbSet AppUserBookmark { get; set; } + public DbSet ReadingList { get; set; } + public DbSet ReadingListItem { get; set; } + protected override void OnModelCreating(ModelBuilder builder) { diff --git a/API/Data/MigrateCoverImages.cs b/API/Data/MigrateCoverImages.cs new file mode 100644 index 000000000..87e65cb81 --- /dev/null +++ b/API/Data/MigrateCoverImages.cs @@ -0,0 +1,180 @@ +using System; +using System.IO; +using System.Linq; +using System.Threading.Tasks; +using API.Comparators; +using API.Helpers; +using API.Services; +using Microsoft.EntityFrameworkCore; + +namespace API.Data +{ + /// + /// A data structure to migrate Cover Images from byte[] to files. + /// + internal class CoverMigration + { + public string Id { get; set; } + public byte[] CoverImage { get; set; } + public string ParentId { get; set; } + } + + /// + /// In v0.4.6, Cover Images were migrated from byte[] in the DB to external files. This migration handles that work. + /// + public static class MigrateCoverImages + { + private static readonly ChapterSortComparerZeroFirst ChapterSortComparerForInChapterSorting = new (); + + /// + /// Run first. Will extract byte[]s from DB and write them to the cover directory. + /// + public static void ExtractToImages(DbContext context) + { + Console.WriteLine("Migrating Cover Images to disk. Expect delay."); + DirectoryService.ExistOrCreate(DirectoryService.CoverImageDirectory); + + Console.WriteLine("Extracting cover images for Series"); + var lockedSeries = SqlHelper.RawSqlQuery(context, "Select Id, CoverImage From Series Where CoverImage IS NOT NULL", x => + new CoverMigration() + { + Id = x[0] + string.Empty, + CoverImage = (byte[]) x[1], + ParentId = "0" + }); + foreach (var series in lockedSeries) + { + if (series.CoverImage == null || !series.CoverImage.Any()) continue; + if (File.Exists(Path.Join(DirectoryService.CoverImageDirectory, + $"{ImageService.GetSeriesFormat(int.Parse(series.Id))}.png"))) continue; + + try + { + var stream = new MemoryStream(series.CoverImage); + stream.Position = 0; + ImageService.WriteCoverThumbnail(stream, ImageService.GetSeriesFormat(int.Parse(series.Id))); + } + catch (Exception e) + { + Console.WriteLine(e); + } + } + + Console.WriteLine("Extracting cover images for Chapters"); + var chapters = SqlHelper.RawSqlQuery(context, "Select Id, CoverImage, VolumeId From Chapter Where CoverImage IS NOT NULL;", x => + new CoverMigration() + { + Id = x[0] + string.Empty, + CoverImage = (byte[]) x[1], + ParentId = x[2] + string.Empty + }); + foreach (var chapter in chapters) + { + if (chapter.CoverImage == null || !chapter.CoverImage.Any()) continue; + if (File.Exists(Path.Join(DirectoryService.CoverImageDirectory, + $"{ImageService.GetChapterFormat(int.Parse(chapter.Id), int.Parse(chapter.ParentId))}.png"))) continue; + + try + { + var stream = new MemoryStream(chapter.CoverImage); + stream.Position = 0; + ImageService.WriteCoverThumbnail(stream, $"{ImageService.GetChapterFormat(int.Parse(chapter.Id), int.Parse(chapter.ParentId))}"); + } + catch (Exception e) + { + Console.WriteLine(e); + } + } + + Console.WriteLine("Extracting cover images for Collection Tags"); + var tags = SqlHelper.RawSqlQuery(context, "Select Id, CoverImage From CollectionTag Where CoverImage IS NOT NULL;", x => + new CoverMigration() + { + Id = x[0] + string.Empty, + CoverImage = (byte[]) x[1] , + ParentId = "0" + }); + foreach (var tag in tags) + { + if (tag.CoverImage == null || !tag.CoverImage.Any()) continue; + if (File.Exists(Path.Join(DirectoryService.CoverImageDirectory, + $"{ImageService.GetCollectionTagFormat(int.Parse(tag.Id))}.png"))) continue; + try + { + var stream = new MemoryStream(tag.CoverImage); + stream.Position = 0; + ImageService.WriteCoverThumbnail(stream, $"{ImageService.GetCollectionTagFormat(int.Parse(tag.Id))}"); + } + catch (Exception e) + { + Console.WriteLine(e); + } + } + } + + /// + /// Run after . Will update the DB with names of files that were extracted. + /// + /// + public static async Task UpdateDatabaseWithImages(DataContext context) + { + Console.WriteLine("Updating Series entities"); + var seriesCovers = await context.Series.Where(s => !string.IsNullOrEmpty(s.CoverImage)).ToListAsync(); + foreach (var series in seriesCovers) + { + if (!File.Exists(Path.Join(DirectoryService.CoverImageDirectory, + $"{ImageService.GetSeriesFormat(series.Id)}.png"))) continue; + series.CoverImage = $"{ImageService.GetSeriesFormat(series.Id)}.png"; + } + + await context.SaveChangesAsync(); + + Console.WriteLine("Updating Chapter entities"); + var chapters = await context.Chapter.ToListAsync(); + foreach (var chapter in chapters) + { + if (File.Exists(Path.Join(DirectoryService.CoverImageDirectory, + $"{ImageService.GetChapterFormat(chapter.Id, chapter.VolumeId)}.png"))) + { + chapter.CoverImage = $"{ImageService.GetChapterFormat(chapter.Id, chapter.VolumeId)}.png"; + } + + } + + await context.SaveChangesAsync(); + + Console.WriteLine("Updating Volume entities"); + var volumes = await context.Volume.Include(v => v.Chapters).ToListAsync(); + foreach (var volume in volumes) + { + var firstChapter = volume.Chapters.OrderBy(x => double.Parse(x.Number), ChapterSortComparerForInChapterSorting).FirstOrDefault(); + if (firstChapter == null) continue; + if (File.Exists(Path.Join(DirectoryService.CoverImageDirectory, + $"{ImageService.GetChapterFormat(firstChapter.Id, firstChapter.VolumeId)}.png"))) + { + volume.CoverImage = $"{ImageService.GetChapterFormat(firstChapter.Id, firstChapter.VolumeId)}.png"; + } + + } + + await context.SaveChangesAsync(); + + Console.WriteLine("Updating Collection Tag entities"); + var tags = await context.CollectionTag.ToListAsync(); + foreach (var tag in tags) + { + if (File.Exists(Path.Join(DirectoryService.CoverImageDirectory, + $"{ImageService.GetCollectionTagFormat(tag.Id)}.png"))) + { + tag.CoverImage = $"{ImageService.GetCollectionTagFormat(tag.Id)}.png"; + } + + } + + await context.SaveChangesAsync(); + + Console.WriteLine("Cover Image Migration completed"); + } + + } +} diff --git a/API/Data/Migrations/20210901150310_ReadingLists.Designer.cs b/API/Data/Migrations/20210901150310_ReadingLists.Designer.cs new file mode 100644 index 000000000..fef65fdcf --- /dev/null +++ b/API/Data/Migrations/20210901150310_ReadingLists.Designer.cs @@ -0,0 +1,1018 @@ +// +using System; +using API.Data; +using Microsoft.EntityFrameworkCore; +using Microsoft.EntityFrameworkCore.Infrastructure; +using Microsoft.EntityFrameworkCore.Migrations; +using Microsoft.EntityFrameworkCore.Storage.ValueConversion; + +namespace API.Data.Migrations +{ + [DbContext(typeof(DataContext))] + [Migration("20210901150310_ReadingLists")] + partial class ReadingLists + { + protected override void BuildTargetModel(ModelBuilder modelBuilder) + { +#pragma warning disable 612, 618 + modelBuilder + .HasAnnotation("ProductVersion", "5.0.8"); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Name") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedName") + .IsUnique() + .HasDatabaseName("RoleNameIndex"); + + b.ToTable("AspNetRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AccessFailedCount") + .HasColumnType("INTEGER"); + + b.Property("ApiKey") + .HasColumnType("TEXT"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Email") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("EmailConfirmed") + .HasColumnType("INTEGER"); + + b.Property("LastActive") + .HasColumnType("TEXT"); + + b.Property("LockoutEnabled") + .HasColumnType("INTEGER"); + + b.Property("LockoutEnd") + .HasColumnType("TEXT"); + + b.Property("NormalizedEmail") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedUserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("PasswordHash") + .HasColumnType("TEXT"); + + b.Property("PhoneNumber") + .HasColumnType("TEXT"); + + b.Property("PhoneNumberConfirmed") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SecurityStamp") + .HasColumnType("TEXT"); + + b.Property("TwoFactorEnabled") + .HasColumnType("INTEGER"); + + b.Property("UserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedEmail") + .HasDatabaseName("EmailIndex"); + + b.HasIndex("NormalizedUserName") + .IsUnique() + .HasDatabaseName("UserNameIndex"); + + b.ToTable("AspNetUsers"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Page") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserBookmark"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("AutoCloseMenu") + .HasColumnType("INTEGER"); + + b.Property("BookReaderDarkMode") + .HasColumnType("INTEGER"); + + b.Property("BookReaderFontFamily") + .HasColumnType("TEXT"); + + b.Property("BookReaderFontSize") + .HasColumnType("INTEGER"); + + b.Property("BookReaderLineSpacing") + .HasColumnType("INTEGER"); + + b.Property("BookReaderMargin") + .HasColumnType("INTEGER"); + + b.Property("BookReaderReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("BookReaderTapToPaginate") + .HasColumnType("INTEGER"); + + b.Property("PageSplitOption") + .HasColumnType("INTEGER"); + + b.Property("ReaderMode") + .HasColumnType("INTEGER"); + + b.Property("ReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("ScalingOption") + .HasColumnType("INTEGER"); + + b.Property("SiteDarkMode") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId") + .IsUnique(); + + b.ToTable("AppUserPreferences"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("BookScrollId") + .HasColumnType("TEXT"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("PagesRead") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserProgresses"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Rating") + .HasColumnType("INTEGER"); + + b.Property("Review") + .HasColumnType("TEXT"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserRating"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("UserId", "RoleId"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetUserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("IsSpecial") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("Range") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("VolumeId"); + + b.ToTable("Chapter"); + }); + + modelBuilder.Entity("API.Entities.CollectionTag", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("NormalizedTitle") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("Id", "Promoted") + .IsUnique(); + + b.ToTable("CollectionTag"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("LastScanned") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("Path") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.ToTable("FolderPath"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Type") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.ToTable("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("FilePath") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ChapterId"); + + b.ToTable("MangaFile"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("ReadingList"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("Order") + .HasColumnType("INTEGER"); + + b.Property("ReadingListId") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ReadingListId"); + + b.HasIndex("SeriesId", "VolumeId", "ChapterId", "LibraryId") + .IsUnique(); + + b.ToTable("ReadingListItem"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("LocalizedName") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasColumnType("TEXT"); + + b.Property("OriginalName") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SortName") + .HasColumnType("TEXT"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.HasIndex("Name", "NormalizedName", "LocalizedName", "LibraryId", "Format") + .IsUnique(); + + b.ToTable("Series"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId") + .IsUnique(); + + b.HasIndex("Id", "SeriesId") + .IsUnique(); + + b.ToTable("SeriesMetadata"); + }); + + modelBuilder.Entity("API.Entities.ServerSetting", b => + { + b.Property("Key") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("Key"); + + b.ToTable("ServerSetting"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("INTEGER"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId"); + + b.ToTable("Volume"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.Property("AppUsersId") + .HasColumnType("INTEGER"); + + b.Property("LibrariesId") + .HasColumnType("INTEGER"); + + b.HasKey("AppUsersId", "LibrariesId"); + + b.HasIndex("LibrariesId"); + + b.ToTable("AppUserLibrary"); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.Property("CollectionTagsId") + .HasColumnType("INTEGER"); + + b.Property("SeriesMetadatasId") + .HasColumnType("INTEGER"); + + b.HasKey("CollectionTagsId", "SeriesMetadatasId"); + + b.HasIndex("SeriesMetadatasId"); + + b.ToTable("CollectionTagSeriesMetadata"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetRoleClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("ProviderKey") + .HasColumnType("TEXT"); + + b.Property("ProviderDisplayName") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("LoginProvider", "ProviderKey"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserLogins"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("UserId", "LoginProvider", "Name"); + + b.ToTable("AspNetUserTokens"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Bookmarks") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithOne("UserPreferences") + .HasForeignKey("API.Entities.AppUserPreferences", "AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Progresses") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Ratings") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.HasOne("API.Entities.AppRole", "Role") + .WithMany("UserRoles") + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.AppUser", "User") + .WithMany("UserRoles") + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Role"); + + b.Navigation("User"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.HasOne("API.Entities.Volume", "Volume") + .WithMany("Chapters") + .HasForeignKey("VolumeId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Volume"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Folders") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.HasOne("API.Entities.Chapter", "Chapter") + .WithMany("Files") + .HasForeignKey("ChapterId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Chapter"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("ReadingLists") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.HasOne("API.Entities.ReadingList", null) + .WithMany("Items") + .HasForeignKey("ReadingListId"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Series") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithOne("Metadata") + .HasForeignKey("API.Entities.SeriesMetadata", "SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithMany("Volumes") + .HasForeignKey("SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("AppUsersId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Library", null) + .WithMany() + .HasForeignKey("LibrariesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.HasOne("API.Entities.CollectionTag", null) + .WithMany() + .HasForeignKey("CollectionTagsId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.SeriesMetadata", null) + .WithMany() + .HasForeignKey("SeriesMetadatasId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.HasOne("API.Entities.AppRole", null) + .WithMany() + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Navigation("Bookmarks"); + + b.Navigation("Progresses"); + + b.Navigation("Ratings"); + + b.Navigation("ReadingLists"); + + b.Navigation("UserPreferences"); + + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Navigation("Files"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Navigation("Folders"); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Navigation("Items"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Navigation("Metadata"); + + b.Navigation("Volumes"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Navigation("Chapters"); + }); +#pragma warning restore 612, 618 + } + } +} diff --git a/API/Data/Migrations/20210901150310_ReadingLists.cs b/API/Data/Migrations/20210901150310_ReadingLists.cs new file mode 100644 index 000000000..709d3e17a --- /dev/null +++ b/API/Data/Migrations/20210901150310_ReadingLists.cs @@ -0,0 +1,84 @@ +using System; +using Microsoft.EntityFrameworkCore.Migrations; + +namespace API.Data.Migrations +{ + public partial class ReadingLists : Migration + { + protected override void Up(MigrationBuilder migrationBuilder) + { + migrationBuilder.CreateTable( + name: "ReadingList", + columns: table => new + { + Id = table.Column(type: "INTEGER", nullable: false) + .Annotation("Sqlite:Autoincrement", true), + Title = table.Column(type: "TEXT", nullable: true), + Summary = table.Column(type: "TEXT", nullable: true), + Promoted = table.Column(type: "INTEGER", nullable: false), + Created = table.Column(type: "TEXT", nullable: false), + LastModified = table.Column(type: "TEXT", nullable: false), + AppUserId = table.Column(type: "INTEGER", nullable: false) + }, + constraints: table => + { + table.PrimaryKey("PK_ReadingList", x => x.Id); + table.ForeignKey( + name: "FK_ReadingList_AspNetUsers_AppUserId", + column: x => x.AppUserId, + principalTable: "AspNetUsers", + principalColumn: "Id", + onDelete: ReferentialAction.Cascade); + }); + + migrationBuilder.CreateTable( + name: "ReadingListItem", + columns: table => new + { + Id = table.Column(type: "INTEGER", nullable: false) + .Annotation("Sqlite:Autoincrement", true), + LibraryId = table.Column(type: "INTEGER", nullable: false), + SeriesId = table.Column(type: "INTEGER", nullable: false), + VolumeId = table.Column(type: "INTEGER", nullable: false), + ChapterId = table.Column(type: "INTEGER", nullable: false), + Order = table.Column(type: "INTEGER", nullable: false), + ReadingListId = table.Column(type: "INTEGER", nullable: true) + }, + constraints: table => + { + table.PrimaryKey("PK_ReadingListItem", x => x.Id); + table.ForeignKey( + name: "FK_ReadingListItem_ReadingList_ReadingListId", + column: x => x.ReadingListId, + principalTable: "ReadingList", + principalColumn: "Id", + onDelete: ReferentialAction.Restrict); + }); + + migrationBuilder.CreateIndex( + name: "IX_ReadingList_AppUserId", + table: "ReadingList", + column: "AppUserId"); + + migrationBuilder.CreateIndex( + name: "IX_ReadingListItem_ReadingListId", + table: "ReadingListItem", + column: "ReadingListId"); + + migrationBuilder.CreateIndex( + name: "IX_ReadingListItem_SeriesId_VolumeId_ChapterId_LibraryId", + table: "ReadingListItem", + columns: new[] { "SeriesId", "VolumeId", "ChapterId", "LibraryId" }, + unique: true); + } + + protected override void Down(MigrationBuilder migrationBuilder) + { + migrationBuilder.DropTable( + name: "ReadingListItem"); + + migrationBuilder.DropTable( + name: "ReadingList"); + } + } +} diff --git a/API/Data/Migrations/20210901200442_ReadingListsAdditions.Designer.cs b/API/Data/Migrations/20210901200442_ReadingListsAdditions.Designer.cs new file mode 100644 index 000000000..8ee5bdec8 --- /dev/null +++ b/API/Data/Migrations/20210901200442_ReadingListsAdditions.Designer.cs @@ -0,0 +1,1022 @@ +// +using System; +using API.Data; +using Microsoft.EntityFrameworkCore; +using Microsoft.EntityFrameworkCore.Infrastructure; +using Microsoft.EntityFrameworkCore.Migrations; +using Microsoft.EntityFrameworkCore.Storage.ValueConversion; + +namespace API.Data.Migrations +{ + [DbContext(typeof(DataContext))] + [Migration("20210901200442_ReadingListsAdditions")] + partial class ReadingListsAdditions + { + protected override void BuildTargetModel(ModelBuilder modelBuilder) + { +#pragma warning disable 612, 618 + modelBuilder + .HasAnnotation("ProductVersion", "5.0.8"); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Name") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedName") + .IsUnique() + .HasDatabaseName("RoleNameIndex"); + + b.ToTable("AspNetRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AccessFailedCount") + .HasColumnType("INTEGER"); + + b.Property("ApiKey") + .HasColumnType("TEXT"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Email") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("EmailConfirmed") + .HasColumnType("INTEGER"); + + b.Property("LastActive") + .HasColumnType("TEXT"); + + b.Property("LockoutEnabled") + .HasColumnType("INTEGER"); + + b.Property("LockoutEnd") + .HasColumnType("TEXT"); + + b.Property("NormalizedEmail") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedUserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("PasswordHash") + .HasColumnType("TEXT"); + + b.Property("PhoneNumber") + .HasColumnType("TEXT"); + + b.Property("PhoneNumberConfirmed") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SecurityStamp") + .HasColumnType("TEXT"); + + b.Property("TwoFactorEnabled") + .HasColumnType("INTEGER"); + + b.Property("UserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedEmail") + .HasDatabaseName("EmailIndex"); + + b.HasIndex("NormalizedUserName") + .IsUnique() + .HasDatabaseName("UserNameIndex"); + + b.ToTable("AspNetUsers"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Page") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserBookmark"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("AutoCloseMenu") + .HasColumnType("INTEGER"); + + b.Property("BookReaderDarkMode") + .HasColumnType("INTEGER"); + + b.Property("BookReaderFontFamily") + .HasColumnType("TEXT"); + + b.Property("BookReaderFontSize") + .HasColumnType("INTEGER"); + + b.Property("BookReaderLineSpacing") + .HasColumnType("INTEGER"); + + b.Property("BookReaderMargin") + .HasColumnType("INTEGER"); + + b.Property("BookReaderReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("BookReaderTapToPaginate") + .HasColumnType("INTEGER"); + + b.Property("PageSplitOption") + .HasColumnType("INTEGER"); + + b.Property("ReaderMode") + .HasColumnType("INTEGER"); + + b.Property("ReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("ScalingOption") + .HasColumnType("INTEGER"); + + b.Property("SiteDarkMode") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId") + .IsUnique(); + + b.ToTable("AppUserPreferences"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("BookScrollId") + .HasColumnType("TEXT"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("PagesRead") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserProgresses"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Rating") + .HasColumnType("INTEGER"); + + b.Property("Review") + .HasColumnType("TEXT"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserRating"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("UserId", "RoleId"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetUserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("IsSpecial") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("Range") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("VolumeId"); + + b.ToTable("Chapter"); + }); + + modelBuilder.Entity("API.Entities.CollectionTag", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("NormalizedTitle") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("Id", "Promoted") + .IsUnique(); + + b.ToTable("CollectionTag"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("LastScanned") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("Path") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.ToTable("FolderPath"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Type") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.ToTable("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("FilePath") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ChapterId"); + + b.ToTable("MangaFile"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("ReadingList"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("Order") + .HasColumnType("INTEGER"); + + b.Property("ReadingListId") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ReadingListId"); + + b.HasIndex("SeriesId", "VolumeId", "ChapterId", "LibraryId") + .IsUnique(); + + b.ToTable("ReadingListItem"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("LocalizedName") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasColumnType("TEXT"); + + b.Property("OriginalName") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SortName") + .HasColumnType("TEXT"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.HasIndex("Name", "NormalizedName", "LocalizedName", "LibraryId", "Format") + .IsUnique(); + + b.ToTable("Series"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId") + .IsUnique(); + + b.HasIndex("Id", "SeriesId") + .IsUnique(); + + b.ToTable("SeriesMetadata"); + }); + + modelBuilder.Entity("API.Entities.ServerSetting", b => + { + b.Property("Key") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("Key"); + + b.ToTable("ServerSetting"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("INTEGER"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId"); + + b.ToTable("Volume"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.Property("AppUsersId") + .HasColumnType("INTEGER"); + + b.Property("LibrariesId") + .HasColumnType("INTEGER"); + + b.HasKey("AppUsersId", "LibrariesId"); + + b.HasIndex("LibrariesId"); + + b.ToTable("AppUserLibrary"); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.Property("CollectionTagsId") + .HasColumnType("INTEGER"); + + b.Property("SeriesMetadatasId") + .HasColumnType("INTEGER"); + + b.HasKey("CollectionTagsId", "SeriesMetadatasId"); + + b.HasIndex("SeriesMetadatasId"); + + b.ToTable("CollectionTagSeriesMetadata"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetRoleClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("ProviderKey") + .HasColumnType("TEXT"); + + b.Property("ProviderDisplayName") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("LoginProvider", "ProviderKey"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserLogins"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("UserId", "LoginProvider", "Name"); + + b.ToTable("AspNetUserTokens"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Bookmarks") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithOne("UserPreferences") + .HasForeignKey("API.Entities.AppUserPreferences", "AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Progresses") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Ratings") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.HasOne("API.Entities.AppRole", "Role") + .WithMany("UserRoles") + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.AppUser", "User") + .WithMany("UserRoles") + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Role"); + + b.Navigation("User"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.HasOne("API.Entities.Volume", "Volume") + .WithMany("Chapters") + .HasForeignKey("VolumeId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Volume"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Folders") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.HasOne("API.Entities.Chapter", "Chapter") + .WithMany("Files") + .HasForeignKey("ChapterId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Chapter"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("ReadingLists") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.HasOne("API.Entities.ReadingList", "ReadingList") + .WithMany("Items") + .HasForeignKey("ReadingListId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("ReadingList"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Series") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithOne("Metadata") + .HasForeignKey("API.Entities.SeriesMetadata", "SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithMany("Volumes") + .HasForeignKey("SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("AppUsersId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Library", null) + .WithMany() + .HasForeignKey("LibrariesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.HasOne("API.Entities.CollectionTag", null) + .WithMany() + .HasForeignKey("CollectionTagsId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.SeriesMetadata", null) + .WithMany() + .HasForeignKey("SeriesMetadatasId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.HasOne("API.Entities.AppRole", null) + .WithMany() + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Navigation("Bookmarks"); + + b.Navigation("Progresses"); + + b.Navigation("Ratings"); + + b.Navigation("ReadingLists"); + + b.Navigation("UserPreferences"); + + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Navigation("Files"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Navigation("Folders"); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Navigation("Items"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Navigation("Metadata"); + + b.Navigation("Volumes"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Navigation("Chapters"); + }); +#pragma warning restore 612, 618 + } + } +} diff --git a/API/Data/Migrations/20210901200442_ReadingListsAdditions.cs b/API/Data/Migrations/20210901200442_ReadingListsAdditions.cs new file mode 100644 index 000000000..b44c2ac4d --- /dev/null +++ b/API/Data/Migrations/20210901200442_ReadingListsAdditions.cs @@ -0,0 +1,55 @@ +using Microsoft.EntityFrameworkCore.Migrations; + +namespace API.Data.Migrations +{ + public partial class ReadingListsAdditions : Migration + { + protected override void Up(MigrationBuilder migrationBuilder) + { + migrationBuilder.DropForeignKey( + name: "FK_ReadingListItem_ReadingList_ReadingListId", + table: "ReadingListItem"); + + migrationBuilder.AlterColumn( + name: "ReadingListId", + table: "ReadingListItem", + type: "INTEGER", + nullable: false, + defaultValue: 0, + oldClrType: typeof(int), + oldType: "INTEGER", + oldNullable: true); + + migrationBuilder.AddForeignKey( + name: "FK_ReadingListItem_ReadingList_ReadingListId", + table: "ReadingListItem", + column: "ReadingListId", + principalTable: "ReadingList", + principalColumn: "Id", + onDelete: ReferentialAction.Cascade); + } + + protected override void Down(MigrationBuilder migrationBuilder) + { + migrationBuilder.DropForeignKey( + name: "FK_ReadingListItem_ReadingList_ReadingListId", + table: "ReadingListItem"); + + migrationBuilder.AlterColumn( + name: "ReadingListId", + table: "ReadingListItem", + type: "INTEGER", + nullable: true, + oldClrType: typeof(int), + oldType: "INTEGER"); + + migrationBuilder.AddForeignKey( + name: "FK_ReadingListItem_ReadingList_ReadingListId", + table: "ReadingListItem", + column: "ReadingListId", + principalTable: "ReadingList", + principalColumn: "Id", + onDelete: ReferentialAction.Restrict); + } + } +} diff --git a/API/Data/Migrations/20210902110705_ReadingListsExtraRealationships.Designer.cs b/API/Data/Migrations/20210902110705_ReadingListsExtraRealationships.Designer.cs new file mode 100644 index 000000000..566d2c5be --- /dev/null +++ b/API/Data/Migrations/20210902110705_ReadingListsExtraRealationships.Designer.cs @@ -0,0 +1,1050 @@ +// +using System; +using API.Data; +using Microsoft.EntityFrameworkCore; +using Microsoft.EntityFrameworkCore.Infrastructure; +using Microsoft.EntityFrameworkCore.Migrations; +using Microsoft.EntityFrameworkCore.Storage.ValueConversion; + +namespace API.Data.Migrations +{ + [DbContext(typeof(DataContext))] + [Migration("20210902110705_ReadingListsExtraRealationships")] + partial class ReadingListsExtraRealationships + { + protected override void BuildTargetModel(ModelBuilder modelBuilder) + { +#pragma warning disable 612, 618 + modelBuilder + .HasAnnotation("ProductVersion", "5.0.8"); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Name") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedName") + .IsUnique() + .HasDatabaseName("RoleNameIndex"); + + b.ToTable("AspNetRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AccessFailedCount") + .HasColumnType("INTEGER"); + + b.Property("ApiKey") + .HasColumnType("TEXT"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Email") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("EmailConfirmed") + .HasColumnType("INTEGER"); + + b.Property("LastActive") + .HasColumnType("TEXT"); + + b.Property("LockoutEnabled") + .HasColumnType("INTEGER"); + + b.Property("LockoutEnd") + .HasColumnType("TEXT"); + + b.Property("NormalizedEmail") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedUserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("PasswordHash") + .HasColumnType("TEXT"); + + b.Property("PhoneNumber") + .HasColumnType("TEXT"); + + b.Property("PhoneNumberConfirmed") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SecurityStamp") + .HasColumnType("TEXT"); + + b.Property("TwoFactorEnabled") + .HasColumnType("INTEGER"); + + b.Property("UserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedEmail") + .HasDatabaseName("EmailIndex"); + + b.HasIndex("NormalizedUserName") + .IsUnique() + .HasDatabaseName("UserNameIndex"); + + b.ToTable("AspNetUsers"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Page") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserBookmark"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("AutoCloseMenu") + .HasColumnType("INTEGER"); + + b.Property("BookReaderDarkMode") + .HasColumnType("INTEGER"); + + b.Property("BookReaderFontFamily") + .HasColumnType("TEXT"); + + b.Property("BookReaderFontSize") + .HasColumnType("INTEGER"); + + b.Property("BookReaderLineSpacing") + .HasColumnType("INTEGER"); + + b.Property("BookReaderMargin") + .HasColumnType("INTEGER"); + + b.Property("BookReaderReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("BookReaderTapToPaginate") + .HasColumnType("INTEGER"); + + b.Property("PageSplitOption") + .HasColumnType("INTEGER"); + + b.Property("ReaderMode") + .HasColumnType("INTEGER"); + + b.Property("ReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("ScalingOption") + .HasColumnType("INTEGER"); + + b.Property("SiteDarkMode") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId") + .IsUnique(); + + b.ToTable("AppUserPreferences"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("BookScrollId") + .HasColumnType("TEXT"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("PagesRead") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserProgresses"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Rating") + .HasColumnType("INTEGER"); + + b.Property("Review") + .HasColumnType("TEXT"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserRating"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("UserId", "RoleId"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetUserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("IsSpecial") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("Range") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("VolumeId"); + + b.ToTable("Chapter"); + }); + + modelBuilder.Entity("API.Entities.CollectionTag", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("NormalizedTitle") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("Id", "Promoted") + .IsUnique(); + + b.ToTable("CollectionTag"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("LastScanned") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("Path") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.ToTable("FolderPath"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Type") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.ToTable("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("FilePath") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ChapterId"); + + b.ToTable("MangaFile"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("ReadingList"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("Order") + .HasColumnType("INTEGER"); + + b.Property("ReadingListId") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ChapterId"); + + b.HasIndex("ReadingListId"); + + b.HasIndex("VolumeId"); + + b.HasIndex("SeriesId", "VolumeId", "ChapterId", "LibraryId") + .IsUnique(); + + b.ToTable("ReadingListItem"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("LocalizedName") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasColumnType("TEXT"); + + b.Property("OriginalName") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SortName") + .HasColumnType("TEXT"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.HasIndex("Name", "NormalizedName", "LocalizedName", "LibraryId", "Format") + .IsUnique(); + + b.ToTable("Series"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId") + .IsUnique(); + + b.HasIndex("Id", "SeriesId") + .IsUnique(); + + b.ToTable("SeriesMetadata"); + }); + + modelBuilder.Entity("API.Entities.ServerSetting", b => + { + b.Property("Key") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("Key"); + + b.ToTable("ServerSetting"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("INTEGER"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId"); + + b.ToTable("Volume"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.Property("AppUsersId") + .HasColumnType("INTEGER"); + + b.Property("LibrariesId") + .HasColumnType("INTEGER"); + + b.HasKey("AppUsersId", "LibrariesId"); + + b.HasIndex("LibrariesId"); + + b.ToTable("AppUserLibrary"); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.Property("CollectionTagsId") + .HasColumnType("INTEGER"); + + b.Property("SeriesMetadatasId") + .HasColumnType("INTEGER"); + + b.HasKey("CollectionTagsId", "SeriesMetadatasId"); + + b.HasIndex("SeriesMetadatasId"); + + b.ToTable("CollectionTagSeriesMetadata"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetRoleClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("ProviderKey") + .HasColumnType("TEXT"); + + b.Property("ProviderDisplayName") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("LoginProvider", "ProviderKey"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserLogins"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("UserId", "LoginProvider", "Name"); + + b.ToTable("AspNetUserTokens"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Bookmarks") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithOne("UserPreferences") + .HasForeignKey("API.Entities.AppUserPreferences", "AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Progresses") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Ratings") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.HasOne("API.Entities.AppRole", "Role") + .WithMany("UserRoles") + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.AppUser", "User") + .WithMany("UserRoles") + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Role"); + + b.Navigation("User"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.HasOne("API.Entities.Volume", "Volume") + .WithMany("Chapters") + .HasForeignKey("VolumeId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Volume"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Folders") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.HasOne("API.Entities.Chapter", "Chapter") + .WithMany("Files") + .HasForeignKey("ChapterId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Chapter"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("ReadingLists") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.HasOne("API.Entities.Chapter", "Chapter") + .WithMany() + .HasForeignKey("ChapterId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.ReadingList", "ReadingList") + .WithMany("Items") + .HasForeignKey("ReadingListId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Series", "Series") + .WithMany() + .HasForeignKey("SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Volume", "Volume") + .WithMany() + .HasForeignKey("VolumeId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Chapter"); + + b.Navigation("ReadingList"); + + b.Navigation("Series"); + + b.Navigation("Volume"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Series") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithOne("Metadata") + .HasForeignKey("API.Entities.SeriesMetadata", "SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithMany("Volumes") + .HasForeignKey("SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("AppUsersId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Library", null) + .WithMany() + .HasForeignKey("LibrariesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.HasOne("API.Entities.CollectionTag", null) + .WithMany() + .HasForeignKey("CollectionTagsId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.SeriesMetadata", null) + .WithMany() + .HasForeignKey("SeriesMetadatasId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.HasOne("API.Entities.AppRole", null) + .WithMany() + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Navigation("Bookmarks"); + + b.Navigation("Progresses"); + + b.Navigation("Ratings"); + + b.Navigation("ReadingLists"); + + b.Navigation("UserPreferences"); + + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Navigation("Files"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Navigation("Folders"); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Navigation("Items"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Navigation("Metadata"); + + b.Navigation("Volumes"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Navigation("Chapters"); + }); +#pragma warning restore 612, 618 + } + } +} diff --git a/API/Data/Migrations/20210902110705_ReadingListsExtraRealationships.cs b/API/Data/Migrations/20210902110705_ReadingListsExtraRealationships.cs new file mode 100644 index 000000000..9ddb1b5fc --- /dev/null +++ b/API/Data/Migrations/20210902110705_ReadingListsExtraRealationships.cs @@ -0,0 +1,67 @@ +using Microsoft.EntityFrameworkCore.Migrations; + +namespace API.Data.Migrations +{ + public partial class ReadingListsExtraRealationships : Migration + { + protected override void Up(MigrationBuilder migrationBuilder) + { + migrationBuilder.CreateIndex( + name: "IX_ReadingListItem_ChapterId", + table: "ReadingListItem", + column: "ChapterId"); + + migrationBuilder.CreateIndex( + name: "IX_ReadingListItem_VolumeId", + table: "ReadingListItem", + column: "VolumeId"); + + migrationBuilder.AddForeignKey( + name: "FK_ReadingListItem_Chapter_ChapterId", + table: "ReadingListItem", + column: "ChapterId", + principalTable: "Chapter", + principalColumn: "Id", + onDelete: ReferentialAction.Cascade); + + migrationBuilder.AddForeignKey( + name: "FK_ReadingListItem_Series_SeriesId", + table: "ReadingListItem", + column: "SeriesId", + principalTable: "Series", + principalColumn: "Id", + onDelete: ReferentialAction.Cascade); + + migrationBuilder.AddForeignKey( + name: "FK_ReadingListItem_Volume_VolumeId", + table: "ReadingListItem", + column: "VolumeId", + principalTable: "Volume", + principalColumn: "Id", + onDelete: ReferentialAction.Cascade); + } + + protected override void Down(MigrationBuilder migrationBuilder) + { + migrationBuilder.DropForeignKey( + name: "FK_ReadingListItem_Chapter_ChapterId", + table: "ReadingListItem"); + + migrationBuilder.DropForeignKey( + name: "FK_ReadingListItem_Series_SeriesId", + table: "ReadingListItem"); + + migrationBuilder.DropForeignKey( + name: "FK_ReadingListItem_Volume_VolumeId", + table: "ReadingListItem"); + + migrationBuilder.DropIndex( + name: "IX_ReadingListItem_ChapterId", + table: "ReadingListItem"); + + migrationBuilder.DropIndex( + name: "IX_ReadingListItem_VolumeId", + table: "ReadingListItem"); + } + } +} diff --git a/API/Data/Migrations/20210906140845_ReadingListsChanges.Designer.cs b/API/Data/Migrations/20210906140845_ReadingListsChanges.Designer.cs new file mode 100644 index 000000000..836a496e0 --- /dev/null +++ b/API/Data/Migrations/20210906140845_ReadingListsChanges.Designer.cs @@ -0,0 +1,1046 @@ +// +using System; +using API.Data; +using Microsoft.EntityFrameworkCore; +using Microsoft.EntityFrameworkCore.Infrastructure; +using Microsoft.EntityFrameworkCore.Migrations; +using Microsoft.EntityFrameworkCore.Storage.ValueConversion; + +namespace API.Data.Migrations +{ + [DbContext(typeof(DataContext))] + [Migration("20210906140845_ReadingListsChanges")] + partial class ReadingListsChanges + { + protected override void BuildTargetModel(ModelBuilder modelBuilder) + { +#pragma warning disable 612, 618 + modelBuilder + .HasAnnotation("ProductVersion", "5.0.8"); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Name") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedName") + .IsUnique() + .HasDatabaseName("RoleNameIndex"); + + b.ToTable("AspNetRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AccessFailedCount") + .HasColumnType("INTEGER"); + + b.Property("ApiKey") + .HasColumnType("TEXT"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Email") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("EmailConfirmed") + .HasColumnType("INTEGER"); + + b.Property("LastActive") + .HasColumnType("TEXT"); + + b.Property("LockoutEnabled") + .HasColumnType("INTEGER"); + + b.Property("LockoutEnd") + .HasColumnType("TEXT"); + + b.Property("NormalizedEmail") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedUserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("PasswordHash") + .HasColumnType("TEXT"); + + b.Property("PhoneNumber") + .HasColumnType("TEXT"); + + b.Property("PhoneNumberConfirmed") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SecurityStamp") + .HasColumnType("TEXT"); + + b.Property("TwoFactorEnabled") + .HasColumnType("INTEGER"); + + b.Property("UserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedEmail") + .HasDatabaseName("EmailIndex"); + + b.HasIndex("NormalizedUserName") + .IsUnique() + .HasDatabaseName("UserNameIndex"); + + b.ToTable("AspNetUsers"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Page") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserBookmark"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("AutoCloseMenu") + .HasColumnType("INTEGER"); + + b.Property("BookReaderDarkMode") + .HasColumnType("INTEGER"); + + b.Property("BookReaderFontFamily") + .HasColumnType("TEXT"); + + b.Property("BookReaderFontSize") + .HasColumnType("INTEGER"); + + b.Property("BookReaderLineSpacing") + .HasColumnType("INTEGER"); + + b.Property("BookReaderMargin") + .HasColumnType("INTEGER"); + + b.Property("BookReaderReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("BookReaderTapToPaginate") + .HasColumnType("INTEGER"); + + b.Property("PageSplitOption") + .HasColumnType("INTEGER"); + + b.Property("ReaderMode") + .HasColumnType("INTEGER"); + + b.Property("ReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("ScalingOption") + .HasColumnType("INTEGER"); + + b.Property("SiteDarkMode") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId") + .IsUnique(); + + b.ToTable("AppUserPreferences"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("BookScrollId") + .HasColumnType("TEXT"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("PagesRead") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserProgresses"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Rating") + .HasColumnType("INTEGER"); + + b.Property("Review") + .HasColumnType("TEXT"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserRating"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("UserId", "RoleId"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetUserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("IsSpecial") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("Range") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("VolumeId"); + + b.ToTable("Chapter"); + }); + + modelBuilder.Entity("API.Entities.CollectionTag", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("NormalizedTitle") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("Id", "Promoted") + .IsUnique(); + + b.ToTable("CollectionTag"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("LastScanned") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("Path") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.ToTable("FolderPath"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Type") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.ToTable("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("FilePath") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ChapterId"); + + b.ToTable("MangaFile"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("ReadingList"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Order") + .HasColumnType("INTEGER"); + + b.Property("ReadingListId") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ChapterId"); + + b.HasIndex("ReadingListId"); + + b.HasIndex("SeriesId"); + + b.HasIndex("VolumeId"); + + b.ToTable("ReadingListItem"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("LocalizedName") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasColumnType("TEXT"); + + b.Property("OriginalName") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SortName") + .HasColumnType("TEXT"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.HasIndex("Name", "NormalizedName", "LocalizedName", "LibraryId", "Format") + .IsUnique(); + + b.ToTable("Series"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId") + .IsUnique(); + + b.HasIndex("Id", "SeriesId") + .IsUnique(); + + b.ToTable("SeriesMetadata"); + }); + + modelBuilder.Entity("API.Entities.ServerSetting", b => + { + b.Property("Key") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("Key"); + + b.ToTable("ServerSetting"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("BLOB"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("INTEGER"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId"); + + b.ToTable("Volume"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.Property("AppUsersId") + .HasColumnType("INTEGER"); + + b.Property("LibrariesId") + .HasColumnType("INTEGER"); + + b.HasKey("AppUsersId", "LibrariesId"); + + b.HasIndex("LibrariesId"); + + b.ToTable("AppUserLibrary"); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.Property("CollectionTagsId") + .HasColumnType("INTEGER"); + + b.Property("SeriesMetadatasId") + .HasColumnType("INTEGER"); + + b.HasKey("CollectionTagsId", "SeriesMetadatasId"); + + b.HasIndex("SeriesMetadatasId"); + + b.ToTable("CollectionTagSeriesMetadata"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetRoleClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("ProviderKey") + .HasColumnType("TEXT"); + + b.Property("ProviderDisplayName") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("LoginProvider", "ProviderKey"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserLogins"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("UserId", "LoginProvider", "Name"); + + b.ToTable("AspNetUserTokens"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Bookmarks") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithOne("UserPreferences") + .HasForeignKey("API.Entities.AppUserPreferences", "AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Progresses") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Ratings") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.HasOne("API.Entities.AppRole", "Role") + .WithMany("UserRoles") + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.AppUser", "User") + .WithMany("UserRoles") + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Role"); + + b.Navigation("User"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.HasOne("API.Entities.Volume", "Volume") + .WithMany("Chapters") + .HasForeignKey("VolumeId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Volume"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Folders") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.HasOne("API.Entities.Chapter", "Chapter") + .WithMany("Files") + .HasForeignKey("ChapterId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Chapter"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("ReadingLists") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.HasOne("API.Entities.Chapter", "Chapter") + .WithMany() + .HasForeignKey("ChapterId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.ReadingList", "ReadingList") + .WithMany("Items") + .HasForeignKey("ReadingListId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Series", "Series") + .WithMany() + .HasForeignKey("SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Volume", "Volume") + .WithMany() + .HasForeignKey("VolumeId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Chapter"); + + b.Navigation("ReadingList"); + + b.Navigation("Series"); + + b.Navigation("Volume"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Series") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithOne("Metadata") + .HasForeignKey("API.Entities.SeriesMetadata", "SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithMany("Volumes") + .HasForeignKey("SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("AppUsersId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Library", null) + .WithMany() + .HasForeignKey("LibrariesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.HasOne("API.Entities.CollectionTag", null) + .WithMany() + .HasForeignKey("CollectionTagsId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.SeriesMetadata", null) + .WithMany() + .HasForeignKey("SeriesMetadatasId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.HasOne("API.Entities.AppRole", null) + .WithMany() + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Navigation("Bookmarks"); + + b.Navigation("Progresses"); + + b.Navigation("Ratings"); + + b.Navigation("ReadingLists"); + + b.Navigation("UserPreferences"); + + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Navigation("Files"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Navigation("Folders"); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Navigation("Items"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Navigation("Metadata"); + + b.Navigation("Volumes"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Navigation("Chapters"); + }); +#pragma warning restore 612, 618 + } + } +} diff --git a/API/Data/Migrations/20210906140845_ReadingListsChanges.cs b/API/Data/Migrations/20210906140845_ReadingListsChanges.cs new file mode 100644 index 000000000..e4ea07e2e --- /dev/null +++ b/API/Data/Migrations/20210906140845_ReadingListsChanges.cs @@ -0,0 +1,43 @@ +using Microsoft.EntityFrameworkCore.Migrations; + +namespace API.Data.Migrations +{ + public partial class ReadingListsChanges : Migration + { + protected override void Up(MigrationBuilder migrationBuilder) + { + migrationBuilder.DropIndex( + name: "IX_ReadingListItem_SeriesId_VolumeId_ChapterId_LibraryId", + table: "ReadingListItem"); + + migrationBuilder.DropColumn( + name: "LibraryId", + table: "ReadingListItem"); + + migrationBuilder.CreateIndex( + name: "IX_ReadingListItem_SeriesId", + table: "ReadingListItem", + column: "SeriesId"); + } + + protected override void Down(MigrationBuilder migrationBuilder) + { + migrationBuilder.DropIndex( + name: "IX_ReadingListItem_SeriesId", + table: "ReadingListItem"); + + migrationBuilder.AddColumn( + name: "LibraryId", + table: "ReadingListItem", + type: "INTEGER", + nullable: false, + defaultValue: 0); + + migrationBuilder.CreateIndex( + name: "IX_ReadingListItem_SeriesId_VolumeId_ChapterId_LibraryId", + table: "ReadingListItem", + columns: new[] { "SeriesId", "VolumeId", "ChapterId", "LibraryId" }, + unique: true); + } + } +} diff --git a/API/Data/Migrations/20210916142418_EntityImageRefactor.Designer.cs b/API/Data/Migrations/20210916142418_EntityImageRefactor.Designer.cs new file mode 100644 index 000000000..b4c6f62f1 --- /dev/null +++ b/API/Data/Migrations/20210916142418_EntityImageRefactor.Designer.cs @@ -0,0 +1,1042 @@ +// +using System; +using API.Data; +using Microsoft.EntityFrameworkCore; +using Microsoft.EntityFrameworkCore.Infrastructure; +using Microsoft.EntityFrameworkCore.Migrations; +using Microsoft.EntityFrameworkCore.Storage.ValueConversion; + +namespace API.Data.Migrations +{ + [DbContext(typeof(DataContext))] + [Migration("20210916142418_EntityImageRefactor")] + partial class EntityImageRefactor + { + protected override void BuildTargetModel(ModelBuilder modelBuilder) + { +#pragma warning disable 612, 618 + modelBuilder + .HasAnnotation("ProductVersion", "5.0.8"); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Name") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedName") + .IsUnique() + .HasDatabaseName("RoleNameIndex"); + + b.ToTable("AspNetRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AccessFailedCount") + .HasColumnType("INTEGER"); + + b.Property("ApiKey") + .HasColumnType("TEXT"); + + b.Property("ConcurrencyStamp") + .IsConcurrencyToken() + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Email") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("EmailConfirmed") + .HasColumnType("INTEGER"); + + b.Property("LastActive") + .HasColumnType("TEXT"); + + b.Property("LockoutEnabled") + .HasColumnType("INTEGER"); + + b.Property("LockoutEnd") + .HasColumnType("TEXT"); + + b.Property("NormalizedEmail") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("NormalizedUserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.Property("PasswordHash") + .HasColumnType("TEXT"); + + b.Property("PhoneNumber") + .HasColumnType("TEXT"); + + b.Property("PhoneNumberConfirmed") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SecurityStamp") + .HasColumnType("TEXT"); + + b.Property("TwoFactorEnabled") + .HasColumnType("INTEGER"); + + b.Property("UserName") + .HasMaxLength(256) + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("NormalizedEmail") + .HasDatabaseName("EmailIndex"); + + b.HasIndex("NormalizedUserName") + .IsUnique() + .HasDatabaseName("UserNameIndex"); + + b.ToTable("AspNetUsers"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Page") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserBookmark"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("AutoCloseMenu") + .HasColumnType("INTEGER"); + + b.Property("BookReaderDarkMode") + .HasColumnType("INTEGER"); + + b.Property("BookReaderFontFamily") + .HasColumnType("TEXT"); + + b.Property("BookReaderFontSize") + .HasColumnType("INTEGER"); + + b.Property("BookReaderLineSpacing") + .HasColumnType("INTEGER"); + + b.Property("BookReaderMargin") + .HasColumnType("INTEGER"); + + b.Property("BookReaderReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("BookReaderTapToPaginate") + .HasColumnType("INTEGER"); + + b.Property("PageSplitOption") + .HasColumnType("INTEGER"); + + b.Property("ReaderMode") + .HasColumnType("INTEGER"); + + b.Property("ReadingDirection") + .HasColumnType("INTEGER"); + + b.Property("ScalingOption") + .HasColumnType("INTEGER"); + + b.Property("SiteDarkMode") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId") + .IsUnique(); + + b.ToTable("AppUserPreferences"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("BookScrollId") + .HasColumnType("TEXT"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("PagesRead") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserProgresses"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Rating") + .HasColumnType("INTEGER"); + + b.Property("Review") + .HasColumnType("TEXT"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("AppUserRating"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("UserId", "RoleId"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetUserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("TEXT"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("IsSpecial") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("Range") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("VolumeId"); + + b.ToTable("Chapter"); + }); + + modelBuilder.Entity("API.Entities.CollectionTag", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("TEXT"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("NormalizedTitle") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("Id", "Promoted") + .IsUnique(); + + b.ToTable("CollectionTag"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("LastScanned") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("Path") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.ToTable("FolderPath"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Type") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.ToTable("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("FilePath") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ChapterId"); + + b.ToTable("MangaFile"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("ReadingList"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Order") + .HasColumnType("INTEGER"); + + b.Property("ReadingListId") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ChapterId"); + + b.HasIndex("ReadingListId"); + + b.HasIndex("SeriesId"); + + b.HasIndex("VolumeId"); + + b.ToTable("ReadingListItem"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("TEXT"); + + b.Property("CoverImageLocked") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("Format") + .HasColumnType("INTEGER"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("LibraryId") + .HasColumnType("INTEGER"); + + b.Property("LocalizedName") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("NormalizedName") + .HasColumnType("TEXT"); + + b.Property("OriginalName") + .HasColumnType("TEXT"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SortName") + .HasColumnType("TEXT"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("LibraryId"); + + b.HasIndex("Name", "NormalizedName", "LocalizedName", "LibraryId", "Format") + .IsUnique(); + + b.ToTable("Series"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId") + .IsUnique(); + + b.HasIndex("Id", "SeriesId") + .IsUnique(); + + b.ToTable("SeriesMetadata"); + }); + + modelBuilder.Entity("API.Entities.ServerSetting", b => + { + b.Property("Key") + .HasColumnType("INTEGER"); + + b.Property("RowVersion") + .IsConcurrencyToken() + .HasColumnType("INTEGER"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("Key"); + + b.ToTable("ServerSetting"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("CoverImage") + .HasColumnType("TEXT"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Number") + .HasColumnType("INTEGER"); + + b.Property("Pages") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("SeriesId"); + + b.ToTable("Volume"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.Property("AppUsersId") + .HasColumnType("INTEGER"); + + b.Property("LibrariesId") + .HasColumnType("INTEGER"); + + b.HasKey("AppUsersId", "LibrariesId"); + + b.HasIndex("LibrariesId"); + + b.ToTable("AppUserLibrary"); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.Property("CollectionTagsId") + .HasColumnType("INTEGER"); + + b.Property("SeriesMetadatasId") + .HasColumnType("INTEGER"); + + b.HasKey("CollectionTagsId", "SeriesMetadatasId"); + + b.HasIndex("SeriesMetadatasId"); + + b.ToTable("CollectionTagSeriesMetadata"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("RoleId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("RoleId"); + + b.ToTable("AspNetRoleClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ClaimType") + .HasColumnType("TEXT"); + + b.Property("ClaimValue") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserClaims"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("ProviderKey") + .HasColumnType("TEXT"); + + b.Property("ProviderDisplayName") + .HasColumnType("TEXT"); + + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.HasKey("LoginProvider", "ProviderKey"); + + b.HasIndex("UserId"); + + b.ToTable("AspNetUserLogins"); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.Property("UserId") + .HasColumnType("INTEGER"); + + b.Property("LoginProvider") + .HasColumnType("TEXT"); + + b.Property("Name") + .HasColumnType("TEXT"); + + b.Property("Value") + .HasColumnType("TEXT"); + + b.HasKey("UserId", "LoginProvider", "Name"); + + b.ToTable("AspNetUserTokens"); + }); + + modelBuilder.Entity("API.Entities.AppUserBookmark", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Bookmarks") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserPreferences", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithOne("UserPreferences") + .HasForeignKey("API.Entities.AppUserPreferences", "AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserProgress", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Progresses") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRating", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("Ratings") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.AppUserRole", b => + { + b.HasOne("API.Entities.AppRole", "Role") + .WithMany("UserRoles") + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.AppUser", "User") + .WithMany("UserRoles") + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Role"); + + b.Navigation("User"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.HasOne("API.Entities.Volume", "Volume") + .WithMany("Chapters") + .HasForeignKey("VolumeId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Volume"); + }); + + modelBuilder.Entity("API.Entities.FolderPath", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Folders") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.MangaFile", b => + { + b.HasOne("API.Entities.Chapter", "Chapter") + .WithMany("Files") + .HasForeignKey("ChapterId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Chapter"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("ReadingLists") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.HasOne("API.Entities.Chapter", "Chapter") + .WithMany() + .HasForeignKey("ChapterId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.ReadingList", "ReadingList") + .WithMany("Items") + .HasForeignKey("ReadingListId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Series", "Series") + .WithMany() + .HasForeignKey("SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Volume", "Volume") + .WithMany() + .HasForeignKey("VolumeId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Chapter"); + + b.Navigation("ReadingList"); + + b.Navigation("Series"); + + b.Navigation("Volume"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.HasOne("API.Entities.Library", "Library") + .WithMany("Series") + .HasForeignKey("LibraryId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Library"); + }); + + modelBuilder.Entity("API.Entities.SeriesMetadata", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithOne("Metadata") + .HasForeignKey("API.Entities.SeriesMetadata", "SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.HasOne("API.Entities.Series", "Series") + .WithMany("Volumes") + .HasForeignKey("SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("AppUserLibrary", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("AppUsersId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Library", null) + .WithMany() + .HasForeignKey("LibrariesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("CollectionTagSeriesMetadata", b => + { + b.HasOne("API.Entities.CollectionTag", null) + .WithMany() + .HasForeignKey("CollectionTagsId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.SeriesMetadata", null) + .WithMany() + .HasForeignKey("SeriesMetadatasId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityRoleClaim", b => + { + b.HasOne("API.Entities.AppRole", null) + .WithMany() + .HasForeignKey("RoleId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserClaim", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserLogin", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("Microsoft.AspNetCore.Identity.IdentityUserToken", b => + { + b.HasOne("API.Entities.AppUser", null) + .WithMany() + .HasForeignKey("UserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + }); + + modelBuilder.Entity("API.Entities.AppRole", b => + { + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.AppUser", b => + { + b.Navigation("Bookmarks"); + + b.Navigation("Progresses"); + + b.Navigation("Ratings"); + + b.Navigation("ReadingLists"); + + b.Navigation("UserPreferences"); + + b.Navigation("UserRoles"); + }); + + modelBuilder.Entity("API.Entities.Chapter", b => + { + b.Navigation("Files"); + }); + + modelBuilder.Entity("API.Entities.Library", b => + { + b.Navigation("Folders"); + + b.Navigation("Series"); + }); + + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Navigation("Items"); + }); + + modelBuilder.Entity("API.Entities.Series", b => + { + b.Navigation("Metadata"); + + b.Navigation("Volumes"); + }); + + modelBuilder.Entity("API.Entities.Volume", b => + { + b.Navigation("Chapters"); + }); +#pragma warning restore 612, 618 + } + } +} diff --git a/API/Data/Migrations/20210916142418_EntityImageRefactor.cs b/API/Data/Migrations/20210916142418_EntityImageRefactor.cs new file mode 100644 index 000000000..deafb134b --- /dev/null +++ b/API/Data/Migrations/20210916142418_EntityImageRefactor.cs @@ -0,0 +1,97 @@ +using System; +using Microsoft.EntityFrameworkCore.Migrations; + +namespace API.Data.Migrations +{ + public partial class EntityImageRefactor : Migration + { + protected override void Up(MigrationBuilder migrationBuilder) + { + migrationBuilder.DropColumn( + name: "RowVersion", + table: "AppUserProgresses"); + + migrationBuilder.AlterColumn( + name: "CoverImage", + table: "Volume", + type: "TEXT", + nullable: true, + oldClrType: typeof(byte[]), + oldType: "BLOB", + oldNullable: true); + + migrationBuilder.AlterColumn( + name: "CoverImage", + table: "Series", + type: "TEXT", + nullable: true, + oldClrType: typeof(byte[]), + oldType: "BLOB", + oldNullable: true); + + migrationBuilder.AlterColumn( + name: "CoverImage", + table: "CollectionTag", + type: "TEXT", + nullable: true, + oldClrType: typeof(byte[]), + oldType: "BLOB", + oldNullable: true); + + migrationBuilder.AlterColumn( + name: "CoverImage", + table: "Chapter", + type: "TEXT", + nullable: true, + oldClrType: typeof(byte[]), + oldType: "BLOB", + oldNullable: true); + } + + protected override void Down(MigrationBuilder migrationBuilder) + { + migrationBuilder.AlterColumn( + name: "CoverImage", + table: "Volume", + type: "BLOB", + nullable: true, + oldClrType: typeof(string), + oldType: "TEXT", + oldNullable: true); + + migrationBuilder.AlterColumn( + name: "CoverImage", + table: "Series", + type: "BLOB", + nullable: true, + oldClrType: typeof(string), + oldType: "TEXT", + oldNullable: true); + + migrationBuilder.AlterColumn( + name: "CoverImage", + table: "CollectionTag", + type: "BLOB", + nullable: true, + oldClrType: typeof(string), + oldType: "TEXT", + oldNullable: true); + + migrationBuilder.AlterColumn( + name: "CoverImage", + table: "Chapter", + type: "BLOB", + nullable: true, + oldClrType: typeof(string), + oldType: "TEXT", + oldNullable: true); + + migrationBuilder.AddColumn( + name: "RowVersion", + table: "AppUserProgresses", + type: "INTEGER", + nullable: false, + defaultValue: 0u); + } + } +} diff --git a/API/Data/Migrations/DataContextModelSnapshot.cs b/API/Data/Migrations/DataContextModelSnapshot.cs index 9f763c03b..38a09633e 100644 --- a/API/Data/Migrations/DataContextModelSnapshot.cs +++ b/API/Data/Migrations/DataContextModelSnapshot.cs @@ -229,10 +229,6 @@ namespace API.Data.Migrations b.Property("PagesRead") .HasColumnType("INTEGER"); - b.Property("RowVersion") - .IsConcurrencyToken() - .HasColumnType("INTEGER"); - b.Property("SeriesId") .HasColumnType("INTEGER"); @@ -292,8 +288,8 @@ namespace API.Data.Migrations .ValueGeneratedOnAdd() .HasColumnType("INTEGER"); - b.Property("CoverImage") - .HasColumnType("BLOB"); + b.Property("CoverImage") + .HasColumnType("TEXT"); b.Property("CoverImageLocked") .HasColumnType("INTEGER"); @@ -335,8 +331,8 @@ namespace API.Data.Migrations .ValueGeneratedOnAdd() .HasColumnType("INTEGER"); - b.Property("CoverImage") - .HasColumnType("BLOB"); + b.Property("CoverImage") + .HasColumnType("TEXT"); b.Property("CoverImageLocked") .HasColumnType("INTEGER"); @@ -440,14 +436,79 @@ namespace API.Data.Migrations b.ToTable("MangaFile"); }); + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("AppUserId") + .HasColumnType("INTEGER"); + + b.Property("Created") + .HasColumnType("TEXT"); + + b.Property("LastModified") + .HasColumnType("TEXT"); + + b.Property("Promoted") + .HasColumnType("INTEGER"); + + b.Property("Summary") + .HasColumnType("TEXT"); + + b.Property("Title") + .HasColumnType("TEXT"); + + b.HasKey("Id"); + + b.HasIndex("AppUserId"); + + b.ToTable("ReadingList"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.Property("Id") + .ValueGeneratedOnAdd() + .HasColumnType("INTEGER"); + + b.Property("ChapterId") + .HasColumnType("INTEGER"); + + b.Property("Order") + .HasColumnType("INTEGER"); + + b.Property("ReadingListId") + .HasColumnType("INTEGER"); + + b.Property("SeriesId") + .HasColumnType("INTEGER"); + + b.Property("VolumeId") + .HasColumnType("INTEGER"); + + b.HasKey("Id"); + + b.HasIndex("ChapterId"); + + b.HasIndex("ReadingListId"); + + b.HasIndex("SeriesId"); + + b.HasIndex("VolumeId"); + + b.ToTable("ReadingListItem"); + }); + modelBuilder.Entity("API.Entities.Series", b => { b.Property("Id") .ValueGeneratedOnAdd() .HasColumnType("INTEGER"); - b.Property("CoverImage") - .HasColumnType("BLOB"); + b.Property("CoverImage") + .HasColumnType("TEXT"); b.Property("CoverImageLocked") .HasColumnType("INTEGER"); @@ -542,8 +603,8 @@ namespace API.Data.Migrations .ValueGeneratedOnAdd() .HasColumnType("INTEGER"); - b.Property("CoverImage") - .HasColumnType("BLOB"); + b.Property("CoverImage") + .HasColumnType("TEXT"); b.Property("Created") .HasColumnType("TEXT"); @@ -780,6 +841,52 @@ namespace API.Data.Migrations b.Navigation("Chapter"); }); + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.HasOne("API.Entities.AppUser", "AppUser") + .WithMany("ReadingLists") + .HasForeignKey("AppUserId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("AppUser"); + }); + + modelBuilder.Entity("API.Entities.ReadingListItem", b => + { + b.HasOne("API.Entities.Chapter", "Chapter") + .WithMany() + .HasForeignKey("ChapterId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.ReadingList", "ReadingList") + .WithMany("Items") + .HasForeignKey("ReadingListId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Series", "Series") + .WithMany() + .HasForeignKey("SeriesId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.HasOne("API.Entities.Volume", "Volume") + .WithMany() + .HasForeignKey("VolumeId") + .OnDelete(DeleteBehavior.Cascade) + .IsRequired(); + + b.Navigation("Chapter"); + + b.Navigation("ReadingList"); + + b.Navigation("Series"); + + b.Navigation("Volume"); + }); + modelBuilder.Entity("API.Entities.Series", b => { b.HasOne("API.Entities.Library", "Library") @@ -892,6 +999,8 @@ namespace API.Data.Migrations b.Navigation("Ratings"); + b.Navigation("ReadingLists"); + b.Navigation("UserPreferences"); b.Navigation("UserRoles"); @@ -909,6 +1018,11 @@ namespace API.Data.Migrations b.Navigation("Series"); }); + modelBuilder.Entity("API.Entities.ReadingList", b => + { + b.Navigation("Items"); + }); + modelBuilder.Entity("API.Entities.Series", b => { b.Navigation("Metadata"); diff --git a/API/Data/AppUserProgressRepository.cs b/API/Data/Repositories/AppUserProgressRepository.cs similarity index 65% rename from API/Data/AppUserProgressRepository.cs rename to API/Data/Repositories/AppUserProgressRepository.cs index 38912b589..c91e61cd0 100644 --- a/API/Data/AppUserProgressRepository.cs +++ b/API/Data/Repositories/AppUserProgressRepository.cs @@ -1,10 +1,11 @@ using System.Linq; using System.Threading.Tasks; +using API.Entities; using API.Entities.Enums; -using API.Interfaces; +using API.Interfaces.Repositories; using Microsoft.EntityFrameworkCore; -namespace API.Data +namespace API.Data.Repositories { public class AppUserProgressRepository : IAppUserProgressRepository { @@ -15,6 +16,11 @@ namespace API.Data _context = context; } + public void Update(AppUserProgress userProgress) + { + _context.Entry(userProgress).State = EntityState.Modified; + } + /// /// This will remove any entries that have chapterIds that no longer exists. This will execute the save as well. /// @@ -25,8 +31,18 @@ namespace API.Data var rowsToRemove = await _context.AppUserProgresses .Where(progress => !chapterIds.Contains(progress.ChapterId)) .ToListAsync(); - + + var rowsToRemoveBookmarks = await _context.AppUserBookmark + .Where(progress => !chapterIds.Contains(progress.ChapterId)) + .ToListAsync(); + + var rowsToRemoveReadingLists = await _context.ReadingListItem + .Where(item => !chapterIds.Contains(item.ChapterId)) + .ToListAsync(); + _context.RemoveRange(rowsToRemove); + _context.RemoveRange(rowsToRemoveBookmarks); + _context.RemoveRange(rowsToRemoveReadingLists); return await _context.SaveChangesAsync() > 0 ? rowsToRemove.Count : 0; } @@ -45,12 +61,19 @@ namespace API.Data .ToListAsync(); if (seriesIds.Count == 0) return false; - + return await _context.Series .Include(s => s.Library) .Where(s => seriesIds.Contains(s.Id) && s.Library.Type == libraryType) .AsNoTracking() .AnyAsync(); } + + public async Task GetUserProgressAsync(int chapterId, int userId) + { + return await _context.AppUserProgresses + .Where(p => p.ChapterId == chapterId && p.AppUserId == userId) + .FirstOrDefaultAsync(); + } } -} \ No newline at end of file +} diff --git a/API/Data/Repositories/ChapterRepository.cs b/API/Data/Repositories/ChapterRepository.cs new file mode 100644 index 000000000..f1905eaa8 --- /dev/null +++ b/API/Data/Repositories/ChapterRepository.cs @@ -0,0 +1,191 @@ +using System.Collections.Generic; +using System.IO; +using System.Linq; +using System.Text; +using System.Threading.Tasks; +using API.DTOs; +using API.DTOs.Reader; +using API.Entities; +using API.Interfaces.Repositories; +using AutoMapper; +using AutoMapper.QueryableExtensions; +using Microsoft.EntityFrameworkCore; + +namespace API.Data.Repositories +{ + public class ChapterRepository : IChapterRepository + { + private readonly DataContext _context; + private readonly IMapper _mapper; + + public ChapterRepository(DataContext context, IMapper mapper) + { + _context = context; + _mapper = mapper; + } + + public void Update(Chapter chapter) + { + _context.Entry(chapter).State = EntityState.Modified; + } + + public async Task> GetChaptersByIdsAsync(IList chapterIds) + { + return await _context.Chapter + .Where(c => chapterIds.Contains(c.Id)) + .Include(c => c.Volume) + .ToListAsync(); + } + + /// + /// Populates a partial IChapterInfoDto + /// + /// + public async Task GetChapterInfoDtoAsync(int chapterId) + { + return await _context.Chapter + .Where(c => c.Id == chapterId) + .Join(_context.Volume, c => c.VolumeId, v => v.Id, (chapter, volume) => new + { + ChapterNumber = chapter.Range, + VolumeNumber = volume.Number, + VolumeId = volume.Id, + chapter.IsSpecial, + volume.SeriesId, + chapter.Pages + }) + .Join(_context.Series, data => data.SeriesId, series => series.Id, (data, series) => new + { + data.ChapterNumber, + data.VolumeNumber, + data.VolumeId, + data.IsSpecial, + data.SeriesId, + data.Pages, + SeriesFormat = series.Format, + SeriesName = series.Name, + series.LibraryId + }) + .Select(data => new BookInfoDto() + { + ChapterNumber = data.ChapterNumber, + VolumeNumber = data.VolumeNumber + string.Empty, + VolumeId = data.VolumeId, + IsSpecial = data.IsSpecial, + SeriesId =data.SeriesId, + SeriesFormat = data.SeriesFormat, + SeriesName = data.SeriesName, + LibraryId = data.LibraryId, + Pages = data.Pages + }) + .AsNoTracking() + .SingleAsync(); + } + + public Task GetChapterTotalPagesAsync(int chapterId) + { + return _context.Chapter + .Where(c => c.Id == chapterId) + .Select(c => c.Pages) + .SingleOrDefaultAsync(); + } + public async Task GetChapterDtoAsync(int chapterId) + { + var chapter = await _context.Chapter + .Include(c => c.Files) + .ProjectTo(_mapper.ConfigurationProvider) + .AsNoTracking() + .SingleOrDefaultAsync(c => c.Id == chapterId); + + return chapter; + } + + /// + /// Returns non-tracked files for a given chapterId + /// + /// + /// + public async Task> GetFilesForChapterAsync(int chapterId) + { + return await _context.MangaFile + .Where(c => chapterId == c.ChapterId) + .AsNoTracking() + .ToListAsync(); + } + + /// + /// Returns a Chapter for an Id. Includes linked s. + /// + /// + /// + public async Task GetChapterAsync(int chapterId) + { + return await _context.Chapter + .Include(c => c.Files) + .SingleOrDefaultAsync(c => c.Id == chapterId); + } + + /// + /// Returns Chapters for a volume id. + /// + /// + /// + public async Task> GetChaptersAsync(int volumeId) + { + return await _context.Chapter + .Where(c => c.VolumeId == volumeId) + .ToListAsync(); + } + + /// + /// Returns the cover image for a chapter id. + /// + /// + /// + public async Task GetChapterCoverImageAsync(int chapterId) + { + + return await _context.Chapter + .Where(c => c.Id == chapterId) + .Select(c => c.CoverImage) + .AsNoTracking() + .SingleOrDefaultAsync(); + } + + public async Task> GetAllCoverImagesAsync() + { + return await _context.Chapter + .Select(c => c.CoverImage) + .Where(t => !string.IsNullOrEmpty(t)) + .AsNoTracking() + .ToListAsync(); + } + + /// + /// Returns cover images for locked chapters + /// + /// + public async Task> GetCoverImagesForLockedChaptersAsync() + { + return await _context.Chapter + .Where(c => c.CoverImageLocked) + .Select(c => c.CoverImage) + .Where(t => !string.IsNullOrEmpty(t)) + .AsNoTracking() + .ToListAsync(); + } + + /// + /// Returns non-tracked files for a set of + /// + /// List of chapter Ids + /// + public async Task> GetFilesForChaptersAsync(IReadOnlyList chapterIds) + { + return await _context.MangaFile + .Where(c => chapterIds.Contains(c.ChapterId)) + .AsNoTracking() + .ToListAsync(); + } + } +} diff --git a/API/Data/CollectionTagRepository.cs b/API/Data/Repositories/CollectionTagRepository.cs similarity index 87% rename from API/Data/CollectionTagRepository.cs rename to API/Data/Repositories/CollectionTagRepository.cs index b694b0bb8..777e82788 100644 --- a/API/Data/CollectionTagRepository.cs +++ b/API/Data/Repositories/CollectionTagRepository.cs @@ -1,14 +1,15 @@ using System.Collections.Generic; +using System.IO; using System.Linq; using System.Threading.Tasks; using API.DTOs; using API.Entities; -using API.Interfaces; +using API.Interfaces.Repositories; using AutoMapper; using AutoMapper.QueryableExtensions; using Microsoft.EntityFrameworkCore; -namespace API.Data +namespace API.Data.Repositories { public class CollectionTagRepository : ICollectionTagRepository { @@ -48,11 +49,19 @@ namespace API.Data public async Task> GetAllTagsAsync() { return await _context.CollectionTag - .Select(c => c) .OrderBy(c => c.NormalizedTitle) .ToListAsync(); } + public async Task> GetAllCoverImagesAsync() + { + return await _context.CollectionTag + .Select(t => t.CoverImage) + .Where(t => !string.IsNullOrEmpty(t)) + .AsNoTracking() + .ToListAsync(); + } + public async Task> GetAllTagDtosAsync() { return await _context.CollectionTag @@ -100,9 +109,9 @@ namespace API.Data .ToListAsync(); } - public Task GetCoverImageAsync(int collectionTagId) + public async Task GetCoverImageAsync(int collectionTagId) { - return _context.CollectionTag + return await _context.CollectionTag .Where(c => c.Id == collectionTagId) .Select(c => c.CoverImage) .AsNoTracking() diff --git a/API/Data/FileRepository.cs b/API/Data/Repositories/FileRepository.cs similarity index 92% rename from API/Data/FileRepository.cs rename to API/Data/Repositories/FileRepository.cs index c3234abba..4665dac7e 100644 --- a/API/Data/FileRepository.cs +++ b/API/Data/Repositories/FileRepository.cs @@ -2,10 +2,10 @@ using System.IO; using System.Linq; using System.Threading.Tasks; -using API.Interfaces; +using API.Interfaces.Repositories; using Microsoft.EntityFrameworkCore; -namespace API.Data +namespace API.Data.Repositories { public class FileRepository : IFileRepository { diff --git a/API/Data/LibraryRepository.cs b/API/Data/Repositories/LibraryRepository.cs similarity index 98% rename from API/Data/LibraryRepository.cs rename to API/Data/Repositories/LibraryRepository.cs index 23ad6ea76..7f3544aee 100644 --- a/API/Data/LibraryRepository.cs +++ b/API/Data/Repositories/LibraryRepository.cs @@ -4,12 +4,12 @@ using System.Threading.Tasks; using API.DTOs; using API.Entities; using API.Entities.Enums; -using API.Interfaces; +using API.Interfaces.Repositories; using AutoMapper; using AutoMapper.QueryableExtensions; using Microsoft.EntityFrameworkCore; -namespace API.Data +namespace API.Data.Repositories { public class LibraryRepository : ILibraryRepository { diff --git a/API/Data/Repositories/ReadingListRepository.cs b/API/Data/Repositories/ReadingListRepository.cs new file mode 100644 index 000000000..4f44bc943 --- /dev/null +++ b/API/Data/Repositories/ReadingListRepository.cs @@ -0,0 +1,178 @@ +using System.Collections.Generic; +using System.Linq; +using System.Threading.Tasks; +using API.DTOs.ReadingLists; +using API.Entities; +using API.Helpers; +using API.Interfaces.Repositories; +using AutoMapper; +using AutoMapper.QueryableExtensions; +using Microsoft.EntityFrameworkCore; + +namespace API.Data.Repositories +{ + public class ReadingListRepository : IReadingListRepository + { + private readonly DataContext _context; + private readonly IMapper _mapper; + + public ReadingListRepository(DataContext context, IMapper mapper) + { + _context = context; + _mapper = mapper; + } + + public void Update(ReadingList list) + { + _context.Entry(list).State = EntityState.Modified; + } + + public void Remove(ReadingListItem item) + { + _context.ReadingListItem.Remove(item); + } + + public void BulkRemove(IEnumerable items) + { + _context.ReadingListItem.RemoveRange(items); + } + + + public async Task> GetReadingListDtosForUserAsync(int userId, bool includePromoted, UserParams userParams) + { + var query = _context.ReadingList + .Where(l => l.AppUserId == userId || (includePromoted && l.Promoted )) + .OrderBy(l => l.LastModified) + .ProjectTo(_mapper.ConfigurationProvider) + .AsNoTracking(); + + return await PagedList.CreateAsync(query, userParams.PageNumber, userParams.PageSize); + } + + public async Task GetReadingListByIdAsync(int readingListId) + { + return await _context.ReadingList + .Where(r => r.Id == readingListId) + .Include(r => r.Items) + .SingleOrDefaultAsync(); + } + + public async Task> GetReadingListItemDtosByIdAsync(int readingListId, int userId) + { + var userLibraries = _context.Library + .Include(l => l.AppUsers) + .Where(library => library.AppUsers.Any(user => user.Id == userId)) + .AsNoTracking() + .Select(library => library.Id) + .ToList(); + + var items = await _context.ReadingListItem + .Where(s => s.ReadingListId == readingListId) + .Join(_context.Chapter, s => s.ChapterId, chapter => chapter.Id, (data, chapter) => new + { + TotalPages = chapter.Pages, + ChapterNumber = chapter.Range, + readingListItem = data + }) + .Join(_context.Volume, s => s.readingListItem.VolumeId, volume => volume.Id, (data, volume) => new + { + data.readingListItem, + data.TotalPages, + data.ChapterNumber, + VolumeId = volume.Id, + VolumeNumber = volume.Name, + }) + .Join(_context.Series, s => s.readingListItem.SeriesId, series => series.Id, + (data, s) => new + { + SeriesName = s.Name, + SeriesFormat = s.Format, + s.LibraryId, + data.readingListItem, + data.TotalPages, + data.ChapterNumber, + data.VolumeNumber, + data.VolumeId + }) + .Select(data => new ReadingListItemDto() + { + Id = data.readingListItem.Id, + ChapterId = data.readingListItem.ChapterId, + Order = data.readingListItem.Order, + SeriesId = data.readingListItem.SeriesId, + SeriesName = data.SeriesName, + SeriesFormat = data.SeriesFormat, + PagesTotal = data.TotalPages, + ChapterNumber = data.ChapterNumber, + VolumeNumber = data.VolumeNumber, + LibraryId = data.LibraryId, + VolumeId = data.VolumeId, + ReadingListId = data.readingListItem.ReadingListId + }) + .Where(o => userLibraries.Contains(o.LibraryId)) + .OrderBy(rli => rli.Order) + .AsNoTracking() + .ToListAsync(); + + // Attach progress information + var fetchedChapterIds = items.Select(i => i.ChapterId); + var progresses = await _context.AppUserProgresses + .Where(p => fetchedChapterIds.Contains(p.ChapterId)) + .AsNoTracking() + .ToListAsync(); + + foreach (var progress in progresses) + { + var progressItem = items.SingleOrDefault(i => i.ChapterId == progress.ChapterId && i.ReadingListId == readingListId); + if (progressItem == null) continue; + + progressItem.PagesRead = progress.PagesRead; + } + + return items; + } + + public async Task GetReadingListDtoByIdAsync(int readingListId, int userId) + { + return await _context.ReadingList + .Where(r => r.Id == readingListId && (r.AppUserId == userId || r.Promoted)) + .ProjectTo(_mapper.ConfigurationProvider) + .SingleOrDefaultAsync(); + } + + public async Task> AddReadingProgressModifiers(int userId, IList items) + { + var chapterIds = items.Select(i => i.ChapterId).Distinct().ToList(); + var userProgress = await _context.AppUserProgresses + .Where(p => p.AppUserId == userId && chapterIds.Contains(p.ChapterId)) + .AsNoTracking() + .ToListAsync(); + + foreach (var item in items) + { + var progress = userProgress.Where(p => p.ChapterId == item.ChapterId); + item.PagesRead = progress.Sum(p => p.PagesRead); + } + + return items; + } + + public async Task GetReadingListDtoByTitleAsync(string title) + { + return await _context.ReadingList + .Where(r => r.Title.Equals(title)) + .ProjectTo(_mapper.ConfigurationProvider) + .SingleOrDefaultAsync(); + } + + public async Task> GetReadingListItemsByIdAsync(int readingListId) + { + return await _context.ReadingListItem + .Where(r => r.ReadingListId == readingListId) + .OrderBy(r => r.Order) + .ToListAsync(); + } + + + } +} diff --git a/API/Data/SeriesRepository.cs b/API/Data/Repositories/SeriesRepository.cs similarity index 86% rename from API/Data/SeriesRepository.cs rename to API/Data/Repositories/SeriesRepository.cs index b9e2f16cd..3ed415859 100644 --- a/API/Data/SeriesRepository.cs +++ b/API/Data/Repositories/SeriesRepository.cs @@ -1,4 +1,6 @@ -using System.Collections.Generic; +using System; +using System.Collections.Generic; +using System.IO; using System.Linq; using System.Threading.Tasks; using API.Comparators; @@ -7,18 +9,17 @@ using API.DTOs.Filtering; using API.Entities; using API.Extensions; using API.Helpers; -using API.Interfaces; +using API.Interfaces.Repositories; using AutoMapper; using AutoMapper.QueryableExtensions; using Microsoft.EntityFrameworkCore; -namespace API.Data +namespace API.Data.Repositories { public class SeriesRepository : ISeriesRepository { private readonly DataContext _context; private readonly IMapper _mapper; - private readonly NaturalSortComparer _naturalSortComparer = new (); public SeriesRepository(DataContext context, IMapper mapper) { _context = context; @@ -115,16 +116,15 @@ namespace API.Data await AddVolumeModifiers(userId, volumes); SortSpecialChapters(volumes); - - return volumes; } - private void SortSpecialChapters(IEnumerable volumes) + private static void SortSpecialChapters(IEnumerable volumes) { + var sorter = new NaturalSortComparer(); foreach (var v in volumes.Where(vDto => vDto.Number == 0)) { - v.Chapters = v.Chapters.OrderBy(x => x.Range, _naturalSortComparer).ToList(); + v.Chapters = v.Chapters.OrderBy(x => x.Range, sorter).ToList(); } } @@ -189,11 +189,16 @@ namespace API.Data /// /// /// - public async Task> GetVolumesForSeriesAsync(int[] seriesIds) + public async Task> GetVolumesForSeriesAsync(IList seriesIds, bool includeChapters = false) { - return await _context.Volume - .Where(v => seriesIds.Contains(v.SeriesId)) - .ToListAsync(); + var query = _context.Volume + .Where(v => seriesIds.Contains(v.SeriesId)); + + if (includeChapters) + { + query = query.Include(v => v.Chapters); + } + return await query.ToListAsync(); } public async Task DeleteSeriesAsync(int seriesId) @@ -221,27 +226,52 @@ namespace API.Data public async Task GetChapterIdsForSeriesAsync(int[] seriesIds) { - var series = await _context.Series - .Where(s => seriesIds.Contains(s.Id)) - .Include(s => s.Volumes) - .ThenInclude(v => v.Chapters) + var volumes = await _context.Volume + .Where(v => seriesIds.Contains(v.SeriesId)) + .Include(v => v.Chapters) .ToListAsync(); IList chapterIds = new List(); - foreach (var s in series) + foreach (var v in volumes) { - foreach (var v in s.Volumes) + foreach (var c in v.Chapters) { - foreach (var c in v.Chapters) - { - chapterIds.Add(c.Id); - } + chapterIds.Add(c.Id); } } return chapterIds.ToArray(); } + /// + /// This returns a list of tuples back for each series id passed + /// + /// + /// + public async Task>> GetChapterIdWithSeriesIdForSeriesAsync(int[] seriesIds) + { + var volumes = await _context.Volume + .Where(v => seriesIds.Contains(v.SeriesId)) + .Include(v => v.Chapters) + .ToListAsync(); + + var seriesChapters = new Dictionary>(); + foreach (var v in volumes) + { + foreach (var c in v.Chapters) + { + if (!seriesChapters.ContainsKey(v.SeriesId)) + { + var list = new List(); + seriesChapters.Add(v.SeriesId, list); + } + seriesChapters[v.SeriesId].Add(c.Id); + } + } + + return seriesChapters; + } + public async Task AddSeriesModifiers(int userId, List series) { var userProgress = await _context.AppUserProgresses @@ -262,16 +292,7 @@ namespace API.Data } } - public async Task GetVolumeCoverImageAsync(int volumeId) - { - return await _context.Volume - .Where(v => v.Id == volumeId) - .Select(v => v.CoverImage) - .AsNoTracking() - .SingleOrDefaultAsync(); - } - - public async Task GetSeriesCoverImageAsync(int seriesId) + public async Task GetSeriesCoverImageAsync(int seriesId) { return await _context.Series .Where(s => s.Id == seriesId) @@ -282,8 +303,9 @@ namespace API.Data private async Task AddVolumeModifiers(int userId, IReadOnlyCollection volumes) { + var volIds = volumes.Select(s => s.Id); var userProgress = await _context.AppUserProgresses - .Where(p => p.AppUserId == userId && volumes.Select(s => s.Id).Contains(p.VolumeId)) + .Where(p => p.AppUserId == userId && volIds.Contains(p.VolumeId)) .AsNoTracking() .ToListAsync(); @@ -457,5 +479,23 @@ namespace API.Data .AsSplitQuery() .ToListAsync(); } + + public async Task> GetAllCoverImagesAsync() + { + return await _context.Series + .Select(s => s.CoverImage) + .Where(t => !string.IsNullOrEmpty(t)) + .AsNoTracking() + .ToListAsync(); + } + + public async Task> GetLockedCoverImagesAsync() + { + return await _context.Series + .Where(s => s.CoverImageLocked && !string.IsNullOrEmpty(s.CoverImage)) + .Select(s => s.CoverImage) + .AsNoTracking() + .ToListAsync(); + } } } diff --git a/API/Data/SettingsRepository.cs b/API/Data/Repositories/SettingsRepository.cs similarity index 94% rename from API/Data/SettingsRepository.cs rename to API/Data/Repositories/SettingsRepository.cs index ecacf0f87..1eb0165bb 100644 --- a/API/Data/SettingsRepository.cs +++ b/API/Data/Repositories/SettingsRepository.cs @@ -4,11 +4,11 @@ using System.Threading.Tasks; using API.DTOs; using API.Entities; using API.Entities.Enums; -using API.Interfaces; +using API.Interfaces.Repositories; using AutoMapper; using Microsoft.EntityFrameworkCore; -namespace API.Data +namespace API.Data.Repositories { public class SettingsRepository : ISettingsRepository { @@ -45,4 +45,4 @@ namespace API.Data return await _context.ServerSetting.ToListAsync(); } } -} \ No newline at end of file +} diff --git a/API/Data/UserRepository.cs b/API/Data/Repositories/UserRepository.cs similarity index 56% rename from API/Data/UserRepository.cs rename to API/Data/Repositories/UserRepository.cs index 2e0b9e7f3..4e20039c7 100644 --- a/API/Data/UserRepository.cs +++ b/API/Data/Repositories/UserRepository.cs @@ -1,17 +1,29 @@ -using System.Collections.Generic; +using System; +using System.Collections.Generic; using System.Linq; using System.Threading.Tasks; using API.Constants; using API.DTOs; +using API.DTOs.Reader; using API.Entities; -using API.Interfaces; +using API.Interfaces.Repositories; using AutoMapper; using AutoMapper.QueryableExtensions; using Microsoft.AspNetCore.Identity; using Microsoft.EntityFrameworkCore; -namespace API.Data +namespace API.Data.Repositories { + [Flags] + public enum AppUserIncludes + { + None = 1, + Progress = 2, + Bookmarks = 4, + ReadingLists = 8, + Ratings = 16 + } + public class UserRepository : IUserRepository { private readonly DataContext _context; @@ -35,35 +47,105 @@ namespace API.Data _context.Entry(preferences).State = EntityState.Modified; } + public void Update(AppUserBookmark bookmark) + { + _context.Entry(bookmark).State = EntityState.Modified; + } + public void Delete(AppUser user) { _context.AppUser.Remove(user); } /// - /// Gets an AppUser by username. Returns back Progress information. + /// A one stop shop to get a tracked AppUser instance with any number of JOINs generated by passing bitwise flags. /// /// + /// Includes() you want. Pass multiple with flag1 | flag2 /// - public async Task GetUserByUsernameAsync(string username) + public async Task GetUserByUsernameAsync(string username, AppUserIncludes includeFlags = AppUserIncludes.None) { - return await _context.Users - .Include(u => u.Progresses) - .Include(u => u.Bookmarks) - .SingleOrDefaultAsync(x => x.UserName == username); + var query = _context.Users + .Where(x => x.UserName == username); + + query = AddIncludesToQuery(query, includeFlags); + + return await query.SingleOrDefaultAsync(); } /// - /// Gets an AppUser by id. Returns back Progress information. + /// A one stop shop to get a tracked AppUser instance with any number of JOINs generated by passing bitwise flags. + /// + /// + /// Includes() you want. Pass multiple with flag1 | flag2 + /// + public async Task GetUserByIdAsync(int userId, AppUserIncludes includeFlags = AppUserIncludes.None) + { + var query = _context.Users + .Where(x => x.Id == userId); + + query = AddIncludesToQuery(query, includeFlags); + + return await query.SingleOrDefaultAsync(); + } + + public async Task GetBookmarkForPage(int page, int chapterId, int userId) + { + return await _context.AppUserBookmark + .Where(b => b.Page == page && b.ChapterId == chapterId && b.AppUserId == userId) + .SingleOrDefaultAsync(); + } + + private static IQueryable AddIncludesToQuery(IQueryable query, AppUserIncludes includeFlags) + { + if (includeFlags.HasFlag(AppUserIncludes.Bookmarks)) + { + query = query.Include(u => u.Bookmarks); + } + + if (includeFlags.HasFlag(AppUserIncludes.Progress)) + { + query = query.Include(u => u.Progresses); + } + + if (includeFlags.HasFlag(AppUserIncludes.ReadingLists)) + { + query = query.Include(u => u.ReadingLists); + } + + if (includeFlags.HasFlag(AppUserIncludes.Ratings)) + { + query = query.Include(u => u.Ratings); + } + + return query; + } + + + /// + /// This fetches the Id for a user. Use whenever you just need an ID. /// /// /// - public async Task GetUserByIdAsync(int id) + public async Task GetUserIdByUsernameAsync(string username) { return await _context.Users - .Include(u => u.Progresses) - .Include(u => u.Bookmarks) - .SingleOrDefaultAsync(x => x.Id == id); + .Where(x => x.UserName == username) + .Select(u => u.Id) + .SingleOrDefaultAsync(); + } + + /// + /// Gets an AppUser by username. Returns back Reading List and their Items. + /// + /// + /// + public async Task GetUserWithReadingListsByUsernameAsync(string username) + { + return await _context.Users + .Include(u => u.ReadingLists) + .ThenInclude(l => l.Items) + .SingleOrDefaultAsync(x => x.UserName == username); } public async Task> GetAdminUsersAsync() @@ -77,11 +159,6 @@ namespace API.Data .SingleOrDefaultAsync(); } - public void AddRatingTracking(AppUserRating userRating) - { - _context.AppUserRating.Add(userRating); - } - public async Task GetPreferencesAsync(string username) { return await _context.AppUserPreferences @@ -129,10 +206,17 @@ namespace API.Data .ToListAsync(); } - public async Task GetUserByApiKeyAsync(string apiKey) + /// + /// Fetches the UserId by API Key. This does not include any extra information + /// + /// + /// + public async Task GetUserIdByApiKeyAsync(string apiKey) { return await _context.AppUser - .SingleOrDefaultAsync(u => u.ApiKey.Equals(apiKey)); + .Where(u => u.ApiKey.Equals(apiKey)) + .Select(u => u.Id) + .SingleOrDefaultAsync(); } diff --git a/API/Data/Repositories/VolumeRepository.cs b/API/Data/Repositories/VolumeRepository.cs new file mode 100644 index 000000000..d991a928c --- /dev/null +++ b/API/Data/Repositories/VolumeRepository.cs @@ -0,0 +1,56 @@ +using System.Collections.Generic; +using System.IO; +using System.Linq; +using System.Threading.Tasks; +using API.DTOs; +using API.DTOs.Reader; +using API.Entities; +using API.Interfaces.Repositories; +using AutoMapper; +using AutoMapper.QueryableExtensions; +using Microsoft.EntityFrameworkCore; + +namespace API.Data.Repositories +{ + public class VolumeRepository : IVolumeRepository + { + private readonly DataContext _context; + + public VolumeRepository(DataContext context) + { + _context = context; + } + + public void Update(Volume volume) + { + _context.Entry(volume).State = EntityState.Modified; + } + + public async Task> GetFilesForVolume(int volumeId) + { + return await _context.Chapter + .Where(c => volumeId == c.VolumeId) + .Include(c => c.Files) + .SelectMany(c => c.Files) + .AsNoTracking() + .ToListAsync(); + } + + public async Task GetVolumeCoverImageAsync(int volumeId) + { + return await _context.Volume + .Where(v => v.Id == volumeId) + .Select(v => v.CoverImage) + .AsNoTracking() + .SingleOrDefaultAsync(); + } + + public async Task> GetChapterIdsByVolumeIds(IReadOnlyList volumeIds) + { + return await _context.Chapter + .Where(c => volumeIds.Contains(c.VolumeId)) + .Select(c => c.Id) + .ToListAsync(); + } + } +} diff --git a/API/Data/UnitOfWork.cs b/API/Data/UnitOfWork.cs index 25ac5654c..017293be0 100644 --- a/API/Data/UnitOfWork.cs +++ b/API/Data/UnitOfWork.cs @@ -1,4 +1,5 @@ using System.Threading.Tasks; +using API.Data.Repositories; using API.Entities; using API.Interfaces; using API.Interfaces.Repositories; @@ -24,14 +25,15 @@ namespace API.Data public IUserRepository UserRepository => new UserRepository(_context, _userManager, _mapper); public ILibraryRepository LibraryRepository => new LibraryRepository(_context, _mapper); - public IVolumeRepository VolumeRepository => new VolumeRepository(_context, _mapper); + public IVolumeRepository VolumeRepository => new VolumeRepository(_context); public ISettingsRepository SettingsRepository => new SettingsRepository(_context, _mapper); public IAppUserProgressRepository AppUserProgressRepository => new AppUserProgressRepository(_context); public ICollectionTagRepository CollectionTagRepository => new CollectionTagRepository(_context, _mapper); public IFileRepository FileRepository => new FileRepository(_context); - public IChapterRepository ChapterRepository => new ChapterRepository(_context); + public IChapterRepository ChapterRepository => new ChapterRepository(_context, _mapper); + public IReadingListRepository ReadingListRepository => new ReadingListRepository(_context, _mapper); /// /// Commits changes to the DB. Completes the open transaction. @@ -39,7 +41,6 @@ namespace API.Data /// public bool Commit() { - return _context.SaveChanges() > 0; } /// diff --git a/API/Data/VolumeRepository.cs b/API/Data/VolumeRepository.cs deleted file mode 100644 index c10a3a04e..000000000 --- a/API/Data/VolumeRepository.cs +++ /dev/null @@ -1,116 +0,0 @@ -using System.Collections.Generic; -using System.Linq; -using System.Threading.Tasks; -using API.DTOs; -using API.Entities; -using API.Interfaces; -using AutoMapper; -using AutoMapper.QueryableExtensions; -using Microsoft.EntityFrameworkCore; - -namespace API.Data -{ - public class VolumeRepository : IVolumeRepository - { - private readonly DataContext _context; - private readonly IMapper _mapper; - - public VolumeRepository(DataContext context, IMapper mapper) - { - _context = context; - _mapper = mapper; - } - - public void Update(Volume volume) - { - _context.Entry(volume).State = EntityState.Modified; - } - - /// - /// Returns a Chapter for an Id. Includes linked s. - /// - /// - /// - public async Task GetChapterAsync(int chapterId) - { - return await _context.Chapter - .Include(c => c.Files) - .SingleOrDefaultAsync(c => c.Id == chapterId); - } - - /// - /// Returns Chapters for a volume id. - /// - /// - /// - public async Task> GetChaptersAsync(int volumeId) - { - return await _context.Chapter - .Where(c => c.VolumeId == volumeId) - .ToListAsync(); - } - - /// - /// Returns the cover image for a chapter id. - /// - /// - /// - public async Task GetChapterCoverImageAsync(int chapterId) - { - return await _context.Chapter - .Where(c => c.Id == chapterId) - .Select(c => c.CoverImage) - .AsNoTracking() - .SingleOrDefaultAsync(); - } - - - - - public async Task GetChapterDtoAsync(int chapterId) - { - var chapter = await _context.Chapter - .Include(c => c.Files) - .ProjectTo(_mapper.ConfigurationProvider) - .AsNoTracking() - .SingleOrDefaultAsync(c => c.Id == chapterId); - - return chapter; - } - - /// - /// Returns non-tracked files for a given chapterId - /// - /// - /// - public async Task> GetFilesForChapterAsync(int chapterId) - { - return await _context.MangaFile - .Where(c => chapterId == c.ChapterId) - .AsNoTracking() - .ToListAsync(); - } - /// - /// Returns non-tracked files for a set of chapterIds - /// - /// - /// - public async Task> GetFilesForChaptersAsync(IReadOnlyList chapterIds) - { - return await _context.MangaFile - .Where(c => chapterIds.Contains(c.ChapterId)) - .AsNoTracking() - .ToListAsync(); - } - - public async Task> GetFilesForVolume(int volumeId) - { - return await _context.Chapter - .Where(c => volumeId == c.VolumeId) - .Include(c => c.Files) - .SelectMany(c => c.Files) - .AsNoTracking() - .ToListAsync(); - } - } -} diff --git a/API/Entities/AppUser.cs b/API/Entities/AppUser.cs index c4a24e405..b959fac1a 100644 --- a/API/Entities/AppUser.cs +++ b/API/Entities/AppUser.cs @@ -18,6 +18,10 @@ namespace API.Entities public AppUserPreferences UserPreferences { get; set; } public ICollection Bookmarks { get; set; } /// + /// Reading lists associated with this user + /// + public ICollection ReadingLists { get; set; } + /// /// An API Key to interact with external services, like OPDS /// public string ApiKey { get; set; } diff --git a/API/Entities/AppUserProgress.cs b/API/Entities/AppUserProgress.cs index cb3c1b33c..08fffa540 100644 --- a/API/Entities/AppUserProgress.cs +++ b/API/Entities/AppUserProgress.cs @@ -9,7 +9,7 @@ namespace API.Entities /// Represents the progress a single user has on a given Chapter. /// //[Index(nameof(SeriesId), nameof(VolumeId), nameof(ChapterId), nameof(AppUserId), IsUnique = true)] - public class AppUserProgress : IEntityDate, IHasConcurrencyToken + public class AppUserProgress : IEntityDate { /// /// Id of Entity @@ -55,16 +55,5 @@ namespace API.Entities /// Last date this was updated /// public DateTime LastModified { get; set; } - - /// - [ConcurrencyCheck] - public uint RowVersion { get; private set; } - - - /// - public void OnSavingChanges() - { - RowVersion++; - } } } diff --git a/API/Entities/Chapter.cs b/API/Entities/Chapter.cs index 4595ba048..ef12de8ce 100644 --- a/API/Entities/Chapter.cs +++ b/API/Entities/Chapter.cs @@ -23,7 +23,11 @@ namespace API.Entities public ICollection Files { get; set; } public DateTime Created { get; set; } public DateTime LastModified { get; set; } - public byte[] CoverImage { get; set; } + /// + /// Absolute path to the (managed) image file + /// + /// The file is managed internally to Kavita's APPDIR + public string CoverImage { get; set; } public bool CoverImageLocked { get; set; } /// /// Total number of pages in all MangaFiles diff --git a/API/Entities/CollectionTag.cs b/API/Entities/CollectionTag.cs index c9dd4fa92..ee966cafc 100644 --- a/API/Entities/CollectionTag.cs +++ b/API/Entities/CollectionTag.cs @@ -14,11 +14,11 @@ namespace API.Entities /// Visible title of the Tag /// public string Title { get; set; } - /// - /// Cover Image for the collection tag + /// Absolute path to the (managed) image file /// - public byte[] CoverImage { get; set; } + /// The file is managed internally to Kavita's APPDIR + public string CoverImage { get; set; } /// /// Denotes if the CoverImage has been overridden by the user. If so, it will not be updated during normal scan operations. /// diff --git a/API/Entities/MangaFile.cs b/API/Entities/MangaFile.cs index 2376ec721..72c620ce9 100644 --- a/API/Entities/MangaFile.cs +++ b/API/Entities/MangaFile.cs @@ -30,9 +30,13 @@ namespace API.Entities public int ChapterId { get; set; } // Methods + /// + /// If the File on disk's last modified time is after what is stored in MangaFile + /// + /// public bool HasFileBeenModified() { - return !File.GetLastWriteTime(FilePath).Equals(LastModified); + return File.GetLastWriteTime(FilePath) > LastModified; } } } diff --git a/API/Entities/ReadingList.cs b/API/Entities/ReadingList.cs new file mode 100644 index 000000000..ef0b4bd9c --- /dev/null +++ b/API/Entities/ReadingList.cs @@ -0,0 +1,29 @@ +using System; +using System.Collections.Generic; +using API.Entities.Interfaces; + +namespace API.Entities +{ + /// + /// This is a collection of which represent individual chapters and an order. + /// + public class ReadingList : IEntityDate + { + public int Id { get; init; } + public string Title { get; set; } + public string Summary { get; set; } + /// + /// Reading lists that are promoted are only done by admins + /// + public bool Promoted { get; set; } + + public ICollection Items { get; set; } + public DateTime Created { get; set; } + public DateTime LastModified { get; set; } + + // Relationships + public int AppUserId { get; set; } + public AppUser AppUser { get; set; } + + } +} diff --git a/API/Entities/ReadingListItem.cs b/API/Entities/ReadingListItem.cs new file mode 100644 index 000000000..002911131 --- /dev/null +++ b/API/Entities/ReadingListItem.cs @@ -0,0 +1,25 @@ +namespace API.Entities +{ + //[Index(nameof(SeriesId), nameof(VolumeId), nameof(ChapterId), IsUnique = true)] + public class ReadingListItem + { + public int Id { get; init; } + public int SeriesId { get; set; } + public int VolumeId { get; set; } + public int ChapterId { get; set; } + /// + /// Order of the chapter within a Reading List + /// + public int Order { get; set; } + + // Relationship + public ReadingList ReadingList { get; set; } + public int ReadingListId { get; set; } + + // Idea, keep these for easy join statements + public Series Series { get; set; } + public Volume Volume { get; set; } + public Chapter Chapter { get; set; } + + } +} diff --git a/API/Entities/Series.cs b/API/Entities/Series.cs index b2d97751f..899e52bfd 100644 --- a/API/Entities/Series.cs +++ b/API/Entities/Series.cs @@ -36,7 +36,11 @@ namespace API.Entities public string Summary { get; set; } // TODO: Migrate into SeriesMetdata (with Metadata update) public DateTime Created { get; set; } public DateTime LastModified { get; set; } - public byte[] CoverImage { get; set; } + /// + /// Absolute path to the (managed) image file + /// + /// The file is managed internally to Kavita's APPDIR + public string CoverImage { get; set; } /// /// Denotes if the CoverImage has been overridden by the user. If so, it will not be updated during normal scan operations. /// diff --git a/API/Entities/Volume.cs b/API/Entities/Volume.cs index dab9f2e1b..3be7a4d6a 100644 --- a/API/Entities/Volume.cs +++ b/API/Entities/Volume.cs @@ -1,6 +1,7 @@ using System; using System.Collections.Generic; using API.Entities.Interfaces; +using Microsoft.EntityFrameworkCore; namespace API.Entities { @@ -12,7 +13,11 @@ namespace API.Entities public IList Chapters { get; set; } public DateTime Created { get; set; } public DateTime LastModified { get; set; } - public byte[] CoverImage { get; set; } + /// + /// Absolute path to the (managed) image file + /// + /// The file is managed internally to Kavita's APPDIR + public string CoverImage { get; set; } public int Pages { get; set; } @@ -21,4 +26,4 @@ namespace API.Entities public Series Series { get; set; } public int SeriesId { get; set; } } -} \ No newline at end of file +} diff --git a/API/Extensions/FileInfoExtensions.cs b/API/Extensions/FileInfoExtensions.cs index a52141611..f7e1291e7 100644 --- a/API/Extensions/FileInfoExtensions.cs +++ b/API/Extensions/FileInfoExtensions.cs @@ -14,7 +14,6 @@ namespace API.Extensions public static bool HasFileBeenModifiedSince(this FileInfo fileInfo, DateTime comparison) { return DateTime.Compare(fileInfo.LastWriteTime, comparison) > 0; - //return fileInfo?.LastWriteTime > comparison; } } } diff --git a/API/Extensions/HttpExtensions.cs b/API/Extensions/HttpExtensions.cs index db7bcd370..80b52f18f 100644 --- a/API/Extensions/HttpExtensions.cs +++ b/API/Extensions/HttpExtensions.cs @@ -1,4 +1,5 @@ using System.Linq; +using System.Text; using System.Text.Json; using API.Helpers; using Microsoft.AspNetCore.Http; @@ -7,7 +8,7 @@ namespace API.Extensions { public static class HttpExtensions { - public static void AddPaginationHeader(this HttpResponse response, int currentPage, + public static void AddPaginationHeader(this HttpResponse response, int currentPage, int itemsPerPage, int totalItems, int totalPages) { var paginationHeader = new PaginationHeader(currentPage, itemsPerPage, totalItems, totalPages); @@ -15,7 +16,7 @@ namespace API.Extensions { PropertyNamingPolicy = JsonNamingPolicy.CamelCase }; - + response.Headers.Add("Pagination", JsonSerializer.Serialize(paginationHeader, options)); response.Headers.Add("Access-Control-Expose-Headers", "Pagination"); } @@ -31,6 +32,18 @@ namespace API.Extensions using var sha1 = new System.Security.Cryptography.SHA256CryptoServiceProvider(); response.Headers.Add("ETag", string.Concat(sha1.ComputeHash(content).Select(x => x.ToString("X2")))); } - + + /// + /// Calculates SHA256 hash for a cover image filename and sets as ETag. Ensures Cache-Control: private header is added. + /// + /// + /// + public static void AddCacheHeader(this HttpResponse response, string filename) + { + if (filename == null || filename.Length <= 0) return; + using var sha1 = new System.Security.Cryptography.SHA256CryptoServiceProvider(); + response.Headers.Add("ETag", string.Concat(sha1.ComputeHash(Encoding.UTF8.GetBytes(filename)).Select(x => x.ToString("X2")))); + } + } -} \ No newline at end of file +} diff --git a/API/Helpers/AutoMapperProfiles.cs b/API/Helpers/AutoMapperProfiles.cs index 084a7d28c..03445ccb2 100644 --- a/API/Helpers/AutoMapperProfiles.cs +++ b/API/Helpers/AutoMapperProfiles.cs @@ -1,6 +1,8 @@ using System.Collections.Generic; using System.Linq; using API.DTOs; +using API.DTOs.Reader; +using API.DTOs.ReadingLists; using API.Entities; using API.Helpers.Converters; using AutoMapper; @@ -31,6 +33,9 @@ namespace API.Helpers CreateMap(); + CreateMap(); + CreateMap(); + CreateMap() .ForMember(dest => dest.SeriesId, opt => opt.MapFrom(src => src.Id)) diff --git a/API/Helpers/SQLHelper.cs b/API/Helpers/SQLHelper.cs new file mode 100644 index 000000000..fcd44e7da --- /dev/null +++ b/API/Helpers/SQLHelper.cs @@ -0,0 +1,30 @@ +using System; +using System.Collections.Generic; +using System.Data; +using System.Data.Common; +using Microsoft.EntityFrameworkCore; + +namespace API.Helpers +{ + public static class SqlHelper + { + public static List RawSqlQuery(DbContext context, string query, Func map) + { + using var command = context.Database.GetDbConnection().CreateCommand(); + command.CommandText = query; + command.CommandType = CommandType.Text; + + context.Database.OpenConnection(); + + using var result = command.ExecuteReader(); + var entities = new List(); + + while (result.Read()) + { + entities.Add(map(result)); + } + + return entities; + } + } +} diff --git a/API/Interfaces/ITaskScheduler.cs b/API/Interfaces/ITaskScheduler.cs index ead76e36a..08a450ac2 100644 --- a/API/Interfaces/ITaskScheduler.cs +++ b/API/Interfaces/ITaskScheduler.cs @@ -14,7 +14,7 @@ namespace API.Interfaces void CleanupChapters(int[] chapterIds); void RefreshMetadata(int libraryId, bool forceUpdate = true); void CleanupTemp(); - void RefreshSeriesMetadata(int libraryId, int seriesId); + void RefreshSeriesMetadata(int libraryId, int seriesId, bool forceUpdate = false); void ScanSeries(int libraryId, int seriesId, bool forceUpdate = false); void CancelStatsTasks(); void RunStatCollection(); diff --git a/API/Interfaces/IUnitOfWork.cs b/API/Interfaces/IUnitOfWork.cs index 3f7b12146..06b47bbe8 100644 --- a/API/Interfaces/IUnitOfWork.cs +++ b/API/Interfaces/IUnitOfWork.cs @@ -14,6 +14,7 @@ namespace API.Interfaces ICollectionTagRepository CollectionTagRepository { get; } IFileRepository FileRepository { get; } IChapterRepository ChapterRepository { get; } + IReadingListRepository ReadingListRepository { get; } bool Commit(); Task CommitAsync(); bool HasChanges(); diff --git a/API/Interfaces/IVolumeRepository.cs b/API/Interfaces/IVolumeRepository.cs deleted file mode 100644 index 0cd703ee9..000000000 --- a/API/Interfaces/IVolumeRepository.cs +++ /dev/null @@ -1,19 +0,0 @@ -using System.Collections.Generic; -using System.Threading.Tasks; -using API.DTOs; -using API.Entities; - -namespace API.Interfaces -{ - public interface IVolumeRepository - { - void Update(Volume volume); - Task GetChapterAsync(int chapterId); - Task GetChapterDtoAsync(int chapterId); - Task> GetFilesForChapterAsync(int chapterId); - Task> GetFilesForChaptersAsync(IReadOnlyList chapterIds); - Task> GetChaptersAsync(int volumeId); - Task GetChapterCoverImageAsync(int chapterId); - Task> GetFilesForVolume(int volumeId); - } -} diff --git a/API/Interfaces/IAppUserProgressRepository.cs b/API/Interfaces/Repositories/IAppUserProgressRepository.cs similarity index 55% rename from API/Interfaces/IAppUserProgressRepository.cs rename to API/Interfaces/Repositories/IAppUserProgressRepository.cs index 96ada0c50..d37198fb2 100644 --- a/API/Interfaces/IAppUserProgressRepository.cs +++ b/API/Interfaces/Repositories/IAppUserProgressRepository.cs @@ -1,11 +1,14 @@ using System.Threading.Tasks; +using API.Entities; using API.Entities.Enums; -namespace API.Interfaces +namespace API.Interfaces.Repositories { public interface IAppUserProgressRepository { + void Update(AppUserProgress userProgress); Task CleanupAbandonedChapters(); Task UserHasProgress(LibraryType libraryType, int userId); + Task GetUserProgressAsync(int chapterId, int userId); } -} \ No newline at end of file +} diff --git a/API/Interfaces/Repositories/IChapterRepository.cs b/API/Interfaces/Repositories/IChapterRepository.cs index 9f3f39a13..9ce145f4c 100644 --- a/API/Interfaces/Repositories/IChapterRepository.cs +++ b/API/Interfaces/Repositories/IChapterRepository.cs @@ -1,9 +1,24 @@ -using API.Entities; +using System.Collections.Generic; +using System.Threading.Tasks; +using API.DTOs; +using API.DTOs.Reader; +using API.Entities; namespace API.Interfaces.Repositories { public interface IChapterRepository { void Update(Chapter chapter); + Task> GetChaptersByIdsAsync(IList chapterIds); + Task GetChapterInfoDtoAsync(int chapterId); + Task GetChapterTotalPagesAsync(int chapterId); + Task GetChapterAsync(int chapterId); + Task GetChapterDtoAsync(int chapterId); + Task> GetFilesForChapterAsync(int chapterId); + Task> GetChaptersAsync(int volumeId); + Task> GetFilesForChaptersAsync(IReadOnlyList chapterIds); + Task GetChapterCoverImageAsync(int chapterId); + Task> GetAllCoverImagesAsync(); + Task> GetCoverImagesForLockedChaptersAsync(); } } diff --git a/API/Interfaces/ICollectionTagRepository.cs b/API/Interfaces/Repositories/ICollectionTagRepository.cs similarity index 81% rename from API/Interfaces/ICollectionTagRepository.cs rename to API/Interfaces/Repositories/ICollectionTagRepository.cs index 62f813c9d..03a552bd9 100644 --- a/API/Interfaces/ICollectionTagRepository.cs +++ b/API/Interfaces/Repositories/ICollectionTagRepository.cs @@ -3,19 +3,20 @@ using System.Threading.Tasks; using API.DTOs; using API.Entities; -namespace API.Interfaces +namespace API.Interfaces.Repositories { public interface ICollectionTagRepository { void Remove(CollectionTag tag); Task> GetAllTagDtosAsync(); Task> SearchTagDtosAsync(string searchQuery); - Task GetCoverImageAsync(int collectionTagId); + Task GetCoverImageAsync(int collectionTagId); Task> GetAllPromotedTagDtosAsync(); Task GetTagAsync(int tagId); Task GetFullTagAsync(int tagId); void Update(CollectionTag tag); Task RemoveTagsWithoutSeries(); Task> GetAllTagsAsync(); + Task> GetAllCoverImagesAsync(); } } diff --git a/API/Interfaces/IFileRepository.cs b/API/Interfaces/Repositories/IFileRepository.cs similarity index 81% rename from API/Interfaces/IFileRepository.cs rename to API/Interfaces/Repositories/IFileRepository.cs index cde587855..a852032d7 100644 --- a/API/Interfaces/IFileRepository.cs +++ b/API/Interfaces/Repositories/IFileRepository.cs @@ -1,10 +1,10 @@ using System.Collections.Generic; using System.Threading.Tasks; -namespace API.Interfaces +namespace API.Interfaces.Repositories { public interface IFileRepository { Task> GetFileExtensions(); } -} \ No newline at end of file +} diff --git a/API/Interfaces/ILibraryRepository.cs b/API/Interfaces/Repositories/ILibraryRepository.cs similarity index 96% rename from API/Interfaces/ILibraryRepository.cs rename to API/Interfaces/Repositories/ILibraryRepository.cs index 4977d38d5..4d9b03fe4 100644 --- a/API/Interfaces/ILibraryRepository.cs +++ b/API/Interfaces/Repositories/ILibraryRepository.cs @@ -4,7 +4,7 @@ using API.DTOs; using API.Entities; using API.Entities.Enums; -namespace API.Interfaces +namespace API.Interfaces.Repositories { public interface ILibraryRepository { diff --git a/API/Interfaces/Repositories/IReadingListRepository.cs b/API/Interfaces/Repositories/IReadingListRepository.cs new file mode 100644 index 000000000..8b5ab085d --- /dev/null +++ b/API/Interfaces/Repositories/IReadingListRepository.cs @@ -0,0 +1,22 @@ +using System.Collections.Generic; +using System.Threading.Tasks; +using API.DTOs.ReadingLists; +using API.Entities; +using API.Helpers; + +namespace API.Interfaces.Repositories +{ + public interface IReadingListRepository + { + Task> GetReadingListDtosForUserAsync(int userId, bool includePromoted, UserParams userParams); + Task GetReadingListByIdAsync(int readingListId); + Task> GetReadingListItemDtosByIdAsync(int readingListId, int userId); + Task GetReadingListDtoByIdAsync(int readingListId, int userId); + Task> AddReadingProgressModifiers(int userId, IList items); + Task GetReadingListDtoByTitleAsync(string title); + Task> GetReadingListItemsByIdAsync(int readingListId); + void Remove(ReadingListItem item); + void BulkRemove(IEnumerable items); + void Update(ReadingList list); + } +} diff --git a/API/Interfaces/ISeriesRepository.cs b/API/Interfaces/Repositories/ISeriesRepository.cs similarity index 85% rename from API/Interfaces/ISeriesRepository.cs rename to API/Interfaces/Repositories/ISeriesRepository.cs index a5518fc60..05fe937eb 100644 --- a/API/Interfaces/ISeriesRepository.cs +++ b/API/Interfaces/Repositories/ISeriesRepository.cs @@ -1,11 +1,13 @@ -using System.Collections.Generic; +using System; +using System.Collections; +using System.Collections.Generic; using System.Threading.Tasks; using API.DTOs; using API.DTOs.Filtering; using API.Entities; using API.Helpers; -namespace API.Interfaces +namespace API.Interfaces.Repositories { public interface ISeriesRepository { @@ -43,11 +45,12 @@ namespace API.Interfaces /// /// Task GetVolumeDtoAsync(int volumeId); - Task> GetVolumesForSeriesAsync(int[] seriesIds); + Task> GetVolumesForSeriesAsync(IList seriesIds, bool includeChapters = false); Task DeleteSeriesAsync(int seriesId); Task GetVolumeByIdAsync(int volumeId); Task GetSeriesByIdAsync(int seriesId); Task GetChapterIdsForSeriesAsync(int[] seriesIds); + Task>> GetChapterIdWithSeriesIdForSeriesAsync(int[] seriesIds); /// /// Used to add Progress/Rating information to series list. /// @@ -56,13 +59,15 @@ namespace API.Interfaces /// Task AddSeriesModifiers(int userId, List series); - Task GetVolumeCoverImageAsync(int volumeId); - Task GetSeriesCoverImageAsync(int seriesId); + + Task GetSeriesCoverImageAsync(int seriesId); Task> GetInProgress(int userId, int libraryId, UserParams userParams, FilterDto filter); Task> GetRecentlyAdded(int libraryId, int userId, UserParams userParams, FilterDto filter); Task GetSeriesMetadata(int seriesId); Task> GetSeriesDtoForCollectionAsync(int collectionId, int userId, UserParams userParams); Task> GetFilesForSeries(int seriesId); Task> GetSeriesDtoForIdsAsync(IEnumerable seriesIds, int userId); + Task> GetAllCoverImagesAsync(); + Task> GetLockedCoverImagesAsync(); } } diff --git a/API/Interfaces/ISettingsRepository.cs b/API/Interfaces/Repositories/ISettingsRepository.cs similarity index 90% rename from API/Interfaces/ISettingsRepository.cs rename to API/Interfaces/Repositories/ISettingsRepository.cs index 5b0994d41..f1687743d 100644 --- a/API/Interfaces/ISettingsRepository.cs +++ b/API/Interfaces/Repositories/ISettingsRepository.cs @@ -4,7 +4,7 @@ using API.DTOs; using API.Entities; using API.Entities.Enums; -namespace API.Interfaces +namespace API.Interfaces.Repositories { public interface ISettingsRepository { @@ -12,6 +12,6 @@ namespace API.Interfaces Task GetSettingsDtoAsync(); Task GetSettingAsync(ServerSettingKey key); Task> GetSettingsAsync(); - + } -} \ No newline at end of file +} diff --git a/API/Interfaces/IUserRepository.cs b/API/Interfaces/Repositories/IUserRepository.cs similarity index 58% rename from API/Interfaces/IUserRepository.cs rename to API/Interfaces/Repositories/IUserRepository.cs index c58eafdfc..22bd9dc92 100644 --- a/API/Interfaces/IUserRepository.cs +++ b/API/Interfaces/Repositories/IUserRepository.cs @@ -1,26 +1,31 @@ using System.Collections.Generic; using System.Threading.Tasks; +using API.Data.Repositories; using API.DTOs; +using API.DTOs.Reader; using API.Entities; -namespace API.Interfaces +namespace API.Interfaces.Repositories { public interface IUserRepository { void Update(AppUser user); void Update(AppUserPreferences preferences); + void Update(AppUserBookmark bookmark); public void Delete(AppUser user); - Task GetUserByUsernameAsync(string username); - Task GetUserByIdAsync(int id); Task> GetMembersAsync(); Task> GetAdminUsersAsync(); Task GetUserRating(int seriesId, int userId); - void AddRatingTracking(AppUserRating userRating); Task GetPreferencesAsync(string username); Task> GetBookmarkDtosForSeries(int userId, int seriesId); Task> GetBookmarkDtosForVolume(int userId, int volumeId); Task> GetBookmarkDtosForChapter(int userId, int chapterId); Task> GetAllBookmarkDtos(int userId); - Task GetUserByApiKeyAsync(string apiKey); + Task GetBookmarkForPage(int page, int chapterId, int userId); + Task GetUserIdByApiKeyAsync(string apiKey); + Task GetUserByUsernameAsync(string username, AppUserIncludes includeFlags = AppUserIncludes.None); + Task GetUserByIdAsync(int userId, AppUserIncludes includeFlags = AppUserIncludes.None); + Task GetUserIdByUsernameAsync(string username); + Task GetUserWithReadingListsByUsernameAsync(string username); } } diff --git a/API/Interfaces/Repositories/IVolumeRepository.cs b/API/Interfaces/Repositories/IVolumeRepository.cs new file mode 100644 index 000000000..62ec0ef9a --- /dev/null +++ b/API/Interfaces/Repositories/IVolumeRepository.cs @@ -0,0 +1,15 @@ +using System.Collections.Generic; +using System.Threading.Tasks; +using API.DTOs; +using API.Entities; + +namespace API.Interfaces.Repositories +{ + public interface IVolumeRepository + { + void Update(Volume volume); + Task> GetFilesForVolume(int volumeId); + Task GetVolumeCoverImageAsync(int volumeId); + Task> GetChapterIdsByVolumeIds(IReadOnlyList volumeIds); + } +} diff --git a/API/Interfaces/Services/IArchiveService.cs b/API/Interfaces/Services/IArchiveService.cs index 07c1e287d..ae9bddc98 100644 --- a/API/Interfaces/Services/IArchiveService.cs +++ b/API/Interfaces/Services/IArchiveService.cs @@ -10,7 +10,7 @@ namespace API.Interfaces.Services { void ExtractArchive(string archivePath, string extractPath); int GetNumberOfPagesFromArchive(string archivePath); - byte[] GetCoverImage(string archivePath, bool createThumbnail = false); + string GetCoverImage(string archivePath, string fileName); bool IsValidArchive(string archivePath); string GetSummaryInfo(string archivePath); ArchiveLibrary CanOpen(string archivePath); diff --git a/API/Interfaces/Services/IBackupService.cs b/API/Interfaces/Services/IBackupService.cs index eaa140e46..315b852f0 100644 --- a/API/Interfaces/Services/IBackupService.cs +++ b/API/Interfaces/Services/IBackupService.cs @@ -1,11 +1,12 @@ using System.Collections.Generic; +using System.Threading.Tasks; using Microsoft.Extensions.Configuration; namespace API.Interfaces.Services { public interface IBackupService { - void BackupDatabase(); + Task BackupDatabase(); /// /// Returns a list of full paths of the logs files detailed in . /// diff --git a/API/Interfaces/Services/IBookService.cs b/API/Interfaces/Services/IBookService.cs index b3afc13a8..cde2cad8e 100644 --- a/API/Interfaces/Services/IBookService.cs +++ b/API/Interfaces/Services/IBookService.cs @@ -8,7 +8,7 @@ namespace API.Interfaces.Services public interface IBookService { int GetNumberOfPages(string filePath); - byte[] GetCoverImage(string fileFilePath, bool createThumbnail = true); + string GetCoverImage(string fileFilePath, string fileName); Task> CreateKeyToPageMappingAsync(EpubBookRef book); /// diff --git a/API/Interfaces/Services/ICleanupService.cs b/API/Interfaces/Services/ICleanupService.cs index da61943fe..afabb9900 100644 --- a/API/Interfaces/Services/ICleanupService.cs +++ b/API/Interfaces/Services/ICleanupService.cs @@ -1,7 +1,10 @@ -namespace API.Interfaces.Services +using System.Threading.Tasks; + +namespace API.Interfaces.Services { public interface ICleanupService { - void Cleanup(); + Task Cleanup(); + void CleanupCacheDirectory(); } -} \ No newline at end of file +} diff --git a/API/Interfaces/Services/IImageService.cs b/API/Interfaces/Services/IImageService.cs index 86f6fa489..0aba07f39 100644 --- a/API/Interfaces/Services/IImageService.cs +++ b/API/Interfaces/Services/IImageService.cs @@ -1,22 +1,23 @@ using API.Entities; +using API.Services; namespace API.Interfaces.Services { public interface IImageService { - byte[] GetCoverImage(string path, bool createThumbnail = false); + string GetCoverImage(string path, string fileName); string GetCoverFile(MangaFile file); /// /// Creates a Thumbnail version of an image /// /// Path to the image file - /// - public byte[] CreateThumbnail(string path); + /// File name with extension of the file. This will always write to + public string CreateThumbnail(string path, string fileName); /// /// Creates a Thumbnail version of a base64 image /// /// base64 encoded image - /// - public byte[] CreateThumbnailFromBase64(string encodedImage); + /// File name with extension of the file. This will always write to + public string CreateThumbnailFromBase64(string encodedImage, string fileName); } } diff --git a/API/Interfaces/Services/IMetadataService.cs b/API/Interfaces/Services/IMetadataService.cs index 70b10b861..6d4d725cf 100644 --- a/API/Interfaces/Services/IMetadataService.cs +++ b/API/Interfaces/Services/IMetadataService.cs @@ -1,4 +1,5 @@ -using API.Entities; +using System.Threading.Tasks; +using API.Entities; namespace API.Interfaces.Services { @@ -9,16 +10,16 @@ namespace API.Interfaces.Services /// /// /// - void RefreshMetadata(int libraryId, bool forceUpdate = false); + Task RefreshMetadata(int libraryId, bool forceUpdate = false); - public void UpdateMetadata(Chapter chapter, bool forceUpdate); - public void UpdateMetadata(Volume volume, bool forceUpdate); - public void UpdateMetadata(Series series, bool forceUpdate); + public bool UpdateMetadata(Chapter chapter, bool forceUpdate); + public bool UpdateMetadata(Volume volume, bool forceUpdate); + public bool UpdateMetadata(Series series, bool forceUpdate); /// /// Performs a forced refresh of metatdata just for a series and it's nested entities /// /// /// - void RefreshMetadataForSeries(int libraryId, int seriesId); + Task RefreshMetadataForSeries(int libraryId, int seriesId, bool forceUpdate = false); } -} \ No newline at end of file +} diff --git a/API/Interfaces/Services/IReaderService.cs b/API/Interfaces/Services/IReaderService.cs index 5bb9baeb1..a72b90699 100644 --- a/API/Interfaces/Services/IReaderService.cs +++ b/API/Interfaces/Services/IReaderService.cs @@ -1,4 +1,5 @@ -using System.Threading.Tasks; +using System.Collections.Generic; +using System.Threading.Tasks; using API.DTOs; using API.Entities; @@ -6,6 +7,11 @@ namespace API.Interfaces.Services { public interface IReaderService { - Task SaveReadingProgress(ProgressDto progressDto, AppUser user); + void MarkChaptersAsRead(AppUser user, int seriesId, IEnumerable chapters); + void MarkChaptersAsUnread(AppUser user, int seriesId, IEnumerable chapters); + Task SaveReadingProgress(ProgressDto progressDto, int userId); + Task CapPageToChapter(int chapterId, int page); + Task GetNextChapterIdAsync(int seriesId, int volumeId, int currentChapterId, int userId); + Task GetPrevChapterIdAsync(int seriesId, int volumeId, int currentChapterId, int userId); } } diff --git a/API/Interfaces/Services/IScannerService.cs b/API/Interfaces/Services/IScannerService.cs index d235adfb5..b67290bfc 100644 --- a/API/Interfaces/Services/IScannerService.cs +++ b/API/Interfaces/Services/IScannerService.cs @@ -12,8 +12,8 @@ namespace API.Interfaces.Services /// /// Library to scan against /// Force overwriting for cover images - void ScanLibrary(int libraryId, bool forceUpdate); - void ScanLibraries(); + Task ScanLibrary(int libraryId, bool forceUpdate); + Task ScanLibraries(); Task ScanSeries(int libraryId, int seriesId, bool forceUpdate, CancellationToken token); } } diff --git a/API/Interfaces/Services/ReaderService.cs b/API/Interfaces/Services/ReaderService.cs index f71a10a7a..eaa3b96d7 100644 --- a/API/Interfaces/Services/ReaderService.cs +++ b/API/Interfaces/Services/ReaderService.cs @@ -1,51 +1,146 @@  using System; using System.Collections.Generic; +using System.Data; using System.Linq; using System.Threading.Tasks; +using API.Comparators; +using API.Data.Repositories; using API.DTOs; using API.Entities; +using Microsoft.Extensions.Logging; namespace API.Interfaces.Services { public class ReaderService : IReaderService { private readonly IUnitOfWork _unitOfWork; + private readonly ILogger _logger; + private readonly ChapterSortComparer _chapterSortComparer = new ChapterSortComparer(); + private readonly ChapterSortComparerZeroFirst _chapterSortComparerForInChapterSorting = new ChapterSortComparerZeroFirst(); - public ReaderService(IUnitOfWork unitOfWork) + public ReaderService(IUnitOfWork unitOfWork, ILogger logger) { _unitOfWork = unitOfWork; + _logger = logger; + } + + /// + /// Marks all Chapters as Read by creating or updating UserProgress rows. Does not commit. + /// + /// + /// + /// + public void MarkChaptersAsRead(AppUser user, int seriesId, IEnumerable chapters) + { + foreach (var chapter in chapters) + { + var userProgress = GetUserProgressForChapter(user, chapter); + + if (userProgress == null) + { + user.Progresses.Add(new AppUserProgress + { + PagesRead = chapter.Pages, + VolumeId = chapter.VolumeId, + SeriesId = seriesId, + ChapterId = chapter.Id + }); + } + else + { + userProgress.PagesRead = chapter.Pages; + userProgress.SeriesId = seriesId; + userProgress.VolumeId = chapter.VolumeId; + } + } + } + + /// + /// Marks all Chapters as Unread by creating or updating UserProgress rows. Does not commit. + /// + /// + /// + /// + public void MarkChaptersAsUnread(AppUser user, int seriesId, IEnumerable chapters) + { + foreach (var chapter in chapters) + { + var userProgress = GetUserProgressForChapter(user, chapter); + + if (userProgress == null) + { + user.Progresses.Add(new AppUserProgress + { + PagesRead = 0, + VolumeId = chapter.VolumeId, + SeriesId = seriesId, + ChapterId = chapter.Id + }); + } + else + { + userProgress.PagesRead = 0; + userProgress.SeriesId = seriesId; + userProgress.VolumeId = chapter.VolumeId; + } + } + } + + /// + /// Gets the User Progress for a given Chapter. This will handle any duplicates that might have occured in past versions and will delete them. Does not commit. + /// + /// + /// + /// + public static AppUserProgress GetUserProgressForChapter(AppUser user, Chapter chapter) + { + AppUserProgress userProgress = null; + try + { + userProgress = + user.Progresses.SingleOrDefault(x => x.ChapterId == chapter.Id && x.AppUserId == user.Id); + } + catch (Exception) + { + // There is a very rare chance that user progress will duplicate current row. If that happens delete one with less pages + var progresses = user.Progresses.Where(x => x.ChapterId == chapter.Id && x.AppUserId == user.Id).ToList(); + if (progresses.Count > 1) + { + user.Progresses = new List() + { + user.Progresses.First() + }; + userProgress = user.Progresses.First(); + } + } + + return userProgress; } /// /// Saves progress to DB /// /// - /// + /// /// - public async Task SaveReadingProgress(ProgressDto progressDto, AppUser user) + public async Task SaveReadingProgress(ProgressDto progressDto, int userId) { // Don't let user save past total pages. - var chapter = await _unitOfWork.VolumeRepository.GetChapterAsync(progressDto.ChapterId); - if (progressDto.PageNum > chapter.Pages) - { - progressDto.PageNum = chapter.Pages; - } - - if (progressDto.PageNum < 0) - { - progressDto.PageNum = 0; - } + progressDto.PageNum = await CapPageToChapter(progressDto.ChapterId, progressDto.PageNum); try { - user.Progresses ??= new List(); var userProgress = - user.Progresses.FirstOrDefault(x => x.ChapterId == progressDto.ChapterId && x.AppUserId == user.Id); + await _unitOfWork.AppUserProgressRepository.GetUserProgressAsync(progressDto.ChapterId, userId); if (userProgress == null) { - user.Progresses.Add(new AppUserProgress + // Create a user object + var userWithProgress = + await _unitOfWork.UserRepository.GetUserByIdAsync(userId, AppUserIncludes.Progress); + userWithProgress.Progresses ??= new List(); + userWithProgress.Progresses.Add(new AppUserProgress { PagesRead = progressDto.PageNum, VolumeId = progressDto.VolumeId, @@ -54,6 +149,7 @@ namespace API.Interfaces.Services BookScrollId = progressDto.BookScrollId, LastModified = DateTime.Now }); + _unitOfWork.UserRepository.Update(userWithProgress); } else { @@ -62,21 +158,154 @@ namespace API.Interfaces.Services userProgress.VolumeId = progressDto.VolumeId; userProgress.BookScrollId = progressDto.BookScrollId; userProgress.LastModified = DateTime.Now; + _unitOfWork.AppUserProgressRepository.Update(userProgress); } - _unitOfWork.UserRepository.Update(user); - if (await _unitOfWork.CommitAsync()) { return true; } } - catch (Exception) + catch (Exception exception) { + _logger.LogError(exception, "Could not save progress"); await _unitOfWork.RollbackAsync(); } return false; } + + /// + /// Ensures that the page is within 0 and total pages for a chapter. Makes one DB call. + /// + /// + /// + /// + public async Task CapPageToChapter(int chapterId, int page) + { + var totalPages = await _unitOfWork.ChapterRepository.GetChapterTotalPagesAsync(chapterId); + if (page > totalPages) + { + page = totalPages; + } + + if (page < 0) + { + page = 0; + } + + return page; + } + + /// + /// Tries to find the next logical Chapter + /// + /// + /// V1 → V2 → V3 chapter 0 → V3 chapter 10 → SP 01 → SP 02 + /// + /// + /// + /// + /// + /// -1 if nothing can be found + public async Task GetNextChapterIdAsync(int seriesId, int volumeId, int currentChapterId, int userId) + { + var volumes = (await _unitOfWork.SeriesRepository.GetVolumesDtoAsync(seriesId, userId)).ToList(); + var currentVolume = volumes.Single(v => v.Id == volumeId); + var currentChapter = currentVolume.Chapters.Single(c => c.Id == currentChapterId); + + if (currentVolume.Number == 0) + { + // Handle specials by sorting on their Filename aka Range + var chapterId = GetNextChapterId(currentVolume.Chapters.OrderBy(x => x.Range, new NaturalSortComparer()), currentChapter.Number); + if (chapterId > 0) return chapterId; + } + + foreach (var volume in volumes) + { + if (volume.Number == currentVolume.Number && volume.Chapters.Count > 1) + { + // Handle Chapters within current Volume + // In this case, i need 0 first because 0 represents a full volume file. + var chapterId = GetNextChapterId(currentVolume.Chapters.OrderBy(x => double.Parse(x.Number), _chapterSortComparerForInChapterSorting), currentChapter.Number); + if (chapterId > 0) return chapterId; + } + + if (volume.Number != currentVolume.Number + 1) continue; + + // Handle Chapters within next Volume + // ! When selecting the chapter for the next volume, we need to make sure a c0 comes before a c1+ + var chapters = volume.Chapters.OrderBy(x => double.Parse(x.Number), _chapterSortComparer).ToList(); + if (currentChapter.Number.Equals("0") && chapters.Last().Number.Equals("0")) + { + return chapters.Last().Id; + } + + var firstChapter = chapters.FirstOrDefault(); + if (firstChapter == null) return -1; + return firstChapter.Id; + + } + + return -1; + } + /// + /// Tries to find the prev logical Chapter + /// + /// + /// V1 ← V2 ← V3 chapter 0 ← V3 chapter 10 ← SP 01 ← SP 02 + /// + /// + /// + /// + /// + /// -1 if nothing can be found + public async Task GetPrevChapterIdAsync(int seriesId, int volumeId, int currentChapterId, int userId) + { + var volumes = (await _unitOfWork.SeriesRepository.GetVolumesDtoAsync(seriesId, userId)).Reverse().ToList(); + var currentVolume = volumes.Single(v => v.Id == volumeId); + var currentChapter = currentVolume.Chapters.Single(c => c.Id == currentChapterId); + + if (currentVolume.Number == 0) + { + var chapterId = GetNextChapterId(currentVolume.Chapters.OrderBy(x => x.Range, new NaturalSortComparer()).Reverse(), currentChapter.Number); + if (chapterId > 0) return chapterId; + } + + foreach (var volume in volumes) + { + if (volume.Number == currentVolume.Number) + { + var chapterId = GetNextChapterId(currentVolume.Chapters.OrderBy(x => double.Parse(x.Number), _chapterSortComparerForInChapterSorting).Reverse(), currentChapter.Number); + if (chapterId > 0) return chapterId; + } + if (volume.Number == currentVolume.Number - 1) + { + var lastChapter = volume.Chapters + .OrderBy(x => double.Parse(x.Number), _chapterSortComparerForInChapterSorting).LastOrDefault(); + if (lastChapter == null) return -1; + return lastChapter.Id; + } + } + return -1; + } + + private static int GetNextChapterId(IEnumerable chapters, string currentChapterNumber) + { + var next = false; + var chaptersList = chapters.ToList(); + foreach (var chapter in chaptersList) + { + if (next) + { + return chapter.Id; + } + if (currentChapterNumber.Equals(chapter.Number)) next = true; + } + + return -1; + } + + } } diff --git a/API/Parser/Parser.cs b/API/Parser/Parser.cs index b7b4ee8eb..0650faf4a 100644 --- a/API/Parser/Parser.cs +++ b/API/Parser/Parser.cs @@ -13,7 +13,7 @@ namespace API.Parser public const string DefaultVolume = "0"; private static readonly TimeSpan RegexTimeout = TimeSpan.FromMilliseconds(500); - public const string ImageFileExtensions = @"^(\.png|\.jpeg|\.jpg)"; + public const string ImageFileExtensions = @"^(\.png|\.jpeg|\.jpg|\.webp)"; public const string ArchiveFileExtensions = @"\.cbz|\.zip|\.rar|\.cbr|\.tar.gz|\.7zip|\.7z|\.cb7|\.cbt"; public const string BookFileExtensions = @"\.epub|\.pdf"; public const string MacOsMetadataFileStartsWith = @"._"; @@ -102,11 +102,17 @@ namespace API.Parser @"^(?.*)( |_)Vol\.?(\d+|tbd)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), + // Mad Chimera World - Volume 005 - Chapter 026.cbz (couldn't figure out how to get Volume negative lookaround working on below regex), + // The Duke of Death and His Black Maid - Vol. 04 Ch. 054.5 - V4 Omake + new Regex( + @"(?.+?)(\s|_|-)+(?:Vol(ume|\.)?(\s|_|-)+\d+)(\s|_|-)+(?:(Ch|Chapter|Ch)\.?)(\s|_|-)+(?\d+)", + RegexOptions.IgnoreCase | RegexOptions.Compiled, + RegexTimeout), // Ichiban_Ushiro_no_Daimaou_v04_ch34_[VISCANS].zip, VanDread-v01-c01.zip new Regex( - @"(?.*)(\b|_)v(?\d+-?\d*)(\s|_|-)", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), + @"(?.*)(\b|_)v(?\d+-?\d*)(\s|_|-)", + RegexOptions.IgnoreCase | RegexOptions.Compiled, + RegexTimeout), // Gokukoku no Brynhildr - c001-008 (v01) [TrinityBAKumA], Black Bullet - v4 c17 [batoto] new Regex( @"(?.*)( - )(?:v|vo|c)\d", @@ -117,11 +123,6 @@ namespace API.Parser @"(?.*)(?:, Chapter )(?\d+)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), - // Mad Chimera World - Volume 005 - Chapter 026.cbz (couldn't figure out how to get Volume negative lookaround working on below regex) - new Regex( - @"(?.*)(\s|_|-)(?:Volume(\s|_|-)+\d+)(\s|_|-)+(?:Chapter)(\s|_|-)(?\d+)", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), // Please Go Home, Akutsu-San! - Chapter 038.5 - Volume Announcement.cbz new Regex( @"(?.*)(\s|_|-)(?!Vol)(\s|_|-)(?:Chapter)(\s|_|-)(?\d+)", @@ -129,9 +130,14 @@ namespace API.Parser RegexTimeout), // [dmntsf.net] One Piece - Digital Colored Comics Vol. 20 Ch. 177 - 30 Million vs 81 Million.cbz new Regex( - @"(?.*) (\b|_|-)(vol)\.?", + @"(?.*) (\b|_|-)(vol)\.?(\s|-|_)?\d+", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), + // [xPearse] Kyochuu Rettou Volume 1 [English] [Manga] [Volume Scans] + new Regex( + @"(?.*) (\b|_|-)(vol)(ume)", + RegexOptions.IgnoreCase | RegexOptions.Compiled, + RegexTimeout), //Knights of Sidonia c000 (S2 LE BD Omake - BLAME!) [Habanero Scans] new Regex( @"(?.*)(\bc\d+\b)", @@ -144,7 +150,7 @@ namespace API.Parser RegexTimeout), // Momo The Blood Taker - Chapter 027 Violent Emotion.cbz, Grand Blue Dreaming - SP02 Extra (2019) (Digital) (danke-Empire).cbz new Regex( - @"(?.*)(\b|_|-|\s)(?:(chapter(\b|_|-|\s))|sp)\d", + @"^(?(?!Vol).+?)(?:(ch(apter|\.)(\b|_|-|\s))|sp)\d", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), // Historys Strongest Disciple Kenichi_v11_c90-98.zip, Killing Bites Vol. 0001 Ch. 0001 - Galactica Scanlations (gb) @@ -240,9 +246,9 @@ namespace API.Parser @"(?.*)(\s|_|-)#", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), - // Baketeriya ch01-05.zip, Akiiro Bousou Biyori - 01.jpg, Beelzebub_172_RHS.zip, Cynthia the Mission 29.rar + // Baketeriya ch01-05.zip, Akiiro Bousou Biyori - 01.jpg, Beelzebub_172_RHS.zip, Cynthia the Mission 29.rar, A Compendium of Ghosts - 031 - The Third Story_ Part 12 (Digital) (Cobalt001) new Regex( - @"^(?!Vol\.?)(?.*)( |_|-)(?.+?)( |_|-)(?.*)(?: |_)i(ssue) #\d+", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), + // Batman Wayne Family Adventures - Ep. 001 - Moving In + new Regex( + @"^(?.+?)(\s|_|-)?(?:Ep\.?)(\s|_|-)+\d+", + RegexOptions.IgnoreCase | RegexOptions.Compiled, + RegexTimeout), // Batman & Catwoman - Trail of the Gun 01, Batman & Grendel (1996) 01 - Devil's Bones, Teen Titans v1 001 (1966-02) (digital) (OkC.O.M.P.U.T.O.-Novus) new Regex( - @"^(?.*)(?: \d+)", + @"^(?.+?)(?: \d+)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), // Batman & Robin the Teen Wonder #0 @@ -318,78 +329,91 @@ namespace API.Parser private static readonly Regex[] ComicVolumeRegex = new[] { - // 04 - Asterix the Gladiator (1964) (Digital-Empire) (WebP by Doc MaKS) - new Regex( - @"^(?\d+) (- |_)?(?.*(\d{4})?)( |_)(\(|\d+)", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), - // 01 Spider-Man & Wolverine 01.cbr - new Regex( - @"^(?\d+) (?:- )?(?.*) (\d+)?", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), - // Batman & Wildcat (1 of 3) - new Regex( - @"(?.*(\d{4})?)( |_)(?:\((?\d+) of \d+)", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), + // // 04 - Asterix the Gladiator (1964) (Digital-Empire) (WebP by Doc MaKS) + // new Regex( + // @"^(?\d+) (- |_)?(?.*(\d{4})?)( |_)(\(|\d+)", + // RegexOptions.IgnoreCase | RegexOptions.Compiled, + // RegexTimeout), + // // 01 Spider-Man & Wolverine 01.cbr + // new Regex( + // @"^(?\d+) (?:- )?(?.*) (\d+)?", + // RegexOptions.IgnoreCase | RegexOptions.Compiled, + // RegexTimeout), + // // Batman & Wildcat (1 of 3) + // new Regex( + // @"(?.*(\d{4})?)( |_)(?:\((?\d+) of \d+)", + // RegexOptions.IgnoreCase | RegexOptions.Compiled, + // RegexTimeout), // Teen Titans v1 001 (1966-02) (digital) (OkC.O.M.P.U.T.O.-Novus) new Regex( @"^(?.*)(?: |_)v(?\d+)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), // Scott Pilgrim 02 - Scott Pilgrim vs. The World (2005) - new Regex( - @"^(?.*)(?\d+)", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), + // BUG: Negative lookbehind has to be fixed width + // NOTE: The case this is built for does not make much sense. + // new Regex( + // @"^(?.+?)(?\d+)", + // RegexOptions.IgnoreCase | RegexOptions.Compiled, + // RegexTimeout), + // Batman & Catwoman - Trail of the Gun 01, Batman & Grendel (1996) 01 - Devil's Bones, Teen Titans v1 001 (1966-02) (digital) (OkC.O.M.P.U.T.O.-Novus) - new Regex( - @"^(?.*)(?\d+))", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), - // Batman & Robin the Teen Wonder #0 - new Regex( - @"^(?.*)(?: |_)#(?\d+)", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), + // new Regex( + // @"^(?.+?)(?\d+))", + // RegexOptions.IgnoreCase | RegexOptions.Compiled, + // RegexTimeout), + // // Batman & Robin the Teen Wonder #0 + // new Regex( + // @"^(?.*)(?: |_)#(?\d+)", + // RegexOptions.IgnoreCase | RegexOptions.Compiled, + // RegexTimeout), }; private static readonly Regex[] ComicChapterRegex = new[] { - // Batman & Wildcat (1 of 3) + // Batman & Wildcat (1 of 3) new Regex( @"(?.*(\d{4})?)( |_)(?:\((?\d+) of \d+)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), + // Batman Beyond 04 (of 6) (1999) + new Regex( + @"(?.+?)(?\d+)(\s|_|-)?\(of", + RegexOptions.IgnoreCase | RegexOptions.Compiled, + RegexTimeout), // Teen Titans v1 001 (1966-02) (digital) (OkC.O.M.P.U.T.O.-Novus) new Regex( - @"^(?.*)(?: |_)v(?\d+)(?: |_)(c? ?)(?(\d+(\.\d)?)-?(\d+(\.\d)?)?)(c? ?)", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), - // Batman & Catwoman - Trail of the Gun 01, Batman & Grendel (1996) 01 - Devil's Bones, Teen Titans v1 001 (1966-02) (digital) (OkC.O.M.P.U.T.O.-Novus) - new Regex( - @"^(?.*)(?: (?\d+))", - RegexOptions.IgnoreCase | RegexOptions.Compiled, - RegexTimeout), - // Batman & Robin the Teen Wonder #0 - new Regex( - @"^(?.*)(?: |_)#(?\d+)", + @"^(?.+?)(?: |_)v(?\d+)(?: |_)(c? ?)(?(\d+(\.\d)?)-?(\d+(\.\d)?)?)(c? ?)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), // Invincible 070.5 - Invincible Returns 1 (2010) (digital) (Minutemen-InnerDemons).cbr new Regex( - @"^(?.*)(?: |_)(c? ?)(?(\d+(\.\d)?)-?(\d+(\.\d)?)?)(c? ?)-", + @"^(?.+?)(?: |_)(c? ?)(?(\d+(\.\d)?)-?(\d+(\.\d)?)?)(c? ?)-", + RegexOptions.IgnoreCase | RegexOptions.Compiled, + RegexTimeout), + // Batman & Catwoman - Trail of the Gun 01, Batman & Grendel (1996) 01 - Devil's Bones, Teen Titans v1 001 (1966-02) (digital) (OkC.O.M.P.U.T.O.-Novus) + new Regex( + @"^(?.+?)(?: (?\d+))", + RegexOptions.IgnoreCase | RegexOptions.Compiled, + RegexTimeout), + // Batman & Robin the Teen Wonder #0 + new Regex( + @"^(?.+?)(?:\s|_)#(?\d+)", + RegexOptions.IgnoreCase | RegexOptions.Compiled, + RegexTimeout), + // Saga 001 (2012) (Digital) (Empire-Zone) + new Regex( + @"(?.+?)(?: |_)(c? ?)(?(\d+(\.\d)?)-?(\d+(\.\d)?)?)\s\(\d{4}", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), // Amazing Man Comics chapter 25 new Regex( - @"^(?!Vol)(?.*)( |_)c(hapter)( |_)(?\d*)", + @"^(?!Vol)(?.+?)( |_)c(hapter)( |_)(?\d*)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), // Amazing Man Comics issue #25 new Regex( - @"^(?!Vol)(?.*)( |_)i(ssue)( |_) #(?\d*)", + @"^(?!Vol)(?.+?)( |_)i(ssue)( |_) #(?\d*)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), }; @@ -422,14 +446,14 @@ namespace API.Parser @"^(?.*)(?: |_)#(?\d+)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), - // Green Worldz - Chapter 027 + // Green Worldz - Chapter 027, Kimi no Koto ga Daidaidaidaidaisuki na 100-nin no Kanojo Chapter 11-10 new Regex( - @"^(?!Vol)(?.*)\s?(?\d+(?:\.?[\d-])?)", + @"^(?!Vol)(?.*)\s?(?\d+(?:\.?[\d-]+)?)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), // Hinowa ga CRUSH! 018 (2019) (Digital) (LuCaZ).cbz, Hinowa ga CRUSH! 018.5 (2019) (Digital) (LuCaZ).cbz new Regex( - @"^(?!Vol)(?.*)\s(?\d+(?:.\d+|-\d+)?)(?:\s\(\d{4}\))?(\b|_|-)", + @"^(?!Vol)(?.+?)\s(?\d+(?:.\d+|-\d+)?)(?:\s\(\d{4}\))?(\b|_|-)", RegexOptions.IgnoreCase | RegexOptions.Compiled, RegexTimeout), // Tower Of God S01 014 (CBT) (digital).cbz @@ -822,8 +846,14 @@ namespace API.Parser var tokens = value.Split("-"); var from = RemoveLeadingZeroes(tokens[0]); - var to = RemoveLeadingZeroes(hasChapterPart ? AddChapterPart(tokens[1]) : tokens[1]); - return $"{@from}-{to}"; + if (tokens.Length == 2) + { + var to = RemoveLeadingZeroes(hasChapterPart ? AddChapterPart(tokens[1]) : tokens[1]); + return $"{@from}-{to}"; + } + + return from; + } } @@ -919,6 +949,9 @@ namespace API.Parser /// /// Translates _ -> spaces, trims front and back of string, removes release groups + /// + /// Hippos_the_Great [Digital], -> Hippos the Great + /// /// /// /// @@ -931,7 +964,7 @@ namespace API.Parser title = RemoveSpecialTags(title); title = title.Replace("_", " ").Trim(); - if (title.EndsWith("-")) + if (title.EndsWith("-") || title.EndsWith(",")) { title = title.Substring(0, title.Length - 1); } diff --git a/API/Program.cs b/API/Program.cs index 6d91f6d98..eddc4cb4e 100644 --- a/API/Program.cs +++ b/API/Program.cs @@ -1,10 +1,17 @@ using System; +using System.Collections.Generic; +using System.Data; using System.IO; +using System.Linq; using System.Security.Cryptography; using System.Threading; +using System.Threading.Channels; using System.Threading.Tasks; using API.Data; using API.Entities; +using API.Helpers; +using API.Interfaces; +using API.Services; using Kavita.Common; using Kavita.Common.EnvironmentInfo; using Microsoft.AspNetCore.Hosting; @@ -14,6 +21,8 @@ using Microsoft.EntityFrameworkCore; using Microsoft.Extensions.DependencyInjection; using Microsoft.Extensions.Hosting; using Microsoft.Extensions.Logging; +using Microsoft.IO; +using NetVips; using Sentry; namespace API @@ -49,8 +58,29 @@ namespace API { var context = services.GetRequiredService(); var roleManager = services.GetRequiredService>(); + + var requiresCoverImageMigration = !Directory.Exists(DirectoryService.CoverImageDirectory); + try + { + // If this is a new install, tables wont exist yet + if (requiresCoverImageMigration) + { + MigrateCoverImages.ExtractToImages(context); + } + } + catch (Exception ) + { + requiresCoverImageMigration = false; + } + // Apply all migrations on startup await context.Database.MigrateAsync(); + + if (requiresCoverImageMigration) + { + await MigrateCoverImages.UpdateDatabaseWithImages(context); + } + await Seed.SeedRoles(roleManager); await Seed.SeedSettings(context); await Seed.SeedUserApiKeys(context); diff --git a/API/Services/ArchiveService.cs b/API/Services/ArchiveService.cs index d8b381b60..bfa36595c 100644 --- a/API/Services/ArchiveService.cs +++ b/API/Services/ArchiveService.cs @@ -28,7 +28,6 @@ namespace API.Services { private readonly ILogger _logger; private readonly IDirectoryService _directoryService; - private static readonly RecyclableMemoryStreamManager StreamManager = new(); private readonly NaturalSortComparer _comparer; private const string ComicInfoFilename = "comicinfo"; @@ -147,12 +146,13 @@ namespace API.Services /// /// This skips over any __MACOSX folder/file iteration. /// + /// This always creates a thumbnail /// - /// Create a smaller variant of file extracted from archive. Archive images are usually 1MB each. + /// File name to use based on context of entity. /// - public byte[] GetCoverImage(string archivePath, bool createThumbnail = false) + public string GetCoverImage(string archivePath, string fileName) { - if (archivePath == null || !IsValidArchive(archivePath)) return Array.Empty(); + if (archivePath == null || !IsValidArchive(archivePath)) return String.Empty; try { var libraryHandler = CanOpen(archivePath); @@ -168,7 +168,7 @@ namespace API.Services var entry = archive.Entries.Single(e => e.FullName == entryName); using var stream = entry.Open(); - return createThumbnail ? CreateThumbnail(entry.FullName, stream) : ConvertEntryToByteArray(entry); + return CreateThumbnail(archivePath + " - " + entry.FullName, stream, fileName); } case ArchiveLibrary.SharpCompress: { @@ -179,18 +179,16 @@ namespace API.Services var entryName = FindFolderEntry(entryNames) ?? FirstFileEntry(entryNames); var entry = archive.Entries.Single(e => e.Key == entryName); - using var ms = StreamManager.GetStream(); - entry.WriteTo(ms); - ms.Position = 0; + using var stream = entry.OpenEntryStream(); - return createThumbnail ? CreateThumbnail(entry.Key, ms, Path.GetExtension(entry.Key)) : ms.ToArray(); + return CreateThumbnail(archivePath + " - " + entry.Key, stream, fileName); } case ArchiveLibrary.NotSupported: _logger.LogWarning("[GetCoverImage] This archive cannot be read: {ArchivePath}. Defaulting to no cover image", archivePath); - return Array.Empty(); + return string.Empty; default: _logger.LogWarning("[GetCoverImage] There was an exception when reading archive stream: {ArchivePath}. Defaulting to no cover image", archivePath); - return Array.Empty(); + return string.Empty; } } catch (Exception ex) @@ -198,15 +196,7 @@ namespace API.Services _logger.LogWarning(ex, "[GetCoverImage] There was an exception when reading archive stream: {ArchivePath}. Defaulting to no cover image", archivePath); } - return Array.Empty(); - } - - private static byte[] ConvertEntryToByteArray(ZipArchiveEntry entry) - { - using var stream = entry.Open(); - using var ms = StreamManager.GetStream(); - stream.CopyTo(ms); - return ms.ToArray(); + return string.Empty; } /// @@ -223,6 +213,7 @@ namespace API.Services archive.Entries.Any(e => e.FullName.Contains(Path.AltDirectorySeparatorChar) && !Parser.Parser.HasBlacklistedFolderInPath(e.FullName)); } + // TODO: Refactor CreateZipForDownload to return the temp file so we can stream it from temp public async Task> CreateZipForDownload(IEnumerable files, string tempFolder) { var dateString = DateTime.Now.ToShortDateString().Replace("/", "_"); @@ -254,23 +245,18 @@ namespace API.Services return Tuple.Create(fileBytes, zipPath); } - private byte[] CreateThumbnail(string entryName, Stream stream, string formatExtension = ".jpg") + private string CreateThumbnail(string entryName, Stream stream, string fileName) { - if (!formatExtension.StartsWith(".")) - { - formatExtension = $".{formatExtension}"; - } try { - using var thumbnail = Image.ThumbnailStream(stream, MetadataService.ThumbnailWidth); - return thumbnail.WriteToBuffer(formatExtension); + return ImageService.WriteCoverThumbnail(stream, fileName); } catch (Exception ex) { _logger.LogWarning(ex, "[GetCoverImage] There was an error and prevented thumbnail generation on {EntryName}. Defaulting to no cover image", entryName); } - return Array.Empty(); + return string.Empty; } /// @@ -303,9 +289,7 @@ namespace API.Services && !Parser.Parser.HasBlacklistedFolderInPath(entry.Key) && Parser.Parser.IsXml(entry.Key)) { - using var ms = StreamManager.GetStream(); - entry.WriteTo(ms); - ms.Position = 0; + using var ms = entry.OpenEntryStream(); var serializer = new XmlSerializer(typeof(ComicInfo)); var info = (ComicInfo) serializer.Deserialize(ms); @@ -332,7 +316,7 @@ namespace API.Services { case ArchiveLibrary.Default: { - _logger.LogDebug("Using default compression handling"); + _logger.LogTrace("Using default compression handling"); using var archive = ZipFile.OpenRead(archivePath); var entry = archive.Entries.SingleOrDefault(x => !Parser.Parser.HasBlacklistedFolderInPath(x.FullName) && Path.GetFileNameWithoutExtension(x.Name)?.ToLower() == ComicInfoFilename @@ -348,7 +332,7 @@ namespace API.Services } case ArchiveLibrary.SharpCompress: { - _logger.LogDebug("Using SharpCompress compression handling"); + _logger.LogTrace("Using SharpCompress compression handling"); using var archive = ArchiveFactory.Open(archivePath); info = FindComicInfoXml(archive.Entries.Where(entry => !entry.IsDirectory && !Parser.Parser.HasBlacklistedFolderInPath(Path.GetDirectoryName(entry.Key) ?? string.Empty) diff --git a/API/Services/BookService.cs b/API/Services/BookService.cs index 6c02b68db..6231de20a 100644 --- a/API/Services/BookService.cs +++ b/API/Services/BookService.cs @@ -4,6 +4,7 @@ using System.Drawing; using System.Drawing.Imaging; using System.IO; using System.Linq; +using System.Net; using System.Runtime.InteropServices; using System.Text; using System.Text.RegularExpressions; @@ -378,18 +379,25 @@ namespace API.Services for (var pageNumber = 0; pageNumber < pages; pageNumber++) { GetPdfPage(docReader, pageNumber, stream); - File.WriteAllBytes(Path.Combine(targetDirectory, "Page-" + pageNumber + ".png"), stream.ToArray()); + using var fileStream = File.Create(Path.Combine(targetDirectory, "Page-" + pageNumber + ".png")); + stream.Seek(0, SeekOrigin.Begin); + stream.CopyTo(fileStream); } } - - public byte[] GetCoverImage(string fileFilePath, bool createThumbnail = true) + /// + /// Extracts the cover image to covers directory and returns file path back + /// + /// + /// Name of the new file. + /// + public string GetCoverImage(string fileFilePath, string fileName) { - if (!IsValidFile(fileFilePath)) return Array.Empty(); + if (!IsValidFile(fileFilePath)) return String.Empty; if (Parser.Parser.IsPdf(fileFilePath)) { - return GetPdfCoverImage(fileFilePath, createThumbnail); + return GetPdfCoverImage(fileFilePath, fileName); } using var epubBook = EpubReader.OpenBook(fileFilePath); @@ -402,47 +410,41 @@ namespace API.Services ?? epubBook.Content.Images.Values.FirstOrDefault(file => Parser.Parser.IsCoverImage(file.FileName)) ?? epubBook.Content.Images.Values.FirstOrDefault(); - if (coverImageContent == null) return Array.Empty(); - - if (!createThumbnail) return coverImageContent.ReadContent(); + if (coverImageContent == null) return string.Empty; using var stream = StreamManager.GetStream("BookService.GetCoverImage", coverImageContent.ReadContent()); - using var thumbnail = NetVips.Image.ThumbnailStream(stream, MetadataService.ThumbnailWidth); - return thumbnail.WriteToBuffer(".jpg"); - + return ImageService.WriteCoverThumbnail(stream, fileName); } catch (Exception ex) { _logger.LogWarning(ex, "[BookService] There was a critical error and prevented thumbnail generation on {BookFile}. Defaulting to no cover image", fileFilePath); } - return Array.Empty(); + return string.Empty; } - private byte[] GetPdfCoverImage(string fileFilePath, bool createThumbnail) + + private string GetPdfCoverImage(string fileFilePath, string fileName) { - try - { - using var docReader = DocLib.Instance.GetDocReader(fileFilePath, new PageDimensions(1080, 1920)); - if (docReader.GetPageCount() == 0) return Array.Empty(); + try + { + using var docReader = DocLib.Instance.GetDocReader(fileFilePath, new PageDimensions(1080, 1920)); + if (docReader.GetPageCount() == 0) return string.Empty; - using var stream = StreamManager.GetStream("BookService.GetPdfPage"); - GetPdfPage(docReader, 0, stream); + using var stream = StreamManager.GetStream("BookService.GetPdfPage"); + GetPdfPage(docReader, 0, stream); - if (!createThumbnail) return stream.ToArray(); + return ImageService.WriteCoverThumbnail(stream, fileName); - using var thumbnail = NetVips.Image.ThumbnailStream(stream, MetadataService.ThumbnailWidth); - return thumbnail.WriteToBuffer(".png"); + } + catch (Exception ex) + { + _logger.LogWarning(ex, + "[BookService] There was a critical error and prevented thumbnail generation on {BookFile}. Defaulting to no cover image", + fileFilePath); + } - } - catch (Exception ex) - { - _logger.LogWarning(ex, - "[BookService] There was a critical error and prevented thumbnail generation on {BookFile}. Defaulting to no cover image", - fileFilePath); - } - - return Array.Empty(); + return string.Empty; } private static void GetPdfPage(IDocReader docReader, int pageNumber, Stream stream) diff --git a/API/Services/CacheService.cs b/API/Services/CacheService.cs index 968abaa72..8decdeccd 100644 --- a/API/Services/CacheService.cs +++ b/API/Services/CacheService.cs @@ -67,7 +67,7 @@ namespace API.Services public async Task Ensure(int chapterId) { EnsureCacheDirectory(); - var chapter = await _unitOfWork.VolumeRepository.GetChapterAsync(chapterId); + var chapter = await _unitOfWork.ChapterRepository.GetChapterAsync(chapterId); var extractPath = GetCachePath(chapterId); if (!Directory.Exists(extractPath)) @@ -192,7 +192,7 @@ namespace API.Services { // Calculate what chapter the page belongs to var pagesSoFar = 0; - var chapterFiles = chapter.Files ?? await _unitOfWork.VolumeRepository.GetFilesForChapterAsync(chapter.Id); + var chapterFiles = chapter.Files ?? await _unitOfWork.ChapterRepository.GetFilesForChapterAsync(chapter.Id); foreach (var mangaFile in chapterFiles) { if (page <= (mangaFile.Pages + pagesSoFar)) diff --git a/API/Services/DirectoryService.cs b/API/Services/DirectoryService.cs index 6d545ea21..360492303 100644 --- a/API/Services/DirectoryService.cs +++ b/API/Services/DirectoryService.cs @@ -19,6 +19,7 @@ namespace API.Services public static readonly string TempDirectory = Path.Join(Directory.GetCurrentDirectory(), "temp"); public static readonly string LogDirectory = Path.Join(Directory.GetCurrentDirectory(), "logs"); public static readonly string CacheDirectory = Path.Join(Directory.GetCurrentDirectory(), "cache"); + public static readonly string CoverImageDirectory = Path.Join(Directory.GetCurrentDirectory(), "covers"); public DirectoryService(ILogger logger) { @@ -305,6 +306,44 @@ namespace API.Services } + /// + /// Finds the highest directories from a set of MangaFiles + /// + /// List of top level folders which files belong to + /// List of file paths that belong to libraryFolders + /// + public static Dictionary FindHighestDirectoriesFromFiles(IEnumerable libraryFolders, IList filePaths) + { + var stopLookingForDirectories = false; + var dirs = new Dictionary(); + foreach (var folder in libraryFolders) + { + if (stopLookingForDirectories) break; + foreach (var file in filePaths) + { + if (!file.Contains(folder)) continue; + + var parts = GetFoldersTillRoot(folder, file).ToList(); + if (parts.Count == 0) + { + // Break from all loops, we done, just scan folder.Path (library root) + dirs.Add(folder, string.Empty); + stopLookingForDirectories = true; + break; + } + + var fullPath = Path.Join(folder, parts.Last()); + if (!dirs.ContainsKey(fullPath)) + { + dirs.Add(fullPath, string.Empty); + } + } + } + + return dirs; + } + + /// /// Recursively scans files and applies an action on them. This uses as many cores the underlying PC has to speed /// up processing. diff --git a/API/Services/DownloadService.cs b/API/Services/DownloadService.cs index 6013d5c84..7d0f56b3d 100644 --- a/API/Services/DownloadService.cs +++ b/API/Services/DownloadService.cs @@ -4,7 +4,6 @@ using System.Linq; using System.Threading.Tasks; using API.Entities; using API.Interfaces.Services; -using Microsoft.AspNetCore.Mvc; using Microsoft.AspNetCore.StaticFiles; namespace API.Services diff --git a/API/Services/ImageService.cs b/API/Services/ImageService.cs index cc4d92742..0f0f3aa16 100644 --- a/API/Services/ImageService.cs +++ b/API/Services/ImageService.cs @@ -14,13 +14,20 @@ namespace API.Services { private readonly ILogger _logger; private readonly IDirectoryService _directoryService; - private readonly NaturalSortComparer _naturalSortComparer; + public const string ChapterCoverImageRegex = @"v\d+_c\d+"; + public const string SeriesCoverImageRegex = @"seres\d+"; + public const string CollectionTagCoverImageRegex = @"tag\d+"; + + + /// + /// Width of the Thumbnail generation + /// + private const int ThumbnailWidth = 320; public ImageService(ILogger logger, IDirectoryService directoryService) { _logger = logger; _directoryService = directoryService; - _naturalSortComparer = new NaturalSortComparer(); } /// @@ -38,68 +45,108 @@ namespace API.Services } var firstImage = _directoryService.GetFilesWithExtension(directory, Parser.Parser.ImageFileExtensions) - .OrderBy(f => f, _naturalSortComparer).FirstOrDefault(); + .OrderBy(f => f, new NaturalSortComparer()).FirstOrDefault(); return firstImage; } - public byte[] GetCoverImage(string path, bool createThumbnail = false) + public string GetCoverImage(string path, string fileName) { - if (string.IsNullOrEmpty(path)) return Array.Empty(); + if (string.IsNullOrEmpty(path)) return string.Empty; try { - if (createThumbnail) - { - return CreateThumbnail(path); - } - - using var img = Image.NewFromFile(path); - using var stream = new MemoryStream(); - img.JpegsaveStream(stream); - stream.Position = 0; - return stream.ToArray(); + return CreateThumbnail(path, fileName); } catch (Exception ex) { _logger.LogWarning(ex, "[GetCoverImage] There was an error and prevented thumbnail generation on {ImageFile}. Defaulting to no cover image", path); } - return Array.Empty(); + return string.Empty; } - /// - public byte[] CreateThumbnail(string path) + public string CreateThumbnail(string path, string fileName) { try { - using var thumbnail = Image.Thumbnail(path, MetadataService.ThumbnailWidth); - return thumbnail.WriteToBuffer(".jpg"); + using var thumbnail = Image.Thumbnail(path, ThumbnailWidth); + var filename = fileName + ".png"; + thumbnail.WriteToFile(Path.Join(DirectoryService.CoverImageDirectory, fileName + ".png")); + return filename; } catch (Exception e) { _logger.LogError(e, "Error creating thumbnail from url"); } - return Array.Empty(); + return string.Empty; + } + + /// + /// Creates a thumbnail out of a memory stream and saves to with the passed + /// fileName and .png extension. + /// + /// Stream to write to disk. Ensure this is rewinded. + /// filename to save as without extension + /// File name with extension of the file. This will always write to + public static string WriteCoverThumbnail(Stream stream, string fileName) + { + using var thumbnail = NetVips.Image.ThumbnailStream(stream, ThumbnailWidth); + var filename = fileName + ".png"; + thumbnail.WriteToFile(Path.Join(DirectoryService.CoverImageDirectory, fileName + ".png")); + return filename; } /// - public byte[] CreateThumbnailFromBase64(string encodedImage) + public string CreateThumbnailFromBase64(string encodedImage, string fileName) { try { - using var thumbnail = Image.ThumbnailBuffer(Convert.FromBase64String(encodedImage), MetadataService.ThumbnailWidth); - return thumbnail.WriteToBuffer(".jpg"); + using var thumbnail = Image.ThumbnailBuffer(Convert.FromBase64String(encodedImage), ThumbnailWidth); + var filename = fileName + ".png"; + thumbnail.WriteToFile(Path.Join(DirectoryService.CoverImageDirectory, fileName + ".png")); + return filename; } catch (Exception e) { _logger.LogError(e, "Error creating thumbnail from url"); } - return Array.Empty(); + return string.Empty; + } + + /// + /// Returns the name format for a chapter cover image + /// + /// + /// + /// + public static string GetChapterFormat(int chapterId, int volumeId) + { + return $"v{volumeId}_c{chapterId}"; + } + + /// + /// Returns the name format for a series cover image + /// + /// + /// + public static string GetSeriesFormat(int seriesId) + { + return $"series{seriesId}"; + } + + /// + /// Returns the name format for a collection tag cover image + /// + /// + /// + public static string GetCollectionTagFormat(int tagId) + { + return $"tag{tagId}"; } } } diff --git a/API/Services/MetadataService.cs b/API/Services/MetadataService.cs index aa175c021..d443f9f23 100644 --- a/API/Services/MetadataService.cs +++ b/API/Services/MetadataService.cs @@ -1,6 +1,7 @@ using System; using System.Collections.Generic; using System.Diagnostics; +using System.IO; using System.Linq; using System.Threading.Tasks; using API.Comparators; @@ -9,6 +10,8 @@ using API.Entities.Enums; using API.Extensions; using API.Interfaces; using API.Interfaces.Services; +using API.SignalR; +using Microsoft.AspNetCore.SignalR; using Microsoft.Extensions.Logging; namespace API.Services @@ -20,58 +23,70 @@ namespace API.Services private readonly IArchiveService _archiveService; private readonly IBookService _bookService; private readonly IImageService _imageService; + private readonly IHubContext _messageHub; private readonly ChapterSortComparerZeroFirst _chapterSortComparerForInChapterSorting = new ChapterSortComparerZeroFirst(); - /// - /// Width of the Thumbnail generation - /// - public static readonly int ThumbnailWidth = 320; // 153w x 230h public MetadataService(IUnitOfWork unitOfWork, ILogger logger, - IArchiveService archiveService, IBookService bookService, IImageService imageService) + IArchiveService archiveService, IBookService bookService, IImageService imageService, IHubContext messageHub) { _unitOfWork = unitOfWork; _logger = logger; _archiveService = archiveService; _bookService = bookService; _imageService = imageService; + _messageHub = messageHub; } /// - /// Determines whether an entity should regenerate cover image + /// Determines whether an entity should regenerate cover image. /// + /// If a cover image is locked but the underlying file has been deleted, this will allow regenerating. /// /// /// /// + /// Directory where cover images are. Defaults to /// - public static bool ShouldUpdateCoverImage(byte[] coverImage, MangaFile firstFile, bool forceUpdate = false, - bool isCoverLocked = false) + public static bool ShouldUpdateCoverImage(string coverImage, MangaFile firstFile, bool forceUpdate = false, + bool isCoverLocked = false, string coverImageDirectory = null) { - if (isCoverLocked) return false; + if (string.IsNullOrEmpty(coverImageDirectory)) + { + coverImageDirectory = DirectoryService.CoverImageDirectory; + } + + var fileExists = File.Exists(Path.Join(coverImageDirectory, coverImage)); + if (isCoverLocked && fileExists) return false; if (forceUpdate) return true; - return (firstFile != null && firstFile.HasFileBeenModified()) || !HasCoverImage(coverImage); + return (firstFile != null && firstFile.HasFileBeenModified()) || !HasCoverImage(coverImage, fileExists); } - private static bool HasCoverImage(byte[] coverImage) + + private static bool HasCoverImage(string coverImage) { - return coverImage != null && coverImage.Any(); + return HasCoverImage(coverImage, File.Exists(coverImage)); } - private byte[] GetCoverImage(MangaFile file, bool createThumbnail = true) + private static bool HasCoverImage(string coverImage, bool fileExists) + { + return !string.IsNullOrEmpty(coverImage) && fileExists; + } + + private string GetCoverImage(MangaFile file, int volumeId, int chapterId) { file.LastModified = DateTime.Now; switch (file.Format) { case MangaFormat.Pdf: case MangaFormat.Epub: - return _bookService.GetCoverImage(file.FilePath, createThumbnail); + return _bookService.GetCoverImage(file.FilePath, ImageService.GetChapterFormat(chapterId, volumeId)); case MangaFormat.Image: var coverImage = _imageService.GetCoverFile(file); - return _imageService.GetCoverImage(coverImage, createThumbnail); + return _imageService.GetCoverImage(coverImage, ImageService.GetChapterFormat(chapterId, volumeId)); case MangaFormat.Archive: - return _archiveService.GetCoverImage(file.FilePath, createThumbnail); + return _archiveService.GetCoverImage(file.FilePath, ImageService.GetChapterFormat(chapterId, volumeId)); default: - return Array.Empty(); + return string.Empty; } } @@ -81,14 +96,17 @@ namespace API.Services /// /// /// Force updating cover image even if underlying file has not been modified or chapter already has a cover image - public void UpdateMetadata(Chapter chapter, bool forceUpdate) + public bool UpdateMetadata(Chapter chapter, bool forceUpdate) { var firstFile = chapter.Files.OrderBy(x => x.Chapter).FirstOrDefault(); if (ShouldUpdateCoverImage(chapter.CoverImage, firstFile, forceUpdate, chapter.CoverImageLocked)) { - chapter.CoverImage = GetCoverImage(firstFile); + chapter.CoverImage = GetCoverImage(firstFile, chapter.VolumeId, chapter.Id); + return true; } + + return false; } /// @@ -96,17 +114,18 @@ namespace API.Services /// /// /// Force updating cover image even if underlying file has not been modified or chapter already has a cover image - public void UpdateMetadata(Volume volume, bool forceUpdate) + public bool UpdateMetadata(Volume volume, bool forceUpdate) { + // We need to check if Volume coverImage matches first chapters if forceUpdate is false if (volume == null || !ShouldUpdateCoverImage(volume.CoverImage, null, forceUpdate - , false)) return; + , false)) return false; volume.Chapters ??= new List(); var firstChapter = volume.Chapters.OrderBy(x => double.Parse(x.Number), _chapterSortComparerForInChapterSorting).FirstOrDefault(); - - if (firstChapter == null) return; + if (firstChapter == null) return false; volume.CoverImage = firstChapter.CoverImage; + return true; } /// @@ -114,14 +133,15 @@ namespace API.Services /// /// /// Force updating cover image even if underlying file has not been modified or chapter already has a cover image - public void UpdateMetadata(Series series, bool forceUpdate) + public bool UpdateMetadata(Series series, bool forceUpdate) { - if (series == null) return; + var madeUpdate = false; + if (series == null) return false; if (ShouldUpdateCoverImage(series.CoverImage, null, forceUpdate, series.CoverImageLocked)) { series.Volumes ??= new List(); var firstCover = series.Volumes.GetCoverImage(series.Format); - byte[] coverImage = null; + string coverImage = null; if (firstCover == null && series.Volumes.Any()) { // If firstCover is null and one volume, the whole series is Chapters under Vol 0. @@ -129,39 +149,46 @@ namespace API.Services { coverImage = series.Volumes[0].Chapters.OrderBy(c => double.Parse(c.Number), _chapterSortComparerForInChapterSorting) .FirstOrDefault(c => !c.IsSpecial)?.CoverImage; + madeUpdate = true; } if (!HasCoverImage(coverImage)) { coverImage = series.Volumes[0].Chapters.OrderBy(c => double.Parse(c.Number), _chapterSortComparerForInChapterSorting) .FirstOrDefault()?.CoverImage; + madeUpdate = true; } } series.CoverImage = firstCover?.CoverImage ?? coverImage; } - UpdateSeriesSummary(series, forceUpdate); + return UpdateSeriesSummary(series, forceUpdate) || madeUpdate ; } - private void UpdateSeriesSummary(Series series, bool forceUpdate) + private bool UpdateSeriesSummary(Series series, bool forceUpdate) { - if (!string.IsNullOrEmpty(series.Summary) && !forceUpdate) return; + if (!string.IsNullOrEmpty(series.Summary) && !forceUpdate) return false; var isBook = series.Library.Type == LibraryType.Book; var firstVolume = series.Volumes.FirstWithChapters(isBook); var firstChapter = firstVolume?.Chapters.GetFirstChapterWithFiles(); var firstFile = firstChapter?.Files.FirstOrDefault(); - if (firstFile == null || (!forceUpdate && !firstFile.HasFileBeenModified())) return; - if (Parser.Parser.IsPdf(firstFile.FilePath)) return; + if (firstFile == null || (!forceUpdate && !firstFile.HasFileBeenModified())) return false; + if (Parser.Parser.IsPdf(firstFile.FilePath)) return false; - var summary = Parser.Parser.IsEpub(firstFile.FilePath) ? _bookService.GetSummaryInfo(firstFile.FilePath) : _archiveService.GetSummaryInfo(firstFile.FilePath); - if (string.IsNullOrEmpty(series.Summary)) + if (series.Format is MangaFormat.Archive or MangaFormat.Epub) { - series.Summary = summary; + var summary = Parser.Parser.IsEpub(firstFile.FilePath) ? _bookService.GetSummaryInfo(firstFile.FilePath) : _archiveService.GetSummaryInfo(firstFile.FilePath); + if (!string.IsNullOrEmpty(series.Summary)) + { + series.Summary = summary; + firstFile.LastModified = DateTime.Now; + return true; + } } - - firstFile.LastModified = DateTime.Now; + firstFile.LastModified = DateTime.Now; // NOTE: Should I put this here as well since it might not have actually been parsed? + return false; } @@ -171,31 +198,33 @@ namespace API.Services /// This can be heavy on memory first run /// /// Force updating cover image even if underlying file has not been modified or chapter already has a cover image - public void RefreshMetadata(int libraryId, bool forceUpdate = false) + public async Task RefreshMetadata(int libraryId, bool forceUpdate = false) { var sw = Stopwatch.StartNew(); - var library = Task.Run(() => _unitOfWork.LibraryRepository.GetFullLibraryForIdAsync(libraryId)).GetAwaiter().GetResult(); + var library = await _unitOfWork.LibraryRepository.GetFullLibraryForIdAsync(libraryId); // PERF: See if we can break this up into multiple threads that process 20 series at a time then save so we can reduce amount of memory used _logger.LogInformation("Beginning metadata refresh of {LibraryName}", library.Name); foreach (var series in library.Series) { + var volumeUpdated = false; foreach (var volume in series.Volumes) { + var chapterUpdated = false; foreach (var chapter in volume.Chapters) { - UpdateMetadata(chapter, forceUpdate); + chapterUpdated = UpdateMetadata(chapter, forceUpdate); } - UpdateMetadata(volume, forceUpdate); + volumeUpdated = UpdateMetadata(volume, chapterUpdated || forceUpdate); } - UpdateMetadata(series, forceUpdate); + UpdateMetadata(series, volumeUpdated || forceUpdate); _unitOfWork.SeriesRepository.Update(series); } - if (_unitOfWork.HasChanges() && Task.Run(() => _unitOfWork.CommitAsync()).Result) + if (_unitOfWork.HasChanges() && await _unitOfWork.CommitAsync()) { _logger.LogInformation("Updated metadata for {LibraryName} in {ElapsedMilliseconds} milliseconds", library.Name, sw.ElapsedMilliseconds); } @@ -207,10 +236,10 @@ namespace API.Services /// /// /// - public void RefreshMetadataForSeries(int libraryId, int seriesId) + public async Task RefreshMetadataForSeries(int libraryId, int seriesId, bool forceUpdate = false) { var sw = Stopwatch.StartNew(); - var library = Task.Run(() => _unitOfWork.LibraryRepository.GetFullLibraryForIdAsync(libraryId)).GetAwaiter().GetResult(); + var library = await _unitOfWork.LibraryRepository.GetFullLibraryForIdAsync(libraryId); var series = library.Series.SingleOrDefault(s => s.Id == seriesId); if (series == null) @@ -219,23 +248,26 @@ namespace API.Services return; } _logger.LogInformation("Beginning metadata refresh of {SeriesName}", series.Name); + var volumeUpdated = false; foreach (var volume in series.Volumes) { + var chapterUpdated = false; foreach (var chapter in volume.Chapters) { - UpdateMetadata(chapter, true); + chapterUpdated = UpdateMetadata(chapter, forceUpdate); } - UpdateMetadata(volume, true); + volumeUpdated = UpdateMetadata(volume, chapterUpdated || forceUpdate); } - UpdateMetadata(series, true); + UpdateMetadata(series, volumeUpdated || forceUpdate); _unitOfWork.SeriesRepository.Update(series); - if (_unitOfWork.HasChanges() && Task.Run(() => _unitOfWork.CommitAsync()).Result) + if (_unitOfWork.HasChanges() && await _unitOfWork.CommitAsync()) { _logger.LogInformation("Updated metadata for {SeriesName} in {ElapsedMilliseconds} milliseconds", series.Name, sw.ElapsedMilliseconds); + await _messageHub.Clients.All.SendAsync(SignalREvents.ScanSeries, MessageFactory.RefreshMetadataEvent(libraryId, seriesId)); } } } diff --git a/API/Services/TaskScheduler.cs b/API/Services/TaskScheduler.cs index f12926c68..2d1b25a7d 100644 --- a/API/Services/TaskScheduler.cs +++ b/API/Services/TaskScheduler.cs @@ -121,7 +121,7 @@ namespace API.Services _logger.LogInformation("Enqueuing library scan for: {LibraryId}", libraryId); BackgroundJob.Enqueue(() => _scannerService.ScanLibrary(libraryId, forceUpdate)); // When we do a scan, force cache to re-unpack in case page numbers change - BackgroundJob.Enqueue(() => _cleanupService.Cleanup()); + BackgroundJob.Enqueue(() => _cleanupService.CleanupCacheDirectory()); } public void CleanupChapters(int[] chapterIds) @@ -141,10 +141,10 @@ namespace API.Services BackgroundJob.Enqueue(() => DirectoryService.ClearDirectory(tempDirectory)); } - public void RefreshSeriesMetadata(int libraryId, int seriesId) + public void RefreshSeriesMetadata(int libraryId, int seriesId, bool forceUpdate = false) { _logger.LogInformation("Enqueuing series metadata refresh for: {SeriesId}", seriesId); - BackgroundJob.Enqueue(() => _metadataService.RefreshMetadataForSeries(libraryId, seriesId)); + BackgroundJob.Enqueue(() => _metadataService.RefreshMetadataForSeries(libraryId, seriesId, forceUpdate)); } public void ScanSeries(int libraryId, int seriesId, bool forceUpdate = false) @@ -161,6 +161,7 @@ namespace API.Services /// /// Not an external call. Only public so that we can call this for a Task /// + // ReSharper disable once MemberCanBePrivate.Global public async Task CheckForUpdate() { var update = await _versionUpdaterService.CheckForUpdate(); diff --git a/API/Services/Tasks/BackupService.cs b/API/Services/Tasks/BackupService.cs index e04e5373f..35388985a 100644 --- a/API/Services/Tasks/BackupService.cs +++ b/API/Services/Tasks/BackupService.cs @@ -59,8 +59,11 @@ namespace API.Services.Tasks return files; } + /// + /// Will backup anything that needs to be backed up. This includes logs, setting files, bare minimum cover images (just locked and first cover). + /// [AutomaticRetry(Attempts = 3, LogEvents = false, OnAttemptsExceeded = AttemptsExceededAction.Fail)] - public void BackupDatabase() + public async Task BackupDatabase() { _logger.LogInformation("Beginning backup of Database at {BackupTime}", DateTime.Now); var backupDirectory = Task.Run(() => _unitOfWork.SettingsRepository.GetSettingAsync(ServerSettingKey.BackupDirectory)).Result.Value; @@ -87,6 +90,9 @@ namespace API.Services.Tasks _directoryService.CopyFilesToDirectory( _backupFiles.Select(file => Path.Join(Directory.GetCurrentDirectory(), file)).ToList(), tempDirectory); + + await CopyCoverImagesToBackupDirectory(tempDirectory); + try { ZipFile.CreateFromDirectory(tempDirectory, zipPath); @@ -100,6 +106,31 @@ namespace API.Services.Tasks _logger.LogInformation("Database backup completed"); } + private async Task CopyCoverImagesToBackupDirectory(string tempDirectory) + { + var outputTempDir = Path.Join(tempDirectory, "covers"); + DirectoryService.ExistOrCreate(outputTempDir); + + try + { + var seriesImages = await _unitOfWork.SeriesRepository.GetLockedCoverImagesAsync(); + _directoryService.CopyFilesToDirectory( + seriesImages.Select(s => Path.Join(DirectoryService.CoverImageDirectory, s)), outputTempDir); + + var collectionTags = await _unitOfWork.CollectionTagRepository.GetAllCoverImagesAsync(); + _directoryService.CopyFilesToDirectory( + collectionTags.Select(s => Path.Join(DirectoryService.CoverImageDirectory, s)), outputTempDir); + + var chapterImages = await _unitOfWork.ChapterRepository.GetCoverImagesForLockedChaptersAsync(); + _directoryService.CopyFilesToDirectory( + chapterImages.Select(s => Path.Join(DirectoryService.CoverImageDirectory, s)), outputTempDir); + } + catch (IOException e) + { + // Swallow exception. This can be a duplicate cover being copied as chapter and volumes can share same file. + } + } + /// /// Removes Database backups older than 30 days. If all backups are older than 30 days, the latest is kept. /// diff --git a/API/Services/Tasks/CleanupService.cs b/API/Services/Tasks/CleanupService.cs index ae04d46bd..c1edf2e6b 100644 --- a/API/Services/Tasks/CleanupService.cs +++ b/API/Services/Tasks/CleanupService.cs @@ -1,7 +1,11 @@ using System.IO; +using System.Linq; +using System.Threading.Tasks; +using API.Interfaces; using API.Interfaces.Services; using Hangfire; using Microsoft.Extensions.Logging; +using NetVips; namespace API.Services.Tasks { @@ -13,27 +17,79 @@ namespace API.Services.Tasks private readonly ICacheService _cacheService; private readonly ILogger _logger; private readonly IBackupService _backupService; + private readonly IUnitOfWork _unitOfWork; + private readonly IDirectoryService _directoryService; - public CleanupService(ICacheService cacheService, ILogger logger, IBackupService backupService) + public CleanupService(ICacheService cacheService, ILogger logger, + IBackupService backupService, IUnitOfWork unitOfWork, IDirectoryService directoryService) { _cacheService = cacheService; _logger = logger; _backupService = backupService; + _unitOfWork = unitOfWork; + _directoryService = directoryService; + } + + public void CleanupCacheDirectory() + { + _logger.LogInformation("Cleaning cache directory"); + _cacheService.Cleanup(); } /// - /// Cleans up Temp, cache, and old database backups + /// Cleans up Temp, cache, deleted cover images, and old database backups /// [AutomaticRetry(Attempts = 3, LogEvents = false, OnAttemptsExceeded = AttemptsExceededAction.Fail)] - public void Cleanup() + public async Task Cleanup() { + _logger.LogInformation("Starting Cleanup"); _logger.LogInformation("Cleaning temp directory"); var tempDirectory = Path.Join(Directory.GetCurrentDirectory(), "temp"); DirectoryService.ClearDirectory(tempDirectory); - _logger.LogInformation("Cleaning cache directory"); - _cacheService.Cleanup(); + CleanupCacheDirectory(); _logger.LogInformation("Cleaning old database backups"); _backupService.CleanupBackups(); + _logger.LogInformation("Cleaning deleted cover images"); + await DeleteSeriesCoverImages(); + await DeleteChapterCoverImages(); + await DeleteTagCoverImages(); + _logger.LogInformation("Cleanup finished"); + } + + private async Task DeleteSeriesCoverImages() + { + var images = await _unitOfWork.SeriesRepository.GetAllCoverImagesAsync(); + var files = _directoryService.GetFiles(DirectoryService.CoverImageDirectory, ImageService.SeriesCoverImageRegex); + foreach (var file in files) + { + if (images.Contains(Path.GetFileName(file))) continue; + File.Delete(file); + + } + } + + private async Task DeleteChapterCoverImages() + { + var images = await _unitOfWork.ChapterRepository.GetAllCoverImagesAsync(); + var files = _directoryService.GetFiles(DirectoryService.CoverImageDirectory, ImageService.ChapterCoverImageRegex); + foreach (var file in files) + { + if (images.Contains(Path.GetFileName(file))) continue; + File.Delete(file); + + } + } + + private async Task DeleteTagCoverImages() + { + var images = await _unitOfWork.CollectionTagRepository.GetAllCoverImagesAsync(); + var files = _directoryService.GetFiles(DirectoryService.CoverImageDirectory, ImageService.CollectionTagCoverImageRegex); + foreach (var file in files) + { + if (images.Contains(Path.GetFileName(file))) continue; + File.Delete(file); + + } } } } diff --git a/API/Services/Tasks/Scanner/ParseScannedFiles.cs b/API/Services/Tasks/Scanner/ParseScannedFiles.cs index 9be88dfde..afcfc1c13 100644 --- a/API/Services/Tasks/Scanner/ParseScannedFiles.cs +++ b/API/Services/Tasks/Scanner/ParseScannedFiles.cs @@ -39,18 +39,18 @@ namespace API.Services.Tasks.Scanner _scannedSeries = new ConcurrentDictionary>(); } + /// + /// Gets the list of parserInfos given a Series. If the series does not exist within, return empty list. + /// + /// + /// + /// public static IList GetInfosByName(Dictionary> parsedSeries, Series series) { var existingKey = parsedSeries.Keys.FirstOrDefault(ps => - ps.Format == series.Format && ps.NormalizedName == Parser.Parser.Normalize(series.OriginalName)); - existingKey ??= new ParsedSeries() - { - Format = series.Format, - Name = series.OriginalName, - NormalizedName = Parser.Parser.Normalize(series.OriginalName) - }; + ps.Format == series.Format && ps.NormalizedName.Equals(Parser.Parser.Normalize(series.OriginalName))); - return parsedSeries[existingKey]; + return existingKey != null ? parsedSeries[existingKey] : new List(); } /// diff --git a/API/Services/Tasks/ScannerService.cs b/API/Services/Tasks/ScannerService.cs index 9fd90844c..15bb715c7 100644 --- a/API/Services/Tasks/ScannerService.cs +++ b/API/Services/Tasks/ScannerService.cs @@ -14,7 +14,9 @@ using API.Interfaces; using API.Interfaces.Services; using API.Parser; using API.Services.Tasks.Scanner; +using API.SignalR; using Hangfire; +using Microsoft.AspNetCore.SignalR; using Microsoft.Extensions.Logging; namespace API.Services.Tasks @@ -27,10 +29,11 @@ namespace API.Services.Tasks private readonly IMetadataService _metadataService; private readonly IBookService _bookService; private readonly ICacheService _cacheService; + private readonly IHubContext _messageHub; private readonly NaturalSortComparer _naturalSort = new (); public ScannerService(IUnitOfWork unitOfWork, ILogger logger, IArchiveService archiveService, - IMetadataService metadataService, IBookService bookService, ICacheService cacheService) + IMetadataService metadataService, IBookService bookService, ICacheService cacheService, IHubContext messageHub) { _unitOfWork = unitOfWork; _logger = logger; @@ -38,6 +41,7 @@ namespace API.Services.Tasks _metadataService = metadataService; _bookService = bookService; _cacheService = cacheService; + _messageHub = messageHub; } [DisableConcurrentExecution(timeoutInSeconds: 360)] @@ -47,7 +51,7 @@ namespace API.Services.Tasks var files = await _unitOfWork.SeriesRepository.GetFilesForSeries(seriesId); var series = await _unitOfWork.SeriesRepository.GetSeriesByIdAsync(seriesId); var library = await _unitOfWork.LibraryRepository.GetFullLibraryForIdAsync(libraryId, seriesId); - var dirs = FindHighestDirectoriesFromFiles(library, files); + var dirs = DirectoryService.FindHighestDirectoriesFromFiles(library.Folders.Select(f => f.Path), files.Select(f => f.FilePath).ToList()); var chapterIds = await _unitOfWork.SeriesRepository.GetChapterIdsForSeriesAsync(new []{ seriesId }); _logger.LogInformation("Beginning file scan on {SeriesName}", series.Name); @@ -63,6 +67,37 @@ namespace API.Services.Tasks parsedSeries.Remove(key); } + if (parsedSeries.Count == 0) + { + // We need to do an additional check for an edge case: If the scan ran and the files do not match the existing Series name, then it is very likely, + // the files have crap naming and if we don't correct, the series will get deleted due to the parser not being able to fallback onto folder parsing as the root + // is the series folder. + var existingFolder = dirs.Keys.FirstOrDefault(key => key.Contains(series.OriginalName)); + if (dirs.Keys.Count == 1 && !string.IsNullOrEmpty(existingFolder)) + { + dirs = new Dictionary(); + var path = Path.GetPathRoot(existingFolder); + if (!string.IsNullOrEmpty(path)) + { + dirs[path] = string.Empty; + } + } + _logger.LogDebug("{SeriesName} has bad naming convention, forcing rescan at a higher directory.", series.OriginalName); + scanner = new ParseScannedFiles(_bookService, _logger); + parsedSeries = scanner.ScanLibrariesForSeries(library.Type, dirs.Keys, out var totalFiles2, out var scanElapsedTime2); + totalFiles += totalFiles2; + scanElapsedTime += scanElapsedTime2; + + // If a root level folder scan occurs, then multiple series gets passed in and thus we get a unique constraint issue + // Hence we clear out anything but what we selected for + firstSeries = library.Series.FirstOrDefault(); + keys = parsedSeries.Keys; + foreach (var key in keys.Where(key => !firstSeries.NameInParserInfo(parsedSeries[key].FirstOrDefault()) || firstSeries?.Format != key.Format)) + { + parsedSeries.Remove(key); + } + } + var sw = new Stopwatch(); UpdateLibrary(library, parsedSeries); @@ -73,9 +108,11 @@ namespace API.Services.Tasks "Processed {TotalFiles} files and {ParsedSeriesCount} series in {ElapsedScanTime} milliseconds for {SeriesName}", totalFiles, parsedSeries.Keys.Count, sw.ElapsedMilliseconds + scanElapsedTime, series.Name); - CleanupDbEntities(); - BackgroundJob.Enqueue(() => _metadataService.RefreshMetadataForSeries(libraryId, seriesId)); + await CleanupDbEntities(); + BackgroundJob.Enqueue(() => _metadataService.RefreshMetadataForSeries(libraryId, seriesId, forceUpdate)); BackgroundJob.Enqueue(() => _cacheService.CleanupChapters(chapterIds)); + // Tell UI that this series is done + await _messageHub.Clients.All.SendAsync(SignalREvents.ScanSeries, MessageFactory.ScanSeriesEvent(seriesId), cancellationToken: token); } else { @@ -83,56 +120,21 @@ namespace API.Services.Tasks "There was a critical error that resulted in a failed scan. Please check logs and rescan"); await _unitOfWork.RollbackAsync(); } - } - /// - /// Finds the highest directories from a set of MangaFiles - /// - /// - /// - /// - private static Dictionary FindHighestDirectoriesFromFiles(Library library, IList files) - { - var stopLookingForDirectories = false; - var dirs = new Dictionary(); - foreach (var folder in library.Folders) - { - if (stopLookingForDirectories) break; - foreach (var file in files) - { - if (!file.FilePath.Contains(folder.Path)) continue; - - var parts = DirectoryService.GetFoldersTillRoot(folder.Path, file.FilePath).ToList(); - if (parts.Count == 0) - { - // Break from all loops, we done, just scan folder.Path (library root) - dirs.Add(folder.Path, string.Empty); - stopLookingForDirectories = true; - break; - } - - var fullPath = Path.Join(folder.Path, parts.Last()); - if (!dirs.ContainsKey(fullPath)) - { - dirs.Add(fullPath, string.Empty); - } - } - } - - return dirs; } [DisableConcurrentExecution(timeoutInSeconds: 360)] [AutomaticRetry(Attempts = 0, OnAttemptsExceeded = AttemptsExceededAction.Delete)] - public void ScanLibraries() + public async Task ScanLibraries() { - var libraries = Task.Run(() => _unitOfWork.LibraryRepository.GetLibrariesAsync()).Result.ToList(); + _logger.LogInformation("Starting Scan of All Libraries"); + var libraries = await _unitOfWork.LibraryRepository.GetLibrariesAsync(); foreach (var lib in libraries) { - ScanLibrary(lib.Id, false); + await ScanLibrary(lib.Id, false); } - + _logger.LogInformation("Scan of All Libraries Finished"); } @@ -145,13 +147,12 @@ namespace API.Services.Tasks /// [DisableConcurrentExecution(360)] [AutomaticRetry(Attempts = 0, OnAttemptsExceeded = AttemptsExceededAction.Delete)] - public void ScanLibrary(int libraryId, bool forceUpdate) + public async Task ScanLibrary(int libraryId, bool forceUpdate) { Library library; try { - library = Task.Run(() => _unitOfWork.LibraryRepository.GetFullLibraryForIdAsync(libraryId)).GetAwaiter() - .GetResult(); + library = await _unitOfWork.LibraryRepository.GetFullLibraryForIdAsync(libraryId); } catch (Exception ex) { @@ -173,7 +174,7 @@ namespace API.Services.Tasks UpdateLibrary(library, series); _unitOfWork.LibraryRepository.Update(library); - if (Task.Run(() => _unitOfWork.CommitAsync()).Result) + if (await _unitOfWork.CommitAsync()) { _logger.LogInformation( "Processed {TotalFiles} files and {ParsedSeriesCount} series in {ElapsedScanTime} milliseconds for {LibraryName}", @@ -185,27 +186,29 @@ namespace API.Services.Tasks "There was a critical error that resulted in a failed scan. Please check logs and rescan"); } - CleanupUserProgress(); + await CleanupAbandonedChapters(); BackgroundJob.Enqueue(() => _metadataService.RefreshMetadata(libraryId, forceUpdate)); + await _messageHub.Clients.All.SendAsync(SignalREvents.ScanLibrary, MessageFactory.ScanLibraryEvent(libraryId, "complete")); } /// /// Remove any user progress rows that no longer exist since scan library ran and deleted series/volumes/chapters /// - private void CleanupUserProgress() + private async Task CleanupAbandonedChapters() { - var cleanedUp = Task.Run(() => _unitOfWork.AppUserProgressRepository.CleanupAbandonedChapters()).Result; + var cleanedUp = await _unitOfWork.AppUserProgressRepository.CleanupAbandonedChapters(); _logger.LogInformation("Removed {Count} abandoned progress rows", cleanedUp); } + /// /// Cleans up any abandoned rows due to removals from Scan loop /// - private void CleanupDbEntities() + private async Task CleanupDbEntities() { - CleanupUserProgress(); - var cleanedUp = Task.Run( () => _unitOfWork.CollectionTagRepository.RemoveTagsWithoutSeries()).Result; + await CleanupAbandonedChapters(); + var cleanedUp = await _unitOfWork.CollectionTagRepository.RemoveTagsWithoutSeries(); _logger.LogInformation("Removed {Count} abandoned collection tags", cleanedUp); } @@ -275,6 +278,9 @@ namespace API.Services.Tasks _logger.LogError(ex, "There was an exception updating volumes for {SeriesName}", series.Name); } }); + + // Last step, remove any series that have no pages + library.Series = library.Series.Where(s => s.Pages > 0).ToList(); } public IEnumerable FindSeriesNotOnDisk(ICollection existingSeries, Dictionary> parsedSeries) diff --git a/API/Services/Tasks/VersionUpdaterService.cs b/API/Services/Tasks/VersionUpdaterService.cs index 5b3607ffc..fbd3d4f10 100644 --- a/API/Services/Tasks/VersionUpdaterService.cs +++ b/API/Services/Tasks/VersionUpdaterService.cs @@ -23,6 +23,7 @@ namespace API.Services.Tasks /// Name of the Tag /// v0.4.3 /// + // ReSharper disable once InconsistentNaming public string Tag_Name { get; init; } /// /// Name of the Release @@ -35,6 +36,7 @@ namespace API.Services.Tasks /// /// Url of the release on Github /// + // ReSharper disable once InconsistentNaming public string Html_Url { get; init; } } @@ -53,8 +55,10 @@ namespace API.Services.Tasks private readonly IHubContext _messageHub; private readonly IPresenceTracker _tracker; private readonly Markdown _markdown = new MarkdownDeep.Markdown(); +#pragma warning disable S1075 private static readonly string GithubLatestReleasesUrl = "https://api.github.com/repos/Kareadita/Kavita/releases/latest"; private static readonly string GithubAllReleasesUrl = "https://api.github.com/repos/Kareadita/Kavita/releases"; +#pragma warning restore S1075 public VersionUpdaterService(ILogger logger, IHubContext messageHub, IPresenceTracker tracker) { @@ -90,12 +94,17 @@ namespace API.Services.Tasks private UpdateNotificationDto CreateDto(GithubReleaseMetadata update) { if (update == null || string.IsNullOrEmpty(update.Tag_Name)) return null; - var version = update.Tag_Name.Replace("v", string.Empty); - var updateVersion = new Version(version); + var updateVersion = new Version(update.Tag_Name.Replace("v", string.Empty)); + var currentVersion = BuildInfo.Version.ToString(); + + if (updateVersion.Revision == -1) + { + currentVersion = currentVersion.Substring(0, currentVersion.LastIndexOf(".", StringComparison.Ordinal)); + } return new UpdateNotificationDto() { - CurrentVersion = version, + CurrentVersion = currentVersion, UpdateVersion = updateVersion.ToString(), UpdateBody = _markdown.Transform(update.Body.Trim()), UpdateTitle = update.Name, @@ -131,11 +140,7 @@ namespace API.Services.Tasks connections.AddRange(await _tracker.GetConnectionsForUser(admin)); } - await _messageHub.Clients.Users(admins).SendAsync("UpdateAvailable", new SignalRMessage - { - Name = "UpdateAvailable", - Body = update - }); + await _messageHub.Clients.Users(admins).SendAsync(SignalREvents.UpdateVersion, MessageFactory.UpdateVersionEvent(update)); } diff --git a/API/SignalR/MessageFactory.cs b/API/SignalR/MessageFactory.cs new file mode 100644 index 000000000..ad6eed5c9 --- /dev/null +++ b/API/SignalR/MessageFactory.cs @@ -0,0 +1,56 @@ +using System.Threading; +using API.DTOs.Update; + +namespace API.SignalR +{ + public static class MessageFactory + { + public static SignalRMessage ScanSeriesEvent(int seriesId) + { + return new SignalRMessage() + { + Name = SignalREvents.ScanSeries, + Body = new + { + SeriesId = seriesId + } + }; + } + + public static SignalRMessage ScanLibraryEvent(int libraryId, string stage) + { + return new SignalRMessage() + { + Name = SignalREvents.ScanLibrary, + Body = new + { + LibraryId = libraryId, + Stage = stage + } + }; + } + + public static SignalRMessage RefreshMetadataEvent(int libraryId, int seriesId) + { + return new SignalRMessage() + { + Name = SignalREvents.RefreshMetadata, + Body = new + { + SeriesId = seriesId, + LibraryId = libraryId + } + }; + } + + public static SignalRMessage UpdateVersionEvent(UpdateNotificationDto update) + { + return new SignalRMessage + { + Name = SignalREvents.UpdateVersion, + Body = update + }; + } + + } +} diff --git a/API/SignalR/SignalREvents.cs b/API/SignalR/SignalREvents.cs new file mode 100644 index 000000000..fcd077146 --- /dev/null +++ b/API/SignalR/SignalREvents.cs @@ -0,0 +1,11 @@ +namespace API.SignalR +{ + public static class SignalREvents + { + public const string UpdateVersion = "UpdateVersion"; + public const string ScanSeries = "ScanSeries"; + public const string RefreshMetadata = "RefreshMetadata"; + public const string ScanLibrary = "ScanLibrary"; + + } +} diff --git a/API/Startup.cs b/API/Startup.cs index cfdae2d9d..ee26e2d2b 100644 --- a/API/Startup.cs +++ b/API/Startup.cs @@ -2,6 +2,8 @@ using System; using System.IO; using System.IO.Compression; using System.Linq; +using System.Net; +using System.Net.Sockets; using API.Extensions; using API.Middleware; using API.Services; @@ -9,6 +11,7 @@ using API.Services.HostedServices; using API.SignalR; using Hangfire; using Hangfire.MemoryStorage; +using Kavita.Common; using Kavita.Common.EnvironmentInfo; using Microsoft.AspNetCore.Builder; using Microsoft.AspNetCore.Hosting; @@ -109,7 +112,7 @@ namespace API .AllowAnyHeader() .AllowAnyMethod() .AllowCredentials() // For SignalR token query param - .WithOrigins("http://localhost:4200") + .WithOrigins("http://localhost:4200", $"http://{GetLocalIpAddress()}:4200") .WithExposedHeaders("Content-Disposition", "Pagination")); } @@ -132,7 +135,7 @@ namespace API new Microsoft.Net.Http.Headers.CacheControlHeaderValue() { Public = false, - MaxAge = TimeSpan.FromSeconds(10) + MaxAge = TimeSpan.FromSeconds(10), }; context.Response.Headers[Microsoft.Net.Http.Headers.HeaderNames.Vary] = new[] { "Accept-Encoding" }; @@ -164,6 +167,14 @@ namespace API Console.WriteLine("You may now close the application window."); } + private static string GetLocalIpAddress() + { + using var socket = new Socket(AddressFamily.InterNetwork, SocketType.Dgram, 0); + socket.Connect("8.8.8.8", 65530); + if (socket.LocalEndPoint is IPEndPoint endPoint) return endPoint.Address.ToString(); + throw new KavitaException("No network adapters with an IPv4 address in the system!"); + } + } } diff --git a/Kavita.Common/Kavita.Common.csproj b/Kavita.Common/Kavita.Common.csproj index f5e97d5f7..83192fafd 100644 --- a/Kavita.Common/Kavita.Common.csproj +++ b/Kavita.Common/Kavita.Common.csproj @@ -4,7 +4,7 @@ net5.0 kavitareader.com Kavita - 0.4.5.1 + 0.4.6.1 en diff --git a/UI/Web/package-lock.json b/UI/Web/package-lock.json index 9f8f3aafa..2ae36e55d 100644 --- a/UI/Web/package-lock.json +++ b/UI/Web/package-lock.json @@ -245,6 +245,28 @@ "tslib": "^2.0.0" } }, + "@angular/cdk": { + "version": "12.2.3", + "resolved": "https://registry.npmjs.org/@angular/cdk/-/cdk-12.2.3.tgz", + "integrity": "sha512-ahY3k5X3eoQlsCX/fYiwbe1z7nfmwY15EiLpcJ8YrnUoB+ZshPm8qFIZi6gwY4tsMmUN8OfsIGcUO701bdxFpg==", + "requires": { + "parse5": "^5.0.0", + "tslib": "^2.2.0" + }, + "dependencies": { + "parse5": { + "version": "5.1.1", + "resolved": "https://registry.npmjs.org/parse5/-/parse5-5.1.1.tgz", + "integrity": "sha512-ugq4DFI0Ptb+WWjAdOK16+u/nHfiIrcE+sh8kZMaM0WllQKLI9rOUq6c2b7cwPkXdzfQESqvoqK6ug7U/Yyzug==", + "optional": true + }, + "tslib": { + "version": "2.3.1", + "resolved": "https://registry.npmjs.org/tslib/-/tslib-2.3.1.tgz", + "integrity": "sha512-77EbyPPpMz+FRFRuAFlWMtmgUWGe9UOG2Z25NqCwiIjRhOf5iKGuzSe5P2w1laq+FkRy4p+PCuVkJSGkzTEKVw==" + } + } + }, "@angular/cli": { "version": "11.2.11", "resolved": "https://registry.npmjs.org/@angular/cli/-/cli-11.2.11.tgz", @@ -2580,6 +2602,11 @@ } } }, + "@polka/url": { + "version": "1.0.0-next.20", + "resolved": "https://registry.npmjs.org/@polka/url/-/url-1.0.0-next.20.tgz", + "integrity": "sha512-88p7+M0QGxKpmnkfXjS4V26AnoC/eiqZutE8GLdaI5X12NY75bXSdTY9NkmYb2Xyk1O+MmkuO6Frmsj84V6I8Q==" + }, "@schematics/angular": { "version": "11.2.11", "resolved": "https://registry.npmjs.org/@schematics/angular/-/angular-11.2.11.tgz", @@ -5762,6 +5789,11 @@ "is-obj": "^2.0.0" } }, + "duplexer": { + "version": "0.1.2", + "resolved": "https://registry.npmjs.org/duplexer/-/duplexer-0.1.2.tgz", + "integrity": "sha512-jtD6YG370ZCIi/9GTaJKQxWTZD045+4R4hTk/x1UyoqadyJ9x9CgSi1RlVDQF8U2sxLLSnFkCaMihqljHIWgMg==" + }, "duplexify": { "version": "3.7.1", "resolved": "https://registry.npmjs.org/duplexify/-/duplexify-3.7.1.tgz", @@ -6957,6 +6989,14 @@ "dev": true, "optional": true }, + "gzip-size": { + "version": "6.0.0", + "resolved": "https://registry.npmjs.org/gzip-size/-/gzip-size-6.0.0.tgz", + "integrity": "sha512-ax7ZYomf6jqPTQ4+XCpUGyXKHk5WweS+e05MBO4/y3WJ5RkmPXNKvX+bx1behVILVwr6JSQvZAku021CHPXG3Q==", + "requires": { + "duplexer": "^0.1.2" + } + }, "handle-thing": { "version": "2.0.1", "resolved": "https://registry.npmjs.org/handle-thing/-/handle-thing-2.0.1.tgz", @@ -11166,6 +11206,11 @@ "is-wsl": "^2.1.1" } }, + "opener": { + "version": "1.5.2", + "resolved": "https://registry.npmjs.org/opener/-/opener-1.5.2.tgz", + "integrity": "sha512-ur5UIdyw5Y7yEj9wLzhqXiy6GZ3Mwx0yGI+5sMn2r0N0v3cKJvUmFH5yPP+WXh9e0xfyzyJX95D8l088DNFj7A==" + }, "opn": { "version": "5.5.0", "resolved": "https://registry.npmjs.org/opn/-/opn-5.5.0.tgz", @@ -14017,6 +14062,23 @@ } } }, + "sirv": { + "version": "1.0.17", + "resolved": "https://registry.npmjs.org/sirv/-/sirv-1.0.17.tgz", + "integrity": "sha512-qx9go5yraB7ekT7bCMqUHJ5jEaOC/GXBxUWv+jeWnb7WzHUFdcQPGWk7YmAwFBaQBrogpuSqd/azbC2lZRqqmw==", + "requires": { + "@polka/url": "^1.0.0-next.20", + "mime": "^2.3.1", + "totalist": "^1.0.0" + }, + "dependencies": { + "mime": { + "version": "2.5.2", + "resolved": "https://registry.npmjs.org/mime/-/mime-2.5.2.tgz", + "integrity": "sha512-tqkh47FzKeCPD2PUiPB6pkbMzsCasjxAfC62/Wap5qrUWcb+sFasXUC5I3gYM5iBM8v/Qpn4UK0x+j0iHyFPDg==" + } + } + }, "sisteransi": { "version": "1.0.5", "resolved": "https://registry.npmjs.org/sisteransi/-/sisteransi-1.0.5.tgz", @@ -15066,6 +15128,11 @@ "integrity": "sha512-yaOH/Pk/VEhBWWTlhI+qXxDFXlejDGcQipMlyxda9nthulaxLZUNcUqFxokp0vcYnvteJln5FNQDRrxj3YcbVw==", "dev": true }, + "totalist": { + "version": "1.1.0", + "resolved": "https://registry.npmjs.org/totalist/-/totalist-1.1.0.tgz", + "integrity": "sha512-gduQwd1rOdDMGxFG1gEvhV88Oirdo2p+KjoYFU7k2g+i7n6AFFbDQ5kMPUsW0pNbfQsB/cwXvT1i4Bue0s9g5g==" + }, "tough-cookie": { "version": "2.5.0", "resolved": "https://registry.npmjs.org/tough-cookie/-/tough-cookie-2.5.0.tgz", @@ -16220,6 +16287,87 @@ } } }, + "webpack-bundle-analyzer": { + "version": "4.4.2", + "resolved": "https://registry.npmjs.org/webpack-bundle-analyzer/-/webpack-bundle-analyzer-4.4.2.tgz", + "integrity": "sha512-PIagMYhlEzFfhMYOzs5gFT55DkUdkyrJi/SxJp8EF3YMWhS+T9vvs2EoTetpk5qb6VsCq02eXTlRDOydRhDFAQ==", + "requires": { + "acorn": "^8.0.4", + "acorn-walk": "^8.0.0", + "chalk": "^4.1.0", + "commander": "^6.2.0", + "gzip-size": "^6.0.0", + "lodash": "^4.17.20", + "opener": "^1.5.2", + "sirv": "^1.0.7", + "ws": "^7.3.1" + }, + "dependencies": { + "acorn": { + "version": "8.5.0", + "resolved": "https://registry.npmjs.org/acorn/-/acorn-8.5.0.tgz", + "integrity": "sha512-yXbYeFy+jUuYd3/CDcg2NkIYE991XYX/bje7LmjJigUciaeO1JR4XxXgCIV1/Zc/dRuFEyw1L0pbA+qynJkW5Q==" + }, + "acorn-walk": { + "version": "8.2.0", + "resolved": "https://registry.npmjs.org/acorn-walk/-/acorn-walk-8.2.0.tgz", + "integrity": "sha512-k+iyHEuPgSw6SbuDpGQM+06HQUa04DZ3o+F6CSzXMvvI5KMvnaEqXe+YVe555R9nn6GPt404fos4wcgpw12SDA==" + }, + "ansi-styles": { + "version": "4.3.0", + "resolved": "https://registry.npmjs.org/ansi-styles/-/ansi-styles-4.3.0.tgz", + "integrity": "sha512-zbB9rCJAT1rbjiVDb2hqKFHNYLxgtk8NURxZ3IZwD3F6NtxbXZQCnnSi1Lkx+IDohdPlFp222wVALIheZJQSEg==", + "requires": { + "color-convert": "^2.0.1" + } + }, + "chalk": { + "version": "4.1.2", + "resolved": "https://registry.npmjs.org/chalk/-/chalk-4.1.2.tgz", + "integrity": "sha512-oKnbhFyRIXpUuez8iBMmyEa4nbj4IOQyuhc/wy9kY7/WVPcwIO9VA668Pu8RkO7+0G76SLROeyw9CpQ061i4mA==", + "requires": { + "ansi-styles": "^4.1.0", + "supports-color": "^7.1.0" + } + }, + "color-convert": { + "version": "2.0.1", + "resolved": "https://registry.npmjs.org/color-convert/-/color-convert-2.0.1.tgz", + "integrity": "sha512-RRECPsj7iu/xb5oKYcsFHSppFNnsj/52OVTRKb4zP5onXwVF3zVmmToNcOfGC+CRDpfK/U584fMg38ZHCaElKQ==", + "requires": { + "color-name": "~1.1.4" + } + }, + "color-name": { + "version": "1.1.4", + "resolved": "https://registry.npmjs.org/color-name/-/color-name-1.1.4.tgz", + "integrity": "sha512-dOy+3AuW3a2wNbZHIuMZpTcgjGuLU/uBL/ubcZF9OXbDo8ff4O8yVp5Bf0efS8uEoYo5q4Fx7dY9OgQGXgAsQA==" + }, + "commander": { + "version": "6.2.1", + "resolved": "https://registry.npmjs.org/commander/-/commander-6.2.1.tgz", + "integrity": "sha512-U7VdrJFnJgo4xjrHpTzu0yrHPGImdsmD95ZlgYSEajAn2JKzDhDTPG9kBTefmObL2w/ngeZnilk+OV9CG3d7UA==" + }, + "has-flag": { + "version": "4.0.0", + "resolved": "https://registry.npmjs.org/has-flag/-/has-flag-4.0.0.tgz", + "integrity": "sha512-EykJT/Q1KjTWctppgIAgfSO0tKVuZUjhgMr17kqTumMl6Afv3EISleU7qZUzoXDFTAHTDC4NOoG/ZxU3EvlMPQ==" + }, + "supports-color": { + "version": "7.2.0", + "resolved": "https://registry.npmjs.org/supports-color/-/supports-color-7.2.0.tgz", + "integrity": "sha512-qpCAvRl9stuOHveKsn7HncJRvv501qIacKzQlO/+Lwxc9+0q2wLyv4Dfvt80/DPn2pqOBsJdDiogXGR9+OvwRw==", + "requires": { + "has-flag": "^4.0.0" + } + }, + "ws": { + "version": "7.5.5", + "resolved": "https://registry.npmjs.org/ws/-/ws-7.5.5.tgz", + "integrity": "sha512-BAkMFcAzl8as1G/hArkxOxq3G7pjUqQ3gzYbLL0/5zNkph70e+lCoxBGnm6AW1+/aiNeV4fnKqZ8m4GZewmH2w==" + } + } + }, "webpack-dev-middleware": { "version": "3.7.2", "resolved": "https://registry.npmjs.org/webpack-dev-middleware/-/webpack-dev-middleware-3.7.2.tgz", diff --git a/UI/Web/package.json b/UI/Web/package.json index 42caf67ec..515c35df8 100644 --- a/UI/Web/package.json +++ b/UI/Web/package.json @@ -6,7 +6,7 @@ "start": "ng serve", "build": "ng build", "prod": "ng build --prod", - "explore": "ng build --stats-json && webpack-bundle-analyzer ../kavita/API/wwwroot/stats.json", + "explore": "ng build --stats-json && webpack-bundle-analyzer dist/stats.json", "test": "jest", "test:watch": "jest --watch", "test:coverage": "jest --coverage", @@ -17,6 +17,7 @@ "dependencies": { "@angular-slider/ngx-slider": "^2.0.3", "@angular/animations": "~11.0.0", + "@angular/cdk": "^12.2.3", "@angular/common": "~11.0.0", "@angular/compiler": "~11.0.0", "@angular/core": "~11.0.0", @@ -45,6 +46,7 @@ "rxjs": "~6.6.0", "swiper": "^6.5.8", "tslib": "^2.0.0", + "webpack-bundle-analyzer": "^4.4.2", "zone.js": "~0.10.2" }, "devDependencies": { diff --git a/UI/Web/src/app/_guards/admin.guard.ts b/UI/Web/src/app/_guards/admin.guard.ts index e9483530e..b88c8d51c 100644 --- a/UI/Web/src/app/_guards/admin.guard.ts +++ b/UI/Web/src/app/_guards/admin.guard.ts @@ -19,7 +19,7 @@ export class AdminGuard implements CanActivate { if (this.accountService.hasAdminRole(user)) { return true; } - + this.toastr.error('You are not authorized to view this page.'); return false; }) diff --git a/UI/Web/src/app/_guards/auth.guard.ts b/UI/Web/src/app/_guards/auth.guard.ts index f477290fc..924f03bf2 100644 --- a/UI/Web/src/app/_guards/auth.guard.ts +++ b/UI/Web/src/app/_guards/auth.guard.ts @@ -19,7 +19,9 @@ export class AuthGuard implements CanActivate { if (user) { return true; } - this.toastr.error('You are not authorized to view this page.'); + if (this.toastr.toasts.filter(toast => toast.message === 'Unauthorized' || toast.message === 'You are not authorized to view this page.').length === 0) { + this.toastr.error('You are not authorized to view this page.'); + } localStorage.setItem(this.urlKey, window.location.pathname); this.router.navigateByUrl('/libraries'); return false; diff --git a/UI/Web/src/app/_models/events/scan-library-event.ts b/UI/Web/src/app/_models/events/scan-library-event.ts new file mode 100644 index 000000000..b0c663502 --- /dev/null +++ b/UI/Web/src/app/_models/events/scan-library-event.ts @@ -0,0 +1,4 @@ +export interface ScanLibraryEvent { + libraryId: number; + stage: 'complete'; +} \ No newline at end of file diff --git a/UI/Web/src/app/_models/events/scan-series-event.ts b/UI/Web/src/app/_models/events/scan-series-event.ts new file mode 100644 index 000000000..45f7a07bc --- /dev/null +++ b/UI/Web/src/app/_models/events/scan-series-event.ts @@ -0,0 +1,3 @@ +export interface ScanSeriesEvent { + seriesId: number; +} \ No newline at end of file diff --git a/UI/Web/src/app/_models/reading-list.ts b/UI/Web/src/app/_models/reading-list.ts new file mode 100644 index 000000000..ad1a325b8 --- /dev/null +++ b/UI/Web/src/app/_models/reading-list.ts @@ -0,0 +1,23 @@ +import { MangaFormat } from "./manga-format"; + +export interface ReadingListItem { + pagesRead: number; + pagesTotal: number; + seriesName: string; + seriesFormat: MangaFormat; + seriesId: number; + chapterId: number; + order: number; + chapterNumber: string; + volumeNumber: string; + libraryId: number; + id: number; +} + +export interface ReadingList { + id: number; + title: string; + summary: string; + promoted: boolean; + items: Array; +} \ No newline at end of file diff --git a/UI/Web/src/app/_models/series.ts b/UI/Web/src/app/_models/series.ts index 5d163cddf..be233122b 100644 --- a/UI/Web/src/app/_models/series.ts +++ b/UI/Web/src/app/_models/series.ts @@ -8,7 +8,6 @@ export interface Series { localizedName: string; sortName: string; summary: string; - coverImage: string; // This is not passed from backend any longer. TODO: Remove this field coverImageLocked: boolean; volumes: Volume[]; pages: number; // Total pages in series diff --git a/UI/Web/src/app/_services/action-factory.service.ts b/UI/Web/src/app/_services/action-factory.service.ts index 178e72400..450b577bc 100644 --- a/UI/Web/src/app/_services/action-factory.service.ts +++ b/UI/Web/src/app/_services/action-factory.service.ts @@ -3,6 +3,7 @@ import { Chapter } from '../_models/chapter'; import { CollectionTag } from '../_models/collection-tag'; import { Library } from '../_models/library'; import { MangaFormat } from '../_models/manga-format'; +import { ReadingList } from '../_models/reading-list'; import { Series } from '../_models/series'; import { Volume } from '../_models/volume'; import { AccountService } from './account.service'; @@ -16,7 +17,9 @@ export enum Action { Info = 5, RefreshMetadata = 6, Download = 7, - Bookmarks = 8 + Bookmarks = 8, + IncognitoRead = 9, + AddToReadingList = 10 } export interface ActionItem { @@ -41,6 +44,8 @@ export class ActionFactoryService { collectionTagActions: Array> = []; + readingListActions: Array> = []; + isAdmin = false; hasDownloadRole = false; @@ -108,7 +113,7 @@ export class ActionFactoryService { this.chapterActions.push({ action: Action.Edit, - title: 'Edit', + title: 'Info', callback: this.dummyCallback, requiresAdmin: false }); @@ -133,28 +138,39 @@ export class ActionFactoryService { } getLibraryActions(callback: (action: Action, library: Library) => void) { - this.libraryActions.forEach(action => action.callback = callback); - return this.libraryActions; + const actions = this.libraryActions.map(a => {return {...a}}); + actions.forEach(action => action.callback = callback); + return actions; } getSeriesActions(callback: (action: Action, series: Series) => void) { - this.seriesActions.forEach(action => action.callback = callback); - return this.seriesActions; + const actions = this.seriesActions.map(a => {return {...a}}); + actions.forEach(action => action.callback = callback); + return actions; } getVolumeActions(callback: (action: Action, volume: Volume) => void) { - this.volumeActions.forEach(action => action.callback = callback); - return this.volumeActions; + const actions = this.volumeActions.map(a => {return {...a}}); + actions.forEach(action => action.callback = callback); + return actions; } getChapterActions(callback: (action: Action, chapter: Chapter) => void) { - this.chapterActions.forEach(action => action.callback = callback); - return this.chapterActions; + const actions = this.chapterActions.map(a => {return {...a}}); + actions.forEach(action => action.callback = callback); + return actions; } getCollectionTagActions(callback: (action: Action, collectionTag: CollectionTag) => void) { - this.collectionTagActions.forEach(action => action.callback = callback); - return this.collectionTagActions; + const actions = this.collectionTagActions.map(a => {return {...a}}); + actions.forEach(action => action.callback = callback); + return actions; + } + + getReadingListActions(callback: (action: Action, readingList: ReadingList) => void) { + const actions = this.readingListActions.map(a => {return {...a}}); + actions.forEach(action => action.callback = callback); + return actions; } filterBookmarksForFormat(action: ActionItem, series: Series) { @@ -187,7 +203,13 @@ export class ActionFactoryService { title: 'Bookmarks', callback: this.dummyCallback, requiresAdmin: false - } + }, + { + action: Action.AddToReadingList, + title: 'Add to Reading List', + callback: this.dummyCallback, + requiresAdmin: false + }, ]; this.volumeActions = [ @@ -203,6 +225,18 @@ export class ActionFactoryService { callback: this.dummyCallback, requiresAdmin: false }, + { + action: Action.AddToReadingList, + title: 'Add to Reading List', + callback: this.dummyCallback, + requiresAdmin: false + }, + { + action: Action.IncognitoRead, + title: 'Read in Incognito', + callback: this.dummyCallback, + requiresAdmin: false + }, { action: Action.Edit, title: 'Info', @@ -223,7 +257,34 @@ export class ActionFactoryService { title: 'Mark as Unread', callback: this.dummyCallback, requiresAdmin: false - } + }, + { + action: Action.IncognitoRead, + title: 'Read in Incognito', + callback: this.dummyCallback, + requiresAdmin: false + }, + { + action: Action.AddToReadingList, + title: 'Add to Reading List', + callback: this.dummyCallback, + requiresAdmin: false + }, + ]; + + this.readingListActions = [ + { + action: Action.Edit, + title: 'Edit', + callback: this.dummyCallback, + requiresAdmin: false + }, + { + action: Action.Delete, + title: 'Delete', + callback: this.dummyCallback, + requiresAdmin: false + }, ]; } } diff --git a/UI/Web/src/app/_services/action.service.ts b/UI/Web/src/app/_services/action.service.ts index 3e400a80b..0cdfb3cfe 100644 --- a/UI/Web/src/app/_services/action.service.ts +++ b/UI/Web/src/app/_services/action.service.ts @@ -1,11 +1,14 @@ import { Injectable, OnDestroy } from '@angular/core'; import { NgbModal, NgbModalRef } from '@ng-bootstrap/ng-bootstrap'; import { ToastrService } from 'ngx-toastr'; -import { forkJoin, Subject } from 'rxjs'; -import { take, takeUntil } from 'rxjs/operators'; +import { Subject } from 'rxjs'; +import { take } from 'rxjs/operators'; import { BookmarksModalComponent } from '../cards/_modals/bookmarks-modal/bookmarks-modal.component'; +import { AddToListModalComponent, ADD_FLOW } from '../reading-list/_modals/add-to-list-modal/add-to-list-modal.component'; +import { EditReadingListModalComponent } from '../reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component'; import { Chapter } from '../_models/chapter'; import { Library } from '../_models/library'; +import { ReadingList } from '../_models/reading-list'; import { Series } from '../_models/series'; import { Volume } from '../_models/volume'; import { LibraryService } from './library.service'; @@ -16,6 +19,8 @@ export type LibraryActionCallback = (library: Partial) => void; export type SeriesActionCallback = (series: Series) => void; export type VolumeActionCallback = (volume: Volume) => void; export type ChapterActionCallback = (chapter: Chapter) => void; +export type ReadingListActionCallback = (readingList: ReadingList) => void; +export type VoidActionCallback = () => void; /** * Responsible for executing actions @@ -27,6 +32,7 @@ export class ActionService implements OnDestroy { private readonly onDestroy = new Subject(); private bookmarkModalRef: NgbModalRef | null = null; + private readingListModalRef: NgbModalRef | null = null; constructor(private libraryService: LibraryService, private seriesService: SeriesService, private readerService: ReaderService, private toastr: ToastrService, private modalService: NgbModal) { } @@ -156,7 +162,7 @@ export class ActionService implements OnDestroy { * @param callback Optional callback to perform actions after API completes */ markVolumeAsUnread(seriesId: number, volume: Volume, callback?: VolumeActionCallback) { - this.readerService.markVolumeRead(seriesId, volume.id).subscribe(() => { + this.readerService.markVolumeUnread(seriesId, volume.id).subscribe(() => { volume.pagesRead = 0; volume.chapters?.forEach(c => c.pagesRead = 0); this.toastr.success('Marked as Unread'); @@ -198,6 +204,85 @@ export class ActionService implements OnDestroy { }); } + /** + * Mark all chapters and the volumes as Read. All volumes and chapters must belong to a series + * @param seriesId Series Id + * @param volumes Volumes, should have id, chapters and pagesRead populated + * @param chapters? Chapters, should have id + * @param callback Optional callback to perform actions after API completes + */ + markMultipleAsRead(seriesId: number, volumes: Array, chapters?: Array, callback?: VoidActionCallback) { + this.readerService.markMultipleRead(seriesId, volumes.map(v => v.id), chapters?.map(c => c.id)).pipe(take(1)).subscribe(() => { + volumes.forEach(volume => { + volume.pagesRead = volume.pages; + volume.chapters?.forEach(c => c.pagesRead = c.pages); + }); + chapters?.forEach(c => c.pagesRead = c.pages); + this.toastr.success('Marked as Read'); + + if (callback) { + callback(); + } + }); + } + + /** + * Mark all chapters and the volumes as Unread. All volumes must belong to a series + * @param seriesId Series Id + * @param volumes Volumes, should have id, chapters and pagesRead populated + * @param callback Optional callback to perform actions after API completes + */ + markMultipleAsUnread(seriesId: number, volumes: Array, chapters?: Array, callback?: VoidActionCallback) { + this.readerService.markMultipleUnread(seriesId, volumes.map(v => v.id), chapters?.map(c => c.id)).pipe(take(1)).subscribe(() => { + volumes.forEach(volume => { + volume.pagesRead = volume.pages; + volume.chapters?.forEach(c => c.pagesRead = c.pages); + }); + chapters?.forEach(c => c.pagesRead = c.pages); + this.toastr.success('Marked as Read'); + + if (callback) { + callback(); + } + }); + } + + /** + * Mark all series as Read. + * @param series Series, should have id, pagesRead populated + * @param callback Optional callback to perform actions after API completes + */ + markMultipleSeriesAsRead(series: Array, callback?: VoidActionCallback) { + this.readerService.markMultipleSeriesRead(series.map(v => v.id)).pipe(take(1)).subscribe(() => { + series.forEach(s => { + s.pagesRead = s.pages; + }); + this.toastr.success('Marked as Read'); + + if (callback) { + callback(); + } + }); + } + + /** + * Mark all series as Unread. + * @param series Series, should have id, pagesRead populated + * @param callback Optional callback to perform actions after API completes + */ + markMultipleSeriesAsUnread(series: Array, callback?: VoidActionCallback) { + this.readerService.markMultipleSeriesUnread(series.map(v => v.id)).pipe(take(1)).subscribe(() => { + series.forEach(s => { + s.pagesRead = s.pages; + }); + this.toastr.success('Marked as Unread'); + + if (callback) { + callback(); + } + }); + } + openBookmarkModal(series: Series, callback?: SeriesActionCallback) { if (this.bookmarkModalRef != null) { return; } @@ -217,4 +302,131 @@ export class ActionService implements OnDestroy { }); } + addMultipleToReadingList(seriesId: number, volumes: Array, chapters?: Array, callback?: VoidActionCallback) { + if (this.readingListModalRef != null) { return; } + this.readingListModalRef = this.modalService.open(AddToListModalComponent, { scrollable: true, size: 'md' }); + this.readingListModalRef.componentInstance.seriesId = seriesId; + this.readingListModalRef.componentInstance.volumeIds = volumes.map(v => v.id); + this.readingListModalRef.componentInstance.chapterIds = chapters?.map(c => c.id); + this.readingListModalRef.componentInstance.title = 'Multiple Selections'; + this.readingListModalRef.componentInstance.type = ADD_FLOW.Multiple; + + + this.readingListModalRef.closed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(); + } + }); + this.readingListModalRef.dismissed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(); + } + }); + } + + addMultipleSeriesToReadingList(series: Array, callback?: VoidActionCallback) { + if (this.readingListModalRef != null) { return; } + this.readingListModalRef = this.modalService.open(AddToListModalComponent, { scrollable: true, size: 'md' }); + this.readingListModalRef.componentInstance.seriesIds = series.map(v => v.id); + this.readingListModalRef.componentInstance.title = 'Multiple Selections'; + this.readingListModalRef.componentInstance.type = ADD_FLOW.Multiple_Series; + + + this.readingListModalRef.closed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(); + } + }); + this.readingListModalRef.dismissed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(); + } + }); + } + + addSeriesToReadingList(series: Series, callback?: SeriesActionCallback) { + if (this.readingListModalRef != null) { return; } + this.readingListModalRef = this.modalService.open(AddToListModalComponent, { scrollable: true, size: 'md' }); + this.readingListModalRef.componentInstance.seriesId = series.id; + this.readingListModalRef.componentInstance.title = series.name; + this.readingListModalRef.componentInstance.type = ADD_FLOW.Series; + + + this.readingListModalRef.closed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(series); + } + }); + this.readingListModalRef.dismissed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(series); + } + }); + } + + addVolumeToReadingList(volume: Volume, seriesId: number, callback?: VolumeActionCallback) { + if (this.readingListModalRef != null) { return; } + this.readingListModalRef = this.modalService.open(AddToListModalComponent, { scrollable: true, size: 'md' }); + this.readingListModalRef.componentInstance.seriesId = seriesId; + this.readingListModalRef.componentInstance.volumeId = volume.id; + this.readingListModalRef.componentInstance.type = ADD_FLOW.Volume; + + + this.readingListModalRef.closed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(volume); + } + }); + this.readingListModalRef.dismissed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(volume); + } + }); + } + + addChapterToReadingList(chapter: Chapter, seriesId: number, callback?: ChapterActionCallback) { + if (this.readingListModalRef != null) { return; } + this.readingListModalRef = this.modalService.open(AddToListModalComponent, { scrollable: true, size: 'md' }); + this.readingListModalRef.componentInstance.seriesId = seriesId; + this.readingListModalRef.componentInstance.chapterId = chapter.id; + this.readingListModalRef.componentInstance.type = ADD_FLOW.Chapter; + + + this.readingListModalRef.closed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(chapter); + } + }); + this.readingListModalRef.dismissed.pipe(take(1)).subscribe(() => { + this.readingListModalRef = null; + if (callback) { + callback(chapter); + } + }); + } + + editReadingList(readingList: ReadingList, callback?: ReadingListActionCallback) { + const readingListModalRef = this.modalService.open(EditReadingListModalComponent, { scrollable: true, size: 'md' }); + readingListModalRef.componentInstance.readingList = readingList; + readingListModalRef.closed.pipe(take(1)).subscribe((list) => { + if (callback && list !== undefined) { + callback(readingList); + } + }); + readingListModalRef.dismissed.pipe(take(1)).subscribe((list) => { + if (callback && list !== undefined) { + callback(readingList); + } + }); + } + } diff --git a/UI/Web/src/app/_services/library.service.ts b/UI/Web/src/app/_services/library.service.ts index e6991e592..2c0b06f1f 100644 --- a/UI/Web/src/app/_services/library.service.ts +++ b/UI/Web/src/app/_services/library.service.ts @@ -37,7 +37,7 @@ export class LibraryService { listDirectories(rootPath: string) { let query = ''; if (rootPath !== undefined && rootPath.length > 0) { - query = '?path=' + rootPath; + query = '?path=' + encodeURIComponent(rootPath); } return this.httpClient.get(this.baseUrl + 'library/list' + query); diff --git a/UI/Web/src/app/_services/message-hub.service.ts b/UI/Web/src/app/_services/message-hub.service.ts index 33c39f18b..f5d193f6a 100644 --- a/UI/Web/src/app/_services/message-hub.service.ts +++ b/UI/Web/src/app/_services/message-hub.service.ts @@ -1,13 +1,18 @@ -import { Injectable } from '@angular/core'; +import { EventEmitter, Injectable } from '@angular/core'; import { HubConnection, HubConnectionBuilder } from '@microsoft/signalr'; import { NgbModal, NgbModalRef } from '@ng-bootstrap/ng-bootstrap'; import { User } from '@sentry/angular'; import { BehaviorSubject, ReplaySubject } from 'rxjs'; import { environment } from 'src/environments/environment'; import { UpdateNotificationModalComponent } from '../shared/update-notification/update-notification-modal.component'; +import { ScanLibraryEvent } from '../_models/events/scan-library-event'; +import { ScanSeriesEvent } from '../_models/events/scan-series-event'; export enum EVENTS { - UpdateAvailable = 'UpdateAvailable' + UpdateAvailable = 'UpdateAvailable', + ScanSeries = 'ScanSeries', + ScanLibrary = 'ScanLibrary', + RefreshMetadata = 'RefreshMetadata', } export interface Message { @@ -26,6 +31,9 @@ export class MessageHubService { private messagesSource = new ReplaySubject>(1); public messages$ = this.messagesSource.asObservable(); + public scanSeries: EventEmitter = new EventEmitter(); + public scanLibrary: EventEmitter = new EventEmitter(); + constructor(private modalService: NgbModal) { } createHubConnection(user: User) { @@ -44,6 +52,25 @@ export class MessageHubService { //console.log('[Hub] Body: ', body); }); + this.hubConnection.on(EVENTS.ScanSeries, resp => { + this.messagesSource.next({ + event: EVENTS.ScanSeries, + payload: resp.body + }); + this.scanSeries.emit(resp.body); + }); + + this.hubConnection.on(EVENTS.ScanLibrary, resp => { + this.messagesSource.next({ + event: EVENTS.ScanLibrary, + payload: resp.body + }); + this.scanLibrary.emit(resp.body); + // if ((resp.body as ScanLibraryEvent).stage === 'complete') { + // this.toastr. + // } + }); + this.hubConnection.on(EVENTS.UpdateAvailable, resp => { this.messagesSource.next({ event: EVENTS.UpdateAvailable, diff --git a/UI/Web/src/app/_services/reader.service.ts b/UI/Web/src/app/_services/reader.service.ts index 042eab4a0..8281ab9e9 100644 --- a/UI/Web/src/app/_services/reader.service.ts +++ b/UI/Web/src/app/_services/reader.service.ts @@ -56,8 +56,8 @@ export class ReaderService { return this.baseUrl + 'reader/image?chapterId=' + chapterId + '&page=' + page; } - getChapterInfo(seriesId: number, chapterId: number) { - return this.httpClient.get(this.baseUrl + 'reader/chapter-info?chapterId=' + chapterId + '&seriesId=' + seriesId); + getChapterInfo(chapterId: number) { + return this.httpClient.get(this.baseUrl + 'reader/chapter-info?chapterId=' + chapterId); } saveProgress(seriesId: number, volumeId: number, chapterId: number, page: number, bookScrollId: string | null = null) { @@ -68,17 +68,44 @@ export class ReaderService { return this.httpClient.post(this.baseUrl + 'reader/mark-volume-read', {seriesId, volumeId}); } - getNextChapter(seriesId: number, volumeId: number, currentChapterId: number) { + markMultipleRead(seriesId: number, volumeIds: Array, chapterIds?: Array) { + return this.httpClient.post(this.baseUrl + 'reader/mark-multiple-read', {seriesId, volumeIds, chapterIds}); + } + + markMultipleUnread(seriesId: number, volumeIds: Array, chapterIds?: Array) { + return this.httpClient.post(this.baseUrl + 'reader/mark-multiple-unread', {seriesId, volumeIds, chapterIds}); + } + + markMultipleSeriesRead(seriesIds: Array) { + return this.httpClient.post(this.baseUrl + 'reader/mark-multiple-series-read', {seriesIds}); + } + + markMultipleSeriesUnread(seriesIds: Array) { + return this.httpClient.post(this.baseUrl + 'reader/mark-multiple-series-unread', {seriesIds}); + } + + markVolumeUnread(seriesId: number, volumeId: number) { + return this.httpClient.post(this.baseUrl + 'reader/mark-volume-unread', {seriesId, volumeId}); + } + + + getNextChapter(seriesId: number, volumeId: number, currentChapterId: number, readingListId: number = -1) { + if (readingListId > 0) { + return this.httpClient.get(this.baseUrl + 'readinglist/next-chapter?seriesId=' + seriesId + '¤tChapterId=' + currentChapterId + '&readingListId=' + readingListId); + } return this.httpClient.get(this.baseUrl + 'reader/next-chapter?seriesId=' + seriesId + '&volumeId=' + volumeId + '¤tChapterId=' + currentChapterId); } - getPrevChapter(seriesId: number, volumeId: number, currentChapterId: number) { + getPrevChapter(seriesId: number, volumeId: number, currentChapterId: number, readingListId: number = -1) { + if (readingListId > 0) { + return this.httpClient.get(this.baseUrl + 'readinglist/prev-chapter?seriesId=' + seriesId + '¤tChapterId=' + currentChapterId + '&readingListId=' + readingListId); + } return this.httpClient.get(this.baseUrl + 'reader/prev-chapter?seriesId=' + seriesId + '&volumeId=' + volumeId + '¤tChapterId=' + currentChapterId); } getCurrentChapter(volumes: Array): Chapter { let currentlyReadingChapter: Chapter | undefined = undefined; - const chapters = volumes.filter(v => v.number !== 0).map(v => v.chapters || []).flat().sort(this.utilityService.sortChapters); // changed from === 0 to != 0 + const chapters = volumes.filter(v => v.number !== 0).map(v => v.chapters || []).flat().sort(this.utilityService.sortChapters); for (const c of chapters) { if (c.pagesRead < c.pages) { @@ -132,4 +159,38 @@ export class ReaderService { if (imageSrc === undefined || imageSrc === '') { return -1; } return parseInt(imageSrc.split('&page=')[1], 10); } + + getNextChapterUrl(url: string, nextChapterId: number, incognitoMode: boolean = false, readingListMode: boolean = false, readingListId: number = -1) { + const lastSlashIndex = url.lastIndexOf('/'); + let newRoute = url.substring(0, lastSlashIndex + 1) + nextChapterId + ''; + newRoute += this.getQueryParams(incognitoMode, readingListMode, readingListId); + return newRoute; + } + + + getQueryParamsObject(incognitoMode: boolean = false, readingListMode: boolean = false, readingListId: number = -1) { + let params: {[key: string]: any} = {}; + if (incognitoMode) { + params['incognitoMode'] = true; + } + if (readingListMode) { + params['readingListId'] = readingListId; + } + return params; + } + + getQueryParams(incognitoMode: boolean = false, readingListMode: boolean = false, readingListId: number = -1) { + let params = ''; + if (incognitoMode) { + params += '?incognitoMode=true'; + } + if (readingListMode) { + if (params.indexOf('?') > 0) { + params += '&readingListId=' + readingListId; + } else { + params += '?readingListId=' + readingListId; + } + } + return params; + } } diff --git a/UI/Web/src/app/_services/reading-list.service.ts b/UI/Web/src/app/_services/reading-list.service.ts new file mode 100644 index 000000000..e520154d6 --- /dev/null +++ b/UI/Web/src/app/_services/reading-list.service.ts @@ -0,0 +1,110 @@ +import { HttpClient, HttpParams } from '@angular/common/http'; +import { Injectable } from '@angular/core'; +import { map } from 'rxjs/operators'; +import { environment } from 'src/environments/environment'; +import { PaginatedResult } from '../_models/pagination'; +import { ReadingList, ReadingListItem } from '../_models/reading-list'; +import { ActionItem } from './action-factory.service'; + +@Injectable({ + providedIn: 'root' +}) +export class ReadingListService { + + baseUrl = environment.apiUrl; + + constructor(private httpClient: HttpClient) { } + + getReadingList(readingListId: number) { + return this.httpClient.get(this.baseUrl + 'readinglist?readingListId=' + readingListId); + } + + getReadingLists(includePromoted: boolean = true, pageNum?: number, itemsPerPage?: number) { + let params = new HttpParams(); + params = this._addPaginationIfExists(params, pageNum, itemsPerPage); + + return this.httpClient.post>(this.baseUrl + 'readinglist/lists?includePromoted=' + includePromoted, {}, {observe: 'response', params}).pipe( + map((response: any) => { + return this._cachePaginatedResults(response, new PaginatedResult()); + }) + ); + } + + getListItems(readingListId: number) { + return this.httpClient.get(this.baseUrl + 'readinglist/items?readingListId=' + readingListId); + } + + createList(title: string) { + return this.httpClient.post(this.baseUrl + 'readinglist/create', {title}); + } + + update(model: {readingListId: number, title?: string, summary?: string, promoted: boolean}) { + return this.httpClient.post(this.baseUrl + 'readinglist/update', model, { responseType: 'text' as 'json' }); + } + + updateByMultiple(readingListId: number, seriesId: number, volumeIds: Array, chapterIds?: Array) { + return this.httpClient.post(this.baseUrl + 'readinglist/update-by-multiple', {readingListId, seriesId, volumeIds, chapterIds}); + } + + updateByMultipleSeries(readingListId: number, seriesIds: Array) { + return this.httpClient.post(this.baseUrl + 'readinglist/update-by-multiple-series', {readingListId, seriesIds}); + } + + updateBySeries(readingListId: number, seriesId: number) { + return this.httpClient.post(this.baseUrl + 'readinglist/update-by-series', {readingListId, seriesId}, { responseType: 'text' as 'json' }); + } + + updateByVolume(readingListId: number, seriesId: number, volumeId: number) { + return this.httpClient.post(this.baseUrl + 'readinglist/update-by-volume', {readingListId, seriesId, volumeId}, { responseType: 'text' as 'json' }); + } + + updateByChapter(readingListId: number, seriesId: number, chapterId: number) { + return this.httpClient.post(this.baseUrl + 'readinglist/update-by-chapter', {readingListId, seriesId, chapterId}, { responseType: 'text' as 'json' }); + } + + delete(readingListId: number) { + return this.httpClient.delete(this.baseUrl + 'readinglist?readingListId=' + readingListId, { responseType: 'text' as 'json' }); + } + + updatePosition(readingListId: number, readingListItemId: number, fromPosition: number, toPosition: number) { + return this.httpClient.post(this.baseUrl + 'readinglist/update-position', {readingListId, readingListItemId, fromPosition, toPosition}, { responseType: 'text' as 'json' }); + } + + deleteItem(readingListId: number, readingListItemId: number) { + return this.httpClient.post(this.baseUrl + 'readinglist/delete-item', {readingListId, readingListItemId}, { responseType: 'text' as 'json' }); + } + + removeRead(readingListId: number) { + return this.httpClient.post(this.baseUrl + 'readinglist/remove-read?readingListId=' + readingListId, { responseType: 'text' as 'json' }); + } + + actionListFilter(action: ActionItem, readingList: ReadingList, isAdmin: boolean) { + if (readingList?.promoted && !isAdmin) return false; + return true; + } + + _addPaginationIfExists(params: HttpParams, pageNum?: number, itemsPerPage?: number) { + // TODO: Move to utility service + if (pageNum !== null && pageNum !== undefined && itemsPerPage !== null && itemsPerPage !== undefined) { + params = params.append('pageNumber', pageNum + ''); + params = params.append('pageSize', itemsPerPage + ''); + } + return params; + } + + _cachePaginatedResults(response: any, paginatedVariable: PaginatedResult) { + // TODO: Move to utility service + if (response.body === null) { + paginatedVariable.result = []; + } else { + paginatedVariable.result = response.body; + } + + const pageHeader = response.headers.get('Pagination'); + if (pageHeader !== null) { + paginatedVariable.pagination = JSON.parse(pageHeader); + } + + return paginatedVariable; + } +} diff --git a/UI/Web/src/app/admin/_modals/directory-picker/directory-picker.component.html b/UI/Web/src/app/admin/_modals/directory-picker/directory-picker.component.html index 78440a06b..6f6d02630 100644 --- a/UI/Web/src/app/admin/_modals/directory-picker/directory-picker.component.html +++ b/UI/Web/src/app/admin/_modals/directory-picker/directory-picker.component.html @@ -9,7 +9,7 @@
- +
@@ -27,7 +27,7 @@ -
Select a folder to view breadcrumb
+
Select a folder to view breadcrumb. Don't see your directory, try checking / first.
    @@ -50,5 +50,6 @@
+ Help
diff --git a/UI/Web/src/app/admin/_modals/library-access-modal/library-access-modal.component.html b/UI/Web/src/app/admin/_modals/library-access-modal/library-access-modal.component.html index 458880b5e..de4001387 100644 --- a/UI/Web/src/app/admin/_modals/library-access-modal/library-access-modal.component.html +++ b/UI/Web/src/app/admin/_modals/library-access-modal/library-access-modal.component.html @@ -14,6 +14,9 @@
+
  • + There are no libraries setup yet. +
    • diff --git a/UI/Web/src/app/admin/_modals/library-editor-modal/library-editor-modal.component.ts b/UI/Web/src/app/admin/_modals/library-editor-modal/library-editor-modal.component.ts index f1257aa8d..441a1ca2a 100644 --- a/UI/Web/src/app/admin/_modals/library-editor-modal/library-editor-modal.component.ts +++ b/UI/Web/src/app/admin/_modals/library-editor-modal/library-editor-modal.component.ts @@ -1,6 +1,7 @@ import { Component, Input, OnInit } from '@angular/core'; import { FormControl, FormGroup, Validators } from '@angular/forms'; import { NgbActiveModal, NgbModal } from '@ng-bootstrap/ng-bootstrap'; +import { ToastrService } from 'ngx-toastr'; import { Library } from 'src/app/_models/library'; import { LibraryService } from 'src/app/_services/library.service'; import { SettingsService } from '../../settings.service'; @@ -26,7 +27,8 @@ export class LibraryEditorModalComponent implements OnInit { libraryTypes: string[] = [] - constructor(private modalService: NgbModal, private libraryService: LibraryService, public modal: NgbActiveModal, private settingService: SettingsService) { } + constructor(private modalService: NgbModal, private libraryService: LibraryService, public modal: NgbActiveModal, private settingService: SettingsService, + private toastr: ToastrService) { } ngOnInit(): void { @@ -64,6 +66,7 @@ export class LibraryEditorModalComponent implements OnInit { model.folders = model.folders.map((item: string) => item.startsWith('\\') ? item.substr(1, item.length) : item); model.type = parseInt(model.type, 10); this.libraryService.create(model).subscribe(() => { + this.toastr.success('Library created, a scan has been started'); this.close(true); }, err => { this.errorMessage = err; diff --git a/UI/Web/src/app/admin/admin.module.ts b/UI/Web/src/app/admin/admin.module.ts index 73b3717e3..5ffadf3a1 100644 --- a/UI/Web/src/app/admin/admin.module.ts +++ b/UI/Web/src/app/admin/admin.module.ts @@ -12,10 +12,10 @@ import { DirectoryPickerComponent } from './_modals/directory-picker/directory-p import { FormsModule, ReactiveFormsModule } from '@angular/forms'; import { ResetPasswordModalComponent } from './_modals/reset-password-modal/reset-password-modal.component'; import { ManageSettingsComponent } from './manage-settings/manage-settings.component'; -import { FilterPipe } from './filter.pipe'; import { EditRbsModalComponent } from './_modals/edit-rbs-modal/edit-rbs-modal.component'; import { ManageSystemComponent } from './manage-system/manage-system.component'; import { ChangelogComponent } from './changelog/changelog.component'; +import { PipeModule } from '../pipe/pipe.module'; @@ -30,7 +30,6 @@ import { ChangelogComponent } from './changelog/changelog.component'; DirectoryPickerComponent, ResetPasswordModalComponent, ManageSettingsComponent, - FilterPipe, EditRbsModalComponent, ManageSystemComponent, ChangelogComponent, @@ -44,6 +43,7 @@ import { ChangelogComponent } from './changelog/changelog.component'; NgbTooltipModule, NgbDropdownModule, SharedModule, + PipeModule ], providers: [] }) diff --git a/UI/Web/src/app/admin/changelog/changelog.component.html b/UI/Web/src/app/admin/changelog/changelog.component.html index 073b72b95..03ef9fe5d 100644 --- a/UI/Web/src/app/admin/changelog/changelog.component.html +++ b/UI/Web/src/app/admin/changelog/changelog.component.html @@ -1,7 +1,10 @@
    -
    {{update.updateTitle}} Installed
    +
    {{update.updateTitle}}  + Installed + Available + 
    
           Download
         
    
@@ -11,4 +14,4 @@
 
 
\ No newline at end of file
+
    
diff --git a/UI/Web/src/app/admin/dashboard/dashboard.component.html b/UI/Web/src/app/admin/dashboard/dashboard.component.html
index 26886dd7f..9b34f71f8 100644
--- a/UI/Web/src/app/admin/dashboard/dashboard.component.html
+++ b/UI/Web/src/app/admin/dashboard/dashboard.component.html
@@ -1,7 +1,7 @@
 
    
   
    Admin Dashboard
    
 
-  
      
+  
        
       
      • 
         {{ tab.title | titlecase }}
         
diff --git a/UI/Web/src/app/admin/manage-users/manage-users.component.html b/UI/Web/src/app/admin/manage-users/manage-users.component.html
index b73841af4..5aff35f12 100644
--- a/UI/Web/src/app/admin/manage-users/manage-users.component.html
+++ b/UI/Web/src/app/admin/manage-users/manage-users.component.html
@@ -9,7 +9,7 @@
         
      • 
             
        
                 
        
-                    {{member.username | titlecase}} Admin
+                    {{member.username | titlecase}} (You)
                     
        
                         
                         
diff --git a/UI/Web/src/app/admin/manage-users/manage-users.component.ts b/UI/Web/src/app/admin/manage-users/manage-users.component.ts
index 48185ba56..fd3d50f62 100644
--- a/UI/Web/src/app/admin/manage-users/manage-users.component.ts
+++ b/UI/Web/src/app/admin/manage-users/manage-users.component.ts
@@ -53,7 +53,18 @@ export class ManageUsersComponent implements OnInit, OnDestroy {
   loadMembers() {
     this.loadingMembers = true;
     this.memberService.getMembers().subscribe(members => {
-      this.members = members.filter(member => member.username !== this.loggedInUsername);
+      this.members = members;
+      // Show logged in user at the top of the list
+      this.members.sort((a: Member, b: Member) => {
+        if (a.username === this.loggedInUsername) return 1;
+        if (b.username === this.loggedInUsername) return 1;
+
+        const nameA = a.username.toUpperCase();
+        const nameB = b.username.toUpperCase();
+        if (nameA < nameB) return -1;
+        if (nameA > nameB) return 1;
+        return 0;
+      })
       this.loadingMembers = false;
     });
   }
diff --git a/UI/Web/src/app/app-routing.module.ts b/UI/Web/src/app/app-routing.module.ts
index 21155ec75..e65fd5ee3 100644
--- a/UI/Web/src/app/app-routing.module.ts
+++ b/UI/Web/src/app/app-routing.module.ts
@@ -10,6 +10,8 @@ import { UserLoginComponent } from './user-login/user-login.component';
 import { AuthGuard } from './_guards/auth.guard';
 import { LibraryAccessGuard } from './_guards/library-access.guard';
 import { InProgressComponent } from './in-progress/in-progress.component';
+import { DashboardComponent as AdminDashboardComponent } from './admin/dashboard/dashboard.component';
+import { DashboardComponent } from './dashboard/dashboard.component';
 
 // TODO: Once we modularize the components, use this and measure performance impact: https://angular.io/guide/lazy-loading-ngmodules#preloading-modules
 
@@ -27,6 +29,10 @@ const routes: Routes = [
     path: 'preferences',
     loadChildren: () => import('./user-settings/user-settings.module').then(m => m.UserSettingsModule)
   },
+  {
+    path: 'lists',
+    loadChildren: () => import('./reading-list/reading-list.module').then(m => m.ReadingListModule)
+  },
   {
     path: '',
     runGuardsAndResolvers: 'always',
@@ -49,7 +55,7 @@ const routes: Routes = [
     runGuardsAndResolvers: 'always',
     canActivate: [AuthGuard],
     children: [
-      {path: 'library', component: LibraryComponent},
+      {path: 'library', component: DashboardComponent},
       {path: 'recently-added', component: RecentlyAddedComponent},
       {path: 'in-progress', component: InProgressComponent},
     ]
diff --git a/UI/Web/src/app/app.module.ts b/UI/Web/src/app/app.module.ts
index a8d5915a5..9a029e665 100644
--- a/UI/Web/src/app/app.module.ts
+++ b/UI/Web/src/app/app.module.ts
@@ -7,7 +7,7 @@ import { BrowserAnimationsModule } from '@angular/platform-browser/animations';
 import { HomeComponent } from './home/home.component';
 import { FormsModule, ReactiveFormsModule } from '@angular/forms';
 import { HttpClientModule, HTTP_INTERCEPTORS } from '@angular/common/http';
-import { NgbAccordionModule, NgbDropdownModule, NgbNavModule, NgbPaginationModule, NgbRatingModule, NgbTooltipModule } from '@ng-bootstrap/ng-bootstrap';
+import { NgbDropdownModule, NgbNavModule, NgbPaginationModule, NgbRatingModule } from '@ng-bootstrap/ng-bootstrap';
 import { NavHeaderComponent } from './nav-header/nav-header.component';
 import { JwtInterceptor } from './_interceptors/jwt.interceptor';
 import { UserLoginComponent } from './user-login/user-login.component';
@@ -21,7 +21,6 @@ import { NotConnectedComponent } from './not-connected/not-connected.component';
 import { AutocompleteLibModule } from 'angular-ng-autocomplete';
 import { ReviewSeriesModalComponent } from './_modals/review-series-modal/review-series-modal.component';
 import { CarouselModule } from './carousel/carousel.module';
-import { NgxSliderModule } from '@angular-slider/ngx-slider';
 
 
 import * as Sentry from '@sentry/angular';
@@ -33,11 +32,12 @@ import { Dedupe as DedupeIntegration } from '@sentry/integrations';
 import { PersonBadgeComponent } from './person-badge/person-badge.component';
 import { TypeaheadModule } from './typeahead/typeahead.module';
 import { RecentlyAddedComponent } from './recently-added/recently-added.component';
-import { InProgressComponent } from './in-progress/in-progress.component';
 import { CardsModule } from './cards/cards.module';
 import { CollectionsModule } from './collections/collections.module';
-import { CommonModule } from '@angular/common';
+import { InProgressComponent } from './in-progress/in-progress.component';
 import { SAVER, getSaver } from './shared/_providers/saver.provider';
+import { ReadingListModule } from './reading-list/reading-list.module';
+import { DashboardComponent } from './dashboard/dashboard.component';
 
 let sentryProviders: any[] = [];
 
@@ -98,6 +98,7 @@ if (environment.production) {
     PersonBadgeComponent,
     RecentlyAddedComponent,
     InProgressComponent,
+    DashboardComponent,
   ],
   imports: [
     HttpClientModule,
@@ -109,19 +110,16 @@ if (environment.production) {
 
     NgbDropdownModule, // Nav
     AutocompleteLibModule, // Nav
-    //NgbTooltipModule, // Shared & SettingsModule
     NgbRatingModule, // Series Detail
     NgbNavModule,
-    //NgbAccordionModule, // User Preferences
-    //NgxSliderModule, // User Preference
     NgbPaginationModule,
 
-
     SharedModule,
     CarouselModule,
     TypeaheadModule,
     CardsModule,
     CollectionsModule,
+    ReadingListModule,
 
     ToastrModule.forRoot({
       positionClass: 'toast-bottom-right',
diff --git a/UI/Web/src/app/book-reader/_models/book-info.ts b/UI/Web/src/app/book-reader/_models/book-info.ts
new file mode 100644
index 000000000..4816bd324
--- /dev/null
+++ b/UI/Web/src/app/book-reader/_models/book-info.ts
@@ -0,0 +1,9 @@
+import { MangaFormat } from "src/app/_models/manga-format";
+
+export interface BookInfo {
+    bookTitle: string;
+    seriesFormat: MangaFormat;
+    seriesId: number;
+    libraryId: number;
+    volumeId: number;
+}
\ No newline at end of file
diff --git a/UI/Web/src/app/book-reader/book-reader/book-reader.component.html b/UI/Web/src/app/book-reader/book-reader/book-reader.component.html
index fb727f93f..93f458d35 100644
--- a/UI/Web/src/app/book-reader/book-reader/book-reader.component.html
+++ b/UI/Web/src/app/book-reader/book-reader/book-reader.component.html
@@ -63,11 +63,13 @@
                     
        
                 
        
                 
        
-                    
        {{pageNum}}
        
-                    
        
+                    
+                    
        {{pageNum}}
        
+                    
        
                         
                     
        
-                    
        {{maxPages - 1}}
        
+                    
        {{maxPages - 1}}
        
+                    
                 
        
                 
        
                     
        Table of Contents
        
@@ -77,18 +79,18 @@
                     
                     
                         
@@ -110,9 +112,9 @@
     
        
         
        
 
-        
        
+        
        
         
        
-        
        
+        
        
         
        
         
         
        
@@ -122,12 +124,22 @@
 
     
         
        
-            
+            
             
             
-            
        {{bookTitle}} 
        
+            
        {{bookTitle}}  (Incognito Mode)
        
             
-            
+            
         
        
             
 
diff --git a/UI/Web/src/app/book-reader/book-reader/book-reader.component.ts b/UI/Web/src/app/book-reader/book-reader/book-reader.component.ts
index 0b6e35163..8f3984565 100644
--- a/UI/Web/src/app/book-reader/book-reader/book-reader.component.ts
+++ b/UI/Web/src/app/book-reader/book-reader/book-reader.component.ts
@@ -22,6 +22,7 @@ import { Preferences } from 'src/app/_models/preferences/preferences';
 import { MemberService } from 'src/app/_services/member.service';
 import { ReadingDirection } from 'src/app/_models/preferences/reading-direction';
 import { ScrollService } from 'src/app/scroll.service';
+import { MangaFormat } from 'src/app/_models/manga-format';
 
 
 interface PageStyle {
@@ -38,7 +39,8 @@ interface HistoryPoint {
 }
 
 const TOP_OFFSET = -50 * 1.5; // px the sticky header takes up
-const SCROLL_PART_TIMEOUT = 5000;
+const CHAPTER_ID_NOT_FETCHED = -2;
+const CHAPTER_ID_DOESNT_EXIST = -1;
 
 @Component({
   selector: 'app-book-reader',
@@ -64,12 +66,31 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
   volumeId!: number;
   chapterId!: number;
   chapter!: Chapter;
+  /**
+   * Reading List id. Defaults to -1.
+   */
+  readingListId: number = CHAPTER_ID_DOESNT_EXIST;
+
+   /**
+    * If this is true, no progress will be saved.
+    */
+  incognitoMode: boolean = false;
+ 
+   /**
+    * If this is true, chapters will be fetched in the order of a reading list, rather than natural series order. 
+    */
+  readingListMode: boolean = false;
 
   chapters: Array = [];
 
   pageNum = 0;
   maxPages = 1;
   adhocPageHistory: Stack = new Stack();
+  /**
+   * A stack of the chapter ids we come across during continuous reading mode. When we traverse a boundary, we use this to avoid extra API calls.
+   * @see Stack
+   */
+   continuousChaptersStack: Stack = new Stack();
   
   user!: User;
 
@@ -90,6 +111,38 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
   @ViewChild('readingSection', {static: false}) readingSectionElemRef!: ElementRef;
   @ViewChild('stickyTop', {static: false}) stickyTopElemRef!: ElementRef;
 
+  /**
+   * Next Chapter Id. This is not garunteed to be a valid ChapterId. Prefetched on page load (non-blocking).
+   */
+   nextChapterId: number = CHAPTER_ID_NOT_FETCHED;
+   /**
+    * Previous Chapter Id. This is not garunteed to be a valid ChapterId. Prefetched on page load (non-blocking).
+    */
+   prevChapterId: number = CHAPTER_ID_NOT_FETCHED;
+   /**
+    * Is there a next chapter. If not, this will disable UI controls.
+    */
+   nextChapterDisabled: boolean = false;
+   /**
+    * Is there a previous chapter. If not, this will disable UI controls.
+    */
+   prevChapterDisabled: boolean = false;
+   /**
+    * Has the next chapter been prefetched. Prefetched means the backend will cache the files.
+    */
+   nextChapterPrefetched: boolean = false;
+   /**
+    * Has the previous chapter been prefetched. Prefetched means the backend will cache the files.
+    */
+   prevChapterPrefetched: boolean = false;
+  /**
+   * If the prev page allows a page change to occur.
+   */
+   prevPageDisabled = false;
+   /**
+    * If the next page allows a page change to occur.
+    */
+   nextPageDisabled = false;
 
   /**
    * Internal property used to capture all the different css properties to render on all elements
@@ -118,6 +171,7 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
    * Last seen progress part path
    */
   lastSeenScrollPartPath: string = '';
+
   /**
    * Hack: Override background color for reader and restore it onDestroy
    */
@@ -147,6 +201,24 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     }
   `;
 
+  get ReadingDirection(): typeof ReadingDirection {
+    return ReadingDirection;
+  }
+
+  get IsPrevDisabled() {
+    if (this.readingDirection === ReadingDirection.LeftToRight) {
+      return this.prevPageDisabled && this.pageNum === 0;
+    } 
+    return this.nextPageDisabled && this.pageNum + 1 >= this.maxPages - 1;
+  }
+
+  get IsNextDisabled() {
+    if (this.readingDirection === ReadingDirection.LeftToRight) {
+      this.nextPageDisabled && this.pageNum + 1 >= this.maxPages - 1;
+    }
+    return this.prevPageDisabled && this.pageNum === 0;
+  }
+
   constructor(private route: ActivatedRoute, private router: Router, private accountService: AccountService,
     private seriesService: SeriesService, private readerService: ReaderService, private location: Location,
     private renderer: Renderer2, private navService: NavService, private toastr: ToastrService, 
@@ -214,14 +286,17 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
           const alreadyReached = Object.values(this.pageAnchors).filter((i: number) => i <= verticalOffset);
           if (alreadyReached.length > 0) {
             this.currentPageAnchor = Object.keys(this.pageAnchors)[alreadyReached.length - 1];
-            this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, this.pageNum, this.lastSeenScrollPartPath).pipe(take(1)).subscribe(() => {/* No operation */});
+
+            if (!this.incognitoMode) {
+              this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, this.pageNum, this.lastSeenScrollPartPath).pipe(take(1)).subscribe(() => {/* No operation */});
+            }
             return;
           } else {
             this.currentPageAnchor = '';
           }
         }
 
-        if (this.lastSeenScrollPartPath !== '') {
+        if (this.lastSeenScrollPartPath !== '' && !this.incognitoMode) {
           this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, this.pageNum, this.lastSeenScrollPartPath).pipe(take(1)).subscribe(() => {/* No operation */});
         }
     });
@@ -268,6 +343,14 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     this.libraryId = parseInt(libraryId, 10);
     this.seriesId = parseInt(seriesId, 10);
     this.chapterId = parseInt(chapterId, 10);
+    this.incognitoMode = this.route.snapshot.queryParamMap.get('incognitoMode') === 'true';
+
+    const readingListId = this.route.snapshot.queryParamMap.get('readingListId');
+    if (readingListId != null) {
+      this.readingListMode = true;
+      this.readingListId = parseInt(readingListId, 10);
+    }
+
 
     this.memberService.hasReadingProgress(this.libraryId).pipe(take(1)).subscribe(hasProgress => {
       if (!hasProgress) {
@@ -276,32 +359,71 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
       }
     });
 
-    forkJoin({
-      chapter: this.seriesService.getChapter(this.chapterId),
-      progress: this.readerService.getProgress(this.chapterId),
-      chapters: this.bookService.getBookChapters(this.chapterId),
-      info: this.bookService.getBookInfo(this.chapterId)
-    }).pipe(take(1)).subscribe(results => {
-      this.chapter = results.chapter;
-      this.volumeId = results.chapter.volumeId;
-      this.maxPages = results.chapter.pages;
-      this.chapters = results.chapters;
-      this.pageNum = results.progress.pageNum;
-      this.bookTitle = results.info;
+    this.init();
+  }
 
+  init() {
+    this.nextChapterId = CHAPTER_ID_NOT_FETCHED;
+    this.prevChapterId = CHAPTER_ID_NOT_FETCHED;
+    this.nextChapterDisabled = false;
+    this.prevChapterDisabled = false;
+    this.nextChapterPrefetched = false;
 
-      if (this.pageNum >= this.maxPages) {
-        this.pageNum = this.maxPages - 1;
-        this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, this.pageNum).pipe(take(1)).subscribe(() => {/* No operation */});
+    this.bookService.getBookInfo(this.chapterId).subscribe(info => {
+      this.bookTitle = info.bookTitle;
+  
+      if (this.readingListMode && info.seriesFormat !== MangaFormat.EPUB) {
+        // Redirect to the manga reader. 
+        const params = this.readerService.getQueryParamsObject(this.incognitoMode, this.readingListMode, this.readingListId);
+        this.router.navigate(['library', info.libraryId, 'series', info.seriesId, 'manga', this.chapterId], {queryParams: params});
+        return;
       }
 
-      // Check if user progress has part, if so load it so we scroll to it
-      this.loadPage(results.progress.bookScrollId || undefined);
-    }, () => {
-      setTimeout(() => {
-        this.closeReader();
-      }, 200);
+      forkJoin({
+        chapter: this.seriesService.getChapter(this.chapterId),
+        progress: this.readerService.getProgress(this.chapterId),
+        chapters: this.bookService.getBookChapters(this.chapterId),
+      }).pipe(take(1)).subscribe(results => {
+        this.chapter = results.chapter;
+        this.volumeId = results.chapter.volumeId;
+        this.maxPages = results.chapter.pages;
+        this.chapters = results.chapters;
+        this.pageNum = results.progress.pageNum;
+        
+  
+        this.continuousChaptersStack.push(this.chapterId);
+  
+  
+        if (this.pageNum >= this.maxPages) {
+          this.pageNum = this.maxPages - 1;
+          if (!this.incognitoMode) {
+            this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, this.pageNum).pipe(take(1)).subscribe(() => {/* No operation */});
+          }
+        }
+  
+        this.readerService.getNextChapter(this.seriesId, this.volumeId, this.chapterId, this.readingListId).pipe(take(1)).subscribe(chapterId => {
+          this.nextChapterId = chapterId;
+          if (chapterId === CHAPTER_ID_DOESNT_EXIST || chapterId === this.chapterId) {
+            this.nextChapterDisabled = true;
+          }
+        });
+        this.readerService.getPrevChapter(this.seriesId, this.volumeId, this.chapterId, this.readingListId).pipe(take(1)).subscribe(chapterId => {
+          this.prevChapterId = chapterId;
+          if (chapterId === CHAPTER_ID_DOESNT_EXIST || chapterId === this.chapterId) {
+            this.prevChapterDisabled = true;
+          }
+        });
+  
+        // Check if user progress has part, if so load it so we scroll to it
+        this.loadPage(results.progress.bookScrollId || undefined);
+      }, () => {
+        setTimeout(() => {
+          this.closeReader();
+        }, 200);
+      });
     });
+
+    
   }
 
   @HostListener('window:keydown', ['$event'])
@@ -322,7 +444,9 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
   }
 
   handleIntersection(entries: IntersectionObserverEntry[]) {
-    const intersectingEntries = Array.from(entries).filter(entry => entry.isIntersecting).map(entry => entry.target);
+    let intersectingEntries = Array.from(entries)
+      .filter(entry => entry.isIntersecting)
+      .map(entry => entry.target)
     intersectingEntries.sort((a: Element, b: Element) => {
       const aTop = a.getBoundingClientRect().top;
       const bTop = b.getBoundingClientRect().top;
@@ -336,6 +460,7 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
       return 0;
     });
 
+
     if (intersectingEntries.length > 0) {
       let path = this.getXPathTo(intersectingEntries[0]);
         if (path === '') { return; }
@@ -346,13 +471,74 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     }
   }
 
-  loadChapter(pageNum: number, part: string) {
+  loadNextChapter() {
+    if (this.nextPageDisabled) { return; }
+    this.isLoading = true;
+    if (this.nextChapterId === CHAPTER_ID_NOT_FETCHED || this.nextChapterId === this.chapterId) {
+      this.readerService.getNextChapter(this.seriesId, this.volumeId, this.chapterId, this.readingListId).pipe(take(1)).subscribe(chapterId => {
+        this.nextChapterId = chapterId;
+        this.loadChapter(chapterId, 'Next');
+      });
+    } else {
+      this.loadChapter(this.nextChapterId, 'Next');
+    }
+  }
+
+  loadPrevChapter() {
+    if (this.prevPageDisabled) { return; }
+    this.isLoading = true;
+    this.continuousChaptersStack.pop();
+    const prevChapter = this.continuousChaptersStack.peek();
+    if (prevChapter != this.chapterId) {
+      if (prevChapter !== undefined) {
+        this.chapterId = prevChapter;
+        this.init();
+        return;
+      }
+    }
+
+    if (this.prevChapterId === CHAPTER_ID_NOT_FETCHED || this.prevChapterId === this.chapterId) {
+      this.readerService.getPrevChapter(this.seriesId, this.volumeId, this.chapterId, this.readingListId).pipe(take(1)).subscribe(chapterId => {
+        this.prevChapterId = chapterId;
+        this.loadChapter(chapterId, 'Prev');
+      });
+    } else {
+      this.loadChapter(this.prevChapterId, 'Prev');
+    }
+  }
+
+  loadChapter(chapterId: number, direction: 'Next' | 'Prev') {
+    if (chapterId >= 0) {
+      this.chapterId = chapterId;
+      this.continuousChaptersStack.push(chapterId); 
+      // Load chapter Id onto route but don't reload
+      const newRoute = this.readerService.getNextChapterUrl(this.router.url, this.chapterId, this.incognitoMode, this.readingListMode, this.readingListId);
+      window.history.replaceState({}, '', newRoute);
+      this.init();
+      this.toastr.info(direction + ' chapter loaded', '', {timeOut: 3000});
+    } else {
+      // This will only happen if no actual chapter can be found
+      this.toastr.warning('Could not find ' + direction + ' chapter');
+      this.isLoading = false;
+      if (direction === 'Prev') {
+        this.prevPageDisabled = true;
+      } else {
+        this.nextPageDisabled = true;
+      }
+    }
+  }
+
+  loadChapterPage(pageNum: number, part: string) {
     this.setPageNum(pageNum);
     this.loadPage('id("' + part + '")');
   }
 
   closeReader() {
-    this.location.back();
+    if (this.readingListMode) {
+      this.router.navigateByUrl('lists/' + this.readingListId);
+    } else {
+      this.location.back();
+    }
   }
 
   resetSettings() {
@@ -466,7 +652,9 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
 
   setupPageAnchors() {
     this.readingSectionElemRef.nativeElement.querySelectorAll('div,o,p,ul,li,a,img,h1,h2,h3,h4,h5,h6,span').forEach(elem => {
-      this.intersectionObserver.observe(elem);
+      if (!elem.classList.contains('no-observe')) {
+        this.intersectionObserver.observe(elem);
+      }
     });
 
     this.pageAnchors = {};
@@ -483,7 +671,9 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
   loadPage(part?: string | undefined, scrollTop?: number | undefined) {
     this.isLoading = true;
 
-    this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, this.pageNum).pipe(take(1)).subscribe(() => {/* No operation */});
+    if (!this.incognitoMode) {
+      this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, this.pageNum).pipe(take(1)).subscribe(() => {/* No operation */});
+    }
 
     this.bookService.getBookPage(this.chapterId, this.pageNum).pipe(take(1)).subscribe(content => {
       this.page = this.domSanitizer.bypassSecurityTrustHtml(content);
@@ -563,7 +753,14 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
       this.setPageNum(this.pageNum + 1);
     }
 
+    if (oldPageNum === 0) {
+      // Move to next volume/chapter automatically
+      this.loadPrevChapter();
+      return;
+    }
+
     if (oldPageNum === this.pageNum) { return; }
+
     this.loadPage();
   }
 
@@ -579,7 +776,12 @@ export class BookReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     } else {
       this.setPageNum(this.pageNum - 1);
     }
-    
+
+    if (this.pageNum >= this.maxPages - 1) {
+      // Move to next volume/chapter automatically
+      this.loadNextChapter();
+    }
+
     if (oldPageNum === this.pageNum) { return; }
 
     this.loadPage();
diff --git a/UI/Web/src/app/book-reader/book.service.ts b/UI/Web/src/app/book-reader/book.service.ts
index d3d650600..bef4ce73d 100644
--- a/UI/Web/src/app/book-reader/book.service.ts
+++ b/UI/Web/src/app/book-reader/book.service.ts
@@ -2,6 +2,7 @@ import { HttpClient } from '@angular/common/http';
 import { Injectable } from '@angular/core';
 import { environment } from 'src/environments/environment';
 import { BookChapterItem } from './_models/book-chapter-item';
+import { BookInfo } from './_models/book-info';
 
 export interface BookPage {
   bookTitle: string;
@@ -32,7 +33,7 @@ export class BookService {
   }
 
   getBookInfo(chapterId: number) {
-    return this.http.get(this.baseUrl + 'book/' + chapterId + '/book-info', {responseType: 'text' as 'json'});
+    return this.http.get(this.baseUrl + 'book/' + chapterId + '/book-info');
   }
 
   getBookPageUrl(chapterId: number, page: number) {
diff --git a/UI/Web/src/app/cards/_modals/card-details-modal/card-details-modal.component.html b/UI/Web/src/app/cards/_modals/card-details-modal/card-details-modal.component.html
index 4542f7938..d18987f6b 100644
--- a/UI/Web/src/app/cards/_modals/card-details-modal/card-details-modal.component.html
+++ b/UI/Web/src/app/cards/_modals/card-details-modal/card-details-modal.component.html
@@ -37,8 +37,8 @@
                     
        
                         
                             
-                                
-                             Chapter {{formatChapterNumber(chapter)}}
+                                 
+                            Chapter {{formatChapterNumber(chapter)}}
                             
                                 {{chapter.pagesRead}} / {{chapter.pages}}
                                 UNREAD
diff --git a/UI/Web/src/app/cards/_modals/edit-collection-tags/edit-collection-tags.component.html b/UI/Web/src/app/cards/_modals/edit-collection-tags/edit-collection-tags.component.html
index 168c9cf5d..2f7caacaf 100644
--- a/UI/Web/src/app/cards/_modals/edit-collection-tags/edit-collection-tags.component.html
+++ b/UI/Web/src/app/cards/_modals/edit-collection-tags/edit-collection-tags.component.html
@@ -11,7 +11,7 @@
         Promotion means that the tag can be seen server-wide, not just for admin users. All series that have this tag will still have user-access restrictions placed on them.
     
        
 
-        
          
+        
            
             
          • 
             {{tabs[0]}}
             
diff --git a/UI/Web/src/app/cards/_modals/edit-series-modal/edit-series-modal.component.html b/UI/Web/src/app/cards/_modals/edit-series-modal/edit-series-modal.component.html
index b968228b3..c354ac22d 100644
--- a/UI/Web/src/app/cards/_modals/edit-series-modal/edit-series-modal.component.html
+++ b/UI/Web/src/app/cards/_modals/edit-series-modal/edit-series-modal.component.html
@@ -6,13 +6,13 @@
             
         
     
        
-    
        
-        
        
-            
          
+    
          
+        
+            
            
                 
          • 
                   {{tabs[0]}}
                   
-
+                    
                     
            
                         
            
                             
@@ -77,6 +77,7 @@
                             
                         
            
                     
            
+                    
 
                               
                 
            • 
@@ -117,7 +118,6 @@
                                       
          
                                       
          
                                           
          
-                                              
                                               
@@ -152,9 +152,8 @@
                   
                 
             
        
-        
         
-        
        
+            
        
     
        
     
        
         
diff --git a/UI/Web/src/app/cards/_modals/edit-series-modal/edit-series-modal.component.ts b/UI/Web/src/app/cards/_modals/edit-series-modal/edit-series-modal.component.ts
index 4f2103e67..dd3be4ead 100644
--- a/UI/Web/src/app/cards/_modals/edit-series-modal/edit-series-modal.component.ts
+++ b/UI/Web/src/app/cards/_modals/edit-series-modal/edit-series-modal.component.ts
@@ -3,7 +3,7 @@ import { FormBuilder, FormControl, FormGroup } from '@angular/forms';
 import { NgbActiveModal } from '@ng-bootstrap/ng-bootstrap';
 import { forkJoin, Subject } from 'rxjs';
 import { takeUntil } from 'rxjs/operators';
-import { UtilityService } from 'src/app/shared/_services/utility.service';
+import { Breakpoint, UtilityService } from 'src/app/shared/_services/utility.service';
 import { TypeaheadSettings } from 'src/app/typeahead/typeahead-settings';
 import { Chapter } from 'src/app/_models/chapter';
 import { CollectionTag } from 'src/app/_models/collection-tag';
@@ -43,6 +43,10 @@ export class EditSeriesModalComponent implements OnInit, OnDestroy {
    */
   selectedCover: string = '';
 
+  get Breakpoint(): typeof Breakpoint {
+    return Breakpoint;
+  }
+
   constructor(public modal: NgbActiveModal,
               private seriesService: SeriesService,
               public utilityService: UtilityService,
@@ -83,6 +87,7 @@ export class EditSeriesModalComponent implements OnInit, OnDestroy {
       if (metadata) {
         this.metadata = metadata;
         this.settings.savedData = metadata.tags;
+        this.tags = metadata.tags;
       }
     });
 
@@ -147,6 +152,7 @@ export class EditSeriesModalComponent implements OnInit, OnDestroy {
       this.seriesService.updateMetadata(this.metadata, this.tags)
     ];
 
+
     if (selectedIndex > 0) {
       apis.push(this.uploadService.updateSeriesCoverImage(model.id, this.selectedCover));
     }
diff --git a/UI/Web/src/app/cards/bulk-operations/bulk-operations.component.html b/UI/Web/src/app/cards/bulk-operations/bulk-operations.component.html
new file mode 100644
index 000000000..2d328bfb3
--- /dev/null
+++ b/UI/Web/src/app/cards/bulk-operations/bulk-operations.component.html
@@ -0,0 +1,8 @@
+
        
+    
        
+         {{bulkSelectionService.totalSelections()}} selected
+        
+        Bulk Actions
+        
+    
        
+
        
\ No newline at end of file
diff --git a/UI/Web/src/app/cards/bulk-operations/bulk-operations.component.scss b/UI/Web/src/app/cards/bulk-operations/bulk-operations.component.scss
new file mode 100644
index 000000000..b385680ee
--- /dev/null
+++ b/UI/Web/src/app/cards/bulk-operations/bulk-operations.component.scss
@@ -0,0 +1,16 @@
+@import "../../../theme/colors";
+@import "../../../assets/themes/dark.scss";
+
+.bulk-select {
+    background-color: $dark-form-background-no-opacity;
+    border-bottom: 2px solid $primary-color;
+    color: white;
+}
+
+.btn-icon {
+    color: white;
+}
+
+.highlight {
+    color: $primary-color !important;
+}
\ No newline at end of file
diff --git a/UI/Web/src/app/cards/bulk-operations/bulk-operations.component.ts b/UI/Web/src/app/cards/bulk-operations/bulk-operations.component.ts
new file mode 100644
index 000000000..6f5590339
--- /dev/null
+++ b/UI/Web/src/app/cards/bulk-operations/bulk-operations.component.ts
@@ -0,0 +1,39 @@
+import { Component, Input, OnInit } from '@angular/core';
+import { Action, ActionItem } from 'src/app/_services/action-factory.service';
+import { BulkSelectionService } from '../bulk-selection.service';
+
+@Component({
+  selector: 'app-bulk-operations',
+  templateUrl: './bulk-operations.component.html',
+  styleUrls: ['./bulk-operations.component.scss']
+})
+export class BulkOperationsComponent implements OnInit {
+
+  @Input() actionCallback!: (action: Action, data: any) => void;
+  topOffset: number = 0;
+
+  get actions() {
+    return this.bulkSelectionService.getActions(this.actionCallback.bind(this));
+  }
+
+  constructor(public bulkSelectionService: BulkSelectionService) { }
+
+  ngOnInit(): void {
+    const navBar = document.querySelector('.navbar');
+    if (navBar) {
+      this.topOffset = Math.ceil(navBar.getBoundingClientRect().height);
+    }
+  }
+
+  handleActionCallback(action: Action, data: any) {
+    this.actionCallback(action, data);
+  }
+
+  performAction(action: ActionItem) {
+    if (typeof action.callback === 'function') {
+      action.callback(action.action, null);
+    }
+  }
+
+
+}
diff --git a/UI/Web/src/app/cards/bulk-selection.service.ts b/UI/Web/src/app/cards/bulk-selection.service.ts
new file mode 100644
index 000000000..47072c014
--- /dev/null
+++ b/UI/Web/src/app/cards/bulk-selection.service.ts
@@ -0,0 +1,147 @@
+import { Injectable } from '@angular/core';
+import { NavigationStart, Router } from '@angular/router';
+import { filter } from 'rxjs/operators';
+import { Action, ActionFactoryService } from '../_services/action-factory.service';
+
+type DataSource = 'volume' | 'chapter' | 'special' | 'series';
+
+/**
+ * Responsible for handling selections on cards. Can handle multiple card sources next to each other in different loops.
+ * This will clear selections between pages.
+ * 
+ * Remakrs: Page which renders cards is responsible for listening for shift keydown/keyup and updating our state variable.
+ */
+@Injectable({
+  providedIn: 'root'
+})
+export class BulkSelectionService {
+
+  private debug: boolean = false;
+  private prevIndex: number = 0;
+  private prevDataSource!: DataSource;
+  private selectedCards: { [key: string]: {[key: number]: boolean} } = {};
+  private dataSourceMax: { [key: string]: number} = {};
+  public isShiftDown: boolean = false;
+
+  constructor(private router: Router, private actionFactory: ActionFactoryService) {
+    router.events
+      .pipe(filter(event => event instanceof NavigationStart))
+      .subscribe((event) => {
+        this.deselectAll();
+        this.dataSourceMax = {};
+        this.prevIndex = 0;
+      });
+  }
+
+  handleCardSelection(dataSource: DataSource, index: number, maxIndex: number, wasSelected: boolean) {
+    if (this.isShiftDown) {
+
+      if (dataSource === this.prevDataSource) {
+        this.debugLog('Selecting ' + dataSource + ' cards from ' + this.prevIndex + ' to ' + index);
+        this.selectCards(dataSource, this.prevIndex, index, !wasSelected);  
+      } else {
+        const isForwardSelection = index < this.prevIndex;
+
+        if (isForwardSelection) {
+          this.debugLog('Selecting ' + this.prevDataSource + ' cards from ' + this.prevIndex + ' to ' + this.dataSourceMax[this.prevDataSource]);
+          this.selectCards(this.prevDataSource, this.prevIndex, this.dataSourceMax[this.prevDataSource], !wasSelected);  
+          this.debugLog('Selecting ' + dataSource + ' cards from ' + 0 + ' to ' + index);
+          this.selectCards(dataSource, 0, index, !wasSelected);
+        } else {
+          this.debugLog('Selecting ' + this.prevDataSource + ' cards from ' + 0 + ' to ' + this.prevIndex);
+          this.selectCards(this.prevDataSource, this.prevIndex, 0, !wasSelected);  
+          this.debugLog('Selecting ' + dataSource + ' cards from ' + index + ' to ' + maxIndex);
+          this.selectCards(dataSource, index, maxIndex, !wasSelected);
+        }
+      }
+    } else {
+      this.debugLog('Selecting ' + dataSource + ' cards at ' + index);
+      this.selectCards(dataSource, index, index, !wasSelected);
+    }
+    this.prevIndex = index;
+    this.prevDataSource = dataSource;
+    this.dataSourceMax[dataSource] = maxIndex;
+  }
+
+  isCardSelected(dataSource: DataSource, index: number) {
+    if (this.selectedCards.hasOwnProperty(dataSource) && this.selectedCards[dataSource].hasOwnProperty(index)) {
+      return this.selectedCards[dataSource][index];
+    }
+    return false;
+  }
+
+  selectCards(dataSource: DataSource, from: number, to: number, value: boolean) {
+    if (!this.selectedCards.hasOwnProperty(dataSource)) {
+      this.selectedCards[dataSource] = {};
+    }
+
+    if (from === to) {
+      this.selectedCards[dataSource][to] = value;
+      return;
+    }
+
+    if (from > to) {
+      for (let i = to; i <= from; i++) {
+        this.selectedCards[dataSource][i] = value;
+      }
+    }
+
+    for (let i = from; i <= to; i++) {
+      this.selectedCards[dataSource][i] = value;
+    }
+  }
+
+  deselectAll() {
+    this.selectedCards = {};
+  }
+
+  hasSelections() {
+    const keys = Object.keys(this.selectedCards);
+    return keys.filter(key => {
+      return Object.values(this.selectedCards[key]).filter(item => item).length > 0;
+    }).length > 0;
+  }
+
+  totalSelections() {
+    let sum = 0;
+    const keys = Object.keys(this.selectedCards);
+    keys.forEach(key => {
+      sum += Object.values(this.selectedCards[key]).filter(item => item).length;
+    });
+    return sum;
+  }
+
+  getSelectedCardsForSource(dataSource: DataSource) {
+    if (!this.selectedCards.hasOwnProperty(dataSource)) return [];
+
+    let ret = [];
+    for(let k in this.selectedCards[dataSource]) {
+      if (this.selectedCards[dataSource][k]) {
+        ret.push(k);
+      }
+    }
+    
+    return ret;
+  }
+
+  getActions(callback: (action: Action, data: any) => void) {
+    // checks if series is present. If so, returns only series actions
+    // else returns volume/chapter items
+    const allowedActions = [Action.AddToReadingList, Action.MarkAsRead, Action.MarkAsUnread];
+    if (Object.keys(this.selectedCards).filter(item => item === 'series').length > 0) {
+      return this.actionFactory.getSeriesActions(callback).filter(item => allowedActions.includes(item.action));
+    }
+
+    return this.actionFactory.getVolumeActions(callback).filter(item => allowedActions.includes(item.action));
+  }
+
+  private debugLog(message: string, extraData?: any) {
+    if (!this.debug) return;
+
+    if (extraData !== undefined) {
+      console.log(message, extraData);  
+    } else {
+      console.log(message);
+    }
+  }
+}
diff --git a/UI/Web/src/app/cards/card-detail-layout/card-detail-layout.component.html b/UI/Web/src/app/cards/card-detail-layout/card-detail-layout.component.html
index d005bab63..7f85064e3 100644
--- a/UI/Web/src/app/cards/card-detail-layout/card-detail-layout.component.html
+++ b/UI/Web/src/app/cards/card-detail-layout/card-detail-layout.component.html
@@ -3,8 +3,8 @@
         
        
             
        
                 
-                    
-                 {{header}} 
+                     
+                {{header}} 
                 
                 {{pagination.totalItems}}
             
        
diff --git a/UI/Web/src/app/cards/card-item/card-actionables/card-actionables.component.ts b/UI/Web/src/app/cards/card-item/card-actionables/card-actionables.component.ts
index b7441e62c..fc3138cbf 100644
--- a/UI/Web/src/app/cards/card-item/card-actionables/card-actionables.component.ts
+++ b/UI/Web/src/app/cards/card-item/card-actionables/card-actionables.component.ts
@@ -39,7 +39,4 @@ export class CardActionablesComponent implements OnInit {
     }
   }
 
-  // TODO: Insert hr to separate admin actions
-
-
 }
diff --git a/UI/Web/src/app/cards/card-item/card-item.component.html b/UI/Web/src/app/cards/card-item/card-item.component.html
index 478764aaf..c4fac279a 100644
--- a/UI/Web/src/app/cards/card-item/card-item.component.html
+++ b/UI/Web/src/app/cards/card-item/card-item.component.html
@@ -1,5 +1,5 @@
 
        
-    
        
+    
        
       
       
       
        
       
        
-        Cannot Read Archive
+        Cannot Read
       
        
-
-      
       
       
        
+      
        
+        
+      
        
     
        
+
     
        
       
        
-        
+        
           
             
+            (promoted)
           
           {{utilityService.mangaFormat(format)}}
            {{title}}
-          (promoted)
         
         
           
diff --git a/UI/Web/src/app/cards/card-item/card-item.component.scss b/UI/Web/src/app/cards/card-item/card-item.component.scss
index e1b5ceecc..0aa5c8ef6 100644
--- a/UI/Web/src/app/cards/card-item/card-item.component.scss
+++ b/UI/Web/src/app/cards/card-item/card-item.component.scss
@@ -38,6 +38,8 @@ $image-width: 160px;
     margin-bottom: 0px;
 }
 
+
+
 .img-top {
     height: $image-height;
 }
@@ -71,12 +73,38 @@ $image-width: 160px;
     border-color: transparent $primary-color transparent transparent;
 }
 
+
+.bulk-mode {
+    position: absolute;
+    top: 5px;
+    left: 5px;
+    visibility: hidden;
+
+    &.always-show {
+        visibility: visible !important;
+        width: $image-width;
+        height: $image-height;
+    }
+
+    input[type="checkbox"] {
+        width: 20px;
+        height: 20px;
+    }
+}
+
+
 .overlay {
     height: $image-height;
+
+    
     
     &:hover {
         visibility: visible;
 
+        .bulk-mode {
+            visibility: visible;
+        }
+
         .overlay-item {
             visibility: visible;
         }
diff --git a/UI/Web/src/app/cards/card-item/card-item.component.ts b/UI/Web/src/app/cards/card-item/card-item.component.ts
index 826c068d8..740cf6043 100644
--- a/UI/Web/src/app/cards/card-item/card-item.component.ts
+++ b/UI/Web/src/app/cards/card-item/card-item.component.ts
@@ -1,4 +1,4 @@
-import { Component, EventEmitter, Input, OnDestroy, OnInit, Output } from '@angular/core';
+import { Component, EventEmitter, HostListener, Input, OnDestroy, OnInit, Output } from '@angular/core';
 import { ToastrService } from 'ngx-toastr';
 import { Observable, Subject } from 'rxjs';
 import { finalize, take, takeUntil, takeWhile } from 'rxjs/operators';
@@ -13,6 +13,7 @@ import { Volume } from 'src/app/_models/volume';
 import { Action, ActionItem } from 'src/app/_services/action-factory.service';
 import { ImageService } from 'src/app/_services/image.service';
 import { LibraryService } from 'src/app/_services/library.service';
+import { BulkSelectionService } from '../bulk-selection.service';
 
 @Component({
   selector: 'app-card-item',
@@ -21,23 +22,71 @@ import { LibraryService } from 'src/app/_services/library.service';
 })
 export class CardItemComponent implements OnInit, OnDestroy {
 
+  /**
+   * Card item url. Will internally handle error and missing covers
+   */
   @Input() imageUrl = '';
+  /**
+   * Name of the card
+   */
   @Input() title = '';
+  /**
+   * Any actions to perform on the card
+   */
   @Input() actions: ActionItem[] = [];
-  @Input() read = 0; // Pages read
-  @Input() total = 0; // Total Pages
+  /**
+   * Pages Read
+   */
+  @Input() read = 0; 
+  /**
+   * Total Pages
+   */
+  @Input() total = 0; 
+  /**
+   * Supress library link
+   */
   @Input() supressLibraryLink = false;
-  @Input() entity!: Series | Volume | Chapter | CollectionTag; // This is the entity we are representing. It will be returned if an action is executed.
+  /**
+   * This is the entity we are representing. It will be returned if an action is executed.
+   */
+  @Input() entity!: Series | Volume | Chapter | CollectionTag;
+  /**
+   * If the entity is selected or not. 
+   */
+  @Input() selected: boolean = false;
+  /**
+   * If the entity should show selection code
+   */
+  @Input() allowSelection: boolean = false;
+  /**
+   * Event emitted when item is clicked
+   */
   @Output() clicked = new EventEmitter();
-
-  libraryName: string | undefined = undefined; // Library name item belongs to
+  /**
+   * When the card is selected.
+   */
+  @Output() selection = new EventEmitter();
+  /**
+   * Library name item belongs to
+   */
+  libraryName: string | undefined = undefined; 
   libraryId: number | undefined = undefined; 
-  supressArchiveWarning: boolean = false; // This will supress the cannot read archive warning when total pages is 0
+  /**
+   * This will supress the cannot read archive warning when total pages is 0
+   */
+  supressArchiveWarning: boolean = false;
+  /**
+   * Format of the entity (only applies to Series)
+   */
   format: MangaFormat = MangaFormat.UNKNOWN;
+  
 
   download$: Observable | null = null;
   downloadInProgress: boolean = false;
 
+  isShiftDown: boolean = false;
+  
+
   get MangaFormat(): typeof MangaFormat {
     return MangaFormat;
   }
@@ -46,7 +95,7 @@ export class CardItemComponent implements OnInit, OnDestroy {
 
   constructor(public imageService: ImageService, private libraryService: LibraryService, 
     public utilityService: UtilityService, private downloadService: DownloadService,
-    private toastr: ToastrService) {}
+    private toastr: ToastrService, public bulkSelectionService: BulkSelectionService) {}
 
   ngOnInit(): void {
     if (this.entity.hasOwnProperty('promoted') && this.entity.hasOwnProperty('title')) {
@@ -69,7 +118,25 @@ export class CardItemComponent implements OnInit, OnDestroy {
     this.onDestroy.complete();
   }
 
-  handleClick() {
+
+  prevTouchTime: number = 0;
+  @HostListener('touchstart', ['$event'])
+  onTouchStart(event: TouchEvent) {
+    this.prevTouchTime = event.timeStamp;
+  }
+
+  @HostListener('touchend', ['$event'])
+  onTouchEnd(event: TouchEvent) {
+    if (event.timeStamp - this.prevTouchTime >= 200) {
+      this.handleSelection();
+      event.stopPropagation();
+      event.preventDefault();
+    }
+    this.prevTouchTime = 0;
+  }
+
+
+  handleClick(event?: any) {
     this.clicked.emit(this.title);
   }
 
@@ -148,4 +215,12 @@ export class CardItemComponent implements OnInit, OnDestroy {
     const tag = this.entity as CollectionTag;
     return tag.hasOwnProperty('promoted') && tag.promoted;
   }
+
+
+  handleSelection(event?: any) {
+    if (event) {
+      event.stopPropagation();
+    }
+    this.selection.emit(this.selected);
+  }
 }
diff --git a/UI/Web/src/app/cards/cards.module.ts b/UI/Web/src/app/cards/cards.module.ts
index c9d427307..7c7db5c54 100644
--- a/UI/Web/src/app/cards/cards.module.ts
+++ b/UI/Web/src/app/cards/cards.module.ts
@@ -19,6 +19,7 @@ import { TypeaheadModule } from '../typeahead/typeahead.module';
 import { BrowserModule } from '@angular/platform-browser';
 import { CardDetailLayoutComponent } from './card-detail-layout/card-detail-layout.component';
 import { CardDetailsModalComponent } from './_modals/card-details-modal/card-details-modal.component';
+import { BulkOperationsComponent } from './bulk-operations/bulk-operations.component';
 
 
 
@@ -34,7 +35,8 @@ import { CardDetailsModalComponent } from './_modals/card-details-modal/card-det
     BookmarksModalComponent,
     CardActionablesComponent,
     CardDetailLayoutComponent,
-    CardDetailsModalComponent
+    CardDetailsModalComponent,
+    BulkOperationsComponent
   ],
   imports: [
     CommonModule,
@@ -70,7 +72,8 @@ import { CardDetailsModalComponent } from './_modals/card-details-modal/card-det
     BookmarksModalComponent,
     CardActionablesComponent,
     CardDetailLayoutComponent,
-    CardDetailsModalComponent
+    CardDetailsModalComponent,
+    BulkOperationsComponent
   ]
 })
 export class CardsModule { }
diff --git a/UI/Web/src/app/cards/series-card/series-card.component.html b/UI/Web/src/app/cards/series-card/series-card.component.html
index 18190842f..8653e3f9d 100644
--- a/UI/Web/src/app/cards/series-card/series-card.component.html
+++ b/UI/Web/src/app/cards/series-card/series-card.component.html
@@ -1,3 +1,6 @@
 
-    
+    
 
\ No newline at end of file
diff --git a/UI/Web/src/app/cards/series-card/series-card.component.ts b/UI/Web/src/app/cards/series-card/series-card.component.ts
index 42c1ccfde..57c2af992 100644
--- a/UI/Web/src/app/cards/series-card/series-card.component.ts
+++ b/UI/Web/src/app/cards/series-card/series-card.component.ts
@@ -21,9 +21,22 @@ export class SeriesCardComponent implements OnInit, OnChanges {
   @Input() data!: Series;
   @Input() libraryId = 0;
   @Input() suppressLibraryLink = false;
+  /**
+   * If the entity is selected or not. 
+   */
+   @Input() selected: boolean = false;
+   /**
+    * If the entity should show selection code
+    */
+   @Input() allowSelection: boolean = false;
+
   @Output() clicked = new EventEmitter();
   @Output() reload = new EventEmitter();
   @Output() dataChanged = new EventEmitter();
+  /**
+   * When the card is selected.
+   */
+   @Output() selection = new EventEmitter();
 
   isAdmin = false;
   actions: ActionItem[] = [];
@@ -78,6 +91,9 @@ export class SeriesCardComponent implements OnInit, OnChanges {
       case(Action.Bookmarks):
         this.actionService.openBookmarkModal(series, (series) => {/* No Operation */ });
         break;
+      case(Action.AddToReadingList):
+        this.actionService.addSeriesToReadingList(series, (series) => {/* No Operation */ });
+        break;
       default:
         break;
     }
@@ -91,7 +107,6 @@ export class SeriesCardComponent implements OnInit, OnChanges {
       if (closeResult.success) {
         if (closeResult.coverImageUpdate) {
           this.imageUrl = this.imageService.randomize(this.imageService.getSeriesCoverImage(closeResult.series.id));
-          console.log('image url: ', this.imageUrl);
         }
         this.seriesService.getSeries(data.id).subscribe(series => {
           this.data = series;
diff --git a/UI/Web/src/app/collections/all-collections/all-collections.component.html b/UI/Web/src/app/collections/all-collections/all-collections.component.html
index 38b7195f3..8cde25096 100644
--- a/UI/Web/src/app/collections/all-collections/all-collections.component.html
+++ b/UI/Web/src/app/collections/all-collections/all-collections.component.html
@@ -1,23 +1,8 @@
-
-    
         
             
         
-    
-
-
-    
-        
-            
-        
-    
-
\ No newline at end of file
+
\ No newline at end of file
diff --git a/UI/Web/src/app/collections/all-collections/all-collections.component.ts b/UI/Web/src/app/collections/all-collections/all-collections.component.ts
index d696b04bc..223894632 100644
--- a/UI/Web/src/app/collections/all-collections/all-collections.component.ts
+++ b/UI/Web/src/app/collections/all-collections/all-collections.component.ts
@@ -1,21 +1,14 @@
 import { Component, OnInit } from '@angular/core';
 import { Title } from '@angular/platform-browser';
-import { ActivatedRoute, Router } from '@angular/router';
+import { Router } from '@angular/router';
 import { NgbModal } from '@ng-bootstrap/ng-bootstrap';
-import { ToastrService } from 'ngx-toastr';
 import { EditCollectionTagsComponent } from 'src/app/cards/_modals/edit-collection-tags/edit-collection-tags.component';
 import { CollectionTag } from 'src/app/_models/collection-tag';
-import { Pagination } from 'src/app/_models/pagination';
-import { Series } from 'src/app/_models/series';
 import { ActionItem, ActionFactoryService, Action } from 'src/app/_services/action-factory.service';
 import { CollectionTagService } from 'src/app/_services/collection-tag.service';
 import { ImageService } from 'src/app/_services/image.service';
-import { SeriesService } from 'src/app/_services/series.service';
 
 
-/**
- * This component is used as a standard layout for any card detail. ie) series, in-progress, collections, etc.
- */
 @Component({
   selector: 'app-all-collections',
   templateUrl: './all-collections.component.html',
@@ -25,32 +18,13 @@ export class AllCollectionsComponent implements OnInit {
 
   isLoading: boolean = true;
   collections: CollectionTag[] = [];
-  collectionTagId: number = 0; // 0 is not a valid id, if 0, we will load all tags
-  collectionTagName: string = '';
-  series: Array = [];
-  seriesPagination!: Pagination;
   collectionTagActions: ActionItem[] = [];
 
-  constructor(private collectionService: CollectionTagService, private router: Router, private route: ActivatedRoute, 
-    private seriesService: SeriesService, private toastr: ToastrService, private actionFactoryService: ActionFactoryService, 
-    private modalService: NgbModal, private titleService: Title, private imageService: ImageService) {
+  constructor(private collectionService: CollectionTagService, private router: Router,
+    private actionFactoryService: ActionFactoryService, private modalService: NgbModal, 
+    private titleService: Title, private imageService: ImageService) {
     this.router.routeReuseStrategy.shouldReuseRoute = () => false;
-
-    const routeId = this.route.snapshot.paramMap.get('id');
-    if (routeId != null) {
-      this.collectionTagId = parseInt(routeId, 10);
-      this.collectionService.allTags().subscribe(tags => {
-        this.collections = tags;
-        const matchingTags = this.collections.filter(t => t.id === this.collectionTagId);
-        if (matchingTags.length === 0) {
-          this.toastr.error('You don\'t have access to any libraries this tag belongs to or this tag is invalid');
-          this.router.navigate(['collections']);
-          return;
-        }
-        this.collectionTagName = tags.filter(item => item.id === this.collectionTagId)[0].title;
-        this.titleService.setTitle('Kavita - ' + this.collectionTagName + ' Collection');
-      });
-    }
+    this.titleService.setTitle('Kavita - Collections');
   }
 
   ngOnInit() {
@@ -60,38 +34,15 @@ export class AllCollectionsComponent implements OnInit {
 
 
   loadCollection(item: CollectionTag) {
-    this.collectionTagId = item.id;
-    this.collectionTagName = item.title;
-    this.router.navigate(['collections', this.collectionTagId]);
+    this.router.navigate(['collections', item.id]);
     this.loadPage();
   }
 
-  onPageChange(pagination: Pagination) {
-    this.router.navigate(['collections', this.collectionTagId], {replaceUrl: true, queryParamsHandling: 'merge', queryParams: {page: this.seriesPagination.currentPage} });
-  }
-
   loadPage() {
-    const page = this.route.snapshot.queryParamMap.get('page');
-    if (page != null) {
-      if (this.seriesPagination === undefined || this.seriesPagination === null) {
-        this.seriesPagination = {currentPage: 0, itemsPerPage: 30, totalItems: 0, totalPages: 1};
-      }
-      this.seriesPagination.currentPage = parseInt(page, 10);
-    }
-    // Reload page after a series is updated or first load
-    if (this.collectionTagId === 0) {
-      this.collectionService.allTags().subscribe(tags => {
-        this.collections = tags;
-        this.isLoading = false;
-      });
-    } else {
-      this.seriesService.getSeriesForTag(this.collectionTagId, this.seriesPagination?.currentPage, this.seriesPagination?.itemsPerPage).subscribe(tags => {
-        this.series = tags.result;
-        this.seriesPagination = tags.pagination;
-        this.isLoading = false;
-        window.scrollTo(0, 0);
-      });
-    }
+    this.collectionService.allTags().subscribe(tags => {
+      this.collections = tags;
+      this.isLoading = false;
+    });
   }
 
   handleCollectionActionCallback(action: Action, collectionTag: CollectionTag) {
diff --git a/UI/Web/src/app/collections/collection-detail/collection-detail.component.html b/UI/Web/src/app/collections/collection-detail/collection-detail.component.html
index ff77357ef..431680257 100644
--- a/UI/Web/src/app/collections/collection-detail/collection-detail.component.html
+++ b/UI/Web/src/app/collections/collection-detail/collection-detail.component.html
@@ -11,14 +11,6 @@
                 
             
        
             
        
-                
                 
        
                     
        
     
        
     
        
+    
 
     
         
-            
+            
         
     
 
diff --git a/UI/Web/src/app/collections/collection-detail/collection-detail.component.ts b/UI/Web/src/app/collections/collection-detail/collection-detail.component.ts
index e7013f34e..5f3fa3145 100644
--- a/UI/Web/src/app/collections/collection-detail/collection-detail.component.ts
+++ b/UI/Web/src/app/collections/collection-detail/collection-detail.component.ts
@@ -1,19 +1,20 @@
-import { Component, OnInit } from '@angular/core';
+import { Component, HostListener, OnInit } from '@angular/core';
 import { Title } from '@angular/platform-browser';
 import { Router, ActivatedRoute } from '@angular/router';
 import { NgbModal } from '@ng-bootstrap/ng-bootstrap';
 import { ToastrService } from 'ngx-toastr';
 import { take } from 'rxjs/operators';
+import { BulkSelectionService } from 'src/app/cards/bulk-selection.service';
 import { UpdateFilterEvent } from 'src/app/cards/card-detail-layout/card-detail-layout.component';
 import { EditCollectionTagsComponent } from 'src/app/cards/_modals/edit-collection-tags/edit-collection-tags.component';
-import { UtilityService } from 'src/app/shared/_services/utility.service';
+import { KEY_CODES } from 'src/app/shared/_services/utility.service';
 import { CollectionTag } from 'src/app/_models/collection-tag';
-import { MangaFormat } from 'src/app/_models/manga-format';
 import { Pagination } from 'src/app/_models/pagination';
 import { Series } from 'src/app/_models/series';
 import { FilterItem, mangaFormatFilters, SeriesFilter } from 'src/app/_models/series-filter';
 import { AccountService } from 'src/app/_services/account.service';
 import { Action, ActionFactoryService, ActionItem } from 'src/app/_services/action-factory.service';
+import { ActionService } from 'src/app/_services/action.service';
 import { CollectionTagService } from 'src/app/_services/collection-tag.service';
 import { ImageService } from 'src/app/_services/image.service';
 import { SeriesService } from 'src/app/_services/series.service';
@@ -39,9 +40,35 @@ export class CollectionDetailComponent implements OnInit {
     mangaFormat: null
   };
 
+  bulkActionCallback = (action: Action, data: any) => {
+    const selectedSeriesIndexies = this.bulkSelectionService.getSelectedCardsForSource('series');
+    const selectedSeries = this.series.filter((series, index: number) => selectedSeriesIndexies.includes(index + ''));
+
+    switch (action) {
+      case Action.AddToReadingList:
+        this.actionService.addMultipleSeriesToReadingList(selectedSeries, () => {
+          this.bulkSelectionService.deselectAll();
+        });
+        break;
+      case Action.MarkAsRead:
+        this.actionService.markMultipleSeriesAsRead(selectedSeries, () => {
+          this.loadPage();
+          this.bulkSelectionService.deselectAll();
+        });
+        break;
+      case Action.MarkAsUnread:
+        this.actionService.markMultipleSeriesAsUnread(selectedSeries, () => {
+          this.loadPage();
+          this.bulkSelectionService.deselectAll();
+        });
+        break;
+    }
+  }
+
   constructor(public imageService: ImageService, private collectionService: CollectionTagService, private router: Router, private route: ActivatedRoute, 
     private seriesService: SeriesService, private toastr: ToastrService, private actionFactoryService: ActionFactoryService, 
-    private modalService: NgbModal, private titleService: Title, private accountService: AccountService, private utilityService: UtilityService) {
+    private modalService: NgbModal, private titleService: Title, private accountService: AccountService,
+    public bulkSelectionService: BulkSelectionService, private actionService: ActionService) {
       this.router.routeReuseStrategy.shouldReuseRoute = () => false;
 
       this.accountService.currentUser$.pipe(take(1)).subscribe(user => {
@@ -63,6 +90,20 @@ export class CollectionDetailComponent implements OnInit {
     this.collectionTagActions = this.actionFactoryService.getCollectionTagActions(this.handleCollectionActionCallback.bind(this));
   }
 
+  @HostListener('document:keydown.shift', ['$event'])
+  handleKeypress(event: KeyboardEvent) {
+    if (event.key === KEY_CODES.SHIFT) {
+      this.bulkSelectionService.isShiftDown = true;
+    }
+  }
+
+  @HostListener('document:keyup.shift', ['$event'])
+  handleKeyUp(event: KeyboardEvent) {
+    if (event.key === KEY_CODES.SHIFT) {
+      this.bulkSelectionService.isShiftDown = false;
+    }
+  }
+
   updateTag(tagId: number) {
     this.collectionService.allTags().subscribe(tags => {
       this.collections = tags;
diff --git a/UI/Web/src/app/collections/collections.module.ts b/UI/Web/src/app/collections/collections.module.ts
index eb0f8690e..0863647c8 100644
--- a/UI/Web/src/app/collections/collections.module.ts
+++ b/UI/Web/src/app/collections/collections.module.ts
@@ -18,6 +18,9 @@ import { AllCollectionsComponent } from './all-collections/all-collections.compo
     SharedModule,
     CardsModule,
     CollectionsRoutingModule,
+  ],
+  exports: [
+    AllCollectionsComponent
   ]
 })
 export class CollectionsModule { }
diff --git a/UI/Web/src/app/dashboard/dashboard.component.html b/UI/Web/src/app/dashboard/dashboard.component.html
new file mode 100644
index 000000000..73bda1d74
--- /dev/null
+++ b/UI/Web/src/app/dashboard/dashboard.component.html
@@ -0,0 +1,21 @@
+
        
+    
+    
        
+
        
\ No newline at end of file
diff --git a/UI/Web/src/app/dashboard/dashboard.component.scss b/UI/Web/src/app/dashboard/dashboard.component.scss
new file mode 100644
index 000000000..e69de29bb
diff --git a/UI/Web/src/app/dashboard/dashboard.component.ts b/UI/Web/src/app/dashboard/dashboard.component.ts
new file mode 100644
index 000000000..518ee208e
--- /dev/null
+++ b/UI/Web/src/app/dashboard/dashboard.component.ts
@@ -0,0 +1,37 @@
+import { Component, OnInit } from '@angular/core';
+import { Title } from '@angular/platform-browser';
+import { ActivatedRoute } from '@angular/router';
+import { ToastrService } from 'ngx-toastr';
+import { ServerService } from '../_services/server.service';
+
+@Component({
+  selector: 'app-dashboard',
+  templateUrl: './dashboard.component.html',
+  styleUrls: ['./dashboard.component.scss']
+})
+export class DashboardComponent implements OnInit {
+
+  tabs: Array<{title: string, fragment: string}> = [
+    {title: 'Libraries', fragment: ''},
+    {title: 'Lists', fragment: 'lists'},
+    {title: 'Collections', fragment: 'collections'},
+  ];
+  active = this.tabs[0];
+
+  constructor(public route: ActivatedRoute, private serverService: ServerService, 
+    private toastr: ToastrService, private titleService: Title) {
+    this.route.fragment.subscribe(frag => {
+      const tab = this.tabs.filter(item => item.fragment === frag);
+      if (tab.length > 0) {
+        this.active = tab[0];
+      } else {
+        this.active = this.tabs[0]; // Default to first tab
+      }
+    });
+    this.titleService.setTitle('Kavita - Dashboard');
+  }
+
+  ngOnInit(): void {
+  }
+
+}
diff --git a/UI/Web/src/app/library-detail/library-detail.component.html b/UI/Web/src/app/library-detail/library-detail.component.html
index 652e0c849..6d7885385 100644
--- a/UI/Web/src/app/library-detail/library-detail.component.html
+++ b/UI/Web/src/app/library-detail/library-detail.component.html
@@ -1,3 +1,4 @@
+
 
     
-        
+        
     
 
diff --git a/UI/Web/src/app/library-detail/library-detail.component.ts b/UI/Web/src/app/library-detail/library-detail.component.ts
index 01ad75c1f..fdd58fb33 100644
--- a/UI/Web/src/app/library-detail/library-detail.component.ts
+++ b/UI/Web/src/app/library-detail/library-detail.component.ts
@@ -1,8 +1,10 @@
-import { Component, OnInit } from '@angular/core';
+import { Component, HostListener, OnInit } from '@angular/core';
 import { Title } from '@angular/platform-browser';
 import { ActivatedRoute, Router } from '@angular/router';
 import { take } from 'rxjs/operators';
+import { BulkSelectionService } from '../cards/bulk-selection.service';
 import { UpdateFilterEvent } from '../cards/card-detail-layout/card-detail-layout.component';
+import { KEY_CODES } from '../shared/_services/utility.service';
 import { Library } from '../_models/library';
 import { Pagination } from '../_models/pagination';
 import { Series } from '../_models/series';
@@ -30,9 +32,35 @@ export class LibraryDetailComponent implements OnInit {
     mangaFormat: null
   };
 
+  bulkActionCallback = (action: Action, data: any) => {
+    const selectedSeriesIndexies = this.bulkSelectionService.getSelectedCardsForSource('series');
+    const selectedSeries = this.series.filter((series, index: number) => selectedSeriesIndexies.includes(index + ''));
+
+    switch (action) {
+      case Action.AddToReadingList:
+        this.actionService.addMultipleSeriesToReadingList(selectedSeries, () => {
+          this.bulkSelectionService.deselectAll();
+        });
+        break;
+      case Action.MarkAsRead:
+        this.actionService.markMultipleSeriesAsRead(selectedSeries, () => {
+          this.loadPage();
+          this.bulkSelectionService.deselectAll();
+        });
+        
+        break;
+      case Action.MarkAsUnread:
+        this.actionService.markMultipleSeriesAsUnread(selectedSeries, () => {
+          this.loadPage();
+          this.bulkSelectionService.deselectAll();
+        });
+        break;
+    }
+  }
+
   constructor(private route: ActivatedRoute, private router: Router, private seriesService: SeriesService, 
     private libraryService: LibraryService, private titleService: Title, private actionFactoryService: ActionFactoryService, 
-    private actionService: ActionService) {
+    private actionService: ActionService, public bulkSelectionService: BulkSelectionService) {
     const routeId = this.route.snapshot.paramMap.get('id');
     if (routeId === null) {
       this.router.navigateByUrl('/libraries');
@@ -53,6 +81,20 @@ export class LibraryDetailComponent implements OnInit {
     
   }
 
+  @HostListener('document:keydown.shift', ['$event'])
+  handleKeypress(event: KeyboardEvent) {
+    if (event.key === KEY_CODES.SHIFT) {
+      this.bulkSelectionService.isShiftDown = true;
+    }
+  }
+
+  @HostListener('document:keyup.shift', ['$event'])
+  handleKeyUp(event: KeyboardEvent) {
+    if (event.key === KEY_CODES.SHIFT) {
+      this.bulkSelectionService.isShiftDown = false;
+    }
+  }
+
   handleAction(action: Action, library: Library) {
     let lib: Partial = library;
     if (library === undefined) {
diff --git a/UI/Web/src/app/library/library.component.html b/UI/Web/src/app/library/library.component.html
index c80c3223f..d1522bb8a 100644
--- a/UI/Web/src/app/library/library.component.html
+++ b/UI/Web/src/app/library/library.component.html
@@ -1,33 +1,24 @@
+
        
+    
        There are no libraries setup yet. Configure some in Server settings.
        
+
        
+
        
+    
        You haven't been granted access to any libraries.
        
+
        
 
-
        
-    
        
-        
        There are no libraries setup yet. Configure some in Server settings.
        
-    
        
-    
        
-        
        You haven't been granted access to any libraries.
        
-    
        
-    
-        
-            
-        
-    
+
+    
+        
+    
+
 
-    
-        
-            
-        
-    
+
+    
+        
+    
+
 
-    
-        
-            
-        
-    
-
-    
-        
-            
-        
-    
-    
-
        
\ No newline at end of file
+
+    
+        
+    
+
diff --git a/UI/Web/src/app/library/library.component.ts b/UI/Web/src/app/library/library.component.ts
index f31e98445..bf862f730 100644
--- a/UI/Web/src/app/library/library.component.ts
+++ b/UI/Web/src/app/library/library.component.ts
@@ -5,7 +5,6 @@ import { NgbModal } from '@ng-bootstrap/ng-bootstrap';
 import { Subject } from 'rxjs';
 import { take, takeUntil } from 'rxjs/operators';
 import { EditCollectionTagsComponent } from '../cards/_modals/edit-collection-tags/edit-collection-tags.component';
-import { ScrollService } from '../scroll.service';
 import { CollectionTag } from '../_models/collection-tag';
 import { InProgressChapter } from '../_models/in-progress-chapter';
 import { Library } from '../_models/library';
@@ -33,8 +32,8 @@ export class LibraryComponent implements OnInit, OnDestroy {
   recentlyAdded: Series[] = [];
   inProgress: Series[] = [];
   continueReading: InProgressChapter[] = [];
-  collectionTags: CollectionTag[] = [];
-  collectionTagActions: ActionItem[] = [];
+  // collectionTags: CollectionTag[] = [];
+  // collectionTagActions: ActionItem[] = [];
 
   private readonly onDestroy = new Subject();
 
@@ -43,8 +42,7 @@ export class LibraryComponent implements OnInit, OnDestroy {
   constructor(public accountService: AccountService, private libraryService: LibraryService, 
     private seriesService: SeriesService, private actionFactoryService: ActionFactoryService, 
     private collectionService: CollectionTagService, private router: Router, 
-    private modalService: NgbModal, private titleService: Title, public imageService: ImageService, 
-    private scrollService: ScrollService) { }
+    private modalService: NgbModal, private titleService: Title, public imageService: ImageService) { }
 
   ngOnInit(): void {
     this.titleService.setTitle('Kavita - Dashboard');
@@ -58,7 +56,7 @@ export class LibraryComponent implements OnInit, OnDestroy {
       });
     });
 
-    this.collectionTagActions = this.actionFactoryService.getCollectionTagActions(this.handleCollectionActionCallback.bind(this));
+    //this.collectionTagActions = this.actionFactoryService.getCollectionTagActions(this.handleCollectionActionCallback.bind(this));
 
     this.reloadSeries();
   }
@@ -103,9 +101,9 @@ export class LibraryComponent implements OnInit, OnDestroy {
   }
 
   reloadTags() {
-    this.collectionService.allTags().pipe(takeUntil(this.onDestroy)).subscribe(tags => {
-      this.collectionTags = tags;
-    });
+    // this.collectionService.allTags().pipe(takeUntil(this.onDestroy)).subscribe(tags => {
+    //   this.collectionTags = tags;
+    // });
   }
 
   handleSectionClick(sectionTitle: string) {
@@ -119,24 +117,24 @@ export class LibraryComponent implements OnInit, OnDestroy {
   }
 
   loadCollection(item: CollectionTag) {
-    this.router.navigate(['collections', item.id]);
+    //this.router.navigate(['collections', item.id]);
   }
 
-  handleCollectionActionCallback(action: Action, collectionTag: CollectionTag) {
-    switch (action) {
-      case(Action.Edit):
-        const modalRef = this.modalService.open(EditCollectionTagsComponent, { size: 'lg', scrollable: true });
-        modalRef.componentInstance.tag = collectionTag;
-        modalRef.closed.subscribe((results: {success: boolean, coverImageUpdated: boolean}) => {
-          this.reloadTags();
-          if (results.coverImageUpdated) {
-            collectionTag.coverImage = this.imageService.randomize(collectionTag.coverImage);
-          }
-        });
-        break;
-      default:
-        break;
-    }
-  }
+  // handleCollectionActionCallback(action: Action, collectionTag: CollectionTag) {
+  //   switch (action) {
+  //     case(Action.Edit):
+  //       const modalRef = this.modalService.open(EditCollectionTagsComponent, { size: 'lg', scrollable: true });
+  //       modalRef.componentInstance.tag = collectionTag;
+  //       modalRef.closed.subscribe((results: {success: boolean, coverImageUpdated: boolean}) => {
+  //         this.reloadTags();
+  //         if (results.coverImageUpdated) {
+  //           collectionTag.coverImage = this.imageService.randomize(collectionTag.coverImage);
+  //         }
+  //       });
+  //       break;
+  //     default:
+  //       break;
+  //   }
+  // }
 
 }
diff --git a/UI/Web/src/app/manga-reader/_models/chapter-info.ts b/UI/Web/src/app/manga-reader/_models/chapter-info.ts
index fff07b12b..f83c86902 100644
--- a/UI/Web/src/app/manga-reader/_models/chapter-info.ts
+++ b/UI/Web/src/app/manga-reader/_models/chapter-info.ts
@@ -1,8 +1,13 @@
+import { MangaFormat } from "src/app/_models/manga-format";
+
 export interface ChapterInfo {
     chapterNumber: string;
     volumeNumber: string;
     chapterTitle: string;
     seriesName: string;
+    seriesFormat: MangaFormat;
+    seriesId: number;
+    libraryId: number;
     fileName: string;
     isSpecial: boolean;
     volumeId: number;
diff --git a/UI/Web/src/app/manga-reader/_models/reader-enums.ts b/UI/Web/src/app/manga-reader/_models/reader-enums.ts
index 0117ed5d2..9738edf9f 100644
--- a/UI/Web/src/app/manga-reader/_models/reader-enums.ts
+++ b/UI/Web/src/app/manga-reader/_models/reader-enums.ts
@@ -2,21 +2,21 @@ export enum FITTING_OPTION {
     HEIGHT = 'full-height',
     WIDTH = 'full-width',
     ORIGINAL = 'original'
-  }
+}
   
 export enum SPLIT_PAGE_PART {
     NO_SPLIT = 'none',
     LEFT_PART = 'left',
     RIGHT_PART = 'right'
-  }
+}
   
 export enum PAGING_DIRECTION {
     FORWARD = 1,
     BACKWARDS = -1,
-  }
+}
   
 export enum COLOR_FILTER {
     NONE = '',
     SEPIA = 'filter-sepia',
     DARK = 'filter-dark'
-  }
+}
diff --git a/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.html b/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.html
index 92be7cb04..c0d5ff542 100644
--- a/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.html
+++ b/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.html
@@ -1,15 +1,43 @@
 
-
        
+
        
     Captures Scroll Events: {{!this.isScrolling && this.allImagesLoaded}}
     Is Scrolling: {{isScrollingForwards() ? 'Forwards' : 'Backwards'}} {{this.isScrolling}}
     All Images Loaded: {{this.allImagesLoaded}}
     Prefetched {{minPageLoaded}}-{{maxPageLoaded}} 
-    Current Page:{{pageNum}}
-    Width: {{webtoonImageWidth}}
+    Pages: {{pageNum}} / {{totalPages}}
+    At Top: {{atTop}}
+    At Bottom: {{atBottom}}
+    Total Height: {{getTotalHeight()}}
+    Total Scroll: {{getTotalScroll()}}
+    Scroll Top: {{getScrollTop()}}
 
        
 
-
+
 
-    image
+    image
 
-
+
diff --git a/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.scss b/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.scss
index c7308aa33..4277b6760 100644
--- a/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.scss
+++ b/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.scss
@@ -4,4 +4,28 @@
 }
 .active {
     border: 2px solid red;
+}
+
+.spacer {
+    width: 100%;
+    height: 300px;
+    cursor: pointer;
+
+    .animate {
+        animation: move-up-down 1s linear infinite;
+    }
+
+    .text {
+        z-index: 101;
+        
+    }
+}
+
+@keyframes move-up-down {
+    0%, 100% {
+      transform: translateY(0);
+    }
+    50% {
+      transform: translateY(-10px);
+    }
 }
\ No newline at end of file
diff --git a/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.ts b/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.ts
index 5e6973ecd..d40eec83d 100644
--- a/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.ts
+++ b/UI/Web/src/app/manga-reader/infinite-scroller/infinite-scroller.component.ts
@@ -1,10 +1,40 @@
 import { Component, EventEmitter, Input, OnChanges, OnDestroy, OnInit, Output, Renderer2, SimpleChanges } from '@angular/core';
+import { ToastrService } from 'ngx-toastr';
 import { BehaviorSubject, fromEvent, ReplaySubject, Subject } from 'rxjs';
 import { debounceTime, takeUntil } from 'rxjs/operators';
 import { ReaderService } from '../../_services/reader.service';
 import { PAGING_DIRECTION } from '../_models/reader-enums';
 import { WebtoonImage } from '../_models/webtoon-image';
 
+/**
+ * How much additional space should pass, past the original bottom of the document height before we trigger the next chapter load
+ */
+const SPACER_SCROLL_INTO_PX = 200;
+
+/**
+ * Bitwise enums for configuring how much debug information we want
+ */
+const enum DEBUG_MODES {
+  /**
+   * No Debug information
+   */
+  None = 0,
+  /**
+   * Turn on debug logging
+   */
+  Logs = 2,
+  /**
+   * Turn on the action bar in UI
+   */
+  ActionBar = 4,
+  /**
+   * Turn on Page outline
+   */
+  Outline = 8
+
+
+}
+
 @Component({
   selector: 'app-infinite-scroller',
   templateUrl: './infinite-scroller.component.html',
@@ -29,6 +59,8 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
    */
   @Input() urlProvider!: (page: number) => string;
   @Output() pageNumberChange: EventEmitter = new EventEmitter();
+  @Output() loadNextChapter: EventEmitter = new EventEmitter();
+  @Output() loadPrevChapter: EventEmitter = new EventEmitter();
 
   @Input() goToPage: ReplaySubject = new ReplaySubject();
   
@@ -71,9 +103,21 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
    */
    imagesLoaded: {[key: number]: number} = {};
   /**
-   * Debug mode. Will show extra information
+   * If the user has scrolled all the way to the bottom. This is used solely for continuous reading
    */
-  debug: boolean = false;
+   atBottom: boolean = false;   
+   /**
+   * If the user has scrolled all the way to the top. This is used solely for continuous reading
+   */
+   atTop: boolean = false;
+   /**
+    * Keeps track of the previous scrolling height for restoring scroll position after we inject spacer block
+    */
+   previousScrollHeightMinusTop: number = 0;
+  /**
+   * Debug mode. Will show extra information. Use bitwise (|) operators between different modes to enable different output
+   */
+  debugMode: DEBUG_MODES = DEBUG_MODES.None;
 
   get minPageLoaded() {
     return Math.min(...Object.values(this.imagesLoaded));
@@ -85,9 +129,10 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
 
 
 
+
   private readonly onDestroy = new Subject();
 
-  constructor(private readerService: ReaderService, private renderer: Renderer2) { }
+  constructor(private readerService: ReaderService, private renderer: Renderer2, private toastr: ToastrService) {}
 
   ngOnChanges(changes: SimpleChanges): void {
     if (changes.hasOwnProperty('totalPages') && changes['totalPages'].previousValue != changes['totalPages'].currentValue) {
@@ -104,7 +149,7 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
 
   ngOnInit(): void {
     fromEvent(window, 'scroll')
-    .pipe(debounceTime(20), takeUntil(this.onDestroy))
+    .pipe(debounceTime(20), takeUntil(this.onDestroy)) 
     .subscribe((event) => this.handleScrollEvent(event));
 
     if (this.goToPage) {
@@ -145,6 +190,61 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
       this.scrollingDirection = PAGING_DIRECTION.BACKWARDS;
     }
     this.prevScrollPosition = verticalOffset;
+
+    // Check if we hit the last page
+    this.checkIfShouldTriggerContinuousReader();
+
+  }
+
+  getTotalHeight() {
+    let totalHeight = 0;
+    document.querySelectorAll('img[id^="page-"]').forEach(img => totalHeight += img.getBoundingClientRect().height);
+    return totalHeight;
+  }
+  getTotalScroll() {
+    return document.documentElement.offsetHeight + document.documentElement.scrollTop;
+  }
+  getScrollTop() {
+    return document.documentElement.scrollTop
+  }
+
+  checkIfShouldTriggerContinuousReader() {
+    if (this.isScrolling) return;
+
+    if (this.scrollingDirection === PAGING_DIRECTION.FORWARD) {
+      const totalHeight = this.getTotalHeight();
+      const totalScroll = this.getTotalScroll();
+
+      // If we were at top but have started scrolling down past page 0, remove top spacer
+      if (this.atTop && this.pageNum > 0) {
+        this.atTop = false;
+      }
+      // debug mode will add an extra pixel from the image border + (this.debug ? 1 : 0) 
+      if (totalScroll === totalHeight && !this.atBottom) {
+        this.atBottom = true;
+        this.setPageNum(this.totalPages);
+        // Scroll user back to original location
+        this.previousScrollHeightMinusTop = document.documentElement.scrollTop;
+        requestAnimationFrame(() => document.documentElement.scrollTop = this.previousScrollHeightMinusTop + (SPACER_SCROLL_INTO_PX / 2));
+      } else if (totalScroll >= totalHeight + SPACER_SCROLL_INTO_PX && this.atBottom) { 
+        // This if statement will fire once we scroll into the spacer at all
+        this.loadNextChapter.emit();
+      }
+    } else {
+      // < 5 because debug mode and FF (mobile) can report non 0, despite being at 0
+      if (this.getScrollTop() < 5 && this.pageNum === 0 && !this.atTop) {
+        this.atBottom = false;
+
+        this.atTop = true; 
+        // Scroll user back to original location
+        this.previousScrollHeightMinusTop = document.documentElement.scrollHeight - document.documentElement.scrollTop;
+        requestAnimationFrame(() => window.scrollTo(0, SPACER_SCROLL_INTO_PX));
+      } else if (this.getScrollTop() < 5 && this.pageNum === 0 && this.atTop) {
+        // If already at top, then we moving on
+        this.loadPrevChapter.emit();
+      }
+    }
+
   }
 
   /**
@@ -170,6 +270,8 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
   initWebtoonReader() {
     this.imagesLoaded = {};
     this.webtoonImages.next([]);
+    this.atBottom = false;
+    this.checkIfShouldTriggerContinuousReader();
 
     const [startingIndex, endingIndex] = this.calculatePrefetchIndecies();
 
@@ -236,6 +338,11 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
    * @param scrollToPage Optional (default false) parameter to trigger scrolling to the newly set page
    */
   setPageNum(pageNum: number, scrollToPage: boolean = false) {
+    if (pageNum > this.totalPages) {
+      pageNum = this.totalPages;
+    } else if (pageNum < 0) {
+      pageNum = 0;
+    }
     this.pageNum = pageNum;
     this.pageNumberChange.emit(this.pageNum);
 
@@ -341,7 +448,7 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
     if (startingIndex === 0 && endingIndex === 0) { return; }
 
     this.debugLog('\t[PREFETCH] prefetching pages: ' + startingIndex + ' to ' + endingIndex);
-    for(let i = startingIndex; i < endingIndex; i++) {
+    for(let i = startingIndex; i <= endingIndex; i++) {
       this.loadWebtoonImage(i);
     }
 
@@ -354,7 +461,7 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
   }
 
   debugLog(message: string, extraData?: any) {
-    if (!this.debug) { return; }
+    if (!(this.debugMode & DEBUG_MODES.Logs)) return;
 
     if (extraData !== undefined) {
       console.log(message, extraData);  
@@ -362,4 +469,12 @@ export class InfiniteScrollerComponent implements OnInit, OnChanges, OnDestroy {
       console.log(message);
     }
   }
+
+  showDebugBar() {
+    return this.debugMode & DEBUG_MODES.ActionBar;
+  }
+
+  showDebugOutline() {
+    return this.debugMode & DEBUG_MODES.Outline;
+  }
 }
diff --git a/UI/Web/src/app/manga-reader/manga-reader.component.html b/UI/Web/src/app/manga-reader/manga-reader.component.html
index 1dd55b6f3..0a96cadd0 100644
--- a/UI/Web/src/app/manga-reader/manga-reader.component.html
+++ b/UI/Web/src/app/manga-reader/manga-reader.component.html
@@ -7,7 +7,7 @@
             
             
             
        
-                
        {{title}}
        
+                
        {{title}} (Incognito Mode)
        
                 
        
                     {{subtitle}}
                 
        
@@ -28,29 +28,28 @@
                 ondragstart="return false;" onselectstart="return false;">
         
         
        
-            
+            
         
        
-         
+        
             
        
             
        
                 
-        
-            
        
-            
        
-            
        
-            
        
-                
     
        
     
     
        
-        
        
+        
        
             
             
        
                 
                 
-                
        
+                
        
                     
                 
        
+                
+                    
        
+                        
+                    
        
+                        
                 
                 
             
        
@@ -59,7 +58,7 @@
         
        
         
        
             
        
-                
diff --git a/UI/Web/src/app/manga-reader/manga-reader.component.scss b/UI/Web/src/app/manga-reader/manga-reader.component.scss
index c076922bc..5f3d2c334 100644
--- a/UI/Web/src/app/manga-reader/manga-reader.component.scss
+++ b/UI/Web/src/app/manga-reader/manga-reader.component.scss
@@ -92,20 +92,6 @@ canvas {
 }
 
 
-.center-menu {
-    position: fixed;
-    top: 10px;
-    left: $side-width;
-    width: $center-width;
-    border-bottom: $dash-width dashed $secondary-color;
-    text-align: center;
-    z-index: 2;
-    padding-bottom: 10px;
-    padding-left: 10px;
-    padding-right: 10px;
-}
-
-
 .right {
     position: fixed;
     right: 0px;
diff --git a/UI/Web/src/app/manga-reader/manga-reader.component.ts b/UI/Web/src/app/manga-reader/manga-reader.component.ts
index 8e6d8c9b3..9f34eb75b 100644
--- a/UI/Web/src/app/manga-reader/manga-reader.component.ts
+++ b/UI/Web/src/app/manga-reader/manga-reader.component.ts
@@ -22,6 +22,7 @@ import { ChapterInfo } from './_models/chapter-info';
 import { COLOR_FILTER, FITTING_OPTION, PAGING_DIRECTION, SPLIT_PAGE_PART } from './_models/reader-enums';
 import { Preferences, scalingOptions } from '../_models/preferences/preferences';
 import { READER_MODE } from '../_models/preferences/reader-mode';
+import { MangaFormat } from '../_models/manga-format';
 
 const PREFETCH_PAGES = 5;
 
@@ -65,7 +66,20 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
   seriesId!: number;
   volumeId!: number;
   chapterId!: number;
+  /**
+   * Reading List id. Defaults to -1.
+   */
+  readingListId: number = CHAPTER_ID_DOESNT_EXIST;
 
+  /**
+   * If this is true, no progress will be saved.
+   */
+  incognitoMode: boolean = false;
+
+  /**
+   * If this is true, chapters will be fetched in the order of a reading list, rather than natural series order. 
+   */
+  readingListMode: boolean = false;
   /**
    * The current page. UI will show this number + 1.
    */
@@ -259,6 +273,14 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     this.libraryId = parseInt(libraryId, 10);
     this.seriesId = parseInt(seriesId, 10);
     this.chapterId = parseInt(chapterId, 10);
+    this.incognitoMode = this.route.snapshot.queryParamMap.get('incognitoMode') === 'true';
+    
+    const readingListId = this.route.snapshot.queryParamMap.get('readingListId');
+    if (readingListId != null) {
+      this.readingListMode = true;
+      this.readingListId = parseInt(readingListId, 10);
+    }
+    
 
     this.continuousChaptersStack.push(this.chapterId);
 
@@ -325,11 +347,26 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
 
   @HostListener('window:keyup', ['$event'])
   handleKeyPress(event: KeyboardEvent) {
-    if (event.key === KEY_CODES.RIGHT_ARROW || event.key === KEY_CODES.DOWN_ARROW) {
-      this.readingDirection === ReadingDirection.LeftToRight ? this.nextPage() : this.prevPage();
-    } else if (event.key === KEY_CODES.LEFT_ARROW || event.key === KEY_CODES.UP_ARROW) {
-      this.readingDirection === ReadingDirection.LeftToRight ? this.prevPage() : this.nextPage();
-    } else if (event.key === KEY_CODES.ESC_KEY) {
+
+    switch (this.readerMode) {
+      case READER_MODE.MANGA_LR:
+        if (event.key === KEY_CODES.RIGHT_ARROW) {
+          this.readingDirection === ReadingDirection.LeftToRight ? this.nextPage() : this.prevPage();
+        } else if (event.key === KEY_CODES.LEFT_ARROW) {
+          this.readingDirection === ReadingDirection.LeftToRight ? this.prevPage() : this.nextPage();
+        }
+        break;
+      case READER_MODE.MANGA_UD:
+      case READER_MODE.WEBTOON:
+        if (event.key === KEY_CODES.DOWN_ARROW) {
+          this.nextPage()
+        } else if (event.key === KEY_CODES.UP_ARROW) {
+          this.prevPage()
+        }
+        break;
+    }
+
+    if (event.key === KEY_CODES.ESC_KEY) {
       if (this.menuOpen) {
         this.toggleMenu();
         event.stopPropagation();
@@ -343,6 +380,8 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
       const goToPageNum = this.promptForPage();
       if (goToPageNum === null) { return; }
       this.goToPage(parseInt(goToPageNum.trim(), 10));
+    } else if (event.key === KEY_CODES.B) {
+      this.bookmarkPage();
     }
   }
 
@@ -352,21 +391,30 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     this.nextChapterDisabled = false;
     this.prevChapterDisabled = false;
     this.nextChapterPrefetched = false;
-    this.pageNum = 1;
+    this.pageNum = 0;
 
     forkJoin({
       progress: this.readerService.getProgress(this.chapterId),
-      chapterInfo: this.readerService.getChapterInfo(this.seriesId, this.chapterId),
+      chapterInfo: this.readerService.getChapterInfo(this.chapterId),
       bookmarks: this.readerService.getBookmarks(this.chapterId)
     }).pipe(take(1)).subscribe(results => {
+
+      if (this.readingListMode && results.chapterInfo.seriesFormat === MangaFormat.EPUB) {
+        // Redirect to the book reader. 
+        const params = this.readerService.getQueryParamsObject(this.incognitoMode, this.readingListMode, this.readingListId);
+        this.router.navigate(['library', results.chapterInfo.libraryId, 'series', results.chapterInfo.seriesId, 'book', this.chapterId], {queryParams: params});
+        return;
+      }
+
       this.volumeId = results.chapterInfo.volumeId;
       this.maxPages = results.chapterInfo.pages;
-
       let page = results.progress.pageNum;
-      if (page >= this.maxPages) {
+      if (page > this.maxPages) {
         page = this.maxPages - 1;
       }
       this.setPageNum(page);
+      
+      
 
       // Due to change detection rules in Angular, we need to re-create the options object to apply the change
       const newOptions: Options = Object.assign({}, this.pageOptions);
@@ -381,20 +429,20 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
         this.bookmarks[bookmark.page] = 1;
       });
 
-      this.readerService.getNextChapter(this.seriesId, this.volumeId, this.chapterId).pipe(take(1)).subscribe(chapterId => {
+      this.readerService.getNextChapter(this.seriesId, this.volumeId, this.chapterId, this.readingListId).pipe(take(1)).subscribe(chapterId => {
         this.nextChapterId = chapterId;
         if (chapterId === CHAPTER_ID_DOESNT_EXIST || chapterId === this.chapterId) {
           this.nextChapterDisabled = true;
         }
       });
-      this.readerService.getPrevChapter(this.seriesId, this.volumeId, this.chapterId).pipe(take(1)).subscribe(chapterId => {
+      this.readerService.getPrevChapter(this.seriesId, this.volumeId, this.chapterId, this.readingListId).pipe(take(1)).subscribe(chapterId => {
         this.prevChapterId = chapterId;
         if (chapterId === CHAPTER_ID_DOESNT_EXIST || chapterId === this.chapterId) {
           this.prevChapterDisabled = true;
         }
       });
 
-      // ! Should I move the prefetching code if we start in webtoon reader mode? 
+
       const images = [];
       for (let i = 0; i < PREFETCH_PAGES + 2; i++) {
         images.push(new Image());
@@ -420,7 +468,11 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
   }
 
   closeReader() {
-    this.location.back();
+    if (this.readingListMode) {
+      this.router.navigateByUrl('lists/' + this.readingListId);
+    } else {
+      this.location.back();
+    }
   }
 
   updateTitle(chapterInfo: ChapterInfo) {
@@ -668,12 +720,12 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     if (this.nextPageDisabled) { return; }
     this.isLoading = true;
     if (this.nextChapterId === CHAPTER_ID_NOT_FETCHED || this.nextChapterId === this.chapterId) {
-      this.readerService.getNextChapter(this.seriesId, this.volumeId, this.chapterId).pipe(take(1)).subscribe(chapterId => {
+      this.readerService.getNextChapter(this.seriesId, this.volumeId, this.chapterId, this.readingListId).pipe(take(1)).subscribe(chapterId => {
         this.nextChapterId = chapterId;
-        this.loadChapter(chapterId, 'next');
+        this.loadChapter(chapterId, 'Next');
       });
     } else {
-      this.loadChapter(this.nextChapterId, 'next');
+      this.loadChapter(this.nextChapterId, 'Next');
     }
   }
 
@@ -691,29 +743,29 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     }
 
     if (this.prevChapterId === CHAPTER_ID_NOT_FETCHED || this.prevChapterId === this.chapterId) {
-      this.readerService.getPrevChapter(this.seriesId, this.volumeId, this.chapterId).pipe(take(1)).subscribe(chapterId => {
+      this.readerService.getPrevChapter(this.seriesId, this.volumeId, this.chapterId, this.readingListId).pipe(take(1)).subscribe(chapterId => {
         this.prevChapterId = chapterId;
-        this.loadChapter(chapterId, 'prev');
+        this.loadChapter(chapterId, 'Prev');
       });
     } else {
-      this.loadChapter(this.prevChapterId, 'prev');
+      this.loadChapter(this.prevChapterId, 'Prev');
     }
   }
 
-  loadChapter(chapterId: number, direction: 'next' | 'prev') {
+  loadChapter(chapterId: number, direction: 'Next' | 'Prev') {
     if (chapterId >= 0) {
       this.chapterId = chapterId;
       this.continuousChaptersStack.push(chapterId); 
       // Load chapter Id onto route but don't reload
-      const lastSlashIndex = this.router.url.lastIndexOf('/');
-      const newRoute = this.router.url.substring(0, lastSlashIndex + 1) + this.chapterId + '';
+      const newRoute = this.readerService.getNextChapterUrl(this.router.url, this.chapterId, this.incognitoMode, this.readingListMode, this.readingListId);
       window.history.replaceState({}, '', newRoute);
       this.init();
+      this.toastr.info(direction + ' chapter loaded', '', {timeOut: 3000});
     } else {
       // This will only happen if no actual chapter can be found
-      this.toastr.warning('Could not find ' + direction + ' chapter');
+      this.toastr.warning('Could not find ' + direction.toLowerCase() + ' chapter');
       this.isLoading = false;
-      if (direction === 'prev') {
+      if (direction === 'Prev') {
         this.prevPageDisabled = true;
       } else {
         this.nextPageDisabled = true;
@@ -722,12 +774,44 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     }
   }
 
+  /**
+   * There are some hard limits on the size of canvas' that we must cap at. https://github.com/jhildenbiddle/canvas-size#test-results
+   * For Safari, it's 16,777,216, so we cap at 4096x4096 when this happens. The drawImage in render will perform bi-cubic scaling for us.
+   * @returns If we should continue to the render loop 
+   */
+  setCanvasSize() {
+    if (this.ctx && this.canvas) {
+      // eslint-disable-next-line @typescript-eslint/ban-ts-comment
+      // @ts-ignore
+      const isSafari = [
+        'iPad Simulator',
+        'iPhone Simulator',
+        'iPod Simulator',
+        'iPad',
+        'iPhone',
+        'iPod'
+      ].includes(navigator.platform)
+      // iPad on iOS 13 detection
+      || (navigator.userAgent.includes("Mac") && "ontouchend" in document);
+      const canvasLimit = isSafari ? 16_777_216 : 124_992_400;
+      const needsScaling = this.canvasImage.width * this.canvasImage.height > canvasLimit;
+      if (needsScaling) {
+        this.canvas.nativeElement.width = isSafari ? 4_096 : 16_384;
+        this.canvas.nativeElement.height = isSafari ? 4_096 : 16_384;
+      } else {
+        this.canvas.nativeElement.width = this.canvasImage.width;
+        this.canvas.nativeElement.height = this.canvasImage.height;
+      }
+    }
+    return true;
+  }
+
   renderPage() {
     if (this.ctx && this.canvas) {
       this.canvasImage.onload = null;
-      //this.ctx.imageSmoothingEnabled = true;
-      this.canvas.nativeElement.width = this.canvasImage.width;
-      this.canvas.nativeElement.height = this.canvasImage.height;
+
+      if (!this.setCanvasSize()) return;
+
       const needsSplitting = this.canvasImage.width > this.canvasImage.height;
       this.updateSplitPage();
 
@@ -777,8 +861,9 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
       pageNum = this.pageNum + 1;
     }
 
-
-    this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, pageNum).pipe(take(1)).subscribe(() => {/* No operation */});
+    if (!this.incognitoMode) {
+      this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, pageNum).pipe(take(1)).subscribe(() => {/* No operation */});
+    }
 
     this.isLoading = true;
     this.canvasImage = this.cachedImages.current();
@@ -838,13 +923,13 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     if (this.pageNum >= this.maxPages - 10) {
       // Tell server to cache the next chapter
       if (this.nextChapterId > 0 && !this.nextChapterPrefetched) {
-        this.readerService.getChapterInfo(this.seriesId, this.nextChapterId).pipe(take(1)).subscribe(res => {
+        this.readerService.getChapterInfo(this.nextChapterId).pipe(take(1)).subscribe(res => {
           this.nextChapterPrefetched = true;
         });
       }
     } else if (this.pageNum <= 10) {
       if (this.prevChapterId > 0 && !this.prevChapterPrefetched) {
-        this.readerService.getChapterInfo(this.seriesId, this.prevChapterId).pipe(take(1)).subscribe(res => {
+        this.readerService.getChapterInfo(this.prevChapterId).pipe(take(1)).subscribe(res => {
           this.prevChapterPrefetched = true;
         });
       }
@@ -901,11 +986,10 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
     switch(this.readerMode) {
       case READER_MODE.MANGA_LR:
         this.readerMode = READER_MODE.MANGA_UD;
+        this.pagingDirection = PAGING_DIRECTION.FORWARD;
         break;
       case READER_MODE.MANGA_UD:
         this.readerMode = READER_MODE.WEBTOON;
-        // Temp disable ability to use webtoon
-        //this.readerMode = READER_MODE.MANGA_LR;
         break;
       case READER_MODE.WEBTOON:
         this.readerMode = READER_MODE.MANGA_LR;
@@ -929,10 +1013,12 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
 
   handleWebtoonPageChange(updatedPageNum: number) {
     this.setPageNum(updatedPageNum);
+    if (this.incognitoMode) return;
     this.readerService.saveProgress(this.seriesId, this.volumeId, this.chapterId, this.pageNum).pipe(take(1)).subscribe(() => {/* No operation */});
   }
 
   saveSettings() {
+    // NOTE: This is not called anywhere
     if (this.user === undefined) return;
 
     const data: Preferences = {
@@ -974,9 +1060,9 @@ export class MangaReaderComponent implements OnInit, AfterViewInit, OnDestroy {
    * Bookmarks the current page for the chapter
    */
   bookmarkPage() {
+    // TODO: Show some sort of UI visual to show that a page was bookmarked
     const pageNum = this.pageNum;
     if (this.pageBookmarked) {
-      // Remove bookmark
       this.readerService.unbookmark(this.seriesId, this.volumeId, this.chapterId, pageNum).pipe(take(1)).subscribe(() => {
         delete this.bookmarks[pageNum];
       });
diff --git a/UI/Web/src/app/manga-reader/manga-reader.router.module.ts b/UI/Web/src/app/manga-reader/manga-reader.router.module.ts
index 388f727b2..680c7cde7 100644
--- a/UI/Web/src/app/manga-reader/manga-reader.router.module.ts
+++ b/UI/Web/src/app/manga-reader/manga-reader.router.module.ts
@@ -6,7 +6,12 @@ const routes: Routes = [
   {
       path: ':chapterId',
       component: MangaReaderComponent
-  }
+  },
+  {
+    // This will allow the MangaReader to have a list to use for next/prev chapters rather than natural sort order
+    path: ':chapterId/list/:listId',
+    component: MangaReaderComponent
+}
 ];
 
 
diff --git a/UI/Web/src/app/nav-header/nav-header.component.html b/UI/Web/src/app/nav-header/nav-header.component.html
index 28da75c1e..c371393d3 100644
--- a/UI/Web/src/app/nav-header/nav-header.component.html
+++ b/UI/Web/src/app/nav-header/nav-header.component.html
@@ -2,7 +2,7 @@
     
        
       Skip to main content
        Kavita
-      
          
+      
            
         
         
            
           
            
diff --git a/UI/Web/src/app/nav-header/nav-header.component.ts b/UI/Web/src/app/nav-header/nav-header.component.ts
index 1216af274..d9005bc10 100644
--- a/UI/Web/src/app/nav-header/nav-header.component.ts
+++ b/UI/Web/src/app/nav-header/nav-header.component.ts
@@ -72,7 +72,7 @@ export class NavHeaderComponent implements OnInit, OnDestroy {
 
   onChangeSearch(val: string) {
       this.isLoading = true;
-      this.searchTerm = val;
+      this.searchTerm = val.trim();
       this.libraryService.search(val).pipe(takeUntil(this.onDestroy)).subscribe(results => {
         this.searchResults = results;
         this.isLoading = false;
diff --git a/UI/Web/src/app/admin/filter.pipe.ts b/UI/Web/src/app/pipe/filter.pipe.ts
similarity index 100%
rename from UI/Web/src/app/admin/filter.pipe.ts
rename to UI/Web/src/app/pipe/filter.pipe.ts
diff --git a/UI/Web/src/app/pipe/pipe.module.ts b/UI/Web/src/app/pipe/pipe.module.ts
new file mode 100644
index 000000000..4361180d5
--- /dev/null
+++ b/UI/Web/src/app/pipe/pipe.module.ts
@@ -0,0 +1,18 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { FilterPipe } from './filter.pipe';
+
+
+
+@NgModule({
+  declarations: [
+    FilterPipe
+  ],
+  imports: [
+    CommonModule,
+  ],
+  exports: [
+    FilterPipe
+  ]
+})
+export class PipeModule { }
diff --git a/UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.html b/UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.html
new file mode 100644
index 000000000..fbcf8083d
--- /dev/null
+++ b/UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.html
@@ -0,0 +1,46 @@
+
+
            
+    
+    
+
            
+
            
+
            
+    
            
+        
+        
            
+            
+            
            
+                
+            
            
+        
            
+    
            
+    
              
+        
            • 
+            {{readingList.title}} 
+        
              • 
+        
            • No lists created yet
              • 
+        
            • 
+            
+        
              • 
+    
            
+
            
+
            
+    
            
+        
            
+            
            
+              
+              
+            
            
+            
            
+              
+            
            
+          
            
+    
            
+
            
+
            
+
+
diff --git a/UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.scss b/UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.scss
new file mode 100644
index 000000000..91847160a
--- /dev/null
+++ b/UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.scss
@@ -0,0 +1,7 @@
+.clickable {
+    cursor: pointer;
+}
+
+.clickable:hover, .clickable:focus {
+    background-color: lightgreen;
+}
\ No newline at end of file
diff --git a/UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.ts b/UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.ts
new file mode 100644
index 000000000..a33d69332
--- /dev/null
+++ b/UI/Web/src/app/reading-list/_modals/add-to-list-modal/add-to-list-modal.component.ts
@@ -0,0 +1,137 @@
+import { noUndefined } from '@angular/compiler/src/util';
+import { AfterViewInit, Component, ElementRef, Input, OnInit, ViewChild } from '@angular/core';
+import { FormControl, FormGroup, Validators } from '@angular/forms';
+import { NgbActiveModal } from '@ng-bootstrap/ng-bootstrap';
+import { ToastrService } from 'ngx-toastr';
+import { ReadingList } from 'src/app/_models/reading-list';
+import { ReadingListService } from 'src/app/_services/reading-list.service';
+
+export enum ADD_FLOW {
+  Series = 0,
+  Volume = 1,
+  Chapter = 2,
+  Multiple = 3,
+  Multiple_Series
+}
+
+@Component({
+  selector: 'app-add-to-list-modal',
+  templateUrl: './add-to-list-modal.component.html',
+  styleUrls: ['./add-to-list-modal.component.scss']
+})
+export class AddToListModalComponent implements OnInit, AfterViewInit {
+
+  @Input() title!: string;
+  /**
+   * Only used in Series flow
+   */
+  @Input() seriesId?: number;
+  /**
+   * Only used in Volume flow
+   */
+  @Input() volumeId?: number;
+  /**
+   * Only used in Chapter flow
+   */
+  @Input() chapterId?: number;
+  /**
+   * Only used in Multiple flow
+   */
+  @Input() volumeIds?: Array;
+  /**
+   * Only used in Multiple flow
+   */
+  @Input() chapterIds?: Array;
+  /**
+   * Only used in Multiple_Series flow
+   */
+  @Input() seriesIds?: Array;
+
+  /**
+   * Determines which Input is required and which API is used to associate to the Reading List
+   */
+  @Input() type!: ADD_FLOW;
+
+  /**
+   * All existing reading lists sorted by recent use date
+   */
+  lists: Array = [];
+  loading: boolean = false;
+  listForm: FormGroup = new FormGroup({});
+
+  @ViewChild('title') inputElem!: ElementRef;
+
+
+  constructor(private modal: NgbActiveModal, private readingListService: ReadingListService, private toastr: ToastrService) { }
+
+  ngOnInit(): void {
+
+    this.listForm.addControl('title', new FormControl(this.title, []));
+    this.listForm.addControl('filterQuery', new FormControl('', []));
+    
+    this.loading = true;
+    this.readingListService.getReadingLists(false).subscribe(lists => {
+      this.lists = lists.result;
+      this.loading = false;
+    });
+
+    
+  }
+
+  ngAfterViewInit() {
+    // Shift focus to input
+    if (this.inputElem) {
+      this.inputElem.nativeElement.select();
+    }
+  }
+
+  close() {
+    this.modal.close();
+  }
+
+  create() {
+    this.readingListService.createList(this.listForm.value.title).subscribe(list => {
+      this.addToList(list);
+    });
+  }
+
+  addToList(readingList: ReadingList) {
+
+    if (this.type === ADD_FLOW.Multiple_Series && this.seriesIds !== undefined) {
+      this.readingListService.updateByMultipleSeries(readingList.id, this.seriesIds).subscribe(() => {
+        this.toastr.success('Series added to reading list');
+        this.modal.close();
+      });
+    }
+
+    if (this.seriesId === undefined) return;
+
+    if (this.type === ADD_FLOW.Series && this.seriesId !== undefined) {
+      this.readingListService.updateBySeries(readingList.id, this.seriesId).subscribe(() => {
+        this.toastr.success('Series added to reading list');
+        this.modal.close();
+      });
+    } else if (this.type === ADD_FLOW.Volume && this.volumeId !== undefined) {
+      this.readingListService.updateByVolume(readingList.id, this.seriesId, this.volumeId).subscribe(() => {
+        this.toastr.success('Volumes added to reading list');
+        this.modal.close();
+      });
+    } else if (this.type === ADD_FLOW.Chapter && this.chapterId !== undefined) {
+      this.readingListService.updateByChapter(readingList.id, this.seriesId, this.chapterId).subscribe(() => {
+        this.toastr.success('Chapter added to reading list');
+        this.modal.close();
+      });
+    } else if (this.type === ADD_FLOW.Multiple && this.volumeIds !== undefined && this.chapterIds !== undefined) {
+      this.readingListService.updateByMultiple(readingList.id, this.seriesId, this.volumeIds, this.chapterIds).subscribe(() => {
+        this.toastr.success('Chapters and Volumes added to reading list');
+        this.modal.close();
+      });
+    }
+    
+  }
+
+  filterList = (listItem: ReadingList) => {
+    return listItem.title.toLowerCase().indexOf((this.listForm.value.filterQuery || '').toLowerCase()) >= 0;
+  }
+
+}
diff --git a/UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.html b/UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.html
new file mode 100644
index 000000000..c07d65d6a
--- /dev/null
+++ b/UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.html
@@ -0,0 +1,31 @@
+
+
            
+    
+    
+
            
+
            
+    
            
+        This list is currently {{readingList?.promoted ? 'promoted' : 'not promoted'}} (). 
+        Promotion means that the list can be seen server-wide, not just for admin users. All series that are within this list will still have user-access restrictions placed on them.
+    
            
+    
            
+        
            
+            
+            
+        
            
+
+        
            
+            
+            
+        
            
+    
            
+
            
+
            
+    
+    
+    
+
            
+
+
diff --git a/UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.scss b/UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.scss
new file mode 100644
index 000000000..e69de29bb
diff --git a/UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.ts b/UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.ts
new file mode 100644
index 000000000..58bd80b9b
--- /dev/null
+++ b/UI/Web/src/app/reading-list/_modals/edit-reading-list-modal/edit-reading-list-modal.component.ts
@@ -0,0 +1,52 @@
+import { Component, Input, OnInit } from '@angular/core';
+import { FormGroup, FormControl, Validators } from '@angular/forms';
+import { NgbActiveModal } from '@ng-bootstrap/ng-bootstrap';
+import { ReadingList } from 'src/app/_models/reading-list';
+import { ReadingListService } from 'src/app/_services/reading-list.service';
+
+@Component({
+  selector: 'app-edit-reading-list-modal',
+  templateUrl: './edit-reading-list-modal.component.html',
+  styleUrls: ['./edit-reading-list-modal.component.scss']
+})
+export class EditReadingListModalComponent implements OnInit {
+
+  @Input() readingList!: ReadingList;
+  reviewGroup!: FormGroup;
+
+  constructor(private ngModal: NgbActiveModal, private readingListService: ReadingListService) { }
+
+  ngOnInit(): void {
+    this.reviewGroup = new FormGroup({
+      title: new FormControl(this.readingList.title, [Validators.required]),
+      summary: new FormControl(this.readingList.summary, [])
+    });
+  }
+
+  close() {
+    this.ngModal.dismiss(undefined);
+  }
+
+  save() {
+    if (this.reviewGroup.value.title.trim() === '') return;
+    const model = {...this.reviewGroup.value, readingListId: this.readingList.id, promoted: this.readingList.promoted};
+
+    this.readingListService.update(model).subscribe(() => {
+      this.readingList.title = model.title;
+      this.readingList.summary = model.summary;
+      this.ngModal.close(this.readingList);
+    });
+  }
+
+  togglePromotion() {
+    const originalPromotion = this.readingList.promoted;
+    this.readingList.promoted = !this.readingList.promoted;
+    const model = {readingListId: this.readingList.id, promoted: this.readingList.promoted};
+    this.readingListService.update(model).subscribe(res => {
+      /* No Operation */
+    }, err => {
+      this.readingList.promoted = originalPromotion;
+    });
+  }
+
+}
diff --git a/UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.html b/UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.html
new file mode 100644
index 000000000..3bee8ee51
--- /dev/null
+++ b/UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.html
@@ -0,0 +1,23 @@
+
            
+    
            
+        
            
+            
+        
            
+
+        
+
+        
            
+            
+                    
+        
            
+        
+        
+    
            
+
            
+
+
            
+
+
            
\ No newline at end of file
diff --git a/UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.scss b/UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.scss
new file mode 100644
index 000000000..dccf8be4e
--- /dev/null
+++ b/UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.scss
@@ -0,0 +1,47 @@
+.example-list {
+    min-width: 500px;
+    max-width: 100%;
+    min-height: 60px;
+    display: block;
+    border-radius: 4px;
+    overflow: hidden;
+  }
+  
+  .example-box {
+    padding: 20px 10px;
+    border-bottom: solid 1px #ccc;
+    display: flex;
+    flex-direction: row;
+    box-sizing: border-box;
+    font-size: 14px;
+
+    .drag-handle {
+        cursor: move;
+        font-size: 24px;
+        margin-top: 215%;
+    }
+  }
+  
+  .cdk-drag-preview {
+    box-sizing: border-box;
+    border-radius: 4px;
+    box-shadow: 0 5px 5px -3px rgba(0, 0, 0, 0.2),
+                0 8px 10px 1px rgba(0, 0, 0, 0.14),
+                0 3px 14px 2px rgba(0, 0, 0, 0.12);
+  }
+  
+  .cdk-drag-placeholder {
+    opacity: 0;
+  }
+  
+  .cdk-drag-animating {
+    transition: transform 250ms cubic-bezier(0, 0, 0.2, 1);
+  }
+  
+  .example-box:last-child {
+    border: none;
+  }
+  
+  .example-list.cdk-drop-list-dragging .example-box:not(.cdk-drag-placeholder) {
+    transition: transform 250ms cubic-bezier(0, 0, 0.2, 1);
+  }
\ No newline at end of file
diff --git a/UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.ts b/UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.ts
new file mode 100644
index 000000000..fddf4ac43
--- /dev/null
+++ b/UI/Web/src/app/reading-list/dragable-ordered-list/dragable-ordered-list.component.ts
@@ -0,0 +1,63 @@
+import { CdkDragDrop, moveItemInArray } from '@angular/cdk/drag-drop';
+import { Component, ContentChild, EventEmitter, Input, OnInit, Output, TemplateRef } from '@angular/core';
+
+export interface IndexUpdateEvent {
+  fromPosition: number;
+  toPosition: number;
+  item: any;
+}
+
+export interface ItemRemoveEvent {
+  position: number;
+  item: any;
+}
+
+@Component({
+  selector: 'app-dragable-ordered-list',
+  templateUrl: './dragable-ordered-list.component.html',
+  styleUrls: ['./dragable-ordered-list.component.scss']
+})
+export class DragableOrderedListComponent implements OnInit {
+
+  @Input() accessibilityMode: boolean = false;
+  @Input() items: Array = [];
+  @Output() orderUpdated: EventEmitter = new EventEmitter();
+  @Output() itemRemove: EventEmitter = new EventEmitter();
+  @ContentChild('draggableItem') itemTemplate!: TemplateRef;
+
+  constructor() { }
+
+  ngOnInit(): void {
+  }
+
+  drop(event: CdkDragDrop) {
+    if (event.previousIndex === event.currentIndex)  return;
+    moveItemInArray(this.items, event.previousIndex, event.currentIndex);
+    this.orderUpdated.emit({
+      fromPosition: event.previousIndex,
+      toPosition: event.currentIndex,
+      item: this.items[event.currentIndex]
+    });
+  }
+
+  updateIndex(previousIndex: number, item: any) {
+    // get the new value of the input 
+    var inputElem = document.querySelector('#reorder-' + previousIndex);
+    const newIndex = parseInt(inputElem.value, 10);
+    if (previousIndex === newIndex)  return;
+    moveItemInArray(this.items, previousIndex, newIndex);
+    this.orderUpdated.emit({
+      fromPosition: previousIndex,
+      toPosition: newIndex,
+      item: this.items[newIndex]
+    });
+  }
+
+  removeItem(item: any, position: number) {
+    this.itemRemove.emit({
+      position,
+      item
+    });
+  }
+
+}
diff --git a/UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.html b/UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.html
new file mode 100644
index 000000000..bfe2e5d09
--- /dev/null
+++ b/UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.html
@@ -0,0 +1,73 @@
+
            
+  
            
+    
+    
            
+                
+      
            
+        
+             
+        
+        {{readingList.title}} () 
+        {{items.length}}
+      
            
+    
            
+    
+    
            
+      
            
+        
+      
            
+      
            
+          
+      
            
+      
            
+        
            
+          
+          
+        
            
+      
            
+    
            
+    
+    
            
+      
+    
            
+    
            
+
+    
            
+      No chapters added
+    
                
+
+    
+        
+            
            
+                
+                
            
+                  
            {{formatTitle(item)}} 
+                      
+                      {{item.pagesRead}} / {{item.pagesTotal}}
+                      UNREAD
+                      READ
+                    
+                  
            
+                  
+                  {{utilityService.mangaFormat(item.seriesFormat)}} 
+
+                  {{item.seriesName}}
+                  
+                    
+                  
+                
            
+              
            
+                     
+                
+
            
\ No newline at end of file
diff --git a/UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.scss b/UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.scss
new file mode 100644
index 000000000..f191b076d
--- /dev/null
+++ b/UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.scss
@@ -0,0 +1,4 @@
+.container-sm {
+    padding-left: 0px;
+    padding-right: 0px;
+}
\ No newline at end of file
diff --git a/UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.ts b/UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.ts
new file mode 100644
index 000000000..5c1728157
--- /dev/null
+++ b/UI/Web/src/app/reading-list/reading-list-detail/reading-list-detail.component.ts
@@ -0,0 +1,159 @@
+import { Component, OnInit } from '@angular/core';
+import { ActivatedRoute, Router } from '@angular/router';
+import { ToastrService } from 'ngx-toastr';
+import { take } from 'rxjs/operators';
+import { ConfirmService } from 'src/app/shared/confirm.service';
+import { UtilityService } from 'src/app/shared/_services/utility.service';
+import { MangaFormat } from 'src/app/_models/manga-format';
+import { ReadingList, ReadingListItem } from 'src/app/_models/reading-list';
+import { AccountService } from 'src/app/_services/account.service';
+import { Action, ActionFactoryService, ActionItem } from 'src/app/_services/action-factory.service';
+import { ActionService } from 'src/app/_services/action.service';
+import { ImageService } from 'src/app/_services/image.service';
+import { ReadingListService } from 'src/app/_services/reading-list.service';
+import { IndexUpdateEvent, ItemRemoveEvent } from '../dragable-ordered-list/dragable-ordered-list.component';
+
+@Component({
+  selector: 'app-reading-list-detail',
+  templateUrl: './reading-list-detail.component.html',
+  styleUrls: ['./reading-list-detail.component.scss']
+})
+export class ReadingListDetailComponent implements OnInit {
+
+  items: Array = [];
+  listId!: number;
+  readingList!: ReadingList;
+  actions: Array> = [];
+  isAdmin: boolean = false;
+  isLoading: boolean = false;
+  accessibilityMode: boolean = false;
+
+  // Downloading
+  hasDownloadingRole: boolean = false;
+  downloadInProgress: boolean = false;
+
+
+  get MangaFormat(): typeof MangaFormat {
+    return MangaFormat;
+  }
+
+  constructor(private route: ActivatedRoute, private router: Router, private readingListService: ReadingListService,
+    private actionService: ActionService, private actionFactoryService: ActionFactoryService, public utilityService: UtilityService,
+    public imageService: ImageService, private accountService: AccountService, private toastr: ToastrService, private confirmService: ConfirmService) {}
+
+  ngOnInit(): void {
+    const listId = this.route.snapshot.paramMap.get('id');
+
+    if (listId === null) {
+      this.router.navigateByUrl('/libraries');
+      return;
+    }
+
+    this.listId = parseInt(listId, 10);
+
+    this.readingListService.getReadingList(this.listId).subscribe(readingList => {
+      if (readingList == null) {
+        // The list doesn't exist
+        this.toastr.error('This list doesn\'t exist.');
+        this.router.navigateByUrl('library');
+        return;
+      }
+      this.readingList = readingList;
+
+      this.accountService.currentUser$.pipe(take(1)).subscribe(user => {
+        if (user) {
+          this.isAdmin = this.accountService.hasAdminRole(user);
+          this.hasDownloadingRole = this.accountService.hasDownloadRole(user);
+          
+          this.actions = this.actionFactoryService.getReadingListActions(this.handleReadingListActionCallback.bind(this)).filter(action => this.readingListService.actionListFilter(action, readingList, this.isAdmin));
+        }
+      });
+    });
+    this.getListItems();
+  }
+
+  getListItems() {
+    this.isLoading = true;
+    this.readingListService.getListItems(this.listId).subscribe(items => {
+      this.items = items;
+      this.isLoading = false;
+    });
+  }
+
+  performAction(action: ActionItem) {
+    // TODO: Try to move performAction into the actionables component. (have default handler in the component, allow for overridding to pass additional context)
+    if (typeof action.callback === 'function') {
+      action.callback(action.action, this.readingList);
+    }
+  }
+
+  handleReadingListActionCallback(action: Action, readingList: ReadingList) {
+    switch(action) {
+      case Action.Delete:
+        this.deleteList(readingList);
+        break;
+      case Action.Edit:
+        this.actionService.editReadingList(readingList, (readingList: ReadingList) => {
+          // Reload information around list
+          this.readingList = readingList;
+        });
+        break;
+    }
+  }
+
+  async deleteList(readingList: ReadingList) {
+    if (!await this.confirmService.confirm('Are you sure you want to delete the reading list? This cannot be undone.')) return;
+
+    this.readingListService.delete(readingList.id).subscribe(() => {
+      this.toastr.success('Reading list deleted');
+      this.router.navigateByUrl('library#lists');
+    });
+  }
+
+  formatTitle(item: ReadingListItem) {
+    if (item.chapterNumber === '0') {
+      return 'Volume ' + item.volumeNumber;
+    }
+
+    if (item.seriesFormat === MangaFormat.EPUB) {
+      return 'Volume ' + this.utilityService.cleanSpecialTitle(item.chapterNumber);
+    }
+
+    return 'Chapter ' + item.chapterNumber;
+  }
+
+  orderUpdated(event: IndexUpdateEvent) {
+    this.readingListService.updatePosition(this.readingList.id, event.item.id, event.fromPosition, event.toPosition).subscribe(() => { /* No Operation */ });
+  }
+
+  itemRemoved(event: ItemRemoveEvent) {
+    this.readingListService.deleteItem(this.readingList.id, event.item.id).subscribe(() => {
+      this.items.splice(event.position, 1);
+      this.toastr.success('Item removed');
+    });
+  }
+
+  removeRead() {
+    this.isLoading = true;
+    this.readingListService.removeRead(this.readingList.id).subscribe(() => {
+      this.getListItems();
+    });
+  }
+
+  read() {
+    let currentlyReadingChapter = this.items[0];
+    for (let i = 0; i < this.items.length; i++) {
+      if (this.items[i].pagesRead >= this.items[i].pagesTotal) {
+        continue;
+      }
+      currentlyReadingChapter = this.items[i];
+      break;
+    }
+
+    if (currentlyReadingChapter.seriesFormat === MangaFormat.EPUB) {
+      this.router.navigate(['library', currentlyReadingChapter.libraryId, 'series', currentlyReadingChapter.seriesId, 'book', currentlyReadingChapter.chapterId], {queryParams: {readingListId: this.readingList.id}});
+    } else {
+      this.router.navigate(['library', currentlyReadingChapter.libraryId, 'series', currentlyReadingChapter.seriesId, 'manga', currentlyReadingChapter.chapterId], {queryParams: {readingListId: this.readingList.id}});
+    }
+  }
+}
diff --git a/UI/Web/src/app/reading-list/reading-list.module.ts b/UI/Web/src/app/reading-list/reading-list.module.ts
new file mode 100644
index 000000000..8b22b67c5
--- /dev/null
+++ b/UI/Web/src/app/reading-list/reading-list.module.ts
@@ -0,0 +1,40 @@
+import { NgModule } from '@angular/core';
+import { CommonModule } from '@angular/common';
+import { DragableOrderedListComponent } from './dragable-ordered-list/dragable-ordered-list.component';
+import { ReadingListDetailComponent } from './reading-list-detail/reading-list-detail.component';
+import { ReadingListRoutingModule } from './reading-list.router.module';
+import {DragDropModule} from '@angular/cdk/drag-drop';
+import { AddToListModalComponent } from './_modals/add-to-list-modal/add-to-list-modal.component';
+import { ReactiveFormsModule } from '@angular/forms';
+import { CardsModule } from '../cards/cards.module';
+import { ReadingListsComponent } from './reading-lists/reading-lists.component';
+import { EditReadingListModalComponent } from './_modals/edit-reading-list-modal/edit-reading-list-modal.component';
+import { PipeModule } from '../pipe/pipe.module';
+import { SharedModule } from '../shared/shared.module';
+
+
+
+@NgModule({
+  declarations: [
+    DragableOrderedListComponent,
+    ReadingListDetailComponent,
+    AddToListModalComponent,
+    ReadingListsComponent,
+    EditReadingListModalComponent
+  ],
+  imports: [
+    CommonModule,
+    ReadingListRoutingModule,
+    ReactiveFormsModule,
+    DragDropModule,
+    CardsModule,
+    PipeModule,
+    SharedModule
+  ],
+  exports: [
+    AddToListModalComponent,
+    ReadingListsComponent,
+    EditReadingListModalComponent
+  ]
+})
+export class ReadingListModule { }
diff --git a/UI/Web/src/app/reading-list/reading-list.router.module.ts b/UI/Web/src/app/reading-list/reading-list.router.module.ts
new file mode 100644
index 000000000..3e664265f
--- /dev/null
+++ b/UI/Web/src/app/reading-list/reading-list.router.module.ts
@@ -0,0 +1,23 @@
+import { NgModule } from "@angular/core";
+import { Routes, RouterModule } from "@angular/router";
+import { AuthGuard } from "../_guards/auth.guard";
+import { ReadingListDetailComponent } from "./reading-list-detail/reading-list-detail.component";
+
+const routes: Routes = [
+  {
+    path: '',
+    runGuardsAndResolvers: 'always',
+    canActivate: [AuthGuard],
+    children: [
+        {path: '', component: ReadingListDetailComponent, pathMatch: 'full'},
+        {path: ':id', component: ReadingListDetailComponent, pathMatch: 'full'},
+    ]
+  }
+];
+
+
+@NgModule({
+  imports: [RouterModule.forChild(routes)],
+  exports: [RouterModule]
+})
+export class ReadingListRoutingModule { }
diff --git a/UI/Web/src/app/reading-list/reading-lists/reading-lists.component.html b/UI/Web/src/app/reading-list/reading-lists/reading-lists.component.html
new file mode 100644
index 000000000..96837060c
--- /dev/null
+++ b/UI/Web/src/app/reading-list/reading-lists/reading-lists.component.html
@@ -0,0 +1,11 @@
+
+    
+        
+    
+
diff --git a/UI/Web/src/app/reading-list/reading-lists/reading-lists.component.scss b/UI/Web/src/app/reading-list/reading-lists/reading-lists.component.scss
new file mode 100644
index 000000000..e69de29bb
diff --git a/UI/Web/src/app/reading-list/reading-lists/reading-lists.component.ts b/UI/Web/src/app/reading-list/reading-lists/reading-lists.component.ts
new file mode 100644
index 000000000..d7051df2e
--- /dev/null
+++ b/UI/Web/src/app/reading-list/reading-lists/reading-lists.component.ts
@@ -0,0 +1,96 @@
+import { Component, OnInit } from '@angular/core';
+import { Router } from '@angular/router';
+import { ToastrService } from 'ngx-toastr';
+import { take } from 'rxjs/operators';
+import { PaginatedResult, Pagination } from 'src/app/_models/pagination';
+import { ReadingList } from 'src/app/_models/reading-list';
+import { AccountService } from 'src/app/_services/account.service';
+import { Action, ActionFactoryService, ActionItem } from 'src/app/_services/action-factory.service';
+import { ActionService } from 'src/app/_services/action.service';
+import { ImageService } from 'src/app/_services/image.service';
+import { ReadingListService } from 'src/app/_services/reading-list.service';
+
+@Component({
+  selector: 'app-reading-lists',
+  templateUrl: './reading-lists.component.html',
+  styleUrls: ['./reading-lists.component.scss']
+})
+export class ReadingListsComponent implements OnInit {
+
+  lists: ReadingList[] = [];
+  loadingLists = false;
+  pagination!: Pagination;
+  actions: ActionItem[] = [];
+  isAdmin: boolean = false;
+
+  constructor(private readingListService: ReadingListService, public imageService: ImageService, private actionFactoryService: ActionFactoryService,
+    private accountService: AccountService, private toastr: ToastrService, private router: Router, private actionService: ActionService) { }
+
+  ngOnInit(): void {
+    this.loadPage();
+
+    this.accountService.currentUser$.pipe(take(1)).subscribe(user => {
+      if (user) {
+        this.isAdmin = this.accountService.hasAdminRole(user);
+      }
+    });
+  }
+
+  getActions(readingList: ReadingList) {
+    return this.actionFactoryService.getReadingListActions(this.handleReadingListActionCallback.bind(this)).filter(action => this.readingListService.actionListFilter(action, readingList, this.isAdmin));
+  }
+
+  performAction(action: ActionItem, readingList: ReadingList) {
+    // TODO: Try to move performAction into the actionables component. (have default handler in the component, allow for overridding to pass additional context)
+    if (typeof action.callback === 'function') {
+      action.callback(action.action, readingList);
+    }
+  }
+
+  handleReadingListActionCallback(action: Action, readingList: ReadingList) {
+    switch(action) {
+      case Action.Delete:
+        this.readingListService.delete(readingList.id).subscribe(() => {
+          this.toastr.success('Reading list deleted');
+          this.loadPage();
+        });
+        break;
+      case Action.Edit:
+        this.actionService.editReadingList(readingList, (updatedList: ReadingList) => {
+          // Reload information around list
+          readingList = updatedList;
+        });
+        break;
+    }
+  }
+
+  getPage() {
+    const urlParams = new URLSearchParams(window.location.search);
+    return urlParams.get('page');
+  }
+
+  loadPage() {
+    const page = this.getPage();
+    if (page != null) {
+      this.pagination.currentPage = parseInt(page, 10);
+    }
+    this.loadingLists = true;
+
+    this.readingListService.getReadingLists(true, this.pagination?.currentPage, this.pagination?.itemsPerPage).pipe(take(1)).subscribe((readingLists: PaginatedResult) => {
+      this.lists = readingLists.result;
+      this.pagination = readingLists.pagination;
+      this.loadingLists = false;
+      window.scrollTo(0, 0);
+    });
+  }
+
+  onPageChange(pagination: Pagination) {
+    window.history.replaceState(window.location.href, '', window.location.href.split('?')[0] + '?page=' + this.pagination.currentPage);
+    this.loadPage();
+  }
+
+  handleClick(list: ReadingList) {
+    this.router.navigateByUrl('lists/' + list.id);
+  }
+
+}
diff --git a/UI/Web/src/app/series-detail/series-detail.component.html b/UI/Web/src/app/series-detail/series-detail.component.html
index 7976265d5..541ff5b88 100644
--- a/UI/Web/src/app/series-detail/series-detail.component.html
+++ b/UI/Web/src/app/series-detail/series-detail.component.html
@@ -95,19 +95,18 @@
             
            
         
            
     
        
-    
        
-
 
     
        
-        
          
+        
+        
            
             
          • 
               Specials
               
-                
            
-                    
            
-                        
+                    
            
+                        
+                        [read]="chapter.pagesRead" [total]="chapter.pages" [actions]="chapterActions" (selection)="bulkSelectionService.handleCardSelection('special', idx, chapters.length, $event)" [selected]="bulkSelectionService.isCardSelected('special', idx)" [allowSelection]="true">
                     
            
                 
            
               
@@ -115,17 +114,17 @@
             
          • 
               Volumes/Chapters
               
-                  
            
-                    
            
-                        
-                    
            
-                    
            
-                        
-                    
            
+                  
            
+                        
            
+                                
+                        
            
+                        
            
+                            
+                        
            
                   
            
               
             
            • 
diff --git a/UI/Web/src/app/series-detail/series-detail.component.scss b/UI/Web/src/app/series-detail/series-detail.component.scss
index 06c2a718c..3819e8b7a 100644
--- a/UI/Web/src/app/series-detail/series-detail.component.scss
+++ b/UI/Web/src/app/series-detail/series-detail.component.scss
@@ -13,7 +13,7 @@
 
 .poster {
   width: 100%;
-  max-height: 481px;
+  max-width: 400px;
 }
 
 
diff --git a/UI/Web/src/app/series-detail/series-detail.component.ts b/UI/Web/src/app/series-detail/series-detail.component.ts
index 56b562fec..208bbd363 100644
--- a/UI/Web/src/app/series-detail/series-detail.component.ts
+++ b/UI/Web/src/app/series-detail/series-detail.component.ts
@@ -1,18 +1,21 @@
-import { Component, OnInit } from '@angular/core';
+import { Component, HostListener, OnDestroy, OnInit } from '@angular/core';
 import { Title } from '@angular/platform-browser';
 import { ActivatedRoute, Router } from '@angular/router';
 import { NgbModal, NgbRatingConfig } from '@ng-bootstrap/ng-bootstrap';
 import { ToastrService } from 'ngx-toastr';
-import { finalize, take, takeWhile } from 'rxjs/operators';
+import { Subject } from 'rxjs';
+import { finalize, take, takeUntil, takeWhile } from 'rxjs/operators';
+import { BulkSelectionService } from '../cards/bulk-selection.service';
 import { CardDetailsModalComponent } from '../cards/_modals/card-details-modal/card-details-modal.component';
 import { EditSeriesModalComponent } from '../cards/_modals/edit-series-modal/edit-series-modal.component';
 import { ConfirmConfig } from '../shared/confirm-dialog/_models/confirm-config';
 import { ConfirmService } from '../shared/confirm.service';
 import { TagBadgeCursor } from '../shared/tag-badge/tag-badge.component';
 import { DownloadService } from '../shared/_services/download.service';
-import { UtilityService } from '../shared/_services/utility.service';
+import { KEY_CODES, UtilityService } from '../shared/_services/utility.service';
 import { ReviewSeriesModalComponent } from '../_modals/review-series-modal/review-series-modal.component';
 import { Chapter } from '../_models/chapter';
+import { ScanSeriesEvent } from '../_models/events/scan-series-event';
 import { LibraryType } from '../_models/library';
 import { MangaFormat } from '../_models/manga-format';
 import { Series } from '../_models/series';
@@ -23,6 +26,7 @@ import { ActionItem, ActionFactoryService, Action } from '../_services/action-fa
 import { ActionService } from '../_services/action.service';
 import { ImageService } from '../_services/image.service';
 import { LibraryService } from '../_services/library.service';
+import { MessageHubService } from '../_services/message-hub.service';
 import { ReaderService } from '../_services/reader.service';
 import { SeriesService } from '../_services/series.service';
 
@@ -32,7 +36,7 @@ import { SeriesService } from '../_services/series.service';
   templateUrl: './series-detail.component.html',
   styleUrls: ['./series-detail.component.scss']
 })
-export class SeriesDetailComponent implements OnInit {
+export class SeriesDetailComponent implements OnInit, OnDestroy {
 
   series!: Series;
   volumes: Volume[] = [];
@@ -50,6 +54,7 @@ export class SeriesDetailComponent implements OnInit {
   seriesActions: ActionItem[] = [];
   volumeActions: ActionItem[] = [];
   chapterActions: ActionItem[] = [];
+  bulkActions: ActionItem[] = [];
 
   hasSpecials = false;
   specials: Array = [];
@@ -76,6 +81,57 @@ export class SeriesDetailComponent implements OnInit {
    */
   actionInProgress: boolean = false;
 
+  /**
+   * Track by function for Volume to tell when to refresh card data
+   */
+  trackByVolumeIdentity = (index: number, item: Volume) => `${item.name}_${item.pagesRead}`;
+  /**
+   * Track by function for Chapter to tell when to refresh card data
+   */
+  trackByChapterIdentity = (index: number, item: Chapter) => `${item.title}_${item.number}_${item.pagesRead}`;
+
+  bulkActionCallback = (action: Action, data: any) => {
+    if (this.series === undefined) {
+      return;
+    }
+    const seriesId = this.series.id;
+    // we need to figure out what is actually selected now
+    const selectedVolumeIndexes = this.bulkSelectionService.getSelectedCardsForSource('volume');
+    const selectedChapterIndexes = this.bulkSelectionService.getSelectedCardsForSource('chapter');
+    const selectedSpecialIndexes = this.bulkSelectionService.getSelectedCardsForSource('special');
+
+    const selectedChapterIds = this.chapters.filter((_chapter, index: number) => selectedChapterIndexes.includes(index + ''));
+    const selectedVolumeIds = this.volumes.filter((_volume, index: number) => selectedVolumeIndexes.includes(index + ''));
+    const selectedSpecials = this.specials.filter((_chapter, index: number) => selectedSpecialIndexes.includes(index + ''));
+    const chapters = [...selectedChapterIds, ...selectedSpecials];
+
+    switch (action) {
+      case Action.AddToReadingList:
+        this.actionService.addMultipleToReadingList(seriesId, selectedVolumeIds, chapters, () => {
+          this.actionInProgress = false;
+          this.bulkSelectionService.deselectAll();
+        });
+        break;
+      case Action.MarkAsRead:
+        this.actionService.markMultipleAsRead(seriesId, selectedVolumeIds, chapters,  () => {
+          this.setContinuePoint();
+          this.actionInProgress = false;
+          this.bulkSelectionService.deselectAll();
+        });
+        
+        break;
+      case Action.MarkAsUnread:
+        this.actionService.markMultipleAsUnread(seriesId, selectedVolumeIds, chapters,  () => {
+          this.setContinuePoint();
+          this.actionInProgress = false;
+          this.bulkSelectionService.deselectAll();
+        });
+        break;
+    }
+  }
+
+  private onDestroy: Subject = new Subject();
+
 
   get LibraryType(): typeof LibraryType {
     return LibraryType;
@@ -97,7 +153,8 @@ export class SeriesDetailComponent implements OnInit {
               private actionFactoryService: ActionFactoryService, private libraryService: LibraryService,
               private confirmService: ConfirmService, private titleService: Title,
               private downloadService: DownloadService, private actionService: ActionService,
-              public imageSerivce: ImageService) {
+              public imageSerivce: ImageService, private messageHub: MessageHubService, 
+              public bulkSelectionService: BulkSelectionService) {
     ratingConfig.max = 5;
     this.router.routeReuseStrategy.shouldReuseRoute = () => false;
     this.accountService.currentUser$.pipe(take(1)).subscribe(user => {
@@ -116,20 +173,39 @@ export class SeriesDetailComponent implements OnInit {
       return;
     }
 
+    this.messageHub.scanSeries.pipe(takeUntil(this.onDestroy)).subscribe((event: ScanSeriesEvent) => {
+      if (event.seriesId == this.series.id)
+      this.loadSeries(seriesId);
+      this.seriesImage = this.imageService.randomize(this.imageService.getSeriesCoverImage(this.series.id));
+      this.toastr.success('Scan series completed');
+    });
+
     const seriesId = parseInt(routeId, 10);
     this.libraryId = parseInt(libraryId, 10);
     this.seriesImage = this.imageService.getSeriesCoverImage(seriesId);
-    this.loadSeriesMetadata(seriesId);
     this.libraryService.getLibraryType(this.libraryId).subscribe(type => {
       this.libraryType = type;
       this.loadSeries(seriesId);
     });
   }
 
-  loadSeriesMetadata(seriesId: number) {
-    this.seriesService.getMetadata(seriesId).subscribe(metadata => {
-      this.seriesMetadata = metadata;
-    });
+  ngOnDestroy() {
+    this.onDestroy.next();
+    this.onDestroy.complete();
+  }
+
+  @HostListener('document:keydown.shift', ['$event'])
+  handleKeypress(event: KeyboardEvent) {
+    if (event.key === KEY_CODES.SHIFT) {
+      this.bulkSelectionService.isShiftDown = true;
+    }
+  }
+
+  @HostListener('document:keyup.shift', ['$event'])
+  handleKeyUp(event: KeyboardEvent) {
+    if (event.key === KEY_CODES.SHIFT) {
+      this.bulkSelectionService.isShiftDown = false;
+    }
   }
 
   handleSeriesActionCallback(action: Action, series: Series) {
@@ -159,6 +235,9 @@ export class SeriesDetailComponent implements OnInit {
       case(Action.Bookmarks):
         this.actionService.openBookmarkModal(series, () => this.actionInProgress = false);
         break;
+      case(Action.AddToReadingList):
+        this.actionService.addSeriesToReadingList(series, () => this.actionInProgress = false);
+        break;
       default:
         break;
     }
@@ -175,6 +254,14 @@ export class SeriesDetailComponent implements OnInit {
       case(Action.Edit):
         this.openViewInfo(volume);
         break;
+      case(Action.AddToReadingList):
+        this.actionService.addVolumeToReadingList(volume, this.series.id, () => {/* No Operation */ });
+        break;
+      case(Action.IncognitoRead):
+        if (volume.chapters != undefined && volume.chapters?.length >= 1) {
+          this.openChapter(volume.chapters[0], true);
+        }
+        break;
       default:
         break;
     }
@@ -191,6 +278,12 @@ export class SeriesDetailComponent implements OnInit {
       case(Action.Edit):
         this.openViewInfo(chapter);
         break;
+      case(Action.AddToReadingList):
+        this.actionService.addChapterToReadingList(chapter, this.series.id, () => {/* No Operation */ });
+        break;
+      case(Action.IncognitoRead):
+        this.openChapter(chapter, true);
+        break;
       default:
         break;
     }
@@ -245,6 +338,7 @@ export class SeriesDetailComponent implements OnInit {
       this.volumeActions = this.actionFactoryService.getVolumeActions(this.handleVolumeActionCallback.bind(this));
       this.chapterActions = this.actionFactoryService.getChapterActions(this.handleChapterActionCallback.bind(this));
       
+      
 
       this.seriesService.getVolumes(this.series.id).subscribe(volumes => {
         this.chapters = volumes.filter(v => v.number === 0).map(v => v.chapters || []).flat().sort(this.utilityService.sortChapters); 
@@ -269,6 +363,11 @@ export class SeriesDetailComponent implements OnInit {
           this.hasNonSpecialVolumeChapters = false;
         }
 
+        // If an update occured and we were on specials, re-activate Volumes/Chapters 
+        if (!this.hasSpecials && this.activeTabId != 2) {
+          this.activeTabId = 2;
+        }
+
         this.isLoading = false;
       });
     }, err => {
@@ -348,16 +447,16 @@ export class SeriesDetailComponent implements OnInit {
     });
   }
 
-  openChapter(chapter: Chapter) {
+  openChapter(chapter: Chapter, incognitoMode = false) {
     if (chapter.pages === 0) {
       this.toastr.error('There are no pages. Kavita was not able to read this archive.');
       return;
     }
 
     if (chapter.files.length > 0 && chapter.files[0].format === MangaFormat.EPUB) {
-      this.router.navigate(['library', this.libraryId, 'series', this.series?.id, 'book', chapter.id]);
+      this.router.navigate(['library', this.libraryId, 'series', this.series?.id, 'book', chapter.id], {queryParams: {incognitoMode}});
     } else {
-      this.router.navigate(['library', this.libraryId, 'series', this.series?.id, 'manga', chapter.id]);
+      this.router.navigate(['library', this.libraryId, 'series', this.series?.id, 'manga', chapter.id], {queryParams: {incognitoMode}});
     }
   }
 
@@ -405,7 +504,6 @@ export class SeriesDetailComponent implements OnInit {
       window.scrollTo(0, 0);
       if (closeResult.success) {
         this.loadSeries(this.series.id);
-        this.loadSeriesMetadata(this.series.id);
         if (closeResult.coverImageUpdate) {
           // Random triggers a load change without any problems with API
           this.seriesImage = this.imageService.randomize(this.imageService.getSeriesCoverImage(this.series.id));
@@ -450,7 +548,6 @@ export class SeriesDetailComponent implements OnInit {
   }
 
   downloadSeries() {
-    
     this.downloadService.downloadSeriesSize(this.series.id).pipe(take(1)).subscribe(async (size) => {
       const wantToDownload = await this.downloadService.confirmSize(size, 'series');
       if (!wantToDownload) { return; }
diff --git a/UI/Web/src/app/shared/_services/download.service.ts b/UI/Web/src/app/shared/_services/download.service.ts
index 0919eb0e7..882d789c8 100644
--- a/UI/Web/src/app/shared/_services/download.service.ts
+++ b/UI/Web/src/app/shared/_services/download.service.ts
@@ -73,7 +73,7 @@ export class DownloadService {
             }));
   }
 
-  async confirmSize(size: number, entityType: 'volume' | 'chapter' | 'series') {
+  async confirmSize(size: number, entityType: 'volume' | 'chapter' | 'series' | 'reading list') {
     return (size < this.SIZE_WARNING || await this.confirmService.confirm('The ' + entityType + '  is ' + this.humanFileSize(size) + '. Are you sure you want to continue?'));
   }
 
@@ -85,6 +85,8 @@ export class DownloadService {
             }));
   }
 
+  
+
   /**
  * Format bytes as human-readable text.
  * 
diff --git a/UI/Web/src/app/shared/_services/utility.service.ts b/UI/Web/src/app/shared/_services/utility.service.ts
index 3c2ed50d5..b66f67cb9 100644
--- a/UI/Web/src/app/shared/_services/utility.service.ts
+++ b/UI/Web/src/app/shared/_services/utility.service.ts
@@ -13,10 +13,19 @@ export enum KEY_CODES {
   SPACE = ' ',
   ENTER = 'Enter',
   G = 'g',
+  B = 'b',
   BACKSPACE = 'Backspace',
-  DELETE = 'Delete'
+  DELETE = 'Delete',
+  SHIFT = 'Shift'
 }
 
+export enum Breakpoint {
+  Mobile = 768,
+  Tablet = 1280,
+  Desktop = 1440
+}
+
+
 @Injectable({
   providedIn: 'root'
 })
@@ -110,4 +119,12 @@ export class UtilityService {
     return d;
   }
 
+  getActiveBreakpoint(): Breakpoint {
+    if (window.innerWidth <= Breakpoint.Mobile) return Breakpoint.Mobile;
+    else if (window.innerWidth > Breakpoint.Mobile && window.innerWidth <= Breakpoint.Tablet) return Breakpoint.Tablet;
+    else if (window.innerWidth > Breakpoint.Tablet) return Breakpoint.Desktop
+    
+    return Breakpoint.Desktop;
+  }
+
 }
diff --git a/UI/Web/src/app/shared/shared.module.ts b/UI/Web/src/app/shared/shared.module.ts
index 790333aa8..246d9363c 100644
--- a/UI/Web/src/app/shared/shared.module.ts
+++ b/UI/Web/src/app/shared/shared.module.ts
@@ -13,7 +13,6 @@ import { ShowIfScrollbarDirective } from './show-if-scrollbar.directive';
 import { A11yClickDirective } from './a11y-click.directive';
 import { SeriesFormatComponent } from './series-format/series-format.component';
 import { UpdateNotificationModalComponent } from './update-notification/update-notification-modal.component';
-import { SAVER, getSaver } from './_providers/saver.provider';
 import { CircularLoaderComponent } from './circular-loader/circular-loader.component';
 import { NgCircleProgressModule } from 'ng-circle-progress';
 
@@ -51,6 +50,5 @@ import { NgCircleProgressModule } from 'ng-circle-progress';
     TagBadgeComponent,
     CircularLoaderComponent,
   ],
-  //providers: [{provide: SAVER, useFactory: getSaver}]
 })
 export class SharedModule { }
diff --git a/UI/Web/src/app/user-settings/user-preferences/user-preferences.component.html b/UI/Web/src/app/user-settings/user-preferences/user-preferences.component.html
index ed5078041..1a1dee3b3 100644
--- a/UI/Web/src/app/user-settings/user-preferences/user-preferences.component.html
+++ b/UI/Web/src/app/user-settings/user-preferences/user-preferences.component.html
@@ -1,6 +1,6 @@
 
            
     
            User Dashboard
            
-    
              
+    
                
         
              • 
             {{ tab.title | titlecase }}
             
@@ -9,8 +9,14 @@
                     These are global settings that are bound to your account. 
                 
                
                 
-                
+                
                         
+                            
+                                
                
+                                  
+                                    
+                                
                
+                                              
                             
                                 
                
                                     
                
@@ -34,6 +40,12 @@
                             
                         
                         
+                            
+                                
                
+                                  
+                                    
+                                
                
+                                              
                             
                                 
                                     
                Manga
                
@@ -130,20 +142,20 @@
                                     
                
                                     
                
                                         
-                                        
+                                        
                
                                     
                
                                     
                
                                          
                                         How much spacing between the lines of the book
                                         How much spacing between the lines of the book
-                                        
+                                        
                
                                     
                
     
                                     
                
                                          
                                         How much spacing on each side of the screen. This will override to 0 on mobile devices regardless of this setting.
                                         How much spacing on each side of the screen. This will override to 0 on mobile devices regardless of this setting.
-                                        
+                                        
                
                                     
                
     
                                     
                
@@ -156,6 +168,12 @@
                     
     
                     
+                        
+                            
                
+                              
+                                
+                            
                
+                                          
                         
                             
                Change your Password