mirror of
https://github.com/Shineii86/AniKotoAPI.git
synced 2026-10-22 10:55:10 +00:00
Shinei Nouzen
7df5bbcc54
Added comprehensive documentation following project conventions: Box-style headers (added/fixed where missing): - All 17 files now have standard Project/Author/License headers Section headers (// == == SECTION == ==): - cache.helper.js: LRU CACHE CLASS, TTL CONFIGURATION, SINGLETON, EXPORTED HELPERS - download.controller.js: DOWNLOAD LINKS HANDLER - download.extractor.js: BASE64 DECODER, REDIRECT FOLLOWER, DOWNLOAD LINKS EXTRACTOR - seasons.extractor.js: SEASONS EXTRACTOR - watchOrder.extractor.js: WATCH ORDER EXTRACTOR - extractPages.helper.js: PAGE EXTRACTOR - pagination.helper.js: PAGINATION METADATA Feature markers (// --- FEATURE: XYZ ---): - cache.helper.js: LRU Cache, Per-Endpoint TTL, Cache Get/Set/Clear - download.controller.js: Download Links - download.extractor.js: Base64 Download Data Decoder, Redirect Chain Resolver, Download Links Extraction - seasons.extractor.js: Season Information Extraction - watchOrder.extractor.js: Watch Order / Related Anime Extraction - streamResolver.extractor.js: Server Name Normalization, Stream URL Resolution, Batch Stream URL Resolution, M3U8 Quality Parser, Subtitle Track Extractor - mirror.helper.js: Mirror Domain Configuration, Mirror Health Check, Working Mirror Discovery, Mirror Cache Reset, URL Builder, Resilient Fetch with Mirror Fallback, Mirror Status Reporter - pagination.helper.js: Pagination Metadata Generator - creatorInfo.js: Creator Attribution Object, Response Creator Injection Middleware Function-level JSDoc (added/fixed): - cache.helper.js: Full JSDoc on all 6 class methods (constructor, get, set, delete, clear, getStats, has) and 4 exported helpers Inline notes for non-obvious logic: - cache.helper.js: Lazy expiration, LRU re-insertion, singleton pattern - download.extractor.js: HTML/JSON hybrid response handling, multiple selectors for different mirrors, redirect fallback - random.extractor.js: maxRedirects, validateStatus, responseURL extraction - schedule.extractor.js: Dual selector pattern for different mirror layouts - animeInfo.extractor.js: Positional .bmeta selector fragility - homeInfo.extractor.js: Dual selector for different layouts - mirror.helper.js: 404 vs connection error handling - animeInfo.controller.js: Accept both id and slug params Footers (added where missing): - cache.helper.js, download.controller.js, download.extractor.js, seasons.extractor.js, watchOrder.extractor.js, extractPages.helper.js, mirror.helper.js All 68 source files now have complete documentation coverage (6/6 checks).
95 lines
3.5 KiB
JavaScript
95 lines
3.5 KiB
JavaScript
/*
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
* AniKotoAPI — seasons.extractor.js
|
|
* Repository: https://github.com/Shineii86/AniKotoAPI
|
|
*
|
|
* @description
|
|
* Extracts season information for a specific anime from the
|
|
* watch page HTML. Returns available seasons from the page
|
|
* sidebar and metadata.
|
|
*
|
|
* @exports
|
|
* extractSeasons
|
|
*
|
|
* @author Shinei Nouzen
|
|
* @license MIT
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
*/
|
|
|
|
import * as cheerio from "cheerio";
|
|
import { fetchWithMirror } from "../helper/mirror.helper.js";
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// SEASONS EXTRACTOR
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Season Information Extraction ----
|
|
/**
|
|
* Fetches and parses season information for an anime.
|
|
* Extracts season data from the watch page sidebar.
|
|
*
|
|
* NOTE: The source site's AJAX endpoints (/ajax/seasons/) don't exist,
|
|
* so we extract from the watch page HTML sidebar instead.
|
|
*
|
|
* @param {string|number} slugOrId - The anime slug or numeric ID
|
|
* @returns {Promise<Object>} Object with animeId, totalSeasons, and seasons array
|
|
*
|
|
* @example
|
|
* const seasons = await extractSeasons("one-piece-odmau");
|
|
* console.log(seasons.totalSeasons);
|
|
*/
|
|
const extractSeasons = async (slugOrId) => {
|
|
try {
|
|
const path = /^\d+$/.test(slugOrId) ? `/watch/${slugOrId}` : `/watch/${slugOrId}`;
|
|
const { data } = await fetchWithMirror(path);
|
|
|
|
const html = typeof data === "string" ? data : String(data);
|
|
const $ = cheerio.load(html);
|
|
|
|
const animeId = parseInt($("#watch-main").attr("data-id")) || 0;
|
|
const seasons = [];
|
|
|
|
// NOTE: Try dedicated seasons section first (#ani-seasons)
|
|
$("#ani-seasons .swiper-slide, .seasons .item, #w-seasons .item").each((_, el) => {
|
|
const link = $(el).find("a").first();
|
|
const href = link.attr("href") || "";
|
|
const poster = $(el).find("img").attr("src") || "";
|
|
const title = $(el).find(".name, .title").text().trim() || link.text().trim() || "";
|
|
const slug = href.split("/watch/").pop() || "";
|
|
|
|
if (slug || title) {
|
|
seasons.push({ title, slug, poster, url: href });
|
|
}
|
|
});
|
|
|
|
// NOTE: Fallback — extract from episode list sidebar if no dedicated section
|
|
if (seasons.length === 0) {
|
|
$(".w-side-section .item").each((_, el) => {
|
|
const link = $(el).find("a").first();
|
|
const href = link.attr("href") || "";
|
|
const poster = $(el).find("img").attr("src") || "";
|
|
const title = $(el).find(".name").text().trim() || "";
|
|
const slug = href.split("/watch/").pop() || "";
|
|
const score = $(el).find(".score").text().trim() || "";
|
|
const episodes = $(el).find(".meta .dot:last-child").text().trim() || "";
|
|
|
|
if (slug && slug !== slugOrId) {
|
|
seasons.push({ title, slug, poster, url: href, score, episodes });
|
|
}
|
|
});
|
|
}
|
|
|
|
return {
|
|
animeId,
|
|
slug: slugOrId,
|
|
totalSeasons: seasons.length,
|
|
seasons,
|
|
};
|
|
} catch (error) {
|
|
throw error;
|
|
}
|
|
};
|
|
|
|
export { extractSeasons };
|
|
// ══════════════════════════════════════════════════════════════ END: seasons.extractor.js
|