@crysoline/lib 0.1.1 → 0.1.3

package/dist/core/anime/hianime/types.d.ts

@@ -21,6 +21,9 @@ export interface HianimeSearchMeta {
 export interface HianimeEpisodeMeta {
     title_jp: string | null;
 }
+export interface HianimeServerMeta {
+    data_id: number | null;
+}
 export interface HianimeInfoMeta {
     year: number | null;
     score: number | null;

package/dist/core/anime/index.d.ts

@@ -4,12 +4,14 @@ import type { NEpisodeMeta, NInfoMeta, NSearchMeta } from './animenexus';
 import type { OEpisodeMeta, OInfoMeta } from './animeonsen';
 import type { PaheEpisodeMeta, PaheInfoMeta, PaheSearchMeta } from './animepahe';
 import type { AZEpisodeMeta, AZInfoMeta, AZSearchMeta } from './anizone';
-import type { HianimeEpisodeMeta, HianimeInfoMeta, HianimeSearchMeta } from './hianime';
+import type { HianimeEpisodeMeta, HianimeInfoMeta, HianimeSearchMeta, HianimeServerMeta } from './hianime';
 import type { KEpisodeMeta, KInfoMeta, KSearchMeta, KSourceMeta } from './kickassanime';
 import type { LEpisodeMeta, LInfoMeta, LSearchMeta, LSourcesMeta } from './lunar';
 import type { UniqueEpisodeMeta, UniqueInfoMeta, UniqueSearchMeta } from './uniquestream';
 declare const Anime: {
     OneTwoThreeAnime: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<OneTwoThreeAnimeSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<OneTwoThreeAnimeInfoMeta, import("../types").Episode<unknown>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<unknown>[]>;
@@ -21,6 +23,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<unknown>>;
     };
     AnimeParadise: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<unknown>[]>;
         info: (id: string | number) => Promise<import("../types").Info<unknown, import("../types").Episode<unknown>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<unknown>[]>;
@@ -32,6 +36,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<unknown>>;
     };
     AnimeHeaven: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<unknown>[]>;
         info: (id: string | number) => Promise<import("../types").Info<unknown, import("../types").Episode<unknown>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<unknown>[]>;
@@ -43,6 +49,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<unknown>>;
     };
     AnimeKai: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<KaiSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<KaiInfoMeta, import("../types").Episode<KaiEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<KaiEpisodeMeta>[]>;
@@ -54,6 +62,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<unknown>>;
     };
     AnimeNexus: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<NSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<NInfoMeta, import("../types").Episode<NEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<NEpisodeMeta>[]>;
@@ -65,6 +75,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<unknown>>;
     };
     AnimeOnsen: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<unknown>[]>;
         info: (id: string | number) => Promise<import("../types").Info<OInfoMeta, import("../types").Episode<OEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<OEpisodeMeta>[]>;
@@ -76,6 +88,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<unknown>>;
     };
     AnimePahe: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<PaheSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<PaheInfoMeta, import("../types").Episode<PaheEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<PaheEpisodeMeta>[]>;
@@ -87,6 +101,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<unknown>>;
     };
     AniZone: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<AZSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<AZInfoMeta, import("../types").Episode<AZEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<AZEpisodeMeta>[]>;
@@ -98,6 +114,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<unknown>>;
     };
     HiAnime: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<HianimeSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<HianimeInfoMeta, import("../types").Episode<HianimeEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<HianimeEpisodeMeta>[]>;
@@ -107,8 +125,14 @@ declare const Anime: {
             subType?: string;
             server?: string;
         }) => Promise<import("../types").Source<unknown>>;
+        servers: (params: {
+            id: string | number;
+            episodeId: string | number;
+        }) => Promise<import("../types").Server<HianimeServerMeta>>;
     };
     KickAssAnime: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<KSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<KInfoMeta, import("../types").Episode<KEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<KEpisodeMeta>[]>;
@@ -120,6 +144,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<KSourceMeta>>;
     };
     LunarAnime: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<LSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<LInfoMeta, import("../types").Episode<LEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<LEpisodeMeta>[]>;
@@ -131,6 +157,8 @@ declare const Anime: {
         }) => Promise<import("../types").Source<LSourcesMeta>>;
     };
     UniqueStream: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<UniqueSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<UniqueInfoMeta, import("../types").Episode<UniqueEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<UniqueEpisodeMeta>[]>;

package/dist/core/anime/index.js

