@tinyweb_dev/oe-exam-sdk 0.1.27 → 0.1.29

package/dist/shared/lib/validation/speaking-conversation.validation.js

@@ -1 +1,75 @@
-import{z as e}from"zod";export const speakingConversationFormSchema=e.object({partnerName:e.string().optional(),partnerAvatarUrl:e.string().optional(),images:e.array(e.object({id:e.string(),url:e.string(),label:e.string()})).optional().default([]),responder:e.enum(["PARTNER","STUDENT"],{message:"Vui lòng chọn người trả lời!"}),interlocutorAudioUrl:e.string().optional(),partnerAudioUrl:e.string().optional(),questionText:e.string().optional(),isBackup:e.boolean().optional().default(!1),expectedAnswers:e.array(e.string()).optional().default([""]),explanation:e.string().optional(),points:e.union([e.string(),e.number()]).transform((n,o)=>{if(""===n||null==n)return o.addIssue({code:e.ZodIssueCode.custom,message:"Vui lòng nhập điểm!"}),e.NEVER;const r="string"==typeof n?parseInt(n,10):n;return isNaN(r)?(o.addIssue({code:e.ZodIssueCode.custom,message:"Vui lòng nhập điểm hợp lệ!"}),e.NEVER):r}).pipe(e.number().min(0,"Điểm số phải >= 0"))}).superRefine((n,o)=>{"PARTNER"!==n.responder||n.partnerAudioUrl&&""!==n.partnerAudioUrl.trim()||o.addIssue({code:e.ZodIssueCode.custom,message:"Câu hỏi mẫu (Partner) cần có audio của Partner!",path:["partnerAudioUrl"]}),"STUDENT"===n.responder&&n.points<1&&o.addIssue({code:e.ZodIssueCode.custom,message:"Câu hỏi học sinh phải có điểm >= 1!",path:["points"]})});
+import { z } from 'zod';
+/**
+ * Zod validation schema for SPEAKING_CONVERSATION creator form.
+ *
+ * Key rules:
+ * - responder: 'PARTNER' → partnerAudioUrl required, points auto-set to 0
+ * - responder: 'STUDENT' → points must be >= 1
+ */
+export const speakingConversationFormSchema = z
+    .object({
+    // ─── Group Data ─────────────────────────────────────────────────────────
+    partnerName: z.string().optional(),
+    partnerAvatarUrl: z.string().optional(),
+    images: z
+        .array(z.object({
+        id: z.string(),
+        url: z.string(),
+        label: z.string(),
+    }))
+        .optional()
+        .default([]),
+    // ─── Question Content ────────────────────────────────────────────────────
+    responder: z.enum(['PARTNER', 'STUDENT'], {
+        message: 'Vui lòng chọn người trả lời!',
+    }),
+    interlocutorAudioUrl: z.string().optional(),
+    partnerAudioUrl: z.string().optional(),
+    questionText: z.string().optional(),
+    isBackup: z.boolean().optional().default(false),
+    // ─── Expected Answers ────────────────────────────────────────────────────
+    expectedAnswers: z.array(z.string()).optional().default(['']),
+    // ─── Explanation ─────────────────────────────────────────────────────────
+    explanation: z.string().optional(),
+    // ─── Points ──────────────────────────────────────────────────────────────
+    points: z
+        .union([z.string(), z.number()])
+        .transform((val, ctx) => {
+        if (val === '' || val === undefined || val === null) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm!',
+            });
+            return z.NEVER;
+        }
+        const num = typeof val === 'string' ? parseInt(val, 10) : val;
+        if (isNaN(num)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm hợp lệ!',
+            });
+            return z.NEVER;
+        }
+        return num;
+    })
+        .pipe(z.number().min(0, 'Điểm số phải >= 0')),
+})
+    .superRefine((data, ctx) => {
+    // PARTNER questions require partnerAudioUrl
+    if (data.responder === 'PARTNER' &&
+        (!data.partnerAudioUrl || data.partnerAudioUrl.trim() === '')) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Câu hỏi mẫu (Partner) cần có audio của Partner!',
+            path: ['partnerAudioUrl'],
+        });
+    }
+    // STUDENT questions require points >= 1
+    if (data.responder === 'STUDENT' && data.points < 1) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Câu hỏi học sinh phải có điểm >= 1!',
+            path: ['points'],
+        });
+    }
+});

package/dist/shared/lib/validation/speaking-describe-image.validation.js

