using System; using System.Collections.Generic; using System.Globalization; using System.Linq; using System.Threading.Tasks; using API.Constants; using API.Data; using API.DTOs; using API.DTOs.Filtering; using API.DTOs.Metadata; using API.Entities.Enums; using API.Extensions; using Kavita.Common.Extensions; using Microsoft.AspNetCore.Mvc; namespace API.Controllers; public class MetadataController : BaseApiController { private readonly IUnitOfWork _unitOfWork; public MetadataController(IUnitOfWork unitOfWork) { _unitOfWork = unitOfWork; } /// /// Fetches genres from the instance /// /// String separated libraryIds or null for all genres /// [HttpGet("genres")] public async Task>> GetAllGenres(string? libraryIds) { var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); var ids = libraryIds?.Split(",").Select(int.Parse).ToList(); if (ids != null && ids.Count > 0) { return Ok(await _unitOfWork.GenreRepository.GetAllGenreDtosForLibrariesAsync(ids, userId)); } return Ok(await _unitOfWork.GenreRepository.GetAllGenreDtosAsync(userId)); } /// /// Fetches people from the instance /// /// String separated libraryIds or null for all people /// [HttpGet("people")] public async Task>> GetAllPeople(string? libraryIds) { var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); var ids = libraryIds?.Split(",").Select(int.Parse).ToList(); if (ids != null && ids.Count > 0) { return Ok(await _unitOfWork.PersonRepository.GetAllPeopleDtosForLibrariesAsync(ids, userId)); } return Ok(await _unitOfWork.PersonRepository.GetAllPersonDtosAsync(userId)); } /// /// Fetches all tags from the instance /// /// String separated libraryIds or null for all tags /// [HttpGet("tags")] public async Task>> GetAllTags(string? libraryIds) { var userId = await _unitOfWork.UserRepository.GetUserIdByUsernameAsync(User.GetUsername()); var ids = libraryIds?.Split(",").Select(int.Parse).ToList(); if (ids != null && ids.Count > 0) { return Ok(await _unitOfWork.TagRepository.GetAllTagDtosForLibrariesAsync(ids, userId)); } return Ok(await _unitOfWork.TagRepository.GetAllTagDtosAsync(userId)); } /// /// Fetches all age ratings from the instance /// /// String separated libraryIds or null for all ratings /// This API is cached for 1 hour, varying by libraryIds /// [ResponseCache(CacheProfileName = ResponseCacheProfiles.FiveMinute, VaryByQueryKeys = new [] {"libraryIds"})] [HttpGet("age-ratings")] public async Task>> GetAllAgeRatings(string? libraryIds) { var ids = libraryIds?.Split(",").Select(int.Parse).ToList(); if (ids != null && ids.Count > 0) { return Ok(await _unitOfWork.LibraryRepository.GetAllAgeRatingsDtosForLibrariesAsync(ids)); } return Ok(Enum.GetValues().Select(t => new AgeRatingDto() { Title = t.ToDescription(), Value = t }).Where(r => r.Value > AgeRating.NotApplicable)); } /// /// Fetches all publication status' from the instance /// /// String separated libraryIds or null for all publication status /// This API is cached for 1 hour, varying by libraryIds /// [ResponseCache(CacheProfileName = ResponseCacheProfiles.FiveMinute, VaryByQueryKeys = new [] {"libraryIds"})] [HttpGet("publication-status")] public ActionResult> GetAllPublicationStatus(string? libraryIds) { var ids = libraryIds?.Split(",").Select(int.Parse).ToList(); if (ids is {Count: > 0}) { return Ok(_unitOfWork.LibraryRepository.GetAllPublicationStatusesDtosForLibrariesAsync(ids)); } return Ok(Enum.GetValues().Select(t => new PublicationStatusDto() { Title = t.ToDescription(), Value = t }).OrderBy(t => t.Title)); } /// /// Fetches all age languages from the libraries passed (or if none passed, all in the server) /// /// This does not perform RBS for the user if they have Library access due to the non-sensitive nature of languages /// String separated libraryIds or null for all ratings /// [HttpGet("languages")] public async Task>> GetAllLanguages(string? libraryIds) { var ids = libraryIds?.Split(",").Select(int.Parse).ToList(); if (ids is {Count: > 0}) { return Ok(await _unitOfWork.LibraryRepository.GetAllLanguagesForLibrariesAsync(ids)); } return Ok(await _unitOfWork.LibraryRepository.GetAllLanguagesForLibrariesAsync()); } [HttpGet("all-languages")] public IEnumerable GetAllValidLanguages() { return CultureInfo.GetCultures(CultureTypes.AllCultures).Select(c => new LanguageDto() { Title = c.DisplayName, IsoCode = c.IetfLanguageTag }).Where(l => !string.IsNullOrEmpty(l.IsoCode)); } /// /// Returns summary for the chapter /// /// /// [HttpGet("chapter-summary")] public async Task> GetChapterSummary(int chapterId) { if (chapterId <= 0) return BadRequest("Chapter does not exist"); var chapter = await _unitOfWork.ChapterRepository.GetChapterAsync(chapterId); if (chapter == null) return BadRequest("Chapter does not exist"); return Ok(chapter.Summary); } }