ani-client 1.4.0 → 1.4.2

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 }
@@ -95,6 +127,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
@@ -166,6 +238,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,14 +253,30 @@ 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) {
     ${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: [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 +458,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 +988,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 +1028,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,46 +1048,74 @@ 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.
    *
    * @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;
   }
@@ -999,7 +1132,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.