@@ -1 +1,31 @@
-import{z as n}from"zod";export const speakingDescribeImageFormSchema=n.object({question:n.string().optional(),imageUrl:n.string().min(1,"Vui lòng upload hình ảnh!"),expectedAnswers:n.array(n.string().min(1,"Vui lòng nhập đáp án!")).min(1,"Cần tối thiểu 1 đáp án!").refine(n=>n.filter(n=>""!==n.trim()).length>=1,{message:"Cần tối thiểu 1 đáp án hợp lệ!"}),explanation:n.string().optional(),points:n.union([n.string(),n.number()]).transform((e,i)=>{if(""===e||null==e)return i.addIssue({code:n.ZodIssueCode.custom,message:"Vui lòng nhập điểm!"}),n.NEVER;const s="string"==typeof e?parseInt(e,10):e;return isNaN(s)?(i.addIssue({code:n.ZodIssueCode.custom,message:"Vui lòng nhập điểm hợp lệ!"}),n.NEVER):s}).pipe(n.number().min(1,"Điểm số phải >= 1"))});
+import { z } from 'zod';
+export const speakingDescribeImageFormSchema = z.object({
+    question: z.string().optional(),
+    imageUrl: z.string().min(1, 'Vui lòng upload hình ảnh!'),
+    expectedAnswers: z
+        .array(z.string().min(1, 'Vui lòng nhập đáp án!'))
+        .min(1, 'Cần tối thiểu 1 đáp án!')
+        .refine((options) => options.filter((opt) => opt.trim() !== '').length >= 1, { message: 'Cần tối thiểu 1 đáp án hợp lệ!' }),
+    explanation: z.string().optional(),
+    points: z
+        .union([z.string(), z.number()])
+        .transform((val, ctx) => {
+        if (val === '' || val === undefined || val === null) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm!',
+            });
+            return z.NEVER;
+        }
+        const num = typeof val === 'string' ? parseInt(val, 10) : val;
+        if (isNaN(num)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm hợp lệ!',
+            });
+            return z.NEVER;
+        }
+        return num;
+    })
+        .pipe(z.number().min(1, 'Điểm số phải >= 1')),
+});

package/dist/shared/lib/validation/spontaneous-qa.validation.js

@@ -1 +1,48 @@
-import{z as e}from"zod";export const spontaneousQAFormSchema=e.object({inputType:e.enum(["AUDIO","TEXT"],{message:"Vui lòng chọn hình thức nhập câu hỏi!"}),audioUrl:e.string().optional(),questionText:e.string().optional(),sampleAnswers:e.array(e.string()).optional().default([""]),explanation:e.string().optional(),points:e.union([e.string(),e.number()]).transform((s,n)=>{if(""===s||null==s)return n.addIssue({code:e.ZodIssueCode.custom,message:"Vui lòng nhập điểm!"}),e.NEVER;const o="string"==typeof s?parseInt(s,10):s;return isNaN(o)?(n.addIssue({code:e.ZodIssueCode.custom,message:"Vui lòng nhập điểm hợp lệ!"}),e.NEVER):o}).pipe(e.number().min(1,"Điểm số phải >= 1"))}).superRefine((s,n)=>{"AUDIO"!==s.inputType||s.audioUrl&&""!==s.audioUrl.trim()||n.addIssue({code:e.ZodIssueCode.custom,message:"Vui lòng upload file audio câu hỏi!",path:["audioUrl"]}),"TEXT"!==s.inputType||s.questionText&&""!==s.questionText.trim()||n.addIssue({code:e.ZodIssueCode.custom,message:"Vui lòng nhập nội dung câu hỏi!",path:["questionText"]})});
+import { z } from 'zod';
+export const spontaneousQAFormSchema = z
+    .object({
+    inputType: z.enum(['AUDIO', 'TEXT'], {
+        message: 'Vui lòng chọn hình thức nhập câu hỏi!',
+    }),
+    audioUrl: z.string().optional(),
+    questionText: z.string().optional(),
+    sampleAnswers: z.array(z.string()).optional().default(['']),
+    explanation: z.string().optional(),
+    points: z
+        .union([z.string(), z.number()])
+        .transform((val, ctx) => {
+        if (val === '' || val === undefined || val === null) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm!',
+            });
+            return z.NEVER;
+        }
+        const num = typeof val === 'string' ? parseInt(val, 10) : val;
+        if (isNaN(num)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm hợp lệ!',
+            });
+            return z.NEVER;
+        }
+        return num;
+    })
+        .pipe(z.number().min(1, 'Điểm số phải >= 1')),
+})
+    .superRefine((data, ctx) => {
+    if (data.inputType === 'AUDIO' && (!data.audioUrl || data.audioUrl.trim() === '')) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Vui lòng upload file audio câu hỏi!',
+            path: ['audioUrl'],
+        });
+    }
+    if (data.inputType === 'TEXT' && (!data.questionText || data.questionText.trim() === '')) {
+        ctx.addIssue({
+            code: z.ZodIssueCode.custom,
+            message: 'Vui lòng nhập nội dung câu hỏi!',
+            path: ['questionText'],
+        });
+    }
+});

package/dist/shared/lib/validation/word-fill-paragraph-default.validation.js

