ani-client 1.4.1 → 1.4.3

package/dist/index.js

@@ -129,6 +129,46 @@ var STAFF_FIELDS = `
   favourites
   siteUrl
 `;
+var STAFF_MEDIA_FIELDS = `
+  staffMedia(perPage: $perPage, sort: [POPULARITY_DESC]) {
+    nodes {
+      id
+      title { romaji english native userPreferred }
+      type
+      format
+      status
+      coverImage { extraLarge large medium color }
+      bannerImage
+      genres
+      averageScore
+      meanScore
+      popularity
+      favourites
+      episodes
+      trending
+      hashtag
+      season
+      seasonYear
+      startDate { year month day }
+      endDate { year month day }
+      nextAiringEpisode {
+        id
+        airingAt
+        episode
+        mediaId
+        timeUntilAiring
+      }
+      studios {
+        edges {
+          node {
+            name
+          }
+        }
+      }
+      siteUrl
+    }
+  }
+`;
 var USER_FIELDS = `
   id
   name
@@ -230,6 +270,13 @@ query ($id: Int!) {
     ${STAFF_FIELDS}
   }
 }`;
+var QUERY_STAFF_BY_ID_WITH_MEDIA = `
+query ($id: Int!, $perPage: Int) {
+  Staff(id: $id) {
+    ${STAFF_FIELDS}
+    ${STAFF_MEDIA_FIELDS}
+  }
+}`;
 var QUERY_STAFF_SEARCH = `
 query ($search: String, $sort: [StaffSort], $page: Int, $perPage: Int) {
   Page(page: $page, perPage: $perPage) {
@@ -582,6 +629,7 @@ var AniListError = class _AniListError extends Error {
     this.name = "AniListError";
     this.status = status;
     this.errors = errors;
+    Object.setPrototypeOf(this, _AniListError.prototype);
     if (Error.captureStackTrace) {
       Error.captureStackTrace(this, _AniListError);
     }
@@ -683,7 +731,7 @@ function isNetworkError(err) {
   return false;
 }
 
-// src/types/index.ts
+// src/types/media.ts
 var MediaType = /* @__PURE__ */ ((MediaType2) => {
   MediaType2["ANIME"] = "ANIME";
   MediaType2["MANGA"] = "MANGA";
@@ -764,22 +812,6 @@ var AiringSort = /* @__PURE__ */ ((AiringSort2) => {
   AiringSort2["EPISODE_DESC"] = "EPISODE_DESC";
   return AiringSort2;
 })(AiringSort || {});
-var CharacterSort = /* @__PURE__ */ ((CharacterSort2) => {
-  CharacterSort2["ID"] = "ID";
-  CharacterSort2["ID_DESC"] = "ID_DESC";
-  CharacterSort2["ROLE"] = "ROLE";
-  CharacterSort2["ROLE_DESC"] = "ROLE_DESC";
-  CharacterSort2["SEARCH_MATCH"] = "SEARCH_MATCH";
-  CharacterSort2["FAVOURITES"] = "FAVOURITES";
-  CharacterSort2["FAVOURITES_DESC"] = "FAVOURITES_DESC";
-  return CharacterSort2;
-})(CharacterSort || {});
-var CharacterRole = /* @__PURE__ */ ((CharacterRole2) => {
-  CharacterRole2["MAIN"] = "MAIN";
-  CharacterRole2["SUPPORTING"] = "SUPPORTING";
-  CharacterRole2["BACKGROUND"] = "BACKGROUND";
-  return CharacterRole2;
-})(CharacterRole || {});
 var MediaRelationType = /* @__PURE__ */ ((MediaRelationType2) => {
   MediaRelationType2["ADAPTATION"] = "ADAPTATION";
   MediaRelationType2["PREQUEL"] = "PREQUEL";
@@ -803,6 +835,26 @@ var RecommendationSort = /* @__PURE__ */ ((RecommendationSort2) => {
   RecommendationSort2["RATING_DESC"] = "RATING_DESC";
   return RecommendationSort2;
 })(RecommendationSort || {});
+
+// src/types/character.ts
+var CharacterSort = /* @__PURE__ */ ((CharacterSort2) => {
+  CharacterSort2["ID"] = "ID";
+  CharacterSort2["ID_DESC"] = "ID_DESC";
+  CharacterSort2["ROLE"] = "ROLE";
+  CharacterSort2["ROLE_DESC"] = "ROLE_DESC";
+  CharacterSort2["SEARCH_MATCH"] = "SEARCH_MATCH";
+  CharacterSort2["FAVOURITES"] = "FAVOURITES";
+  CharacterSort2["FAVOURITES_DESC"] = "FAVOURITES_DESC";
+  return CharacterSort2;
+})(CharacterSort || {});
+var CharacterRole = /* @__PURE__ */ ((CharacterRole2) => {
+  CharacterRole2["MAIN"] = "MAIN";
+  CharacterRole2["SUPPORTING"] = "SUPPORTING";
+  CharacterRole2["BACKGROUND"] = "BACKGROUND";
+  return CharacterRole2;
+})(CharacterRole || {});
+
+// src/types/lists.ts
 var MediaListStatus = /* @__PURE__ */ ((MediaListStatus2) => {
   MediaListStatus2["CURRENT"] = "CURRENT";
   MediaListStatus2["PLANNING"] = "PLANNING";
@@ -846,6 +898,18 @@ var MediaListSort = /* @__PURE__ */ ((MediaListSort2) => {
   return MediaListSort2;
 })(MediaListSort || {});
 
+// src/utils/index.ts
+function clampPerPage(value) {
+  return Math.min(Math.max(value, 1), 50);
+}
+function chunk(arr, size) {
+  const chunks = [];
+  for (let i = 0; i < arr.length; i += size) {
+    chunks.push(arr.slice(i, i + size));
+  }
+  return chunks;
+}
+
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
 var AniListClient = class {
@@ -888,12 +952,13 @@ var AniListClient = class {
   async executeRequest(query, variables, cacheKey) {
     const start = Date.now();
     this.hooks.onRequest?.(query, variables);
+    const minifiedQuery = query.replace(/\s+/g, " ").trim();
     const res = await this.rateLimiter.fetchWithRetry(
       this.apiUrl,
       {
         method: "POST",
         headers: this.headers,
-        body: JSON.stringify({ query, variables })
+        body: JSON.stringify({ query: minifiedQuery, variables })
       },
       { onRetry: this.hooks.onRetry, onRateLimit: this.hooks.onRateLimit }
     );
@@ -919,13 +984,6 @@ var AniListClient = class {
     }
     return { pageInfo: data.Page.pageInfo, results };
   }
-  /**
-   * @internal
-   * Clamp perPage to AniList's maximum of 50.
-   */
-  clampPerPage(value) {
-    return Math.min(Math.max(value, 1), 50);
-  }
   /**
    * Fetch a single media entry by its AniList ID.
    *
@@ -985,7 +1043,7 @@ var AniListClient = class {
     const { query: search, page = 1, perPage = 20, ...filters } = options;
     return this.pagedRequest(
       QUERY_MEDIA_SEARCH,
-      { search, ...filters, page, perPage: this.clampPerPage(perPage) },
+      { search, ...filters, page, perPage: clampPerPage(perPage) },
       "media"
     );
   }
@@ -997,7 +1055,7 @@ var AniListClient = class {
    * @param perPage - Results per page (default 20, max 50)
    */
   async getTrending(type = "ANIME" /* ANIME */, page = 1, perPage = 20) {
-    return this.pagedRequest(QUERY_TRENDING, { type, page, perPage: this.clampPerPage(perPage) }, "media");
+    return this.pagedRequest(QUERY_TRENDING, { type, page, perPage: clampPerPage(perPage) }, "media");
   }
   /**
    * Fetch a character by AniList ID.
@@ -1043,7 +1101,7 @@ var AniListClient = class {
     const gqlQuery = voiceActors ? QUERY_CHARACTER_SEARCH_WITH_VA : QUERY_CHARACTER_SEARCH;
     return this.pagedRequest(
       gqlQuery,
-      { search, ...rest, page, perPage: this.clampPerPage(perPage) },
+      { search, ...rest, page, perPage: clampPerPage(perPage) },
       "characters"
     );
   }
@@ -1051,15 +1109,26 @@ var AniListClient = class {
    * Fetch a staff member by AniList ID.
    *
    * @param id - The AniList staff ID
+   * @param include - Optional include options to fetch related data (e.g. media)
    * @returns The staff object
    *
    * @example
    * ```ts
    * const staff = await client.getStaff(95001);
    * console.log(staff.name.full);
