ani-client 1.8.0 → 1.8.1

package/README.md

@@ -1,11 +1,9 @@
 # ani-client
 
-![ani-client logo](docs/public/assets/logo.png)
-
 [![CI](https://github.com/gonzyui/ani-client/actions/workflows/ci.yml/badge.svg)](https://github.com/gonzyui/ani-client/actions/workflows/ci.yml)
 [![npm version](https://img.shields.io/npm/v/ani-client)](https://www.npmjs.com/package/ani-client)
 [![npm downloads](https://img.shields.io/npm/dm/ani-client)](https://www.npmjs.com/package/ani-client)
-[![bundle size](https://img.shields.io/bundlephobia/minzip/ani-client)](https://bundlephobia.com/package/ani-client)
+[![codecov](https://codecov.io/gh/gonzyui/ani-client/graph/badge.svg)](https://codecov.io/gh/gonzyui/ani-client)
 [![TypeScript](https://img.shields.io/badge/TypeScript-strict-blue)](https://www.typescriptlang.org/)
 [![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
 

package/dist/index.d.mts

@@ -1,9 +1,9 @@
 interface PageInfo {
     total: number | null;
-    perPage: number | null;
-    currentPage: number | null;
-    lastPage: number | null;
-    hasNextPage: boolean | null;
+    perPage: number;
+    currentPage: number;
+    lastPage: number;
+    hasNextPage: boolean;
 }
 interface PagedResult<T> {
     pageInfo: PageInfo;
@@ -155,6 +155,78 @@ interface AniListClientOptions {
     logger?: Logger;
 }
 
+declare enum MediaListStatus {
+    CURRENT = "CURRENT",
+    PLANNING = "PLANNING",
+    COMPLETED = "COMPLETED",
+    DROPPED = "DROPPED",
+    PAUSED = "PAUSED",
+    REPEATING = "REPEATING"
+}
+declare enum MediaListSort {
+    MEDIA_ID = "MEDIA_ID",
+    MEDIA_ID_DESC = "MEDIA_ID_DESC",
+    SCORE = "SCORE",
+    SCORE_DESC = "SCORE_DESC",
+    STATUS = "STATUS",
+    STATUS_DESC = "STATUS_DESC",
+    PROGRESS = "PROGRESS",
+    PROGRESS_DESC = "PROGRESS_DESC",
+    PROGRESS_VOLUMES = "PROGRESS_VOLUMES",
+    PROGRESS_VOLUMES_DESC = "PROGRESS_VOLUMES_DESC",
+    REPEAT = "REPEAT",
+    REPEAT_DESC = "REPEAT_DESC",
+    PRIORITY = "PRIORITY",
+    PRIORITY_DESC = "PRIORITY_DESC",
+    STARTED_ON = "STARTED_ON",
+    STARTED_ON_DESC = "STARTED_ON_DESC",
+    FINISHED_ON = "FINISHED_ON",
+    FINISHED_ON_DESC = "FINISHED_ON_DESC",
+    ADDED_TIME = "ADDED_TIME",
+    ADDED_TIME_DESC = "ADDED_TIME_DESC",
+    UPDATED_TIME = "UPDATED_TIME",
+    UPDATED_TIME_DESC = "UPDATED_TIME_DESC",
+    MEDIA_TITLE_ROMAJI = "MEDIA_TITLE_ROMAJI",
+    MEDIA_TITLE_ROMAJI_DESC = "MEDIA_TITLE_ROMAJI_DESC",
+    MEDIA_TITLE_ENGLISH = "MEDIA_TITLE_ENGLISH",
+    MEDIA_TITLE_ENGLISH_DESC = "MEDIA_TITLE_ENGLISH_DESC",
+    MEDIA_TITLE_NATIVE = "MEDIA_TITLE_NATIVE",
+    MEDIA_TITLE_NATIVE_DESC = "MEDIA_TITLE_NATIVE_DESC",
+    MEDIA_POPULARITY = "MEDIA_POPULARITY",
+    MEDIA_POPULARITY_DESC = "MEDIA_POPULARITY_DESC"
+}
+interface MediaListEntry {
+    id: number;
+    mediaId: number;
+    status: MediaListStatus;
+    score: number | null;
+    progress: number | null;
+    progressVolumes: number | null;
+    repeat: number | null;
+    priority: number | null;
+    private: boolean | null;
+    notes: string | null;
+    startedAt: FuzzyDate | null;
+    completedAt: FuzzyDate | null;
+    updatedAt: number | null;
+    createdAt: number | null;
+    media: Media;
+}
+interface GetUserMediaListOptions {
+    /** User ID (provide either userId or userName) */
+    userId?: number;
+    /** Username (provide either userId or userName) */
+    userName?: string;
+    /** ANIME or MANGA */
+    type: MediaType;
+    /** Filter by list status (CURRENT, COMPLETED, etc.) */
+    status?: MediaListStatus;
+    /** Sort order */
+    sort?: MediaListSort[];
+    page?: number;
+    perPage?: number;
+}
+
 declare enum StaffSort {
     ID = "ID",
     ID_DESC = "ID_DESC",
@@ -259,139 +331,6 @@ interface VoiceActor extends Pick<Staff, "id" | "image" | "gender" | "primaryOcc
     languageV2: string | null;
 }
 
-declare enum CharacterSort {
-    ID = "ID",
-    ID_DESC = "ID_DESC",
-    ROLE = "ROLE",
-    ROLE_DESC = "ROLE_DESC",
-    SEARCH_MATCH = "SEARCH_MATCH",
-    FAVOURITES = "FAVOURITES",
-    FAVOURITES_DESC = "FAVOURITES_DESC"
-}
-declare enum CharacterRole {
-    MAIN = "MAIN",
-    SUPPORTING = "SUPPORTING",
-    BACKGROUND = "BACKGROUND"
-}
-interface CharacterName {
-    first: string | null;
-    middle: string | null;
-    last: string | null;
-    full: string | null;
-    native: string | null;
-    alternative: string[];
-}
-interface CharacterImage {
-    large: string | null;
-    medium: string | null;
-}
-type CharacterMediaNode = Pick<Media, "id" | "title" | "type" | "coverImage" | "siteUrl">;
-interface CharacterMediaEdge {
-    node: CharacterMediaNode;
-    voiceActors?: VoiceActor[];
-}
-interface Character {
-    id: number;
-    name: CharacterName;
-    image: CharacterImage;
-    description: string | null;
-    gender: string | null;
-    dateOfBirth: FuzzyDate | null;
-    age: string | null;
-    bloodType: string | null;
-    favourites: number | null;
-    siteUrl: string | null;
-    media: {
-        nodes?: CharacterMediaNode[];
-        edges?: CharacterMediaEdge[];
-    } | null;
-}
-/** Options for including extra data when fetching a character. */
-interface CharacterIncludeOptions {
-    /** Include voice actors for each media the character appears in. */
-    voiceActors?: boolean;
-}
-interface SearchCharacterOptions {
-    query?: string;
-    sort?: CharacterSort[];
-    page?: number;
-    perPage?: number;
-    /** Include voice actors for each media the character appears in. */
-    voiceActors?: boolean;
-}
-
-declare enum MediaListStatus {
-    CURRENT = "CURRENT",
-    PLANNING = "PLANNING",
-    COMPLETED = "COMPLETED",
-    DROPPED = "DROPPED",
-    PAUSED = "PAUSED",
-    REPEATING = "REPEATING"
-}
-declare enum MediaListSort {
-    MEDIA_ID = "MEDIA_ID",
-    MEDIA_ID_DESC = "MEDIA_ID_DESC",
-    SCORE = "SCORE",
-    SCORE_DESC = "SCORE_DESC",
-    STATUS = "STATUS",
-    STATUS_DESC = "STATUS_DESC",
-    PROGRESS = "PROGRESS",
-    PROGRESS_DESC = "PROGRESS_DESC",
-    PROGRESS_VOLUMES = "PROGRESS_VOLUMES",
-    PROGRESS_VOLUMES_DESC = "PROGRESS_VOLUMES_DESC",
-    REPEAT = "REPEAT",
-    REPEAT_DESC = "REPEAT_DESC",
-    PRIORITY = "PRIORITY",
-    PRIORITY_DESC = "PRIORITY_DESC",
-    STARTED_ON = "STARTED_ON",
-    STARTED_ON_DESC = "STARTED_ON_DESC",
-    FINISHED_ON = "FINISHED_ON",
-    FINISHED_ON_DESC = "FINISHED_ON_DESC",
-    ADDED_TIME = "ADDED_TIME",
-    ADDED_TIME_DESC = "ADDED_TIME_DESC",
-    UPDATED_TIME = "UPDATED_TIME",
-    UPDATED_TIME_DESC = "UPDATED_TIME_DESC",
-    MEDIA_TITLE_ROMAJI = "MEDIA_TITLE_ROMAJI",
-    MEDIA_TITLE_ROMAJI_DESC = "MEDIA_TITLE_ROMAJI_DESC",
-    MEDIA_TITLE_ENGLISH = "MEDIA_TITLE_ENGLISH",
-    MEDIA_TITLE_ENGLISH_DESC = "MEDIA_TITLE_ENGLISH_DESC",
-    MEDIA_TITLE_NATIVE = "MEDIA_TITLE_NATIVE",
-    MEDIA_TITLE_NATIVE_DESC = "MEDIA_TITLE_NATIVE_DESC",
-    MEDIA_POPULARITY = "MEDIA_POPULARITY",
-    MEDIA_POPULARITY_DESC = "MEDIA_POPULARITY_DESC"
-}
-interface MediaListEntry {
-    id: number;
-    mediaId: number;
-    status: MediaListStatus;
-    score: number | null;
-    progress: number | null;
-    progressVolumes: number | null;
-    repeat: number | null;
-    priority: number | null;
-    private: boolean | null;
-    notes: string | null;
-    startedAt: FuzzyDate | null;
-    completedAt: FuzzyDate | null;
-    updatedAt: number | null;
-    createdAt: number | null;
-    media: Media;
-}
-interface GetUserMediaListOptions {
-    /** User ID (provide either userId or userName) */
-    userId?: number;
-    /** Username (provide either userId or userName) */
-    userName?: string;
-    /** ANIME or MANGA */
-    type: MediaType;
-    /** Filter by list status (CURRENT, COMPLETED, etc.) */
-    status?: MediaListStatus;
-    /** Sort order */
-    sort?: MediaListSort[];
-    page?: number;
-    perPage?: number;
-}
-
 interface Studio {
     id: number;
     name: string;
@@ -644,6 +583,7 @@ interface MediaTag {
     description: string | null;
     category: string | null;
     rank: number | null;
+    isAdult: boolean | null;
     isMediaSpoiler: boolean | null;
 }
 declare enum MediaRelationType {
@@ -885,57 +825,118 @@ interface AiringSchedule {
 type DayOfWeek = "Monday" | "Tuesday" | "Wednesday" | "Thursday" | "Friday" | "Saturday" | "Sunday";
 type WeeklySchedule = Record<DayOfWeek, AiringSchedule[]>;
 
-/** Represents a forum thread on AniList. */
-interface Thread {
-    id: number;
-    title: string;
-    body: string | null;
-    userId: number;
-    replyUserId: number | null;
-    replyCommentId: number | null;
-    replyCount: number;
-    viewCount: number;
-    isLocked: boolean;
-    isSticky: boolean;
-    isSubscribed: boolean;
-    repliedAt: number | null;
-    createdAt: number;
-    updatedAt: number;
-    siteUrl: string | null;
-    user: {
-        id: number;
-        name: string;
-        avatar: UserAvatar;
-    } | null;
-    replyUser: {
-        id: number;
-        name: string;
-        avatar: UserAvatar;
-    } | null;
-    categories: ThreadCategory[] | null;
-    mediaCategories: ThreadMediaCategory[] | null;
-    likes: {
-        id: number;
-        name: string;
-    }[] | null;
-}
-interface ThreadCategory {
-    id: number;
-    name: string;
-}
-interface ThreadMediaCategory {
-    id: number;
-    title: MediaTitle;
-    type: MediaType;
-    coverImage: Pick<MediaCoverImage, "large" | "medium"> | null;
-    siteUrl: string | null;
-}
-/** Sort options for thread queries. */
-declare enum ThreadSort {
+declare enum CharacterSort {
     ID = "ID",
     ID_DESC = "ID_DESC",
-    TITLE = "TITLE",
-    TITLE_DESC = "TITLE_DESC",
+    ROLE = "ROLE",
+    ROLE_DESC = "ROLE_DESC",
+    SEARCH_MATCH = "SEARCH_MATCH",
+    FAVOURITES = "FAVOURITES",
+    FAVOURITES_DESC = "FAVOURITES_DESC"
+}
+declare enum CharacterRole {
+    MAIN = "MAIN",
+    SUPPORTING = "SUPPORTING",
+    BACKGROUND = "BACKGROUND"
+}
+interface CharacterName {
+    first: string | null;
+    middle: string | null;
+    last: string | null;
+    full: string | null;
+    native: string | null;
+    alternative: string[];
+}
+interface CharacterImage {
+    large: string | null;
+    medium: string | null;
+}
+type CharacterMediaNode = Pick<Media, "id" | "title" | "type" | "coverImage" | "siteUrl">;
+interface CharacterMediaEdge {
+    node: CharacterMediaNode;
+    voiceActors?: VoiceActor[];
+}
+interface Character {
+    id: number;
+    name: CharacterName;
+    image: CharacterImage;
+    description: string | null;
+    gender: string | null;
+    dateOfBirth: FuzzyDate | null;
+    age: string | null;
+    bloodType: string | null;
+    favourites: number | null;
+    siteUrl: string | null;
+    media: {
+        nodes?: CharacterMediaNode[];
+        edges?: CharacterMediaEdge[];
+    } | null;
+}
+/** Options for including extra data when fetching a character. */
+interface CharacterIncludeOptions {
+    /** Include voice actors for each media the character appears in. */
+    voiceActors?: boolean;
+}
+interface SearchCharacterOptions {
+    query?: string;
+    sort?: CharacterSort[];
+    page?: number;
+    perPage?: number;
+    /** Include voice actors for each media the character appears in. */
+    voiceActors?: boolean;
+}
+
+/** Represents a forum thread on AniList. */
+interface Thread {
+    id: number;
+    title: string;
+    body: string | null;
+    userId: number;
+    replyUserId: number | null;
+    replyCommentId: number | null;
+    replyCount: number;
+    viewCount: number;
+    isLocked: boolean;
+    isSticky: boolean;
+    isSubscribed: boolean;
+    repliedAt: number | null;
+    createdAt: number;
+    updatedAt: number;
+    siteUrl: string | null;
+    user: {
+        id: number;
+        name: string;
+        avatar: UserAvatar;
+    } | null;
+    replyUser: {
+        id: number;
+        name: string;
+        avatar: UserAvatar;
+    } | null;
+    categories: ThreadCategory[] | null;
+    mediaCategories: ThreadMediaCategory[] | null;
+    likes: {
+        id: number;
+        name: string;
+    }[] | null;
+}
+interface ThreadCategory {
+    id: number;
+    name: string;
+}
+interface ThreadMediaCategory {
+    id: number;
+    title: MediaTitle;
+    type: MediaType;
+    coverImage: Pick<MediaCoverImage, "large" | "medium"> | null;
+    siteUrl: string | null;
+}
+/** Sort options for thread queries. */
+declare enum ThreadSort {
+    ID = "ID",
+    ID_DESC = "ID_DESC",
+    TITLE = "TITLE",
+    TITLE_DESC = "TITLE_DESC",
     CREATED_AT = "CREATED_AT",
     CREATED_AT_DESC = "CREATED_AT_DESC",
     UPDATED_AT = "UPDATED_AT",
@@ -965,6 +966,145 @@ interface SearchThreadOptions {
     perPage?: number;
 }
 
+/** Cache performance statistics. */
+interface CacheStats {
+    /** Total cache hits. */
+    hits: number;
+    /** Total cache misses. */
+    misses: number;
+    /** Stale entries returned (only with stale-while-revalidate). */
+    stales: number;
+    /** Hit rate as a ratio 0–1 (NaN if no requests yet). */
+    hitRate: number;
+}
+declare class MemoryCache implements CacheAdapter {
+    private readonly ttl;
+    private readonly maxSize;
+    private readonly enabled;
+    private readonly swrMs;
+    private readonly store;
+    private _hits;
+    private _misses;
+    private _stales;
+    constructor(options?: CacheOptions);
+    /** Build a deterministic cache key from a query + variables pair. */
+    static key(query: string, variables: Record<string, unknown>): string;
+    /**
+     * Retrieve a cached value, or `undefined` if missing / expired.
+     * With stale-while-revalidate enabled, returns stale data within the grace window
+     * and flags it so the caller can refresh in the background.
+     */
+    get<T>(key: string): T | undefined;
+    /** Store a value in the cache. */
+    set<T>(key: string, data: T): void;
+    /** Remove a specific entry. */
+    delete(key: string): boolean;
+    /** Clear the entire cache and reset statistics. */
+    clear(): void;
+    /** Number of entries currently stored. */
+    get size(): number | Promise<number>;
+    /** Return all cache keys. */
+    keys(): string[];
+    /**
+     * Get cache performance statistics.
+     *
+     * @example
+     * ```ts
+     * const cache = new MemoryCache();
+     * // ... after some usage ...
+     * console.log(cache.stats);
+     * // { hits: 42, misses: 8, stales: 0, hitRate: 0.84 }
+     * ```
+     */
+    get stats(): CacheStats;
+    /** Reset cache statistics without clearing stored data. */
+    resetStats(): void;
+    /**
+     * 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.
+     */
+    invalidate(pattern: string | RegExp): number;
+}
+
+/**
+ * Minimal interface representing a Redis client.
+ * Compatible with both `ioredis` and `redis` (node-redis v4+).
+ */
+interface RedisLikeClient {
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, ...args: unknown[]): Promise<unknown>;
+    del(...keys: (string | string[])[]): Promise<number>;
+    keys(pattern: string): Promise<string[]>;
+    /** Optional SCAN-based iteration — used when available to avoid blocking the server. */
+    scanIterator?(options: {
+        MATCH: string;
+        COUNT?: number;
+    }): AsyncIterable<string>;
+}
+interface RedisCacheOptions {
+    /** A Redis client instance (ioredis or node-redis). */
+    client: RedisLikeClient;
+    /** Key prefix to namespace ani-client entries (default: `"ani:"`) */
+    prefix?: string;
+    /** TTL in seconds (default: 86 400 = 24 h) */
+    ttl?: number;
+}
+/**
+ * Redis-backed cache adapter for AniListClient.
+ *
+ * @example
+ * ```ts
+ * import Redis from "ioredis";
+ * import { AniListClient, RedisCache } from "ani-client";
+ *
+ * const redis = new Redis();
+ * const client = new AniListClient({
+ *   cacheAdapter: new RedisCache({ client: redis }),
+ * });
+ * ```
+ */
+declare class RedisCache implements CacheAdapter {
+    private readonly client;
+    private readonly prefix;
+    private readonly ttl;
+    constructor(options: RedisCacheOptions);
+    private prefixedKey;
+    get<T>(key: string): Promise<T | undefined>;
+    set<T>(key: string, data: T): Promise<void>;
+    delete(key: string): Promise<boolean>;
+    /**
+     * 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
+     */
+    private collectKeys;
+    clear(): Promise<void>;
+    /**
+     * Get the actual number of keys with this prefix in Redis.
+     */
+    get size(): Promise<number>;
+    /** @internal */
+    private getSize;
+    keys(): Promise<string[]>;
+    /**
+     * 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.
+     */
+    invalidate(pattern: string | RegExp): Promise<number>;
+}
+
 /**
  * Lightweight AniList GraphQL client with built-in caching and rate limiting.
  *
@@ -1167,142 +1307,6 @@ declare class AniListError extends Error {
     constructor(message: string, status: number, errors?: unknown[]);
 }
 
-/** Cache performance statistics. */
-interface CacheStats {
-    /** Total cache hits. */
-    hits: number;
-    /** Total cache misses. */
-    misses: number;
-    /** Stale entries returned (only with stale-while-revalidate). */
-    stales: number;
-    /** Hit rate as a ratio 0–1 (NaN if no requests yet). */
-    hitRate: number;
-}
-declare class MemoryCache implements CacheAdapter {
-    private readonly ttl;
-    private readonly maxSize;
-    private readonly enabled;
-    private readonly swrMs;
-    private readonly store;
-    private _hits;
-    private _misses;
-    private _stales;
-    constructor(options?: CacheOptions);
-    /** Build a deterministic cache key from a query + variables pair. */
-    static key(query: string, variables: Record<string, unknown>): string;
-    /**
-     * Retrieve a cached value, or `undefined` if missing / expired.
-     * With stale-while-revalidate enabled, returns stale data within the grace window
-     * and flags it so the caller can refresh in the background.
-     */
-    get<T>(key: string): T | undefined;
-    /** Store a value in the cache. */
-    set<T>(key: string, data: T): void;
-    /** Remove a specific entry. */
-    delete(key: string): boolean;
-    /** Clear the entire cache and reset statistics. */
-    clear(): void;
-    /** Number of entries currently stored. */
-    get size(): number | Promise<number>;
-    /** Return all cache keys. */
-    keys(): string[];
-    /**
-     * Get cache performance statistics.
-     *
-     * @example
-     * ```ts
-     * const cache = new MemoryCache();
-     * // ... after some usage ...
-     * console.log(cache.stats);
-     * // { hits: 42, misses: 8, stales: 0, hitRate: 0.84 }
-     * ```
-     */
-    get stats(): CacheStats;
-    /** Reset cache statistics without clearing stored data. */
-    resetStats(): void;
-    /**
-     * 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.
-     */
-    invalidate(pattern: string | RegExp): number;
-}
-
-/**
- * Minimal interface representing a Redis client.
- * Compatible with both `ioredis` and `redis` (node-redis v4+).
- */
-interface RedisLikeClient {
-    get(key: string): Promise<string | null>;
-    set(key: string, value: string, ...args: unknown[]): Promise<unknown>;
-    del(...keys: (string | string[])[]): Promise<number>;
-    keys(pattern: string): Promise<string[]>;
-    /** Optional SCAN-based iteration — used when available to avoid blocking the server. */
-    scanIterator?(options: {
-        MATCH: string;
-        COUNT?: number;
-    }): AsyncIterable<string>;
-}
-interface RedisCacheOptions {
-    /** A Redis client instance (ioredis or node-redis). */
-    client: RedisLikeClient;
-    /** Key prefix to namespace ani-client entries (default: `"ani:"`) */
-    prefix?: string;
-    /** TTL in seconds (default: 86 400 = 24 h) */
-    ttl?: number;
-}
-/**
- * Redis-backed cache adapter for AniListClient.
- *
- * @example
- * ```ts
- * import Redis from "ioredis";
- * import { AniListClient, RedisCache } from "ani-client";
- *
- * const redis = new Redis();
- * const client = new AniListClient({
- *   cacheAdapter: new RedisCache({ client: redis }),
- * });
- * ```
- */
-declare class RedisCache implements CacheAdapter {
-    private readonly client;
-    private readonly prefix;
-    private readonly ttl;
-    constructor(options: RedisCacheOptions);
-    private prefixedKey;
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, data: T): Promise<void>;
-    delete(key: string): Promise<boolean>;
-    /**
-     * 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
-     */
-    private collectKeys;
-    clear(): Promise<void>;
-    /**
-     * Get the actual number of keys with this prefix in Redis.
-     */
-    get size(): Promise<number>;
-    /** @internal */
-    private getSize;
-    keys(): Promise<string[]>;
-    /**
-     * Remove all entries whose key matches the given glob pattern.
-     *
-     * @param pattern — A glob pattern (e.g. `"*Media*"`)
-     * @returns Number of entries removed.
-     */
-    invalidate(pattern: string | RegExp): Promise<number>;
-}
-
 /**
  * Rate limiter with automatic retry for AniList API.
  *