@@ -1 +1,38 @@
-import{z as n}from"zod";export const wordFillParagraphDefaultFormSchema=n.object({title:n.string().optional().default(""),imageUrl:n.string().optional(),paragraph:n.string().min(1,"Vui lòng nhập đoạn văn!"),answers:n.array(n.string().min(1,"Vui lòng nhập đáp án cho chỗ trống này!")).min(1,"Cần ít nhất 1 đáp án!"),exampleAnswer:n.array(n.string()).optional().default([]),caseSensitive:n.boolean().optional().default(!1),explanation:n.string().optional(),points:n.union([n.string(),n.number()]).transform((e,t)=>{if(""===e||null==e)return t.addIssue({code:n.ZodIssueCode.custom,message:"Vui lòng nhập điểm!"}),n.NEVER;const i="string"==typeof e?parseInt(e,10):e;return isNaN(i)?(t.addIssue({code:n.ZodIssueCode.custom,message:"Điểm không hợp lệ!"}),n.NEVER):i}).pipe(n.number().min(1,"Điểm phải >= 1"))});
+import { z } from 'zod';
+/**
+ * Validation schema for WORD_FILL_PARAGRAPH with DEFAULT viewMode.
+ * In DEFAULT mode, each placeholder {0}, {1}, ... gets a text input
+ * for the correct answer — no word bank, no options.
+ */
+export const wordFillParagraphDefaultFormSchema = z.object({
+    title: z.string().optional().default(''),
+    imageUrl: z.string().optional(),
+    paragraph: z.string().min(1, 'Vui lòng nhập đoạn văn!'),
+    answers: z
+        .array(z.string().min(1, 'Vui lòng nhập đáp án cho chỗ trống này!'))
+        .min(1, 'Cần ít nhất 1 đáp án!'),
+    exampleAnswer: z.array(z.string()).optional().default([]),
+    caseSensitive: z.boolean().optional().default(false),
+    explanation: z.string().optional(),
+    points: z
+        .union([z.string(), z.number()])
+        .transform((val, ctx) => {
+        if (val === '' || val === undefined || val === null) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm!',
+            });
+            return z.NEVER;
+        }
+        const num = typeof val === 'string' ? parseInt(val, 10) : val;
+        if (isNaN(num)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Điểm không hợp lệ!',
+            });
+            return z.NEVER;
+        }
+        return num;
+    })
+        .pipe(z.number().min(1, 'Điểm phải >= 1')),
+});

package/dist/shared/lib/validation/word-fill-paragraph-with-options.validation.js

@@ -1 +1,39 @@
-import{z as n}from"zod";const i=n.object({options:n.array(n.string().min(1,"Vui lòng nhập đáp án!")).min(2,"Mỗi chỗ trống cần ít nhất 2 lựa chọn!"),isExample:n.boolean().optional()});export const wordFillParagraphWithOptionsFormSchema=n.object({title:n.string().optional().default(""),imageUrl:n.string().optional(),paragraph:n.string().min(1,"Vui lòng nhập đoạn văn!"),wordBank:n.array(i).min(1,"Cần ít nhất 1 chỗ trống với lựa chọn!"),answers:n.array(n.string().min(1,"Vui lòng chọn đáp án cho chỗ trống này!")).min(1,"Cần ít nhất 1 đáp án!"),caseSensitive:n.boolean().optional().default(!1),explanation:n.string().optional(),points:n.union([n.string(),n.number()]).transform((i,t)=>{if(""===i||null==i)return t.addIssue({code:n.ZodIssueCode.custom,message:"Vui lòng nhập điểm!"}),n.NEVER;const o="string"==typeof i?parseInt(i,10):i;return isNaN(o)?(t.addIssue({code:n.ZodIssueCode.custom,message:"Điểm không hợp lệ!"}),n.NEVER):o}).pipe(n.number().min(1,"Điểm phải >= 1"))});
+import { z } from 'zod';
+const wordBankWithOptionsItemSchema = z.object({
+    options: z.array(z.string().min(1, 'Vui lòng nhập đáp án!')).min(2, 'Mỗi chỗ trống cần ít nhất 2 lựa chọn!'),
+    isExample: z.boolean().optional(),
+});
+export const wordFillParagraphWithOptionsFormSchema = z.object({
+    title: z.string().optional().default(''),
+    imageUrl: z.string().optional(),
+    paragraph: z.string().min(1, 'Vui lòng nhập đoạn văn!'),
+    wordBank: z
+        .array(wordBankWithOptionsItemSchema)
+        .min(1, 'Cần ít nhất 1 chỗ trống với lựa chọn!'),
+    answers: z
+        .array(z.string().min(1, 'Vui lòng chọn đáp án cho chỗ trống này!'))
+        .min(1, 'Cần ít nhất 1 đáp án!'),
+    caseSensitive: z.boolean().optional().default(false),
+    explanation: z.string().optional(),
+    points: z
+        .union([z.string(), z.number()])
+        .transform((val, ctx) => {
+        if (val === '' || val === undefined || val === null) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm!',
+            });
+            return z.NEVER;
+        }
+        const num = typeof val === 'string' ? parseInt(val, 10) : val;
+        if (isNaN(num)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Điểm không hợp lệ!',
+            });
+            return z.NEVER;
+        }
+        return num;
+    })
+        .pipe(z.number().min(1, 'Điểm phải >= 1')),
+});

