ani-mcp 0.8.4 → 0.10.0

package/README.md

@@ -95,6 +95,19 @@ Works with any MCP-compatible client.
 | `anilist_sequels` | Sequels airing this season for titles you've completed |
 | `anilist_watch_order` | Viewing order for a franchise |
 | `anilist_session` | Plan a viewing session within a time budget |
+| `anilist_mal_import` | Import a MyAnimeList user's list and generate recommendations |
+
+### Cards
+
+| Tool | Description |
+| --- | --- |
+| `anilist_taste_card` | Generate a shareable taste profile card as a PNG image |
+| `anilist_compat_card` | Generate a compatibility card comparing two users as a PNG image |
+
+<p align="center">
+  <img src="assets/taste-card.png" width="400" alt="Taste Profile Card">
+  <img src="assets/compat-card.png" width="400" alt="Compatibility Card">
+</p>
 
 ### Info
 
@@ -104,6 +117,7 @@ Works with any MCP-compatible client.
 | `anilist_staff_search` | Search for a person by name and see all their works |
 | `anilist_studio_search` | Search for a studio and see their productions |
 | `anilist_schedule` | Airing schedule and next episode countdown |
+| `anilist_airing` | Upcoming episodes for titles you're currently watching |
 | `anilist_characters` | Search characters by name with appearances and VAs |
 | `anilist_whoami` | Check authentication status and score format |
 

package/dist/api/client.js

@@ -13,7 +13,7 @@ const ANILIST_API_URL = process.env.ANILIST_API_URL || "https://graphql.anilist.
 const RATE_LIMIT_PER_MINUTE = process.env.VITEST ? 10_000 : 85;
 const MAX_RETRIES = 3;
 // Hard timeout per fetch attempt (retries get their own timeout)
-const FETCH_TIMEOUT_MS = 15_000;
+const FETCH_TIMEOUT_MS = process.env.VITEST ? 500 : 15_000;
 // === Logging ===
 const DEBUG = process.env.DEBUG === "true" || process.env.DEBUG === "1";
 // Extract query operation name (e.g. "SearchMedia" from "query SearchMedia(...)")

package/dist/api/mal-client.d.ts

@@ -0,0 +1,23 @@
+/** Jikan (MyAnimeList) API client for read-only list import */
+export interface JikanAnimeEntry {
+    score: number;
+    episodes_watched: number;
+    anime: {
+        mal_id: number;
+        title: string;
+        type: string;
+        episodes: number | null;
+        score: number | null;
+        genres: Array<{
+            mal_id: number;
+            name: string;
+        }>;
+        year: number | null;
+    };
+}
+/** Map a MAL genre name to its AniList equivalent */
+export declare function mapMalGenre(name: string): string;
+/** Map a MAL format string to AniList format */
+export declare function mapMalFormat(malType: string): string;
+/** Fetch a MAL user's completed anime list via Jikan */
+export declare function fetchMalList(username: string, maxPages?: number): Promise<JikanAnimeEntry[]>;

package/dist/api/mal-client.js

