@crysoline/lib 0.1.1

package/dist/core/meta/mymangalist/types.d.ts

@@ -0,0 +1,48 @@
+export interface MMSearchMeta {
+    type: string | null;
+    score: string | null;
+    members: string | null;
+    volumes: string | null;
+}
+export interface MMLink {
+    label: string | null;
+    url: string | null;
+}
+export interface MMLRelation {
+    id: number | null;
+    image: string | null;
+    title: string | null;
+    relationType: string | null;
+}
+export interface MMLCharacter {
+    id: number | null;
+    image: string | null;
+    name: string | null;
+    role: string | null;
+}
+export interface MMLVoiceActor {
+    id: number | null;
+    image: string | null;
+    name: string | null;
+    language: string | null;
+}
+export interface MMLInfoMeta {
+    moreInfo: string | null;
+    score: string | null;
+    rank: string | null;
+    popularity: string | null;
+    members: string | null;
+    type: string | null;
+    volumes: string | null;
+    chapters: string | null;
+    status: string | null;
+    published: string | null;
+    serialization: string | null;
+    genres: string[] | null;
+    themes: string[] | null;
+    authors: string[] | null;
+    favorites: string | null;
+    externalLinks: MMLink[] | null;
+    relations: MMLRelation[] | null;
+    characters: MMLCharacter[] | null;
+}

package/dist/core/meta/mymangalist/types.js

@@ -0,0 +1 @@
+export {};

package/dist/core/types.d.ts

@@ -0,0 +1,101 @@
+export interface Image {
+    aspectRatio: number;
+    small: string;
+    medium: string;
+    large: string;
+}
+export interface Title {
+    english?: string | null | undefined;
+    romaji?: string | null | undefined;
+    japanese?: string | null | undefined;
+    native?: string | null | undefined;
+}
+export interface Chapter<T = unknown> {
+    id?: string | null;
+    title?: string | null;
+    number?: number | null;
+    rating?: number | null;
+    updatedAt?: number | string | null;
+    mixdrop?: string | null;
+    metadata?: T;
+}
+export interface Episode<T = unknown> {
+    id?: number | string | null;
+    title?: string | null;
+    image?: Image | string | null;
+    description?: string | null;
+    number?: number | null;
+    teaserUrl?: string | null;
+    metadata?: T | null;
+    isFiller?: boolean | null;
+    isRecap?: boolean | null;
+}
+export interface Info<T = unknown, E = unknown> {
+    id?: string | number | null;
+    idMal?: string | number | null;
+    idAl?: string | number | null;
+    idMdx?: string | number | null;
+    title?: Title | null;
+    synonyms?: string[] | null;
+    description?: string | null;
+    image?: Image | null;
+    banner?: Image | null;
+    logo?: Image | null;
+    airedEpisodes?: number | null;
+    totalEpisodes?: number | null;
+    metadata?: T | null;
+    episodes?: Partial<E>[] | null;
+}
+export interface Page {
+    url?: string | null;
+    index?: number | null;
+    headers?: Record<string, unknown> | null;
+}
+export interface Search<T = unknown> {
+    id?: number | string | null;
+    title?: Title | null;
+    image?: Image | null;
+    banner?: Image | null;
+    logo?: Image | null;
+    description?: string | null;
+    airedEpisodes?: number | null;
+    totalEpisodes?: number | null;
+    metadata?: T | null;
+}
+export declare enum VideoType {
+    HLS = "hls",
+    DASH = "dash",
+    MP4 = "mp4"
+}
+export interface IntroOutro {
+    start?: number | null;
+    end?: number | null;
+}
+export interface Download {
+    url?: string | null;
+    quality?: string | null;
+}
+export interface VideoSource {
+    url?: string | null;
+    isM3U8?: boolean | null;
+    type?: VideoType | null;
+    quality?: string | null;
+    isDub?: boolean | null;
+}
+export interface Subtitle {
+    id?: string | null;
+    url?: string | null;
+    label?: string | null;
+    srcLang?: string | null;
+}
+export interface Source<T = unknown> {
+    headers?: Record<string, unknown> | null;
+    intro?: IntroOutro | null;
+    outro?: IntroOutro | null;
+    sources: Partial<VideoSource>[];
+    subtitles?: Partial<Subtitle>[] | null;
+    download?: Partial<Download>[] | string | null;
+    chapters?: string | null;
+    thumbnails?: string | null;
+    metadata?: T | null;
+}

