ani-client 2.0.2 → 2.1.0

package/dist/index.js

@@ -446,6 +446,7 @@ var RELATIONS_FIELDS = `
         coverImage { extraLarge large medium color }
         genres
         averageScore
+        meanScore
         studios { nodes { id name isAnimationStudio siteUrl } }
         siteUrl
         nextAiringEpisode {
@@ -459,6 +460,30 @@ var RELATIONS_FIELDS = `
     }
   }
 `;
+var MEDIA_RECOMMENDATION_FIELDS = `
+  id
+  rating
+  mediaRecommendation {
+    id
+    title { romaji english native userPreferred }
+    type
+    format
+    coverImage { large medium }
+    averageScore
+    meanScore
+   	episodes
+   	chapters
+   	volumes
+    nextAiringEpisode
+   	season
+   	seasonYear
+   	startDate
+   	endDate
+   	studios
+   	genres
+    siteUrl
+  }
+`;
 var MEDIA_FIELDS = `
   ${MEDIA_FIELDS_BASE}
   ${RELATIONS_FIELDS}
@@ -744,6 +769,7 @@ query (
   $genre_not_in: [String],
   $tag_not_in: [String],
   $isAdult: Boolean,
+  $idNotIn: [Int],
   $sort: [MediaSort],
   $page: Int,
   $perPage: Int
@@ -766,6 +792,7 @@ query (
       genre_not_in: $genre_not_in,
       tag_not_in: $tag_not_in,
       isAdult: $isAdult,
+      id_not_in: $idNotIn,
       sort: $sort
     ) {
       ${MEDIA_FIELDS_BASE}
@@ -773,19 +800,42 @@ query (
   }
 }`;
 var QUERY_TRENDING = `
-query ($type: MediaType, $isAdult: Boolean, $page: Int, $perPage: Int) {
+query (
+  $type: MediaType,
+  $isAdult: Boolean,
+  $idNotIn: [Int],
+  $page: Int,
+  $perPage: Int
+) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
-    media(type: $type, isAdult: $isAdult, sort: TRENDING_DESC) {
+    media(
+      type: $type,
+      isAdult: $isAdult,
+      id_not_in: $idNotIn,
+      sort: TRENDING_DESC
+    ) {
       ${MEDIA_FIELDS_BASE}
     }
   }
 }`;
 var QUERY_AIRING_SCHEDULE = `
-query ($airingAt_greater: Int, $airingAt_lesser: Int, $isAdult: Boolean, $sort: [AiringSort], $page: Int, $perPage: Int) {
+query (
+  $airingAt_greater: Int,
+  $airingAt_lesser: Int,
+  $sort: [AiringSort],
+  $idNotIn: [Int],
+  $page: Int,
+  $perPage: Int
+) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
-    airingSchedules(airingAt_greater: $airingAt_greater, airingAt_lesser: $airingAt_lesser, sort: $sort) {
+    airingSchedules(
+      airingAt_greater: $airingAt_greater,
+      airingAt_lesser: $airingAt_lesser,
+      id_not_in: $idNotIn,
+      sort: $sort
+    ) {
       id
       airingAt
       timeUntilAiring
@@ -798,19 +848,43 @@ query ($airingAt_greater: Int, $airingAt_lesser: Int, $isAdult: Boolean, $sort:
   }
 }`;
 var QUERY_RECENT_CHAPTERS = `
-query ($isAdult: Boolean $page: Int, $perPage: Int) {
+query (
+  $isAdult: Boolean,
+  $idNotIn: [Int],
+  $page: Int,
+  $perPage: Int
+) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
-    media(type: MANGA, isAdult: $isAdult status: RELEASING, sort: UPDATED_AT_DESC) {
+    media(
+      type: MANGA,
+      isAdult: $isAdult,
+      id_not_in: $idNotIn,
+      status: RELEASING,
+      sort: UPDATED_AT_DESC
+    ) {
       ${MEDIA_FIELDS_BASE}
     }
   }
 }`;
 var QUERY_PLANNING = `
-query ($type: MediaType, $isAdult: Boolean, $sort: [MediaSort], $page: Int, $perPage: Int) {
+query (
+  $type: MediaType,
+  $isAdult: Boolean,
+  $idNotIn: [Int],
+  $sort: [MediaSort],
+  $page: Int,
+  $perPage: Int
+) {
   Page(page: $page, perPage: $perPage) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
-    media(type: $type, isAdult: $isAdult, status: NOT_YET_RELEASED, sort: $sort) {
+    media(
+      type: $type,
+      isAdult: $isAdult,
+      id_not_in: $idNotIn,
+      status: NOT_YET_RELEASED,
+      sort: $sort
+    ) {
       ${MEDIA_FIELDS_BASE}
     }
   }
@@ -821,6 +895,7 @@ query (
   $seasonYear: Int!,
   $type: MediaType,
   $isAdult: Boolean,
+  $idNotIn: [Int],
   $sort: [MediaSort],
   $page: Int,
   $perPage: Int
@@ -832,6 +907,7 @@ query (
       seasonYear: $seasonYear,
       type: $type,
       isAdult: $isAdult,
+      id_not_in: $idNotIn,
       sort: $sort
     ) {
       ${MEDIA_FIELDS_BASE}
@@ -850,25 +926,7 @@ query ($mediaId: Int!, $page: Int, $perPage: Int, $sort: [RecommendationSort]) {
     recommendations(page: $page, perPage: $perPage, sort: $sort) {
       pageInfo { total perPage currentPage lastPage hasNextPage }
       nodes {
-        id
-        rating
-        userRating
-        mediaRecommendation {
-          id
-          idMal
-          title { romaji english native userPreferred }
-          type
-          format
-          status
-          coverImage { extraLarge large medium color }
-          bannerImage
-          genres
-          averageScore
-          meanScore
-          popularity
-          favourites
-          siteUrl
-        }
+        ${MEDIA_RECOMMENDATION_FIELDS}
         user {
           id
           name
@@ -925,17 +983,7 @@ function buildMediaByIdQuery(include) {
     extra.push(`
     recommendations(perPage: ${perPage}, sort: [RATING_DESC]) {
       nodes {
-        id
-        rating
-        mediaRecommendation {
-          id
-          title { romaji english native userPreferred }
-          type
-          format
-          coverImage { large medium }
-          averageScore
-          siteUrl
-        }
+        ${MEDIA_RECOMMENDATION_FIELDS}
       }
     }`);
   }
@@ -974,6 +1022,44 @@ query ($id: Int!) {
   }
 }`;
 }
+function buildMediaCharactersQuery(options = {}) {
+  const sortClause = options.sort === false ? "" : ", sort: [ROLE, RELEVANCE, ID]";
+  const voiceActorBlock = options.voiceActors ? `
+            voiceActors {
+              ${VOICE_ACTOR_FIELDS_COMPACT}
+            }` : "";
+  return `
+query ($mediaId: Int!, $page: Int, $perPage: Int) {
+  Media(id: $mediaId) {
+    characters(page: $page, perPage: $perPage${sortClause}) {
+      pageInfo { total perPage currentPage lastPage hasNextPage }
+      edges {
+        role
+        node {
+          ${CHARACTER_FIELDS_COMPACT}
+        }${voiceActorBlock}
+      }
+    }
+  }
+}`;
+}
+function buildMediaStaffQuery(options = {}) {
+  const sortClause = options.sort === false ? "" : ", sort: [RELEVANCE, ID]";
+  return `
+query ($mediaId: Int!, $page: Int, $perPage: Int) {
+  Media(id: $mediaId) {
+    staff(page: $page, perPage: $perPage${sortClause}) {
+      pageInfo { total perPage currentPage lastPage hasNextPage }
+      edges {
+        role
+        node {
+          ${STAFF_FIELDS}
+        }
+      }
+    }
+  }
+}`;
+}
 function buildBatchQuery(ids, typeName, fields, prefix) {
   const aliases = ids.map((id, i) => `${prefix}${i}: ${typeName}(id: ${id}) { ${fields} }`).join("\n  ");
   return `query {
@@ -1032,6 +1118,75 @@ query {
   }
 }`;
 
+// src/queries/review.ts
+var QUERY_REVIEWS = `
+  query ($page: Int, $perPage: Int, $sort: [ReviewSort], $mediaId: Int, $userId: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      reviews(sort: $sort, mediaId: $mediaId, userId: $userId) {
+        id
+        userId
+        mediaId
+        mediaType
+        summary
+        body
+        rating
+        ratingAmount
+        userRating
+        score
+        private
+        siteUrl
+        createdAt
+        updatedAt
+        user {
+          id
+          name
+          avatar { large medium }
+          siteUrl
+        }
+        media {
+          ${MEDIA_FIELDS_LIGHT}
+        }
+      }
+    }
+  }
+`;
+var QUERY_REVIEW_BY_ID = `
+  query ($id: Int) {
+    Review(id: $id) {
+      id
+      userId
+      mediaId
+      mediaType
+      summary
+      body
+      rating
+      ratingAmount
+      userRating
+      score
+      private
+      siteUrl
+      createdAt
+      updatedAt
+      user {
+        id
+        name
+        avatar { large medium }
+        siteUrl
+      }
+      media {
+        ${MEDIA_FIELDS_BASE}
+      }
+    }
+  }
+`;
+
 // src/queries/staff.ts
 var QUERY_STAFF_BY_ID = `
 query ($id: Int!) {
@@ -1557,6 +1712,21 @@ var RecommendationSort = /* @__PURE__ */ ((RecommendationSort2) => {
   return RecommendationSort2;
 })(RecommendationSort || {});
 
+// src/types/review.ts
+var ReviewSort = /* @__PURE__ */ ((ReviewSort2) => {
+  ReviewSort2["ID"] = "ID";
+  ReviewSort2["ID_DESC"] = "ID_DESC";
+  ReviewSort2["SCORE"] = "SCORE";
+  ReviewSort2["SCORE_DESC"] = "SCORE_DESC";
+  ReviewSort2["RATING"] = "RATING";
+  ReviewSort2["RATING_DESC"] = "RATING_DESC";
+  ReviewSort2["CREATED_AT"] = "CREATED_AT";
+  ReviewSort2["CREATED_AT_DESC"] = "CREATED_AT_DESC";
+  ReviewSort2["UPDATED_AT"] = "UPDATED_AT";
+  ReviewSort2["UPDATED_AT_DESC"] = "UPDATED_AT_DESC";
+  return ReviewSort2;
+})(ReviewSort || {});
+
 // src/types/staff.ts
 var StaffSort = /* @__PURE__ */ ((StaffSort2) => {
   StaffSort2["ID"] = "ID";
@@ -1626,6 +1796,25 @@ async function getMedia(client, id, include) {
   const data = await client.request(query, { id });
   return data.Media;
 }
+async function getMediaCharacters(client, mediaId, options = {}) {
+  validateId(mediaId, "mediaId");
+  const query = buildMediaCharactersQuery(options);
+  const data = await client.request(
+    query,
+    { mediaId, page: options.page ?? 1, perPage: clampPerPage(options.perPage ?? 25) }
+  );
+  return { pageInfo: data.Media.characters.pageInfo, results: data.Media.characters.edges };
+}
+async function getMediaStaff(client, mediaId, options = {}) {
+  validateId(mediaId, "mediaId");
+  const query = buildMediaStaffQuery(options);
+  const data = await client.request(query, {
+    mediaId,
+    page: options.page ?? 1,
+    perPage: clampPerPage(options.perPage ?? 25)
+  });
+  return { pageInfo: data.Media.staff.pageInfo, results: data.Media.staff.edges };
+}
 async function getMediaByMalId(client, malId, type) {
   validateId(malId, "malId");
   const data = await client.request(QUERY_MEDIA_BY_MAL_ID, {
@@ -1664,16 +1853,20 @@ async function searchMedia(client, options = {}) {
   );
 }
 async function getTrending(client, options) {
-  const { type = "ANIME" /* ANIME */, isAdult = false, page = 1, perPage = 20 } = options;
-  return client.pagedRequest(QUERY_TRENDING, { type, isAdult, page, perPage: clampPerPage(perPage) }, "media");
+  const { type = "ANIME" /* ANIME */, isAdult = false, idNotIn = [], page = 1, perPage = 20 } = options;
+  return client.pagedRequest(
+    QUERY_TRENDING,
+    { type, isAdult, idNotIn, page, perPage: clampPerPage(perPage) },
+    "media"
+  );
 }
 async function getPopular(client, options) {
-  const { type = "ANIME" /* ANIME */, isAdult = false, page = 1, perPage = 20 } = options;
-  return searchMedia(client, { type, isAdult, sort: ["POPULARITY_DESC" /* POPULARITY_DESC */], page, perPage });
+  const { type = "ANIME" /* ANIME */, isAdult = false, idNotIn = [], page = 1, perPage = 20 } = options;
+  return searchMedia(client, { type, isAdult, idNotIn, sort: ["POPULARITY_DESC" /* POPULARITY_DESC */], page, perPage });
 }
 async function getTopRated(client, options) {
-  const { type = "ANIME" /* ANIME */, isAdult = false, page = 1, perPage = 20 } = options;
-  return searchMedia(client, { type, isAdult, sort: ["SCORE_DESC" /* SCORE_DESC */], page, perPage });
+  const { type = "ANIME" /* ANIME */, isAdult = false, idNotIn = [], page = 1, perPage = 20 } = options;
+  return searchMedia(client, { type, isAdult, idNotIn, sort: ["SCORE_DESC" /* SCORE_DESC */], page, perPage });
 }
 async function getAiredEpisodes(client, options = {}) {
   const now = Math.floor(Date.now() / 1e3);
@@ -1682,7 +1875,7 @@ async function getAiredEpisodes(client, options = {}) {
     {
       airingAt_greater: options.airingAtGreater ?? now - 24 * 3600,
       airingAt_lesser: options.airingAtLesser ?? now,
-      isAdult: options.isAdult ?? false,
+      idNotIn: options.idNotIn ?? [],
       sort: options.sort,
       page: options.page ?? 1,
       perPage: clampPerPage(options.perPage ?? 20)
@@ -1695,6 +1888,7 @@ async function getRecentlyUpdatedManga(client, options = {}) {
     QUERY_RECENT_CHAPTERS,
     {
       isAdult: options.isAdult ?? false,
+      idNotIn: options.idNotIn ?? [],
       page: options.page ?? 1,
       perPage: clampPerPage(options.perPage ?? 20)
     },
@@ -1707,6 +1901,7 @@ async function getPlanning(client, options = {}) {
     {
       type: options.type,
       isAdult: options.isAdult ?? false,
+      idNotIn: options.idNotIn ?? [],
       sort: options.sort ?? ["POPULARITY_DESC" /* POPULARITY_DESC */],
       page: options.page ?? 1,
       perPage: clampPerPage(options.perPage ?? 20)
@@ -1735,6 +1930,7 @@ async function getMediaBySeason(client, options) {
       seasonYear: options.seasonYear,
       type: options.type,
       isAdult: options.isAdult ?? false,
+      idNotIn: options.idNotIn ?? [],
       sort: options.sort,
       page: options.page ?? 1,
       perPage: clampPerPage(options.perPage ?? 20)
@@ -1742,7 +1938,7 @@ async function getMediaBySeason(client, options) {
     "media"
   );
 }
-async function getWeeklySchedule(client, date = /* @__PURE__ */ new Date(), isAdult = false) {
+async function getWeeklySchedule(client, date = /* @__PURE__ */ new Date(), idNotIn) {
   const schedule = {
     Monday: [],
     Tuesday: [],
@@ -1764,7 +1960,7 @@ async function getWeeklySchedule(client, date = /* @__PURE__ */ new Date(), isAd
     (page) => getAiredEpisodes(client, {
       airingAtGreater: startTimestamp,
       airingAtLesser: endTimestamp,
-      isAdult,
+      idNotIn,
       page,
       perPage: 50
     }),
@@ -1779,6 +1975,17 @@ async function getWeeklySchedule(client, date = /* @__PURE__ */ new Date(), isAd
   return schedule;
 }
 
+// src/client/review.ts
+async function getReview(client, id) {
+  validateId(id, "reviewId");
+  const data = await client.request(QUERY_REVIEW_BY_ID, { id });
+  return data.Review;
+}
+async function searchReviews(client, options = {}) {
+  const { mediaId, userId, sort, page = 1, perPage = 20 } = options;
+  return client.pagedRequest(QUERY_REVIEWS, { mediaId, userId, sort, page, perPage }, "reviews");
+}
+
 // src/client/staff.ts
 async function getStaff(client, id, include) {
   validateId(id, "staffId");
@@ -1910,7 +2117,7 @@ function mapFavorites(fav) {
 
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
-var LIB_VERSION = "2.0.2" ;
+var LIB_VERSION = "2.1.0" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -2053,6 +2260,12 @@ var AniListClient = class {
   async getMedia(id, include) {
     return getMedia(this, id, include);
   }
+  async getMediaCharacters(mediaId, options = {}) {
+    return getMediaCharacters(this, mediaId, options);
+  }
+  async getMediaStaff(mediaId, options = {}) {
+    return getMediaStaff(this, mediaId, options);
+  }
   /**
    * Search for anime or manga.
    *
@@ -2087,7 +2300,7 @@ var AniListClient = class {
     return getRecentlyUpdatedManga(this, options);
   }
   /**
-   * @deprecated Use `getRecentlyUpdatedManga` instead. This alias will be removed in v2.
+   * @deprecated Use `getRecentlyUpdatedManga()` instead. This alias will be removed in v3.
    */
   async getAiredChapters(options = {}) {
     return this.getRecentlyUpdatedManga(options);
@@ -2168,6 +2381,23 @@ var AniListClient = class {
   async getUserFavorites(idOrName, options) {
     return getUserFavorites(this, idOrName, options);
   }
+  /**
+   * Fetch a review by its AniList ID.
+   *
+   * @param id - The AniList review ID
+   */
+  async getReview(id) {
+    return getReview(this, id);
+  }
+  /**
+   * Search for reviews with optional filters.
+   *
+   * @param options - Search and filter options
+   * @returns Paginated results with matching reviews
+   */
+  async searchReviews(options = {}) {
+    return searchReviews(this, options);
+  }
   /**
    * Fetch a studio by its AniList ID.
    * Pass `include` to customise the number of media returned.
@@ -2328,6 +2558,7 @@ exports.MemoryCache = MemoryCache;
 exports.RateLimiter = RateLimiter;
 exports.RecommendationSort = RecommendationSort;
 exports.RedisCache = RedisCache;
+exports.ReviewSort = ReviewSort;
 exports.StaffSort = StaffSort;
 exports.StudioSort = StudioSort;
 exports.ThreadSort = ThreadSort;