package/dist/shared/lib/validation/word-fill-paragraph.validation.js

@@ -1 +1,43 @@
-import{z as n}from"zod";const o=n.object({word:n.string().min(1,"Vui lòng nhập từ!"),content:n.string().optional(),imageUrl:n.string().optional(),isExample:n.boolean().optional()});export const wordFillParagraphFormSchema=n.object({title:n.string().optional().default(""),imageUrl:n.string().optional(),paragraph:n.string().min(1,"Vui lòng nhập đoạn văn!"),wordBank:n.array(o).min(2,"Cần ít nhất 2 từ trong word bank!"),answers:n.array(n.string().min(1,"Vui lòng chọn đáp án cho chỗ trống này!")).min(1,"Cần ít nhất 1 đáp án!"),exampleAnswer:n.array(n.string()).optional().default([]),isExample:n.boolean().optional(),caseSensitive:n.boolean().optional().default(!1),explanation:n.string().optional(),points:n.union([n.string(),n.number()]).transform((o,t)=>{if(""===o||null==o)return t.addIssue({code:n.ZodIssueCode.custom,message:"Vui lòng nhập điểm!"}),n.NEVER;const i="string"==typeof o?parseInt(o,10):o;return isNaN(i)?(t.addIssue({code:n.ZodIssueCode.custom,message:"Điểm không hợp lệ!"}),n.NEVER):i}).pipe(n.number().min(1,"Điểm phải >= 1"))});
+import { z } from 'zod';
+const wordBankItemSchema = z.object({
+    word: z.string().min(1, 'Vui lòng nhập từ!'),
+    content: z.string().optional(),
+    imageUrl: z.string().optional(),
+    isExample: z.boolean().optional(),
+});
+export const wordFillParagraphFormSchema = z.object({
+    title: z.string().optional().default(''),
+    imageUrl: z.string().optional(),
+    paragraph: z.string().min(1, 'Vui lòng nhập đoạn văn!'),
+    wordBank: z
+        .array(wordBankItemSchema)
+        .min(2, 'Cần ít nhất 2 từ trong word bank!'),
+    answers: z
+        .array(z.string().min(1, 'Vui lòng chọn đáp án cho chỗ trống này!'))
+        .min(1, 'Cần ít nhất 1 đáp án!'),
+    exampleAnswer: z.array(z.string()).optional().default([]),
+    isExample: z.boolean().optional(),
+    caseSensitive: z.boolean().optional().default(false),
+    explanation: z.string().optional(),
+    points: z
+        .union([z.string(), z.number()])
+        .transform((val, ctx) => {
+        if (val === '' || val === undefined || val === null) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm!',
+            });
+            return z.NEVER;
+        }
+        const num = typeof val === 'string' ? parseInt(val, 10) : val;
+        if (isNaN(num)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Điểm không hợp lệ!',
+            });
+            return z.NEVER;
+        }
+        return num;
+    })
+        .pipe(z.number().min(1, 'Điểm phải >= 1')),
+});

package/dist/shared/lib/validation/word-ordering.validation.js

@@ -1 +1,33 @@
-import{z as n}from"zod";export const wordOrderingFormSchema=n.object({words:n.array(n.string().min(1,"Vui lòng nhập từ/chữ cái!")).min(2,"Cần ít nhất 2 từ/chữ cái!"),answer:n.array(n.string().min(1,"Vui lòng nhập đáp án!")).min(2,"Cần ít nhất 2 từ/chữ cái trong đáp án!"),imageUrl:n.string().optional(),isExample:n.boolean().optional(),explanation:n.string().optional(),points:n.union([n.string(),n.number()]).transform((i,o)=>{if(""===i||null==i)return o.addIssue({code:n.ZodIssueCode.custom,message:"Vui lòng nhập điểm!"}),n.NEVER;const t="string"==typeof i?parseInt(i,10):i;return isNaN(t)?(o.addIssue({code:n.ZodIssueCode.custom,message:"Điểm không hợp lệ!"}),n.NEVER):t}).pipe(n.number().min(1,"Điểm phải >= 1"))});
+import { z } from 'zod';
+export const wordOrderingFormSchema = z.object({
+    words: z
+        .array(z.string().min(1, 'Vui lòng nhập từ/chữ cái!'))
+        .min(2, 'Cần ít nhất 2 từ/chữ cái!'),
+    answer: z
+        .array(z.string().min(1, 'Vui lòng nhập đáp án!'))
+        .min(2, 'Cần ít nhất 2 từ/chữ cái trong đáp án!'),
+    imageUrl: z.string().optional(),
+    isExample: z.boolean().optional(),
+    explanation: z.string().optional(),
+    points: z
+        .union([z.string(), z.number()])
+        .transform((val, ctx) => {
+        if (val === '' || val === undefined || val === null) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Vui lòng nhập điểm!',
+            });
+            return z.NEVER;
+        }
+        const num = typeof val === 'string' ? parseInt(val, 10) : val;
+        if (isNaN(num)) {
+            ctx.addIssue({
+                code: z.ZodIssueCode.custom,
+                message: 'Điểm không hợp lệ!',
+            });
+            return z.NEVER;
+        }
+        return num;
+    })
+        .pipe(z.number().min(1, 'Điểm phải >= 1')),
+});