@@ -1,48 +1,230 @@
 import { AnimeFetch } from '../../helpers/fetch';
+/**
+ * Creates a 123Anime API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = OneTwoThreeAnime(process.env.API_KEY);
+ * const results = await client.search("naruto");
+ * const info = await client.info(results[0].id);
+ * ```
+ */
 const OneTwoThreeAnime = (apiKey) => AnimeFetch({
     provider: 'onetwothreeanime',
     apiKey,
 });
+/**
+ * Creates an AnimeParadise API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = AnimeParadise(process.env.API_KEY);
+ * const results = await client.search("one piece");
+ * const episodes = await client.episodes(results[0].id);
+ * ```
+ */
 const AnimeParadise = (apiKey) => AnimeFetch({
     provider: 'animeparadise',
     apiKey,
 });
+/**
+ * Creates an AnimeHeaven API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = AnimeHeaven(process.env.API_KEY);
+ * const results = await client.search("demon slayer");
+ * const info = await client.info(results[0].id);
+ * ```
+ */
 const AnimeHeaven = (apiKey) => AnimeFetch({
     provider: 'animeheaven',
     apiKey,
 });
+/**
+ * Creates an AnimeKai API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = AnimeKai(process.env.API_KEY);
+ * const results = await client.search("attack on titan");
+ * const episodes = await client.episodes(results[0].id);
+ * ```
+ */
 const AnimeKai = (apiKey) => AnimeFetch({
     provider: 'animekai',
     apiKey,
 });
+/**
+ * Creates an AnimeNexus API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = AnimeNexus(process.env.API_KEY);
+ * const results = await client.search("jujutsu kaisen");
+ * const info = await client.info(results[0].id);
+ * ```
+ */
 const AnimeNexus = (apiKey) => AnimeFetch({
     provider: 'animenexus',
     apiKey,
 });
+/**
+ * Creates an AnimeOnsen API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = AnimeOnsen(process.env.API_KEY);
+ * const results = await client.search("my hero academia");
+ * const episodes = await client.episodes(results[0].id);
+ * ```
+ */
 const AnimeOnsen = (apiKey) => AnimeFetch({
     provider: 'animeonsen',
     apiKey,
 });
+/**
+ * Creates an AnimePahe API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = AnimePahe(process.env.API_KEY);
+ * const results = await client.search("chainsaw man");
+ * const info = await client.info(results[0].id);
+ * ```
+ */
 const AnimePahe = (apiKey) => AnimeFetch({
     provider: 'animepahe',
     apiKey,
 });
+/**
+ * Creates an AniZone API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = AniZone(process.env.API_KEY);
+ * const results = await client.search("spy x family");
+ * const episodes = await client.episodes(results[0].id);
+ * ```
+ */
 const AniZone = (apiKey) => AnimeFetch({
     provider: 'anizone',
     apiKey,
 });
+/**
+ * Creates a HiAnime API client.
+ *
+ * **Full-featured provider with server selection support.**
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources, servers
+ *
+ * @example
+ * ```ts
+ * const client = HiAnime(process.env.API_KEY);
+ *
+ * // Search for anime
+ * const results = await client.search("alya");
+ *
+ * // Get anime info
+ * const info = await client.info(results[0].id);
+ *
+ * // Get episodes
+ * const episodes = await client.episodes(results[0].id);
+ *
+ * // Get available servers
+ * const servers = await client.servers({
+ *   id: results[0].id,
+ *   episodeId: episodes[0].id
+ * });
+ *
+ * // Get streaming sources
+ * const sources = await client.sources({
+ *   id: results[0].id,
+ *   episodeId: episodes[0].id,
+ *   subType: "sub"
+ * });
+ * ```
+ */
 const HiAnime = (apiKey) => AnimeFetch({
     provider: 'hianime',
     apiKey,
 });
+/**
+ * Creates a KickAssAnime API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = KickAssAnime(process.env.API_KEY);
+ * const results = await client.search("vinland saga");
+ * const sources = await client.sources({
+ *   id: results[0].id,
+ *   episodeId: "ep-1"
+ * });
+ * ```
+ */
 const KickAssAnime = (apiKey) => AnimeFetch({
     provider: 'kickassanime',
     apiKey,
 });
+/**
+ * Creates a LunarAnime API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = LunarAnime(process.env.API_KEY);
+ * const results = await client.search("bleach");
+ * const info = await client.info(results[0].id);
+ * const episodes = await client.episodes(results[0].id);
+ * ```
+ */
 const LunarAnime = (apiKey) => AnimeFetch({
     provider: 'lunaranime',
     apiKey,
 });
