Files
AniKotoAPI/src/controllers/spotlight.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

57 lines
2.2 KiB
JavaScript

/*
* ======= • ======= • ======= • ======= • =======• =======
* AniKotoAPI — spotlight.controller.js
* Repository: https://github.com/Shineii86/AniKotoAPI
*
* @description
* Controller for spotlight/featured anime carousel data.
* Returns a list of featured anime with banners and descriptions.
* No parameters required - returns fixed spotlight content.
*
* @exports
* getSpotlight - Express route handler for GET /api/spotlight
*
* @author Shinei Nouzen
* @license MIT
* ======= • ======= • ======= • ======= • =======• =======
*/
import { extractSpotlight } from "../extractors/spotlight.extractor.js";
import { getCache, setCache, TTL } from "../helper/cache.helper.js";
// ══════════════════════════════════════════════════════════════
// CONTROLLER: SPOTLIGHT
// ══════════════════════════════════════════════════════════════
// ---- FEATURE: Spotlight carousel endpoint ----
/**
* Handles GET /api/spotlight requests. Returns featured anime
* data for the homepage spotlight carousel.
*
* @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 spotlight anime list
*
* @example
* GET /api/spotlight
* Response: { success: true, results: [{ title, banner, ... }] }
*/
const getSpotlight = async (req, res, next) => {
try {
const cacheKey = "spotlight";
const cached = getCache(cacheKey);
if (cached) {
return res.json({ success: true, results: cached });
}
const data = await extractSpotlight();
setCache(cacheKey, data, TTL.spotlight);
res.json({ success: true, results: data });
} catch (error) {
next(error);
}
};
export { getSpotlight };
// ══════════════════════════════════════════════════════════════ END: spotlight.controller.js