@octo-cyber/quiz-engine 0.5.0

package/dist/schemas/question.schema.d.ts

@@ -0,0 +1,147 @@
+import { z } from 'zod';
+export declare const QuestionOptionSchema: z.ZodObject<{
+    key: z.ZodString;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    text?: string;
+    key?: string;
+}, {
+    text?: string;
+    key?: string;
+}>;
+export declare const CreateQuestionSchema: z.ZodObject<{
+    categoryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    type: z.ZodEnum<["SINGLE_CHOICE", "MULTIPLE_CHOICE", "TRUE_FALSE", "FILL_BLANK", "ESSAY"]>;
+    content: z.ZodString;
+    options: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text?: string;
+        key?: string;
+    }, {
+        text?: string;
+        key?: string;
+    }>, "many">>>;
+    correctAnswer: z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>;
+    explanation: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+    difficulty: z.ZodDefault<z.ZodNumber>;
+    tags: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+    defaultScore: z.ZodDefault<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    type?: "SINGLE_CHOICE" | "MULTIPLE_CHOICE" | "TRUE_FALSE" | "FILL_BLANK" | "ESSAY";
+    categoryId?: string;
+    content?: string;
+    options?: {
+        text?: string;
+        key?: string;
+    }[];
+    correctAnswer?: string | string[];
+    explanation?: string;
+    difficulty?: number;
+    tags?: string[];
+    defaultScore?: number;
+}, {
+    type?: "SINGLE_CHOICE" | "MULTIPLE_CHOICE" | "TRUE_FALSE" | "FILL_BLANK" | "ESSAY";
+    categoryId?: string;
+    content?: string;
+    options?: {
+        text?: string;
+        key?: string;
+    }[];
+    correctAnswer?: string | string[];
+    explanation?: string;
+    difficulty?: number;
+    tags?: string[];
+    defaultScore?: number;
+}>;
+export declare const UpdateQuestionSchema: z.ZodObject<{
+    categoryId: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    type: z.ZodOptional<z.ZodEnum<["SINGLE_CHOICE", "MULTIPLE_CHOICE", "TRUE_FALSE", "FILL_BLANK", "ESSAY"]>>;
+    content: z.ZodOptional<z.ZodString>;
+    options: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodObject<{
+        key: z.ZodString;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        text?: string;
+        key?: string;
+    }, {
+        text?: string;
+        key?: string;
+    }>, "many">>>>;
+    correctAnswer: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodUnion<[z.ZodString, z.ZodArray<z.ZodString, "many">]>>>>;
+    explanation: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodString>>>;
+    difficulty: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    tags: z.ZodOptional<z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>>;
+    defaultScore: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    type?: "SINGLE_CHOICE" | "MULTIPLE_CHOICE" | "TRUE_FALSE" | "FILL_BLANK" | "ESSAY";
+    categoryId?: string;
+    content?: string;
+    options?: {
+        text?: string;
+        key?: string;
+    }[];
+    correctAnswer?: string | string[];
+    explanation?: string;
+    difficulty?: number;
+    tags?: string[];
+    defaultScore?: number;
+}, {
+    type?: "SINGLE_CHOICE" | "MULTIPLE_CHOICE" | "TRUE_FALSE" | "FILL_BLANK" | "ESSAY";
+    categoryId?: string;
+    content?: string;
+    options?: {
+        text?: string;
+        key?: string;
+    }[];
+    correctAnswer?: string | string[];
+    explanation?: string;
+    difficulty?: number;
+    tags?: string[];
+    defaultScore?: number;
+}>;
+export declare const SmartGenerateSchema: z.ZodObject<{
+    paperId: z.ZodString;
+    rules: z.ZodArray<z.ZodObject<{
+        categoryId: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        type: z.ZodOptional<z.ZodEnum<["SINGLE_CHOICE", "MULTIPLE_CHOICE", "TRUE_FALSE", "FILL_BLANK", "ESSAY"]>>;
+        difficulty: z.ZodOptional<z.ZodNumber>;
+        count: z.ZodNumber;
+        scorePerQuestion: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        type?: "SINGLE_CHOICE" | "MULTIPLE_CHOICE" | "TRUE_FALSE" | "FILL_BLANK" | "ESSAY";
+        categoryId?: string;
+        difficulty?: number;
+        count?: number;
+        scorePerQuestion?: number;
+    }, {
+        type?: "SINGLE_CHOICE" | "MULTIPLE_CHOICE" | "TRUE_FALSE" | "FILL_BLANK" | "ESSAY";
+        categoryId?: string;
+        difficulty?: number;
+        count?: number;
+        scorePerQuestion?: number;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    paperId?: string;
+    rules?: {
+        type?: "SINGLE_CHOICE" | "MULTIPLE_CHOICE" | "TRUE_FALSE" | "FILL_BLANK" | "ESSAY";
+        categoryId?: string;
+        difficulty?: number;
+        count?: number;
+        scorePerQuestion?: number;
+    }[];
+}, {
+    paperId?: string;
+    rules?: {
+        type?: "SINGLE_CHOICE" | "MULTIPLE_CHOICE" | "TRUE_FALSE" | "FILL_BLANK" | "ESSAY";
+        categoryId?: string;
+        difficulty?: number;
+        count?: number;
+        scorePerQuestion?: number;
+    }[];
+}>;
+export type CreateQuestionDto = z.infer<typeof CreateQuestionSchema>;
+export type UpdateQuestionDto = z.infer<typeof UpdateQuestionSchema>;
+export type SmartGenerateDto = z.infer<typeof SmartGenerateSchema>;
+//# sourceMappingURL=question.schema.d.ts.map

package/dist/schemas/question.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.schema.d.ts","sourceRoot":"","sources":["../../src/schemas/question.schema.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,oBAAoB;;;;;;;;;EAG/B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAU/B,CAAC;AAEH,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAAiC,CAAC;AAEnE,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAS9B,CAAC;AAEH,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACrE,MAAM,MAAM,iBAAiB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AACrE,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC"}

package/dist/schemas/question.schema.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SmartGenerateSchema = exports.UpdateQuestionSchema = exports.CreateQuestionSchema = exports.QuestionOptionSchema = void 0;
+const zod_1 = require("zod");
+const quiz_question_entity_js_1 = require("../entities/quiz-question.entity.js");
+exports.QuestionOptionSchema = zod_1.z.object({
+    key: zod_1.z.string().min(1).max(8),
+    text: zod_1.z.string().min(1),
+});
+exports.CreateQuestionSchema = zod_1.z.object({
+    categoryId: zod_1.z.string().uuid().nullable().optional(),
+    type: zod_1.z.enum(quiz_question_entity_js_1.QUESTION_TYPES),
+    content: zod_1.z.string().min(1),
+    options: zod_1.z.array(exports.QuestionOptionSchema).nullable().optional(),
+    correctAnswer: zod_1.z.union([zod_1.z.string(), zod_1.z.array(zod_1.z.string())]).nullable().optional(),
+    explanation: zod_1.z.string().nullable().optional(),
+    difficulty: zod_1.z.number().int().min(1).max(5).default(3),
+    tags: zod_1.z.array(zod_1.z.string()).nullable().optional(),
+    defaultScore: zod_1.z.number().min(0).default(1),
+});
+exports.UpdateQuestionSchema = exports.CreateQuestionSchema.partial();
+exports.SmartGenerateSchema = zod_1.z.object({
+    paperId: zod_1.z.string().uuid(),
+    rules: zod_1.z.array(zod_1.z.object({
+        categoryId: zod_1.z.string().uuid().nullable().optional(),
+        type: zod_1.z.enum(quiz_question_entity_js_1.QUESTION_TYPES).optional(),
+        difficulty: zod_1.z.number().int().min(1).max(5).optional(),
+        count: zod_1.z.number().int().min(1).max(100),
+        scorePerQuestion: zod_1.z.number().min(0).optional(),
+    })).min(1),
+});
+//# sourceMappingURL=question.schema.js.map

package/dist/schemas/question.schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"question.schema.js","sourceRoot":"","sources":["../../src/schemas/question.schema.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AACxB,iFAAqE;AAExD,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7B,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;CACxB,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC3C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACnD,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAc,CAAC;IAC5B,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,OAAO,EAAE,OAAC,CAAC,KAAK,CAAC,4BAAoB,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC5D,aAAa,EAAE,OAAC,CAAC,KAAK,CAAC,CAAC,OAAC,CAAC,MAAM,EAAE,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC/E,WAAW,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;IACrD,IAAI,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC/C,YAAY,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC;CAC3C,CAAC,CAAC;AAEU,QAAA,oBAAoB,GAAG,4BAAoB,CAAC,OAAO,EAAE,CAAC;AAEtD,QAAA,mBAAmB,GAAG,OAAC,CAAC,MAAM,CAAC;IAC1C,OAAO,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE;IAC1B,KAAK,EAAE,OAAC,CAAC,KAAK,CAAC,OAAC,CAAC,MAAM,CAAC;QACtB,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;QACnD,IAAI,EAAE,OAAC,CAAC,IAAI,CAAC,wCAAc,CAAC,CAAC,QAAQ,EAAE;QACvC,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;QACrD,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;QACvC,gBAAgB,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;KAC/C,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACX,CAAC,CAAC"}

package/dist/services/attempt.service.d.ts

@@ -0,0 +1,33 @@
+import { QuizAttempt } from '../entities/quiz-attempt.entity.js';
+import { QuizAnswer } from '../entities/quiz-answer.entity.js';
+import { QuizQuestion } from '../entities/quiz-question.entity.js';
+import type { SubmitAnswersDto } from '../schemas/attempt.schema.js';
+export interface AttemptDetail {
+    attempt: QuizAttempt;
+    answers: Array<QuizAnswer & {
+        questionDetail: QuizQuestion;
+    }>;
+}
+export declare class AttemptService {
+    private attemptRepo;
+    private answerRepo;
+    private examRepo;
+    private pqRepo;
+    private questionRepo;
+    private initialized;
+    initialize(): void;
+    private ensureInitialized;
+    startAttempt(examId: string, userId: string): Promise<QuizAttempt>;
+    submitAttempt(attemptId: string, userId: string, dto: SubmitAnswersDto): Promise<QuizAttempt>;
+    findAttemptsByExam(examId: string, page: number, pageSize: number): Promise<{
+        items: QuizAttempt[];
+        total: number;
+    }>;
+    findAttemptsByUser(userId: string, page: number, pageSize: number): Promise<{
+        items: QuizAttempt[];
+        total: number;
+    }>;
+    findAttemptDetail(attemptId: string): Promise<AttemptDetail>;
+    private autoGrade;
+}
+//# sourceMappingURL=attempt.service.d.ts.map

package/dist/services/attempt.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.service.d.ts","sourceRoot":"","sources":["../../src/services/attempt.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,oCAAoC,CAAC;AACjE,OAAO,EAAE,UAAU,EAAE,MAAM,mCAAmC,CAAC;AAG/D,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AAEnE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAErE,MAAM,WAAW,aAAa;IAC5B,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,KAAK,CAAC,UAAU,GAAG;QAAE,cAAc,EAAE,YAAY,CAAA;KAAE,CAAC,CAAC;CAC/D;AAED,qBACa,cAAc;IACzB,OAAO,CAAC,WAAW,CAA2B;IAC9C,OAAO,CAAC,UAAU,CAA0B;IAC5C,OAAO,CAAC,QAAQ,CAAwB;IACxC,OAAO,CAAC,MAAM,CAAiC;IAC/C,OAAO,CAAC,YAAY,CAA4B;IAChD,OAAO,CAAC,WAAW,CAAS;IAE5B,UAAU,IAAI,IAAI;IAUlB,OAAO,CAAC,iBAAiB;IAQnB,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC;IAsClE,aAAa,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,gBAAgB,GAAG,OAAO,CAAC,WAAW,CAAC;IAwD7F,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAWpH,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAWpH,iBAAiB,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAwBlE,OAAO,CAAC,SAAS;CA6BlB"}

package/dist/services/attempt.service.js

@@ -0,0 +1,197 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AttemptService = void 0;
+const core_1 = require("@octo-cyber/core");
+const quiz_attempt_entity_js_1 = require("../entities/quiz-attempt.entity.js");
+const quiz_answer_entity_js_1 = require("../entities/quiz-answer.entity.js");
+const quiz_exam_entity_js_1 = require("../entities/quiz-exam.entity.js");
+const quiz_paper_question_entity_js_1 = require("../entities/quiz-paper-question.entity.js");
+const quiz_question_entity_js_1 = require("../entities/quiz-question.entity.js");
+let AttemptService = class AttemptService {
+    attemptRepo;
+    answerRepo;
+    examRepo;
+    pqRepo;
+    questionRepo;
+    initialized = false;
+    initialize() {
+        const db = core_1.Container.get(core_1.DatabaseService);
+        this.attemptRepo = db.getRepository(quiz_attempt_entity_js_1.QuizAttempt);
+        this.answerRepo = db.getRepository(quiz_answer_entity_js_1.QuizAnswer);
+        this.examRepo = db.getRepository(quiz_exam_entity_js_1.QuizExam);
+        this.pqRepo = db.getRepository(quiz_paper_question_entity_js_1.QuizPaperQuestion);
+        this.questionRepo = db.getRepository(quiz_question_entity_js_1.QuizQuestion);
+        this.initialized = true;
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            try {
+                this.initialize();
+            }
+            catch {
+                throw new core_1.AppError('AttemptService not initialized', 500);
+            }
+        }
+    }
+    async startAttempt(examId, userId) {
+        this.ensureInitialized();
+        const exam = await this.examRepo.findOne({ where: { id: examId } });
+        if (!exam)
+            throw core_1.AppError.notFound('Exam not found');
+        if (exam.status === 'CANCELLED')
+            throw core_1.AppError.badRequest('Exam is cancelled');
+        if (exam.status === 'ENDED')
+            throw core_1.AppError.badRequest('Exam has ended');
+        const now = new Date();
+        if (exam.startTime && now < exam.startTime) {
+            throw core_1.AppError.badRequest('Exam has not started yet');
+        }
+        if (exam.endTime && now > exam.endTime) {
+            throw core_1.AppError.badRequest('Exam has already ended');
+        }
+        if (exam.maxAttempts > 0) {
+            const count = await this.attemptRepo.count({ where: { examId, userId } });
+            if (count >= exam.maxAttempts) {
+                throw core_1.AppError.badRequest(`Max attempts (${exam.maxAttempts}) reached`);
+            }
+        }
+        const inProgress = await this.attemptRepo.findOne({
+            where: { examId, userId, status: 'IN_PROGRESS' },
+        });
+        if (inProgress)
+            return inProgress;
+        const attempt = this.attemptRepo.create({
+            examId,
+            userId,
+            startedAt: now,
+            status: 'IN_PROGRESS',
+        });
+        const saved = await this.attemptRepo.save(attempt);
+        core_1.Container.get(core_1.LoggerService).info(`[AttemptService] Started attempt: ${saved.id}`);
+        return saved;
+    }
+    async submitAttempt(attemptId, userId, dto) {
+        this.ensureInitialized();
+        const attempt = await this.attemptRepo.findOne({ where: { id: attemptId, userId } });
+        if (!attempt)
+            throw core_1.AppError.notFound('Attempt not found');
+        if (attempt.status !== 'IN_PROGRESS') {
+            throw core_1.AppError.badRequest('Attempt is not in progress');
+        }
+        const exam = await this.examRepo.findOne({ where: { id: attempt.examId } });
+        if (!exam)
+            throw core_1.AppError.notFound('Exam not found');
+        const pqs = await this.pqRepo.find({ where: { paperId: exam.paperId } });
+        const qIds = pqs.map((pq) => pq.questionId);
+        const questions = await this.questionRepo.createQueryBuilder('q')
+            .where('q.id IN (:...ids)', { ids: qIds })
+            .getMany();
+        const questionMap = new Map(questions.map((q) => [q.id, q]));
+        const scoreMap = new Map(pqs.map((pq) => [pq.questionId, pq.score]));
+        let totalScore = 0;
+        for (const ans of dto.answers) {
+            const question = questionMap.get(ans.questionId);
+            if (!question)
+                continue;
+            const maxScore = scoreMap.get(ans.questionId) ?? question.defaultScore;
+            const { isCorrect, score } = this.autoGrade(question, ans.userAnswer, maxScore);
+            const answer = this.answerRepo.create({
+                attemptId,
+                questionId: ans.questionId,
+                userAnswer: ans.userAnswer != null ? JSON.stringify(ans.userAnswer) : null,
+                isCorrect,
+                score,
+            });
+            await this.answerRepo.save(answer);
+            totalScore += score;
+        }
+        attempt.status = 'SUBMITTED';
+        attempt.submittedAt = new Date();
+        attempt.timeUsedSeconds = dto.timeUsedSeconds ?? 0;
+        attempt.totalScore = totalScore;
+        const hasPendingSubjective = dto.answers.some((ans) => {
+            const q = questionMap.get(ans.questionId);
+            return q && (q.type === 'ESSAY' || q.type === 'FILL_BLANK');
+        });
+        if (!hasPendingSubjective) {
+            attempt.status = 'GRADED';
+        }
+        const saved = await this.attemptRepo.save(attempt);
+        core_1.Container.get(core_1.LoggerService).info(`[AttemptService] Submitted attempt: ${attemptId}, score: ${totalScore}`);
+        return saved;
+    }
+    async findAttemptsByExam(examId, page, pageSize) {
+        this.ensureInitialized();
+        const [items, total] = await this.attemptRepo.findAndCount({
+            where: { examId },
+            order: { createdAt: 'DESC' },
+            skip: (page - 1) * pageSize,
+            take: pageSize,
+        });
+        return { items, total };
+    }
+    async findAttemptsByUser(userId, page, pageSize) {
+        this.ensureInitialized();
+        const [items, total] = await this.attemptRepo.findAndCount({
+            where: { userId },
+            order: { createdAt: 'DESC' },
+            skip: (page - 1) * pageSize,
+            take: pageSize,
+        });
+        return { items, total };
+    }
+    async findAttemptDetail(attemptId) {
+        this.ensureInitialized();
+        const attempt = await this.attemptRepo.findOne({ where: { id: attemptId } });
+        if (!attempt)
+            throw core_1.AppError.notFound('Attempt not found');
+        const answers = await this.answerRepo.find({ where: { attemptId } });
+        const qIds = answers.map((a) => a.questionId);
+        const questionMap = new Map();
+        if (qIds.length > 0) {
+            const questions = await this.questionRepo.createQueryBuilder('q')
+                .where('q.id IN (:...ids)', { ids: qIds })
+                .getMany();
+            questions.forEach((q) => questionMap.set(q.id, q));
+        }
+        const detailedAnswers = answers.map((a) => ({
+            ...a,
+            questionDetail: questionMap.get(a.questionId),
+        }));
+        return { attempt, answers: detailedAnswers };
+    }
+    autoGrade(question, userAnswer, maxScore) {
+        if (question.type === 'ESSAY' || question.type === 'FILL_BLANK') {
+            return { isCorrect: null, score: 0 };
+        }
+        if (!question.correctAnswer || userAnswer == null) {
+            return { isCorrect: false, score: 0 };
+        }
+        let correct;
+        try {
+            correct = JSON.parse(question.correctAnswer);
+        }
+        catch {
+            return { isCorrect: false, score: 0 };
+        }
+        const userStr = Array.isArray(userAnswer)
+            ? [...userAnswer].sort().join(',')
+            : String(userAnswer).toLowerCase();
+        const correctStr = Array.isArray(correct)
+            ? [...correct].sort().join(',')
+            : String(correct).toLowerCase();
+        const isCorrect = userStr === correctStr;
+        return { isCorrect, score: isCorrect ? maxScore : 0 };
+    }
+};
+exports.AttemptService = AttemptService;
+exports.AttemptService = AttemptService = __decorate([
+    (0, core_1.Service)()
+], AttemptService);
+//# sourceMappingURL=attempt.service.js.map