+/**
+ * Creates a UniqueStream API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = UniqueStream(process.env.API_KEY);
+ * const results = await client.search("solo leveling");
+ * const episodes = await client.episodes(results[0].id);
+ * ```
+ */
 const UniqueStream = (apiKey) => AnimeFetch({
     provider: 'uniquestream',
     apiKey,

package/dist/core/hentai/index.d.ts

@@ -4,6 +4,8 @@ import type { HavenEpisodeMeta, HavenInfoMeta, HavenSourceMeta } from './hentaih
 import type { HStreamSearchMeta } from './hstream';
 declare const Hentai: {
     HAnime: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<HAnimeSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<HAnimeInfoMeta, import("../types").Episode<HianimeEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<HianimeEpisodeMeta>[]>;
@@ -15,6 +17,8 @@ declare const Hentai: {
         }) => Promise<import("../types").Source<unknown>>;
     };
     HentaiHaven: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<unknown>[]>;
         info: (id: string | number) => Promise<import("../types").Info<HavenInfoMeta, import("../types").Episode<HavenEpisodeMeta>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<HavenEpisodeMeta>[]>;
@@ -26,6 +30,8 @@ declare const Hentai: {
         }) => Promise<import("../types").Source<HavenSourceMeta>>;
     };
     HStream: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<HStreamSearchMeta>[]>;
         info: (id: string | number) => Promise<import("../types").Info<unknown, import("../types").Episode<unknown>>>;
         episodes: (id: string | number) => Promise<import("../types").Episode<unknown>[]>;

package/dist/core/hentai/index.js

@@ -1,12 +1,55 @@
 import { HentaiFetch } from '../../helpers/fetch';
+/**
+ * Creates an HAnime API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = HAnime(process.env.API_KEY);
+ * const results = await client.search("query");
+ * const info = await client.info(results[0].id);
+ * const episodes = await client.episodes(results[0].id);
+ * ```
+ */
 const HAnime = (apiKey) => HentaiFetch({
     provider: 'hanime',
     apiKey,
 });
+/**
+ * Creates a HentaiHaven API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = HentaiHaven(process.env.API_KEY);
+ * const info = await client.info("content-id");
+ * const sources = await client.sources({
+ *   id: "content-id",
+ *   episodeId: "ep-1"
+ * });
+ * ```
+ */
 const HentaiHaven = (apiKey) => HentaiFetch({
     provider: 'hentaihaven',
     apiKey,
 });
