ani-client 2.4.0 → 2.5.0

package/README.md

@@ -79,6 +79,10 @@ Contributions are welcome! Before opening an issue or a pull request, please rea
 - [CONTRIBUTING.md](CONTRIBUTING.md)
 - [SECURITY.md](SECURITY.md)
 
+## Disclaimer
+
+> **Note:** `ani-client` is an unofficial, community-driven tool. It is not affiliated with, endorsed by, or associated with AniList or AniChart in any way.
+
 ## License
 
 [MIT](LICENSE) © [gonzyui](https://gonzyuidev.xyz)

package/dist/cache/redis.d.mts

@@ -1 +1 @@
-export { f as RedisCache, g as RedisCacheOptions, h as RedisLikeClient } from '../redis-UeRs8nqC.mjs';
+export { f as RedisCache, g as RedisCacheOptions, h as RedisLikeClient } from '../redis-ClB2nNrs.mjs';

package/dist/cache/redis.d.ts

@@ -1 +1 @@
-export { f as RedisCache, g as RedisCacheOptions, h as RedisLikeClient } from '../redis-UeRs8nqC.js';
+export { f as RedisCache, g as RedisCacheOptions, h as RedisLikeClient } from '../redis-ClB2nNrs.js';

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { F as FuzzyDate, P as PageInfo, E as ExternalLink, C as CacheAdapter, a as CacheOptions, b as PagedResult, A as AniListClientOptions, R as RateLimitInfo, c as ResponseMeta, d as RateLimitOptions } from './redis-UeRs8nqC.mjs';
-export { e as AniListHooks, L as Logger, f as RedisCache, g as RedisCacheOptions, h as RedisLikeClient } from './redis-UeRs8nqC.mjs';
+import { F as FuzzyDate, P as PageInfo, E as ExternalLink, C as CacheAdapter, a as CacheOptions, b as PagedResult, A as AniListClientOptions, R as RateLimitInfo, c as ResponseMeta, d as RateLimitOptions } from './redis-ClB2nNrs.mjs';
+export { e as AniListHooks, L as Logger, f as RedisCache, g as RedisCacheOptions, h as RedisLikeClient } from './redis-ClB2nNrs.mjs';
 
 declare enum MediaListStatus {
     CURRENT = "CURRENT",
@@ -156,6 +156,10 @@ interface Staff {
 }
 /** Options to include additional related data when fetching a staff member by ID. */
 interface StaffIncludeOptions {
+    /** Include character roles (voice acting) for each media the staff member worked on. */
+    characterRoles?: boolean;
+    /** Raw GraphQL fields to append to the query (e.g. for custom data) */
+    customFields?: string;
     /** Include media the staff member has worked on.
      *  `true` = 25 results sorted by popularity. Object form to customize. */
     media?: boolean | {
@@ -211,10 +215,14 @@ interface SearchStudioOptions {
  * Pass `{ media: { perPage: 50 } }` to fetch more media per studio.
  */
 interface StudioIncludeOptions {
-    /** Customize the number of media returned. `true` = 25 (default), or `{ perPage }`. */
+    /** Include the media produced by this studio. */
     media?: boolean | {
         perPage?: number;
+        isMain?: boolean;
+        sort?: boolean;
     };
+    /** Raw GraphQL fields to append to the query (e.g. for custom data) */
+    customFields?: string;
 }
 
 declare enum UserSort {
@@ -707,6 +715,8 @@ interface MediaIncludeOptions {
     recommendations?: boolean | {
         perPage?: number;
     };
+    /** Raw GraphQL fields to append to the query (e.g. for custom data) */
+    customFields?: string;
 }
 interface GetMediaCharactersOptions {
     /** Page number */
@@ -788,6 +798,8 @@ interface Character {
 interface CharacterIncludeOptions {
     /** Include voice actors for each media the character appears in. */
     voiceActors?: boolean;
+    /** Raw GraphQL fields to append to the query (e.g. for custom data) */
+    customFields?: string;
 }
 interface SearchCharacterOptions {
     query?: string;
@@ -1038,6 +1050,7 @@ interface ClientBase {
     request<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
     pagedRequest<T>(query: string, variables: Record<string, unknown>, field: string): Promise<PagedResult<T>>;
     paginate<T>(fetchPage: (page: number) => Promise<PagedResult<T>>, maxPages?: number): AsyncGenerator<T, void, undefined>;
+    fetchAll<T>(fetchPage: (page: number) => Promise<PagedResult<T>>, maxPages?: number): Promise<T[]>;
 }
 
 /**
@@ -1072,6 +1085,7 @@ declare class AniListClient implements ClientBase {
     private readonly mediaLoader;
     private readonly characterLoader;
     private readonly staffLoader;
+    private readonly batchingEnabled;
     constructor(options?: AniListClientOptions);
     /**
      * The current rate limit information from the last API response.
@@ -1213,6 +1227,13 @@ declare class AniListClient implements ClientBase {
      * @param maxPages - Maximum number of pages to fetch (default: Infinity)
      */
     paginate<T>(fetchPage: (page: number) => Promise<PagedResult<T>>, maxPages?: number): AsyncGenerator<T, void, undefined>;
+    /**
+     * Utility to fetch all pages of a paginated request and return them as a single array.
+     *
+     * @param fetchPage - A function that takes a page number and returns a `PagedResult<T>`
+     * @param maxPages - Maximum number of pages to fetch (default: Infinity)
+     */
+    fetchAll<T>(fetchPage: (page: number) => Promise<PagedResult<T>>, maxPages?: number): Promise<T[]>;
     /** Fetch multiple media entries in a single API request. */
     getMediaBatch(ids: number[]): Promise<Media[]>;
     /** Fetch multiple characters in a single API request. */
@@ -1273,6 +1294,53 @@ declare class AniListError extends Error {
     constructor(message: string, status: number, errors?: GraphQLError[] | unknown[]);
 }
 
+/**
+ * Lightweight media fields — minimal payload for list/search contexts.
+ * Does NOT include tags, studios, trailer, synonyms, or nextAiringEpisode.
+ */
+declare const MEDIA_FIELDS_LIGHT = "\n  __typename\n  id\n  idMal\n  title { romaji english native userPreferred }\n  type\n  format\n  status\n  coverImage { large medium color }\n  bannerImage\n  genres\n  averageScore\n  popularity\n  favourites\n  isAdult\n  siteUrl\n  season\n  seasonYear\n  episodes\n  chapters\n  nextAiringEpisode {\n    id\n    airingAt\n    episode\n    timeUntilAiring\n  }\n";
+/** Core media fields — always returned. Does NOT include relations (opt-in via include). */
+declare const MEDIA_FIELDS_BASE = "\n  __typename\n  id\n  idMal\n  title { romaji english native userPreferred }\n  type\n  format\n  status\n  description(asHtml: false)\n  startDate { year month day }\n  endDate { year month day }\n  season\n  seasonYear\n  episodes\n  duration\n  chapters\n  volumes\n  countryOfOrigin\n  isLicensed\n  source\n  hashtag\n  trailer { id site thumbnail }\n  coverImage { extraLarge large medium color }\n  bannerImage\n  genres\n  synonyms\n  averageScore\n  meanScore\n  popularity\n  favourites\n  trending\n  tags { id name description category rank isMediaSpoiler }\n  studios { nodes { id name isAnimationStudio siteUrl } }\n  isAdult\n  siteUrl\n  nextAiringEpisode {\n    id\n    airingAt\n    episode\n    mediaId\n    timeUntilAiring\n  }\n";
+declare const RELATIONS_FIELDS = "\n  relations {\n    edges {\n      relationType(version: 2)\n      node {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        type\n        format\n        status\n        description(asHtml: false)\n        startDate { year month day }\n        endDate { year month day }\n        season\n        seasonYear\n        episodes\n        chapters\n        volumes\n        coverImage { extraLarge large medium color }\n        genres\n        averageScore\n        meanScore\n        studios { nodes { id name isAnimationStudio siteUrl } }\n        siteUrl\n        nextAiringEpisode {\n          id\n          airingAt\n          episode\n          mediaId\n          timeUntilAiring\n        }\n      }\n    }\n  }\n";
+/** Media Recommendation fields - used for when fetching recommendation for a specific media entry */
+declare const MEDIA_RECOMMENDATION_FIELDS = "\n  __typename\n  id\n  rating\n  mediaRecommendation {\n    __typename\n    id\n    title { romaji english native userPreferred }\n    type\n    format\n    status\n    description(asHtml: false)\n    coverImage { extraLarge large medium color }\n    averageScore\n    meanScore\n   \tepisodes\n   \tchapters\n   \tvolumes\n    nextAiringEpisode {\n      id\n      airingAt\n      episode\n      mediaId\n      timeUntilAiring\n    }\n   \tseason\n   \tseasonYear\n   \tstartDate { year month day }\n    endDate { year month day }\n   \tstudios { nodes { id name isAnimationStudio siteUrl } }\n   \tgenres\n    siteUrl\n  }\n";
+/** Full media fields with relations — used by existing queries for backward compat. */
+declare const MEDIA_FIELDS = "\n  \n  __typename\n  id\n  idMal\n  title { romaji english native userPreferred }\n  type\n  format\n  status\n  description(asHtml: false)\n  startDate { year month day }\n  endDate { year month day }\n  season\n  seasonYear\n  episodes\n  duration\n  chapters\n  volumes\n  countryOfOrigin\n  isLicensed\n  source\n  hashtag\n  trailer { id site thumbnail }\n  coverImage { extraLarge large medium color }\n  bannerImage\n  genres\n  synonyms\n  averageScore\n  meanScore\n  popularity\n  favourites\n  trending\n  tags { id name description category rank isMediaSpoiler }\n  studios { nodes { id name isAnimationStudio siteUrl } }\n  isAdult\n  siteUrl\n  nextAiringEpisode {\n    id\n    airingAt\n    episode\n    mediaId\n    timeUntilAiring\n  }\n\n  \n  relations {\n    edges {\n      relationType(version: 2)\n      node {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        type\n        format\n        status\n        description(asHtml: false)\n        startDate { year month day }\n        endDate { year month day }\n        season\n        seasonYear\n        episodes\n        chapters\n        volumes\n        coverImage { extraLarge large medium color }\n        genres\n        averageScore\n        meanScore\n        studios { nodes { id name isAnimationStudio siteUrl } }\n        siteUrl\n        nextAiringEpisode {\n          id\n          airingAt\n          episode\n          mediaId\n          timeUntilAiring\n        }\n      }\n    }\n  }\n\n";
+/** Character fields without back-reference to media (used when embedding characters inside a Media query). */
+declare const CHARACTER_FIELDS_COMPACT = "\n  __typename\n  id\n  name { first middle last full native alternative }\n  image { large medium }\n  description(asHtml: false)\n  gender\n  dateOfBirth { year month day }\n  age\n  bloodType\n  favourites\n  siteUrl\n";
+/** Compact voice actor fields — lightweight subset for embedding inside character edges. */
+declare const VOICE_ACTOR_FIELDS_COMPACT = "\n  __typename\n  id\n  name { first middle last full native userPreferred }\n  languageV2\n  image { large medium }\n  gender\n  primaryOccupations\n  siteUrl\n";
+declare const CHARACTER_FIELDS = "\n  \n  __typename\n  id\n  name { first middle last full native alternative }\n  image { large medium }\n  description(asHtml: false)\n  gender\n  dateOfBirth { year month day }\n  age\n  bloodType\n  favourites\n  siteUrl\n\n  \n  media(perPage: 10) {\n    nodes {\n      __typename\n      id\n      title { romaji english native userPreferred }\n      type\n      coverImage { large medium }\n      siteUrl\n    }\n  }\n\n";
+declare const CHARACTER_FIELDS_WITH_VA = "\n  \n  __typename\n  id\n  name { first middle last full native alternative }\n  image { large medium }\n  description(asHtml: false)\n  gender\n  dateOfBirth { year month day }\n  age\n  bloodType\n  favourites\n  siteUrl\n\n  \n  media(perPage: 10) {\n    edges {\n      voiceActors {\n        \n  __typename\n  id\n  name { first middle last full native userPreferred }\n  languageV2\n  image { large medium }\n  gender\n  primaryOccupations\n  siteUrl\n\n      }\n      node {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        type\n        coverImage { large medium }\n        siteUrl\n      }\n    }\n  }\n\n";
+declare const STAFF_FIELDS = "\n  __typename\n  id\n  name { first middle last full native }\n  language\n  image { large medium }\n  description(asHtml: false)\n  primaryOccupations\n  gender\n  dateOfBirth { year month day }\n  dateOfDeath { year month day }\n  age\n  yearsActive\n  homeTown\n  bloodType\n  favourites\n  siteUrl\n";
+declare const STAFF_MEDIA_FIELDS = "\n  staffMedia(perPage: $perPage, sort: [POPULARITY_DESC]) {\n    nodes {\n      __typename\n      id\n      title { romaji english native userPreferred }\n      type\n      format\n      status\n      coverImage { extraLarge large medium color }\n      bannerImage\n      genres\n      averageScore\n      meanScore\n      popularity\n      favourites\n      episodes\n      trending\n      hashtag\n      season\n      seasonYear\n      startDate { year month day }\n      endDate { year month day }\n      nextAiringEpisode {\n        id\n        airingAt\n        episode\n        mediaId\n        timeUntilAiring\n      }\n      studios {\n        edges {\n          node {\n            name\n          }\n        }\n      }\n      siteUrl\n    }\n  }\n";
+declare const USER_FIELDS = "\n  __typename\n  id\n  name\n  about(asHtml: false)\n  avatar { large medium }\n  bannerImage\n  isFollowing\n  isFollower\n  donatorTier\n  donatorBadge\n  createdAt\n  siteUrl\n  statistics {\n    anime { count meanScore minutesWatched episodesWatched chaptersRead volumesRead }\n    manga { count meanScore minutesWatched episodesWatched chaptersRead volumesRead }\n  }\n";
+/** Favorites fragment — lightweight fields for each favorite category. */
+declare const USER_FAVORITES_FIELDS = "\n  favourites {\n    anime(perPage: 25) {\n      nodes {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        coverImage { large medium }\n        type\n        format\n        siteUrl\n      }\n    }\n    manga(perPage: 25) {\n      nodes {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        coverImage { large medium }\n        type\n        format\n        siteUrl\n      }\n    }\n    characters(perPage: 25) {\n      nodes {\n        __typename\n        id\n        name { full native }\n        image { large medium }\n        siteUrl\n      }\n    }\n    staff(perPage: 25) {\n      nodes {\n        __typename\n        id\n        name { full native }\n        image { large medium }\n        siteUrl\n      }\n    }\n    studios(perPage: 25) {\n      nodes {\n        __typename\n        id\n        name\n        siteUrl\n      }\n    }\n  }\n";
+declare const MEDIA_LIST_FIELDS = "\n  __typename\n  id\n  mediaId\n  status\n  score(format: POINT_100)\n  progress\n  progressVolumes\n  repeat\n  priority\n  private\n  notes\n  startedAt { year month day }\n  completedAt { year month day }\n  updatedAt\n  createdAt\n  media {\n    \n  __typename\n  id\n  idMal\n  title { romaji english native userPreferred }\n  type\n  format\n  status\n  description(asHtml: false)\n  startDate { year month day }\n  endDate { year month day }\n  season\n  seasonYear\n  episodes\n  duration\n  chapters\n  volumes\n  countryOfOrigin\n  isLicensed\n  source\n  hashtag\n  trailer { id site thumbnail }\n  coverImage { extraLarge large medium color }\n  bannerImage\n  genres\n  synonyms\n  averageScore\n  meanScore\n  popularity\n  favourites\n  trending\n  tags { id name description category rank isMediaSpoiler }\n  studios { nodes { id name isAnimationStudio siteUrl } }\n  isAdult\n  siteUrl\n  nextAiringEpisode {\n    id\n    airingAt\n    episode\n    mediaId\n    timeUntilAiring\n  }\n\n  }\n";
+declare const STUDIO_FIELDS = "\n  __typename\n  id\n  name\n  isAnimationStudio\n  siteUrl\n  favourites\n  media(page: 1, perPage: 25, sort: POPULARITY_DESC) {\n    pageInfo { total perPage currentPage lastPage hasNextPage }\n    nodes {\n      __typename\n      id\n      title { romaji english native userPreferred }\n      type\n      format\n      coverImage { large medium }\n      siteUrl\n    }\n  }\n";
+declare const THREAD_FIELDS = "\n  __typename\n  id\n  title\n  body(asHtml: false)\n  userId\n  replyUserId\n  replyCommentId\n  replyCount\n  viewCount\n  isLocked\n  isSticky\n  isSubscribed\n  repliedAt\n  createdAt\n  updatedAt\n  siteUrl\n  user {\n    __typename\n    id\n    name\n    avatar { large medium }\n  }\n  replyUser {\n    __typename\n    id\n    name\n    avatar { large medium }\n  }\n  categories {\n    __typename\n    id\n    name\n  }\n  mediaCategories {\n    __typename\n    id\n    title { romaji english native userPreferred }\n    type\n    coverImage { large medium }\n    siteUrl\n  }\n  likes {\n    __typename\n    id\n    name\n  }\n";
+
+declare const fragments_CHARACTER_FIELDS: typeof CHARACTER_FIELDS;
+declare const fragments_CHARACTER_FIELDS_COMPACT: typeof CHARACTER_FIELDS_COMPACT;
+declare const fragments_CHARACTER_FIELDS_WITH_VA: typeof CHARACTER_FIELDS_WITH_VA;
+declare const fragments_MEDIA_FIELDS: typeof MEDIA_FIELDS;
+declare const fragments_MEDIA_FIELDS_BASE: typeof MEDIA_FIELDS_BASE;
+declare const fragments_MEDIA_FIELDS_LIGHT: typeof MEDIA_FIELDS_LIGHT;
+declare const fragments_MEDIA_LIST_FIELDS: typeof MEDIA_LIST_FIELDS;
+declare const fragments_MEDIA_RECOMMENDATION_FIELDS: typeof MEDIA_RECOMMENDATION_FIELDS;
+declare const fragments_RELATIONS_FIELDS: typeof RELATIONS_FIELDS;
+declare const fragments_STAFF_FIELDS: typeof STAFF_FIELDS;
+declare const fragments_STAFF_MEDIA_FIELDS: typeof STAFF_MEDIA_FIELDS;
+declare const fragments_STUDIO_FIELDS: typeof STUDIO_FIELDS;
+declare const fragments_THREAD_FIELDS: typeof THREAD_FIELDS;
+declare const fragments_USER_FAVORITES_FIELDS: typeof USER_FAVORITES_FIELDS;
+declare const fragments_USER_FIELDS: typeof USER_FIELDS;
+declare const fragments_VOICE_ACTOR_FIELDS_COMPACT: typeof VOICE_ACTOR_FIELDS_COMPACT;
+declare namespace fragments {
+  export { fragments_CHARACTER_FIELDS as CHARACTER_FIELDS, fragments_CHARACTER_FIELDS_COMPACT as CHARACTER_FIELDS_COMPACT, fragments_CHARACTER_FIELDS_WITH_VA as CHARACTER_FIELDS_WITH_VA, fragments_MEDIA_FIELDS as MEDIA_FIELDS, fragments_MEDIA_FIELDS_BASE as MEDIA_FIELDS_BASE, fragments_MEDIA_FIELDS_LIGHT as MEDIA_FIELDS_LIGHT, fragments_MEDIA_LIST_FIELDS as MEDIA_LIST_FIELDS, fragments_MEDIA_RECOMMENDATION_FIELDS as MEDIA_RECOMMENDATION_FIELDS, fragments_RELATIONS_FIELDS as RELATIONS_FIELDS, fragments_STAFF_FIELDS as STAFF_FIELDS, fragments_STAFF_MEDIA_FIELDS as STAFF_MEDIA_FIELDS, fragments_STUDIO_FIELDS as STUDIO_FIELDS, fragments_THREAD_FIELDS as THREAD_FIELDS, fragments_USER_FAVORITES_FIELDS as USER_FAVORITES_FIELDS, fragments_USER_FIELDS as USER_FIELDS, fragments_VOICE_ACTOR_FIELDS_COMPACT as VOICE_ACTOR_FIELDS_COMPACT };
+}
+
 /**
  * Rate limiter with automatic retry for AniList API.
  *
@@ -1320,4 +1388,4 @@ declare class RateLimiter {
 
 declare function parseAniListMarkdown(text: string): string;
 
-export { type AiringSchedule, AiringSort, AniListClient, AniListClientOptions, AniListError, CacheAdapter, CacheOptions, type CacheStats, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type DayOfWeek, ExternalLink, type FavoriteCharacterNode, type FavoriteMediaNode, type FavoriteStaffNode, type FavoriteStudioNode, FuzzyDate, type GetAiringOptions, type GetMediaCharactersOptions, type GetMediaStaffOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, MediaSource, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type NextAiringEpisode, NormalizedCache, PageInfo, PagedResult, RateLimitInfo, RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, ResponseMeta, type Review, ReviewSort, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchReviewOptions, type SearchStaffOptions, type SearchStudioOptions, type SearchThreadOptions, type SearchUserOptions, type Staff, type StaffImage, type StaffIncludeOptions, type StaffMediaNode, type StaffName, StaffSort, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioIncludeOptions, StudioSort, type Thread, type ThreadCategory, type ThreadMediaCategory, ThreadSort, type User, type UserAvatar, type UserFavorites, type UserFavoritesOptions, UserSort, type UserStatistics, type VoiceActor, type WeeklySchedule, parseAniListMarkdown };
+export { type AiringSchedule, AiringSort, AniListClient, AniListClientOptions, AniListError, CacheAdapter, CacheOptions, type CacheStats, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type DayOfWeek, ExternalLink, type FavoriteCharacterNode, type FavoriteMediaNode, type FavoriteStaffNode, type FavoriteStudioNode, fragments as Fragments, FuzzyDate, type GetAiringOptions, type GetMediaCharactersOptions, type GetMediaStaffOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, MediaSource, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type NextAiringEpisode, NormalizedCache, PageInfo, PagedResult, RateLimitInfo, RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, ResponseMeta, type Review, ReviewSort, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchReviewOptions, type SearchStaffOptions, type SearchStudioOptions, type SearchThreadOptions, type SearchUserOptions, type Staff, type StaffImage, type StaffIncludeOptions, type StaffMediaNode, type StaffName, StaffSort, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioIncludeOptions, StudioSort, type Thread, type ThreadCategory, type ThreadMediaCategory, ThreadSort, type User, type UserAvatar, type UserFavorites, type UserFavoritesOptions, UserSort, type UserStatistics, type VoiceActor, type WeeklySchedule, parseAniListMarkdown };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { F as FuzzyDate, P as PageInfo, E as ExternalLink, C as CacheAdapter, a as CacheOptions, b as PagedResult, A as AniListClientOptions, R as RateLimitInfo, c as ResponseMeta, d as RateLimitOptions } from './redis-UeRs8nqC.js';
-export { e as AniListHooks, L as Logger, f as RedisCache, g as RedisCacheOptions, h as RedisLikeClient } from './redis-UeRs8nqC.js';
+import { F as FuzzyDate, P as PageInfo, E as ExternalLink, C as CacheAdapter, a as CacheOptions, b as PagedResult, A as AniListClientOptions, R as RateLimitInfo, c as ResponseMeta, d as RateLimitOptions } from './redis-ClB2nNrs.js';
+export { e as AniListHooks, L as Logger, f as RedisCache, g as RedisCacheOptions, h as RedisLikeClient } from './redis-ClB2nNrs.js';
 
 declare enum MediaListStatus {
     CURRENT = "CURRENT",
@@ -156,6 +156,10 @@ interface Staff {
 }
 /** Options to include additional related data when fetching a staff member by ID. */
 interface StaffIncludeOptions {
+    /** Include character roles (voice acting) for each media the staff member worked on. */
+    characterRoles?: boolean;
+    /** Raw GraphQL fields to append to the query (e.g. for custom data) */
+    customFields?: string;
     /** Include media the staff member has worked on.
      *  `true` = 25 results sorted by popularity. Object form to customize. */
     media?: boolean | {
@@ -211,10 +215,14 @@ interface SearchStudioOptions {
  * Pass `{ media: { perPage: 50 } }` to fetch more media per studio.
  */
 interface StudioIncludeOptions {
-    /** Customize the number of media returned. `true` = 25 (default), or `{ perPage }`. */
+    /** Include the media produced by this studio. */
     media?: boolean | {
         perPage?: number;
+        isMain?: boolean;
+        sort?: boolean;
     };
+    /** Raw GraphQL fields to append to the query (e.g. for custom data) */
+    customFields?: string;
 }
 
 declare enum UserSort {
@@ -707,6 +715,8 @@ interface MediaIncludeOptions {
     recommendations?: boolean | {
         perPage?: number;
     };
+    /** Raw GraphQL fields to append to the query (e.g. for custom data) */
+    customFields?: string;
 }
 interface GetMediaCharactersOptions {
     /** Page number */
@@ -788,6 +798,8 @@ interface Character {
 interface CharacterIncludeOptions {
     /** Include voice actors for each media the character appears in. */
     voiceActors?: boolean;
+    /** Raw GraphQL fields to append to the query (e.g. for custom data) */
+    customFields?: string;
 }
 interface SearchCharacterOptions {
     query?: string;
@@ -1038,6 +1050,7 @@ interface ClientBase {
     request<T>(query: string, variables?: Record<string, unknown>): Promise<T>;
     pagedRequest<T>(query: string, variables: Record<string, unknown>, field: string): Promise<PagedResult<T>>;
     paginate<T>(fetchPage: (page: number) => Promise<PagedResult<T>>, maxPages?: number): AsyncGenerator<T, void, undefined>;
+    fetchAll<T>(fetchPage: (page: number) => Promise<PagedResult<T>>, maxPages?: number): Promise<T[]>;
 }
 
 /**
@@ -1072,6 +1085,7 @@ declare class AniListClient implements ClientBase {
     private readonly mediaLoader;
     private readonly characterLoader;
     private readonly staffLoader;
+    private readonly batchingEnabled;
     constructor(options?: AniListClientOptions);
     /**
      * The current rate limit information from the last API response.
@@ -1213,6 +1227,13 @@ declare class AniListClient implements ClientBase {
      * @param maxPages - Maximum number of pages to fetch (default: Infinity)
      */
     paginate<T>(fetchPage: (page: number) => Promise<PagedResult<T>>, maxPages?: number): AsyncGenerator<T, void, undefined>;
+    /**
+     * Utility to fetch all pages of a paginated request and return them as a single array.
+     *
+     * @param fetchPage - A function that takes a page number and returns a `PagedResult<T>`
+     * @param maxPages - Maximum number of pages to fetch (default: Infinity)
+     */
+    fetchAll<T>(fetchPage: (page: number) => Promise<PagedResult<T>>, maxPages?: number): Promise<T[]>;
     /** Fetch multiple media entries in a single API request. */
     getMediaBatch(ids: number[]): Promise<Media[]>;
     /** Fetch multiple characters in a single API request. */
@@ -1273,6 +1294,53 @@ declare class AniListError extends Error {
     constructor(message: string, status: number, errors?: GraphQLError[] | unknown[]);
 }
 
+/**
+ * Lightweight media fields — minimal payload for list/search contexts.
+ * Does NOT include tags, studios, trailer, synonyms, or nextAiringEpisode.
+ */
+declare const MEDIA_FIELDS_LIGHT = "\n  __typename\n  id\n  idMal\n  title { romaji english native userPreferred }\n  type\n  format\n  status\n  coverImage { large medium color }\n  bannerImage\n  genres\n  averageScore\n  popularity\n  favourites\n  isAdult\n  siteUrl\n  season\n  seasonYear\n  episodes\n  chapters\n  nextAiringEpisode {\n    id\n    airingAt\n    episode\n    timeUntilAiring\n  }\n";
+/** Core media fields — always returned. Does NOT include relations (opt-in via include). */
+declare const MEDIA_FIELDS_BASE = "\n  __typename\n  id\n  idMal\n  title { romaji english native userPreferred }\n  type\n  format\n  status\n  description(asHtml: false)\n  startDate { year month day }\n  endDate { year month day }\n  season\n  seasonYear\n  episodes\n  duration\n  chapters\n  volumes\n  countryOfOrigin\n  isLicensed\n  source\n  hashtag\n  trailer { id site thumbnail }\n  coverImage { extraLarge large medium color }\n  bannerImage\n  genres\n  synonyms\n  averageScore\n  meanScore\n  popularity\n  favourites\n  trending\n  tags { id name description category rank isMediaSpoiler }\n  studios { nodes { id name isAnimationStudio siteUrl } }\n  isAdult\n  siteUrl\n  nextAiringEpisode {\n    id\n    airingAt\n    episode\n    mediaId\n    timeUntilAiring\n  }\n";
+declare const RELATIONS_FIELDS = "\n  relations {\n    edges {\n      relationType(version: 2)\n      node {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        type\n        format\n        status\n        description(asHtml: false)\n        startDate { year month day }\n        endDate { year month day }\n        season\n        seasonYear\n        episodes\n        chapters\n        volumes\n        coverImage { extraLarge large medium color }\n        genres\n        averageScore\n        meanScore\n        studios { nodes { id name isAnimationStudio siteUrl } }\n        siteUrl\n        nextAiringEpisode {\n          id\n          airingAt\n          episode\n          mediaId\n          timeUntilAiring\n        }\n      }\n    }\n  }\n";
+/** Media Recommendation fields - used for when fetching recommendation for a specific media entry */
+declare const MEDIA_RECOMMENDATION_FIELDS = "\n  __typename\n  id\n  rating\n  mediaRecommendation {\n    __typename\n    id\n    title { romaji english native userPreferred }\n    type\n    format\n    status\n    description(asHtml: false)\n    coverImage { extraLarge large medium color }\n    averageScore\n    meanScore\n   \tepisodes\n   \tchapters\n   \tvolumes\n    nextAiringEpisode {\n      id\n      airingAt\n      episode\n      mediaId\n      timeUntilAiring\n    }\n   \tseason\n   \tseasonYear\n   \tstartDate { year month day }\n    endDate { year month day }\n   \tstudios { nodes { id name isAnimationStudio siteUrl } }\n   \tgenres\n    siteUrl\n  }\n";
+/** Full media fields with relations — used by existing queries for backward compat. */
+declare const MEDIA_FIELDS = "\n  \n  __typename\n  id\n  idMal\n  title { romaji english native userPreferred }\n  type\n  format\n  status\n  description(asHtml: false)\n  startDate { year month day }\n  endDate { year month day }\n  season\n  seasonYear\n  episodes\n  duration\n  chapters\n  volumes\n  countryOfOrigin\n  isLicensed\n  source\n  hashtag\n  trailer { id site thumbnail }\n  coverImage { extraLarge large medium color }\n  bannerImage\n  genres\n  synonyms\n  averageScore\n  meanScore\n  popularity\n  favourites\n  trending\n  tags { id name description category rank isMediaSpoiler }\n  studios { nodes { id name isAnimationStudio siteUrl } }\n  isAdult\n  siteUrl\n  nextAiringEpisode {\n    id\n    airingAt\n    episode\n    mediaId\n    timeUntilAiring\n  }\n\n  \n  relations {\n    edges {\n      relationType(version: 2)\n      node {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        type\n        format\n        status\n        description(asHtml: false)\n        startDate { year month day }\n        endDate { year month day }\n        season\n        seasonYear\n        episodes\n        chapters\n        volumes\n        coverImage { extraLarge large medium color }\n        genres\n        averageScore\n        meanScore\n        studios { nodes { id name isAnimationStudio siteUrl } }\n        siteUrl\n        nextAiringEpisode {\n          id\n          airingAt\n          episode\n          mediaId\n          timeUntilAiring\n        }\n      }\n    }\n  }\n\n";
+/** Character fields without back-reference to media (used when embedding characters inside a Media query). */
+declare const CHARACTER_FIELDS_COMPACT = "\n  __typename\n  id\n  name { first middle last full native alternative }\n  image { large medium }\n  description(asHtml: false)\n  gender\n  dateOfBirth { year month day }\n  age\n  bloodType\n  favourites\n  siteUrl\n";
+/** Compact voice actor fields — lightweight subset for embedding inside character edges. */
+declare const VOICE_ACTOR_FIELDS_COMPACT = "\n  __typename\n  id\n  name { first middle last full native userPreferred }\n  languageV2\n  image { large medium }\n  gender\n  primaryOccupations\n  siteUrl\n";
+declare const CHARACTER_FIELDS = "\n  \n  __typename\n  id\n  name { first middle last full native alternative }\n  image { large medium }\n  description(asHtml: false)\n  gender\n  dateOfBirth { year month day }\n  age\n  bloodType\n  favourites\n  siteUrl\n\n  \n  media(perPage: 10) {\n    nodes {\n      __typename\n      id\n      title { romaji english native userPreferred }\n      type\n      coverImage { large medium }\n      siteUrl\n    }\n  }\n\n";
+declare const CHARACTER_FIELDS_WITH_VA = "\n  \n  __typename\n  id\n  name { first middle last full native alternative }\n  image { large medium }\n  description(asHtml: false)\n  gender\n  dateOfBirth { year month day }\n  age\n  bloodType\n  favourites\n  siteUrl\n\n  \n  media(perPage: 10) {\n    edges {\n      voiceActors {\n        \n  __typename\n  id\n  name { first middle last full native userPreferred }\n  languageV2\n  image { large medium }\n  gender\n  primaryOccupations\n  siteUrl\n\n      }\n      node {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        type\n        coverImage { large medium }\n        siteUrl\n      }\n    }\n  }\n\n";
+declare const STAFF_FIELDS = "\n  __typename\n  id\n  name { first middle last full native }\n  language\n  image { large medium }\n  description(asHtml: false)\n  primaryOccupations\n  gender\n  dateOfBirth { year month day }\n  dateOfDeath { year month day }\n  age\n  yearsActive\n  homeTown\n  bloodType\n  favourites\n  siteUrl\n";
+declare const STAFF_MEDIA_FIELDS = "\n  staffMedia(perPage: $perPage, sort: [POPULARITY_DESC]) {\n    nodes {\n      __typename\n      id\n      title { romaji english native userPreferred }\n      type\n      format\n      status\n      coverImage { extraLarge large medium color }\n      bannerImage\n      genres\n      averageScore\n      meanScore\n      popularity\n      favourites\n      episodes\n      trending\n      hashtag\n      season\n      seasonYear\n      startDate { year month day }\n      endDate { year month day }\n      nextAiringEpisode {\n        id\n        airingAt\n        episode\n        mediaId\n        timeUntilAiring\n      }\n      studios {\n        edges {\n          node {\n            name\n          }\n        }\n      }\n      siteUrl\n    }\n  }\n";
+declare const USER_FIELDS = "\n  __typename\n  id\n  name\n  about(asHtml: false)\n  avatar { large medium }\n  bannerImage\n  isFollowing\n  isFollower\n  donatorTier\n  donatorBadge\n  createdAt\n  siteUrl\n  statistics {\n    anime { count meanScore minutesWatched episodesWatched chaptersRead volumesRead }\n    manga { count meanScore minutesWatched episodesWatched chaptersRead volumesRead }\n  }\n";
+/** Favorites fragment — lightweight fields for each favorite category. */
+declare const USER_FAVORITES_FIELDS = "\n  favourites {\n    anime(perPage: 25) {\n      nodes {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        coverImage { large medium }\n        type\n        format\n        siteUrl\n      }\n    }\n    manga(perPage: 25) {\n      nodes {\n        __typename\n        id\n        title { romaji english native userPreferred }\n        coverImage { large medium }\n        type\n        format\n        siteUrl\n      }\n    }\n    characters(perPage: 25) {\n      nodes {\n        __typename\n        id\n        name { full native }\n        image { large medium }\n        siteUrl\n      }\n    }\n    staff(perPage: 25) {\n      nodes {\n        __typename\n        id\n        name { full native }\n        image { large medium }\n        siteUrl\n      }\n    }\n    studios(perPage: 25) {\n      nodes {\n        __typename\n        id\n        name\n        siteUrl\n      }\n    }\n  }\n";
+declare const MEDIA_LIST_FIELDS = "\n  __typename\n  id\n  mediaId\n  status\n  score(format: POINT_100)\n  progress\n  progressVolumes\n  repeat\n  priority\n  private\n  notes\n  startedAt { year month day }\n  completedAt { year month day }\n  updatedAt\n  createdAt\n  media {\n    \n  __typename\n  id\n  idMal\n  title { romaji english native userPreferred }\n  type\n  format\n  status\n  description(asHtml: false)\n  startDate { year month day }\n  endDate { year month day }\n  season\n  seasonYear\n  episodes\n  duration\n  chapters\n  volumes\n  countryOfOrigin\n  isLicensed\n  source\n  hashtag\n  trailer { id site thumbnail }\n  coverImage { extraLarge large medium color }\n  bannerImage\n  genres\n  synonyms\n  averageScore\n  meanScore\n  popularity\n  favourites\n  trending\n  tags { id name description category rank isMediaSpoiler }\n  studios { nodes { id name isAnimationStudio siteUrl } }\n  isAdult\n  siteUrl\n  nextAiringEpisode {\n    id\n    airingAt\n    episode\n    mediaId\n    timeUntilAiring\n  }\n\n  }\n";
+declare const STUDIO_FIELDS = "\n  __typename\n  id\n  name\n  isAnimationStudio\n  siteUrl\n  favourites\n  media(page: 1, perPage: 25, sort: POPULARITY_DESC) {\n    pageInfo { total perPage currentPage lastPage hasNextPage }\n    nodes {\n      __typename\n      id\n      title { romaji english native userPreferred }\n      type\n      format\n      coverImage { large medium }\n      siteUrl\n    }\n  }\n";
+declare const THREAD_FIELDS = "\n  __typename\n  id\n  title\n  body(asHtml: false)\n  userId\n  replyUserId\n  replyCommentId\n  replyCount\n  viewCount\n  isLocked\n  isSticky\n  isSubscribed\n  repliedAt\n  createdAt\n  updatedAt\n  siteUrl\n  user {\n    __typename\n    id\n    name\n    avatar { large medium }\n  }\n  replyUser {\n    __typename\n    id\n    name\n    avatar { large medium }\n  }\n  categories {\n    __typename\n    id\n    name\n  }\n  mediaCategories {\n    __typename\n    id\n    title { romaji english native userPreferred }\n    type\n    coverImage { large medium }\n    siteUrl\n  }\n  likes {\n    __typename\n    id\n    name\n  }\n";
+
+declare const fragments_CHARACTER_FIELDS: typeof CHARACTER_FIELDS;
+declare const fragments_CHARACTER_FIELDS_COMPACT: typeof CHARACTER_FIELDS_COMPACT;
+declare const fragments_CHARACTER_FIELDS_WITH_VA: typeof CHARACTER_FIELDS_WITH_VA;
+declare const fragments_MEDIA_FIELDS: typeof MEDIA_FIELDS;
+declare const fragments_MEDIA_FIELDS_BASE: typeof MEDIA_FIELDS_BASE;
+declare const fragments_MEDIA_FIELDS_LIGHT: typeof MEDIA_FIELDS_LIGHT;
+declare const fragments_MEDIA_LIST_FIELDS: typeof MEDIA_LIST_FIELDS;
+declare const fragments_MEDIA_RECOMMENDATION_FIELDS: typeof MEDIA_RECOMMENDATION_FIELDS;
+declare const fragments_RELATIONS_FIELDS: typeof RELATIONS_FIELDS;
+declare const fragments_STAFF_FIELDS: typeof STAFF_FIELDS;
+declare const fragments_STAFF_MEDIA_FIELDS: typeof STAFF_MEDIA_FIELDS;
+declare const fragments_STUDIO_FIELDS: typeof STUDIO_FIELDS;
+declare const fragments_THREAD_FIELDS: typeof THREAD_FIELDS;
+declare const fragments_USER_FAVORITES_FIELDS: typeof USER_FAVORITES_FIELDS;
+declare const fragments_USER_FIELDS: typeof USER_FIELDS;
+declare const fragments_VOICE_ACTOR_FIELDS_COMPACT: typeof VOICE_ACTOR_FIELDS_COMPACT;
+declare namespace fragments {
+  export { fragments_CHARACTER_FIELDS as CHARACTER_FIELDS, fragments_CHARACTER_FIELDS_COMPACT as CHARACTER_FIELDS_COMPACT, fragments_CHARACTER_FIELDS_WITH_VA as CHARACTER_FIELDS_WITH_VA, fragments_MEDIA_FIELDS as MEDIA_FIELDS, fragments_MEDIA_FIELDS_BASE as MEDIA_FIELDS_BASE, fragments_MEDIA_FIELDS_LIGHT as MEDIA_FIELDS_LIGHT, fragments_MEDIA_LIST_FIELDS as MEDIA_LIST_FIELDS, fragments_MEDIA_RECOMMENDATION_FIELDS as MEDIA_RECOMMENDATION_FIELDS, fragments_RELATIONS_FIELDS as RELATIONS_FIELDS, fragments_STAFF_FIELDS as STAFF_FIELDS, fragments_STAFF_MEDIA_FIELDS as STAFF_MEDIA_FIELDS, fragments_STUDIO_FIELDS as STUDIO_FIELDS, fragments_THREAD_FIELDS as THREAD_FIELDS, fragments_USER_FAVORITES_FIELDS as USER_FAVORITES_FIELDS, fragments_USER_FIELDS as USER_FIELDS, fragments_VOICE_ACTOR_FIELDS_COMPACT as VOICE_ACTOR_FIELDS_COMPACT };
+}
+
 /**
  * Rate limiter with automatic retry for AniList API.
  *
@@ -1320,4 +1388,4 @@ declare class RateLimiter {
 
 declare function parseAniListMarkdown(text: string): string;
 
-export { type AiringSchedule, AiringSort, AniListClient, AniListClientOptions, AniListError, CacheAdapter, CacheOptions, type CacheStats, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type DayOfWeek, ExternalLink, type FavoriteCharacterNode, type FavoriteMediaNode, type FavoriteStaffNode, type FavoriteStudioNode, FuzzyDate, type GetAiringOptions, type GetMediaCharactersOptions, type GetMediaStaffOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, MediaSource, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type NextAiringEpisode, NormalizedCache, PageInfo, PagedResult, RateLimitInfo, RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, ResponseMeta, type Review, ReviewSort, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchReviewOptions, type SearchStaffOptions, type SearchStudioOptions, type SearchThreadOptions, type SearchUserOptions, type Staff, type StaffImage, type StaffIncludeOptions, type StaffMediaNode, type StaffName, StaffSort, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioIncludeOptions, StudioSort, type Thread, type ThreadCategory, type ThreadMediaCategory, ThreadSort, type User, type UserAvatar, type UserFavorites, type UserFavoritesOptions, UserSort, type UserStatistics, type VoiceActor, type WeeklySchedule, parseAniListMarkdown };
+export { type AiringSchedule, AiringSort, AniListClient, AniListClientOptions, AniListError, CacheAdapter, CacheOptions, type CacheStats, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type DayOfWeek, ExternalLink, type FavoriteCharacterNode, type FavoriteMediaNode, type FavoriteStaffNode, type FavoriteStudioNode, fragments as Fragments, FuzzyDate, type GetAiringOptions, type GetMediaCharactersOptions, type GetMediaStaffOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, MediaSource, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type NextAiringEpisode, NormalizedCache, PageInfo, PagedResult, RateLimitInfo, RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, ResponseMeta, type Review, ReviewSort, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchReviewOptions, type SearchStaffOptions, type SearchStudioOptions, type SearchThreadOptions, type SearchUserOptions, type Staff, type StaffImage, type StaffIncludeOptions, type StaffMediaNode, type StaffName, StaffSort, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioIncludeOptions, StudioSort, type Thread, type ThreadCategory, type ThreadMediaCategory, ThreadSort, type User, type UserAvatar, type UserFavorites, type UserFavoritesOptions, UserSort, type UserStatistics, type VoiceActor, type WeeklySchedule, parseAniListMarkdown };

package/dist/index.js

@@ -1,10 +1,17 @@
 'use strict';
 
+var __defProp = Object.defineProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+
 // src/utils/dataloader.ts
 var BatchLoader = class {
-  constructor(batchFetch, maxWaitMs = 50) {
+  constructor(batchFetch, maxWaitMs = 50, maxBatchSize = 50) {
     this.batchFetch = batchFetch;
     this.maxWaitMs = maxWaitMs;
+    this.maxBatchSize = maxBatchSize;
   }
   queue = /* @__PURE__ */ new Map();
   timeout = null;
@@ -20,10 +27,21 @@ var BatchLoader = class {
         this.queue.set(id, callbacks);
       }
       callbacks.push({ resolve, reject });
+      if (this.queue.size >= this.maxBatchSize) {
+        if (this.timeout) {
+          clearTimeout(this.timeout);
+          this.timeout = null;
+        }
+        void this.dispatch();
+        return;
+      }
       if (this.timeout === null) {
-        this.timeout = setTimeout(() => this.dispatch(), this.maxWaitMs);
-        if (typeof this.timeout.unref === "function") {
-          this.timeout.unref();
+        this.timeout = setTimeout(() => {
+          void this.dispatch();
+        }, this.maxWaitMs);
+        const timer = this.timeout;
+        if (typeof timer.unref === "function") {
+          timer.unref();
         }
       }
     });
@@ -632,6 +650,25 @@ var AniListError = class _AniListError extends Error {
 };
 
 // src/queries/fragments.ts
+var fragments_exports = {};
+__export(fragments_exports, {
+  CHARACTER_FIELDS: () => CHARACTER_FIELDS,
+  CHARACTER_FIELDS_COMPACT: () => CHARACTER_FIELDS_COMPACT,
+  CHARACTER_FIELDS_WITH_VA: () => CHARACTER_FIELDS_WITH_VA,
+  MEDIA_FIELDS: () => MEDIA_FIELDS,
+  MEDIA_FIELDS_BASE: () => MEDIA_FIELDS_BASE,
+  MEDIA_FIELDS_LIGHT: () => MEDIA_FIELDS_LIGHT,
+  MEDIA_LIST_FIELDS: () => MEDIA_LIST_FIELDS,
+  MEDIA_RECOMMENDATION_FIELDS: () => MEDIA_RECOMMENDATION_FIELDS,
+  RELATIONS_FIELDS: () => RELATIONS_FIELDS,
+  STAFF_FIELDS: () => STAFF_FIELDS,
+  STAFF_MEDIA_FIELDS: () => STAFF_MEDIA_FIELDS,
+  STUDIO_FIELDS: () => STUDIO_FIELDS,
+  THREAD_FIELDS: () => THREAD_FIELDS,
+  USER_FAVORITES_FIELDS: () => USER_FAVORITES_FIELDS,
+  USER_FIELDS: () => USER_FIELDS,
+  VOICE_ACTOR_FIELDS_COMPACT: () => VOICE_ACTOR_FIELDS_COMPACT
+});
 var MEDIA_FIELDS_LIGHT = `
   __typename
   id
@@ -1322,6 +1359,9 @@ function buildMediaIncludeQuery(include) {
       statusDistribution { status amount }
     }`);
   }
+  if (include.customFields) {
+    extra.push(include.customFields);
+  }
   return extra;
 }
 function buildMediaByIdQuery(include) {
@@ -1549,6 +1589,14 @@ query ($id: Int!) {
     ${CHARACTER_FIELDS_WITH_VA}
   }
 }`;
+function buildCharacterByIdQuery(include) {
+  if (!include?.customFields) {
+    return include?.voiceActors ? QUERY_CHARACTER_BY_ID_WITH_VA : QUERY_CHARACTER_BY_ID;
+  }
+  const fields = include.voiceActors ? CHARACTER_FIELDS_WITH_VA : CHARACTER_FIELDS;
+  return `query ($id: Int!) { Character(id: $id) { ${fields}
+${include.customFields} } }`;
+}
 var QUERY_CHARACTER_SEARCH = `
 query ($search: String, $sort: [CharacterSort], $page: Int, $perPage: Int) {
   Page(page: $page, perPage: $perPage) {
@@ -1667,6 +1715,15 @@ query ($id: Int!, $perPage: Int) {
     ${STAFF_MEDIA_FIELDS}
   }
 }`;
+function buildStaffByIdQuery(include) {
+  if (!include?.customFields) {
+    return include?.characterRoles || include?.media ? QUERY_STAFF_BY_ID_WITH_MEDIA : QUERY_STAFF_BY_ID;
+  }
+  const extra = include?.characterRoles || include?.media ? `
+    ${STAFF_MEDIA_FIELDS}` : "";
+  return `query ($id: Int!, $perPage: Int) { Staff(id: $id) { ${STAFF_FIELDS}${extra}
+${include.customFields} } }`;
+}
 var QUERY_STAFF_SEARCH = `
 query ($search: String, $sort: [StaffSort], $page: Int, $perPage: Int) {
   Page(page: $page, perPage: $perPage) {
@@ -1684,9 +1741,15 @@ query ($id: Int!) {
     ${STUDIO_FIELDS}
   }
 }`;
-function buildStudioByIdQuery(mediaPerPage) {
-  if (mediaPerPage === void 0) return QUERY_STUDIO_BY_ID;
-  const pp = clampPerPage(mediaPerPage);
+function buildStudioByIdQuery(include) {
+  const custom = include?.customFields ? `
+    ${include.customFields}` : "";
+  if (!include?.media) {
+    if (!custom) return QUERY_STUDIO_BY_ID;
+    return `query ($id: Int!) { Studio(id: $id) { ${STUDIO_FIELDS}${custom} } }`;
+  }
+  const mediaOpts = typeof include.media === "object" ? include.media : {};
+  const pp = clampPerPage(mediaOpts.perPage ?? 25);
   return `
 query ($id: Int!) {
   Studio(id: $id) {
@@ -1700,7 +1763,7 @@ query ($id: Int!) {
       nodes {
         ${MEDIA_FIELDS_LIGHT}
       }
-    }
+    }${custom}
   }
 }`;
 }
@@ -1983,7 +2046,7 @@ function isNetworkError(err) {
 // src/client/character.ts
 async function getCharacter(client, id, include) {
   validateId(id, "characterId");
-  const query = include?.voiceActors ? QUERY_CHARACTER_BY_ID_WITH_VA : QUERY_CHARACTER_BY_ID;
+  const query = buildCharacterByIdQuery(include);
   const data = await client.request(query, { id });
   return data.Character;
 }
@@ -2460,12 +2523,13 @@ async function searchReviews(client, options = {}) {
 // src/client/staff.ts
 async function getStaff(client, id, include) {
   validateId(id, "staffId");
-  if (include?.media) {
+  const query = buildStaffByIdQuery(include);
+  if (include?.characterRoles || include?.media) {
     const perPage = typeof include.media === "object" ? include.media.perPage ?? 25 : 25;
-    const data2 = await client.request(QUERY_STAFF_BY_ID_WITH_MEDIA, { id, perPage });
+    const data2 = await client.request(query, { id, perPage });
     return data2.Staff;
   }
-  const data = await client.request(QUERY_STAFF_BY_ID, { id });
+  const data = await client.request(query, { id });
   return data.Staff;
 }
 async function searchStaff(client, options = {}) {
@@ -2480,13 +2544,8 @@ async function searchStaff(client, options = {}) {
 // src/client/studio.ts
 async function getStudio(client, id, include) {
   validateId(id, "studioId");
-  if (include?.media) {
-    const perPage = typeof include.media === "object" ? include.media.perPage : void 0;
-    const query = buildStudioByIdQuery(perPage);
-    const data2 = await client.request(query, { id });
-    return data2.Studio;
-  }
-  const data = await client.request(QUERY_STUDIO_BY_ID, { id });
+  const query = buildStudioByIdQuery(include);
+  const data = await client.request(query, { id });
   return data.Studio;
 }
 async function searchStudios(client, options = {}) {
@@ -2588,7 +2647,7 @@ function mapFavorites(fav) {
 
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
-var LIB_VERSION = "2.4.0" ;
+var LIB_VERSION = "2.5.0" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -2603,6 +2662,7 @@ var AniListClient = class {
   mediaLoader;
   characterLoader;
   staffLoader;
+  batchingEnabled;
   constructor(options = {}) {
     this.apiUrl = options.apiUrl ?? DEFAULT_API_URL;
     this.headers = {
@@ -2618,9 +2678,12 @@ var AniListClient = class {
     this.hooks = options.hooks ?? {};
     this.logger = options.logger;
     this.signal = options.signal;
-    this.mediaLoader = new BatchLoader((ids) => this.getMediaBatch(ids), 50);
-    this.characterLoader = new BatchLoader((ids) => this.getCharacterBatch(ids), 50);
-    this.staffLoader = new BatchLoader((ids) => this.getStaffBatch(ids), 50);
+    this.batchingEnabled = options.batching?.enabled ?? true;
+    const windowMs = options.batching?.windowMs ?? 50;
+    const maxBatchSize = options.batching?.maxBatchSize ?? 50;
+    this.mediaLoader = new BatchLoader((ids) => this.getMediaBatch(ids), windowMs, maxBatchSize);
+    this.characterLoader = new BatchLoader((ids) => this.getCharacterBatch(ids), windowMs, maxBatchSize);
+    this.staffLoader = new BatchLoader((ids) => this.getStaffBatch(ids), windowMs, maxBatchSize);
   }
   /**
    * The current rate limit information from the last API response.
@@ -2723,6 +2786,17 @@ var AniListClient = class {
         remaining: Number.parseInt(rlRemaining, 10),
         reset: Number.parseInt(rlReset, 10)
       };
+      const remainingPercent = this._rateLimitInfo.remaining / this._rateLimitInfo.limit;
+      if (remainingPercent <= 0.15) {
+        const resetIn = this._rateLimitInfo.reset - Math.floor(Date.now() / 1e3);
+        const resetInSeconds = resetIn > 0 ? resetIn : 0;
+        this.logger?.warn("Smart Alert: AniList API rate limit is critically low", {
+          remaining: this._rateLimitInfo.remaining,
+          limit: this._rateLimitInfo.limit,
+          resetInSeconds
+        });
+        this.hooks.onRateLimitAlert?.(this._rateLimitInfo.remaining, resetInSeconds);
+      }
     }
     const durationMs = Date.now() - start;
     const data = json.data;
@@ -2751,10 +2825,10 @@ var AniListClient = class {
    * @param include - Optional related data to include
    */
   async getMedia(id, include) {
-    if (!include) {
-      return this.mediaLoader.load(id);
+    if (!this.batchingEnabled || include) {
+      return getMedia(this, id, include);
     }
-    return getMedia(this, id, include);
+    return this.mediaLoader.load(id);
   }
   async getMediaCharacters(mediaId, options = {}) {
     return getMediaCharacters(this, mediaId, options);
@@ -2822,10 +2896,10 @@ var AniListClient = class {
   }
   /** Fetch a character by AniList ID. Pass `{ voiceActors: true }` to include VA data. */
   async getCharacter(id, include) {
-    if (!include) {
-      return this.characterLoader.load(id);
+    if (!this.batchingEnabled || include) {
+      return getCharacter(this, id, include);
     }
-    return getCharacter(this, id, include);
+    return this.characterLoader.load(id);
   }
   /** Search for characters by name. */
   async searchCharacters(options = {}) {
@@ -2833,10 +2907,10 @@ var AniListClient = class {
   }
   /** Fetch a staff member by AniList ID. Pass `{ media: true }` or `{ media: { perPage } }` for media credits. */
   async getStaff(id, include) {
-    if (!include) {
-      return this.staffLoader.load(id);
+    if (!this.batchingEnabled || include) {
+      return getStaff(this, id, include);
     }
-    return getStaff(this, id, include);
+    return this.staffLoader.load(id);
   }
   /** Search for staff (voice actors, directors, etc.). */
   async searchStaff(options = {}) {
@@ -2950,6 +3024,19 @@ var AniListClient = class {
       page++;
     }
   }
+  /**
+   * Utility to fetch all pages of a paginated request and return them as a single array.
+   *
+   * @param fetchPage - A function that takes a page number and returns a `PagedResult<T>`
+   * @param maxPages - Maximum number of pages to fetch (default: Infinity)
+   */
+  async fetchAll(fetchPage, maxPages = Number.POSITIVE_INFINITY) {
+    const results = [];
+    for await (const item of this.paginate(fetchPage, maxPages)) {
+      results.push(item);
+    }
+    return results;
+  }
   /** Fetch multiple media entries in a single API request. */
   async getMediaBatch(ids) {
     if (ids.length === 0) return [];
@@ -3042,6 +3129,7 @@ exports.AniListClient = AniListClient;
 exports.AniListError = AniListError;
 exports.CharacterRole = CharacterRole;
 exports.CharacterSort = CharacterSort;
+exports.Fragments = fragments_exports;
 exports.MediaFormat = MediaFormat;
 exports.MediaListSort = MediaListSort;
 exports.MediaListStatus = MediaListStatus;