ani-client 1.8.0 → 1.9.0

package/dist/index.mjs

@@ -248,6 +248,95 @@ var MemoryCache = class {
   }
 };
 
+// src/cache/redis.ts
+var RedisCache = class {
+  client;
+  prefix;
+  ttl;
+  constructor(options) {
+    this.client = options.client;
+    this.prefix = options.prefix ?? "ani:";
+    this.ttl = options.ttl ?? 86400;
+  }
+  prefixedKey(key) {
+    return `${this.prefix}${key}`;
+  }
+  async get(key) {
+    const raw = await this.client.get(this.prefixedKey(key));
+    if (raw === null) return void 0;
+    try {
+      return JSON.parse(raw);
+    } catch {
+      return void 0;
+    }
+  }
+  async set(key, data) {
+    await this.client.set(this.prefixedKey(key), JSON.stringify(data), "EX", this.ttl);
+  }
+  async delete(key) {
+    const count = await this.client.del(this.prefixedKey(key));
+    return count > 0;
+  }
+  /**
+   * Collect keys matching a pattern. Uses SCAN when available, falls back to KEYS.
+   *
+   * **Warning:** The `KEYS` fallback is O(N) and blocks the Redis server.
+   * Provide a client with `scanIterator` support for production use.
+   * @internal
+   */
+  async collectKeys(pattern) {
+    if (this.client.scanIterator) {
+      const keys = [];
+      for await (const key of this.client.scanIterator({ MATCH: pattern, COUNT: 100 })) {
+        keys.push(key);
+      }
+      return keys;
+    }
+    return this.client.keys(pattern);
+  }
+  async clear() {
+    const keys = await this.collectKeys(`${this.prefix}*`);
+    if (keys.length > 0) {
+      await this.client.del(...keys);
+    }
+  }
+  /**
+   * Get the actual number of keys with this prefix in Redis.
+   */
+  get size() {
+    return this.getSize();
+  }
+  /** @internal */
+  async getSize() {
+    const keys = await this.collectKeys(`${this.prefix}*`);
+    return keys.length;
+  }
+  async keys() {
+    const raw = await this.collectKeys(`${this.prefix}*`);
+    return raw.map((k) => k.slice(this.prefix.length));
+  }
+  /**
+   * Remove all entries whose key matches the given pattern.
+   *
+   * - **String**: treated as a substring match (e.g. `"Media"` removes all keys containing `"Media"`).
+   * - **RegExp**: tested against each key directly.
+   *
+   * @param pattern — A string (substring match) or RegExp.
+   * @returns Number of entries removed.
+   */
+  async invalidate(pattern) {
+    if (typeof pattern === "string") {
+      const keys = await this.collectKeys(`${this.prefix}*${pattern}*`);
+      if (keys.length === 0) return 0;
+      return this.client.del(...keys);
+    }
+    const allKeys = await this.collectKeys(`${this.prefix}*`);
+    const matching = allKeys.filter((k) => pattern.test(k.slice(this.prefix.length)));
+    if (matching.length === 0) return 0;
+    return this.client.del(...matching);
+  }
+};
+
 // src/errors/index.ts
 var AniListError = class _AniListError extends Error {
   /** HTTP status code returned by the API */
@@ -622,8 +711,10 @@ query ($id: Int!) {
 var QUERY_MEDIA_SEARCH = `
 query (
   $search: String,
+  $countryOfOrigin: CountryCode,
   $type: MediaType,
   $format: MediaFormat,
+  $format_in: [MediaFormat],
   $status: MediaStatus,
   $season: MediaSeason,
   $seasonYear: Int,
@@ -642,8 +733,10 @@ query (
     pageInfo { total perPage currentPage lastPage hasNextPage }
     media(
       search: $search,
+      countryOfOrigin: $countryOfOrigin,
       type: $type,
       format: $format,
+      format_in: $format_in,
       status: $status,
       season: $season,
       seasonYear: $seasonYear,
@@ -753,6 +846,111 @@ query ($mediaId: Int!, $page: Int, $perPage: Int, $sort: [RecommendationSort]) {
   }
 }`;
 
+// src/queries/builders.ts
+function buildMediaByIdQuery(include) {
+  if (!include) return QUERY_MEDIA_BY_ID;
+  const extra = [];
+  if (include.relations !== false) {
+    extra.push(RELATIONS_FIELDS);
+  }
+  if (include.characters) {
+    const opts = typeof include.characters === "object" ? include.characters : {};
+    const perPage = clampPerPage(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}
+      }
+    }`);
+  }
+  if (include.staff) {
+    const opts = typeof include.staff === "object" ? include.staff : {};
+    const perPage = clampPerPage(opts.perPage ?? 25);
+    const sortClause = opts.sort !== false ? ", sort: [RELEVANCE, ID]" : "";
+    extra.push(`
+    staff(perPage: ${perPage}${sortClause}) {
+      edges {
+        role
+        node {
+          ${STAFF_FIELDS}
+        }
+      }
+    }`);
+  }
+  if (include.recommendations) {
+    const perPage = clampPerPage(
+      typeof include.recommendations === "object" ? include.recommendations.perPage ?? 10 : 10
+    );
+    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
+        }
+      }
+    }`);
+  }
+  if (include.streamingEpisodes) {
+    extra.push(`
+    streamingEpisodes {
+      title
+      thumbnail
+      url
+      site
+    }`);
+  }
+  if (include.externalLinks) {
+    extra.push(`
+    externalLinks {
+      id
+      url
+      site
+      type
+      icon
+      color
+    }`);
+  }
+  if (include.stats) {
+    extra.push(`
+    stats {
+      scoreDistribution { score amount }
+      statusDistribution { status amount }
+    }`);
+  }
+  return `
+query ($id: Int!) {
+  Media(id: $id) {
+    ${MEDIA_FIELDS_BASE}
+    ${extra.join("\n")}
+  }
+}`;
+}
+function buildBatchQuery(ids, typeName, fields, prefix) {
+  const aliases = ids.map((id, i) => `${prefix}${i}: ${typeName}(id: ${id}) { ${fields} }`).join("\n  ");
+  return `query {
+  ${aliases}
+}`;
+}
+var buildBatchMediaQuery = (ids) => buildBatchQuery(ids, "Media", MEDIA_FIELDS, "m");
+var buildBatchCharacterQuery = (ids) => buildBatchQuery(ids, "Character", CHARACTER_FIELDS, "c");
+var buildBatchStaffQuery = (ids) => buildBatchQuery(ids, "Staff", STAFF_FIELDS, "s");
+
 // src/queries/character.ts
 var QUERY_CHARACTER_BY_ID = `
 query ($id: Int!) {
@@ -785,6 +983,22 @@ query ($search: String, $sort: [CharacterSort], $page: Int, $perPage: Int) {
   }
 }`;
 
