# MangaService

Access manga workflows through `anilist.manga`.

```typescript
import { Anilist } from "@api-wrappers/anilist-wrapper";

const anilist = new Anilist();
```

## Methods

| Method | Auth | Returns |
| --- | --- | --- |
| `getMangaById(id)` | No | `Media` |
| `getMangaByTitle(title, page?, perPage?)` | No | `Page.media` |
| `getMangaBySearch(search, page?, perPage?)` | No | `Page.media` |
| `getMangaTrending(page?, perPage?)` | No | `Page.media` |
| `getMangaPopular(page?, perPage?)` | No | `Page.media` |
| `getMangaListByGenre(genre, page?, perPage?)` | No | `Page.media` |
| `browseManga(filters?, page?, perPage?)` | No | `Page.media` |
| `getMangaRecommendations(mediaId)` | No | `Media.recommendations` |
| `getMangaRelations(mediaId)` | No | `Media.relations` |
| `getMangaCharacters(mediaId)` | No | `Media.characters` |
| `getMangaStaff(mediaId)` | No | `Media.staff` |
| `toggleFavorite(mangaId)` | Yes | `ToggleFavourite` |
| `toggleFavourite(mangaId)` | Yes | `ToggleFavourite` |

Selected calls use normalized roots: `media` for manga detail/sub-resource
methods, `page` for paginated methods, and `favorites` for favorite mutations.
See the [selection migration guide](../selection-migration.md).

## Lookup And Search

```typescript
const berserk = await anilist.manga.getMangaByTitle("Berserk");
const firstMatch = berserk.Page?.media?.[0];

console.log(firstMatch?.id);
console.log(firstMatch?.title?.userPreferred);
```

```typescript
const search = await anilist.manga.getMangaBySearch("Witch Hat Atelier", 1, 5);

for (const media of search.Page?.media ?? []) {
	console.log(media?.title?.userPreferred, media?.chapters);
}
```

## Browse

`browseManga` mirrors `anime.browseAnime` with genre, format, status, and start
date filters, sorted by popularity and excluding adult entries.

```typescript
import { MediaFormat, MediaStatus } from "@api-wrappers/anilist-wrapper";

const ongoing = await anilist.manga.browseManga(
	{ status: MediaStatus.Releasing, format: MediaFormat.Manga },
	1,
	10,
);

for (const media of ongoing.Page?.media ?? []) {
	console.log(media?.title?.userPreferred, media?.chapters);
}
```

AniList has no seasonal manga, so there is no `getSeasonalManga`; use
`browseManga` with `startDate` instead.

## Pagination

The list methods accept an optional `page` and `perPage`. Leave them off and you
get the first page. The per-page default is not the same for every call: search
and genre lookups return 10, while trending and popular return 20.

| Method | `page` default | `perPage` default |
| --- | --- | --- |
| `getMangaBySearch` | `1` | `10` |
| `getMangaTrending` | `1` | `20` |
| `getMangaPopular` | `1` | `20` |
| `getMangaListByGenre` | `1` | `10` |
| `getMangaByTitle` | `1` | `1` |

Pass both values when you want a specific window of results:

```typescript
// second page, 15 results per page
const page2 = await anilist.manga.getMangaTrending(2, 15);

for (const media of page2.Page?.media ?? []) {
	console.log(media?.title?.userPreferred, media?.chapters);
}
```

AniList caps `perPage` at 50. Passing a larger value throws a `TypeError`
naming the limit, so requests fail before they reach the API.

AniList responses are nullable at every level, from the `Page` down to each
entry in `media`. Guard with optional chaining and default to an empty array
before looping, as the example does with `?? []`.

### Collecting every page

Use `collectPages` to gather all items sequentially. It stops when
`pageInfo.hasNextPage` is not `true` and propagates errors (including
`RateLimitError`) untouched.

```typescript
import { collectPages } from "@api-wrappers/anilist-wrapper";

const media = await collectPages(
	(page) => anilist.manga.getMangaBySearch("Berserk", page, 50),
	(response) => ({
		pageInfo: response.Page?.pageInfo,
		items: response.Page?.media,
	}),
);

console.log(media.length);
```

`paginate` is the streaming variant if you would rather process items as they
arrive.

## Genre, Relations, And Credits

```typescript
const fantasy = await anilist.manga.getMangaListByGenre("Fantasy");
const relations = await anilist.manga.getMangaRelations(30013);
const characters = await anilist.manga.getMangaCharacters(30013);
const staff = await anilist.manga.getMangaStaff(30013);

console.log(fantasy.Page?.media?.length);
console.log(relations.Media?.relations?.edges?.[0]?.relationType);
console.log(characters.Media?.characters?.edges?.[0]?.node?.name?.full);
console.log(staff.Media?.staff?.edges?.[0]?.node?.name?.full);
```

## Favorites

`toggleFavorite` mutates the authenticated viewer's favorites.
`toggleFavourite` remains available as a backwards-compatible alias.

```typescript
import { Anilist } from "@api-wrappers/anilist-wrapper";

const anilist = new Anilist(process.env.ANILIST_TOKEN);

await anilist.manga.toggleFavorite(30013);
```

```typescript
const { favorites } = await anilist.manga.toggleFavorite(30013, {
	select: { favorites: { manga: { nodes: { id: true } } } },
});
```