mirror of
				https://github.com/Kareadita/Kavita.git
				synced 2025-10-31 18:47:05 -04:00 
			
		
		
		
	* Enhance plugin/authenticate to allow RefreshToken to be returned as well. * When typing a series name, min, or max filter, press enter to apply metadata filter. * Cleaned up the documentation around MaxCount and TotalCount * Fixed a bug where PublicationStatus wasn't being correctly set due to some strange logic I coded. * Fixed bookmark mode not having access to critical page dimensions. Fetching bookmark info api now returns dimensions by default. * Fixed pagination scaling code for different fitting options * Fixed missing code to persist page split in manga reader * Removed unneeded prefetch of blank images in bookmark mode
		
			
				
	
	
		
			792 lines
		
	
	
		
			33 KiB
		
	
	
	
		
			C#
		
	
	
	
	
	
			
		
		
	
	
			792 lines
		
	
	
		
			33 KiB
		
	
	
	
		
			C#
		
	
	
	
	
	
| using System;
 | |
| using System.Collections.Generic;
 | |
| using System.IO;
 | |
| using System.Linq;
 | |
| using System.Threading.Tasks;
 | |
| using API.Constants;
 | |
| using API.Data;
 | |
| using API.Data.Repositories;
 | |
| using API.DTOs;
 | |
| using API.DTOs.Filtering;
 | |
| using API.DTOs.Reader;
 | |
| using API.Entities;
 | |
| using API.Entities.Enums;
 | |
| using API.Extensions;
 | |
| using API.Services;
 | |
| using API.SignalR;
 | |
| using Hangfire;
 | |
| using Microsoft.AspNetCore.Authorization;
 | |
| using Microsoft.AspNetCore.Mvc;
 | |
| using Microsoft.Extensions.Logging;
 | |
| using Microsoft.IdentityModel.Tokens;
 | |
| using MimeTypes;
 | |
| 
 | |
| namespace API.Controllers;
 | |
| 
 | |
| /// <summary>
 | |
| /// For all things regarding reading, mainly focusing on non-Book related entities
 | |
| /// </summary>
 | |
| public class ReaderController : BaseApiController
 | |