package/dist/services/attempt.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"attempt.service.js","sourceRoot":"","sources":["../../src/services/attempt.service.ts"],"names":[],"mappings":"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"}

package/dist/services/category.service.d.ts

@@ -0,0 +1,14 @@
+import { QuizCategory } from '../entities/quiz-category.entity.js';
+import type { CreateCategoryDto, UpdateCategoryDto } from '../schemas/category.schema.js';
+export declare class CategoryService {
+    private repo;
+    private initialized;
+    initialize(): void;
+    private ensureInitialized;
+    findAll(): Promise<QuizCategory[]>;
+    findById(id: string): Promise<QuizCategory>;
+    create(dto: CreateCategoryDto): Promise<QuizCategory>;
+    update(id: string, dto: UpdateCategoryDto): Promise<QuizCategory>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=category.service.d.ts.map

package/dist/services/category.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.service.d.ts","sourceRoot":"","sources":["../../src/services/category.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACnE,OAAO,KAAK,EAAE,iBAAiB,EAAE,iBAAiB,EAAE,MAAM,+BAA+B,CAAC;AAE1F,qBACa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAA4B;IACxC,OAAO,CAAC,WAAW,CAAS;IAE5B,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,iBAAiB;IAQnB,OAAO,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAKlC,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAO3C,MAAM,CAAC,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAarD,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,CAAC;IAQjE,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOxC"}

package/dist/services/category.service.js

@@ -0,0 +1,74 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CategoryService = void 0;
+const core_1 = require("@octo-cyber/core");
+const quiz_category_entity_js_1 = require("../entities/quiz-category.entity.js");
+let CategoryService = class CategoryService {
+    repo;
+    initialized = false;
+    initialize() {
+        const db = core_1.Container.get(core_1.DatabaseService);
+        this.repo = db.getRepository(quiz_category_entity_js_1.QuizCategory);
+        this.initialized = true;
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            try {
+                this.initialize();
+            }
+            catch {
+                throw new core_1.AppError('CategoryService not initialized', 500);
+            }
+        }
+    }
+    async findAll() {
+        this.ensureInitialized();
+        return this.repo.find({ order: { sortOrder: 'ASC', name: 'ASC' } });
+    }
+    async findById(id) {
+        this.ensureInitialized();
+        const entity = await this.repo.findOne({ where: { id } });
+        if (!entity)
+            throw core_1.AppError.notFound('Category not found');
+        return entity;
+    }
+    async create(dto) {
+        this.ensureInitialized();
+        const entity = this.repo.create({
+            name: dto.name,
+            parentId: dto.parentId ?? null,
+            description: dto.description ?? null,
+            sortOrder: dto.sortOrder ?? 0,
+        });
+        const saved = await this.repo.save(entity);
+        core_1.Container.get(core_1.LoggerService).info(`[CategoryService] Created category: ${saved.id}`);
+        return saved;
+    }
+    async update(id, dto) {
+        this.ensureInitialized();
+        const existing = await this.repo.findOne({ where: { id } });
+        if (!existing)
+            throw core_1.AppError.notFound('Category not found');
+        Object.assign(existing, dto);
+        return this.repo.save(existing);
+    }
+    async delete(id) {
+        this.ensureInitialized();
+        const existing = await this.repo.findOne({ where: { id } });
+        if (!existing)
+            throw core_1.AppError.notFound('Category not found');
+        await this.repo.remove(existing);
+        core_1.Container.get(core_1.LoggerService).info(`[CategoryService] Deleted category: ${id}`);
+    }
+};
+exports.CategoryService = CategoryService;
+exports.CategoryService = CategoryService = __decorate([
+    (0, core_1.Service)()
+], CategoryService);
+//# sourceMappingURL=category.service.js.map