+/**
+ * Creates an HStream API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, episodes, sources
+ *
+ * @example
+ * ```ts
+ * const client = HStream(process.env.API_KEY);
+ * const results = await client.search("query");
+ * const info = await client.info(results[0].id);
+ * ```
+ */
 const HStream = (apiKey) => HentaiFetch({
     provider: 'hstream',
     apiKey,

package/dist/core/manga/index.d.ts

@@ -3,8 +3,10 @@ import type { MDXInfoMeta, MDXSearchMeta } from './mangadex';
 import type { MFInfoMeta, MFSearchMeta } from './mangafire';
 declare const Manga: {
     LunarManga: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<LMangaSearchMeta>[]>;
-        info: (id: string | number) => Promise<import("../types").Info<LMangaInfoMeta, unknown>>;
+        info: (id: string | number) => Promise<import("../types").Info<LMangaInfoMeta, import("../types").Episode<unknown>>>;
         chapters: (id: string | number) => Promise<import("../types").Chapter<unknown>[]>;
         pages: (params: {
             id: string | number;
@@ -13,8 +15,10 @@ declare const Manga: {
         }) => Promise<import("../types").Page[]>;
     };
     MangaDex: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<MDXSearchMeta>[]>;
-        info: (id: string | number) => Promise<import("../types").Info<MDXInfoMeta, unknown>>;
+        info: (id: string | number) => Promise<import("../types").Info<MDXInfoMeta, import("../types").Episode<unknown>>>;
         chapters: (id: string | number) => Promise<import("../types").Chapter<unknown>[]>;
         pages: (params: {
             id: string | number;
@@ -23,8 +27,10 @@ declare const Manga: {
         }) => Promise<import("../types").Page[]>;
     };
     MangaFire: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<MFSearchMeta>[]>;
-        info: (id: string | number) => Promise<import("../types").Info<MFInfoMeta, unknown>>;
+        info: (id: string | number) => Promise<import("../types").Info<MFInfoMeta, import("../types").Episode<unknown>>>;
         chapters: (id: string | number) => Promise<import("../types").Chapter<unknown>[]>;
         pages: (params: {
             id: string | number;

package/dist/core/manga/index.js

@@ -1,12 +1,64 @@
 import { MangaFetch } from '../../helpers/fetch';
+/**
+ * Creates a LunarManga API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, chapters, pages
+ *
+ * @example
+ * ```ts
+ * const client = LunarManga(process.env.API_KEY);
+ * const results = await client.search("one piece");
+ * const info = await client.info(results[0].id);
+ * const chapters = await client.chapters(results[0].id);
+ * const pages = await client.pages({
+ *   id: results[0].id,
+ *   chapterId: chapters[0].id
+ * });
+ * ```
+ */
 const LunarManga = (apiKey) => MangaFetch({
     provider: 'lunarmanga',
     apiKey,
 });
+/**
+ * Creates a MangaDex API client.
+ *
+ * **Popular provider with multi-language support.**
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, chapters, pages
+ *
+ * @example
+ * ```ts
+ * const client = MangaDex(process.env.API_KEY);
+ * const results = await client.search("chainsaw man");
+ * const chapters = await client.chapters(results[0].id);
+ * const pages = await client.pages({
+ *   id: results[0].id,
+ *   chapterId: chapters[0].id,
+ *   lang: "en"
+ * });
+ * ```
+ */
 const MangaDex = (apiKey) => MangaFetch({
     provider: 'mangadex',
     apiKey,
 });
+/**
+ * Creates a MangaFire API client.
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info, chapters, pages
+ *
+ * @example
+ * ```ts
+ * const client = MangaFire(process.env.API_KEY);
+ * const results = await client.search("berserk");
+ * const info = await client.info(results[0].id);
+ * const chapters = await client.chapters(results[0].id);
+ * ```
+ */
 const MangaFire = (apiKey) => MangaFetch({
     provider: 'mangafire',
     apiKey,

package/dist/core/mapper/index.d.ts

@@ -1,7 +1,30 @@
+/**
+ * Creates a Mapper API client for converting between provider IDs.
+ *
+ * **Use this to map AniList IDs to provider-specific IDs.**
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with method: map
+ *
+ * @example
+ * ```ts
+ * const mapper = Mapper(process.env.API_KEY);
+ *
+ * // Map AniList ID to provider ID
+ * const mapping = await mapper.map({
+ *   id: 21,  // AniList ID for "One Piece"
+ *   provider: "animepahe"
+ * });
+ *
+ * console.log(mapping.idMap);  // Provider-specific ID
+ * ```
+ */
 declare const Mapper: (apiKey: string) => {
+    name: string;
+} & {
     map: (params: {
         id: number;
         provider: string;
-    }) => Promise<unknown>;
+    }) => Promise<import("./types").Mapping>;
 };
 export { Mapper };

package/dist/core/mapper/index.js

@@ -1,4 +1,25 @@
 import { MapperFetch } from '../../helpers/fetch';
+/**
+ * Creates a Mapper API client for converting between provider IDs.
+ *
+ * **Use this to map AniList IDs to provider-specific IDs.**
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with method: map
+ *
+ * @example
+ * ```ts
+ * const mapper = Mapper(process.env.API_KEY);
+ *
+ * // Map AniList ID to provider ID
+ * const mapping = await mapper.map({
+ *   id: 21,  // AniList ID for "One Piece"
+ *   provider: "animepahe"
+ * });
+ *
+ * console.log(mapping.idMap);  // Provider-specific ID
+ * ```
+ */
 const Mapper = (apiKey) => MapperFetch({
     provider: 'mapper',
     apiKey,

package/dist/core/meta/index.d.ts

@@ -2,12 +2,16 @@ import type { MInfoMeta, MSearchMeta } from './myanimelist';
 import type { MMLInfoMeta, MMSearchMeta } from './mymangalist';
 declare const Meta: {
     MyAnimeList: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<MSearchMeta>[]>;
-        info: (id: string | number) => Promise<import("../types").Info<MInfoMeta, unknown>>;
+        info: (id: string | number) => Promise<import("../types").Info<MInfoMeta, import("../types").Episode<unknown>>>;
     };
     MyMangaList: (apiKey: string) => {
+        name: string;
+    } & {
         search: (q: string) => Promise<import("../types").Search<MMSearchMeta>[]>;
-        info: (id: string | number) => Promise<import("../types").Info<MMLInfoMeta, unknown>>;
+        info: (id: string | number) => Promise<import("../types").Info<MMLInfoMeta, import("../types").Episode<unknown>>>;
     };
 };
 export { Meta };

package/dist/core/meta/index.js

@@ -1,8 +1,48 @@
 import { MetaFetch } from '../../helpers/fetch';
+/**
+ * Creates a MyAnimeList API client for anime metadata.
+ *
+ * **Provides comprehensive anime information and statistics from MyAnimeList.**
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info
+ *
+ * @example
+ * ```ts
+ * const mal = MyAnimeList(process.env.API_KEY);
+ *
+ * // Search for anime
+ * const results = await mal.search("steins gate");
+ *
+ * // Get detailed info with MAL ratings, stats, and metadata
+ * const info = await mal.info(results[0].id);
+ * console.log(info.score, info.rank, info.popularity);
+ * ```
+ */
 const MyAnimeList = (apiKey) => MetaFetch({
     provider: 'myanimelist',
     apiKey,
 });
+/**
+ * Creates a MyMangaList API client for manga metadata.
+ *
+ * **Provides comprehensive manga information and statistics from MyAnimeList.**
+ *
+ * @param apiKey - Your API key for authentication
+ * @returns API client with methods: search, info
+ *
+ * @example
+ * ```ts
+ * const mml = MyMangaList(process.env.API_KEY);
+ *
+ * // Search for manga
+ * const results = await mml.search("berserk");
+ *
+ * // Get detailed info with MAL ratings, stats, and metadata
+ * const info = await mml.info(results[0].id);
+ * console.log(info.score, info.rank, info.members);
+ * ```
+ */
 const MyMangaList = (apiKey) => MetaFetch({
     provider: 'mymangalist',
     apiKey,

package/dist/core/types.d.ts

@@ -99,3 +99,9 @@ export interface Source<T = unknown> {
     thumbnails?: string | null;
     metadata?: T | null;
 }
+export interface Server<T = unknown> {
+    id?: string | number | null;
+    name?: string | null;
+    type?: string | null;
+    metadata?: T | null;
+}

package/dist/helpers/fetch.d.ts

@@ -1,49 +1,78 @@
-import type { Chapter, Episode, Info, Page, Search, Source } from '../core/types';
+import type { Mapping } from '../core/mapper/types';
+import type { Chapter, Episode, Info, Page, Search, Server, Source } from '../core/types';
+type SearchRoute<T = unknown> = (q: string) => Promise<Search<T>[]>;
+type InfoRoute<T = unknown, E = unknown> = (id: string | number) => Promise<Info<T, E>>;
+type EpisodesRoute<T = unknown> = (id: string | number) => Promise<Episode<T>[]>;
+type SourcesRoute<T> = (params: {
+    id: string | number;
+    episodeId: string | number;
+    subType?: string;
+    server?: string;
+}) => Promise<Source<T>>;
+type ServersRoute<T> = (params: {
+    id: string | number;
+    episodeId: string | number;
+}) => Promise<Server<T>>;
+type ChaptersRoute<T = unknown> = (id: string | number) => Promise<Chapter<T>[]>;
+type PagesRoute = (params: {
+    id: string | number;
+    chapterId: string | number;
+    lang?: string;
+}) => Promise<Page[]>;
+type MapRoute = (params: {
+    id: number;
+    provider: string;
+}) => Promise<Mapping>;
+type RouteMap<TSearchMeta = unknown, TInfoMeta = unknown, TEpisodeMeta = unknown, TSourceMeta = unknown, TServerMeta = unknown, TChapterMeta = unknown> = {
+    search: SearchRoute<TSearchMeta>;
+    info: InfoRoute<TInfoMeta, Episode<TEpisodeMeta>>;
+    episodes: EpisodesRoute<TEpisodeMeta>;
+    sources: SourcesRoute<TSourceMeta>;
+    servers: ServersRoute<TServerMeta>;
+    chapters: ChaptersRoute<TChapterMeta>;
+    pages: PagesRoute;
+    map: MapRoute;
+};
+type SelectRoutes = {
+    [K in keyof RouteMap]?: boolean;
+};
+type BuildRoutes<T extends SelectRoutes, TSearchMeta = unknown, TInfoMeta = unknown, TEpisodeMeta = unknown, TSourceMeta = unknown, TServerMeta = unknown, TChapterMeta = unknown> = {
+    name: string;
+} & {
+    [K in keyof T & keyof RouteMap as T[K] extends true ? K : never]: RouteMap<TSearchMeta, TInfoMeta, TEpisodeMeta, TSourceMeta, TServerMeta, TChapterMeta>[K];
+};
+type BuildAnimeRoutes<T extends SelectRoutes, TSearchMeta = unknown, TInfoMeta = unknown, TEpisodeMeta = unknown, TSourceMeta = unknown, TServerMeta = unknown> = BuildRoutes<T, TSearchMeta, TInfoMeta, TEpisodeMeta, TSourceMeta, TServerMeta>;
+type BuildMangaRoutes<T extends SelectRoutes, TSearchMeta = unknown, TInfoMeta = unknown, TChapterMeta = unknown> = BuildRoutes<T, TSearchMeta, TInfoMeta, unknown, unknown, unknown, TChapterMeta>;
+type BuildMetaRoutes<T extends SelectRoutes, TSearchMeta = unknown, TInfoMeta = unknown> = BuildRoutes<T, TSearchMeta, TInfoMeta>;
 interface FetchModuleConfig {
     baseUrl?: string;
     provider: string;
     apiKey: string;
+    select?: SelectRoutes;
 }
-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 declare const AnimeFetch: <TSearchMeta = unknown, TInfoMeta = unknown, TEpisodeMeta = unknown, TSourceMeta = unknown, TServerMeta = unknown, S extends SelectRoutes = {
+    search: true;
+    info: true;
+    episodes: true;
+    sources: true;
+}>(config: FetchModuleConfig) => BuildAnimeRoutes<S, TSearchMeta, TInfoMeta, TEpisodeMeta, TSourceMeta, TServerMeta>;
+export declare const HentaiFetch: <TSearchMeta = unknown, TInfoMeta = unknown, TEpisodeMeta = unknown, TSourceMeta = unknown, TServerMeta = unknown, S extends SelectRoutes = {
+    search: true;
+    info: true;
+    episodes: true;
+    sources: true;
+}>(config: FetchModuleConfig) => BuildAnimeRoutes<S, TSearchMeta, TInfoMeta, TEpisodeMeta, TSourceMeta, TServerMeta>;
+export declare const MangaFetch: <TSearchMeta = unknown, TInfoMeta = unknown, TChapterMeta = unknown, S extends SelectRoutes = {
+    search: true;
+    info: true;
+    chapters: true;
+    pages: true;
+}>(config: FetchModuleConfig) => BuildMangaRoutes<S, TSearchMeta, TInfoMeta, TChapterMeta>;
+export declare const MetaFetch: <TSearchMeta = unknown, TInfoMeta = unknown, S extends SelectRoutes = {
+    search: true;
+    info: true;
+}>(config: FetchModuleConfig) => BuildMetaRoutes<S, TSearchMeta, TInfoMeta>;
+export declare const MapperFetch: (config: FetchModuleConfig) => BuildRoutes<{
+    map: true;
+}>;
 export {};

package/dist/helpers/fetch.js

@@ -23,101 +23,48 @@ 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);
+    const servers = (params) => fetcher('servers', params);
     return {
+        name: provider,
         search,
         info,
         episodes,
         sources,
+        servers,
     };
 };
 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);
+    const servers = (params) => fetcher('servers', params);
     return {
+        name: provider,
         search,
         info,
         episodes,
         sources,
+        servers,
     };
 };
 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 {
+        name: provider,
         search,
         info,
         chapters,
@@ -128,19 +75,10 @@ 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 {
+        name: provider,
         search,
         info,
     };
@@ -149,11 +87,6 @@ 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/package.json

@@ -2,17 +2,27 @@
   "name": "@crysoline/lib",
   "description": "The official crysoline library for anime, manga using the Crysoline API",
   "license": "MIT",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
-  "files": ["dist"],
+  "files": [
+    "dist"
+  ],
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "default": "./dist/index.js"
     }
   },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/crysoline/crysoline-lib.git"
+  },
+  "homepage": "https://github.com/crysoline/crysoline-lib",
+  "bugs": {
+    "url": "https://github.com/crysoline/crysoline-lib/issues"
+  },
   "scripts": {
     "build": "tsc",
     "prepublishOnly": "npm run build",