ani-client 2.4.0 → 2.5.0

package/dist/index.mjs

@@ -1,8 +1,15 @@
+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;
@@ -18,10 +25,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();
         }
       }
     });
@@ -630,6 +648,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
@@ -1320,6 +1357,9 @@ function buildMediaIncludeQuery(include) {
       statusDistribution { status amount }
     }`);
   }
+  if (include.customFields) {
+    extra.push(include.customFields);
+  }
   return extra;
 }
 function buildMediaByIdQuery(include) {
@@ -1547,6 +1587,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) {
@@ -1665,6 +1713,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) {
@@ -1682,9 +1739,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) {
@@ -1698,7 +1761,7 @@ query ($id: Int!) {
       nodes {
         ${MEDIA_FIELDS_LIGHT}
       }
-    }
+    }${custom}
   }
 }`;
 }
@@ -1981,7 +2044,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;
 }
@@ -2458,12 +2521,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 = {}) {
@@ -2478,13 +2542,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 = {}) {
@@ -2586,7 +2645,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;
@@ -2601,6 +2660,7 @@ var AniListClient = class {
   mediaLoader;
   characterLoader;
   staffLoader;
+  batchingEnabled;
   constructor(options = {}) {
     this.apiUrl = options.apiUrl ?? DEFAULT_API_URL;
     this.headers = {
@@ -2616,9 +2676,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.
@@ -2721,6 +2784,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;
@@ -2749,10 +2823,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);
@@ -2820,10 +2894,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 = {}) {
@@ -2831,10 +2905,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 = {}) {
@@ -2948,6 +3022,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 [];
@@ -3035,6 +3122,6 @@ var AniListClient = class {
   }
 };
 
-export { AiringSort, AniListClient, AniListError, CharacterRole, CharacterSort, MediaFormat, MediaListSort, MediaListStatus, MediaRelationType, MediaSeason, MediaSort, MediaSource, MediaStatus, MediaType, MemoryCache, NormalizedCache, RateLimiter, RecommendationSort, RedisCache, ReviewSort, StaffSort, StudioSort, ThreadSort, UserSort, parseAniListMarkdown };
+export { AiringSort, AniListClient, AniListError, CharacterRole, CharacterSort, fragments_exports as Fragments, MediaFormat, MediaListSort, MediaListStatus, MediaRelationType, MediaSeason, MediaSort, MediaSource, MediaStatus, MediaType, MemoryCache, NormalizedCache, RateLimiter, RecommendationSort, RedisCache, ReviewSort, StaffSort, StudioSort, ThreadSort, UserSort, parseAniListMarkdown };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map