package/dist/shared/types/branch.types.js

@@ -1 +1,6 @@
-export{};
+/**
+ * Branch Management Types
+ * Types for branch (chi nhánh) management feature
+ * Based on API documentation: docs/api/admin/branchs/branch-management-api.md
+ */
+export {};

package/dist/shared/types/common.types.d.ts

@@ -29,7 +29,7 @@ export declare enum StudentSelectionType {
 }
 export type ResultStatus = 'PENDING' | 'PARTIAL_GRADED' | 'GRADED';
 export type StudentStatus = 'NOT_STARTED' | 'IN_PROGRESS' | 'SUBMITTED';
-export type QuestionType = 'FILL_IN_BLANK' | 'TRUE_FALSE' | 'MATCHING' | 'ORDERING' | 'LISTENING' | 'COLORING' | 'ESSAY' | 'LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE' | 'LISTEN_AND_TICK_ANSWER' | 'LISTEN_AND_FILL_NAME_NUMBER' | 'LISTENING_FILL_BLANK' | 'LISTENING_COLOR' | 'TICK_TRUE_OR_FALSE' | 'TICK_YES_OR_NO' | 'READING_TICK_CROSS' | 'ARRANGE_LETTERS_INTO_WORDS' | 'READ_PASSAGE_AND_COMPLETE_STORY' | 'CLOZE_TEST_WITH_TICK_BOX' | 'READ_AND_CHOOSE_APPROPRIATE_WORD' | 'WRITE_SHORT_PARAGRAPH' | 'LABEL_THE_PICTURE' | 'READING_LETTER_ARRANGE' | 'READING_PASSAGE_FILL' | 'FILL_BLANK' | 'FILL_MISSING_WORDS_IN_GRID' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'LABEL_THE_PICTURE' | 'READ_AND_COLOR_OBJECTS' | 'IMAGE_OBJECT_MATCHING' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'TRUE_FALSE_GROUP' | 'CROSS_OUT_WORD_GROUP' | 'WRITE_A_SHORT_LETTER' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_CORRECT_ADJECTIVE' | 'ANSWER_THE_QUESTION' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | 'WRITE_SENTENCES' | 'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP' | 'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD' | 'WORD_FILL_STRUCTURED_FORM';
+export type QuestionType = 'FILL_IN_BLANK' | 'TRUE_FALSE' | 'MATCHING' | 'ORDERING' | 'LISTENING' | 'COLORING' | 'ESSAY' | 'LISTEN_AND_FILL_IN_THE_BLANK_WITH_IMAGE' | 'LISTEN_AND_TICK_ANSWER' | 'LISTEN_AND_FILL_NAME_NUMBER' | 'LISTENING_FILL_BLANK' | 'LISTENING_COLOR' | 'TICK_TRUE_OR_FALSE' | 'TICK_YES_OR_NO' | 'READING_TICK_CROSS' | 'ARRANGE_LETTERS_INTO_WORDS' | 'READ_PASSAGE_AND_COMPLETE_STORY' | 'CLOZE_TEST_WITH_TICK_BOX' | 'READ_AND_CHOOSE_APPROPRIATE_WORD' | 'WRITE_SHORT_PARAGRAPH' | 'LABEL_THE_PICTURE' | 'READING_LETTER_ARRANGE' | 'READING_PASSAGE_FILL' | 'FILL_BLANK' | 'FILL_MISSING_WORDS_IN_GRID' | 'LOOK_PICTURE_CHOOSE_CORRECT_ANSWER' | 'LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER' | 'LOOK_PICTURE_FILL_WORD_HINT' | 'LABEL_THE_PICTURE' | 'READ_AND_COLOR_OBJECTS' | 'IMAGE_OBJECT_MATCHING' | 'READ_PASSAGE_AND_ANSWER_QUESTIONS' | 'CHOOSE_THE_CORRECT_ANSWER' | 'CHOOSE_THE_CORRECT_ANSWER_GROUP' | 'TRUE_FALSE_GROUP' | 'CROSS_OUT_WORD_GROUP' | 'SPONTANEOUS_QA_GROUP' | 'WORD_ORDER_AND_MATCH_GROUP' | 'WRITE_A_SHORT_LETTER' | 'WRITE_CORRECT_VERB_FORM' | 'CHOOSE_CORRECT_ADJECTIVE' | 'ANSWER_THE_QUESTION' | 'WORD_ORDERING' | 'WORD_FILL_PARAGRAPH' | 'MATCH_BY_WRITING_ANSWER' | 'WRITE_SENTENCES' | 'LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP' | 'LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE' | 'LISTEN_AND_DRAG_OBJECTS_INTO_SCENE' | 'LISTEN_AND_SPEAK_ANSWER' | 'LISTEN_AND_SPEAK_IMAGE_GROUP' | 'LISTEN_AND_SPEAK_QUESTION_LIST' | 'LISTEN_AND_SPEAK_COMPARE_IMAGES' | 'LISTEN_AND_SPEAK_WITH_STORY_IMAGES' | 'LISTEN_AND_SPEAK_ODD_ONE_OUT' | 'LISTEN_AND_SPEAK_INFO_EXCHANGE' | 'READ_DISPLAYED_CONTENT' | 'SPEAKING_DESCRIBE_IMAGE' | 'SPONTANEOUS_QA' | 'SPEAKING_CONVERSATION' | 'GN_SPEAKING_INTERVIEW' | 'SPEAKING_CUE_CARD' | 'WORD_FILL_STRUCTURED_FORM';
 export type Level = 'Pre-A1' | 'A1' | 'A2' | 'B1' | 'B2' | 'C1' | 'C2';
 export type Difficulty = 'EASY' | 'MEDIUM' | 'HARD';
 export type Skill = 'LISTENING' | 'READING' | 'WRITING' | 'SPEAKING';