@@ -0,0 +1,61 @@
+/** Jikan (MyAnimeList) API client for read-only list import */
+import pThrottle from "p-throttle";
+import pRetry, { AbortError } from "p-retry";
+const JIKAN_BASE = "https://api.jikan.moe/v4";
+const FETCH_TIMEOUT_MS = 15_000;
+// Jikan rate limit: 3 req/sec (unauthenticated)
+const throttle = pThrottle({
+    limit: process.env.VITEST ? 10_000 : 3,
+    interval: 1_000,
+});
+const throttled = throttle(() => { });
+// === Genre Mapping ===
+// MAL and AniList share most genre names; only map exceptions
+const MAL_TO_ANILIST_GENRE = {
+    "Sci-Fi": "Sci-Fi",
+    "Slice of Life": "Slice of Life",
+};
+/** Map a MAL genre name to its AniList equivalent */
+export function mapMalGenre(name) {
+    return MAL_TO_ANILIST_GENRE[name] ?? name;
+}
+/** Map a MAL format string to AniList format */
+export function mapMalFormat(malType) {
+    const map = {
+        TV: "TV",
+        Movie: "MOVIE",
+        OVA: "OVA",
+        ONA: "ONA",
+        Special: "SPECIAL",
+        Music: "MUSIC",
+    };
+    return map[malType] ?? "TV";
+}
+// === Client ===
+/** Fetch a MAL user's completed anime list via Jikan */
+export async function fetchMalList(username, maxPages = 5) {
+    const entries = [];
+    for (let page = 1; page <= maxPages; page++) {
+        const data = await fetchPage(username, page);
+        entries.push(...data.data);
+        if (!data.pagination.has_next_page)
+            break;
+    }
+    return entries;
+}
+async function fetchPage(username, page) {
+    return pRetry(async () => {
+        await throttled();
+        const url = `${JIKAN_BASE}/users/${encodeURIComponent(username)}/animelist?status=completed&page=${page}`;
+        const response = await fetch(url, {
+            signal: AbortSignal.timeout(FETCH_TIMEOUT_MS),
+        });
+        if (!response.ok) {
+            if (response.status === 404) {
+                throw new AbortError(`MAL user "${username}" not found.`);
+            }
+            throw new Error(`Jikan API error (HTTP ${response.status})`);
+        }
+        return (await response.json());
+    }, { retries: 3 });
+}

package/dist/api/queries.d.ts

@@ -5,35 +5,37 @@
  * if the AniList schema changes.
  */
 /** Paginated search with optional genre, year, and format filters */
