ani-client 2.1.4 → 2.2.1

package/dist/index.js

@@ -135,6 +135,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;
@@ -246,8 +247,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 });
   }
@@ -255,6 +258,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;
@@ -291,6 +298,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.
@@ -468,7 +485,7 @@ var RedisCache = class {
   constructor(options) {
     this.client = options.client;
     this.prefix = options.prefix ?? "ani:";
-    this.ttl = options.ttl ?? 86400;
+    this.ttl = options.ttl !== void 0 ? Math.floor(options.ttl / 1e3) : 86400;
   }
   prefixedKey(key) {
     return `${this.prefix}${key}`;
@@ -1183,8 +1200,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);
@@ -1259,14 +1275,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 ? `
@@ -2068,7 +2242,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,
@@ -2080,8 +2254,9 @@ async function searchMedia(client, options = {}) {
     format,
     ...filters
   } = options;
+  const query = buildSearchMediaQuery(include);
   return client.pagedRequest(
-    QUERY_MEDIA_SEARCH,
+    query,
     {
       search,
       ...filters,
@@ -2097,21 +2272,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);
@@ -2128,9 +2300,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 ?? [],
@@ -2140,9 +2313,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,
@@ -2167,9 +2341,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,
@@ -2366,7 +2541,7 @@ function mapFavorites(fav) {
 
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
-var LIB_VERSION = "2.1.4" ;
+var LIB_VERSION = "2.2.1" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -2479,7 +2654,8 @@ var AniListClient = class {
       throw error;
     }
     if (!res.ok || json.errors) {
-      const message = json.errors?.[0]?.message ?? `AniList API error (HTTP ${res.status})`;
+      const msgs = (json.errors || []).map((e) => e.message).filter(Boolean);
+      const message = msgs.length > 0 ? msgs.join(" | ") : `AniList API error (HTTP ${res.status})`;
       const error = new AniListError(message, res.status, json.errors ?? []);
       this.logger?.error("Request failed", { error: error.message, status: error.status });
       this.hooks.onError?.(error, query, variables);
@@ -2536,20 +2712,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 = {}) {
@@ -2560,14 +2736,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.
@@ -2583,16 +2753,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) {