ani-client 1.8.1 → 2.0.0

package/README.md

@@ -11,6 +11,8 @@
 
 ✨ **Showcase**: [See who's using ani-client](https://ani-client.js.org/showcase)
 
+**Support server** [Discord server](https://discord.gg/3P7twDurUD)
+
 ## Highlights
 
 - **Zero dependencies** — uses the native `fetch` API

package/dist/index.d.mts

@@ -699,11 +699,19 @@ interface Media {
     siteUrl: string | null;
 }
 interface SearchMediaOptions {
+    /** Search Term */
     query?: string;
+    /** Filter by country code (e.g., "JP", "KR") */
+    countryOfOrigin?: string;
+    /** Filter by Anime or Manga */
     type?: MediaType;
-    format?: MediaFormat;
+    /** Filter by format (For multiple formats: [MediaFormat.TV]) */
+    format?: MediaFormat | MediaFormat[];
+    /** Filter by status of Media */
     status?: MediaStatus;
+    /** Filter by Season (Winter, Spring, Summer, Fall) */
     season?: MediaSeason;
+    /** Filter by Year */
     seasonYear?: number;
     /** Single genre filter (kept for backward compat) */
     genre?: string;
@@ -717,9 +725,23 @@ interface SearchMediaOptions {
     genresExclude?: string[];
     /** Exclude media with any of these tags */
     tagsExclude?: string[];
+    /** Include or Exclude explicit content (default: false) */
     isAdult?: boolean;
+    /** Sort order */
     sort?: MediaSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
+    perPage?: number;
+}
+interface GeneralMediaQueryOptions {
+    /** Filter by Anime or Manga */
+    type?: MediaType;
+    /** Include or Exclude explicit content (default: false) */
+    isAdult?: boolean;
+    /** Page number */
+    page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 interface GetAiringOptions {
@@ -727,12 +749,18 @@ interface GetAiringOptions {
     airingAtGreater?: number;
     /** Only show episodes that aired before this UNIX timestamp */
     airingAtLesser?: number;
+    /** Include or Exclude explicit content (default: false) */
+    isAdult?: boolean;
     /** Sort order (default: TIME_DESC) */
     sort?: AiringSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 interface GetRecentChaptersOptions {
+    /** Include or Exclude explicit content (default: false) */
+    isAdult?: boolean;
     /** Page number (default: 1) */
     page?: number;
     /** Results per page (default: 20, max 50) */
@@ -741,9 +769,13 @@ interface GetRecentChaptersOptions {
 interface GetPlanningOptions {
     /** Filter by ANIME or MANGA (returns both if omitted) */
     type?: MediaType;
+    /** Include or Exclude explicit content (default: false) */
+    isAdult?: boolean;
     /** Sort order (default: POPULARITY_DESC) */
     sort?: MediaSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 declare enum RecommendationSort {
@@ -768,7 +800,9 @@ interface GetRecommendationsOptions {
     mediaId: number;
     /** Sort order (default: RATING_DESC) */
     sort?: RecommendationSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 interface GetSeasonOptions {
@@ -778,9 +812,13 @@ interface GetSeasonOptions {
     seasonYear: number;
     /** Filter by ANIME or MANGA (defaults to ANIME) */
     type?: MediaType;
+    /** Allow or disallow explicit content (defaults to False) */
+    isAdult?: boolean;
     /** Sort order (default: POPULARITY_DESC) */
     sort?: MediaSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 /**
@@ -1168,11 +1206,11 @@ declare class AniListClient {
      */
     searchMedia(options?: SearchMediaOptions): Promise<PagedResult<Media>>;
     /** Get currently trending anime or manga. */
-    getTrending(type?: MediaType, page?: number, perPage?: number): Promise<PagedResult<Media>>;
+    getTrending(options?: GeneralMediaQueryOptions): Promise<PagedResult<Media>>;
     /** Get the most popular anime or manga. */
-    getPopular(type?: MediaType, page?: number, perPage?: number): Promise<PagedResult<Media>>;
+    getPopular(options?: GeneralMediaQueryOptions): Promise<PagedResult<Media>>;
     /** Get the highest-rated anime or manga. */
-    getTopRated(type?: MediaType, page?: number, perPage?: number): Promise<PagedResult<Media>>;
+    getTopRated(options?: GeneralMediaQueryOptions): Promise<PagedResult<Media>>;
     /** Get recently aired anime episodes. */
     getAiredEpisodes(options?: GetAiringOptions): Promise<PagedResult<AiringSchedule>>;
     /**
@@ -1310,7 +1348,7 @@ declare class AniListError extends Error {
 /**
  * Rate limiter with automatic retry for AniList API.
  *
- * AniList allows 90 requests per minute.
+ * AniList allows 30 requests per minute.
  * When a 429 (Too Many Requests) is received, the client
  * waits for the Retry-After header and retries automatically.
  */

package/dist/index.d.ts

@@ -699,11 +699,19 @@ interface Media {
     siteUrl: string | null;
 }
 interface SearchMediaOptions {
+    /** Search Term */
     query?: string;
+    /** Filter by country code (e.g., "JP", "KR") */
+    countryOfOrigin?: string;
+    /** Filter by Anime or Manga */
     type?: MediaType;
-    format?: MediaFormat;
+    /** Filter by format (For multiple formats: [MediaFormat.TV]) */
+    format?: MediaFormat | MediaFormat[];
+    /** Filter by status of Media */
     status?: MediaStatus;
+    /** Filter by Season (Winter, Spring, Summer, Fall) */
     season?: MediaSeason;
+    /** Filter by Year */
     seasonYear?: number;
     /** Single genre filter (kept for backward compat) */
     genre?: string;
@@ -717,9 +725,23 @@ interface SearchMediaOptions {
     genresExclude?: string[];
     /** Exclude media with any of these tags */
     tagsExclude?: string[];
+    /** Include or Exclude explicit content (default: false) */
     isAdult?: boolean;
+    /** Sort order */
     sort?: MediaSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
+    perPage?: number;
+}
+interface GeneralMediaQueryOptions {
+    /** Filter by Anime or Manga */
+    type?: MediaType;
+    /** Include or Exclude explicit content (default: false) */
+    isAdult?: boolean;
+    /** Page number */
+    page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 interface GetAiringOptions {
@@ -727,12 +749,18 @@ interface GetAiringOptions {
     airingAtGreater?: number;
     /** Only show episodes that aired before this UNIX timestamp */
     airingAtLesser?: number;
+    /** Include or Exclude explicit content (default: false) */
+    isAdult?: boolean;
     /** Sort order (default: TIME_DESC) */
     sort?: AiringSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 interface GetRecentChaptersOptions {
+    /** Include or Exclude explicit content (default: false) */
+    isAdult?: boolean;
     /** Page number (default: 1) */
     page?: number;
     /** Results per page (default: 20, max 50) */
@@ -741,9 +769,13 @@ interface GetRecentChaptersOptions {
 interface GetPlanningOptions {
     /** Filter by ANIME or MANGA (returns both if omitted) */
     type?: MediaType;
+    /** Include or Exclude explicit content (default: false) */
+    isAdult?: boolean;
     /** Sort order (default: POPULARITY_DESC) */
     sort?: MediaSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 declare enum RecommendationSort {
@@ -768,7 +800,9 @@ interface GetRecommendationsOptions {
     mediaId: number;
     /** Sort order (default: RATING_DESC) */
     sort?: RecommendationSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 interface GetSeasonOptions {
@@ -778,9 +812,13 @@ interface GetSeasonOptions {
     seasonYear: number;
     /** Filter by ANIME or MANGA (defaults to ANIME) */
     type?: MediaType;
+    /** Allow or disallow explicit content (defaults to False) */
+    isAdult?: boolean;
     /** Sort order (default: POPULARITY_DESC) */
     sort?: MediaSort[];
+    /** Page number */
     page?: number;
+    /** Results per page (max 50) */
     perPage?: number;
 }
 /**
@@ -1168,11 +1206,11 @@ declare class AniListClient {
      */
     searchMedia(options?: SearchMediaOptions): Promise<PagedResult<Media>>;
     /** Get currently trending anime or manga. */
-    getTrending(type?: MediaType, page?: number, perPage?: number): Promise<PagedResult<Media>>;
+    getTrending(options?: GeneralMediaQueryOptions): Promise<PagedResult<Media>>;
     /** Get the most popular anime or manga. */
-    getPopular(type?: MediaType, page?: number, perPage?: number): Promise<PagedResult<Media>>;
+    getPopular(options?: GeneralMediaQueryOptions): Promise<PagedResult<Media>>;
     /** Get the highest-rated anime or manga. */
-    getTopRated(type?: MediaType, page?: number, perPage?: number): Promise<PagedResult<Media>>;
+    getTopRated(options?: GeneralMediaQueryOptions): Promise<PagedResult<Media>>;
     /** Get recently aired anime episodes. */
     getAiredEpisodes(options?: GetAiringOptions): Promise<PagedResult<AiringSchedule>>;
     /**
@@ -1310,7 +1348,7 @@ declare class AniListError extends Error {
 /**
  * Rate limiter with automatic retry for AniList API.
  *
- * AniList allows 90 requests per minute.
+ * AniList allows 30 requests per minute.
  * When a 429 (Too Many Requests) is received, the client
  * waits for the Retry-After header and retries automatically.
  */

package/dist/index.js

@@ -436,7 +436,17 @@ var RELATIONS_FIELDS = `
         type
         format
         status
-        coverImage { large medium }
+        startDate { year month day }
+        endDate { year month day }
+        season
+        seasonYear
+        episodes
+        chapters
+        volumes
+        coverImage { extraLarge large medium color }
+        genres
+        averageScore
+        studios { nodes { id name isAnimationStudio siteUrl } }
         siteUrl
       }
     }
@@ -713,8 +723,10 @@ query ($id: Int!) {
 var QUERY_MEDIA_SEARCH = `
 query (
   $search: String,
+  $countryOfOrigin: CountryCode,
   $type: MediaType,
   $format: MediaFormat,
+  $format_in: [MediaFormat],
   $status: MediaStatus,
   $season: MediaSeason,
   $seasonYear: Int,
@@ -733,8 +745,10 @@ query (
     pageInfo { total perPage currentPage lastPage hasNextPage }
     media(
       search: $search,
+      countryOfOrigin: $countryOfOrigin,
       type: $type,
       format: $format,
+      format_in: $format_in,
       status: $status,
       season: $season,
       seasonYear: $seasonYear,
@@ -752,16 +766,16 @@ query (
   }
 }`;
 var QUERY_TRENDING = `
-query ($type: MediaType, $page: Int, $perPage: Int) {
+query ($type: MediaType, $isAdult: Boolean, $page: Int, $perPage: Int) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
-    media(type: $type, sort: TRENDING_DESC) {
+    media(type: $type, isAdult: $isAdult, sort: TRENDING_DESC) {
       ${MEDIA_FIELDS_BASE}
     }
   }
 }`;
 var QUERY_AIRING_SCHEDULE = `
-query ($airingAt_greater: Int, $airingAt_lesser: Int, $sort: [AiringSort], $page: Int, $perPage: Int) {
+query ($airingAt_greater: Int, $airingAt_lesser: Int, $isAdult: Boolean, $sort: [AiringSort], $page: Int, $perPage: Int) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
     airingSchedules(airingAt_greater: $airingAt_greater, airingAt_lesser: $airingAt_lesser, sort: $sort) {
@@ -770,35 +784,49 @@ query ($airingAt_greater: Int, $airingAt_lesser: Int, $sort: [AiringSort], $page
       timeUntilAiring
       episode
       mediaId
-      media {
+      media(isAdult: $isAdult) {
         ${MEDIA_FIELDS_BASE}
       }
     }
   }
 }`;
 var QUERY_RECENT_CHAPTERS = `
-query ($page: Int, $perPage: Int) {
+query ($isAdult: Boolean $page: Int, $perPage: Int) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
-    media(type: MANGA, status: RELEASING, sort: UPDATED_AT_DESC) {
+    media(type: MANGA, isAdult: $isAdult status: RELEASING, sort: UPDATED_AT_DESC) {
       ${MEDIA_FIELDS_BASE}
     }
   }
 }`;
 var QUERY_PLANNING = `
-query ($type: MediaType, $sort: [MediaSort], $page: Int, $perPage: Int) {
+query ($type: MediaType, $isAdult: Boolean, $sort: [MediaSort], $page: Int, $perPage: Int) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
-    media(type: $type, status: NOT_YET_RELEASED, sort: $sort) {
+    media(type: $type, isAdult: $isAdult, status: NOT_YET_RELEASED, sort: $sort) {
       ${MEDIA_FIELDS_BASE}
     }
   }
 }`;
 var QUERY_MEDIA_BY_SEASON = `
-query ($season: MediaSeason!, $seasonYear: Int!, $type: MediaType, $sort: [MediaSort], $page: Int, $perPage: Int) {
+query (
+  $season: MediaSeason!,
+  $seasonYear: Int!,
+  $type: MediaType,
+  $isAdult: Boolean,
+  $sort: [MediaSort],
+  $page: Int,
+  $perPage: Int
+) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
-    media(season: $season, seasonYear: $seasonYear, type: $type, sort: $sort) {
+    media(
+      season: $season,
+      seasonYear: $seasonYear,
+      type: $type,
+      isAdult: $isAdult,
+      sort: $sort
+    ) {
       ${MEDIA_FIELDS_BASE}
     }
   }
@@ -1197,7 +1225,7 @@ var RateLimiter = class {
   /** @internal — active sleep timers for cleanup */
   activeTimers = /* @__PURE__ */ new Set();
   constructor(options = {}) {
-    this.maxRequests = options.maxRequests ?? 85;
+    this.maxRequests = options.maxRequests ?? 25;
     this.windowMs = options.windowMs ?? 6e4;
     this.maxRetries = options.maxRetries ?? 3;
     this.retryDelayMs = options.retryDelayMs ?? 2e3;
@@ -1600,12 +1628,24 @@ async function getMediaByMalId(client, malId, type) {
   return data.Media;
 }
 async function searchMedia(client, options = {}) {
-  const { query: search, page = 1, perPage = 20, genres, tags, genresExclude, tagsExclude, ...filters } = options;
+  const {
+    query: search,
+    page = 1,
+    perPage = 20,
+    genres,
+    tags,
+    genresExclude,
+    tagsExclude,
+    format,
+    ...filters
+  } = options;
   return client.pagedRequest(
     QUERY_MEDIA_SEARCH,
     {
       search,
       ...filters,
+      format: Array.isArray(format) ? void 0 : format,
+      format_in: Array.isArray(format) ? format : void 0,
       genre_in: genres,
       tag_in: tags,
       genre_not_in: genresExclude,
@@ -1616,14 +1656,17 @@ async function searchMedia(client, options = {}) {
     "media"
   );
 }
-async function getTrending(client, type = "ANIME" /* ANIME */, page = 1, perPage = 20) {
-  return client.pagedRequest(QUERY_TRENDING, { type, page, perPage: clampPerPage(perPage) }, "media");
+async function getTrending(client, options) {
+  const { type = "ANIME" /* ANIME */, isAdult = false, page = 1, perPage = 20 } = options;
+  return client.pagedRequest(QUERY_TRENDING, { type, isAdult, page, perPage: clampPerPage(perPage) }, "media");
 }
-async function getPopular(client, type = "ANIME" /* ANIME */, page = 1, perPage = 20) {
-  return searchMedia(client, { type, sort: ["POPULARITY_DESC" /* POPULARITY_DESC */], page, perPage });
+async function getPopular(client, options) {
+  const { type = "ANIME" /* ANIME */, isAdult = false, page = 1, perPage = 20 } = options;
+  return searchMedia(client, { type, isAdult, sort: ["POPULARITY_DESC" /* POPULARITY_DESC */], page, perPage });
 }
-async function getTopRated(client, type = "ANIME" /* ANIME */, page = 1, perPage = 20) {
-  return searchMedia(client, { type, sort: ["SCORE_DESC" /* SCORE_DESC */], page, perPage });
+async function getTopRated(client, options) {
+  const { type = "ANIME" /* ANIME */, isAdult = false, page = 1, perPage = 20 } = options;
+  return searchMedia(client, { type, isAdult, sort: ["SCORE_DESC" /* SCORE_DESC */], page, perPage });
 }
 async function getAiredEpisodes(client, options = {}) {
   const now = Math.floor(Date.now() / 1e3);
@@ -1632,6 +1675,7 @@ async function getAiredEpisodes(client, options = {}) {
     {
       airingAt_greater: options.airingAtGreater ?? now - 24 * 3600,
       airingAt_lesser: options.airingAtLesser ?? now,
+      isAdult: options.isAdult ?? false,
       sort: options.sort,
       page: options.page ?? 1,
       perPage: clampPerPage(options.perPage ?? 20)
@@ -1643,6 +1687,7 @@ async function getRecentlyUpdatedManga(client, options = {}) {
   return client.pagedRequest(
     QUERY_RECENT_CHAPTERS,
     {
+      isAdult: options.isAdult ?? false,
       page: options.page ?? 1,
       perPage: clampPerPage(options.perPage ?? 20)
     },
@@ -1654,6 +1699,7 @@ async function getPlanning(client, options = {}) {
     QUERY_PLANNING,
     {
       type: options.type,
+      isAdult: options.isAdult ?? false,
       sort: options.sort ?? ["POPULARITY_DESC" /* POPULARITY_DESC */],
       page: options.page ?? 1,
       perPage: clampPerPage(options.perPage ?? 20)
@@ -1681,6 +1727,7 @@ async function getMediaBySeason(client, options) {
       season: options.season,
       seasonYear: options.seasonYear,
       type: options.type,
+      isAdult: options.isAdult ?? false,
       sort: options.sort,
       page: options.page ?? 1,
       perPage: clampPerPage(options.perPage ?? 20)
@@ -1688,7 +1735,7 @@ async function getMediaBySeason(client, options) {
     "media"
   );
 }
-async function getWeeklySchedule(client, date = /* @__PURE__ */ new Date()) {
+async function getWeeklySchedule(client, date = /* @__PURE__ */ new Date(), isAdult = false) {
   const schedule = {
     Monday: [],
     Tuesday: [],
@@ -1710,6 +1757,7 @@ async function getWeeklySchedule(client, date = /* @__PURE__ */ new Date()) {
     (page) => getAiredEpisodes(client, {
       airingAtGreater: startTimestamp,
       airingAtLesser: endTimestamp,
+      isAdult,
       page,
       perPage: 50
     }),
@@ -1855,7 +1903,7 @@ function mapFavorites(fav) {
 
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
-var LIB_VERSION = "1.8.1" ;
+var LIB_VERSION = "2.0.0" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -2008,16 +2056,16 @@ var AniListClient = class {
     return searchMedia(this, options);
   }
   /** Get currently trending anime or manga. */
-  async getTrending(type, page, perPage) {
-    return getTrending(this, type, page, perPage);
+  async getTrending(options = {}) {
+    return getTrending(this, options);
   }
   /** Get the most popular anime or manga. */
-  async getPopular(type, page, perPage) {
-    return getPopular(this, type, page, perPage);
+  async getPopular(options = {}) {
+    return getPopular(this, options);
   }
   /** Get the highest-rated anime or manga. */
-  async getTopRated(type, page, perPage) {
-    return getTopRated(this, type, page, perPage);
+  async getTopRated(options = {}) {
+    return getTopRated(this, options);
   }
   /** Get recently aired anime episodes. */
   async getAiredEpisodes(options = {}) {