@cyanheads/anime-mcp-server 0.1.1

package/dist/services/anilist/types.d.ts

@@ -0,0 +1,255 @@
+/**
+ * @fileoverview AniList service types — normalized domain types for the AniList GraphQL API.
+ * @module services/anilist/types
+ */
+/** Media type selector. */
+export type MediaType = 'ANIME' | 'MANGA';
+/** AniList season enum. */
+export type MediaSeason = 'WINTER' | 'SPRING' | 'SUMMER' | 'FALL';
+/** AniList format enum. */
+export type MediaFormat = 'TV' | 'TV_SHORT' | 'MOVIE' | 'SPECIAL' | 'OVA' | 'ONA' | 'MUSIC' | 'MANGA' | 'NOVEL' | 'ONE_SHOT';
+/** AniList status enum. */
+export type MediaStatus = 'FINISHED' | 'RELEASING' | 'NOT_YET_RELEASED' | 'CANCELLED' | 'HIATUS';
+/** AniList staff language enum. */
+export type StaffLanguage = 'JAPANESE' | 'ENGLISH' | 'KOREAN' | 'ITALIAN' | 'SPANISH' | 'PORTUGUESE' | 'FRENCH' | 'GERMAN' | 'HEBREW' | 'HUNGARIAN';
+/** Relation type between media entries. */
+export type MediaRelationType = 'ADAPTATION' | 'PREQUEL' | 'SEQUEL' | 'PARENT' | 'SIDE_STORY' | 'CHARACTER' | 'SUMMARY' | 'ALTERNATIVE' | 'SPIN_OFF' | 'OTHER' | 'SOURCE' | 'COMPILATION' | 'CONTAINS';
+/** Character role. */
+export type CharacterRole = 'MAIN' | 'SUPPORTING' | 'BACKGROUND';
+/** A title's localized name variants. */
+export interface MediaTitle {
+    english: string | null;
+    native: string | null;
+    romaji: string | null;
+}
+/** Cover image URLs. */
+export interface CoverImage {
+    color: string | null;
+    extraLarge: string | null;
+    large: string | null;
+    medium: string | null;
+}
+/** A single tag. */
+export interface MediaTag {
+    category: string | null;
+    description: string | null;
+    id: number;
+    isAdult: boolean;
+    isGeneralSpoiler: boolean;
+    name: string;
+    rank: number | null;
+}
+/** A single studio edge. */
+export interface StudioEdge {
+    isMain: boolean;
+    node: {
+        id: number;
+        name: string;
+        isAnimationStudio: boolean;
+    };
+}
+/** An external link (streaming or info). */
+export interface ExternalLink {
+    color: string | null;
+    icon: string | null;
+    id: number;
+    isDisabled: boolean;
+    language: string | null;
+    site: string;
+    siteId: number | null;
+    type: string | null;
+    url: string | null;
+}
+/** A relation edge pointing to another media entry. */
+export interface MediaRelationEdge {
+    node: MediaNode;
+    relationType: MediaRelationType;
+}
+/** A lightweight media node used in relation graphs and recommendations. */
+export interface MediaNode {
+    chapters: number | null;
+    coverImage: CoverImage | null;
+    episodes: number | null;
+    format: MediaFormat | null;
+    id: number;
+    idMal: number | null;
+    isAdult: boolean;
+    meanScore: number | null;
+    season: MediaSeason | null;
+    seasonYear: number | null;
+    status: MediaStatus | null;
+    title: MediaTitle;
+    type: MediaType;
+    volumes: number | null;
+}
+/** Full media detail from AniList. */
+export interface MediaDetail extends MediaNode {
+    averageScore: number | null;
+    bannerImage: string | null;
+    description: string | null;
+    endDate: {
+        year: number | null;
+        month: number | null;
+        day: number | null;
+    } | null;
+    externalLinks: ExternalLink[];
+    favourites: number | null;
+    genres: string[];
+    hashtag: string | null;
+    isAdult: boolean;
+    isFavourite: boolean;
+    nextAiringEpisode: {
+        airingAt: number;
+        episode: number;
+        timeUntilAiring: number;
+    } | null;
+    popularity: number | null;
+    relations: {
+        edges: MediaRelationEdge[];
+    };
+    siteUrl: string | null;
+    source: string | null;
+    startDate: {
+        year: number | null;
+        month: number | null;
+        day: number | null;
+    } | null;
+    studios: {
+        edges: StudioEdge[];
+    };
+    tags: MediaTag[];
+    trailer: {
+        id: string;
+        site: string;
+    } | null;
+}
+/** A page of media search results. */
+export interface MediaPage {
+    media: MediaNode[];
+    pageInfo: {
+        total: number | null;
+        currentPage: number;
+        lastPage: number | null;
+        hasNextPage: boolean;
+        perPage: number | null;
+    };
+}
+/** A character with optional voice actor edges. */
+export interface CharacterEdge {
+    node: {
+        id: number;
+        name: {
+            full: string | null;
+            native: string | null;
+        };
+        image: {
+            large: string | null;
+            medium: string | null;
+        } | null;
+        description: string | null;
+        siteUrl: string | null;
+    };
+    role: CharacterRole;
+    voiceActors: VoiceActor[];
+}
+/** Voice actor (Staff) basic info. */
+export interface VoiceActor {
+    id: number;
+    image: {
+        large: string | null;
+        medium: string | null;
+    } | null;
+    language: StaffLanguage | null;
+    name: {
+        full: string | null;
+        native: string | null;
+    };
+    siteUrl: string | null;
+}
+/** Full staff/VA with media roles. */
+export interface StaffWithRoles {
+    characterMedia: {
+        pageInfo: {
+            hasNextPage: boolean;
+            currentPage: number;
+        };
+        edges: Array<{
+            characterRole: CharacterRole;
+            node: MediaNode;
+            characters: Array<{
+                id: number;
+                name: {
+                    full: string | null;
+                    native: string | null;
+                };
+            }>;
+        }>;
+    };
+    description: string | null;
+    id: number;
+    image: {
+        large: string | null;
+        medium: string | null;
+    } | null;
+    language: StaffLanguage | null;
+    name: {
+        full: string | null;
+        native: string | null;
+    };
+    siteUrl: string | null;
+}
+/** A character with their media appearances. */
+export interface CharacterWithMedia {
+    description: string | null;
+    id: number;
+    image: {
+        large: string | null;
+        medium: string | null;
+    } | null;
+    media: {
+        pageInfo: {
+            hasNextPage: boolean;
+            currentPage: number;
+        };
+        nodes: MediaNode[];
+        edges: Array<{
+            characterRole: CharacterRole;
+            voiceActors: VoiceActor[];
+        }>;
+    };
+    name: {
+        full: string | null;
+        native: string | null;
+    };
+    siteUrl: string | null;
+}
+/** A recommendation node. */
+export interface RecommendationNode {
+    mediaRecommendation: MediaNode | null;
+    rating: number | null;
+}
+/** AniList airing schedule entry. */
+export interface AiringSchedule {
+    airingAt: number;
+    episode: number;
+    id: number;
+    media: MediaNode;
+    timeUntilAiring: number;
+}
+/** Studio full detail. */
+export interface StudioDetail {
+    id: number;
+    isAnimationStudio: boolean;
+    media: {
+        pageInfo: {
+            total: number | null;
+            currentPage: number;
+            lastPage: number | null;
+            hasNextPage: boolean;
+        };
+        nodes: MediaNode[];
+    };
+    name: string;
+    siteUrl: string | null;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/anilist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/anilist/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,2BAA2B;AAC3B,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,OAAO,CAAC;AAE1C,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,MAAM,CAAC;AAElE,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GACnB,IAAI,GACJ,UAAU,GACV,OAAO,GACP,SAAS,GACT,KAAK,GACL,KAAK,GACL,OAAO,GACP,OAAO,GACP,OAAO,GACP,UAAU,CAAC;AAEf,2BAA2B;AAC3B,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,WAAW,GAAG,kBAAkB,GAAG,WAAW,GAAG,QAAQ,CAAC;AAEjG,mCAAmC;AACnC,MAAM,MAAM,aAAa,GACrB,UAAU,GACV,SAAS,GACT,QAAQ,GACR,SAAS,GACT,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,QAAQ,GACR,QAAQ,GACR,WAAW,CAAC;AAEhB,2CAA2C;AAC3C,MAAM,MAAM,iBAAiB,GACzB,YAAY,GACZ,SAAS,GACT,QAAQ,GACR,QAAQ,GACR,YAAY,GACZ,WAAW,GACX,SAAS,GACT,aAAa,GACb,UAAU,GACV,OAAO,GACP,QAAQ,GACR,aAAa,GACb,UAAU,CAAC;AAEf,sBAAsB;AACtB,MAAM,MAAM,aAAa,GAAG,MAAM,GAAG,YAAY,GAAG,YAAY,CAAC;AAEjE,yCAAyC;AACzC,MAAM,WAAW,UAAU;IACzB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,wBAAwB;AACxB,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,oBAAoB;AACpB,MAAM,WAAW,QAAQ;IACvB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,gBAAgB,EAAE,OAAO,CAAC;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;CACrB;AAED,4BAA4B;AAC5B,MAAM,WAAW,UAAU;IACzB,MAAM,EAAE,OAAO,CAAC;IAChB,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,iBAAiB,EAAE,OAAO,CAAC;KAC5B,CAAC;CACH;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,EAAE,EAAE,MAAM,CAAC;IACX,UAAU,EAAE,OAAO,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,SAAS,CAAC;IAChB,YAAY,EAAE,iBAAiB,CAAC;CACjC;AAED,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACxB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,UAAU,EAAE,UAAU,GAAG,IAAI,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,WAAW,GAAG,IAAI,CAAC;IAC3B,KAAK,EAAE,UAAU,CAAC;IAClB,IAAI,EAAE,SAAS,CAAC;IAChB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,WAAY,SAAQ,SAAS;IAC5C,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;IAC5B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAClF,aAAa,EAAE,YAAY,EAAE,CAAC;IAC9B,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,iBAAiB,EAAE;QACjB,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,eAAe,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI,CAAC;IACT,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,SAAS,EAAE;QACT,KAAK,EAAE,iBAAiB,EAAE,CAAC;KAC5B,CAAC;IACF,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,SAAS,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IACpF,OAAO,EAAE;QAAE,KAAK,EAAE,UAAU,EAAE,CAAA;KAAE,CAAC;IACjC,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9C;AAED,sCAAsC;AACtC,MAAM,WAAW,SAAS;IACxB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,QAAQ,EAAE;QACR,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC;QACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;QACxB,WAAW,EAAE,OAAO,CAAC;QACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;CACH;AAED,mDAAmD;AACnD,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM,CAAC;QACX,IAAI,EAAE;YAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,CAAC;QACrD,KAAK,EAAE;YAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;SAAE,GAAG,IAAI,CAAC;QAC9D,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;QAC3B,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;KACxB,CAAC;IACF,IAAI,EAAE,aAAa,CAAC;IACpB,WAAW,EAAE,UAAU,EAAE,CAAC;CAC3B;AAED,sCAAsC;AACtC,MAAM,WAAW,UAAU;IACzB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,sCAAsC;AACtC,MAAM,WAAW,cAAc;IAC7B,cAAc,EAAE;QACd,QAAQ,EAAE;YAAE,WAAW,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QACxD,KAAK,EAAE,KAAK,CAAC;YACX,aAAa,EAAE,aAAa,CAAC;YAC7B,IAAI,EAAE,SAAS,CAAC;YAChB,UAAU,EAAE,KAAK,CAAC;gBAChB,EAAE,EAAE,MAAM,CAAC;gBACX,IAAI,EAAE;oBAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;oBAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;iBAAE,CAAC;aACtD,CAAC,CAAC;SACJ,CAAC,CAAC;KACJ,CAAC;IACF,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,QAAQ,EAAE,aAAa,GAAG,IAAI,CAAC;IAC/B,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,gDAAgD;AAChD,MAAM,WAAW,kBAAkB;IACjC,WAAW,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,GAAG,IAAI,CAAC;IAC9D,KAAK,EAAE;QACL,QAAQ,EAAE;YAAE,WAAW,EAAE,OAAO,CAAC;YAAC,WAAW,EAAE,MAAM,CAAA;SAAE,CAAC;QACxD,KAAK,EAAE,SAAS,EAAE,CAAC;QACnB,KAAK,EAAE,KAAK,CAAC;YACX,aAAa,EAAE,aAAa,CAAC;YAC7B,WAAW,EAAE,UAAU,EAAE,CAAC;SAC3B,CAAC,CAAC;KACJ,CAAC;IACF,IAAI,EAAE;QAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;KAAE,CAAC;IACrD,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB;AAED,6BAA6B;AAC7B,MAAM,WAAW,kBAAkB;IACjC,mBAAmB,EAAE,SAAS,GAAG,IAAI,CAAC;IACtC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;CACvB;AAED,qCAAqC;AACrC,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,SAAS,CAAC;IACjB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,0BAA0B;AAC1B,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,EAAE;QACL,QAAQ,EAAE;YACR,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;YACrB,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;YACxB,WAAW,EAAE,OAAO,CAAC;SACtB,CAAC;QACF,KAAK,EAAE,SAAS,EAAE,CAAC;KACpB,CAAC;IACF,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;CACxB"}

package/dist/services/anilist/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview AniList service types — normalized domain types for the AniList GraphQL API.
+ * @module services/anilist/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/anilist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/anilist/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/services/jikan/jikan-service.d.ts

@@ -0,0 +1,22 @@
+/**
+ * @fileoverview Jikan v4 service — REST client wrapping https://api.jikan.moe/v4 (MyAnimeList proxy).
+ * Media-type-aware: routes to /anime/... or /manga/... based on media_type.
+ * Rate limit: ~3 req/sec; enforces 350ms minimum between calls.
+ * @module services/jikan/jikan-service
+ */
+import type { JikanMedia, JikanPagination, JikanRecommendation, JikanSearchResult } from './types.js';
+/** Get full detail for one anime or manga by MAL ID. Returns null if not found. */
+export declare function getMediaFull(malId: number, mediaType: 'ANIME' | 'MANGA'): Promise<JikanMedia | null>;
+/** Search anime or manga by query. */
+export declare function searchMedia(params: {
+    query: string;
+    mediaType: 'ANIME' | 'MANGA';
+    page?: number;
+    limit?: number;
+}): Promise<{
+    results: JikanSearchResult[];
+    pagination: JikanPagination | null;
+}>;
+/** Get recommendations for an anime or manga by MAL ID. */
+export declare function getRecommendations(malId: number, mediaType: 'ANIME' | 'MANGA'): Promise<JikanRecommendation[]>;
+//# sourceMappingURL=jikan-service.d.ts.map

package/dist/services/jikan/jikan-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jikan-service.d.ts","sourceRoot":"","sources":["../../../src/services/jikan/jikan-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EACV,UAAU,EACV,eAAe,EACf,mBAAmB,EACnB,iBAAiB,EAClB,MAAM,YAAY,CAAC;AA0EpB,mFAAmF;AACnF,wBAAsB,YAAY,CAChC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,GAAG,OAAO,GAC3B,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAI5B;AAED,sCAAsC;AACtC,wBAAsB,WAAW,CAAC,MAAM,EAAE;IACxC,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,OAAO,GAAG,OAAO,CAAC;IAC7B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,iBAAiB,EAAE,CAAC;IAAC,UAAU,EAAE,eAAe,GAAG,IAAI,CAAA;CAAE,CAAC,CAYhF;AAED,2DAA2D;AAC3D,wBAAsB,kBAAkB,CACtC,KAAK,EAAE,MAAM,EACb,SAAS,EAAE,OAAO,GAAG,OAAO,GAC3B,OAAO,CAAC,mBAAmB,EAAE,CAAC,CAIhC"}

package/dist/services/jikan/jikan-service.js

@@ -0,0 +1,89 @@
+/**
+ * @fileoverview Jikan v4 service — REST client wrapping https://api.jikan.moe/v4 (MyAnimeList proxy).
+ * Media-type-aware: routes to /anime/... or /manga/... based on media_type.
+ * Rate limit: ~3 req/sec; enforces 350ms minimum between calls.
+ * @module services/jikan/jikan-service
+ */
+import { serviceUnavailable } from '@cyanheads/mcp-ts-core/errors';
+import { fetchWithTimeout, requestContextService, withRetry } from '@cyanheads/mcp-ts-core/utils';
+// ─── Constants ────────────────────────────────────────────────────────────────
+const JIKAN_BASE = 'https://api.jikan.moe/v4';
+const TIMEOUT_MS = 15_000;
+const REQUEST_CONTEXT = requestContextService.createRequestContext({ operation: 'jikan-service' });
+const MIN_INTERVAL_MS = 350;
+// ─── Rate-limit guard ─────────────────────────────────────────────────────────
+let _lastCallAt = 0;
+async function throttle() {
+    const now = Date.now();
+    const elapsed = now - _lastCallAt;
+    if (elapsed < MIN_INTERVAL_MS) {
+        await new Promise((r) => setTimeout(r, MIN_INTERVAL_MS - elapsed));
+    }
+    _lastCallAt = Date.now();
+}
+// ─── Core fetch ───────────────────────────────────────────────────────────────
+/**
+ * Execute a GET request against Jikan. Returns parsed JSON body or null if not found.
+ * Jikan returns HTTP 5xx for nonexistent MAL IDs (upstream proxy issue) — treat 5xx on
+ * ID lookups as "not found or MAL unavailable" rather than a server error.
+ */
+async function get(path, params) {
+    await throttle();
+    const url = new URL(`${JIKAN_BASE}${path}`);
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    return withRetry(async () => {
+        const resp = await fetchWithTimeout(url.toString(), TIMEOUT_MS, REQUEST_CONTEXT);
+        if (resp.status === 404)
+            return null;
+        // Jikan returns 500 for nonexistent MAL IDs (UpstreamException) — treat as not found
+        if (resp.status >= 500)
+            return null;
+        if (!resp.ok) {
+            throw serviceUnavailable(`Jikan returned HTTP ${resp.status}`, { status: resp.status });
+        }
+        return (await resp.json());
+    }, {
+        maxRetries: 2,
+        baseDelayMs: 1000,
+        maxDelayMs: 5000,
+        operation: 'jikan-get',
+        context: REQUEST_CONTEXT,
+        // Don't retry 5xx — they're "not found" for Jikan
+        isTransient: (e) => {
+            const msg = e instanceof Error ? e.message.toLowerCase() : '';
+            return msg.includes('timeout') || msg.includes('serviceunavailable');
+        },
+    });
+}
+// ─── Service methods ──────────────────────────────────────────────────────────
+/** Get full detail for one anime or manga by MAL ID. Returns null if not found. */
+export async function getMediaFull(malId, mediaType) {
+    const noun = mediaType === 'ANIME' ? 'anime' : 'manga';
+    const result = await get(`/${noun}/${malId}/full`);
+    return result?.data ?? null;
+}
+/** Search anime or manga by query. */
+export async function searchMedia(params) {
+    const noun = params.mediaType === 'ANIME' ? 'anime' : 'manga';
+    const result = await get(`/${noun}`, {
+        q: params.query,
+        page: params.page ?? 1,
+        limit: Math.min(params.limit ?? 20, 25),
+    });
+    return {
+        results: result?.data ?? [],
+        pagination: result?.pagination ?? null,
+    };
+}
+/** Get recommendations for an anime or manga by MAL ID. */
+export async function getRecommendations(malId, mediaType) {
+    const noun = mediaType === 'ANIME' ? 'anime' : 'manga';
+    const result = await get(`/${noun}/${malId}/recommendations`);
+    return result?.data ?? [];
+}
+//# sourceMappingURL=jikan-service.js.map

package/dist/services/jikan/jikan-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jikan-service.js","sourceRoot":"","sources":["../../../src/services/jikan/jikan-service.ts"],"names":[],"mappings":"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"}

package/dist/services/jikan/types.d.ts

@@ -0,0 +1,85 @@
+/**
+ * @fileoverview Jikan v4 service types — normalized domain types for the Jikan REST API (MAL proxy).
+ * @module services/jikan/types
+ */
+/** Jikan anime/manga full detail. */
+export interface JikanMedia {
+    chapters: number | null;
+    episodes: number | null;
+    /** External links */
+    external: Array<{
+        name: string;
+        url: string;
+    }> | null;
+    favorites: number | null;
+    images: {
+        jpg?: {
+            image_url: string | null;
+            small_image_url: string | null;
+            large_image_url: string | null;
+        };
+        webp?: {
+            image_url: string | null;
+            small_image_url: string | null;
+            large_image_url: string | null;
+        };
+    } | null;
+    mal_id: number;
+    popularity: number | null;
+    rank: number | null;
+    score: number | null;
+    scored_by: number | null;
+    status: string | null;
+    /** Streaming sources (anime only) */
+    streaming: Array<{
+        name: string;
+        url: string;
+    }> | null;
+    synopsis: string | null;
+    title: string;
+    title_english: string | null;
+    title_japanese: string | null;
+    type: string | null;
+    url: string | null;
+    volumes: number | null;
+}
+/** A single recommendation entry from Jikan. */
+export interface JikanRecommendation {
+    entry: {
+        mal_id: number;
+        url: string | null;
+        images: {
+            jpg?: {
+                image_url: string | null;
+            };
+        } | null;
+        title: string;
+    };
+    votes: number;
+}
+/** Jikan search result item (lighter than full). */
+export interface JikanSearchResult {
+    chapters: number | null;
+    episodes: number | null;
+    mal_id: number;
+    rank: number | null;
+    score: number | null;
+    scored_by: number | null;
+    status: string | null;
+    title: string;
+    title_english: string | null;
+    type: string | null;
+    url: string | null;
+}
+/** Jikan pagination info. */
+export interface JikanPagination {
+    current_page: number;
+    has_next_page: boolean;
+    items: {
+        count: number;
+        total: number;
+        per_page: number;
+    };
+    last_visible_page: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/jikan/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/jikan/types.ts"],"names":[],"mappings":"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"}

package/dist/services/jikan/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Jikan v4 service types — normalized domain types for the Jikan REST API (MAL proxy).
+ * @module services/jikan/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/jikan/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/jikan/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/services/kitsu/kitsu-service.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @fileoverview Kitsu service — JSON:API client wrapping https://kitsu.io/api/edge.
+ * Provides streaming links (anime only) and MAL ID → Kitsu ID mapping.
+ * Streaming links are anime-only; Kitsu calls are skipped entirely for MANGA.
+ * @module services/kitsu/kitsu-service
+ */
+import type { KitsuStreamingResult } from './types.js';
+/**
+ * Get streaming links for an anime by MAL ID.
+ * Resolves MAL ID → Kitsu ID, then fetches streaming links.
+ * Returns null when Kitsu lookup fails (graceful degradation).
+ */
+export declare function getAnimeStreamingByMalId(malId: number): Promise<KitsuStreamingResult | null>;
+//# sourceMappingURL=kitsu-service.d.ts.map

package/dist/services/kitsu/kitsu-service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"kitsu-service.d.ts","sourceRoot":"","sources":["../../../src/services/kitsu/kitsu-service.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAsB,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAwG3E;;;;GAIG;AACH,wBAAsB,wBAAwB,CAC5C,KAAK,EAAE,MAAM,GACZ,OAAO,CAAC,oBAAoB,GAAG,IAAI,CAAC,CAMtC"}

package/dist/services/kitsu/kitsu-service.js

@@ -0,0 +1,94 @@
+/**
+ * @fileoverview Kitsu service — JSON:API client wrapping https://kitsu.io/api/edge.
+ * Provides streaming links (anime only) and MAL ID → Kitsu ID mapping.
+ * Streaming links are anime-only; Kitsu calls are skipped entirely for MANGA.
+ * @module services/kitsu/kitsu-service
+ */
+import { fetchWithTimeout, requestContextService, withRetry } from '@cyanheads/mcp-ts-core/utils';
+// ─── Constants ────────────────────────────────────────────────────────────────
+const KITSU_BASE = 'https://kitsu.io/api/edge';
+const TIMEOUT_MS = 12_000;
+const REQUEST_CONTEXT = requestContextService.createRequestContext({ operation: 'kitsu-service' });
+// ─── Core fetch ───────────────────────────────────────────────────────────────
+function get(path, params) {
+    const url = new URL(`${KITSU_BASE}${path}`);
+    if (params) {
+        for (const [k, v] of Object.entries(params)) {
+            url.searchParams.set(k, v);
+        }
+    }
+    return withRetry(async () => {
+        const resp = await fetchWithTimeout(url.toString(), TIMEOUT_MS, REQUEST_CONTEXT, {
+            headers: {
+                Accept: 'application/vnd.api+json',
+                'Content-Type': 'application/vnd.api+json',
+            },
+        });
+        if (resp.status === 404)
+            return null;
+        if (!resp.ok)
+            return null; // Degrade gracefully — Kitsu is a supplement
+        return (await resp.json());
+    }, {
+        maxRetries: 2,
+        baseDelayMs: 1000,
+        maxDelayMs: 5000,
+        operation: 'kitsu-get',
+        context: REQUEST_CONTEXT,
+    });
+}
+// ─── Service methods ──────────────────────────────────────────────────────────
+/**
+ * Find Kitsu anime ID by MAL ID using the mappings filter.
+ * Returns null if not found.
+ */
+async function findKitsuAnimeId(malId) {
+    // Kitsu's mappings endpoint with externalSite filter returns mapping records;
+    // the relationships.item data contains the kitsu ID
+    const result = await get('/mappings', {
+        'filter[externalSite]': 'myanimelist/anime',
+        'filter[externalId]': String(malId),
+        include: 'item',
+        'fields[anime]': 'id',
+    });
+    if (!result?.data?.length)
+        return null;
+    const rel = result.data[0]?.relationships?.item?.data;
+    if (rel && rel.type === 'anime')
+        return rel.id;
+    return null;
+}
+/**
+ * Get streaming links for an anime by Kitsu ID.
+ * Returns empty array on failure (supplement service — degrades gracefully).
+ */
+async function getStreamingLinks(kitsuId) {
+    // Guard: Kitsu IDs are numeric strings (e.g. "7442"). Reject anything that would
+    // escape the path segment (traversal, scheme injection) via a malformed API response.
+    if (!/^\d+$/.test(kitsuId))
+        return [];
+    const result = await get(`/anime/${kitsuId}`, { include: 'streamingLinks' });
+    if (!result?.included)
+        return [];
+    return result.included
+        .filter((item) => item.type === 'streamingLinks')
+        .map((item) => ({
+        id: item.id,
+        url: item.attributes.url,
+        subs: item.attributes.subs ?? [],
+        dubs: item.attributes.dubs ?? [],
+    }));
+}
+/**
+ * Get streaming links for an anime by MAL ID.
+ * Resolves MAL ID → Kitsu ID, then fetches streaming links.
+ * Returns null when Kitsu lookup fails (graceful degradation).
+ */
+export async function getAnimeStreamingByMalId(malId) {
+    const kitsuId = await findKitsuAnimeId(malId);
+    if (!kitsuId)
+        return null;
+    const links = await getStreamingLinks(kitsuId);
+    return { kitsuId, streamingLinks: links };
+}
+//# sourceMappingURL=kitsu-service.js.map

package/dist/services/kitsu/kitsu-service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kitsu-service.js","sourceRoot":"","sources":["../../../src/services/kitsu/kitsu-service.ts"],"names":[],"mappings":"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"}

package/dist/services/kitsu/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * @fileoverview Kitsu service types — normalized domain types for the Kitsu JSON:API.
+ * @module services/kitsu/types
+ */
+/** A streaming link from Kitsu's included[] array. */
+export interface KitsuStreamingLink {
+    dubs: string[];
+    id: string;
+    subs: string[];
+    url: string;
+}
+/** Result from resolving Kitsu ID + streaming links. */
+export interface KitsuStreamingResult {
+    kitsuId: string;
+    streamingLinks: KitsuStreamingLink[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/kitsu/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/kitsu/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sDAAsD;AACtD,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;CACb;AAED,wDAAwD;AACxD,MAAM,WAAW,oBAAoB;IACnC,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc,EAAE,kBAAkB,EAAE,CAAC;CACtC"}

package/dist/services/kitsu/types.js

@@ -0,0 +1,6 @@
+/**
+ * @fileoverview Kitsu service types — normalized domain types for the Kitsu JSON:API.
+ * @module services/kitsu/types
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/services/kitsu/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/services/kitsu/types.ts"],"names":[],"mappings":"AAAA;;;GAGG"}