goyomi/sources/base/hentaihand/hentaihand.go

// Package hentaihand implements the HentaiHand REST API base.
// GET {base}/api/comics?page={n}&order_by=popularity
package hentaihand

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

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

type Config struct {
	Name    string
	BaseURL string
	Lang    string
}

type comicDTO struct {
	ID          int    `json:"id"`
	Slug        string `json:"slug"`
	Title       string `json:"title"`
	CoverURL    string `json:"cover_url"`
	Author      string `json:"author"`
	Description string `json:"description"`
	Status      string `json:"status"`
	Tags        []struct{ Name string `json:"name"` } `json:"tags"`
}

type comicsListDTO struct {
	Data []comicDTO `json:"data"`
	Meta struct {
		CurrentPage int `json:"current_page"`
		LastPage    int `json:"last_page"`
	} `json:"meta"`
}

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) base() string { return strings.TrimRight(s.cfg.BaseURL, "/") }

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
	}
	req.Header.Set("Accept", "application/json")
	resp, err := s.client.Do(req)
	if err != nil {
		return err
	}
	defer resp.Body.Close()
	if resp.StatusCode != http.StatusOK {
		return fmt.Errorf("hentaihand: HTTP %d", resp.StatusCode)
	}
	body, _ := io.ReadAll(resp.Body)
	return json.Unmarshal(body, out)
}

func (s *Source) toSManga(c comicDTO) source.SManga {
	genres := make([]string, len(c.Tags))
	for i, t := range c.Tags {
		genres[i] = t.Name
	}
	return source.SManga{
		URL:          fmt.Sprintf("/comics/%s", c.Slug),
		Title:        c.Title,
		Author:       c.Author,
		Description:  c.Description,
		Genre:        strings.Join(genres, ", "),
		Status:       util.StatusFromString(c.Status),
		ThumbnailURL: c.CoverURL,
	}
}

func (s *Source) fetchComics(ctx context.Context, page int, orderBy, q string) (source.MangasPage, error) {
	u := fmt.Sprintf("%s/api/comics?page=%d&order_by=%s", s.base(), page, orderBy)
	if q != "" {
		u += "&q=" + q
	}
	var result comicsListDTO
	if err := s.getJSON(ctx, u, &result); err != nil {
		return source.MangasPage{}, err
	}
	mangas := make([]source.SManga, len(result.Data))
	for i, c := range result.Data {
		mangas[i] = s.toSManga(c)
	}
	hasNext := result.Meta.CurrentPage < result.Meta.LastPage
	return source.MangasPage{Mangas: mangas, HasNextPage: hasNext}, nil
}

func (s *Source) GetPopularManga(page int) (source.MangasPage, error) {
	return s.fetchComics(context.Background(), page, "popularity", "")
}
func (s *Source) GetLatestUpdates(page int) (source.MangasPage, error) {
	return s.fetchComics(context.Background(), page, "date", "")
}
func (s *Source) GetSearchManga(page int, query string, filters []source.Filter) (source.MangasPage, error) {
	return s.fetchComics(context.Background(), page, "popularity", query)
}

func (s *Source) GetMangaDetails(manga source.SManga) (source.SManga, error) {
	slug := util.SlugFromURL(manga.URL)
	var result comicDTO
	if err := s.getJSON(context.Background(), fmt.Sprintf("%s/api/comics/%s", s.base(), slug), &result); err != nil {
		return manga, err
	}
	return s.toSManga(result), nil
}

func (s *Source) GetChapterList(manga source.SManga) ([]source.SChapter, error) {
	slug := util.SlugFromURL(manga.URL)
	var result struct {
		Data []struct {
			Slug   string  `json:"slug"`
			Number float32 `json:"number"`
			Title  string  `json:"title"`
			Date   string  `json:"date"`
		} `json:"data"`
	}
	if err := s.getJSON(context.Background(), fmt.Sprintf("%s/api/comics/%s/chapters", s.base(), slug), &result); err != nil {
		return nil, err
	}
	chapters := make([]source.SChapter, len(result.Data))
	for i, ch := range result.Data {
		name := fmt.Sprintf("Chapter %.1f", ch.Number)
		if ch.Title != "" {
			name += " - " + ch.Title
		}
		chapters[i] = source.SChapter{
			URL:        fmt.Sprintf("/comics/%s/%s", slug, ch.Slug),
			Name:       name,
			DateUpload: util.ParseAbsoluteDate(ch.Date, "2006-01-02"),
		}
	}
	return chapters, nil
}

func (s *Source) GetPageList(chapter source.SChapter) ([]source.Page, error) {
	parts := strings.Split(strings.Trim(chapter.URL, "/"), "/")
	if len(parts) < 3 {
		return nil, fmt.Errorf("hentaihand: invalid chapter URL")
	}
	slug := parts[1]
	chSlug := parts[2]
	var result struct {
		Images []string `json:"images"`
	}
	if err := s.getJSON(context.Background(), fmt.Sprintf("%s/api/comics/%s/chapters/%s", s.base(), slug, chSlug), &result); err != nil {
		return nil, err
	}
	pages := make([]source.Page, len(result.Images))
	for i, img := range result.Images {
		pages[i] = source.Page{Index: i, ImageURL: img}
	}
	return pages, nil
}

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