kaizoku-core 0.1.0

package/dist/providers/meta/anilist/queries.js

@@ -0,0 +1,405 @@
+// ─── Shared Field Fragments ─────────────────────────────────────
+// AniList doesn't support native GraphQL fragments via its endpoint
+// so we use template strings to keep things DRY.
+/** Fields selected for cards, carousels, and list items */
+export const MEDIA_CARD_FIELDS = `
+  id
+  idMal
+  title {
+    romaji
+    english
+    native
+    userPreferred
+  }
+  coverImage {
+    extraLarge
+    large
+    medium
+    color
+  }
+  bannerImage
+  format
+  type
+  status
+  episodes
+  duration
+  season
+  seasonYear
+  averageScore
+  meanScore
+  popularity
+  favourites
+  trending
+  genres
+  description(asHtml: false)
+  trailer {
+    id
+    site
+    thumbnail
+  }
+  startDate {
+    year
+    month
+    day
+  }
+  endDate {
+    year
+    month
+    day
+  }
+  source
+  countryOfOrigin
+  isAdult
+  studios(isMain: true) {
+    nodes {
+      id
+      name
+      isAnimationStudio
+      siteUrl
+    }
+  }
+  nextAiringEpisode {
+    id
+    airingAt
+    timeUntilAiring
+    episode
+  }
+`;
+/** Extra fields only needed on the detail page */
+const MEDIA_DETAIL_EXTRA = `
+  synonyms
+  hashtag
+  siteUrl
+  characters(sort: [ROLE, RELEVANCE, ID], perPage: 25) {
+    edges {
+      id
+      role
+      node {
+        id
+        name {
+          full
+          native
+          first
+          last
+        }
+        image {
+          large
+          medium
+        }
+      }
+      voiceActors(language: JAPANESE) {
+        id
+        name {
+          full
+          native
+          first
+          last
+        }
+        image {
+          large
+          medium
+        }
+        languageV2
+      }
+    }
+  }
+  staff(sort: RELEVANCE, perPage: 25) {
+    edges {
+      id
+      role
+      node {
+        id
+        name {
+          full
+          native
+        }
+        image {
+          large
+          medium
+        }
+        primaryOccupations
+      }
+    }
+  }
+  streamingEpisodes {
+    title
+    thumbnail
+    url
+    site
+  }
+  externalLinks {
+    id
+    url
+    site
+    type
+    icon
+    color
+  }
+  relations {
+    edges {
+      id
+      relationType(version: 2)
+      node {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+  recommendations(sort: RATING_DESC, perPage: 10) {
+    nodes {
+      id
+      rating
+      mediaRecommendation {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+// ─── Page Queries (lists) ───────────────────────────────────────
+/** Trending right now — sorted by trending score descending */
+export const TRENDING_QUERY = `
+  query TrendingAnime($page: Int, $perPage: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      media(sort: TRENDING_DESC, type: ANIME, isAdult: false) {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+/** Popular this season */
+export const POPULAR_THIS_SEASON_QUERY = `
+  query PopularThisSeason($page: Int, $perPage: Int, $season: MediaSeason, $seasonYear: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      media(
+        sort: POPULARITY_DESC
+        type: ANIME
+        season: $season
+        seasonYear: $seasonYear
+        isAdult: false
+      ) {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+/** Top upcoming — next season, sorted by popularity */
+export const UPCOMING_QUERY = `
+  query UpcomingAnime($page: Int, $perPage: Int, $season: MediaSeason, $seasonYear: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      media(
+        sort: POPULARITY_DESC
+        type: ANIME
+        season: $season
+        seasonYear: $seasonYear
+        status: NOT_YET_RELEASED
+        isAdult: false
+      ) {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+/** All-time most popular */
+export const ALL_TIME_POPULAR_QUERY = `
+  query AllTimePopular($page: Int, $perPage: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      media(sort: POPULARITY_DESC, type: ANIME, isAdult: false) {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+/** All-time most favorited */
+export const ALL_TIME_FAVORITE_QUERY = `
+  query AllTimeFavorite($page: Int, $perPage: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      media(sort: FAVOURITES_DESC, type: ANIME, isAdult: false) {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+/** Top rated of all time */
+export const TOP_RATED_QUERY = `
+  query TopRated($page: Int, $perPage: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      media(sort: SCORE_DESC, type: ANIME, isAdult: false) {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+/** Currently airing — releasing right now */
+export const CURRENTLY_AIRING_QUERY = `
+  query CurrentlyAiring($page: Int, $perPage: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      media(sort: POPULARITY_DESC, type: ANIME, status: RELEASING, isAdult: false) {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+// ─── Search Query ───────────────────────────────────────────────
+export const SEARCH_QUERY = `
+  query SearchAnime(
+    $page: Int
+    $perPage: Int
+    $search: String
+    $sort: [MediaSort]
+    $genre_in: [String]
+    $tag_in: [String]
+    $season: MediaSeason
+    $seasonYear: Int
+    $format: MediaFormat
+    $status: MediaStatus
+    $countryOfOrigin: CountryCode
+    $source: MediaSource
+  ) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      media(
+        search: $search
+        sort: $sort
+        type: ANIME
+        genre_in: $genre_in
+        tag_in: $tag_in
+        season: $season
+        seasonYear: $seasonYear
+        format: $format
+        status: $status
+        countryOfOrigin: $countryOfOrigin
+        source: $source
+        isAdult: false
+      ) {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+// ─── Detail Query (single anime) ───────────────────────────────
+export const MEDIA_DETAIL_QUERY = `
+  query MediaDetail($id: Int) {
+    Media(id: $id, type: ANIME) {
+      ${MEDIA_CARD_FIELDS}
+      ${MEDIA_DETAIL_EXTRA}
+    }
+  }
+`;
+// ─── Hero / Featured Query ──────────────────────────────────────
+// Specifically for the hero carousel — we want trending anime
+// that have trailers and banner images for a cinematic look.
+export const HERO_QUERY = `
+  query HeroAnime($page: Int, $perPage: Int) {
+    Page(page: $page, perPage: $perPage) {
+      pageInfo {
+        total
+        currentPage
+        lastPage
+        hasNextPage
+        perPage
+      }
+      media(sort: TRENDING_DESC, type: ANIME, isAdult: false) {
+        ${MEDIA_CARD_FIELDS}
+      }
+    }
+  }
+`;
+// ─── Genre Collection Query ─────────────────────────────────────
+export const GENRE_COLLECTION_QUERY = `
+  query GenreCollection {
+    GenreCollection
+  }
+`;
+export const TAG_COLLECTION_QUERY = `
+  query TagCollection {
+    MediaTagCollection {
+      name
+    }
+  }
+`;
+export const SETTINGS_ASSETS_QUERY = `
+  query SettingsAssets {
+    banners: Page(perPage: 20) {
+      media(sort: POPULARITY_DESC, type: ANIME, isAdult: false) {
+        id
+        bannerImage
+      }
+    }
+    avatars: Page(perPage: 10) {
+      media(sort: POPULARITY_DESC, type: ANIME, isAdult: false) {
+        id
+        title {
+          romaji
+          english
+        }
+        characters(sort: FAVOURITES_DESC, perPage: 5) {
+          edges {
+            node {
+              id
+              name {
+                full
+              }
+              image {
+                large
+              }
+            }
+          }
+        }
+      }
+    }
+  }
+`;

package/dist/providers/meta/anilist/types.d.ts

@@ -0,0 +1,213 @@
+export type MediaType = "ANIME" | "MANGA";
+export type MediaFormat = "TV" | "TV_SHORT" | "MOVIE" | "SPECIAL" | "OVA" | "ONA" | "MUSIC";
+export type MediaStatus = "FINISHED" | "RELEASING" | "NOT_YET_RELEASED" | "CANCELLED" | "HIATUS";
+export type MediaSeason = "WINTER" | "SPRING" | "SUMMER" | "FALL";
+export type MediaSource = "ORIGINAL" | "MANGA" | "LIGHT_NOVEL" | "VISUAL_NOVEL" | "VIDEO_GAME" | "OTHER" | "NOVEL" | "DOUJINSHI" | "ANIME" | "WEB_NOVEL" | "LIVE_ACTION" | "GAME" | "COMIC" | "MULTIMEDIA_PROJECT" | "PICTURE_BOOK";
+export type MediaRelation = "ADAPTATION" | "PREQUEL" | "SEQUEL" | "PARENT" | "SIDE_STORY" | "CHARACTER" | "SUMMARY" | "ALTERNATIVE" | "SPIN_OFF" | "OTHER" | "SOURCE" | "COMPILATION" | "CONTAINS";
+export type CharacterRole = "MAIN" | "SUPPORTING" | "BACKGROUND";
+export type MediaSort = "ID" | "TITLE_ROMAJI" | "TITLE_ENGLISH" | "TITLE_NATIVE" | "TYPE" | "FORMAT" | "START_DATE" | "END_DATE" | "SCORE" | "POPULARITY" | "TRENDING" | "EPISODES" | "DURATION" | "STATUS" | "FAVOURITES" | "ID_DESC" | "TITLE_ROMAJI_DESC" | "TITLE_ENGLISH_DESC" | "TITLE_NATIVE_DESC" | "TYPE_DESC" | "FORMAT_DESC" | "START_DATE_DESC" | "END_DATE_DESC" | "SCORE_DESC" | "POPULARITY_DESC" | "TRENDING_DESC" | "EPISODES_DESC" | "DURATION_DESC" | "STATUS_DESC" | "FAVOURITES_DESC";
+export interface MediaTitle {
+    romaji: string | null;
+    english: string | null;
+    native: string | null;
+    userPreferred: string | null;
+}
+export interface MediaCoverImage {
+    extraLarge: string | null;
+    large: string | null;
+    medium: string | null;
+    color: string | null;
+}
+export interface FuzzyDate {
+    year: number | null;
+    month: number | null;
+    day: number | null;
+}
+export interface MediaTrailer {
+    /** Video ID on the platform (e.g. YouTube video ID) */
+    id: string | null;
+    /** Platform name — typically "youtube" or "dailymotion" */
+    site: string | null;
+    /** Thumbnail URL for the trailer */
+    thumbnail: string | null;
+}
+export interface Studio {
+    id: number;
+    name: string;
+    isAnimationStudio: boolean;
+    siteUrl: string | null;
+}
+export interface StudioConnection {
+    nodes: Studio[];
+}
+export interface CharacterName {
+    full: string | null;
+    native: string | null;
+    first: string | null;
+    last: string | null;
+}
+export interface CharacterImage {
+    large: string | null;
+    medium: string | null;
+}
+export interface Character {
+    id: number;
+    name: CharacterName;
+    image: CharacterImage;
+}
+export interface VoiceActor {
+    id: number;
+    name: CharacterName;
+    image: CharacterImage;
+    languageV2: string | null;
+}
+export interface CharacterEdge {
+    id: number;
+    role: CharacterRole;
+    node: Character;
+    voiceActors: VoiceActor[];
+}
+export interface CharacterConnection {
+    edges: CharacterEdge[];
+}
+export interface StaffName {
+    full: string | null;
+    native: string | null;
+}
+export interface StaffImage {
+    large: string | null;
+    medium: string | null;
+}
+export interface Staff {
+    id: number;
+    name: StaffName;
+    image: StaffImage;
+    primaryOccupations: string[];
+}
+export interface StaffEdge {
+    id: number;
+    role: string;
+    node: Staff;
+}
+export interface StaffConnection {
+    edges: StaffEdge[];
+}
+export interface StreamingEpisode {
+    title: string | null;
+    thumbnail: string | null;
+    url: string | null;
+    site: string | null;
+}
+export interface ExternalLink {
+    id: number;
+    url: string | null;
+    site: string;
+    type: string | null;
+    icon: string | null;
+    color: string | null;
+}
+export interface MediaRelationEdge {
+    id: number;
+    relationType: MediaRelation;
+    node: MediaBase;
+}
+export interface MediaRelationConnection {
+    edges: MediaRelationEdge[];
+}
+export interface RecommendationNode {
+    id: number;
+    rating: number;
+    mediaRecommendation: MediaBase | null;
+}
+export interface RecommendationConnection {
+    nodes: RecommendationNode[];
+}
+export interface AiringSchedule {
+    id: number;
+    airingAt: number;
+    timeUntilAiring: number;
+    episode: number;
+}
+export interface AiringScheduleConnection {
+    nodes: AiringSchedule[];
+}
+/** Lightweight media used in lists / cards / carousels */
+export interface MediaBase {
+    id: number;
+    idMal: number | null;
+    title: MediaTitle;
+    coverImage: MediaCoverImage;
+    bannerImage: string | null;
+    format: MediaFormat | null;
+    type: MediaType | null;
+    status: MediaStatus | null;
+    episodes: number | null;
+    duration: number | null;
+    season: MediaSeason | null;
+    seasonYear: number | null;
+    averageScore: number | null;
+    meanScore: number | null;
+    popularity: number | null;
+    favourites: number | null;
+    trending: number | null;
+    genres: string[];
+    description: string | null;
+    trailer: MediaTrailer | null;
+    startDate: FuzzyDate | null;
+    endDate: FuzzyDate | null;
+    source: MediaSource | null;
+    countryOfOrigin: string | null;
+    isAdult: boolean;
+    studios: StudioConnection | null;
+    nextAiringEpisode: AiringSchedule | null;
+}
+/** Full media detail includes characters, staff, relations, etc. */
+export interface MediaDetail extends MediaBase {
+    synonyms: string[];
+    hashtag: string | null;
+    siteUrl: string | null;
+    characters: CharacterConnection | null;
+    staff: StaffConnection | null;
+    streamingEpisodes: StreamingEpisode[];
+    externalLinks: ExternalLink[];
+    relations: MediaRelationConnection | null;
+    recommendations: RecommendationConnection | null;
+}
+export interface SearchFilters {
+    search?: string;
+    sort?: MediaSort[];
+    genres?: string[];
+    tags?: string[];
+    season?: MediaSeason;
+    seasonYear?: number;
+    format?: MediaFormat;
+    status?: MediaStatus;
+    countryOfOrigin?: string;
+    source?: MediaSource | string;
+    page?: number;
+    perPage?: number;
+}
+export interface PageInfo {
+    total: number | null;
+    currentPage: number | null;
+    lastPage: number | null;
+    hasNextPage: boolean;
+    perPage: number | null;
+}
+export interface PagedMedia {
+    pageInfo: PageInfo;
+    media: MediaBase[];
+}
+export interface PageResponse {
+    Page: PagedMedia;
+}
+export interface MediaResponse {
+    Media: MediaDetail;
+}
+/** Returns current anime season based on month */
+export declare function getCurrentSeason(): MediaSeason;
+/** Returns the next anime season and year */
+export declare function getNextSeason(): {
+    season: MediaSeason;
+    year: number;
+};

package/dist/providers/meta/anilist/types.js

@@ -0,0 +1,21 @@
+/** Returns current anime season based on month */
+export function getCurrentSeason() {
+    const month = new Date().getMonth() + 1; // 1-12
+    if (month >= 1 && month <= 3)
+        return "WINTER";
+    if (month >= 4 && month <= 6)
+        return "SPRING";
+    if (month >= 7 && month <= 9)
+        return "SUMMER";
+    return "FALL";
+}
+/** Returns the next anime season and year */
+export function getNextSeason() {
+    const currentSeason = getCurrentSeason();
+    const currentYear = new Date().getFullYear();
+    const order = ["WINTER", "SPRING", "SUMMER", "FALL"];
+    const currentIndex = order.indexOf(currentSeason);
+    const nextIndex = (currentIndex + 1) % 4;
+    const nextYear = nextIndex === 0 ? currentYear + 1 : currentYear;
+    return { season: order[nextIndex], year: nextYear };
+}

package/dist/providers/meta/anilist.d.ts

@@ -0,0 +1,15 @@
+import { AniZipData, Episode, EpisodeSources } from '../../types/types.js';
+/**
+ * The available providers in the meta wrapper.
+ */
+export declare const PROVIDERS: Record<string, any>;
+export declare function getAniZipData(anilistId: string | number): Promise<AniZipData | null>;
+/**
+ * Tries to find the anime on a specific provider by searching its titles.
+ */
+export declare function mapToProvider(anilistId: string | number, providerName: string): Promise<string | null>;
+/**
+ * Fetches episodes from a provider and enriches them with AniZip metadata (titles, images, filler).
+ */
+export declare function fetchEpisodes(anilistId: string | number, providerName: string): Promise<Episode[]>;
+export declare function fetchEpisodeSources(episodeId: string, providerName: string, extraArgs?: any): Promise<EpisodeSources>;