ani-client 1.4.0 → 1.4.1

package/README.md

@@ -182,7 +182,7 @@ The second parameter of `getMedia()` lets you opt-in to additional data. By defa
 
 | Option | Type | Default | Description |
 | --- | --- | --- | --- |
-| `characters` | `boolean \| { perPage?, sort? }` | — | Characters with their roles (MAIN, SUPPORTING, BACKGROUND) |
+| `characters` | `boolean \| { perPage?, sort?, voiceActors? }` | — | Characters with their roles (MAIN, SUPPORTING, BACKGROUND). Set `voiceActors: true` to include VA data. |
 | `staff` | `boolean \| { perPage?, sort? }` | — | Staff members with their roles |
 | `relations` | `boolean` | `true` | Sequels, prequels, adaptations, etc. Set `false` to exclude |
 | `streamingEpisodes` | `boolean` | — | Streaming links (Crunchyroll, Funimation, etc.) |
@@ -202,6 +202,17 @@ const anime = await client.getMedia(1, {
   characters: { perPage: 50, sort: false },
 });
 
+// Include voice actors alongside characters
+const anime = await client.getMedia(1, {
+  characters: { voiceActors: true },
+});
+anime.characters?.edges.forEach((e) => {
+  console.log(e.node.name.full);
+  e.voiceActors?.forEach((va) =>
+    console.log(`  VA: ${va.name.full} (${va.languageV2})`)
+  );
+});
+
 // Staff members
 const anime = await client.getMedia(1, { staff: true });
 anime.staff?.edges.forEach((e) =>
@@ -230,12 +241,24 @@ const anime = await client.getMedia(1, {
 
 | Method | Description |
 | --- | --- |
-| `getCharacter(id)` | Fetch a character by ID |
-| `searchCharacters(options?)` | Search characters by name |
+| `getCharacter(id, include?)` | Fetch a character by ID, optionally with voice actors |
+| `searchCharacters(options?)` | Search characters by name, optionally with voice actors |
 
 ```ts
 const spike = await client.getCharacter(1);
 const results = await client.searchCharacters({ query: "Luffy", perPage: 5 });
+
+// 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} (${va.languageV2})`)
+  );
+});
+
+// Search with voice actors
+const result = await client.searchCharacters({ query: "Luffy", voiceActors: true });
 ```
 
 ### Staff
@@ -538,9 +561,10 @@ All types and enums are exported:
 
 ```ts
 import type {
-  Media, Character, Staff, User,
+  Media, Character, Staff, User, VoiceActor,
   AiringSchedule, MediaListEntry, Recommendation, StudioDetail,
   MediaEdge, MediaConnection, MediaCharacterEdge, MediaCharacterConnection,
+  CharacterMediaEdge, CharacterIncludeOptions,
   MediaStaffEdge, MediaStaffConnection, MediaIncludeOptions,
   StreamingEpisode, ExternalLink, MediaStats, MediaRecommendationNode,
   PageInfo, PagedResult,

package/dist/index.d.mts

@@ -159,9 +159,27 @@ interface CharacterImage {
     large: string | null;
     medium: string | null;
 }
+/** Compact voice actor data returned inside character edges. */
+interface VoiceActor {
+    id: number;
+    name: {
+        first: string | null;
+        middle: string | null;
+        last: string | null;
+        full: string | null;
+        native: string | null;
+        userPreferred: string | null;
+    };
+    languageV2: string | null;
+    image: StaffImage;
+    gender: string | null;
+    primaryOccupations: string[];
+    siteUrl: string | null;
+}
 interface MediaCharacterEdge {
     role: CharacterRole;
     node: Omit<Character, "media">;
+    voiceActors?: VoiceActor[];
 }
 interface MediaCharacterConnection {
     edges: MediaCharacterEdge[];
@@ -248,6 +266,11 @@ interface Media {
     isAdult: boolean | null;
     siteUrl: string | null;
 }
+type CharacterMediaNode = Pick<Media, "id" | "title" | "type" | "coverImage" | "siteUrl">;
+interface CharacterMediaEdge {
+    node: CharacterMediaNode;
+    voiceActors?: VoiceActor[];
+}
 interface Character {
     id: number;
     name: CharacterName;
@@ -260,9 +283,15 @@ interface Character {
     favourites: number | null;
     siteUrl: string | null;
     media: {
-        nodes: Pick<Media, "id" | "title" | "type" | "coverImage" | "siteUrl">[];
+        nodes?: CharacterMediaNode[];
+        edges?: CharacterMediaEdge[];
     } | null;
 }
+/** Options for including extra data when fetching a character. */
+interface CharacterIncludeOptions {
+    /** Include voice actors for each media the character appears in. */
+    voiceActors?: boolean;
+}
 interface StaffName {
     first: string | null;
     middle: string | null;
@@ -354,6 +383,8 @@ interface SearchCharacterOptions {
     sort?: CharacterSort[];
     page?: number;
     perPage?: number;
+    /** Include voice actors for each media the character appears in. */
+    voiceActors?: boolean;
 }
 interface SearchStaffOptions {
     query?: string;
@@ -523,6 +554,7 @@ interface MediaIncludeOptions {
     characters?: boolean | {
         perPage?: number;
         sort?: boolean;
+        voiceActors?: boolean;
     };
     /** Include staff members with their roles.
      *  `true` = 25 results sorted by relevance. Object form to customize. */
@@ -676,6 +708,9 @@ declare class AniListClient {
      * // 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 },
@@ -720,24 +755,35 @@ declare class AniListClient {
      * 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}`));
+     * });
      * ```
      */
-    getCharacter(id: number): Promise<Character>;
+    getCharacter(id: number, include?: CharacterIncludeOptions): Promise<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 });
      * ```
      */
     searchCharacters(options?: SearchCharacterOptions): Promise<PagedResult<Character>>;
@@ -1161,4 +1207,4 @@ declare class RateLimiter {
     private sleep;
 }
 
-export { type AiringSchedule, AiringSort, AniListClient, type AniListClientOptions, AniListError, type AniListHooks, type CacheAdapter, type CacheOptions, type Character, type CharacterImage, type CharacterName, CharacterRole, CharacterSort, type ExternalLink, type FuzzyDate, type GetAiringOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type PageInfo, type PagedResult, type RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, RedisCache, type RedisCacheOptions, type RedisLikeClient, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchStaffOptions, type SearchStudioOptions, type Staff, type StaffImage, type StaffName, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioDetail, type User, type UserAvatar, type UserStatistics };
+export { type AiringSchedule, AiringSort, AniListClient, type AniListClientOptions, AniListError, type AniListHooks, type CacheAdapter, type CacheOptions, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type ExternalLink, type FuzzyDate, type GetAiringOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type PageInfo, type PagedResult, type RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, RedisCache, type RedisCacheOptions, type RedisLikeClient, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchStaffOptions, type SearchStudioOptions, type Staff, type StaffImage, type StaffName, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioDetail, type User, type UserAvatar, type UserStatistics, type VoiceActor };

package/dist/index.d.ts

@@ -159,9 +159,27 @@ interface CharacterImage {
     large: string | null;
     medium: string | null;
 }
+/** Compact voice actor data returned inside character edges. */
+interface VoiceActor {
+    id: number;
+    name: {
+        first: string | null;
+        middle: string | null;
+        last: string | null;
+        full: string | null;
+        native: string | null;
+        userPreferred: string | null;
+    };
+    languageV2: string | null;
+    image: StaffImage;
+    gender: string | null;
+    primaryOccupations: string[];
+    siteUrl: string | null;
+}
 interface MediaCharacterEdge {
     role: CharacterRole;
     node: Omit<Character, "media">;
+    voiceActors?: VoiceActor[];
 }
 interface MediaCharacterConnection {
     edges: MediaCharacterEdge[];
@@ -248,6 +266,11 @@ interface Media {
     isAdult: boolean | null;
     siteUrl: string | null;
 }
+type CharacterMediaNode = Pick<Media, "id" | "title" | "type" | "coverImage" | "siteUrl">;
+interface CharacterMediaEdge {
+    node: CharacterMediaNode;
+    voiceActors?: VoiceActor[];
+}
 interface Character {
     id: number;
     name: CharacterName;
@@ -260,9 +283,15 @@ interface Character {
     favourites: number | null;
     siteUrl: string | null;
     media: {
-        nodes: Pick<Media, "id" | "title" | "type" | "coverImage" | "siteUrl">[];
+        nodes?: CharacterMediaNode[];
+        edges?: CharacterMediaEdge[];
     } | null;
 }
+/** Options for including extra data when fetching a character. */
+interface CharacterIncludeOptions {
+    /** Include voice actors for each media the character appears in. */
+    voiceActors?: boolean;
+}
 interface StaffName {
     first: string | null;
     middle: string | null;
@@ -354,6 +383,8 @@ interface SearchCharacterOptions {
     sort?: CharacterSort[];
     page?: number;
     perPage?: number;
+    /** Include voice actors for each media the character appears in. */
+    voiceActors?: boolean;
 }
 interface SearchStaffOptions {
     query?: string;
@@ -523,6 +554,7 @@ interface MediaIncludeOptions {
     characters?: boolean | {
         perPage?: number;
         sort?: boolean;
+        voiceActors?: boolean;
     };
     /** Include staff members with their roles.
      *  `true` = 25 results sorted by relevance. Object form to customize. */
@@ -676,6 +708,9 @@ declare class AniListClient {
      * // 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 },
@@ -720,24 +755,35 @@ declare class AniListClient {
      * 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}`));
+     * });
      * ```
      */
-    getCharacter(id: number): Promise<Character>;
+    getCharacter(id: number, include?: CharacterIncludeOptions): Promise<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 });
      * ```
      */
     searchCharacters(options?: SearchCharacterOptions): Promise<PagedResult<Character>>;
@@ -1161,4 +1207,4 @@ declare class RateLimiter {
     private sleep;
 }
 
-export { type AiringSchedule, AiringSort, AniListClient, type AniListClientOptions, AniListError, type AniListHooks, type CacheAdapter, type CacheOptions, type Character, type CharacterImage, type CharacterName, CharacterRole, CharacterSort, type ExternalLink, type FuzzyDate, type GetAiringOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type PageInfo, type PagedResult, type RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, RedisCache, type RedisCacheOptions, type RedisLikeClient, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchStaffOptions, type SearchStudioOptions, type Staff, type StaffImage, type StaffName, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioDetail, type User, type UserAvatar, type UserStatistics };
+export { type AiringSchedule, AiringSort, AniListClient, type AniListClientOptions, AniListError, type AniListHooks, type CacheAdapter, type CacheOptions, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type ExternalLink, type FuzzyDate, type GetAiringOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type PageInfo, type PagedResult, type RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, RedisCache, type RedisCacheOptions, type RedisLikeClient, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchStaffOptions, type SearchStudioOptions, type Staff, type StaffImage, type StaffName, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioDetail, type User, type UserAvatar, type UserStatistics, type VoiceActor };

package/dist/index.js

@@ -68,8 +68,7 @@ var CHARACTER_FIELDS_COMPACT = `
   favourites
   siteUrl
 `;
-var CHARACTER_FIELDS = `
-  ${CHARACTER_FIELDS_COMPACT}
+var CHARACTER_MEDIA_NODES = `
   media(perPage: 10) {
     nodes {
       id
@@ -80,6 +79,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 }
@@ -168,6 +200,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) {
@@ -177,6 +215,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) {
@@ -184,7 +231,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) {
@@ -366,13 +413,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}
       }
     }`);
   }
@@ -892,6 +943,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 },
@@ -929,7 +983,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.
@@ -945,32 +1003,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.
@@ -1001,7 +1076,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.