package/dist/shared/types/common.types.js

@@ -1 +1,49 @@
-export var UserRole;!function(E){E.SYSTEM_ADMIN="SYSTEM_ADMIN",E.ADMIN="ADMIN",E.TEACHER="TEACHER",E.STUDENT="STUDENT"}(UserRole||(UserRole={}));export var Gender;!function(E){E.MALE="male",E.FEMALE="female",E.OTHER="other"}(Gender||(Gender={}));export var RoomType;!function(E){E.CONTEST="CONTEST",E.PRACTICE_TEST="PRACTICE_TEST"}(RoomType||(RoomType={}));export var ExamRoomStatus;!function(E){E.SCHEDULED="SCHEDULED",E.IN_PROGRESS="IN_PROGRESS",E.COMPLETED="COMPLETED"}(ExamRoomStatus||(ExamRoomStatus={}));export var StudentSelectionType;!function(E){E.ALL="ALL",E.SPECIFIC="SPECIFIC"}(StudentSelectionType||(StudentSelectionType={}));export var SkillEnum;!function(E){E.LISTENING="LISTENING",E.SPEAKING="SPEAKING",E.READING="READING",E.WRITING="WRITING"}(SkillEnum||(SkillEnum={}));export var ExamTemplateTheme;!function(E){E.CAMBRIDGE_YLE="CAMBRIDGE_YLE",E.FLYER_WOODEN="FLYER_WOODEN",E.SUMMER_SKY="SUMMER_SKY",E.IELTS_LRW="IELTS_LRW"}(ExamTemplateTheme||(ExamTemplateTheme={}));
+/**
+ * Common shared types across the application
+ */
+// User role enum for role-based permissions
+export var UserRole;
+(function (UserRole) {
+    UserRole["SYSTEM_ADMIN"] = "SYSTEM_ADMIN";
+    UserRole["ADMIN"] = "ADMIN";
+    UserRole["TEACHER"] = "TEACHER";
+    UserRole["STUDENT"] = "STUDENT";
+})(UserRole || (UserRole = {}));
+export var Gender;
+(function (Gender) {
+    Gender["MALE"] = "male";
+    Gender["FEMALE"] = "female";
+    Gender["OTHER"] = "other";
+})(Gender || (Gender = {}));
+export var RoomType;
+(function (RoomType) {
+    RoomType["CONTEST"] = "CONTEST";
+    RoomType["PRACTICE_TEST"] = "PRACTICE_TEST";
+})(RoomType || (RoomType = {}));
+export var ExamRoomStatus;
+(function (ExamRoomStatus) {
+    ExamRoomStatus["SCHEDULED"] = "SCHEDULED";
+    ExamRoomStatus["IN_PROGRESS"] = "IN_PROGRESS";
+    ExamRoomStatus["COMPLETED"] = "COMPLETED";
+})(ExamRoomStatus || (ExamRoomStatus = {}));
+export var StudentSelectionType;
+(function (StudentSelectionType) {
+    StudentSelectionType["ALL"] = "ALL";
+    StudentSelectionType["SPECIFIC"] = "SPECIFIC";
+})(StudentSelectionType || (StudentSelectionType = {}));
+// Skill enum for programmatic use
+export var SkillEnum;
+(function (SkillEnum) {
+    SkillEnum["LISTENING"] = "LISTENING";
+    SkillEnum["SPEAKING"] = "SPEAKING";
+    SkillEnum["READING"] = "READING";
+    SkillEnum["WRITING"] = "WRITING";
+})(SkillEnum || (SkillEnum = {}));
+// Exam template theme enum
+export var ExamTemplateTheme;
+(function (ExamTemplateTheme) {
+    ExamTemplateTheme["CAMBRIDGE_YLE"] = "CAMBRIDGE_YLE";
+    ExamTemplateTheme["FLYER_WOODEN"] = "FLYER_WOODEN";
+    ExamTemplateTheme["SUMMER_SKY"] = "SUMMER_SKY";
+    ExamTemplateTheme["IELTS_LRW"] = "IELTS_LRW";
+})(ExamTemplateTheme || (ExamTemplateTheme = {}));

