goyomi/sources/base/mangadventure/mangadventure.go

// Package mangadventure implements the MangAdventure Django REST API base.
// API: GET {base}/api/v2/series/, GET {base}/api/v2/chapters/
package mangadventure

import (
	"context"
	"encoding/json"
	"fmt"
	"io"
	"net/http"
	"net/url"
	"strings"

	"goyomi/internal/httpclient"
	"goyomi/internal/source"
	"goyomi/sources/base/util"
)

type Config struct {
	Name    string
	BaseURL string
	Lang    string
}

type seriesDTO struct {
	Slug        string   `json:"slug"`
	Title       string   `json:"title"`
	Description string   `json:"description"`
	Cover       string   `json:"cover"`
	Authors     []string `json:"authors"`
	Artists     []string `json:"artists"`
	Status      string   `json:"status"`
	Categories  []struct{ Name string `json:"name"` } `json:"categories"`
}

type paginator struct {
	Count   int         `json:"count"`
	Last    bool        `json:"last"`
	Results json.RawMessage `json:"results"`
}

type chapterDTO struct {
	ID         int    `json:"id"`
	Slug       string `json:"slug"`
	Title      string `json:"title"`
	Number     float32 `json:"number"`
	Volume     int    `json:"volume"`
	Published  string `json:"published"`
	Series     string `json:"series"`
}

type pageDTO struct {
	Number int    `json:"number"`
	Image  string `json:"image"`
}

type Source struct {
	cfg    Config
	client *httpclient.Client
	id     int64
}

func New(cfg Config) *Source {
	c := httpclient.NewClient(httpclient.WithRateLimit(1, 2))
	return &Source{cfg: cfg, client: c, id: source.GenerateSourceID(cfg.Name, cfg.Lang)}
}

func (s *Source) ID() int64           { return s.id }
func (s *Source) Name() string        { return s.cfg.Name }
func (s *Source) Lang() string        { return s.cfg.Lang }
func (s *Source) SupportsLatest() bool { return true }

func (s *Source) api() string { return strings.TrimRight(s.cfg.BaseURL, "/") + "/api/v2" }

func (s *Source) getJSON(ctx context.Context, rawURL string, out any) error {
	req, err := http.NewRequestWithContext(ctx, http.MethodGet, rawURL, nil)
	if err != nil {
		return err
	}
	resp, err := s.client.Do(req)
	if err != nil {
		return err
	}
	defer resp.Body.Close()
	if resp.StatusCode != http.StatusOK {
		return fmt.Errorf("mangadventure: HTTP %d", resp.StatusCode)
	}
	body, err := io.ReadAll(resp.Body)
	if err != nil {
		return err
	}
	return json.Unmarshal(body, out)
}

func (s *Source) toSManga(d seriesDTO) source.SManga {
	genres := make([]string, len(d.Categories))
	for i, c := range d.Categories {
		genres[i] = c.Name
	}
	return source.SManga{
		URL:          fmt.Sprintf("/api/v2/series/%s/", d.Slug),
		Title:        d.Title,
		Author:       strings.Join(d.Authors, ", "),
		Artist:       strings.Join(d.Artists, ", "),
		Description:  d.Description,
		Genre:        strings.Join(genres, ", "),
		Status:       util.StatusFromString(d.Status),
		ThumbnailURL: d.Cover,
	}
}

func (s *Source) GetPopularManga(page int) (source.MangasPage, error) {
	u, _ := url.Parse(s.api() + "/series/")
	q := u.Query()
	q.Set("page", fmt.Sprintf("%d", page))
	q.Set("sort", "-views")
	u.RawQuery = q.Encode()
	var pg paginator
	if err := s.getJSON(context.Background(), u.String(), &pg); err != nil {
		return source.MangasPage{}, err
	}
	var series []seriesDTO
	if err := json.Unmarshal(pg.Results, &series); err != nil {
		return source.MangasPage{}, err
	}
	mangas := make([]source.SManga, len(series))
	for i, s2 := range series {
		mangas[i] = s.toSManga(s2)
	}
	return source.MangasPage{Mangas: mangas, HasNextPage: !pg.Last}, nil
}