+   *
+   * // With media the staff worked on
+   * const staff = await client.getStaff(95001, { media: true });
+   * staff.staffMedia?.nodes.forEach((m) => console.log(m.title.romaji));
    * ```
    */
-  async getStaff(id) {
+  async getStaff(id, include) {
+    if (include?.media) {
+      const opts = typeof include.media === "object" ? include.media : {};
+      const perPage = opts.perPage ?? 25;
+      const data2 = await this.request(QUERY_STAFF_BY_ID_WITH_MEDIA, { id, perPage });
+      return data2.Staff;
+    }
     const data = await this.request(QUERY_STAFF_BY_ID, { id });
     return data.Staff;
   }
@@ -1078,7 +1147,7 @@ var AniListClient = class {
     const { query: search, page = 1, perPage = 20, sort } = options;
     return this.pagedRequest(
       QUERY_STAFF_SEARCH,
-      { search, sort, page, perPage: this.clampPerPage(perPage) },
+      { search, sort, page, perPage: clampPerPage(perPage) },
       "staff"
     );
   }
@@ -1147,7 +1216,7 @@ var AniListClient = class {
       airingAt_lesser: options.airingAtLesser ?? now,
       sort: options.sort ?? ["TIME_DESC"],
       page: options.page ?? 1,
-      perPage: this.clampPerPage(options.perPage ?? 20)
+      perPage: clampPerPage(options.perPage ?? 20)
     };
     return this.pagedRequest(QUERY_AIRING_SCHEDULE, variables, "airingSchedules");
   }
@@ -1170,7 +1239,7 @@ var AniListClient = class {
       QUERY_RECENT_CHAPTERS,
       {
         page: options.page ?? 1,
-        perPage: this.clampPerPage(options.perPage ?? 20)
+        perPage: clampPerPage(options.perPage ?? 20)
       },
       "media"
     );
@@ -1196,7 +1265,7 @@ var AniListClient = class {
         type: options.type,
         sort: options.sort ?? ["POPULARITY_DESC"],
         page: options.page ?? 1,
-        perPage: this.clampPerPage(options.perPage ?? 20)
+        perPage: clampPerPage(options.perPage ?? 20)
       },
       "media"
     );
@@ -1258,7 +1327,7 @@ var AniListClient = class {
         type: options.type ?? "ANIME",
         sort: options.sort ?? ["POPULARITY_DESC"],
         page: options.page ?? 1,
-        perPage: this.clampPerPage(options.perPage ?? 20)
+        perPage: clampPerPage(options.perPage ?? 20)
       },
       "media"
     );
@@ -1300,7 +1369,7 @@ var AniListClient = class {
         status: options.status,
         sort: options.sort,
         page: options.page ?? 1,
-        perPage: this.clampPerPage(options.perPage ?? 20)
+        perPage: clampPerPage(options.perPage ?? 20)
       },
       "mediaList"
     );
@@ -1333,7 +1402,7 @@ var AniListClient = class {
       {
         search: options.query,
         page: options.page ?? 1,
-        perPage: this.clampPerPage(options.perPage ?? 20)
+        perPage: clampPerPage(options.perPage ?? 20)
       },
       "studios"
     );
@@ -1433,23 +1502,14 @@ var AniListClient = class {
   }
   /** @internal */
   async executeBatch(ids, buildQuery, prefix) {
-    const chunks = this.chunk(ids, 50);
-    const chunkResults = await Promise.all(
-      chunks.map(async (chunk) => {
-        const query = buildQuery(chunk);
-        const data = await this.request(query);
-        return chunk.map((_, i) => data[`${prefix}${i}`]);
-      })
-    );
-    return chunkResults.flat();
-  }
-  /** @internal */
-  chunk(arr, size) {
-    const chunks = [];
-    for (let i = 0; i < arr.length; i += size) {
-      chunks.push(arr.slice(i, i + size));
+    const chunks = chunk(ids, 50);
+    const chunkResults = [];
+    for (const idChunk of chunks) {
+      const query = buildQuery(idChunk);
+      const data = await this.request(query);
+      chunkResults.push(idChunk.map((_, i) => data[`${prefix}${i}`]));
     }
-    return chunks;
+    return chunkResults.flat();
   }
   // ── Cache management ──
   /**
@@ -1459,8 +1519,8 @@ var AniListClient = class {
     await this.cacheAdapter.clear();
   }
   /**
-   * Number of entries currently in the cache (sync).
-   * For async adapters like Redis, this may be approximate.
+   * Number of entries currently in the cache.
+   * For async adapters like Redis, this may return a Promise.
    */
   get cacheSize() {
     return this.cacheAdapter.size;
@@ -1538,15 +1598,14 @@ var RedisCache = class {
     }
   }
   /**
-   * Returns -1 because Redis keys can expire silently via TTL.
-   * Use `getSize()` for an accurate count.
+   * Get the actual number of keys with this prefix in Redis.
    */
   get size() {
-    return -1;
+    return this.getSize();
   }
-  /** Get the actual number of keys with this prefix in Redis. */
+  /** @internal */
   async getSize() {
-    const keys = await this.client.keys(`${this.prefix}*`);
+    const keys = await this.collectKeys(`${this.prefix}*`);
     return keys.length;
   }
   async keys() {