package/dist/services/category.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"category.service.js","sourceRoot":"","sources":["../../src/services/category.service.ts"],"names":[],"mappings":"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"}

package/dist/services/exam.service.d.ts

@@ -0,0 +1,17 @@
+import { QuizExam } from '../entities/quiz-exam.entity.js';
+import type { CreateExamDto, UpdateExamDto } from '../schemas/exam.schema.js';
+export declare class ExamService {
+    private repo;
+    private initialized;
+    initialize(): void;
+    private ensureInitialized;
+    findAll(page: number, pageSize: number): Promise<{
+        items: QuizExam[];
+        total: number;
+    }>;
+    findById(id: string): Promise<QuizExam>;
+    create(dto: CreateExamDto, userId?: string): Promise<QuizExam>;
+    update(id: string, dto: UpdateExamDto): Promise<QuizExam>;
+    delete(id: string): Promise<void>;
+}
+//# sourceMappingURL=exam.service.d.ts.map

package/dist/services/exam.service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"exam.service.d.ts","sourceRoot":"","sources":["../../src/services/exam.service.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,iCAAiC,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE9E,qBACa,WAAW;IACtB,OAAO,CAAC,IAAI,CAAwB;IACpC,OAAO,CAAC,WAAW,CAAS;IAE5B,UAAU,IAAI,IAAI;IAMlB,OAAO,CAAC,iBAAiB;IAQnB,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAUtF,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAOvC,MAAM,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC;IAmB9D,MAAM,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,aAAa,GAAG,OAAO,CAAC,QAAQ,CAAC;IAezD,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAOxC"}