+// src/queries/metadata.ts
+var QUERY_GENRES = `
+query {
+  GenreCollection
+}`;
+var QUERY_TAGS = `
+query {
+  MediaTagCollection {
+    id
+    name
+    description
+    category
+    isAdult
+  }
+}`;
+
 // src/queries/staff.ts
 var QUERY_STAFF_BY_ID = `
 query ($id: Int!) {
@@ -809,6 +1023,60 @@ query ($search: String, $sort: [StaffSort], $page: Int, $perPage: Int) {
   }
 }`;
 
+// src/queries/studio.ts
+var QUERY_STUDIO_BY_ID = `
+query ($id: Int!) {
+  Studio(id: $id) {
+    ${STUDIO_FIELDS}
+  }
+}`;
+function buildStudioByIdQuery(mediaPerPage) {
+  if (mediaPerPage === void 0) return QUERY_STUDIO_BY_ID;
+  const pp = clampPerPage(mediaPerPage);
+  return `
+query ($id: Int!) {
+  Studio(id: $id) {
+    id
+    name
+    isAnimationStudio
+    siteUrl
+    favourites
+    media(page: 1, perPage: ${pp}, sort: POPULARITY_DESC) {
+      pageInfo { total perPage currentPage lastPage hasNextPage }
+      nodes {
+        ${MEDIA_FIELDS_LIGHT}
+      }
+    }
+  }
+}`;
+}
+var QUERY_STUDIO_SEARCH = `
+query ($search: String, $sort: [StudioSort], $page: Int, $perPage: Int) {
+  Page(page: $page, perPage: $perPage) {
+    pageInfo { total perPage currentPage lastPage hasNextPage }
+    studios(search: $search, sort: $sort) {
+      ${STUDIO_FIELDS}
+    }
+  }
+}`;
+
+// src/queries/thread.ts
+var QUERY_THREAD_BY_ID = `
+query ($id: Int!) {
+  Thread(id: $id) {
+    ${THREAD_FIELDS}
+  }
+}`;
+var QUERY_THREAD_SEARCH = `
+query ($search: String, $mediaCategoryId: Int, $categoryId: Int, $sort: [ThreadSort], $page: Int, $perPage: Int) {
+  Page(page: $page, perPage: $perPage) {
+    pageInfo { total perPage currentPage lastPage hasNextPage }
+    threads(search: $search, mediaCategoryId: $mediaCategoryId, categoryId: $categoryId, sort: $sort) {
+      ${THREAD_FIELDS}
+    }
+  }
+}`;
+
 // src/queries/user.ts
 var QUERY_USER_BY_ID = `
 query ($id: Int!) {
@@ -895,199 +1163,24 @@ query (${varDecl}) {
         }
       }
       staff(perPage: ${pp}) {
-        nodes {
-          id
-          name { full native }
-          image { large medium }
-          siteUrl
-        }
-      }
-      studios(perPage: ${pp}) {
-        nodes {
-          id
-          name
-          siteUrl
-        }
-      }
-    }
-  }
-}`;
-}
-
-// src/queries/studio.ts
-var QUERY_STUDIO_BY_ID = `
-query ($id: Int!) {
-  Studio(id: $id) {
-    ${STUDIO_FIELDS}
-  }
-}`;
-function buildStudioByIdQuery(mediaPerPage) {
-  if (mediaPerPage === void 0) return QUERY_STUDIO_BY_ID;
-  const pp = clampPerPage(mediaPerPage);
-  return `
-query ($id: Int!) {
-  Studio(id: $id) {
-    id
-    name
-    isAnimationStudio
-    siteUrl
-    favourites
-    media(page: 1, perPage: ${pp}, sort: POPULARITY_DESC) {
-      pageInfo { total perPage currentPage lastPage hasNextPage }
-      nodes {
-        ${MEDIA_FIELDS_LIGHT}
-      }
-    }
-  }
-}`;
-}
-var QUERY_STUDIO_SEARCH = `
-query ($search: String, $sort: [StudioSort], $page: Int, $perPage: Int) {
-  Page(page: $page, perPage: $perPage) {
-    pageInfo { total perPage currentPage lastPage hasNextPage }
-    studios(search: $search, sort: $sort) {
-      ${STUDIO_FIELDS}
-    }
-  }
-}`;
-
-// src/queries/metadata.ts
-var QUERY_GENRES = `
-query {
-  GenreCollection
-}`;
-var QUERY_TAGS = `
-query {
-  MediaTagCollection {
-    id
-    name
-    description
-    category
-    isAdult
-  }
-}`;
-
-// src/queries/builders.ts
-function buildMediaByIdQuery(include) {
-  if (!include) return QUERY_MEDIA_BY_ID;
-  const extra = [];
-  if (include.relations !== false) {
-    extra.push(RELATIONS_FIELDS);
-  }
-  if (include.characters) {
-    const opts = typeof include.characters === "object" ? include.characters : {};
-    const perPage = clampPerPage(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}
-      }
-    }`);
-  }
-  if (include.staff) {
-    const opts = typeof include.staff === "object" ? include.staff : {};
-    const perPage = clampPerPage(opts.perPage ?? 25);
-    const sortClause = opts.sort !== false ? ", sort: [RELEVANCE, ID]" : "";
-    extra.push(`
-    staff(perPage: ${perPage}${sortClause}) {
-      edges {
-        role
-        node {
-          ${STAFF_FIELDS}
-        }
-      }
-    }`);
-  }
-  if (include.recommendations) {
-    const perPage = clampPerPage(
-      typeof include.recommendations === "object" ? include.recommendations.perPage ?? 10 : 10
-    );
-    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
-        }
-      }
-    }`);
-  }
-  if (include.streamingEpisodes) {
-    extra.push(`
-    streamingEpisodes {
-      title
-      thumbnail
-      url
-      site
-    }`);
-  }
-  if (include.externalLinks) {
-    extra.push(`
-    externalLinks {
-      id
-      url
-      site
-      type
-      icon
-      color
-    }`);
-  }
-  if (include.stats) {
-    extra.push(`
-    stats {
-      scoreDistribution { score amount }
-      statusDistribution { status amount }
-    }`);
-  }
-  return `
-query ($id: Int!) {
-  Media(id: $id) {
-    ${MEDIA_FIELDS_BASE}
-    ${extra.join("\n")}
-  }
-}`;
-}
-function buildBatchQuery(ids, typeName, fields, prefix) {
-  const aliases = ids.map((id, i) => `${prefix}${i}: ${typeName}(id: ${id}) { ${fields} }`).join("\n  ");
-  return `query {
-  ${aliases}
-}`;
-}
-var buildBatchMediaQuery = (ids) => buildBatchQuery(ids, "Media", MEDIA_FIELDS, "m");
-var buildBatchCharacterQuery = (ids) => buildBatchQuery(ids, "Character", CHARACTER_FIELDS, "c");
-var buildBatchStaffQuery = (ids) => buildBatchQuery(ids, "Staff", STAFF_FIELDS, "s");
-
-// src/queries/thread.ts
-var QUERY_THREAD_BY_ID = `
-query ($id: Int!) {
-  Thread(id: $id) {
-    ${THREAD_FIELDS}
-  }
-}`;
-var QUERY_THREAD_SEARCH = `
-query ($search: String, $mediaCategoryId: Int, $categoryId: Int, $sort: [ThreadSort], $page: Int, $perPage: Int) {
-  Page(page: $page, perPage: $perPage) {
-    pageInfo { total perPage currentPage lastPage hasNextPage }
-    threads(search: $search, mediaCategoryId: $mediaCategoryId, categoryId: $categoryId, sort: $sort) {
-      ${THREAD_FIELDS}
+        nodes {
+          id
+          name { full native }
+          image { large medium }
+          siteUrl
+        }
+      }
+      studios(perPage: ${pp}) {
+        nodes {
+          id
+          name
+          siteUrl
+        }
+      }
     }
   }
 }`;
