ani-client 2.1.1 → 2.1.3

package/dist/index.mjs

@@ -122,6 +122,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 {
@@ -145,11 +351,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) {
@@ -162,7 +368,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++;
@@ -171,7 +377,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) {
@@ -357,6 +567,7 @@ var AniListError = class _AniListError extends Error {
 
 // src/queries/fragments.ts
 var MEDIA_FIELDS_LIGHT = `
+  __typename
   id
   idMal
   title { romaji english native userPreferred }
@@ -383,6 +594,7 @@ var MEDIA_FIELDS_LIGHT = `
   }
 `;
 var MEDIA_FIELDS_BASE = `
+  __typename
   id
   idMal
   title { romaji english native userPreferred }
@@ -429,6 +641,7 @@ var RELATIONS_FIELDS = `
     edges {
       relationType(version: 2)
       node {
+        __typename
         id
         title { romaji english native userPreferred }
         type
@@ -459,9 +672,11 @@ var RELATIONS_FIELDS = `
   }
 `;
 var MEDIA_RECOMMENDATION_FIELDS = `
+  __typename
   id
   rating
   mediaRecommendation {
+    __typename
     id
     title { romaji english native userPreferred }
     type
@@ -493,6 +708,7 @@ var MEDIA_FIELDS = `
   ${RELATIONS_FIELDS}
 `;
 var CHARACTER_FIELDS_COMPACT = `
+  __typename
   id
   name { first middle last full native alternative }
   image { large medium }
@@ -507,6 +723,7 @@ var CHARACTER_FIELDS_COMPACT = `
 var CHARACTER_MEDIA_NODES = `
   media(perPage: 10) {
     nodes {
+      __typename
       id
       title { romaji english native userPreferred }
       type
@@ -516,6 +733,7 @@ var CHARACTER_MEDIA_NODES = `
   }
 `;
 var VOICE_ACTOR_FIELDS_COMPACT = `
+  __typename
   id
   name { first middle last full native userPreferred }
   languageV2
@@ -531,6 +749,7 @@ var CHARACTER_MEDIA_EDGES_WITH_VA = `
         ${VOICE_ACTOR_FIELDS_COMPACT}
       }
       node {
+        __typename
         id
         title { romaji english native userPreferred }
         type
@@ -549,6 +768,7 @@ var CHARACTER_FIELDS_WITH_VA = `
   ${CHARACTER_MEDIA_EDGES_WITH_VA}
 `;
 var STAFF_FIELDS = `
+  __typename
   id
   name { first middle last full native }
   language
@@ -568,6 +788,7 @@ var STAFF_FIELDS = `
 var STAFF_MEDIA_FIELDS = `
   staffMedia(perPage: $perPage, sort: [POPULARITY_DESC]) {
     nodes {
+      __typename
       id
       title { romaji english native userPreferred }
       type
@@ -606,6 +827,7 @@ var STAFF_MEDIA_FIELDS = `
   }
 `;
 var USER_FIELDS = `
+  __typename
   id
   name
   about(asHtml: false)
@@ -626,6 +848,7 @@ var USER_FAVORITES_FIELDS = `
   favourites {
     anime(perPage: 25) {
       nodes {
+        __typename
         id
         title { romaji english native userPreferred }
         coverImage { large medium }
@@ -636,6 +859,7 @@ var USER_FAVORITES_FIELDS = `
     }
     manga(perPage: 25) {
       nodes {
+        __typename
         id
         title { romaji english native userPreferred }
         coverImage { large medium }
@@ -646,6 +870,7 @@ var USER_FAVORITES_FIELDS = `
     }
     characters(perPage: 25) {
       nodes {
+        __typename
         id
         name { full native }
         image { large medium }
@@ -654,6 +879,7 @@ var USER_FAVORITES_FIELDS = `
     }
     staff(perPage: 25) {
       nodes {
+        __typename
         id
         name { full native }
         image { large medium }
@@ -662,6 +888,7 @@ var USER_FAVORITES_FIELDS = `
     }
     studios(perPage: 25) {
       nodes {
+        __typename
         id
         name
         siteUrl
@@ -670,6 +897,7 @@ var USER_FAVORITES_FIELDS = `
   }
 `;
 var MEDIA_LIST_FIELDS = `
+  __typename
   id
   mediaId
   status
@@ -689,6 +917,7 @@ var MEDIA_LIST_FIELDS = `
   }
 `;
 var STUDIO_FIELDS = `
+  __typename
   id
   name
   isAnimationStudio
@@ -697,6 +926,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
@@ -707,6 +937,7 @@ var STUDIO_FIELDS = `
   }
 `;
 var THREAD_FIELDS = `
+  __typename
   id
   title
   body(asHtml: false)
@@ -723,20 +954,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
@@ -744,6 +979,7 @@ var THREAD_FIELDS = `
     siteUrl
   }
   likes {
+    __typename
     id
     name
   }
@@ -1987,7 +2223,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
@@ -2121,7 +2361,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;
@@ -2166,10 +2406,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);
@@ -2319,8 +2574,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 = {}) {
@@ -2544,6 +2799,6 @@ var AniListClient = class {
   }
 };
 
-export { AiringSort, AniListClient, AniListError, CharacterRole, CharacterSort, MediaFormat, MediaListSort, MediaListStatus, MediaRelationType, MediaSeason, MediaSort, MediaSource, MediaStatus, MediaType, MemoryCache, RateLimiter, RecommendationSort, RedisCache, ReviewSort, StaffSort, StudioSort, ThreadSort, UserSort, parseAniListMarkdown };
+export { AiringSort, AniListClient, AniListError, CharacterRole, CharacterSort, MediaFormat, MediaListSort, MediaListStatus, MediaRelationType, MediaSeason, MediaSort, MediaSource, MediaStatus, MediaType, MemoryCache, NormalizedCache, RateLimiter, RecommendationSort, RedisCache, ReviewSort, StaffSort, StudioSort, ThreadSort, UserSort, parseAniListMarkdown };
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map