ani-client 2.1.1 → 2.1.3

package/dist/index.js

@@ -124,6 +124,212 @@ 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.gc();
+    }
+    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;
+  }
+  /**
+   * Garbage-collect orphaned entities that are no longer referenced by any query.
+   * Called automatically on LRU eviction to prevent unbounded entity store growth.
+   */
+  gc() {
+    const referencedRefs = /* @__PURE__ */ new Set();
+    const collectRefs = (data) => {
+      if (Array.isArray(data)) {
+        for (const item of data) collectRefs(item);
+        return;
+      }
+      if (data !== null && typeof data === "object") {
+        const obj = data;
+        if (typeof obj.__ref === "string") {
+          referencedRefs.add(obj.__ref);
+          const entity = this.entityStore.get(obj.__ref);
+          if (entity && !referencedRefs.has(`_visited:${obj.__ref}`)) {
+            referencedRefs.add(`_visited:${obj.__ref}`);
+            collectRefs(entity);
+          }
+          return;
+        }
+        for (const v of Object.values(obj)) collectRefs(v);
+      }
+    };
+    for (const entry of this.queryStore.values()) {
+      collectRefs(entry.data);
+    }
+    let removed = 0;
+    for (const ref of this.entityStore.keys()) {
+      if (!referencedRefs.has(ref)) {
+        this.entityStore.delete(ref);
+        removed++;
+      }
+    }
+    return removed;
+  }
+};
+
 // src/cache/index.ts
 var ONE_DAY_MS = 24 * 60 * 60 * 1e3;
 var MemoryCache = class {
@@ -147,11 +353,11 @@ var MemoryCache = class {
     return `${normalized}|${JSON.stringify(sortObjectKeys(variables))}`;
   }
   /**
-   * Retrieve a cached value, or `undefined` if missing / expired.
+   * Retrieve a cached value and its stale status.
    * 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) {
+  getWithMeta(key) {
     if (!this.enabled) return void 0;
     const entry = this.store.get(key);
     if (!entry) {
@@ -164,7 +370,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 +379,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 +569,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 +596,7 @@ var MEDIA_FIELDS_LIGHT = `
   }
 `;
 var MEDIA_FIELDS_BASE = `
+  __typename
   id
   idMal
   title { romaji english native userPreferred }
@@ -431,6 +643,7 @@ var RELATIONS_FIELDS = `
     edges {
       relationType(version: 2)
       node {
+        __typename
         id
         title { romaji english native userPreferred }
         type
@@ -461,9 +674,11 @@ var RELATIONS_FIELDS = `
   }
 `;
 var MEDIA_RECOMMENDATION_FIELDS = `
+  __typename
   id
   rating
   mediaRecommendation {
+    __typename
     id
     title { romaji english native userPreferred }
     type
@@ -495,6 +710,7 @@ var MEDIA_FIELDS = `
   ${RELATIONS_FIELDS}
 `;
 var CHARACTER_FIELDS_COMPACT = `
+  __typename
   id
   name { first middle last full native alternative }
   image { large medium }
@@ -509,6 +725,7 @@ var CHARACTER_FIELDS_COMPACT = `
 var CHARACTER_MEDIA_NODES = `
   media(perPage: 10) {
     nodes {
+      __typename
       id
       title { romaji english native userPreferred }
       type
@@ -518,6 +735,7 @@ var CHARACTER_MEDIA_NODES = `
   }
 `;
 var VOICE_ACTOR_FIELDS_COMPACT = `
+  __typename
   id
   name { first middle last full native userPreferred }
   languageV2
@@ -533,6 +751,7 @@ var CHARACTER_MEDIA_EDGES_WITH_VA = `
         ${VOICE_ACTOR_FIELDS_COMPACT}
       }
       node {
+        __typename
         id
         title { romaji english native userPreferred }
         type
@@ -551,6 +770,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 +790,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 +829,7 @@ var STAFF_MEDIA_FIELDS = `
   }
 `;
 var USER_FIELDS = `
+  __typename
   id
   name
   about(asHtml: false)
@@ -628,6 +850,7 @@ var USER_FAVORITES_FIELDS = `
   favourites {
     anime(perPage: 25) {
       nodes {
+        __typename
         id
         title { romaji english native userPreferred }
         coverImage { large medium }
@@ -638,6 +861,7 @@ var USER_FAVORITES_FIELDS = `
     }
     manga(perPage: 25) {
       nodes {
+        __typename
         id
         title { romaji english native userPreferred }
         coverImage { large medium }
@@ -648,6 +872,7 @@ var USER_FAVORITES_FIELDS = `
     }
     characters(perPage: 25) {
       nodes {
+        __typename
         id
         name { full native }
         image { large medium }
@@ -656,6 +881,7 @@ var USER_FAVORITES_FIELDS = `
     }
     staff(perPage: 25) {
       nodes {
+        __typename
         id
         name { full native }
         image { large medium }
@@ -664,6 +890,7 @@ var USER_FAVORITES_FIELDS = `
     }
     studios(perPage: 25) {
       nodes {
+        __typename
         id
         name
         siteUrl
@@ -672,6 +899,7 @@ var USER_FAVORITES_FIELDS = `
   }
 `;
 var MEDIA_LIST_FIELDS = `
+  __typename
   id
   mediaId
   status
@@ -691,6 +919,7 @@ var MEDIA_LIST_FIELDS = `
   }
 `;
 var STUDIO_FIELDS = `
+  __typename
   id
   name
   isAnimationStudio
@@ -699,6 +928,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 +939,7 @@ var STUDIO_FIELDS = `
   }
 `;
 var THREAD_FIELDS = `
+  __typename
   id
   title
   body(asHtml: false)
@@ -725,20 +956,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 +981,7 @@ var THREAD_FIELDS = `
     siteUrl
   }
   likes {
+    __typename
     id
     name
   }
@@ -1989,7 +2225,11 @@ async function getReview(client, id) {
 }
 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");
+  return client.pagedRequest(
+    QUERY_REVIEWS,
+    { mediaId, userId, sort, page, perPage: clampPerPage(perPage) },
+    "reviews"
+  );
 }
 
 // src/client/staff.ts
@@ -2123,7 +2363,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.3" ;
 var AniListClient = class {
   apiUrl;
   headers;
@@ -2168,10 +2408,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);
@@ -2321,8 +2576,8 @@ var AniListClient = class {
     return getMediaByMalId(this, malId, type);
   }
   /** Get the detailed schedule for the current week, sorted by day. */
-  async getWeeklySchedule(date) {
-    return getWeeklySchedule(this, date);
+  async getWeeklySchedule(date, idNotIn) {
+    return getWeeklySchedule(this, date, idNotIn);
   }
   /** Get upcoming (not yet released) media. */
   async getPlanning(options = {}) {
@@ -2561,6 +2816,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;