ani-client 2.3.0 → 2.4.0

package/README.md

@@ -18,7 +18,8 @@
 - **LRU cache** with TTL, stale-while-revalidate, and hit/miss stats
 - **Rate-limit protection** with exponential backoff, retries, and custom strategies
 - **Request deduplication** — concurrent identical queries share a single in-flight request
-- **Batch queries** — fetch up to 50 media, characters, or staff in a single API call
+- **Automatic batching (DataLoader)** — groups rapid, individual `getMedia(id)` calls within a 50ms window into a single batch query, saving API limits.
+- **Batch queries** — manually fetch up to 50 media, characters, or staff in a single API call
 - **Auto-pagination** — async iterator that yields items across all pages
 - **AbortSignal support** — cancel globally or per-request via `withSignal()`
 - **Injectable logger** — plug in `console`, pino, winston, or any compatible logger

package/dist/index.d.mts

@@ -1069,6 +1069,9 @@ declare class AniListClient implements ClientBase {
     private readonly inFlight;
     private _rateLimitInfo?;
     private _lastRequestMeta?;
+    private readonly mediaLoader;
+    private readonly characterLoader;
+    private readonly staffLoader;
     constructor(options?: AniListClientOptions);
     /**
      * The current rate limit information from the last API response.

package/dist/index.d.ts

@@ -1069,6 +1069,9 @@ declare class AniListClient implements ClientBase {
     private readonly inFlight;
     private _rateLimitInfo?;
     private _lastRequestMeta?;
+    private readonly mediaLoader;
+    private readonly characterLoader;
+    private readonly staffLoader;
     constructor(options?: AniListClientOptions);
     /**
      * The current rate limit information from the last API response.

package/dist/index.js

@@ -1,5 +1,62 @@
 'use strict';
 
+// 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);
@@ -2531,7 +2588,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;
@@ -2543,6 +2600,9 @@ var AniListClient = class {
   inFlight = /* @__PURE__ */ new Map();
   _rateLimitInfo;
   _lastRequestMeta;
+  mediaLoader;
+  characterLoader;
+  staffLoader;
   constructor(options = {}) {
     this.apiUrl = options.apiUrl ?? DEFAULT_API_URL;
     this.headers = {
@@ -2558,6 +2618,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.
@@ -2688,6 +2751,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 = {}) {
@@ -2756,6 +2822,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. */
@@ -2764,6 +2833,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.). */
@@ -2883,7 +2955,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. */
@@ -2891,7 +2963,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. */
@@ -2899,7 +2972,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 */