+}
 
 // src/rate-limiter/index.ts
 var RateLimiter = class {
@@ -1171,7 +1264,7 @@ var RateLimiter = class {
       }
     }
     if (lastResponse) return lastResponse;
-    throw lastError;
+    throw lastError ?? new Error(`Request failed after ${this.maxRetries} retries`);
   }
   /** @internal — Exponential backoff with jitter, capped at 30s (or custom strategy) */
   exponentialDelay(attempt) {
@@ -1246,6 +1339,68 @@ async function searchCharacters(client, options = {}) {
   return client.pagedRequest(gqlQuery, { search, sort, page, perPage: clampPerPage(perPage) }, "characters");
 }
 
+// src/types/character.ts
+var CharacterSort = /* @__PURE__ */ ((CharacterSort2) => {
+  CharacterSort2["ID"] = "ID";
+  CharacterSort2["ID_DESC"] = "ID_DESC";
+  CharacterSort2["ROLE"] = "ROLE";
+  CharacterSort2["ROLE_DESC"] = "ROLE_DESC";
+  CharacterSort2["SEARCH_MATCH"] = "SEARCH_MATCH";
+  CharacterSort2["FAVOURITES"] = "FAVOURITES";
+  CharacterSort2["FAVOURITES_DESC"] = "FAVOURITES_DESC";
+  return CharacterSort2;
+})(CharacterSort || {});
+var CharacterRole = /* @__PURE__ */ ((CharacterRole2) => {
+  CharacterRole2["MAIN"] = "MAIN";
+  CharacterRole2["SUPPORTING"] = "SUPPORTING";
+  CharacterRole2["BACKGROUND"] = "BACKGROUND";
+  return CharacterRole2;
+})(CharacterRole || {});
+
+// src/types/lists.ts
+var MediaListStatus = /* @__PURE__ */ ((MediaListStatus2) => {
+  MediaListStatus2["CURRENT"] = "CURRENT";
+  MediaListStatus2["PLANNING"] = "PLANNING";
+  MediaListStatus2["COMPLETED"] = "COMPLETED";
+  MediaListStatus2["DROPPED"] = "DROPPED";
+  MediaListStatus2["PAUSED"] = "PAUSED";
+  MediaListStatus2["REPEATING"] = "REPEATING";
+  return MediaListStatus2;
+})(MediaListStatus || {});
+var MediaListSort = /* @__PURE__ */ ((MediaListSort2) => {
+  MediaListSort2["MEDIA_ID"] = "MEDIA_ID";
+  MediaListSort2["MEDIA_ID_DESC"] = "MEDIA_ID_DESC";
+  MediaListSort2["SCORE"] = "SCORE";
+  MediaListSort2["SCORE_DESC"] = "SCORE_DESC";
+  MediaListSort2["STATUS"] = "STATUS";
+  MediaListSort2["STATUS_DESC"] = "STATUS_DESC";
+  MediaListSort2["PROGRESS"] = "PROGRESS";
+  MediaListSort2["PROGRESS_DESC"] = "PROGRESS_DESC";
+  MediaListSort2["PROGRESS_VOLUMES"] = "PROGRESS_VOLUMES";
+  MediaListSort2["PROGRESS_VOLUMES_DESC"] = "PROGRESS_VOLUMES_DESC";
+  MediaListSort2["REPEAT"] = "REPEAT";
+  MediaListSort2["REPEAT_DESC"] = "REPEAT_DESC";
+  MediaListSort2["PRIORITY"] = "PRIORITY";
+  MediaListSort2["PRIORITY_DESC"] = "PRIORITY_DESC";
+  MediaListSort2["STARTED_ON"] = "STARTED_ON";
+  MediaListSort2["STARTED_ON_DESC"] = "STARTED_ON_DESC";
+  MediaListSort2["FINISHED_ON"] = "FINISHED_ON";
+  MediaListSort2["FINISHED_ON_DESC"] = "FINISHED_ON_DESC";
+  MediaListSort2["ADDED_TIME"] = "ADDED_TIME";
+  MediaListSort2["ADDED_TIME_DESC"] = "ADDED_TIME_DESC";
+  MediaListSort2["UPDATED_TIME"] = "UPDATED_TIME";
+  MediaListSort2["UPDATED_TIME_DESC"] = "UPDATED_TIME_DESC";
+  MediaListSort2["MEDIA_TITLE_ROMAJI"] = "MEDIA_TITLE_ROMAJI";
+  MediaListSort2["MEDIA_TITLE_ROMAJI_DESC"] = "MEDIA_TITLE_ROMAJI_DESC";
+  MediaListSort2["MEDIA_TITLE_ENGLISH"] = "MEDIA_TITLE_ENGLISH";
+  MediaListSort2["MEDIA_TITLE_ENGLISH_DESC"] = "MEDIA_TITLE_ENGLISH_DESC";
+  MediaListSort2["MEDIA_TITLE_NATIVE"] = "MEDIA_TITLE_NATIVE";
+  MediaListSort2["MEDIA_TITLE_NATIVE_DESC"] = "MEDIA_TITLE_NATIVE_DESC";
+  MediaListSort2["MEDIA_POPULARITY"] = "MEDIA_POPULARITY";
+  MediaListSort2["MEDIA_POPULARITY_DESC"] = "MEDIA_POPULARITY_DESC";
+  return MediaListSort2;
+})(MediaListSort || {});
+
 // src/types/media.ts
 var MediaType = /* @__PURE__ */ ((MediaType2) => {
   MediaType2["ANIME"] = "ANIME";
@@ -1369,24 +1524,6 @@ var RecommendationSort = /* @__PURE__ */ ((RecommendationSort2) => {
   return RecommendationSort2;
 })(RecommendationSort || {});
 
-// src/types/character.ts
-var CharacterSort = /* @__PURE__ */ ((CharacterSort2) => {
-  CharacterSort2["ID"] = "ID";
-  CharacterSort2["ID_DESC"] = "ID_DESC";
-  CharacterSort2["ROLE"] = "ROLE";
-  CharacterSort2["ROLE_DESC"] = "ROLE_DESC";
-  CharacterSort2["SEARCH_MATCH"] = "SEARCH_MATCH";
-  CharacterSort2["FAVOURITES"] = "FAVOURITES";
-  CharacterSort2["FAVOURITES_DESC"] = "FAVOURITES_DESC";
-  return CharacterSort2;
-})(CharacterSort || {});
-var CharacterRole = /* @__PURE__ */ ((CharacterRole2) => {
-  CharacterRole2["MAIN"] = "MAIN";
-  CharacterRole2["SUPPORTING"] = "SUPPORTING";
-  CharacterRole2["BACKGROUND"] = "BACKGROUND";
-  return CharacterRole2;
-})(CharacterRole || {});
-
 // src/types/staff.ts
 var StaffSort = /* @__PURE__ */ ((StaffSort2) => {
   StaffSort2["ID"] = "ID";
@@ -1402,20 +1539,6 @@ var StaffSort = /* @__PURE__ */ ((StaffSort2) => {
   return StaffSort2;
 })(StaffSort || {});
 
-// src/types/user.ts
-var UserSort = /* @__PURE__ */ ((UserSort2) => {
-  UserSort2["ID"] = "ID";
-  UserSort2["ID_DESC"] = "ID_DESC";
-  UserSort2["USERNAME"] = "USERNAME";
-  UserSort2["USERNAME_DESC"] = "USERNAME_DESC";
-  UserSort2["WATCHED_TIME"] = "WATCHED_TIME";
-  UserSort2["WATCHED_TIME_DESC"] = "WATCHED_TIME_DESC";
-  UserSort2["CHAPTERS_READ"] = "CHAPTERS_READ";
-  UserSort2["CHAPTERS_READ_DESC"] = "CHAPTERS_READ_DESC";
-  UserSort2["SEARCH_MATCH"] = "SEARCH_MATCH";
-  return UserSort2;
-})(UserSort || {});
-
 // src/types/studio.ts
 var StudioSort = /* @__PURE__ */ ((StudioSort2) => {
   StudioSort2["ID"] = "ID";
@@ -1428,50 +1551,6 @@ var StudioSort = /* @__PURE__ */ ((StudioSort2) => {
   return StudioSort2;
 })(StudioSort || {});
 
-// src/types/lists.ts
-var MediaListStatus = /* @__PURE__ */ ((MediaListStatus2) => {
-  MediaListStatus2["CURRENT"] = "CURRENT";
-  MediaListStatus2["PLANNING"] = "PLANNING";
-  MediaListStatus2["COMPLETED"] = "COMPLETED";
-  MediaListStatus2["DROPPED"] = "DROPPED";
-  MediaListStatus2["PAUSED"] = "PAUSED";
-  MediaListStatus2["REPEATING"] = "REPEATING";
-  return MediaListStatus2;
-})(MediaListStatus || {});
-var MediaListSort = /* @__PURE__ */ ((MediaListSort2) => {
-  MediaListSort2["MEDIA_ID"] = "MEDIA_ID";
-  MediaListSort2["MEDIA_ID_DESC"] = "MEDIA_ID_DESC";
-  MediaListSort2["SCORE"] = "SCORE";
-  MediaListSort2["SCORE_DESC"] = "SCORE_DESC";
-  MediaListSort2["STATUS"] = "STATUS";
-  MediaListSort2["STATUS_DESC"] = "STATUS_DESC";
-  MediaListSort2["PROGRESS"] = "PROGRESS";
-  MediaListSort2["PROGRESS_DESC"] = "PROGRESS_DESC";
-  MediaListSort2["PROGRESS_VOLUMES"] = "PROGRESS_VOLUMES";
-  MediaListSort2["PROGRESS_VOLUMES_DESC"] = "PROGRESS_VOLUMES_DESC";
-  MediaListSort2["REPEAT"] = "REPEAT";
-  MediaListSort2["REPEAT_DESC"] = "REPEAT_DESC";
-  MediaListSort2["PRIORITY"] = "PRIORITY";
-  MediaListSort2["PRIORITY_DESC"] = "PRIORITY_DESC";
-  MediaListSort2["STARTED_ON"] = "STARTED_ON";
-  MediaListSort2["STARTED_ON_DESC"] = "STARTED_ON_DESC";
-  MediaListSort2["FINISHED_ON"] = "FINISHED_ON";
-  MediaListSort2["FINISHED_ON_DESC"] = "FINISHED_ON_DESC";
-  MediaListSort2["ADDED_TIME"] = "ADDED_TIME";
-  MediaListSort2["ADDED_TIME_DESC"] = "ADDED_TIME_DESC";
-  MediaListSort2["UPDATED_TIME"] = "UPDATED_TIME";
-  MediaListSort2["UPDATED_TIME_DESC"] = "UPDATED_TIME_DESC";
-  MediaListSort2["MEDIA_TITLE_ROMAJI"] = "MEDIA_TITLE_ROMAJI";
-  MediaListSort2["MEDIA_TITLE_ROMAJI_DESC"] = "MEDIA_TITLE_ROMAJI_DESC";
-  MediaListSort2["MEDIA_TITLE_ENGLISH"] = "MEDIA_TITLE_ENGLISH";
-  MediaListSort2["MEDIA_TITLE_ENGLISH_DESC"] = "MEDIA_TITLE_ENGLISH_DESC";
-  MediaListSort2["MEDIA_TITLE_NATIVE"] = "MEDIA_TITLE_NATIVE";
-  MediaListSort2["MEDIA_TITLE_NATIVE_DESC"] = "MEDIA_TITLE_NATIVE_DESC";
-  MediaListSort2["MEDIA_POPULARITY"] = "MEDIA_POPULARITY";
-  MediaListSort2["MEDIA_POPULARITY_DESC"] = "MEDIA_POPULARITY_DESC";
-  return MediaListSort2;
-})(MediaListSort || {});
-
 // src/types/thread.ts
 var ThreadSort = /* @__PURE__ */ ((ThreadSort2) => {
   ThreadSort2["ID"] = "ID";
@@ -1493,6 +1572,20 @@ var ThreadSort = /* @__PURE__ */ ((ThreadSort2) => {
   return ThreadSort2;
 })(ThreadSort || {});
 
+// src/types/user.ts
+var UserSort = /* @__PURE__ */ ((UserSort2) => {
+  UserSort2["ID"] = "ID";
+  UserSort2["ID_DESC"] = "ID_DESC";
+  UserSort2["USERNAME"] = "USERNAME";
+  UserSort2["USERNAME_DESC"] = "USERNAME_DESC";
+  UserSort2["WATCHED_TIME"] = "WATCHED_TIME";
+  UserSort2["WATCHED_TIME_DESC"] = "WATCHED_TIME_DESC";
+  UserSort2["CHAPTERS_READ"] = "CHAPTERS_READ";
+  UserSort2["CHAPTERS_READ_DESC"] = "CHAPTERS_READ_DESC";
+  UserSort2["SEARCH_MATCH"] = "SEARCH_MATCH";
+  return UserSort2;
+})(UserSort || {});
+
 // src/client/media.ts
 async function getMedia(client, id, include) {
   validateId(id, "mediaId");
@@ -1509,12 +1602,24 @@ async function getMediaByMalId(client, malId, type) {
   return data.Media;
 }
 async function searchMedia(client, options = {}) {
-  const { query: search, page = 1, perPage = 20, genres, tags, genresExclude, tagsExclude, ...filters } = options;
+  const {
+    query: search,
+    page = 1,
+    perPage = 20,
+    genres,
+    tags,
+    genresExclude,
+    tagsExclude,
+    format,
+    ...filters
+  } = options;
   return client.pagedRequest(
     QUERY_MEDIA_SEARCH,
     {
       search,
       ...filters,
+      format: Array.isArray(format) ? void 0 : format,
+      format_in: Array.isArray(format) ? format : void 0,
       genre_in: genres,
       tag_in: tags,
       genre_not_in: genresExclude,
@@ -1717,7 +1822,7 @@ async function searchUsers(client, options = {}) {
 }
 async function getUserMediaList(client, options) {
   if (!options.userId && !options.userName) {
-    throw new AniListError("getUserMediaList requires either userId or userName", 0, []);
+    throw new TypeError("getUserMediaList requires either userId or userName");
   }
   if (options.userId) {
     validateId(options.userId, "userId");
@@ -1764,7 +1869,7 @@ function mapFavorites(fav) {
 
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
-var LIB_VERSION = "1.8.0" ;
+var LIB_VERSION = "1.9.0" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -1852,7 +1957,15 @@ var AniListClient = class {
       this.hooks.onError?.(error, query, variables);
       throw error;
     }
-    const json = await res.json();
+    let json;
+    try {
+      json = await res.json();
+    } catch {
+      const error = new AniListError(`Non-JSON response from AniList (HTTP ${res.status})`, res.status, []);
+      this.logger?.error("Request failed", { error: error.message, status: error.status });
+      this.hooks.onError?.(error, query, variables);
+      throw error;
+    }
     if (!res.ok || json.errors) {
       const message = json.errors?.[0]?.message ?? `AniList API error (HTTP ${res.status})`;
       const error = new AniListError(message, res.status, json.errors ?? []);
@@ -2156,92 +2269,6 @@ var AniListClient = class {
   }
 };
 
-// src/cache/redis.ts
-var RedisCache = class {
-  client;
-  prefix;
-  ttl;
-  constructor(options) {
-    this.client = options.client;
-    this.prefix = options.prefix ?? "ani:";
-    this.ttl = options.ttl ?? 86400;
-  }
-  prefixedKey(key) {
-    return `${this.prefix}${key}`;
-  }
-  async get(key) {
-    const raw = await this.client.get(this.prefixedKey(key));
-    if (raw === null) return void 0;
-    try {
-      return JSON.parse(raw);
-    } catch {
-      return void 0;
-    }
-  }
-  async set(key, data) {
-    await this.client.set(this.prefixedKey(key), JSON.stringify(data), "EX", this.ttl);
-  }
-  async delete(key) {
-    const count = await this.client.del(this.prefixedKey(key));
-    return count > 0;
-  }
-  /**
-   * Collect keys matching a pattern. Uses SCAN when available, falls back to KEYS.
-   *
-   * **Warning:** The `KEYS` fallback is O(N) and blocks the Redis server.
-   * Provide a client with `scanIterator` support for production use.
-   * @internal
-   */
-  async collectKeys(pattern) {
-    if (this.client.scanIterator) {
-      const keys = [];
-      for await (const key of this.client.scanIterator({ MATCH: pattern, COUNT: 100 })) {
-        keys.push(key);
-      }
-      return keys;
-    }
-    return this.client.keys(pattern);
-  }
-  async clear() {
-    const keys = await this.collectKeys(`${this.prefix}*`);
-    if (keys.length > 0) {
-      await this.client.del(...keys);
-    }
-  }
-  /**
-   * Get the actual number of keys with this prefix in Redis.
-   */
-  get size() {
-    return this.getSize();
-  }
-  /** @internal */
-  async getSize() {
-    const keys = await this.collectKeys(`${this.prefix}*`);
-    return keys.length;
-  }
-  async keys() {
-    const raw = await this.collectKeys(`${this.prefix}*`);
-    return raw.map((k) => k.slice(this.prefix.length));
-  }
-  /**
-   * Remove all entries whose key matches the given glob pattern.
-   *
-   * @param pattern — A glob pattern (e.g. `"*Media*"`)
-   * @returns Number of entries removed.
-   */
-  async invalidate(pattern) {
-    if (typeof pattern === "string") {
-      const keys = await this.collectKeys(`${this.prefix}${pattern}`);
-      if (keys.length === 0) return 0;
-      return this.client.del(...keys);
-    }
-    const allKeys = await this.collectKeys(`${this.prefix}*`);
-    const matching = allKeys.filter((k) => pattern.test(k.slice(this.prefix.length)));
-    if (matching.length === 0) return 0;
-    return this.client.del(...matching);
-  }
-};
-
 export { AiringSort, AniListClient, AniListError, CharacterRole, CharacterSort, MediaFormat, MediaListSort, MediaListStatus, MediaRelationType, MediaSeason, MediaSort, MediaSource, MediaStatus, MediaType, MemoryCache, RateLimiter, RecommendationSort, RedisCache, StaffSort, StudioSort, ThreadSort, UserSort, parseAniListMarkdown };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map