package/dist/shared/types/entities/exam-schedule.types.js

@@ -1 +1,5 @@
-export{};
+/**
+ * Exam Schedule entity types
+ * Quản lý lịch thi - Schedule cho từng kỳ thi
+ */
+export {};

package/dist/shared/types/entities/exam.types.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/shared/types/entities/question.types.js

@@ -1 +1,4 @@
-export{};
+/**
+ * Question entity types
+ */
+export {};

package/dist/shared/types/entities/result.types.js

@@ -1 +1,4 @@
-export{};
+/**
+ * Exam result entity types
+ */
+export {};

package/dist/shared/types/entities/user.types.js

@@ -1 +1,4 @@
-export{};
+/**
+ * User entity types
+ */
+export {};

package/dist/shared/types/exam-taking.types.js

@@ -1 +1,2 @@
-export{};
+// Student Exam Taking Types
+export {};

package/dist/shared/types/history.types.js

@@ -1 +1,34 @@
-export const DEFAULT_HISTORY_FILTERS={level:"ALL",skill:"ALL",testName:"",status:"ALL"};export const EXAM_LEVEL_LABELS={STARTERS:"STARTERS",MOVERS:"MOVERS",FLYERS:"FLYERS",PET:"PET",KET:"KET",TOEFL_JUNIOR:"TOEFL JUNIOR"};export const SKILL_LABELS={listening:"Listening","reading & writing":"Reading & Writing",writing:"Writing"};export const ALL_EXAM_LEVELS=["STARTERS","MOVERS","FLYERS","PET","KET","TOEFL_JUNIOR"];export const ALL_SKILLS=["listening","reading & writing","writing"];
+// Student Exam History Types
+// Default filter values
+export const DEFAULT_HISTORY_FILTERS = {
+    level: 'ALL',
+    skill: 'ALL',
+    testName: '',
+    status: 'ALL',
+};
+// Display labels for exam levels
+export const EXAM_LEVEL_LABELS = {
+    STARTERS: 'STARTERS',
+    MOVERS: 'MOVERS',
+    FLYERS: 'FLYERS',
+    PET: 'PET',
+    KET: 'KET',
+    TOEFL_JUNIOR: 'TOEFL JUNIOR',
+};
+// Display labels for skills
+export const SKILL_LABELS = {
+    listening: 'Listening',
+    'reading & writing': 'Reading & Writing',
+    writing: 'Writing',
+};
+// All exam levels for filter dropdown
+export const ALL_EXAM_LEVELS = [
+    'STARTERS',
+    'MOVERS',
+    'FLYERS',
+    'PET',
+    'KET',
+    'TOEFL_JUNIOR',
+];
+// All skills for filter dropdown
+export const ALL_SKILLS = ['listening', 'reading & writing', 'writing'];

package/dist/shared/types/index.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/shared/types/questions/choose-correct-adjective.js

@@ -1 +1,4 @@
-export{};
+/**
+ * API Payload interface for CHOOSE_CORRECT_ADJECTIVE question type
+ */
+export {};

package/dist/shared/types/questions/choose-the-correct-answer-group.d.ts

