mirror of
https://github.com/Shineii86/AniKotoAPI.git
synced 2026-10-22 10:55:10 +00:00
Shinei Nouzen
fe51275db0
- Add multi-mirror fallback system with 5 mirror domains - Add LRU cache with configurable TTL per endpoint - Add response compression (gzip) - Add Seasons endpoint (/api/seasons/:id) - Add Watch Order endpoint (/api/watch-order/:id) - Add Latest Updated endpoint (/api/latest-updated) - Add Download endpoint (/api/download) - Add cache stats endpoint (/api/cache/stats) - Add mirror status/reset endpoints (/api/mirrors, /api/mirrors/reset) - Add configurable rate limiting with X-RateLimit headers - Add request timeouts and entity too large handling - Update documentation with all new endpoints - Update CHANGELOG.md with v2.0.0 entry - Update package.json version to 2.0.0 - Add 6 AI agent prompts for development
64 lines
2.5 KiB
JavaScript
64 lines
2.5 KiB
JavaScript
/*
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
* AniKotoAPI — episodeList.controller.js
|
|
* Repository: https://github.com/Shineii86/AniKotoAPI
|
|
*
|
|
* @description
|
|
* Controller for fetching the episode list of a specific anime.
|
|
* Returns all available episodes with their numbers and titles.
|
|
* Requires an anime ID as a route parameter.
|
|
*
|
|
* @exports
|
|
* getEpisodeList - Express route handler for GET /api/episodes/:id
|
|
*
|
|
* @author Shinei Nouzen
|
|
* @license MIT
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
*/
|
|
|
|
import { extractEpisodeList } from "../extractors/episodeList.extractor.js";
|
|
import { getCache, setCache, TTL } from "../helper/cache.helper.js";
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// CONTROLLER: EPISODE LIST
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Episode list endpoint ----
|
|
/**
|
|
* Handles GET /api/episodes/:id requests. Extracts the full
|
|
* episode list for the specified anime from the source site.
|
|
*
|
|
* @param {object} req - Express request object
|
|
* @param {object} req.params.id - Anime ID/slug
|
|
* @param {object} res - Express response object
|
|
* @param {Function} next - Express next middleware function
|
|
* @returns {void} Sends JSON response with episode list
|
|
*
|
|
* @example
|
|
* GET /api/episodes/one-piece
|
|
* Response: { success: true, results: [{ number, title, ... }] }
|
|
*
|
|
* @throws {400} If anime ID is not provided
|
|
*/
|
|
const getEpisodeList = async (req, res, next) => {
|
|
try {
|
|
const { id } = req.params;
|
|
if (!id) {
|
|
return res.status(400).json({ success: false, message: "Anime slug is required" });
|
|
}
|
|
const cacheKey = `episodes_${id}`;
|
|
const cached = getCache(cacheKey);
|
|
if (cached) {
|
|
return res.json({ success: true, results: cached });
|
|
}
|
|
const data = await extractEpisodeList(id);
|
|
setCache(cacheKey, data, TTL.episodes);
|
|
res.json({ success: true, results: data });
|
|
} catch (error) {
|
|
next(error);
|
|
}
|
|
};
|
|
|
|
export { getEpisodeList };
|
|
|
|
// ══════════════════════════════════════════════════════════════ END: episodeList.controller.js
|