ani-client 2.3.0 → 2.4.0

package/dist/index.mjs

@@ -1,3 +1,60 @@
+// src/utils/dataloader.ts
+var BatchLoader = class {
+  constructor(batchFetch, maxWaitMs = 50) {
+    this.batchFetch = batchFetch;
+    this.maxWaitMs = maxWaitMs;
+  }
+  queue = /* @__PURE__ */ new Map();
+  timeout = null;
+  /**
+   * Queue an ID to be fetched in the next batch.
+   * Returns a Promise that resolves when the batch request completes.
+   */
+  async load(id) {
+    return new Promise((resolve, reject) => {
+      let callbacks = this.queue.get(id);
+      if (!callbacks) {
+        callbacks = [];
+        this.queue.set(id, callbacks);
+      }
+      callbacks.push({ resolve, reject });
+      if (this.timeout === null) {
+        this.timeout = setTimeout(() => this.dispatch(), this.maxWaitMs);
+        if (typeof this.timeout.unref === "function") {
+          this.timeout.unref();
+        }
+      }
+    });
+  }
+  async dispatch() {
+    this.timeout = null;
+    if (this.queue.size === 0) return;
+    const currentQueue = this.queue;
+    this.queue = /* @__PURE__ */ new Map();
+    const ids = Array.from(currentQueue.keys());
+    try {
+      const results = await this.batchFetch(ids);
+      const resultMap = /* @__PURE__ */ new Map();
+      for (const item of results) {
+        resultMap.set(item.id, item);
+      }
+      for (const [id, callbacks] of currentQueue.entries()) {
+        const result = resultMap.get(id);
+        if (result) {
+          for (const cb of callbacks) cb.resolve(result);
+        } else {
+          const err = new Error(`Item with ID ${id} not found in batch response`);
+          for (const cb of callbacks) cb.reject(err);
+        }
+      }
+    } catch (err) {
+      for (const callbacks of currentQueue.values()) {
+        for (const cb of callbacks) cb.reject(err);
+      }
+    }
+  }
+};
+
 // src/utils/markdown.ts
 function isSafeUrl(url) {
   return /^https?:\/\//i.test(url);
@@ -2529,7 +2586,7 @@ function mapFavorites(fav) {
 
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
-var LIB_VERSION = "2.3.0" ;
+var LIB_VERSION = "2.4.0" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -2541,6 +2598,9 @@ var AniListClient = class {
   inFlight = /* @__PURE__ */ new Map();
   _rateLimitInfo;
   _lastRequestMeta;
+  mediaLoader;
+  characterLoader;
+  staffLoader;
   constructor(options = {}) {
     this.apiUrl = options.apiUrl ?? DEFAULT_API_URL;
     this.headers = {
@@ -2556,6 +2616,9 @@ 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);
   }
   /**
    * The current rate limit information from the last API response.
@@ -2686,6 +2749,9 @@ var AniListClient = class {
    * @param include - Optional related data to include
    */
   async getMedia(id, include) {
+    if (!include) {
+      return this.mediaLoader.load(id);
+    }
     return getMedia(this, id, include);
   }
   async getMediaCharacters(mediaId, options = {}) {
@@ -2754,6 +2820,9 @@ 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);
+    }
     return getCharacter(this, id, include);
   }
   /** Search for characters by name. */
@@ -2762,6 +2831,9 @@ 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);
+    }
     return getStaff(this, id, include);
   }
   /** Search for staff (voice actors, directors, etc.). */
@@ -2881,7 +2953,7 @@ var AniListClient = class {
     if (ids.length === 0) return [];
     validateIds(ids, "mediaId");
     const [singleMediaId] = ids;
-    if (ids.length === 1 && singleMediaId !== void 0) return [await this.getMedia(singleMediaId)];
+    if (ids.length === 1 && singleMediaId !== void 0) return [await getMedia(this, singleMediaId)];
     return this.executeBatch(ids, buildBatchMediaQuery, "m");
   }
   /** Fetch multiple characters in a single API request. */
@@ -2889,7 +2961,8 @@ var AniListClient = class {
     if (ids.length === 0) return [];
     validateIds(ids, "characterId");
     const [singleCharId] = ids;
-    if (ids.length === 1 && singleCharId !== void 0) return [await this.getCharacter(singleCharId)];
+    if (ids.length === 1 && singleCharId !== void 0)
+      return [await getCharacter(this, singleCharId)];
     return this.executeBatch(ids, buildBatchCharacterQuery, "c");
   }
   /** Fetch multiple staff members in a single API request. */
@@ -2897,7 +2970,7 @@ var AniListClient = class {
     if (ids.length === 0) return [];
     validateIds(ids, "staffId");
     const [singleStaffId] = ids;
-    if (ids.length === 1 && singleStaffId !== void 0) return [await this.getStaff(singleStaffId)];
+    if (ids.length === 1 && singleStaffId !== void 0) return [await getStaff(this, singleStaffId)];
     return this.executeBatch(ids, buildBatchStaffQuery, "s");
   }
   /** @internal */