ani-client 2.1.1 → 2.1.2

package/dist/index.d.mts

@@ -29,6 +29,17 @@ interface ExternalLink {
 interface CacheAdapter {
     /** Retrieve a cached value, or `undefined` if missing / expired. */
     get<T>(key: string): T | undefined | Promise<T | undefined>;
+    /**
+     * Retrieve a cached value along with its stale status (for stale-while-revalidate).
+     * If implemented, the client will use this to trigger background revalidation.
+     */
+    getWithMeta?<T>(key: string): {
+        data: T;
+        stale: boolean;
+    } | undefined | Promise<{
+        data: T;
+        stale: boolean;
+    } | undefined>;
     /** Store a value in the cache. */
     set<T>(key: string, data: T): void | Promise<void>;
     /** Remove a specific entry. Returns `true` if the key existed. */
@@ -1070,6 +1081,47 @@ interface SearchThreadOptions {
     perPage?: number;
 }
 
+/**
+ * Normalized Cache Adapter for AniListClient.
+ *
+ * This cache intercepts GraphQL responses, extracts objects with `__typename` and `id`,
+ * and stores them flat in an entity store.
+ * This ensures data consistency across all queries (e.g., `getMedia(1)` and `searchMedia`
+ * share the exact same `Media` object).
+ */
+declare class NormalizedCache implements CacheAdapter {
+    private readonly ttl;
+    private readonly maxSize;
+    private readonly enabled;
+    private readonly swrMs;
+    private readonly queryStore;
+    private readonly entityStore;
+    private _hits;
+    private _misses;
+    private _stales;
+    constructor(options?: CacheOptions);
+    static key(query: string, variables: Record<string, unknown>): string;
+    /** Normalizes a GraphQL response, extracting entities and returning a tree of references. */
+    private normalize;
+    /** Reconstructs a GraphQL response from references. */
+    private denormalize;
+    getWithMeta<T>(key: string): {
+        data: T;
+        stale: boolean;
+    } | undefined;
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, data: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+    get size(): number;
+    keys(): string[];
+    invalidate(pattern: string | RegExp): number;
+    get stats(): CacheStats & {
+        entitiesCount: number;
+    };
+    resetStats(): void;
+}
+
 /** Cache performance statistics. */
 interface CacheStats {
     /** Total cache hits. */
@@ -1098,6 +1150,13 @@ declare class MemoryCache implements CacheAdapter {
      * With stale-while-revalidate enabled, returns stale data within the grace window
      * and flags it so the caller can refresh in the background.
      */
+    /**
+     * Retrieve a cached value and its stale status.
+     */
+    getWithMeta<T>(key: string): {
+        data: T;
+        stale: boolean;
+    } | undefined;
     get<T>(key: string): T | undefined;
     /** Store a value in the cache. */
     set<T>(key: string, data: T): void;
@@ -1473,4 +1532,4 @@ declare class RateLimiter {
 
 declare function parseAniListMarkdown(text: string): string;
 
-export { type AiringSchedule, AiringSort, AniListClient, type AniListClientOptions, AniListError, type AniListHooks, type CacheAdapter, type CacheOptions, type CacheStats, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type DayOfWeek, type ExternalLink, type FavoriteCharacterNode, type FavoriteMediaNode, type FavoriteStaffNode, type FavoriteStudioNode, type FuzzyDate, type GetAiringOptions, type GetMediaCharactersOptions, type GetMediaStaffOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Logger, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, MediaSource, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type NextAiringEpisode, type PageInfo, type PagedResult, type RateLimitInfo, type RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, RedisCache, type RedisCacheOptions, type RedisLikeClient, type ResponseMeta, type Review, ReviewSort, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchReviewOptions, type SearchStaffOptions, type SearchStudioOptions, type SearchThreadOptions, type SearchUserOptions, type Staff, type StaffImage, type StaffIncludeOptions, type StaffMediaNode, type StaffName, StaffSort, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioIncludeOptions, StudioSort, type Thread, type ThreadCategory, type ThreadMediaCategory, ThreadSort, type User, type UserAvatar, type UserFavorites, type UserFavoritesOptions, UserSort, type UserStatistics, type VoiceActor, type WeeklySchedule, parseAniListMarkdown };
+export { type AiringSchedule, AiringSort, AniListClient, type AniListClientOptions, AniListError, type AniListHooks, type CacheAdapter, type CacheOptions, type CacheStats, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type DayOfWeek, type ExternalLink, type FavoriteCharacterNode, type FavoriteMediaNode, type FavoriteStaffNode, type FavoriteStudioNode, type FuzzyDate, type GetAiringOptions, type GetMediaCharactersOptions, type GetMediaStaffOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Logger, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, MediaSource, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type NextAiringEpisode, NormalizedCache, type PageInfo, type PagedResult, type RateLimitInfo, type RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, RedisCache, type RedisCacheOptions, type RedisLikeClient, type ResponseMeta, type Review, ReviewSort, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchReviewOptions, type SearchStaffOptions, type SearchStudioOptions, type SearchThreadOptions, type SearchUserOptions, type Staff, type StaffImage, type StaffIncludeOptions, type StaffMediaNode, type StaffName, StaffSort, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioIncludeOptions, StudioSort, type Thread, type ThreadCategory, type ThreadMediaCategory, ThreadSort, type User, type UserAvatar, type UserFavorites, type UserFavoritesOptions, UserSort, type UserStatistics, type VoiceActor, type WeeklySchedule, parseAniListMarkdown };

package/dist/index.d.ts

@@ -29,6 +29,17 @@ interface ExternalLink {
 interface CacheAdapter {
     /** Retrieve a cached value, or `undefined` if missing / expired. */
     get<T>(key: string): T | undefined | Promise<T | undefined>;
+    /**
+     * Retrieve a cached value along with its stale status (for stale-while-revalidate).
+     * If implemented, the client will use this to trigger background revalidation.
+     */
+    getWithMeta?<T>(key: string): {
+        data: T;
+        stale: boolean;
+    } | undefined | Promise<{
+        data: T;
+        stale: boolean;
+    } | undefined>;
     /** Store a value in the cache. */
     set<T>(key: string, data: T): void | Promise<void>;
     /** Remove a specific entry. Returns `true` if the key existed. */
@@ -1070,6 +1081,47 @@ interface SearchThreadOptions {
     perPage?: number;
 }
 
+/**
+ * Normalized Cache Adapter for AniListClient.
+ *
+ * This cache intercepts GraphQL responses, extracts objects with `__typename` and `id`,
+ * and stores them flat in an entity store.
+ * This ensures data consistency across all queries (e.g., `getMedia(1)` and `searchMedia`
+ * share the exact same `Media` object).
+ */
+declare class NormalizedCache implements CacheAdapter {
+    private readonly ttl;
+    private readonly maxSize;
+    private readonly enabled;
+    private readonly swrMs;
+    private readonly queryStore;
+    private readonly entityStore;
+    private _hits;
+    private _misses;
+    private _stales;
+    constructor(options?: CacheOptions);
+    static key(query: string, variables: Record<string, unknown>): string;
+    /** Normalizes a GraphQL response, extracting entities and returning a tree of references. */
+    private normalize;
+    /** Reconstructs a GraphQL response from references. */
+    private denormalize;
+    getWithMeta<T>(key: string): {
+        data: T;
+        stale: boolean;
+    } | undefined;
+    get<T>(key: string): T | undefined;
+    set<T>(key: string, data: T): void;
+    delete(key: string): boolean;
+    clear(): void;
+    get size(): number;
+    keys(): string[];
+    invalidate(pattern: string | RegExp): number;
+    get stats(): CacheStats & {
+        entitiesCount: number;
+    };
+    resetStats(): void;
+}
+
 /** Cache performance statistics. */
 interface CacheStats {
     /** Total cache hits. */
@@ -1098,6 +1150,13 @@ declare class MemoryCache implements CacheAdapter {
      * With stale-while-revalidate enabled, returns stale data within the grace window
      * and flags it so the caller can refresh in the background.
      */
+    /**
+     * Retrieve a cached value and its stale status.
+     */
+    getWithMeta<T>(key: string): {
+        data: T;
+        stale: boolean;
+    } | undefined;
     get<T>(key: string): T | undefined;
     /** Store a value in the cache. */
     set<T>(key: string, data: T): void;
@@ -1473,4 +1532,4 @@ declare class RateLimiter {
 
 declare function parseAniListMarkdown(text: string): string;
 
-export { type AiringSchedule, AiringSort, AniListClient, type AniListClientOptions, AniListError, type AniListHooks, type CacheAdapter, type CacheOptions, type CacheStats, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type DayOfWeek, type ExternalLink, type FavoriteCharacterNode, type FavoriteMediaNode, type FavoriteStaffNode, type FavoriteStudioNode, type FuzzyDate, type GetAiringOptions, type GetMediaCharactersOptions, type GetMediaStaffOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Logger, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, MediaSource, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type NextAiringEpisode, type PageInfo, type PagedResult, type RateLimitInfo, type RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, RedisCache, type RedisCacheOptions, type RedisLikeClient, type ResponseMeta, type Review, ReviewSort, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchReviewOptions, type SearchStaffOptions, type SearchStudioOptions, type SearchThreadOptions, type SearchUserOptions, type Staff, type StaffImage, type StaffIncludeOptions, type StaffMediaNode, type StaffName, StaffSort, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioIncludeOptions, StudioSort, type Thread, type ThreadCategory, type ThreadMediaCategory, ThreadSort, type User, type UserAvatar, type UserFavorites, type UserFavoritesOptions, UserSort, type UserStatistics, type VoiceActor, type WeeklySchedule, parseAniListMarkdown };
+export { type AiringSchedule, AiringSort, AniListClient, type AniListClientOptions, AniListError, type AniListHooks, type CacheAdapter, type CacheOptions, type CacheStats, type Character, type CharacterImage, type CharacterIncludeOptions, type CharacterMediaEdge, type CharacterName, CharacterRole, CharacterSort, type DayOfWeek, type ExternalLink, type FavoriteCharacterNode, type FavoriteMediaNode, type FavoriteStaffNode, type FavoriteStudioNode, type FuzzyDate, type GetAiringOptions, type GetMediaCharactersOptions, type GetMediaStaffOptions, type GetPlanningOptions, type GetRecentChaptersOptions, type GetRecommendationsOptions, type GetSeasonOptions, type GetUserMediaListOptions, type Logger, type Media, type MediaCharacterConnection, type MediaCharacterEdge, type MediaConnection, type MediaCoverImage, type MediaEdge, MediaFormat, type MediaIncludeOptions, type MediaListEntry, MediaListSort, MediaListStatus, type MediaRecommendationNode, MediaRelationType, MediaSeason, MediaSort, MediaSource, type MediaStaffConnection, type MediaStaffEdge, type MediaStats, MediaStatus, type MediaTag, type MediaTitle, type MediaTrailer, MediaType, MemoryCache, type NextAiringEpisode, NormalizedCache, type PageInfo, type PagedResult, type RateLimitInfo, type RateLimitOptions, RateLimiter, type Recommendation, RecommendationSort, RedisCache, type RedisCacheOptions, type RedisLikeClient, type ResponseMeta, type Review, ReviewSort, type ScoreDistribution, type SearchCharacterOptions, type SearchMediaOptions, type SearchReviewOptions, type SearchStaffOptions, type SearchStudioOptions, type SearchThreadOptions, type SearchUserOptions, type Staff, type StaffImage, type StaffIncludeOptions, type StaffMediaNode, type StaffName, StaffSort, type StatusDistribution, type StreamingEpisode, type Studio, type StudioConnection, type StudioIncludeOptions, StudioSort, type Thread, type ThreadCategory, type ThreadMediaCategory, ThreadSort, type User, type UserAvatar, type UserFavorites, type UserFavoritesOptions, UserSort, type UserStatistics, type VoiceActor, type WeeklySchedule, parseAniListMarkdown };

package/dist/index.js

@@ -124,6 +124,174 @@ function sortObjectKeys(obj) {
   return sorted;
 }
 
+// src/cache/normalized.ts
+var NormalizedCache = class {
+  ttl;
+  maxSize;
+  enabled;
+  swrMs;
+  queryStore = /* @__PURE__ */ new Map();
+  entityStore = /* @__PURE__ */ new Map();
+  _hits = 0;
+  _misses = 0;
+  _stales = 0;
+  constructor(options = {}) {
+    this.ttl = options.ttl ?? 24 * 60 * 60 * 1e3;
+    this.maxSize = options.maxSize ?? 500;
+    this.enabled = options.enabled ?? true;
+    this.swrMs = options.staleWhileRevalidateMs ?? 0;
+  }
+  static key(query, variables) {
+    const normalized = normalizeQuery(query);
+    return `${normalized}|${JSON.stringify(sortObjectKeys(variables))}`;
+  }
+  /** Normalizes a GraphQL response, extracting entities and returning a tree of references. */
+  normalize(data, seen = /* @__PURE__ */ new WeakSet()) {
+    if (Array.isArray(data)) {
+      if (seen.has(data)) return null;
+      seen.add(data);
+      return data.map((item) => this.normalize(item, seen));
+    }
+    if (data !== null && typeof data === "object") {
+      if (seen.has(data)) return null;
+      seen.add(data);
+      const obj = data;
+      if (typeof obj.__typename === "string" && (typeof obj.id === "number" || typeof obj.id === "string")) {
+        const ref = `${obj.__typename}:${obj.id}`;
+        const normalizedObj = {};
+        for (const [k, v] of Object.entries(obj)) {
+          normalizedObj[k] = this.normalize(v, seen);
+        }
+        const existing = this.entityStore.get(ref) || {};
+        this.entityStore.set(ref, { ...existing, ...normalizedObj });
+        return { __ref: ref };
+      }
+      const result = {};
+      for (const [k, v] of Object.entries(obj)) {
+        result[k] = this.normalize(v, seen);
+      }
+      return result;
+    }
+    return data;
+  }
+  /** Reconstructs a GraphQL response from references. */
+  denormalize(data, seen = /* @__PURE__ */ new Set()) {
+    if (Array.isArray(data)) {
+      return data.map((item) => this.denormalize(item, seen));
+    }
+    if (data !== null && typeof data === "object") {
+      const obj = data;
+      if (typeof obj.__ref === "string") {
+        const ref = obj.__ref;
+        if (seen.has(ref)) {
+          return { __ref: ref };
+        }
+        seen.add(ref);
+        const entity = this.entityStore.get(ref);
+        if (!entity) return void 0;
+        const result2 = this.denormalize(entity, seen);
+        seen.delete(ref);
+        return result2;
+      }
+      const result = {};
+      for (const [k, v] of Object.entries(obj)) {
+        const denormalized = this.denormalize(v, seen);
+        if (denormalized === void 0) return void 0;
+        result[k] = denormalized;
+      }
+      return result;
+    }
+    return data;
+  }
+  getWithMeta(key) {
+    if (!this.enabled) return void 0;
+    const entry = this.queryStore.get(key);
+    if (!entry) {
+      this._misses++;
+      return void 0;
+    }
+    const now = Date.now();
+    let isStale = false;
+    if (now > entry.expiresAt) {
+      if (this.swrMs > 0 && now <= entry.expiresAt + this.swrMs) {
+        isStale = true;
+      } else {
+        this.queryStore.delete(key);
+        this._misses++;
+        return void 0;
+      }
+    }
+    const denormalized = this.denormalize(entry.data);
+    if (denormalized === void 0) {
+      this.queryStore.delete(key);
+      this._misses++;
+      return void 0;
+    }
+    this.queryStore.delete(key);
+    this.queryStore.set(key, entry);
+    if (isStale) {
+      this._stales++;
+    } else {
+      this._hits++;
+    }
+    return { data: denormalized, stale: isStale };
+  }
+  get(key) {
+    const res = this.getWithMeta(key);
+    return res ? res.data : void 0;
+  }
+  set(key, data) {
+    if (!this.enabled) return;
+    const normalizedData = this.normalize(data);
+    this.queryStore.delete(key);
+    if (this.maxSize > 0 && this.queryStore.size >= this.maxSize) {
+      const firstKey = this.queryStore.keys().next().value;
+      if (firstKey !== void 0) this.queryStore.delete(firstKey);
+    }
+    this.queryStore.set(key, { data: normalizedData, expiresAt: Date.now() + this.ttl });
+  }
+  delete(key) {
+    return this.queryStore.delete(key);
+  }
+  clear() {
+    this.queryStore.clear();
+    this.entityStore.clear();
+    this._hits = 0;
+    this._misses = 0;
+    this._stales = 0;
+  }
+  get size() {
+    return this.queryStore.size;
+  }
+  keys() {
+    return [...this.queryStore.keys()];
+  }
+  invalidate(pattern) {
+    const test = typeof pattern === "string" ? (key) => key.includes(pattern) : (key) => pattern.test(key);
+    const toDelete = [];
+    for (const key of this.queryStore.keys()) {
+      if (test(key)) toDelete.push(key);
+    }
+    for (const key of toDelete) this.queryStore.delete(key);
+    return toDelete.length;
+  }
+  get stats() {
+    const total = this._hits + this._misses + this._stales;
+    return {
+      hits: this._hits,
+      misses: this._misses,
+      stales: this._stales,
+      hitRate: total === 0 ? Number.NaN : this._hits / total,
+      entitiesCount: this.entityStore.size
+    };
+  }
+  resetStats() {
+    this._hits = 0;
+    this._misses = 0;
+    this._stales = 0;
+  }
+};
+
 // src/cache/index.ts
 var ONE_DAY_MS = 24 * 60 * 60 * 1e3;
 var MemoryCache = class {
@@ -151,7 +319,10 @@ var MemoryCache = class {
    * With stale-while-revalidate enabled, returns stale data within the grace window
    * and flags it so the caller can refresh in the background.
    */
-  get(key) {
+  /**
+   * Retrieve a cached value and its stale status.
+   */
+  getWithMeta(key) {
     if (!this.enabled) return void 0;
     const entry = this.store.get(key);
     if (!entry) {
@@ -164,7 +335,7 @@ var MemoryCache = class {
         this.store.delete(key);
         this.store.set(key, entry);
         this._stales++;
-        return entry.data;
+        return { data: entry.data, stale: true };
       }
       this.store.delete(key);
       this._misses++;
@@ -173,7 +344,11 @@ var MemoryCache = class {
     this.store.delete(key);
     this.store.set(key, entry);
     this._hits++;
-    return entry.data;
+    return { data: entry.data, stale: false };
+  }
+  get(key) {
+    const res = this.getWithMeta(key);
+    return res ? res.data : void 0;
   }
   /** Store a value in the cache. */
   set(key, data) {
@@ -359,6 +534,7 @@ var AniListError = class _AniListError extends Error {
 
 // src/queries/fragments.ts
 var MEDIA_FIELDS_LIGHT = `
+  __typename
   id
   idMal
   title { romaji english native userPreferred }
@@ -385,6 +561,7 @@ var MEDIA_FIELDS_LIGHT = `
   }
 `;
 var MEDIA_FIELDS_BASE = `
+  __typename
   id
   idMal
   title { romaji english native userPreferred }
@@ -431,6 +608,7 @@ var RELATIONS_FIELDS = `
     edges {
       relationType(version: 2)
       node {
+        __typename
         id
         title { romaji english native userPreferred }
         type
@@ -461,9 +639,11 @@ var RELATIONS_FIELDS = `
   }
 `;
 var MEDIA_RECOMMENDATION_FIELDS = `
+  __typename
   id
   rating
   mediaRecommendation {
+    __typename
     id
     title { romaji english native userPreferred }
     type
@@ -495,6 +675,7 @@ var MEDIA_FIELDS = `
   ${RELATIONS_FIELDS}
 `;
 var CHARACTER_FIELDS_COMPACT = `
+  __typename
   id
   name { first middle last full native alternative }
   image { large medium }
@@ -509,6 +690,7 @@ var CHARACTER_FIELDS_COMPACT = `
 var CHARACTER_MEDIA_NODES = `
   media(perPage: 10) {
     nodes {
+      __typename
       id
       title { romaji english native userPreferred }
       type
@@ -518,6 +700,7 @@ var CHARACTER_MEDIA_NODES = `
   }
 `;
 var VOICE_ACTOR_FIELDS_COMPACT = `
+  __typename
   id
   name { first middle last full native userPreferred }
   languageV2
@@ -533,6 +716,7 @@ var CHARACTER_MEDIA_EDGES_WITH_VA = `
         ${VOICE_ACTOR_FIELDS_COMPACT}
       }
       node {
+        __typename
         id
         title { romaji english native userPreferred }
         type
@@ -551,6 +735,7 @@ var CHARACTER_FIELDS_WITH_VA = `
   ${CHARACTER_MEDIA_EDGES_WITH_VA}
 `;
 var STAFF_FIELDS = `
+  __typename
   id
   name { first middle last full native }
   language
@@ -570,6 +755,7 @@ var STAFF_FIELDS = `
 var STAFF_MEDIA_FIELDS = `
   staffMedia(perPage: $perPage, sort: [POPULARITY_DESC]) {
     nodes {
+      __typename
       id
       title { romaji english native userPreferred }
       type
@@ -608,6 +794,7 @@ var STAFF_MEDIA_FIELDS = `
   }
 `;
 var USER_FIELDS = `
+  __typename
   id
   name
   about(asHtml: false)
@@ -628,6 +815,7 @@ var USER_FAVORITES_FIELDS = `
   favourites {
     anime(perPage: 25) {
       nodes {
+        __typename
         id
         title { romaji english native userPreferred }
         coverImage { large medium }
@@ -638,6 +826,7 @@ var USER_FAVORITES_FIELDS = `
     }
     manga(perPage: 25) {
       nodes {
+        __typename
         id
         title { romaji english native userPreferred }
         coverImage { large medium }
@@ -648,6 +837,7 @@ var USER_FAVORITES_FIELDS = `
     }
     characters(perPage: 25) {
       nodes {
+        __typename
         id
         name { full native }
         image { large medium }
@@ -656,6 +846,7 @@ var USER_FAVORITES_FIELDS = `
     }
     staff(perPage: 25) {
       nodes {
+        __typename
         id
         name { full native }
         image { large medium }
@@ -664,6 +855,7 @@ var USER_FAVORITES_FIELDS = `
     }
     studios(perPage: 25) {
       nodes {
+        __typename
         id
         name
         siteUrl
@@ -672,6 +864,7 @@ var USER_FAVORITES_FIELDS = `
   }
 `;
 var MEDIA_LIST_FIELDS = `
+  __typename
   id
   mediaId
   status
@@ -691,6 +884,7 @@ var MEDIA_LIST_FIELDS = `
   }
 `;
 var STUDIO_FIELDS = `
+  __typename
   id
   name
   isAnimationStudio
@@ -699,6 +893,7 @@ var STUDIO_FIELDS = `
   media(page: 1, perPage: 25, sort: POPULARITY_DESC) {
     pageInfo { total perPage currentPage lastPage hasNextPage }
     nodes {
+      __typename
       id
       title { romaji english native userPreferred }
       type
@@ -709,6 +904,7 @@ var STUDIO_FIELDS = `
   }
 `;
 var THREAD_FIELDS = `
+  __typename
   id
   title
   body(asHtml: false)
@@ -725,20 +921,24 @@ var THREAD_FIELDS = `
   updatedAt
   siteUrl
   user {
+    __typename
     id
     name
     avatar { large medium }
   }
   replyUser {
+    __typename
     id
     name
     avatar { large medium }
   }
   categories {
+    __typename
     id
     name
   }
   mediaCategories {
+    __typename
     id
     title { romaji english native userPreferred }
     type
@@ -746,6 +946,7 @@ var THREAD_FIELDS = `
     siteUrl
   }
   likes {
+    __typename
     id
     name
   }
@@ -2123,7 +2324,7 @@ function mapFavorites(fav) {
 
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
-var LIB_VERSION = "2.1.1" ;
+var LIB_VERSION = "2.1.2" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -2168,10 +2369,25 @@ var AniListClient = class {
   /** @internal */
   async request(query, variables = {}) {
     const cacheKey = MemoryCache.key(query, variables);
-    const cached = await this.cacheAdapter.get(cacheKey);
+    let cached;
+    let isStale = false;
+    if (this.cacheAdapter.getWithMeta) {
+      const res = await this.cacheAdapter.getWithMeta(cacheKey);
+      if (res) {
+        cached = res.data;
+        isStale = res.stale;
+      }
+    } else {
+      cached = await this.cacheAdapter.get(cacheKey);
+    }
     if (cached !== void 0) {
+      if (isStale) {
+        this.executeRequest(query, variables, cacheKey).catch((err) => {
+          this.logger?.error("Background revalidation failed", { error: err.message, cacheKey });
+        });
+      }
       this.hooks.onCacheHit?.(cacheKey);
-      this.logger?.debug("Cache hit", { cacheKey });
+      this.logger?.debug("Cache hit", { cacheKey, isStale });
       const meta = { durationMs: 0, fromCache: true };
       this._lastRequestMeta = meta;
       this.hooks.onResponse?.(query, 0, true);
@@ -2561,6 +2777,7 @@ exports.MediaSource = MediaSource;
 exports.MediaStatus = MediaStatus;
 exports.MediaType = MediaType;
 exports.MemoryCache = MemoryCache;
+exports.NormalizedCache = NormalizedCache;
 exports.RateLimiter = RateLimiter;
 exports.RecommendationSort = RecommendationSort;
 exports.RedisCache = RedisCache;