| {
 | |
|     private readonly ICacheService _cacheService;
 | |
|     private readonly IUnitOfWork _unitOfWork;
 | |
|     private readonly ILogger<ReaderController> _logger;
 | |
|     private readonly IReaderService _readerService;
 | |
|     private readonly IBookmarkService _bookmarkService;
 | |
|     private readonly IAccountService _accountService;
 | |
|     private readonly IEventHub _eventHub;
 | |
| 
 | |
|     /// <inheritdoc />
 | |
|     public ReaderController(ICacheService cacheService,
 | |
|         IUnitOfWork unitOfWork, ILogger<ReaderController> logger,
 | |
|         IReaderService readerService, IBookmarkService bookmarkService,
 | |
|         IAccountService accountService, IEventHub eventHub)
 | |
|     {
 | |
|         _cacheService = cacheService;
 | |
|         _unitOfWork = unitOfWork;
 | |
|         _logger = logger;
 | |
|         _readerService = readerService;
 | |
|         _bookmarkService = bookmarkService;
 | |
|         _accountService = accountService;
 | |
|         _eventHub = eventHub;
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns the PDF for the chapterId.
 | |
|     /// </summary>
 | |
|     /// <param name="chapterId"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("pdf")]
 | |
|     [ResponseCache(CacheProfileName = ResponseCacheProfiles.Hour, VaryByQueryKeys = new []{"chapterId", "apiKey"})]
 | |
|     public async Task<ActionResult> GetPdf(int chapterId, string apiKey)
 | |
|     {
 | |
|         if (await _unitOfWork.UserRepository.GetUserIdByApiKeyAsync(apiKey) == 0) return BadRequest();
 | |
|         var chapter = await _cacheService.Ensure(chapterId);
 | |
|         if (chapter == null) return BadRequest("There was an issue finding pdf file for reading");
 | |
| 
 | |
|         // Validate the user has access to the PDF
 | |
|         var series = await _unitOfWork.SeriesRepository.GetSeriesForChapter(chapter.Id,
 | |
|             await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()));
 | |
|         if (series == null) return BadRequest("Invalid Access");
 | |
| 
 | |
|         try
 | |
|         {
 | |
| 
 | |
|             var path = _cacheService.GetCachedFile(chapter);
 | |
|             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest($"Pdf doesn't exist when it should.");
 | |
| 
 | |
|             return PhysicalFile(path, "application/pdf", Path.GetFileName(path), true);
 | |
|         }
 | |
|         catch (Exception)
 | |
|         {
 | |
|             _cacheService.CleanupChapters(new []{ chapterId });
 | |
|             throw;
 | |
|         }
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns an image for a given chapter. Will perform bounding checks
 | |
|     /// </summary>
 | |
|     /// <remarks>This will cache the chapter images for reading</remarks>
 | |
|     /// <param name="chapterId">Chapter Id</param>
 | |
|     /// <param name="page">Page in question</param>
 | |
|     /// <param name="apiKey">User's API Key for authentication</param>
 | |
|     /// <param name="extractPdf">Should Kavita extract pdf into images. Defaults to false.</param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("image")]
 | |
|     [ResponseCache(CacheProfileName = ResponseCacheProfiles.Hour, VaryByQueryKeys = new []{"chapterId","page", "extractPdf", "apiKey"})]
 | |
|     [AllowAnonymous]
 | |
|     public async Task<ActionResult> GetImage(int chapterId, int page, string apiKey, bool extractPdf = false)
 | |
|     {
 | |
|         if (page < 0) page = 0;
 | |
|         if (await _unitOfWork.UserRepository.GetUserIdByApiKeyAsync(apiKey) == 0) return BadRequest();
 | |
|         var chapter = await _cacheService.Ensure(chapterId, extractPdf);
 | |
|         if (chapter == null) return BadRequest("There was an issue finding image file for reading");
 | |
| 
 | |
|         try
 | |
|         {
 | |
|             var path = _cacheService.GetCachedPagePath(chapter.Id, page);
 | |
|             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest($"No such image for page {page}. Try refreshing to allow re-cache.");
 | |
|             var format = Path.GetExtension(path);
 | |
| 
 | |
|             return PhysicalFile(path, MimeTypeMap.GetMimeType(format), Path.GetFileName(path), true);
 | |
|         }
 | |
|         catch (Exception)
 | |
|         {
 | |
|             _cacheService.CleanupChapters(new []{ chapterId });
 | |
|             throw;
 | |
|         }
 | |
|     }
 | |
| 
 | |
|     [HttpGet("thumbnail")]
 | |
|     [ResponseCache(CacheProfileName = ResponseCacheProfiles.Hour, VaryByQueryKeys = new []{"chapterId", "pageNum", "apiKey"})]
 | |
|     [AllowAnonymous]
 | |
|     public async Task<ActionResult> GetThumbnail(int chapterId, int pageNum, string apiKey)
 | |
|     {
 | |
|         if (await _unitOfWork.UserRepository.GetUserIdByApiKeyAsync(apiKey) == 0) return BadRequest();
 | |
|         var chapter = await _cacheService.Ensure(chapterId, true);
 | |
|         if (chapter == null) return BadRequest("There was an issue extracting images from chapter");
 | |
|         var images = _cacheService.GetCachedPages(chapterId);
 | |
| 
 | |
|         var path = await _readerService.GetThumbnail(chapter, pageNum, images);
 | |
|         var format = Path.GetExtension(path);
 | |
|         return PhysicalFile(path, MimeTypeMap.GetMimeType(format), Path.GetFileName(path), true);
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns an image for a given bookmark series. Side effect: This will cache the bookmark images for reading.
 | |
|     /// </summary>
 | |
|     /// <param name="seriesId"></param>
 | |
|     /// <param name="apiKey">Api key for the user the bookmarks are on</param>
 | |
|     /// <param name="page"></param>
 | |
|     /// <remarks>We must use api key as bookmarks could be leaked to other users via the API</remarks>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("bookmark-image")]
 | |
|     [ResponseCache(CacheProfileName = ResponseCacheProfiles.Hour, VaryByQueryKeys = new []{"seriesId", "page", "apiKey"})]
 | |
|     [AllowAnonymous]
 | |
|     public async Task<ActionResult> GetBookmarkImage(int seriesId, string apiKey, int page)
 | |
|     {
 | |
|         if (page < 0) page = 0;
 | |
|         var userId = await _unitOfWork.UserRepository.GetUserIdByApiKeyAsync(apiKey);
 | |
|         if (userId == 0) return BadRequest();
 | |
| 
 | |
|         var totalPages = await _cacheService.CacheBookmarkForSeries(userId, seriesId);
 | |
|         if (page > totalPages)
 | |
|         {
 | |
|             page = totalPages;
 | |
|         }
 | |
| 
 | |
|         try
 | |
|         {
 | |
|             var path = _cacheService.GetCachedBookmarkPagePath(seriesId, page);
 | |
|             if (string.IsNullOrEmpty(path) || !System.IO.File.Exists(path)) return BadRequest($"No such image for page {page}");
 | |
|             var format = Path.GetExtension(path);
 | |
| 
 | |
|             return PhysicalFile(path, MimeTypeMap.GetMimeType(format), Path.GetFileName(path));
 | |
|         }
 | |
|         catch (Exception)
 | |
|         {
 | |
|             _cacheService.CleanupBookmarks(new []{ seriesId });
 | |
|             throw;
 | |
|         }
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns the file dimensions for all pages in a chapter. If the underlying chapter is PDF, use extractPDF to unpack as images.
 | |
|     /// </summary>
 | |
|     /// <remarks>This has a side effect of caching the images.
 | |
|     /// This will only be populated on archive filetypes and not in bookmark mode</remarks>
 | |
|     /// <param name="chapterId"></param>
 | |
|     /// <param name="extractPdf"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("file-dimensions")]
 | |
|     [ResponseCache(CacheProfileName = ResponseCacheProfiles.Hour, VaryByQueryKeys = new []{"chapterId", "extractPdf"})]
 | |
|     public async Task<ActionResult<IEnumerable<FileDimensionDto>>> GetFileDimensions(int chapterId, bool extractPdf = false)
 | |
|     {
 | |
|         if (chapterId <= 0) return ArraySegment<FileDimensionDto>.Empty;
 | |
|         var chapter = await _cacheService.Ensure(chapterId, extractPdf);
 | |
|         if (chapter == null) return BadRequest("Could not find Chapter");
 | |
|         return Ok(_cacheService.GetCachedFileDimensions(_cacheService.GetCachePath(chapterId)));
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns various information about a Chapter. Side effect: This will cache the chapter images for reading.
 | |
|     /// </summary>
 | |
|     /// <remarks>This is generally the first call when attempting to read to allow pre-generation of assets needed for reading</remarks>
 | |
|     /// <param name="chapterId"></param>
 | |
|     /// <param name="extractPdf">Should Kavita extract pdf into images. Defaults to false.</param>
 | |
|     /// <param name="includeDimensions">Include file dimensions. Only useful for image based reading</param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("chapter-info")]
 | |
|     [ResponseCache(CacheProfileName = ResponseCacheProfiles.Hour, VaryByQueryKeys = new []{"chapterId", "extractPdf", "includeDimensions"})]
 | |
|     public async Task<ActionResult<ChapterInfoDto>> GetChapterInfo(int chapterId, bool extractPdf = false, bool includeDimensions = false)
 | |
|     {
 | |
|         if (chapterId <= 0) return Ok(null); // This can happen occasionally from UI, we should just ignore
 | |
|         var chapter = await _cacheService.Ensure(chapterId, extractPdf);
 | |
|         if (chapter == null) return BadRequest("Could not find Chapter");
 | |
| 
 | |
|         var dto = await _unitOfWork.ChapterRepository.GetChapterInfoDtoAsync(chapterId);
 | |
|         if (dto == null) return BadRequest("Please perform a scan on this series or library and try again");
 | |
|         var mangaFile = chapter.Files.First();
 | |
| 
 | |
|         var info = new ChapterInfoDto()
 | |
|         {
 | |
|             ChapterNumber = dto.ChapterNumber,
 | |
|             VolumeNumber = dto.VolumeNumber,
 | |
|             VolumeId = dto.VolumeId,
 | |
|             FileName = Path.GetFileName(mangaFile.FilePath),
 | |
|             SeriesName = dto.SeriesName,
 | |
|             SeriesFormat = dto.SeriesFormat,
 | |
|             SeriesId = dto.SeriesId,
 | |
|             LibraryId = dto.LibraryId,
 | |
|             IsSpecial = dto.IsSpecial,
 | |
|             Pages = dto.Pages,
 | |
|             ChapterTitle = dto.ChapterTitle ?? string.Empty,
 | |
|             Subtitle = string.Empty,
 | |
|             Title = dto.SeriesName,
 | |
|         };
 | |
| 
 | |
|         if (includeDimensions)
 | |
|         {
 | |
|             info.PageDimensions = _cacheService.GetCachedFileDimensions(_cacheService.GetCachePath(chapterId));
 | |
|             info.DoublePairs = _readerService.GetPairs(info.PageDimensions);
 | |
|         }
 | |
| 
 | |
|         if (info.ChapterTitle is {Length: > 0}) {
 | |
|             info.Title += " - " + info.ChapterTitle;
 | |
|         }
 | |
| 
 | |
|         if (info.IsSpecial && dto.VolumeNumber.Equals(Services.Tasks.Scanner.Parser.Parser.DefaultVolume))
 | |
|         {
 | |
|             info.Subtitle = info.FileName;
 | |
|         } else if (!info.IsSpecial && info.VolumeNumber.Equals(Services.Tasks.Scanner.Parser.Parser.DefaultVolume))
 | |
|         {
 | |
|             info.Subtitle = ReaderService.FormatChapterName(info.LibraryType, true, true) + info.ChapterNumber;
 | |
|         }
 | |
|         else
 | |
|         {
 | |
|             info.Subtitle = "Volume " + info.VolumeNumber;
 | |
|             if (!info.ChapterNumber.Equals(Services.Tasks.Scanner.Parser.Parser.DefaultChapter))
 | |
|             {
 | |
|                 info.Subtitle += " " + ReaderService.FormatChapterName(info.LibraryType, true, true) +
 | |
|                                  info.ChapterNumber;
 | |
|             }
 | |
|         }
 | |
| 
 | |
|         return Ok(info);
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns various information about all bookmark files for a Series. Side effect: This will cache the bookmark images for reading.
 | |
|     /// </summary>
 | |
|     /// <param name="seriesId">Series Id for all bookmarks</param>
 | |
|     /// <param name="includeDimensions">Include file dimensions (extra I/O). Defaults to true.</param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("bookmark-info")]
 | |
|     [ResponseCache(CacheProfileName = ResponseCacheProfiles.Hour, VaryByQueryKeys = new []{"seriesId", "includeDimensions"})]
 | |
|     public async Task<ActionResult<BookmarkInfoDto>> GetBookmarkInfo(int seriesId, bool includeDimensions = true)
 | |
|     {
 | |
|         var totalPages = await _cacheService.CacheBookmarkForSeries(User.GetUserId(), seriesId);
 | |
|         var series = await _unitOfWork.SeriesRepository.GetSeriesByIdAsync(seriesId, SeriesIncludes.None);
 | |
| 
 | |
|         var info = new BookmarkInfoDto()
 | |
|         {
 | |
|             SeriesName = series!.Name,
 | |
|             SeriesFormat = series.Format,
 | |
|             SeriesId = series.Id,
 | |
|             LibraryId = series.LibraryId,
 | |
|             Pages = totalPages,
 | |
|         };
 | |
| 
 | |
|         if (includeDimensions)
 | |
|         {
 | |
|             info.PageDimensions = _cacheService.GetCachedFileDimensions(_cacheService.GetBookmarkCachePath(seriesId));
 | |
|             info.DoublePairs = _readerService.GetPairs(info.PageDimensions);
 | |
|         }
 | |
| 
 | |
|         return Ok(info);
 | |
|     }
 | |
| 
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Marks a Series as read. All volumes and chapters will be marked as read during this process.
 | |
|     /// </summary>
 | |
|     /// <param name="markReadDto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("mark-read")]
 | |
|     public async Task<ActionResult> MarkRead(MarkReadDto markReadDto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress);
 | |
|         if (user == null) return Unauthorized();
 | |
|         await _readerService.MarkSeriesAsRead(user, markReadDto.SeriesId);
 | |
| 
 | |
|         if (!await _unitOfWork.CommitAsync()) return BadRequest("There was an issue saving progress");
 | |
| 
 | |
|         return Ok();
 | |
|     }
 | |
| 
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Marks a Series as Unread. All volumes and chapters will be marked as unread during this process.
 | |
|     /// </summary>
 | |
|     /// <param name="markReadDto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("mark-unread")]
 | |
|     public async Task<ActionResult> MarkUnread(MarkReadDto markReadDto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress);
 | |
|         if (user == null) return Unauthorized();
 | |
|         await _readerService.MarkSeriesAsUnread(user, markReadDto.SeriesId);
 | |
| 
 | |
|         if (!await _unitOfWork.CommitAsync()) return BadRequest("There was an issue saving progress");
 | |
| 
 | |
|         return Ok();
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Marks all chapters within a volume as unread
 | |
|     /// </summary>
 | |
|     /// <param name="markVolumeReadDto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("mark-volume-unread")]
 | |
|     public async Task<ActionResult> MarkVolumeAsUnread(MarkVolumeReadDto markVolumeReadDto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress);
 | |
|         if (user == null) return Unauthorized();
 | |
| 
 | |
|         var chapters = await _unitOfWork.ChapterRepository.GetChaptersAsync(markVolumeReadDto.VolumeId);
 | |
|         await _readerService.MarkChaptersAsUnread(user, markVolumeReadDto.SeriesId, chapters);
 | |
| 
 | |
|         if (await _unitOfWork.CommitAsync())
 | |
|         {
 | |
|             return Ok();
 | |
|         }
 | |
| 
 | |
|         return BadRequest("Could not save progress");
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Marks all chapters within a volume as Read
 | |
|     /// </summary>
 | |
|     /// <param name="markVolumeReadDto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("mark-volume-read")]
 | |
|     public async Task<ActionResult> MarkVolumeAsRead(MarkVolumeReadDto markVolumeReadDto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress);
 | |
| 
 | |
|         var chapters = await _unitOfWork.ChapterRepository.GetChaptersAsync(markVolumeReadDto.VolumeId);
 | |
|         if (user == null) return Unauthorized();
 | |
|         await _readerService.MarkChaptersAsRead(user, markVolumeReadDto.SeriesId, chapters);
 | |
|         await _eventHub.SendMessageAsync(MessageFactory.UserProgressUpdate,
 | |
|             MessageFactory.UserProgressUpdateEvent(user.Id, user.UserName!, markVolumeReadDto.SeriesId,
 | |
|                 markVolumeReadDto.VolumeId, 0, chapters.Sum(c => c.Pages)));
 | |
| 
 | |
|         if (await _unitOfWork.CommitAsync())
 | |
|         {
 | |
|             return Ok();
 | |
|         }
 | |
| 
 | |
|         return BadRequest("Could not save progress");
 | |
|     }
 | |
| 
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Marks all chapters within a list of volumes as Read. All volumes must belong to the same Series.
 | |
|     /// </summary>
 | |
|     /// <param name="dto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("mark-multiple-read")]
 | |
|     public async Task<ActionResult> MarkMultipleAsRead(MarkVolumesReadDto dto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress);
 | |
|         if (user == null) return Unauthorized();
 | |
|         user.Progresses ??= new List<AppUserProgress>();
 | |
| 
 | |
|         var chapterIds = await _unitOfWork.VolumeRepository.GetChapterIdsByVolumeIds(dto.VolumeIds);
 | |
|         foreach (var chapterId in dto.ChapterIds)
 | |
|         {
 | |
|             chapterIds.Add(chapterId);
 | |
|         }
 | |
|         var chapters = await _unitOfWork.ChapterRepository.GetChaptersByIdsAsync(chapterIds);
 | |
|         await _readerService.MarkChaptersAsRead(user, dto.SeriesId, chapters.ToList());
 | |
| 
 | |
|         if (await _unitOfWork.CommitAsync())
 | |
|         {
 | |
|             return Ok();
 | |
|         }
 | |
| 
 | |
| 
 | |
|         return BadRequest("Could not save progress");
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Marks all chapters within a list of volumes as Unread. All volumes must belong to the same Series.
 | |
|     /// </summary>
 | |
|     /// <param name="dto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("mark-multiple-unread")]
 | |
|     public async Task<ActionResult> MarkMultipleAsUnread(MarkVolumesReadDto dto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress);
 | |
|         if (user == null) return Unauthorized();
 | |
|         user.Progresses ??= new List<AppUserProgress>();
 | |
| 
 | |
|         var chapterIds = await _unitOfWork.VolumeRepository.GetChapterIdsByVolumeIds(dto.VolumeIds);
 | |
|         foreach (var chapterId in dto.ChapterIds)
 | |
|         {
 | |
|             chapterIds.Add(chapterId);
 | |
|         }
 | |
|         var chapters = await _unitOfWork.ChapterRepository.GetChaptersByIdsAsync(chapterIds);
 | |
|         await _readerService.MarkChaptersAsUnread(user, dto.SeriesId, chapters.ToList());
 | |
| 
 | |
|         if (await _unitOfWork.CommitAsync())
 | |
|         {
 | |
|             return Ok();
 | |
|         }
 | |
| 
 | |
|         return BadRequest("Could not save progress");
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Marks all chapters within a list of series as Read.
 | |
|     /// </summary>
 | |
|     /// <param name="dto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("mark-multiple-series-read")]
 | |
|     public async Task<ActionResult> MarkMultipleSeriesAsRead(MarkMultipleSeriesAsReadDto dto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress);
 | |
|         if (user == null) return Unauthorized();
 | |
|         user.Progresses ??= new List<AppUserProgress>();
 | |
| 
 | |
|         var volumes = await _unitOfWork.VolumeRepository.GetVolumesForSeriesAsync(dto.SeriesIds.ToArray(), true);
 | |
|         foreach (var volume in volumes)
 | |
|         {
 | |
|             await _readerService.MarkChaptersAsRead(user, volume.SeriesId, volume.Chapters);
 | |
|         }
 | |
| 
 | |
|         if (await _unitOfWork.CommitAsync())
 | |
|         {
 | |
|             return Ok();
 | |
|         }
 | |
| 
 | |
|         return BadRequest("Could not save progress");
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Marks all chapters within a list of series as Unread.
 | |
|     /// </summary>
 | |
|     /// <param name="dto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("mark-multiple-series-unread")]
 | |
|     public async Task<ActionResult> MarkMultipleSeriesAsUnread(MarkMultipleSeriesAsReadDto dto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Progress);
 | |
|         if (user == null) return Unauthorized();
 | |
|         user.Progresses ??= new List<AppUserProgress>();
 | |
| 
 | |
|         var volumes = await _unitOfWork.VolumeRepository.GetVolumesForSeriesAsync(dto.SeriesIds.ToArray(), true);
 | |
|         foreach (var volume in volumes)
 | |
|         {
 | |
|             await _readerService.MarkChaptersAsUnread(user, volume.SeriesId, volume.Chapters);
 | |
|         }
 | |
| 
 | |
|         if (await _unitOfWork.CommitAsync())
 | |
|         {
 | |
|             return Ok();
 | |
|         }
 | |
| 
 | |
|         return BadRequest("Could not save progress");
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns Progress (page number) for a chapter for the logged in user
 | |
|     /// </summary>
 | |
|     /// <param name="chapterId"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("get-progress")]
 | |
|     public async Task<ActionResult<ProgressDto>> GetProgress(int chapterId)
 | |
|     {
 | |
|         var progress = await _unitOfWork.AppUserProgressRepository.GetUserProgressDtoAsync(chapterId, User.GetUserId());
 | |
|         if (progress == null) return Ok(new ProgressDto()
 | |
|         {
 | |
|             PageNum = 0,
 | |
|             ChapterId = chapterId,
 | |
|             VolumeId = 0,
 | |
|             SeriesId = 0
 | |
|         });
 | |
|         return Ok(progress);
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Save page against Chapter for logged in user
 | |
|     /// </summary>
 | |
|     /// <param name="progressDto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("progress")]
 | |
|     public async Task<ActionResult> BookmarkProgress(ProgressDto progressDto)
 | |
|     {
 | |
|         if (await _readerService.SaveReadingProgress(progressDto, User.GetUserId())) return Ok(true);
 | |
| 
 | |
|         return BadRequest("Could not save progress");
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Continue point is the chapter which you should start reading again from. If there is no progress on a series, then the first chapter will be returned (non-special unless only specials).
 | |
|     /// Otherwise, loop through the chapters and volumes in order to find the next chapter which has progress.
 | |
|     /// </summary>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("continue-point")]
 | |
|     public async Task<ActionResult<ChapterDto>> GetContinuePoint(int seriesId)
 | |
|     {
 | |
|         var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername());
 | |
| 
 | |
|         return Ok(await _readerService.GetContinuePoint(seriesId, userId));
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns if the user has reading progress on the Series
 | |
|     /// </summary>
 | |
|     /// <param name="seriesId"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("has-progress")]
 | |
|     public async Task<ActionResult<bool>> HasProgress(int seriesId)
 | |
|     {
 | |
|         var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername());
 | |
|         return Ok(await _unitOfWork.AppUserProgressRepository.HasAnyProgressOnSeriesAsync(seriesId, userId));
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns a list of bookmarked pages for a given Chapter
 | |
|     /// </summary>
 | |
|     /// <param name="chapterId"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("chapter-bookmarks")]
 | |
|     public async Task<ActionResult<IEnumerable<BookmarkDto>>> GetBookmarks(int chapterId)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks);
 | |
|         if (user == null) return Unauthorized();
 | |
|         if (user.Bookmarks == null) return Ok(Array.Empty<BookmarkDto>());
 | |
|         return Ok(await _unitOfWork.UserRepository.GetBookmarkDtosForChapter(user.Id, chapterId));
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns a list of all bookmarked pages for a User
 | |
|     /// </summary>
 | |
|     /// <param name="filterDto">Only supports SeriesNameQuery</param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("all-bookmarks")]
 | |
|     public async Task<ActionResult<IEnumerable<BookmarkDto>>> GetAllBookmarks(FilterDto filterDto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks);
 | |
|         if (user == null) return Unauthorized();
 | |
|         if (user.Bookmarks == null) return Ok(Array.Empty<BookmarkDto>());
 | |
| 
 | |
|         return Ok(await _unitOfWork.UserRepository.GetAllBookmarkDtos(user.Id, filterDto));
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Removes all bookmarks for all chapters linked to a Series
 | |
|     /// </summary>
 | |
|     /// <param name="dto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("remove-bookmarks")]
 | |
|     public async Task<ActionResult> RemoveBookmarks(RemoveBookmarkForSeriesDto dto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks);
 | |
|         if (user == null) return Unauthorized();
 | |
|         if (user.Bookmarks == null) return Ok("Nothing to remove");
 | |
| 
 | |
|         try
 | |
|         {
 | |
|             var bookmarksToRemove = user.Bookmarks.Where(bmk => bmk.SeriesId == dto.SeriesId).ToList();
 | |
|             user.Bookmarks = user.Bookmarks.Where(bmk => bmk.SeriesId != dto.SeriesId).ToList();
 | |
|             _unitOfWork.UserRepository.Update(user);
 | |
| 
 | |
|             if (!_unitOfWork.HasChanges() || await _unitOfWork.CommitAsync())
 | |
|             {
 | |
|                 try
 | |
|                 {
 | |
|                     await _bookmarkService.DeleteBookmarkFiles(bookmarksToRemove);
 | |
|                 }
 | |
|                 catch (Exception ex)
 | |
|                 {
 | |
|                     _logger.LogError(ex, "There was an issue cleaning up old bookmarks");
 | |
|                 }
 | |
|                 return Ok();
 | |
|             }
 | |
|         }
 | |
|         catch (Exception ex)
 | |
|         {
 | |
|             _logger.LogError(ex, "There was an exception when trying to clear bookmarks");
 | |
|             await _unitOfWork.RollbackAsync();
 | |
|         }
 | |
| 
 | |
|         return BadRequest("Could not clear bookmarks");
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Removes all bookmarks for all chapters linked to a Series
 | |
|     /// </summary>
 | |
|     /// <param name="dto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("bulk-remove-bookmarks")]
 | |
|     public async Task<ActionResult> BulkRemoveBookmarks(BulkRemoveBookmarkForSeriesDto dto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks);
 | |
|         if (user == null) return Unauthorized();
 | |
|         if (user.Bookmarks == null) return Ok("Nothing to remove");
 | |
| 
 | |
|         try
 | |
|         {
 | |
|             foreach (var seriesId in dto.SeriesIds)
 | |
|             {
 | |
|                 var bookmarksToRemove = user.Bookmarks.Where(bmk => bmk.SeriesId == seriesId).ToList();
 | |
|                 user.Bookmarks = user.Bookmarks.Where(bmk => bmk.SeriesId != seriesId).ToList();
 | |
|                 _unitOfWork.UserRepository.Update(user);
 | |
|                 await _bookmarkService.DeleteBookmarkFiles(bookmarksToRemove);
 | |
|             }
 | |
| 
 | |
| 
 | |
|             if (!_unitOfWork.HasChanges() || await _unitOfWork.CommitAsync())
 | |
|             {
 | |
|                 return Ok();
 | |
|             }
 | |
|         }
 | |
|         catch (Exception ex)
 | |
|         {
 | |
|             _logger.LogError(ex, "There was an exception when trying to clear bookmarks");
 | |
|             await _unitOfWork.RollbackAsync();
 | |
|         }
 | |
| 
 | |
|         return BadRequest("Could not clear bookmarks");
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns all bookmarked pages for a given volume
 | |
|     /// </summary>
 | |
|     /// <param name="volumeId"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("volume-bookmarks")]
 | |
|     public async Task<ActionResult<IEnumerable<BookmarkDto>>> GetBookmarksForVolume(int volumeId)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks);
 | |
|         if (user == null) return Unauthorized();
 | |
|         if (user.Bookmarks == null) return Ok(Array.Empty<BookmarkDto>());
 | |
|         return Ok(await _unitOfWork.UserRepository.GetBookmarkDtosForVolume(user.Id, volumeId));
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns all bookmarked pages for a given series
 | |
|     /// </summary>
 | |
|     /// <param name="seriesId"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("series-bookmarks")]
 | |
|     public async Task<ActionResult<IEnumerable<BookmarkDto>>> GetBookmarksForSeries(int seriesId)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks);
 | |
|         if (user == null) return Unauthorized();
 | |
|         if (user.Bookmarks == null) return Ok(Array.Empty<BookmarkDto>());
 | |
| 
 | |
|         return Ok(await _unitOfWork.UserRepository.GetBookmarkDtosForSeries(user.Id, seriesId));
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Bookmarks a page against a Chapter
 | |
|     /// </summary>
 | |
|     /// <remarks>This has a side effect of caching the chapter files to disk</remarks>
 | |
|     /// <param name="bookmarkDto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("bookmark")]
 | |
|     public async Task<ActionResult> BookmarkPage(BookmarkDto bookmarkDto)
 | |
|     {
 | |
|         // Don't let user save past total pages.
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks);
 | |
|         if (user == null) return new UnauthorizedResult();
 | |
| 
 | |
|         if (!await _accountService.HasBookmarkPermission(user))
 | |
|             return BadRequest("You do not have permission to bookmark");
 | |
| 
 | |
|         var chapter = await _cacheService.Ensure(bookmarkDto.ChapterId);
 | |
|         if (chapter == null) return BadRequest("Could not find cached image. Reload and try again.");
 | |
| 
 | |
|         bookmarkDto.Page = _readerService.CapPageToChapter(chapter, bookmarkDto.Page);
 | |
|         var path = _cacheService.GetCachedPagePath(chapter.Id, bookmarkDto.Page);
 | |
| 
 | |
|         if (!await _bookmarkService.BookmarkPage(user, bookmarkDto, path)) return BadRequest("Could not save bookmark");
 | |
| 
 | |
|         BackgroundJob.Enqueue(() => _cacheService.CleanupBookmarkCache(bookmarkDto.SeriesId));
 | |
|         return Ok();
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Removes a bookmarked page for a Chapter
 | |
|     /// </summary>
 | |
|     /// <param name="bookmarkDto"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpPost("unbookmark")]
 | |
|     public async Task<ActionResult> UnBookmarkPage(BookmarkDto bookmarkDto)
 | |
|     {
 | |
|         var user = await _unitOfWork.UserRepository.GetUserByUsernameAsync(User.GetUsername(), AppUserIncludes.Bookmarks);
 | |
|         if (user == null) return new UnauthorizedResult();
 | |
|         if (user.Bookmarks.IsNullOrEmpty()) return Ok();
 | |
| 
 | |
|         if (!await _accountService.HasBookmarkPermission(user))
 | |
|             return BadRequest("You do not have permission to unbookmark");
 | |
| 
 | |
|         if (!await _bookmarkService.RemoveBookmarkPage(user, bookmarkDto))
 | |
|             return BadRequest("Could not remove bookmark");
 | |
|         BackgroundJob.Enqueue(() => _cacheService.CleanupBookmarkCache(bookmarkDto.SeriesId));
 | |
|         return Ok();
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns the next logical chapter from the series.
 | |
|     /// </summary>
 | |
|     /// <example>
 | |
|     /// V1 → V2 → V3 chapter 0 → V3 chapter 10 → SP 01 → SP 02
 | |
|     /// </example>
 | |
|     /// <param name="seriesId"></param>
 | |
|     /// <param name="volumeId"></param>
 | |
|     /// <param name="currentChapterId"></param>
 | |
|     /// <returns>chapter id for next manga</returns>
 | |
|     [ResponseCache(CacheProfileName = "Hour", VaryByQueryKeys = new [] { "seriesId", "volumeId", "currentChapterId"})]
 | |
|     [HttpGet("next-chapter")]
 | |
|     public async Task<ActionResult<int>> GetNextChapter(int seriesId, int volumeId, int currentChapterId)
 | |
|     {
 | |
|         var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername());
 | |
|         return await _readerService.GetNextChapterIdAsync(seriesId, volumeId, currentChapterId, userId);
 | |
|     }
 | |
| 
 | |
| 
 | |
|     /// <summary>
 | |
|     /// Returns the previous logical chapter from the series.
 | |
|     /// </summary>
 | |
|     /// <example>
 | |
|     /// V1 ← V2 ← V3 chapter 0 ← V3 chapter 10 ← SP 01 ← SP 02
 | |
|     /// </example>
 | |
|     /// <param name="seriesId"></param>
 | |
|     /// <param name="volumeId"></param>
 | |
|     /// <param name="currentChapterId"></param>
 | |
|     /// <returns>chapter id for next manga</returns>
 | |
|     [ResponseCache(CacheProfileName = "Hour", VaryByQueryKeys = new [] { "seriesId", "volumeId", "currentChapterId"})]
 | |
|     [HttpGet("prev-chapter")]
 | |
|     public async Task<ActionResult<int>> GetPreviousChapter(int seriesId, int volumeId, int currentChapterId)
 | |
|     {
 | |
|         var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername());
 | |
|         return await _readerService.GetPrevChapterIdAsync(seriesId, volumeId, currentChapterId, userId);
 | |
|     }
 | |
| 
 | |
|     /// <summary>
 | |
|     /// For the current user, returns an estimate on how long it would take to finish reading the series.
 | |
|     /// </summary>
 | |
|     /// <remarks>For Epubs, this does not check words inside a chapter due to overhead so may not work in all cases.</remarks>
 | |
|     /// <param name="seriesId"></param>
 | |
|     /// <returns></returns>
 | |
|     [HttpGet("time-left")]
 | |
|     [ResponseCache(CacheProfileName = "Hour", VaryByQueryKeys = new [] { "seriesId"})]
 | |
|     public async Task<ActionResult<HourEstimateRangeDto>> GetEstimateToCompletion(int seriesId)
 | |
|     {
 | |
|         var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername());
 | |
|         var series = await _unitOfWork.SeriesRepository.GetSeriesDtoByIdAsync(seriesId, userId);
 | |
| 
 | |
|         // Get all sum of all chapters with progress that is complete then subtract from series. Multiply by modifiers
 | |
|         var progress = await _unitOfWork.AppUserProgressRepository.GetUserProgressForSeriesAsync(seriesId, userId);
 | |
|         if (series.Format == MangaFormat.Epub)
 | |
|         {
 | |
|             var chapters =
 | |
|                 await _unitOfWork.ChapterRepository.GetChaptersByIdsAsync(progress.Select(p => p.ChapterId).ToList());
 | |
|             // Word count
 | |
|             var progressCount = chapters.Sum(c => c.WordCount);
 | |
|             var wordsLeft = series.WordCount - progressCount;
 | |
|             return _readerService.GetTimeEstimate(wordsLeft, 0, true);
 | |
|         }
 | |
| 
 | |
|         var progressPageCount = progress.Sum(p => p.PagesRead);
 | |
|         var pagesLeft = series.Pages - progressPageCount;
 | |
|         return _readerService.GetTimeEstimate(0, pagesLeft, false);
 | |
|     }
 | |
| 
 | |
| }
 |