package/dist/core/types.js

@@ -0,0 +1,6 @@
+export var VideoType;
+(function (VideoType) {
+    VideoType["HLS"] = "hls";
+    VideoType["DASH"] = "dash";
+    VideoType["MP4"] = "mp4";
+})(VideoType || (VideoType = {}));

package/dist/helpers/fetch.d.ts

@@ -0,0 +1,49 @@
+import type { Chapter, Episode, Info, Page, Search, Source } from '../core/types';
+interface FetchModuleConfig {
+    baseUrl?: string;
+    provider: string;
+    apiKey: string;
+}
+export declare const AnimeFetch: <TSearchMeta = unknown, TInfoMeta = unknown, TEpisodeMeta = unknown, TSourceMeta = unknown>(config: FetchModuleConfig) => {
+    search: (q: string) => Promise<Search<TSearchMeta>[]>;
+    info: (id: string | number) => Promise<Info<TInfoMeta, Episode<TEpisodeMeta>>>;
+    episodes: (id: string | number) => Promise<Episode<TEpisodeMeta>[]>;
+    sources: (params: {
+        id: string | number;
+        episodeId: string | number;
+        subType?: string;
+        server?: string;
+    }) => Promise<Source<TSourceMeta>>;
+};
+export declare const HentaiFetch: <TSearchMeta = unknown, TInfoMeta = unknown, TEpisodeMeta = unknown, TSourceMeta = unknown>(config: FetchModuleConfig) => {
+    search: (q: string) => Promise<Search<TSearchMeta>[]>;
+    info: (id: string | number) => Promise<Info<TInfoMeta, Episode<TEpisodeMeta>>>;
+    episodes: (id: string | number) => Promise<Episode<TEpisodeMeta>[]>;
+    sources: (params: {
+        id: string | number;
+        episodeId: string | number;
+        subType?: string;
+        server?: string;
+    }) => Promise<Source<TSourceMeta>>;
+};
+export declare const MangaFetch: <TSearchMeta = unknown, TInfoMeta = unknown, TChapterMeta = unknown>(config: FetchModuleConfig) => {
+    search: (q: string) => Promise<Search<TSearchMeta>[]>;
+    info: (id: string | number) => Promise<Info<TInfoMeta, unknown>>;
+    chapters: (id: string | number) => Promise<Chapter<TChapterMeta>[]>;
+    pages: (params: {
+        id: string | number;
+        chapterId: string | number;
+        lang?: string;
+    }) => Promise<Page[]>;
+};
+export declare const MetaFetch: <TSearchMeta = unknown, TInfoMeta = unknown>(config: FetchModuleConfig) => {
+    search: (q: string) => Promise<Search<TSearchMeta>[]>;
+    info: (id: string | number) => Promise<Info<TInfoMeta, unknown>>;
+};
+export declare const MapperFetch: (config: FetchModuleConfig) => {
+    map: (params: {
+        id: number;
+        provider: string;
+    }) => Promise<unknown>;
+};
+export {};

package/dist/helpers/fetch.js

