Files
AniKotoAPI/src/controllers/topten.controller.js
T
Shinei Nouzen fe51275db0 feat: upgrade to v2.0.0 with multi-mirror fallback, new endpoints, and LRU cache
- 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
2026-07-04 15:07:07 +05:30

56 lines
2.1 KiB
JavaScript

/*
* ======= • ======= • ======= • ======= • =======• =======
* AniKotoAPI — topten.controller.js
* Repository: https://github.com/Shineii86/AniKotoAPI
*
* @description
* Controller for top 10 ranked anime. Returns the current top 10
* anime list from the source site. No parameters required.
*
* @exports
* getTopTen - Express route handler for GET /api/top-ten
*
* @author Shinei Nouzen
* @license MIT
* ======= • ======= • ======= • ======= • =======• =======
*/
import { extractTopTen } from "../extractors/topten.extractor.js";
import { getCache, setCache, TTL } from "../helper/cache.helper.js";
// ══════════════════════════════════════════════════════════════
// CONTROLLER: TOP TEN
// ══════════════════════════════════════════════════════════════
// ---- FEATURE: Top 10 anime endpoint ----
/**
* Handles GET /api/top-ten requests. Returns the current top 10
* ranked anime from the source site.
*
* @param {object} req - Express request object
* @param {object} res - Express response object
* @param {Function} next - Express next middleware function
* @returns {void} Sends JSON response with top 10 anime list
*
* @example
* GET /api/top-ten
* Response: { success: true, results: [{ rank, title, ... }] }
*/
const getTopTen = async (req, res, next) => {
try {
const cacheKey = "topTen";
const cached = getCache(cacheKey);
if (cached) {
return res.json({ success: true, results: cached });
}
const data = await extractTopTen();
setCache(cacheKey, data, TTL.default);
res.json({ success: true, results: data });
} catch (error) {
next(error);
}
};
export { getTopTen };
// ══════════════════════════════════════════════════════════════ END: topten.controller.js