-export declare const SEARCH_MEDIA_QUERY = "\n  query SearchMedia(\n    $search: String!\n    $type: MediaType\n    $genre: [String]\n    $year: Int\n    $format: MediaFormat\n    $isAdult: Boolean\n    $page: Int\n    $perPage: Int\n    $sort: [MediaSort]\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo {\n        total\n        currentPage\n        lastPage\n        hasNextPage\n      }\n      media(\n        search: $search\n        type: $type\n        genre_in: $genre\n        startDate_year: $year\n        format: $format\n        isAdult: $isAdult\n        sort: $sort\n      ) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const SEARCH_MEDIA_QUERY = "\n  query SearchMedia(\n    $search: String!\n    $type: MediaType\n    $genre: [String]\n    $year: Int\n    $format: MediaFormat\n    $isAdult: Boolean\n    $page: Int\n    $perPage: Int\n    $sort: [MediaSort]\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo {\n        total\n        currentPage\n        lastPage\n        hasNextPage\n      }\n      media(\n        search: $search\n        type: $type\n        genre_in: $genre\n        startDate_year: $year\n        format: $format\n        isAdult: $isAdult\n        sort: $sort\n      ) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** Full media lookup with relations and recommendations */
-export declare const MEDIA_DETAILS_QUERY = "\n  query MediaDetails($id: Int, $search: String) {\n    Media(id: $id, search: $search) {\n      ...MediaFields\n      relations {\n        edges {\n          relationType\n          node {\n            id\n            title { romaji english }\n            format\n            status\n            type\n          }\n        }\n      }\n      recommendations(sort: RATING_DESC, perPage: 5) {\n        nodes {\n          rating\n          mediaRecommendation {\n            id\n            title { romaji english }\n            format\n            meanScore\n            genres\n            siteUrl\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const MEDIA_DETAILS_QUERY = "\n  query MediaDetails($id: Int, $search: String) {\n    Media(id: $id, search: $search) {\n      ...MediaFields\n      relations {\n        edges {\n          relationType\n          node {\n            id\n            title { romaji english }\n            format\n            status\n            type\n          }\n        }\n      }\n      recommendations(sort: RATING_DESC, perPage: 5) {\n        nodes {\n          rating\n          mediaRecommendation {\n            id\n            title { romaji english }\n            format\n            meanScore\n            genres\n            siteUrl\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** Discover top-rated titles by genre without a search term */
-export declare const DISCOVER_MEDIA_QUERY = "\n  query DiscoverMedia(\n    $type: MediaType\n    $genre_in: [String]\n    $page: Int\n    $perPage: Int\n    $sort: [MediaSort]\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      media(type: $type, genre_in: $genre_in, sort: $sort) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const DISCOVER_MEDIA_QUERY = "\n  query DiscoverMedia(\n    $type: MediaType\n    $genre_in: [String]\n    $page: Int\n    $perPage: Int\n    $sort: [MediaSort]\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      media(type: $type, genre_in: $genre_in, sort: $sort) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** Browse anime by season and year */
-export declare const SEASONAL_MEDIA_QUERY = "\n  query SeasonalMedia(\n    $season: MediaSeason\n    $seasonYear: Int\n    $type: MediaType\n    $isAdult: Boolean\n    $sort: [MediaSort]\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total currentPage lastPage hasNextPage }\n      media(\n        season: $season\n        seasonYear: $seasonYear\n        type: $type\n        isAdult: $isAdult\n        sort: $sort\n      ) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const SEASONAL_MEDIA_QUERY = "\n  query SeasonalMedia(\n    $season: MediaSeason\n    $seasonYear: Int\n    $type: MediaType\n    $isAdult: Boolean\n    $sort: [MediaSort]\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total currentPage lastPage hasNextPage }\n      media(\n        season: $season\n        seasonYear: $seasonYear\n        type: $type\n        isAdult: $isAdult\n        sort: $sort\n      ) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** User profile statistics - watching/reading stats, genre/tag/score breakdowns */
 export declare const USER_STATS_QUERY = "\n  query UserStats($name: String!) {\n    User(name: $name) {\n      id\n      name\n      mediaListOptions {\n        scoreFormat\n      }\n      statistics {\n        anime {\n          count\n          meanScore\n          minutesWatched\n          episodesWatched\n          genres(sort: COUNT_DESC, limit: 10) {\n            genre\n            count\n            meanScore\n            minutesWatched\n          }\n          scores(sort: MEAN_SCORE_DESC) {\n            score\n            count\n          }\n          formats(sort: COUNT_DESC) {\n            format\n            count\n          }\n        }\n        manga {\n          count\n          meanScore\n          chaptersRead\n          volumesRead\n          genres(sort: COUNT_DESC, limit: 10) {\n            genre\n            count\n            meanScore\n            chaptersRead\n          }\n          scores(sort: MEAN_SCORE_DESC) {\n            score\n            count\n          }\n          formats(sort: COUNT_DESC) {\n            format\n            count\n          }\n        }\n      }\n    }\n  }\n";
 /** Media recommendations for a given title */
-export declare const RECOMMENDATIONS_QUERY = "\n  query MediaRecommendations($id: Int, $search: String, $perPage: Int) {\n    Media(id: $id, search: $search) {\n      id\n      title { romaji english native }\n      recommendations(sort: RATING_DESC, perPage: $perPage) {\n        nodes {\n          rating\n          mediaRecommendation {\n            ...MediaFields\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const RECOMMENDATIONS_QUERY = "\n  query MediaRecommendations($id: Int, $search: String, $perPage: Int) {\n    Media(id: $id, search: $search) {\n      id\n      title { romaji english native }\n      recommendations(sort: RATING_DESC, perPage: $perPage) {\n        nodes {\n          rating\n          mediaRecommendation {\n            ...MediaFields\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** Trending anime or manga right now */
-export declare const TRENDING_MEDIA_QUERY = "\n  query TrendingMedia(\n    $type: MediaType\n    $isAdult: Boolean\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      media(type: $type, isAdult: $isAdult, sort: TRENDING_DESC) {\n        ...MediaFields\n        trending\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const TRENDING_MEDIA_QUERY = "\n  query TrendingMedia(\n    $type: MediaType\n    $isAdult: Boolean\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      media(type: $type, isAdult: $isAdult, sort: TRENDING_DESC) {\n        ...MediaFields\n        trending\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** Browse by genre without a search term, with optional filters */
-export declare const GENRE_BROWSE_QUERY = "\n  query GenreBrowse(\n    $type: MediaType\n    $genre_in: [String]\n    $year: Int\n    $status: MediaStatus\n    $format: MediaFormat\n    $isAdult: Boolean\n    $sort: [MediaSort]\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      media(\n        type: $type\n        genre_in: $genre_in\n        startDate_year: $year\n        status: $status\n        format: $format\n        isAdult: $isAdult\n        sort: $sort\n      ) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const GENRE_BROWSE_QUERY = "\n  query GenreBrowse(\n    $type: MediaType\n    $genre_in: [String]\n    $year: Int\n    $status: MediaStatus\n    $format: MediaFormat\n    $isAdult: Boolean\n    $sort: [MediaSort]\n    $page: Int\n    $perPage: Int\n  ) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      media(\n        type: $type\n        genre_in: $genre_in\n        startDate_year: $year\n        status: $status\n        format: $format\n        isAdult: $isAdult\n        sort: $sort\n      ) {\n        ...MediaFields\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** Staff and voice actors for a media title */
 export declare const STAFF_QUERY = "\n  query MediaStaff($id: Int, $search: String) {\n    Media(id: $id, search: $search) {\n      id\n      title { romaji english native }\n      format\n      siteUrl\n      staff(sort: RELEVANCE, perPage: 15) {\n        edges {\n          role\n          node {\n            id\n            name { full native }\n            siteUrl\n          }\n        }\n      }\n      characters(sort: ROLE, perPage: 10) {\n        edges {\n          role\n          node {\n            id\n            name { full native }\n            siteUrl\n          }\n          voiceActors(language: JAPANESE) {\n            id\n            name { full native }\n            siteUrl\n          }\n        }\n      }\n    }\n  }\n";
 /** Airing schedule for currently airing anime */
 export declare const AIRING_SCHEDULE_QUERY = "\n  query AiringSchedule($id: Int, $search: String, $notYetAired: Boolean) {\n    Media(id: $id, search: $search) {\n      id\n      title { romaji english native }\n      status\n      episodes\n      nextAiringEpisode {\n        episode\n        airingAt\n        timeUntilAiring\n      }\n      airingSchedule(notYetAired: $notYetAired, perPage: 10) {\n        nodes {\n          episode\n          airingAt\n          timeUntilAiring\n        }\n      }\n      siteUrl\n    }\n  }\n";
+/** Batch-fetch next airing episodes for multiple media IDs */
+export declare const BATCH_AIRING_QUERY = "\n  query BatchAiring($ids: [Int], $perPage: Int) {\n    Page(perPage: $perPage) {\n      media(id_in: $ids, status: RELEASING) {\n        id\n        title { romaji english native }\n        format\n        episodes\n        nextAiringEpisode {\n          episode\n          airingAt\n          timeUntilAiring\n        }\n        siteUrl\n      }\n    }\n  }\n";
 /** Search for characters by name */
 export declare const CHARACTER_SEARCH_QUERY = "\n  query CharacterSearch($search: String!, $page: Int, $perPage: Int) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      characters(search: $search, sort: FAVOURITES_DESC) {\n        id\n        name { full native alternative }\n        image { medium }\n        favourites\n        siteUrl\n        media(sort: POPULARITY_DESC, perPage: 5) {\n          edges {\n            characterRole\n            node {\n              id\n              title { romaji english }\n              format\n              type\n              siteUrl\n            }\n            voiceActors(language: JAPANESE) {\n              id\n              name { full }\n              siteUrl\n            }\n          }\n        }\n      }\n    }\n  }\n";
 /** Create or update a list entry */
-export declare const SAVE_MEDIA_LIST_ENTRY_MUTATION = "\n  mutation SaveMediaListEntry(\n    $mediaId: Int\n    $status: MediaListStatus\n    $scoreRaw: Int\n    $progress: Int\n    $notes: String\n    $private: Boolean\n  ) {\n    SaveMediaListEntry(\n      mediaId: $mediaId\n      status: $status\n      scoreRaw: $scoreRaw\n      progress: $progress\n      notes: $notes\n      private: $private\n    ) {\n      id\n      mediaId\n      status\n      score(format: POINT_10)\n      progress\n    }\n  }\n";
+export declare const SAVE_MEDIA_LIST_ENTRY_MUTATION = "\n  mutation SaveMediaListEntry(\n    $mediaId: Int\n    $status: MediaListStatus\n    $scoreRaw: Int\n    $progress: Int\n    $progressVolumes: Int\n    $notes: String\n    $private: Boolean\n  ) {\n    SaveMediaListEntry(\n      mediaId: $mediaId\n      status: $status\n      scoreRaw: $scoreRaw\n      progress: $progress\n      progressVolumes: $progressVolumes\n      notes: $notes\n      private: $private\n    ) {\n      id\n      mediaId\n      status\n      score(format: POINT_10)\n      progress\n      progressVolumes\n    }\n  }\n";
 /** Fetch a single list entry for snapshotting before mutations */
-export declare const MEDIA_LIST_ENTRY_QUERY = "\n  query MediaListEntry($id: Int, $mediaId: Int, $userName: String) {\n    MediaList(id: $id, mediaId: $mediaId, userName: $userName) {\n      id\n      mediaId\n      status\n      score(format: POINT_10)\n      progress\n      notes\n      private\n    }\n  }\n";
+export declare const MEDIA_LIST_ENTRY_QUERY = "\n  query MediaListEntry($id: Int, $mediaId: Int, $userName: String) {\n    MediaList(id: $id, mediaId: $mediaId, userName: $userName) {\n      id\n      mediaId\n      status\n      score(format: POINT_10)\n      progress\n      progressVolumes\n      notes\n      private\n    }\n  }\n";
 /** Remove a list entry */
 export declare const DELETE_MEDIA_LIST_ENTRY_MUTATION = "\n  mutation DeleteMediaListEntry($id: Int!) {\n    DeleteMediaListEntry(id: $id) {\n      deleted\n    }\n  }\n";
 /** User's anime/manga list, grouped by status. Omit $status to get all lists. */
-export declare const USER_LIST_QUERY = "\n  query UserMediaList(\n    $userName: String!\n    $type: MediaType\n    $status: MediaListStatus\n    $sort: [MediaListSort]\n  ) {\n    MediaListCollection(\n      userName: $userName\n      type: $type\n      status: $status\n      sort: $sort\n    ) {\n      lists {\n        name\n        status\n        isCustomList\n        entries {\n          id\n          score(format: POINT_10)  # normalize to 1-10 scale regardless of user's profile setting\n          progress\n          status\n          updatedAt\n          startedAt { year month day }\n          completedAt { year month day }\n          notes\n          media {\n            ...MediaFields\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
+export declare const USER_LIST_QUERY = "\n  query UserMediaList(\n    $userName: String!\n    $type: MediaType\n    $status: MediaListStatus\n    $sort: [MediaListSort]\n  ) {\n    MediaListCollection(\n      userName: $userName\n      type: $type\n      status: $status\n      sort: $sort\n    ) {\n      lists {\n        name\n        status\n        isCustomList\n        entries {\n          id\n          score(format: POINT_10)  # normalize to 1-10 scale regardless of user's profile setting\n          progress\n          progressVolumes\n          status\n          updatedAt\n          startedAt { year month day }\n          completedAt { year month day }\n          notes\n          media {\n            ...MediaFields\n          }\n        }\n      }\n    }\n  }\n  \n  fragment MediaFields on Media {\n    id\n    type\n    title {\n      romaji\n      english\n      native\n    }\n    format\n    status\n    episodes\n    duration\n    chapters\n    volumes\n    meanScore\n    averageScore\n    popularity\n    genres\n    tags {\n      name\n      rank\n      isMediaSpoiler\n    }\n    season\n    seasonYear\n    startDate { year month day }\n    endDate { year month day }\n    studios(isMain: true) {\n      nodes { name }\n    }\n    source\n    isAdult\n    coverImage { large extraLarge }\n    trailer { id site thumbnail }\n    siteUrl\n    description(asHtml: false)\n  }\n\n";
 /** Search for staff by name with their top works */
 export declare const STAFF_SEARCH_QUERY = "\n  query StaffSearch($search: String!, $page: Int, $perPage: Int, $mediaPerPage: Int) {\n    Page(page: $page, perPage: $perPage) {\n      pageInfo { total hasNextPage }\n      staff(search: $search, sort: SEARCH_MATCH) {\n        id\n        name { full native }\n        primaryOccupations\n        siteUrl\n        staffMedia(sort: POPULARITY_DESC, perPage: $mediaPerPage) {\n          edges {\n            staffRole\n            node {\n              id\n              title { romaji english }\n              format\n              type\n              meanScore\n              siteUrl\n            }\n          }\n        }\n      }\n    }\n  }\n";
 /** Authenticated user info */

package/dist/api/queries.js

@@ -38,7 +38,8 @@ const MEDIA_FRAGMENT = `
     }
     source
     isAdult
-    coverImage { large }
+    coverImage { large extraLarge }
+    trailer { id site thumbnail }
     siteUrl
     description(asHtml: false)
   }
@@ -336,6 +337,25 @@ export const AIRING_SCHEDULE_QUERY = `
     }
   }
 `;
+/** Batch-fetch next airing episodes for multiple media IDs */
+export const BATCH_AIRING_QUERY = `
+  query BatchAiring($ids: [Int], $perPage: Int) {
+    Page(perPage: $perPage) {
+      media(id_in: $ids, status: RELEASING) {
+        id
+        title { romaji english native }
+        format
+        episodes
+        nextAiringEpisode {
+          episode
+          airingAt
+          timeUntilAiring
+        }
+        siteUrl
+      }
+    }
+  }
+`;
 /** Search for characters by name */
 export const CHARACTER_SEARCH_QUERY = `
   query CharacterSearch($search: String!, $page: Int, $perPage: Int) {
@@ -375,6 +395,7 @@ export const SAVE_MEDIA_LIST_ENTRY_MUTATION = `
     $status: MediaListStatus
     $scoreRaw: Int
     $progress: Int
+    $progressVolumes: Int
     $notes: String
     $private: Boolean
   ) {
@@ -383,6 +404,7 @@ export const SAVE_MEDIA_LIST_ENTRY_MUTATION = `
       status: $status
       scoreRaw: $scoreRaw
       progress: $progress
+      progressVolumes: $progressVolumes
       notes: $notes
       private: $private
     ) {
@@ -391,6 +413,7 @@ export const SAVE_MEDIA_LIST_ENTRY_MUTATION = `
       status
       score(format: POINT_10)
       progress
+      progressVolumes
     }
   }
 `;
@@ -403,6 +426,7 @@ export const MEDIA_LIST_ENTRY_QUERY = `
       status
       score(format: POINT_10)
       progress
+      progressVolumes
       notes
       private
     }
@@ -438,6 +462,7 @@ export const USER_LIST_QUERY = `
           id
           score(format: POINT_10)  # normalize to 1-10 scale regardless of user's profile setting
           progress
+          progressVolumes
           status
           updatedAt
           startedAt { year month day }

package/dist/engine/card.d.ts

@@ -0,0 +1,26 @@
+/** Generates shareable SVG cards for taste profiles and compatibility comparisons */
+import type { TasteProfile } from "./taste.js";
+/** Fetch an image URL and return a base64 data URI, or null on failure */
+export declare function fetchAvatarB64(url: string): Promise<string | null>;
+/** Build an SVG taste profile card */
+export declare function buildTasteCardSvg(username: string, profile: TasteProfile, avatarB64?: string | null): string;
+export interface CompatCardData {
+    user1: string;
+    user2: string;
+    compatibility: number;
+    sharedCount: number;
+    sharedFavorites: Array<{
+        title: string;
+        score1: number;
+        score2: number;
+    }>;
+    divergences: string[];
+    profile1: TasteProfile;
+    profile2: TasteProfile;
+    avatar1?: string | null;
+    avatar2?: string | null;
+}
+/** Build an SVG compatibility comparison card */
+export declare function buildCompatCardSvg(data: CompatCardData): string;
+/** Render an SVG string to a PNG buffer */
+export declare function svgToPng(svg: string): Promise<Buffer>;