mcp-quiz-server
Version:
🧠AI-Powered Quiz Management via Model Context Protocol (MCP) - Create, manage, and take quizzes directly from VS Code, Claude, and other AI agents.
142 lines (140 loc) • 5.34 kB
JavaScript
;
/**
* @fileoverview Quiz Start Routes - Direct quiz start functionality
* @version 1.0.0
* @since 2025-08-04
* @module QuizStartRoutes
* @description Handles direct quiz start URLs that bypass modal and begin quiz immediately
* @contributors GitHub Copilot
* @requirements REQ_ROUTES_001
* @lineCount < 200
*/
var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
var desc = Object.getOwnPropertyDescriptor(m, k);
if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
desc = { enumerable: true, get: function() { return m[k]; } };
}
Object.defineProperty(o, k2, desc);
}) : (function(o, m, k, k2) {
if (k2 === undefined) k2 = k;
o[k2] = m[k];
}));
var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
Object.defineProperty(o, "default", { enumerable: true, value: v });
}) : function(o, v) {
o["default"] = v;
});
var __importStar = (this && this.__importStar) || (function () {
var ownKeys = function(o) {
ownKeys = Object.getOwnPropertyNames || function (o) {
var ar = [];
for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
return ar;
};
return ownKeys(o);
};
return function (mod) {
if (mod && mod.__esModule) return mod;
var result = {};
if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
__setModuleDefault(result, mod);
return result;
};
})();
Object.defineProperty(exports, "__esModule", { value: true });
exports.createQuizStartRoutes = createQuizStartRoutes;
const express = __importStar(require("express"));
const error_handler_1 = require("../../../../shared/error-handler");
const html_generator_1 = require("../utils/html-generator");
/**
* Creates quiz start routes for direct quiz launching
*
* @param config Configuration object
* @returns Express router for quiz start functionality
*/
function createQuizStartRoutes(config) {
const router = express.Router();
/**
* Direct Quiz Start Route
* GET /start/:id
*
* Bypasses modal and starts quiz immediately with embedded quiz data
*/
router.get('/:id', (0, error_handler_1.asyncHandler)(async (req, res) => {
var _a;
try {
const quizId = req.params.id;
const autoStart = req.query.auto !== 'false';
const userType = req.query.userType || 'anonymous';
// Get quiz data through Clean Architecture
let quiz = null;
if ((_a = config.controllerFactory) === null || _a === void 0 ? void 0 : _a.hasCleanArchitecture()) {
try {
// Mock request/response for controller
const mockReq = { params: { id: quizId } };
const mockRes = {
locals: {},
json: (data) => { quiz = data; }
};
const quizController = config.controllerFactory.createQuizController();
await quizController.getQuiz(mockReq, mockRes, () => { });
quiz = mockRes.locals.quizData || quiz;
}
catch (error) {
error_handler_1.Logger.warn('Clean Architecture controller failed, quiz not available', { quizId, error });
}
}
if (!quiz) {
return res.status(404).send(`
<!DOCTYPE html>
<html>
<head><title>Quiz Not Found</title></head>
<body>
<h1>Quiz Not Found</h1>
<p>The quiz with ID "${quizId}" could not be found.</p>
<a href="/">Return to Home</a>
</body>
</html>
`);
}
// Generate HTML with embedded quiz data for direct start
const htmlContent = await generateQuizStartHTML(quiz, {
autoStart,
userType,
directStart: true,
skipModal: true
});
res.send(htmlContent);
}
catch (error) {
error_handler_1.Logger.error('Error in direct quiz start:', error instanceof Error ? error : new Error(String(error)));
res.status(500).send('Failed to load quiz');
}
}));
return router;
}
/**
* Generate HTML for direct quiz start
*/
async function generateQuizStartHTML(quiz, options) {
const baseHTML = await (0, html_generator_1.getBaseHTML)();
const quizScript = `
<script>
window.QUIZ_CONFIG = {
quiz: ${JSON.stringify(quiz)},
autoStart: ${options.autoStart},
userType: "${options.userType}",
directStart: true,
skipModal: true
};
// Auto-start quiz when page loads
window.addEventListener('DOMContentLoaded', () => {
if (window.QUIZ_CONFIG.autoStart && window.app?.startQuizDirectly) {
window.app.startQuizDirectly(window.QUIZ_CONFIG.quiz);
}
});
</script>
`;
return baseHTML.replace('</head>', `${quizScript}</head>`);
}