func (s *Source) GetLatestUpdates(page int) (source.MangasPage, error) {
	u, _ := url.Parse(s.api() + "/series/")
	q := u.Query()
	q.Set("page", fmt.Sprintf("%d", page))
	q.Set("sort", "-latest_upload")
	u.RawQuery = q.Encode()
	var pg paginator
	if err := s.getJSON(context.Background(), u.String(), &pg); err != nil {
		return source.MangasPage{}, err
	}
	var series []seriesDTO
	if err := json.Unmarshal(pg.Results, &series); err != nil {
		return source.MangasPage{}, err
	}
	mangas := make([]source.SManga, len(series))
	for i, s2 := range series {
		mangas[i] = s.toSManga(s2)
	}
	return source.MangasPage{Mangas: mangas, HasNextPage: !pg.Last}, nil
}

func (s *Source) GetSearchManga(page int, query string, filters []source.Filter) (source.MangasPage, error) {
	u, _ := url.Parse(s.api() + "/series/")
	q := u.Query()
	q.Set("page", fmt.Sprintf("%d", page))
	q.Set("title", query)
	u.RawQuery = q.Encode()
	var pg paginator
	if err := s.getJSON(context.Background(), u.String(), &pg); err != nil {
		return source.MangasPage{}, err
	}
	var series []seriesDTO
	if err := json.Unmarshal(pg.Results, &series); err != nil {
		return source.MangasPage{}, err
	}
	mangas := make([]source.SManga, len(series))
	for i, s2 := range series {
		mangas[i] = s.toSManga(s2)
	}
	return source.MangasPage{Mangas: mangas, HasNextPage: !pg.Last}, nil
}

func (s *Source) GetMangaDetails(manga source.SManga) (source.SManga, error) {
	slug := util.SlugFromURL(strings.TrimRight(manga.URL, "/"))
	var d seriesDTO
	if err := s.getJSON(context.Background(), s.api()+"/series/"+slug+"/", &d); err != nil {
		return manga, err
	}
	return s.toSManga(d), nil
}

func (s *Source) GetChapterList(manga source.SManga) ([]source.SChapter, error) {
	slug := util.SlugFromURL(strings.TrimRight(manga.URL, "/"))
	apiURL := fmt.Sprintf("%s/chapters/?series=%s&date_format=timestamp", s.api(), slug)
	var pg paginator
	if err := s.getJSON(context.Background(), apiURL, &pg); err != nil {
		return nil, err
	}
	var chapters []chapterDTO
	if err := json.Unmarshal(pg.Results, &chapters); err != nil {
		return nil, err
	}
	result := make([]source.SChapter, len(chapters))
	for i, ch := range chapters {
		name := fmt.Sprintf("Chapter %.1f", ch.Number)
		if ch.Title != "" {
			name += " - " + ch.Title
		}
		result[i] = source.SChapter{
			URL:        fmt.Sprintf("/api/v2/chapters/%d/", ch.ID),
			Name:       name,
			DateUpload: util.ParseAbsoluteDate(ch.Published, "2006-01-02T15:04:05Z"),
		}
	}
	return result, nil
}

func (s *Source) GetPageList(chapter source.SChapter) ([]source.Page, error) {
	chID := util.SlugFromURL(strings.TrimRight(chapter.URL, "/"))
	apiURL := fmt.Sprintf("%s/chapters/%s/pages/", s.api(), chID)
	var pages []pageDTO
	if err := s.getJSON(context.Background(), apiURL, &pages); err != nil {
		return nil, err
	}
	result := make([]source.Page, len(pages))
	for i, p := range pages {
		result[i] = source.Page{Index: p.Number, ImageURL: p.Image}
	}
	return result, nil
}

func (s *Source) GetImageURL(page source.Page) (string, error) { return page.ImageURL, nil }
func (s *Source) GetFilterList() []source.Filter               { return nil }