ani-client 2.1.0 → 2.1.2

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) {
@@ -351,7 +526,7 @@ var AniListError = class _AniListError extends Error {
     this.status = status;
     this.errors = errors;
     Object.setPrototypeOf(this, _AniListError.prototype);
-    if (Error.captureStackTrace) {
+    if ("captureStackTrace" in Error) {
       Error.captureStackTrace(this, _AniListError);
     }
   }
@@ -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,25 +639,33 @@ var RELATIONS_FIELDS = `
   }
 `;
 var MEDIA_RECOMMENDATION_FIELDS = `
+  __typename
   id
   rating
   mediaRecommendation {
+    __typename
     id
     title { romaji english native userPreferred }
     type
     format
-    coverImage { large medium }
+    coverImage { extraLarge large medium color }
     averageScore
     meanScore
    	episodes
    	chapters
    	volumes
-    nextAiringEpisode
+    nextAiringEpisode {
+      id
+      airingAt
+      episode
+      mediaId
+      timeUntilAiring
+    }
    	season
    	seasonYear
-   	startDate
-   	endDate
-   	studios
+   	startDate { year month day }
+    endDate { year month day }
+   	studios { nodes { id name isAnimationStudio siteUrl } }
    	genres
     siteUrl
   }
@@ -489,6 +675,7 @@ var MEDIA_FIELDS = `
   ${RELATIONS_FIELDS}
 `;
 var CHARACTER_FIELDS_COMPACT = `
+  __typename
   id
   name { first middle last full native alternative }
   image { large medium }
@@ -503,6 +690,7 @@ var CHARACTER_FIELDS_COMPACT = `
 var CHARACTER_MEDIA_NODES = `
   media(perPage: 10) {
     nodes {
+      __typename
       id
       title { romaji english native userPreferred }
       type
@@ -512,6 +700,7 @@ var CHARACTER_MEDIA_NODES = `
   }
 `;
 var VOICE_ACTOR_FIELDS_COMPACT = `
+  __typename
   id
   name { first middle last full native userPreferred }
   languageV2
@@ -527,6 +716,7 @@ var CHARACTER_MEDIA_EDGES_WITH_VA = `
         ${VOICE_ACTOR_FIELDS_COMPACT}
       }
       node {
+        __typename
         id
         title { romaji english native userPreferred }
         type
@@ -545,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
@@ -564,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
@@ -602,6 +794,7 @@ var STAFF_MEDIA_FIELDS = `
   }
 `;
 var USER_FIELDS = `
+  __typename
   id
   name
   about(asHtml: false)
@@ -622,6 +815,7 @@ var USER_FAVORITES_FIELDS = `
   favourites {
     anime(perPage: 25) {
       nodes {
+        __typename
         id
         title { romaji english native userPreferred }
         coverImage { large medium }
@@ -632,6 +826,7 @@ var USER_FAVORITES_FIELDS = `
     }
     manga(perPage: 25) {
       nodes {
+        __typename
         id
         title { romaji english native userPreferred }
         coverImage { large medium }
@@ -642,6 +837,7 @@ var USER_FAVORITES_FIELDS = `
     }
     characters(perPage: 25) {
       nodes {
+        __typename
         id
         name { full native }
         image { large medium }
@@ -650,6 +846,7 @@ var USER_FAVORITES_FIELDS = `
     }
     staff(perPage: 25) {
       nodes {
+        __typename
         id
         name { full native }
         image { large medium }
@@ -658,6 +855,7 @@ var USER_FAVORITES_FIELDS = `
     }
     studios(perPage: 25) {
       nodes {
+        __typename
         id
         name
         siteUrl
@@ -666,6 +864,7 @@ var USER_FAVORITES_FIELDS = `
   }
 `;
 var MEDIA_LIST_FIELDS = `
+  __typename
   id
   mediaId
   status
@@ -685,6 +884,7 @@ var MEDIA_LIST_FIELDS = `
   }
 `;
 var STUDIO_FIELDS = `
+  __typename
   id
   name
   isAnimationStudio
@@ -693,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
@@ -703,6 +904,7 @@ var STUDIO_FIELDS = `
   }
 `;
 var THREAD_FIELDS = `
+  __typename
   id
   title
   body(asHtml: false)
@@ -719,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
@@ -740,6 +946,7 @@ var THREAD_FIELDS = `
     siteUrl
   }
   likes {
+    __typename
     id
     name
   }
@@ -841,7 +1048,7 @@ query (
       timeUntilAiring
       episode
       mediaId
-      media(isAdult: $isAdult) {
+      media {
         ${MEDIA_FIELDS_BASE}
       }
     }
@@ -2117,7 +2324,7 @@ function mapFavorites(fav) {
 
 // src/client/index.ts
 var DEFAULT_API_URL = "https://graphql.anilist.co";
-var LIB_VERSION = "2.1.0" ;
+var LIB_VERSION = "2.1.2" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -2162,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);
@@ -2555,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;