ani-client 1.4.1 → 1.4.3

package/README.md

@@ -6,6 +6,8 @@
 
 > A simple, typed client to fetch anime, manga, character, staff and user data from [AniList](https://anilist.co).
 
+✨ **Showcase**: [Check here](SHOWCASE.md) to see which projects use this package!
+
 - **Zero dependencies** — uses the native `fetch` API
 - **Universal** — Node.js ≥ 20, Bun, Deno and modern browsers
 - **Dual format** — ships ESM + CJS with full TypeScript declarations
@@ -265,12 +267,21 @@ const result = await client.searchCharacters({ query: "Luffy", voiceActors: true
 
 | Method | Description |
 | --- | --- |
-| `getStaff(id)` | Fetch a staff member by ID |
+| `getStaff(id, include?)` | Fetch a staff member by ID (optionally with media) |
 | `searchStaff(options?)` | Search for staff members |
 
 ```ts
 const staff = await client.getStaff(95001);
 const results = await client.searchStaff({ query: "Miyazaki" });
+
+// With media the staff member worked on
+const staffWithMedia = await client.getStaff(95001, { media: true });
+staffWithMedia.staffMedia?.nodes.forEach((m) => {
+  console.log(m.title.romaji, m.format, m.averageScore);
+});
+
+// Customize the number of media returned
+const staffWith5Media = await client.getStaff(95001, { media: { perPage: 5 } });
 ```
 
 ### Users
@@ -470,7 +481,7 @@ class MyCache implements CacheAdapter {
   set<T>(key: string, data: T): void | Promise<void> { /* ... */ }
   delete(key: string): boolean | Promise<boolean> { /* ... */ }
   clear(): void | Promise<void> { /* ... */ }
-  get size(): number { return -1; } // return -1 if unknown
+  get size(): number | Promise<number> { return -1; } // return -1 if unknown
   keys(): string[] | Promise<string[]> { /* ... */ }
   // Optional — the client provides a fallback if omitted
   invalidate?(pattern: string | RegExp): number | Promise<number> { /* ... */ }
@@ -566,6 +577,7 @@ import type {
   MediaEdge, MediaConnection, MediaCharacterEdge, MediaCharacterConnection,
   CharacterMediaEdge, CharacterIncludeOptions,
   MediaStaffEdge, MediaStaffConnection, MediaIncludeOptions,
+  StaffMediaNode, StaffIncludeOptions,
   StreamingEpisode, ExternalLink, MediaStats, MediaRecommendationNode,
   PageInfo, PagedResult,
   CacheAdapter, AniListHooks, AniListClientOptions,