package/dist/services/exam.service.js

@@ -0,0 +1,92 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ExamService = void 0;
+const core_1 = require("@octo-cyber/core");
+const quiz_exam_entity_js_1 = require("../entities/quiz-exam.entity.js");
+let ExamService = class ExamService {
+    repo;
+    initialized = false;
+    initialize() {
+        const db = core_1.Container.get(core_1.DatabaseService);
+        this.repo = db.getRepository(quiz_exam_entity_js_1.QuizExam);
+        this.initialized = true;
+    }
+    ensureInitialized() {
+        if (!this.initialized) {
+            try {
+                this.initialize();
+            }
+            catch {
+                throw new core_1.AppError('ExamService not initialized', 500);
+            }
+        }
+    }
+    async findAll(page, pageSize) {
+        this.ensureInitialized();
+        const [items, total] = await this.repo.findAndCount({
+            order: { createdAt: 'DESC' },
+            skip: (page - 1) * pageSize,
+            take: pageSize,
+        });
+        return { items, total };
+    }
+    async findById(id) {
+        this.ensureInitialized();
+        const entity = await this.repo.findOne({ where: { id } });
+        if (!entity)
+            throw core_1.AppError.notFound('Exam not found');
+        return entity;
+    }
+    async create(dto, userId) {
+        this.ensureInitialized();
+        const entity = this.repo.create({
+            title: dto.title,
+            paperId: dto.paperId,
+            description: dto.description ?? null,
+            startTime: dto.startTime ? new Date(dto.startTime) : null,
+            endTime: dto.endTime ? new Date(dto.endTime) : null,
+            maxAttempts: dto.maxAttempts ?? 1,
+            shuffleQuestions: dto.shuffleQuestions ?? false,
+            shuffleOptions: dto.shuffleOptions ?? false,
+            showAnswerAfterSubmit: dto.showAnswerAfterSubmit ?? false,
+            createdBy: userId ?? null,
+        });
+        const saved = await this.repo.save(entity);
+        core_1.Container.get(core_1.LoggerService).info(`[ExamService] Created exam: ${saved.id}`);
+        return saved;
+    }
+    async update(id, dto) {
+        this.ensureInitialized();
+        const existing = await this.repo.findOne({ where: { id } });
+        if (!existing)
+            throw core_1.AppError.notFound('Exam not found');
+        if (dto.startTime !== undefined) {
+            existing['startTime'] = dto.startTime ? new Date(dto.startTime) : null;
+        }
+        if (dto.endTime !== undefined) {
+            existing['endTime'] = dto.endTime ? new Date(dto.endTime) : null;
+        }
+        const { startTime: _s, endTime: _e, ...rest } = dto;
+        Object.assign(existing, rest);
+        return this.repo.save(existing);
+    }
+    async delete(id) {
+        this.ensureInitialized();
+        const existing = await this.repo.findOne({ where: { id } });
+        if (!existing)
+            throw core_1.AppError.notFound('Exam not found');
+        await this.repo.remove(existing);
+        core_1.Container.get(core_1.LoggerService).info(`[ExamService] Deleted exam: ${id}`);
+    }
+};
+exports.ExamService = ExamService;
+exports.ExamService = ExamService = __decorate([
+    (0, core_1.Service)()
+], ExamService);
+//# sourceMappingURL=exam.service.js.map