@@ -0,0 +1,161 @@
+const fetchFn = (baseUrl, apiKey) => {
+    return async (path, params) => {
+        const url = new URL(baseUrl + path);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null) {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        const res = await fetch(url.toString(), {
+            headers: {
+                'x-api-key': apiKey,
+            },
+        });
+        if (!res.ok) {
+            throw new Error(`Failed (${res.status}) (${res.statusText}) on ${url.pathname}`);
+        }
+        return res.json();
+    };
+};
+export const AnimeFetch = (config) => {
+    const { baseUrl = 'https://api.crysoline.moe', provider, apiKey } = config;
+    const basePath = `${baseUrl}/api/anime/${provider}/`;
+    const fetcher = fetchFn(basePath, apiKey);
+    /**
+     * Search for anime by query string.
+     *
+     * @param q - Search query.
+     */
+    const search = async (q) => fetcher('search', { q });
+    /**
+     * Fetch detailed info for a given anime id.
+     *
+     * @param id - Anime identifier (string or number)
+     */
+    const info = async (id) => fetcher(`info/${encodeURIComponent(id)}`);
+    /**
+     * Fetch episodes list for a given anime id.
+     *
+     * @param id - Anime identifier (string or number)
+     */
+    const episodes = async (id) => fetcher(`episodes/${encodeURIComponent(id)}`);
+    /**
+     * Fetch sources for a particular episode.
+     *
+     * @param params - Object containing `id`, `episodeId` and optional `subType` and `server`
+     */
+    const sources = (params) => fetcher('sources', params);
+    return {
+        search,
+        info,
+        episodes,
+        sources,
+    };
+};
+export const HentaiFetch = (config) => {
+    const { baseUrl = 'https://api.crysoline.moe', provider, apiKey } = config;
+    const basePath = `${baseUrl}/api/hentai/${provider}/`;
+    const fetcher = fetchFn(basePath, apiKey);
+    /**
+     * Search for hentai by query string.
+     *
+     * @param q - Search query.
+     */
+    const search = async (q) => fetcher('search', { q });
+    /**
+     * Get detailed info for an item by id.
+     *
+     * @param id - Item identifier.
+     */
+    const info = async (id) => fetcher(`info/${encodeURIComponent(id)}`);
+    /**
+     * List episodes for a specific item.
+     *
+     * @param id - Item identifier.
+     */
+    const episodes = async (id) => fetcher(`episodes/${encodeURIComponent(id)}`);
+    /**
+     * Get sources for a specific episode.
+     *
+     * @param params - Parameters to identify the episode and optional filters.
+     */
+    const sources = (params) => fetcher('sources', params);
+    return {
+        search,
+        info,
+        episodes,
+        sources,
+    };
+};
+export const MangaFetch = (config) => {
+    const { baseUrl = 'https://api.crysoline.moe', provider, apiKey } = config;
+    const basePath = `${baseUrl}/api/manga/${provider}/`;
+    const fetcher = fetchFn(basePath, apiKey);
+    /**
+     * Search for manga by query string.
+     *
+     * @param q - Search query.
+     */
+    const search = async (q) => fetcher('search', { q });
+    /**
+     * Get detailed info for a manga by id.
+     *
+     * @param id - Manga identifier.
+     */
+    const info = async (id) => fetcher(`info/${encodeURIComponent(id)}`);
+    /**
+     * List chapters for a specific manga.
+     *
+     * @param id - Manga identifier.
+     */
+    const chapters = async (id) => fetcher(`chapters/${encodeURIComponent(id)}`);
+    /**
+     * Fetch pages for a specific manga chapter.
+     *
+     * @param params - Object containing `id`, `chapterId` and optional `lang`
+     */
+    const pages = (params) => fetcher('pages', params);
+    return {
+        search,
+        info,
+        chapters,
+        pages,
+    };
+};
+export const MetaFetch = (config) => {
+    const { baseUrl = 'https://api.crysoline.moe', provider, apiKey } = config;
+    const basePath = `${baseUrl}/api/meta/${provider}/`;
+    const fetcher = fetchFn(basePath, apiKey);
+    /**
+     * Search meta provider by query string.
+     *
+     * @param q - Search query.
+     */
+    const search = async (q) => fetcher('search', { q });
+    /**
+     * Get info from meta provider by id.
+     *
+     * @param id - Resource identifier.
+     */
+    const info = async (id) => fetcher(`info/${encodeURIComponent(id)}`);
+    return {
+        search,
+        info,
+    };
+};
+export const MapperFetch = (config) => {
+    const { baseUrl = 'https://api.crysoline.moe', provider, apiKey } = config;
+    const basePath = `${baseUrl}/api/mapper/${provider}`;
+    const fetcher = fetchFn(basePath, apiKey);
+    /**
+     * Map an id from one provider to another.
+     *
+     * @param params - Mapping parameters: `id` to map and `provider` to map to.
+     */
+    const map = async (params) => fetcher('map', params);
+    return {
+        map,
+    };
+};

package/dist/index.d.ts

@@ -0,0 +1 @@
+export { Anime, Hentai, Manga, Mapper, Meta } from './core';

package/dist/index.js

@@ -0,0 +1 @@
+export { Anime, Hentai, Manga, Mapper, Meta } from './core';

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "@crysoline/lib",
+  "description": "The official crysoline library for anime, manga using the Crysoline API",
+  "license": "MIT",
+  "version": "0.1.1",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": ["dist"],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build",
+    "lint": "biome lint .",
+    "format": "biome format . --write"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "2.3.10",
+    "typescript": "^5",
+    "@types/bun": "latest"
+  },
+  "keywords": [
+    "crysoline",
+    "anime",
+    "manga",
+    "meta"
+  ]
+}