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.4 KiB
JavaScript
64 lines
2.4 KiB
JavaScript
/*
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
* AniKotoAPI — seasons.controller.js
|
|
* Repository: https://github.com/Shineii86/AniKotoAPI
|
|
*
|
|
* @description
|
|
* Controller for anime season information. Returns season data
|
|
* for a specific anime including related seasons and episodes.
|
|
* Requires an anime ID as a route parameter.
|
|
*
|
|
* @exports
|
|
* getSeasons - Express route handler for GET /api/seasons/:id
|
|
*
|
|
* @author Shinei Nouzen
|
|
* @license MIT
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
*/
|
|
|
|
import { extractSeasons } from "../extractors/seasons.extractor.js";
|
|
import { getCache, setCache, TTL } from "../helper/cache.helper.js";
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// CONTROLLER: SEASONS
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Anime seasons endpoint ----
|
|
/**
|
|
* Handles GET /api/seasons/:id requests. Returns season information
|
|
* for the specified anime.
|
|
*
|
|
* @param {object} req - Express request object
|
|
* @param {string} req.params.id - Anime ID
|
|
* @param {object} res - Express response object
|
|
* @param {Function} next - Express next middleware function
|
|
* @returns {void} Sends JSON response with season data
|
|
*
|
|
* @example
|
|
* GET /api/seasons/12345
|
|
* Response: { success: true, results: { seasons, ... } }
|
|
*
|
|
* @throws {400} If anime ID is not provided
|
|
*/
|
|
const getSeasons = async (req, res, next) => {
|
|
try {
|
|
const { id } = req.params;
|
|
if (!id) {
|
|
return res.status(400).json({ success: false, message: "Anime ID is required" });
|
|
}
|
|
const cacheKey = `seasons_${id}`;
|
|
const cached = getCache(cacheKey);
|
|
if (cached) {
|
|
return res.json({ success: true, results: cached });
|
|
}
|
|
const data = await extractSeasons(id);
|
|
setCache(cacheKey, data, TTL.default);
|
|
res.json({ success: true, results: data });
|
|
} catch (error) {
|
|
next(error);
|
|
}
|
|
};
|
|
|
|
export { getSeasons };
|
|
|
|
// ══════════════════════════════════════════════════════════════ END: seasons.controller.js
|