@@ -21,6 +21,7 @@ export interface ChooseTheCorrectAnswerGroupItem {
 export interface ChooseTheCorrectAnswerGroupContent {
     meta?: {
         instruction?: string;
+        passage?: string;
     };
     items: ChooseTheCorrectAnswerGroupItem[];
 }

package/dist/shared/types/questions/choose-the-correct-answer-group.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/shared/types/questions/choose-the-correct-answer.js

@@ -1 +1,9 @@
-export{};
+/**
+ * API Payload interface for CHOOSE_THE_CORRECT_ANSWER question type
+ *
+ * Used for:
+ * - API GET /manage/exams/{examId}/questions response
+ * - API POST /admin/questions/batch request/response
+ * - localStorage storage (without addToQuestionBank and questionBank)
+ */
+export {};

package/dist/shared/types/questions/cross-out-word-group.d.ts

@@ -1,6 +1,8 @@
 export type CrossOutWordItemMode = 'CROSS_OUT' | 'CROSS_OUT_AND_REPLACE';
 export interface CrossOutWordGroupItemAnswer {
     type: CrossOutWordItemMode;
+    /** 0-based word index in tokenized question. null = line is correct. */
+    wordIndex?: number | null;
     crossOut: string;
     replaceWith?: string;
 }

package/dist/shared/types/questions/cross-out-word-group.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/shared/types/questions/fill-missing-words-in-grid.js

@@ -1 +1,11 @@
-export{};
+/**
+ * FILL_MISSING_WORDS_IN_GRID Question Type Interfaces
+ *
+ * This question type displays a grid where some cells are empty (missing words)
+ * and the student needs to fill in the correct letters/words.
+ *
+ * API format (camelCase):
+ * - content: { grid, rows, columns, disabledCells }
+ * - correctAnswer: { answers, caseSensitive }
+ */
+export {};

package/dist/shared/types/questions/index.d.ts

@@ -28,3 +28,4 @@ export * from './listen-and-speak-answer';
 export * from './read-displayed-content';
 export * from './speaking-describe-image';
 export * from './spontaneous-qa';
+export * from './word-order-and-match-group';

package/dist/shared/types/questions/index.js

@@ -1 +1,46 @@
-export*from"./choose-the-correct-answer";export*from"./choose-the-correct-answer-group";export*from"./cross-out-word-group";export*from"./write-correct-verb-form";export*from"./choose-correct-adjective";export*from"./look-picture-fill-blank-choose-answer";export*from"./fill-missing-words-in-grid";export*from"./look-picture-fill-word-hint";export*from"./look-picture-choose-correct-answer";export*from"./listen-and-speak-answer";export*from"./read-displayed-content";export*from"./speaking-describe-image";export*from"./spontaneous-qa";
+/**
+ * Question Payload Types
+ *
+ * This folder contains TypeScript interfaces for each question type's API payload format.
+ * Each file corresponds to one question_type value.
+ *
+ * Usage:
+ * ```typescript
+ * import { ChooseTheCorrectAnswerAPIPayload } from '@/shared/types/question-payloads/choose-the-correct-answer';
+ * // or import all from index
+ * import { ChooseTheCorrectAnswerAPIPayload } from '@/shared/types/question-payloads';
+ * ```
+ *
+ * Format Guidelines:
+ * - API Payload: Full format sent to/from API (includes addToQuestionBank, questionBank)
+ * - LocalStorage: Same format but WITHOUT addToQuestionBank and questionBank
+ */
+// CHOOSE_THE_CORRECT_ANSWER
+export * from './choose-the-correct-answer';
+// CHOOSE_THE_CORRECT_ANSWER_GROUP
+export * from './choose-the-correct-answer-group';
+// CROSS_OUT_WORD_GROUP
+export * from './cross-out-word-group';
+// WRITE_CORRECT_VERB_FORM
+export * from './write-correct-verb-form';
+// CHOOSE_CORRECT_ADJECTIVE
+export * from './choose-correct-adjective';
+// LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER
+export * from './look-picture-fill-blank-choose-answer';
+// FILL_MISSING_WORDS_IN_GRID
+export * from './fill-missing-words-in-grid';
+// LOOK_PICTURE_FILL_WORD_HINT
+export * from './look-picture-fill-word-hint';
+// LOOK_PICTURE_CHOOSE_CORRECT_ANSWER
+export * from './look-picture-choose-correct-answer';
+// Add more question types here as they are created:
+// etc.
+export * from './listen-and-speak-answer';
+// READ_DISPLAYED_CONTENT
+export * from './read-displayed-content';
+// SPEAKING_DESCRIBE_IMAGE
+export * from './speaking-describe-image';
+// SPONTANEOUS_QA
+export * from './spontaneous-qa';
+// WORD_ORDER_AND_MATCH_GROUP
+export * from './word-order-and-match-group';

package/dist/shared/types/questions/listen-and-speak-answer.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/shared/types/questions/listen-and-speak-compare-images.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/shared/types/questions/listen-and-speak-image-group.js

@@ -1 +1 @@
-export{};
+export {};

package/dist/shared/types/questions/listen-and-speak-info-exchange.js

@@ -1 +1,3 @@
-export{};
+// API-level types for LISTEN_AND_SPEAK_INFO_EXCHANGE
+// (Flyers Part 2 - Information Exchange: 2a = ANSWER mode, 2b = ASK mode)
+export {};

package/dist/shared/types/questions/listen-and-speak-odd-one-out.js

@@ -1 +1,3 @@
-export{};
+// API-level types for LISTEN_AND_SPEAK_ODD_ONE_OUT question type
+// (Movers Part 3 - Which One Is Different? Why?)
+export {};

package/dist/shared/types/questions/listen-and-speak-question-list.js

@@ -1 +1 @@
-export{};
+export {};