mirror of
https://github.com/Shineii86/AniKotoAPI.git
synced 2026-10-22 19:05:11 +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
65 lines
2.5 KiB
JavaScript
65 lines
2.5 KiB
JavaScript
/*
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
* AniKotoAPI — watchOrder.controller.js
|
|
* Repository: https://github.com/Shineii86/AniKotoAPI
|
|
*
|
|
* @description
|
|
* Controller for recommended watch order. Returns the optimal
|
|
* viewing order for anime with multiple seasons, movies, and OVAs.
|
|
* Requires an anime ID as a route parameter.
|
|
*
|
|
* @exports
|
|
* getWatchOrder - Express route handler for GET /api/watch-order/:id
|
|
*
|
|
* @author Shinei Nouzen
|
|
* @license MIT
|
|
* ======= • ======= • ======= • ======= • =======• =======
|
|
*/
|
|
|
|
import { extractWatchOrder } from "../extractors/watchOrder.extractor.js";
|
|
import { getCache, setCache, TTL } from "../helper/cache.helper.js";
|
|
|
|
// ══════════════════════════════════════════════════════════════
|
|
// CONTROLLER: WATCH ORDER
|
|
// ══════════════════════════════════════════════════════════════
|
|
|
|
// ---- FEATURE: Recommended watch order endpoint ----
|
|
/**
|
|
* Handles GET /api/watch-order/:id requests. Returns recommended
|
|
* viewing order for the specified anime franchise.
|
|
*
|
|
* @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 watch order data
|
|
*
|
|
* @example
|
|
* GET /api/watch-order/12345
|
|
* Response: { success: true, results: [{ order, title, ... }] }
|
|
*
|
|
* @throws {400} If anime ID is not provided
|
|
* TIP: Useful for anime franchises with complex viewing orders
|
|
*/
|
|
const getWatchOrder = 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 = `watchorder_${id}`;
|
|
const cached = getCache(cacheKey);
|
|
if (cached) {
|
|
return res.json({ success: true, results: cached });
|
|
}
|
|
const data = await extractWatchOrder(id);
|
|
setCache(cacheKey, data, TTL.default);
|
|
res.json({ success: true, results: data });
|
|
} catch (error) {
|
|
next(error);
|
|
}
|
|
};
|
|
|
|
export { getWatchOrder };
|
|
|
|
// ══════════════════════════════════════════════════════════════ END: watchOrder.controller.js
|