ani-client 1.4.0 → 1.4.1

package/dist/index.mjs

@@ -66,8 +66,7 @@ var CHARACTER_FIELDS_COMPACT = `
   favourites
   siteUrl
 `;
-var CHARACTER_FIELDS = `
-  ${CHARACTER_FIELDS_COMPACT}
+var CHARACTER_MEDIA_NODES = `
   media(perPage: 10) {
     nodes {
       id
@@ -78,6 +77,39 @@ var CHARACTER_FIELDS = `
     }
   }
 `;
+var VOICE_ACTOR_FIELDS_COMPACT = `
+  id
+  name { first middle last full native userPreferred }
+  languageV2
+  image { large medium }
+  gender
+  primaryOccupations
+  siteUrl
+`;
+var CHARACTER_MEDIA_EDGES_WITH_VA = `
+  media(perPage: 10) {
+    edges {
+      voiceActors {
+        ${VOICE_ACTOR_FIELDS_COMPACT}
+      }
+      node {
+        id
+        title { romaji english native userPreferred }
+        type
+        coverImage { large medium }
+        siteUrl
+      }
+    }
+  }
+`;
+var CHARACTER_FIELDS = `
+  ${CHARACTER_FIELDS_COMPACT}
+  ${CHARACTER_MEDIA_NODES}
+`;
+var CHARACTER_FIELDS_WITH_VA = `
+  ${CHARACTER_FIELDS_COMPACT}
+  ${CHARACTER_MEDIA_EDGES_WITH_VA}
+`;
 var STAFF_FIELDS = `
   id
   name { first middle last full native }
@@ -166,6 +198,12 @@ query ($id: Int!) {
     ${CHARACTER_FIELDS}
   }
 }`;
+var QUERY_CHARACTER_BY_ID_WITH_VA = `
+query ($id: Int!) {
+  Character(id: $id) {
+    ${CHARACTER_FIELDS_WITH_VA}
+  }
+}`;
 var QUERY_CHARACTER_SEARCH = `
 query ($search: String, $sort: [CharacterSort], $page: Int, $perPage: Int) {
   Page(page: $page, perPage: $perPage) {
@@ -175,6 +213,15 @@ query ($search: String, $sort: [CharacterSort], $page: Int, $perPage: Int) {
     }
   }
 }`;
+var QUERY_CHARACTER_SEARCH_WITH_VA = `
+query ($search: String, $sort: [CharacterSort], $page: Int, $perPage: Int) {
+  Page(page: $page, perPage: $perPage) {
+    pageInfo { total perPage currentPage lastPage hasNextPage }
+    characters(search: $search, sort: $sort) {
+      ${CHARACTER_FIELDS_WITH_VA}
+    }
+  }
+}`;
 var QUERY_STAFF_BY_ID = `
 query ($id: Int!) {
   Staff(id: $id) {
@@ -182,7 +229,7 @@ query ($id: Int!) {
   }
 }`;
 var QUERY_STAFF_SEARCH = `
-query ($search: String, $sort: [CharacterSort], $page: Int, $perPage: Int) {
+query ($search: String, $sort: [StaffSort], $page: Int, $perPage: Int) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
     staff(search: $search, sort: $sort) {
@@ -364,13 +411,17 @@ function buildMediaByIdQuery(include) {
     const opts = typeof include.characters === "object" ? include.characters : {};
     const perPage = opts.perPage ?? 25;
     const sortClause = opts.sort !== false ? ", sort: [ROLE, RELEVANCE, ID]" : "";
+    const voiceActorBlock = opts.voiceActors ? `
+            voiceActors {
+              ${VOICE_ACTOR_FIELDS_COMPACT}
+            }` : "";
     extra.push(`
     characters(perPage: ${perPage}${sortClause}) {
       edges {
         role
         node {
           ${CHARACTER_FIELDS_COMPACT}
-        }
+        }${voiceActorBlock}
       }
     }`);
   }
@@ -890,6 +941,9 @@ var AniListClient = class {
    * // Include characters sorted by role, 25 results
    * const anime = await client.getMedia(1, { characters: true });
    *
+   * // Include characters with voice actors
+   * const anime = await client.getMedia(1, { characters: { voiceActors: true } });
+   *
    * // Full control
    * const anime = await client.getMedia(1, {
    *   characters: { perPage: 50, sort: true },
@@ -927,7 +981,11 @@ var AniListClient = class {
    */
   async searchMedia(options = {}) {
     const { query: search, page = 1, perPage = 20, ...filters } = options;
-    return this.pagedRequest(QUERY_MEDIA_SEARCH, { search, ...filters, page, perPage: this.clampPerPage(perPage) }, "media");
+    return this.pagedRequest(
+      QUERY_MEDIA_SEARCH,
+      { search, ...filters, page, perPage: this.clampPerPage(perPage) },
+      "media"
+    );
   }
   /**
    * Get currently trending anime or manga.
@@ -943,32 +1001,49 @@ var AniListClient = class {
    * Fetch a character by AniList ID.
    *
    * @param id - The AniList character ID
+   * @param include - Optional include options (e.g. voice actors)
    * @returns The character object
    *
    * @example
    * ```ts
    * const spike = await client.getCharacter(1);
    * console.log(spike.name.full); // "Spike Spiegel"
+   *
+   * // With voice actors
+   * const spike = await client.getCharacter(1, { voiceActors: true });
+   * spike.media?.edges?.forEach((e) => {
+   *   console.log(e.node.title.romaji);
+   *   e.voiceActors?.forEach((va) => console.log(`  VA: ${va.name.full}`));
+   * });
    * ```
    */
-  async getCharacter(id) {
-    const data = await this.request(QUERY_CHARACTER_BY_ID, { id });
+  async getCharacter(id, include) {
+    const query = include?.voiceActors ? QUERY_CHARACTER_BY_ID_WITH_VA : QUERY_CHARACTER_BY_ID;
+    const data = await this.request(query, { id });
     return data.Character;
   }
   /**
    * Search for characters by name.
    *
-   * @param options - Search / pagination parameters
+   * @param options - Search / pagination parameters (includes optional `voiceActors`)
    * @returns Paginated results with matching characters
    *
    * @example
    * ```ts
    * const result = await client.searchCharacters({ query: "Luffy", perPage: 5 });
+   *
+   * // With voice actors
+   * const result = await client.searchCharacters({ query: "Luffy", voiceActors: true });
    * ```
    */
   async searchCharacters(options = {}) {
-    const { query: search, page = 1, perPage = 20, ...rest } = options;
-    return this.pagedRequest(QUERY_CHARACTER_SEARCH, { search, ...rest, page, perPage: this.clampPerPage(perPage) }, "characters");
+    const { query: search, page = 1, perPage = 20, voiceActors, ...rest } = options;
+    const gqlQuery = voiceActors ? QUERY_CHARACTER_SEARCH_WITH_VA : QUERY_CHARACTER_SEARCH;
+    return this.pagedRequest(
+      gqlQuery,
+      { search, ...rest, page, perPage: this.clampPerPage(perPage) },
+      "characters"
+    );
   }
   /**
    * Fetch a staff member by AniList ID.
@@ -999,7 +1074,11 @@ var AniListClient = class {
    */
   async searchStaff(options = {}) {
     const { query: search, page = 1, perPage = 20, sort } = options;
-    return this.pagedRequest(QUERY_STAFF_SEARCH, { search, sort, page, perPage: this.clampPerPage(perPage) }, "staff");
+    return this.pagedRequest(
+      QUERY_STAFF_SEARCH,
+      { search, sort, page, perPage: this.clampPerPage(perPage) },
+      "staff"
+    );
   }
   /**
    * Fetch a user by AniList ID.