ani-client 2.1.3 → 2.2.0

package/dist/index.mjs

@@ -133,6 +133,7 @@ var NormalizedCache = class {
   _hits = 0;
   _misses = 0;
   _stales = 0;
+  gcTimeout;
   constructor(options = {}) {
     this.ttl = options.ttl ?? 24 * 60 * 60 * 1e3;
     this.maxSize = options.maxSize ?? 500;
@@ -244,8 +245,10 @@ var NormalizedCache = class {
     this.queryStore.delete(key);
     if (this.maxSize > 0 && this.queryStore.size >= this.maxSize) {
       const firstKey = this.queryStore.keys().next().value;
-      if (firstKey !== void 0) this.queryStore.delete(firstKey);
-      this.gc();
+      if (firstKey !== void 0) {
+        this.queryStore.delete(firstKey);
+      }
+      this.scheduleGc();
     }
     this.queryStore.set(key, { data: normalizedData, expiresAt: Date.now() + this.ttl });
   }
@@ -253,6 +256,10 @@ var NormalizedCache = class {
     return this.queryStore.delete(key);
   }
   clear() {
+    if (this.gcTimeout) {
+      clearTimeout(this.gcTimeout);
+      this.gcTimeout = void 0;
+    }
     this.queryStore.clear();
     this.entityStore.clear();
     this._hits = 0;
@@ -289,6 +296,16 @@ var NormalizedCache = class {
     this._misses = 0;
     this._stales = 0;
   }
+  scheduleGc() {
+    if (this.gcTimeout) return;
+    this.gcTimeout = setTimeout(() => {
+      this.gc();
+      this.gcTimeout = void 0;
+    }, 500);
+    if (typeof this.gcTimeout.unref === "function") {
+      this.gcTimeout.unref();
+    }
+  }
   /**
    * Garbage-collect orphaned entities that are no longer referenced by any query.
    * Called automatically on LRU eviction to prevent unbounded entity store growth.
@@ -647,6 +664,7 @@ var RELATIONS_FIELDS = `
         type
         format
         status
+        description(asHtml: false)
         startDate { year month day }
         endDate { year month day }
         season
@@ -681,6 +699,8 @@ var MEDIA_RECOMMENDATION_FIELDS = `
     title { romaji english native userPreferred }
     type
     format
+    status
+    description(asHtml: false)
     coverImage { extraLarge large medium color }
     averageScore
     meanScore
@@ -1178,8 +1198,7 @@ query ($mediaId: Int!, $page: Int, $perPage: Int, $sort: [RecommendationSort]) {
 }`;
 
 // src/queries/builders.ts
-function buildMediaByIdQuery(include) {
-  if (!include) return QUERY_MEDIA_BY_ID;
+function buildMediaIncludeQuery(include) {
   const extra = [];
   if (include.relations !== false) {
     extra.push(RELATIONS_FIELDS);
@@ -1254,14 +1273,172 @@ function buildMediaByIdQuery(include) {
       statusDistribution { status amount }
     }`);
   }
+  return extra;
+}
+function buildMediaByIdQuery(include) {
+  if (!include) return QUERY_MEDIA_BY_ID;
   return `
 query ($id: Int!) {
   Media(id: $id) {
     ${MEDIA_FIELDS_BASE}
-    ${extra.join("\n")}
+    ${buildMediaIncludeQuery(include).join("\n")}
   }
 }`;
 }
+function buildSearchMediaQuery(include) {
+  if (!include) return QUERY_MEDIA_SEARCH;
+  return `
+  query (
+    $search: String,
+    $countryOfOrigin: CountryCode,
+    $type: MediaType,
+    $format: MediaFormat,
+    $format_in: [MediaFormat],
+    $status: MediaStatus,
+    $season: MediaSeason,
+    $seasonYear: Int,
+    $genre: String,
+    $tag: String,
+    $genre_in: [String],
+    $tag_in: [String],
+    $genre_not_in: [String],
+    $tag_not_in: [String],
+    $isAdult: Boolean,
+    $idNotIn: [Int],
+    $sort: [MediaSort],
+    $page: Int,
+    $perPage: Int
+  ) {
+    Page(page: $page, perPage: $perPage) {
+      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,
+        genre: $genre,
+        tag: $tag,
+        genre_in: $genre_in,
+        tag_in: $tag_in,
+        genre_not_in: $genre_not_in,
+        tag_not_in: $tag_not_in,
+        isAdult: $isAdult,
+        id_not_in: $idNotIn,
+        sort: $sort
+      ) {
+        ${MEDIA_FIELDS_BASE}
+        ${buildMediaIncludeQuery(include).join("\n")}
+      }
+    }
+  }`;
+}
+function buildGetTrendingQuery(include) {
+  if (!include) return QUERY_TRENDING;
+  return `
+  query (
+    $type: MediaType,
+    $isAdult: Boolean,
+    $idNotIn: [Int],
+    $page: Int,
+    $perPage: Int
+  ) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo { total perPage currentPage lastPage hasNextPage }
+      media(
+        type: $type,
+        isAdult: $isAdult,
+        id_not_in: $idNotIn,
+        sort: TRENDING_DESC
+      ) {
+        ${MEDIA_FIELDS_BASE}
+        ${buildMediaIncludeQuery(include).join("\n")}
+      }
+    }
+  }`;
+}
+function buildGetMediaBySeasonQuery(include) {
+  if (!include) return QUERY_MEDIA_BY_SEASON;
+  return `
+  query (
+    $season: MediaSeason!,
+    $seasonYear: Int!,
+    $type: MediaType,
+    $isAdult: Boolean,
+    $idNotIn: [Int],
+    $sort: [MediaSort],
+    $page: Int,
+    $perPage: Int
+  ) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo { total perPage currentPage lastPage hasNextPage }
+      media(
+        season: $season,
+        seasonYear: $seasonYear,
+        type: $type,
+        isAdult: $isAdult,
+        id_not_in: $idNotIn,
+        sort: $sort
+      ) {
+        ${MEDIA_FIELDS_BASE}
+        ${buildMediaIncludeQuery(include).join("\n")}
+      }
+    }
+  }`;
+}
+function buildGetRecentlyUpdatedMangaQuery(include) {
+  if (!include) return QUERY_RECENT_CHAPTERS;
+  return `
+  query (
+    $isAdult: Boolean,
+    $idNotIn: [Int],
+    $page: Int,
+    $perPage: Int
+  ) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo { total perPage currentPage lastPage hasNextPage }
+      media(
+        type: MANGA,
+        isAdult: $isAdult,
+        id_not_in: $idNotIn,
+        status: RELEASING,
+        sort: UPDATED_AT_DESC
+      ) {
+        ${MEDIA_FIELDS_BASE}
+        ${buildMediaIncludeQuery(include).join("\n")}
+      }
+    }
+  }`;
+}
+function buildGetPlanningQuery(include) {
+  if (!include) return QUERY_PLANNING;
+  return `
+  query (
+    $type: MediaType,
+    $isAdult: Boolean,
+    $idNotIn: [Int],
+    $sort: [MediaSort],
+    $page: Int,
+    $perPage: Int
+  ) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo { total perPage currentPage lastPage hasNextPage }
+      media(
+        type: $type,
+        isAdult: $isAdult,
+        id_not_in: $idNotIn,
+        status: NOT_YET_RELEASED,
+        sort: $sort
+      ) {
+        ${MEDIA_FIELDS_BASE}
+        ${buildMediaIncludeQuery(include).join("\n")}
+      }
+    }
+  }`;
+}
 function buildMediaCharactersQuery(options = {}) {
   const sortClause = options.sort === false ? "" : ", sort: [ROLE, RELEVANCE, ID]";
   const voiceActorBlock = options.voiceActors ? `
@@ -2063,7 +2240,7 @@ async function getMediaByMalId(client, malId, type) {
   });
   return data.Media;
 }
-async function searchMedia(client, options = {}) {
+async function searchMedia(client, options = {}, include) {
   const {
     query: search,
     page = 1,
@@ -2075,8 +2252,9 @@ async function searchMedia(client, options = {}) {
     format,
     ...filters
   } = options;
+  const query = buildSearchMediaQuery(include);
   return client.pagedRequest(
-    QUERY_MEDIA_SEARCH,
+    query,
     {
       search,
       ...filters,
@@ -2092,21 +2270,18 @@ async function searchMedia(client, options = {}) {
     "media"
   );
 }
-async function getTrending(client, options) {
+async function getTrending(client, options, include) {
   const { type = "ANIME" /* ANIME */, isAdult = false, idNotIn = [], page = 1, perPage = 20 } = options;
-  return client.pagedRequest(
-    QUERY_TRENDING,
-    { type, isAdult, idNotIn, page, perPage: clampPerPage(perPage) },
-    "media"
-  );
+  const query = buildGetTrendingQuery(include);
+  return client.pagedRequest(query, { type, isAdult, idNotIn, page, perPage: clampPerPage(perPage) }, "media");
 }
-async function getPopular(client, options) {
+async function getPopular(client, options, include) {
   const { type = "ANIME" /* ANIME */, isAdult = false, idNotIn = [], page = 1, perPage = 20 } = options;
-  return searchMedia(client, { type, isAdult, idNotIn, sort: ["POPULARITY_DESC" /* POPULARITY_DESC */], page, perPage });
+  return searchMedia(client, { type, isAdult, idNotIn, sort: ["POPULARITY_DESC" /* POPULARITY_DESC */], page, perPage }, include);
 }
-async function getTopRated(client, options) {
+async function getTopRated(client, options, include) {
   const { type = "ANIME" /* ANIME */, isAdult = false, idNotIn = [], page = 1, perPage = 20 } = options;
-  return searchMedia(client, { type, isAdult, idNotIn, sort: ["SCORE_DESC" /* SCORE_DESC */], page, perPage });
+  return searchMedia(client, { type, isAdult, idNotIn, sort: ["SCORE_DESC" /* SCORE_DESC */], page, perPage }, include);
 }
 async function getAiredEpisodes(client, options = {}) {
   const now = Math.floor(Date.now() / 1e3);
@@ -2123,9 +2298,10 @@ async function getAiredEpisodes(client, options = {}) {
     "airingSchedules"
   );
 }
-async function getRecentlyUpdatedManga(client, options = {}) {
+async function getRecentlyUpdatedManga(client, options = {}, include) {
+  const query = buildGetRecentlyUpdatedMangaQuery(include);
   return client.pagedRequest(
-    QUERY_RECENT_CHAPTERS,
+    query,
     {
       isAdult: options.isAdult ?? false,
       idNotIn: options.idNotIn ?? [],
@@ -2135,9 +2311,10 @@ async function getRecentlyUpdatedManga(client, options = {}) {
     "media"
   );
 }
-async function getPlanning(client, options = {}) {
+async function getPlanning(client, options = {}, include) {
+  const query = buildGetPlanningQuery(include);
   return client.pagedRequest(
-    QUERY_PLANNING,
+    query,
     {
       type: options.type,
       isAdult: options.isAdult ?? false,
@@ -2162,9 +2339,10 @@ async function getRecommendations(client, mediaId, options = {}) {
     results: data.Media.recommendations.nodes
   };
 }
-async function getMediaBySeason(client, options) {
+async function getMediaBySeason(client, options, include) {
+  const query = buildGetMediaBySeasonQuery(include);
   return client.pagedRequest(
-    QUERY_MEDIA_BY_SEASON,
+    query,
     {
       season: options.season,
       seasonYear: options.seasonYear,
@@ -2361,7 +2539,7 @@ function mapFavorites(fav) {
 
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
-var LIB_VERSION = "2.1.3" ;
+var LIB_VERSION = "2.2.0" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -2531,20 +2709,20 @@ var AniListClient = class {
    * @param options - Search / filter parameters
    * @returns Paginated results with matching media
    */
-  async searchMedia(options = {}) {
-    return searchMedia(this, options);
+  async searchMedia(options = {}, include) {
+    return searchMedia(this, options, include);
   }
   /** Get currently trending anime or manga. */
-  async getTrending(options = {}) {
-    return getTrending(this, options);
+  async getTrending(options = {}, include) {
+    return getTrending(this, options, include);
   }
   /** Get the most popular anime or manga. */
-  async getPopular(options = {}) {
-    return getPopular(this, options);
+  async getPopular(options = {}, include) {
+    return getPopular(this, options, include);
   }
   /** Get the highest-rated anime or manga. */
-  async getTopRated(options = {}) {
-    return getTopRated(this, options);
+  async getTopRated(options = {}, include) {
+    return getTopRated(this, options, include);
   }
   /** Get recently aired anime episodes. */
   async getAiredEpisodes(options = {}) {
@@ -2555,14 +2733,8 @@ var AniListClient = class {
    *
    * @param options - Pagination parameters
    */
-  async getRecentlyUpdatedManga(options = {}) {
-    return getRecentlyUpdatedManga(this, options);
-  }
-  /**
-   * @deprecated Use `getRecentlyUpdatedManga()` instead. This alias will be removed in v3.
-   */
-  async getAiredChapters(options = {}) {
-    return this.getRecentlyUpdatedManga(options);
+  async getRecentlyUpdatedManga(options = {}, include) {
+    return getRecentlyUpdatedManga(this, options, include);
   }
   /**
    * Fetch a media entry by its MyAnimeList (MAL) ID.
@@ -2578,16 +2750,16 @@ var AniListClient = class {
     return getWeeklySchedule(this, date, idNotIn);
   }
   /** Get upcoming (not yet released) media. */
-  async getPlanning(options = {}) {
-    return getPlanning(this, options);
+  async getPlanning(options = {}, include) {
+    return getPlanning(this, options, include);
   }
   /** Get recommendations for a specific media. */
   async getRecommendations(mediaId, options = {}) {
     return getRecommendations(this, mediaId, options);
   }
   /** Get anime (or manga) for a specific season and year. */
-  async getMediaBySeason(options) {
-    return getMediaBySeason(this, options);
+  async getMediaBySeason(options, include) {
+    return getMediaBySeason(this, options, include);
   }
   /** Fetch a character by AniList ID. Pass `{ voiceActors: true }` to include VA data. */
   async getCharacter(id, include) {