@tinyweb_dev/oe-exam-sdk 0.1.28 → 0.1.30

package/dist/shared/lib/toast.js

@@ -1 +1,43 @@
-import{toast as s}from"sonner";export const toast={success:(i,r)=>s.success(i,{description:r,duration:3e3}),error:(i,r)=>s.error(i,{description:r,duration:4e3}),warning:(i,r)=>s.warning(i,{description:r,duration:3500}),info:(i,r)=>s.info(i,{description:r,duration:3e3}),loading:(i,r)=>s.loading(i,{description:r}),promise:(i,{loading:r,success:o,error:n})=>s.promise(i,{loading:r,success:o,error:n}),dismiss:i=>s.dismiss(i)};
+import { toast as sonnerToast } from 'sonner';
+// Re-export sonner toast with Vietnamese messages
+export const toast = {
+    success: (message, description) => {
+        return sonnerToast.success(message, {
+            description,
+            duration: 3000,
+        });
+    },
+    error: (message, description) => {
+        return sonnerToast.error(message, {
+            description,
+            duration: 4000,
+        });
+    },
+    warning: (message, description) => {
+        return sonnerToast.warning(message, {
+            description,
+            duration: 3500,
+        });
+    },
+    info: (message, description) => {
+        return sonnerToast.info(message, {
+            description,
+            duration: 3000,
+        });
+    },
+    loading: (message, description) => {
+        return sonnerToast.loading(message, {
+            description,
+        });
+    },
+    promise: (promise, { loading, success, error, }) => {
+        return sonnerToast.promise(promise, {
+            loading,
+            success,
+            error,
+        });
+    },
+    dismiss: (id) => {
+        return sonnerToast.dismiss(id);
+    },
+};

package/dist/shared/lib/utils/public-page.js

@@ -1 +1,44 @@
-const t=["discover","my-contests"],e=["/","/login","/register","/terms","/student/contests/discover","/upload-sheet","/result","/tra-cuu-ket-qua-oea","/placement-test"];export function isPublicOrContestPage(){if("undefined"==typeof window)return!1;const s=window.location.pathname;if(e.some(t=>s===t||"/"!==t&&s.startsWith(t+"/")))return!0;if(s.startsWith("/student/contests/")&&!t.includes(s.split("/")[3]||""))return!0;return!!(s.startsWith("/student/results/")&&s.endsWith("/review")&&window.location.search.includes("token="))}
+/** Known sub-routes under /student/contests/ that are NOT contest slugs */
+const CONTEST_KNOWN_SUBROUTES = ['discover', 'my-contests'];
+/** Static paths that are always publicly accessible (no auth required) */
+const STATIC_PUBLIC_PATHS = [
+    '/',
+    '/login',
+    '/register',
+    '/terms',
+    '/student/contests/discover',
+    '/upload-sheet',
+    '/result',
+    '/tra-cuu-ket-qua-oea',
+    '/placement-test',
+];
+/**
+ * Check if the current browser page is a public page or a contest detail page
+ * (which may be publicly accessible depending on contest visibility).
+ *
+ * Used by both the axios response interceptor and AuthSessionSync to decide
+ * whether to redirect to /login on 401 responses.
+ */
+export function isPublicOrContestPage() {
+    if (typeof window === 'undefined')
+        return false;
+    const pathname = window.location.pathname;
+    // Check static public paths
+    const isStaticPublic = STATIC_PUBLIC_PATHS.some((path) => pathname === path || (path !== '/' && pathname.startsWith(path + '/')));
+    if (isStaticPublic)
+        return true;
+    // Contest detail pages (/student/contests/[slug]) may be public depending on visibility.
+    // We can't call the API here (sync context), so we optimistically skip the redirect
+    // and let the page itself handle the "not found / not public" case.
+    const isContestDetailPage = pathname.startsWith('/student/contests/') &&
+        !CONTEST_KNOWN_SUBROUTES.includes(pathname.split('/')[3] || '');
+    if (isContestDetailPage)
+        return true;
+    // Result review pages with a token are public
+    const isPublicResultReview = pathname.startsWith('/student/results/') &&
+        pathname.endsWith('/review') &&
+        window.location.search.includes('token=');
+    if (isPublicResultReview)
+        return true;
+    return false;
+}

package/dist/shared/lib/utils/question-reverse-transform.js

@@ -1 +1,438 @@
-const e=e=>"object"==typeof e&&null!==e&&!Array.isArray(e),t=t=>e(t)?t:{},n=e=>Array.isArray(e)?e:[],o=(e,t="")=>"string"==typeof e?e:t,r=(e,t)=>"number"==typeof e&&Number.isFinite(e)?e:t,s=e=>t(e.correctAnswer??e.correct_answer),i=e=>t(e.questionGroup??e.question_group),a=e=>Number.parseFloat(String(e.total_points??e.points??1))||1,_=e=>{const t=e?.toUpperCase();return"EASY"===t||"MEDIUM"===t||"HARD"===t?t:void 0},p=e=>{const t=e?.toUpperCase();return"LISTENING"===t||"READING"===t||"WRITING"===t||"SPEAKING"===t?t:void 0},E=e=>({content:e.content,answer:s(e)}),c=e=>{const r=t(e.content),i=s(e);return{content:"",answer:{imageUrl:o(r.imageUrl),question:o(r.question),options:n(r.options).map(e=>"string"==typeof e?e:o(t(e).text)),correctAnswer:i.answer??i.correctAnswer??-1,explanation:o(e.explanation),points:a(e)}}},u=e=>{const n=t(e.content),_=s(e),p=i(e);return{content:"",answer:{...t(p.payload),...n,..._,groupNumber:r(p.groupNumber,1),explanation:o(e.explanation),points:a(e)}}},A=e=>{const n=s(e),r=t(e.content);return{content:e.content??"",answer:{...n,...r,explanation:o(e.explanation),points:a(e)}}},l={CHOOSE_THE_CORRECT_ANSWER:e=>{const r=t(e.content),i=s(e),_=i.answer??-1,p=Boolean(r.multipleAnswers??i.multipleAnswers??Array.isArray(_));return{content:"",answer:{question:o(r.question),optionType:o(r.optionType,"text"),options:n(r.options),imageUrl:o(r.imageUrl),askerName:o(r.askerName),answererName:o(r.answererName),correctAnswer:p?Array.isArray(_)?_:-1===_?[]:[_]:Array.isArray(_)?_[0]??-1:_,multipleAnswers:p,explanation:o(e.explanation),points:a(e)}}},CHOOSE_THE_CORRECT_ANSWER_GROUP:e=>{const i=t(e.content),a=s(e),_=n(a.answer).map(e=>o(e)),p=n(i.items).map((e,s)=>{const i=t(e),a=t(i.content),p=t(i.correctAnswer),E=n(a.options).map((e,n)=>{const r=t(e);return{id:o(r.id,`opt-${n+1}`),text:o(r.text)}}),c=!0===i.isExample;return{question:o(a.question),optionType:"image"===o(a.optionType,"text")?"image":"text",options:E.length>=2?E:[{id:"opt-1",text:""},{id:"opt-2",text:""},{id:"opt-3",text:""}],correctAnswer:o(p.answer)||_[s]||E[0]?.id||"opt-1",isExample:c,points:c?0:r(i.points,1),questionNumber:r(i.questionNumber,s+1)}});return{content:"",answer:{instruction:o(t(i.meta).instruction,"Choose the correct answer."),items:p,explanation:o(e.explanation),points:p.reduce((e,t)=>t.isExample?e:e+t.points,0)}}},TRUE_FALSE_GROUP:e=>{const i=t(e.content),a=s(e),_=n(a.answer),p=n(i.items).map((e,n)=>{const s=t(e),i=t(s.content),a=t(s.correctAnswer),p=!0===s.isExample,E="boolean"==typeof a.answer?a.answer:"boolean"!=typeof _[n]||_[n];return{question:o(i.question),correctAnswer:E,isExample:p,points:p?0:r(s.points,1),questionNumber:r(s.questionNumber,n+1)}});return{content:"",answer:{instruction:o(t(i.meta).instruction,"Tick True or False."),items:p,explanation:o(e.explanation),points:p.reduce((e,t)=>t.isExample?e:e+t.points,0)}}},CROSS_OUT_WORD_GROUP:e=>{const i=t(e.content),a=s(e),_=n(a.answer),p=n(i.items).map((e,n)=>{const s=t(e),i=t(s.content),a=t(t(s.correctAnswer).answer),p=t(_[n]),E=Object.keys(a).length>0?a:p,c=!0===s.isExample,u="CROSS_OUT_AND_REPLACE"===i.type||"CROSS_OUT_AND_REPLACE"===E.type?"CROSS_OUT_AND_REPLACE":"CROSS_OUT",A="CROSS_OUT_AND_REPLACE"===u?{type:"CROSS_OUT_AND_REPLACE",crossOut:o(E.crossOut),replaceWith:o(E.replaceWith)}:{type:"CROSS_OUT",crossOut:o(E.crossOut)};return{type:u,question:o(i.question),correctAnswer:A,isExample:c,points:c?0:r(s.points,1),questionNumber:r(s.questionNumber,n+1)}});return{content:"",answer:{instruction:o(t(i.meta).instruction,"Cross out the extra or incorrect word. If the word is incorrect, write the correct word. If the line is correct, leave it blank."),items:p,explanation:o(e.explanation),points:p.reduce((e,t)=>t.isExample?e:e+t.points,0)}}},LOOK_PICTURE_CHOOSE_CORRECT_ANSWER:c,LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER:c,FILL_IN_BLANK:e=>{const r=t(e.content),i=s(e),_=t(n(r.blanks)[0]);return{content:"",answer:{question:o(r.question??_.text),answers:Array.isArray(i.answers)?i.answers:[],caseSensitive:Boolean(i.caseSensitive??!1),imageUrl:o(r.imageUrl),showHints:Boolean(r.showHints??!1),hints:n(r.hints),explanation:o(e.explanation),points:a(e),blanks:n(r.blanks)}}},READ_PASSAGE_AND_ANSWER_QUESTIONS:e=>{const _=t(e.content),p=s(e),E=i(e),c=t(E.payload);return{content:"",answer:{passage:o(c.passage??_.passage),passageTitle:o(c.passageTitle??_.passageTitle),instructions:o(c.instructions??_.instructions),singleQuestion:{id:o(e.id,`question-${String(e.question_number??e.questionNumber??1)}`),question:o(_.question),options:n(_.options),correctAnswer:p.correctAnswer??p.answer??-1,points:a(e),groupNumber:r(E.groupNumber,1)}}}},LABEL_THE_PICTURE:e=>{const r=t(e.content),i=s(e),a=t(i.labels??i.answers);return{content:"",answer:{imageUrl:o(r.imageUrl),wordBank:n(r.wordBank),labels:n(r.labels).map(e=>{const n=t(e),r=o(n.id);return{...n,correctAnswer:n.correctAnswer??a[r]??""}})}}},READ_AND_COLOR_OBJECTS:u,IMAGE_OBJECT_MATCHING:u,FILL_MISSING_WORDS_IN_GRID:e=>({content:e.content??{},answer:s(e)}),LOOK_PICTURE_FILL_WORD_HINT:u,ANSWER_THE_QUESTION:u,TRUE_FALSE:A,WORD_ORDERING:A,WORD_FILL_PARAGRAPH:A,MATCH_BY_WRITING_ANSWER:u,WRITE_SENTENCES:u,WRITE_A_SHORT_LETTER:A,WRITE_CORRECT_VERB_FORM:A,CHOOSE_CORRECT_ADJECTIVE:A,WORD_FILL_STRUCTURED_FORM:u,LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP:u,LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE:u,LISTEN_AND_DRAG_OBJECTS_INTO_SCENE:u,LISTEN_AND_SPEAK_ANSWER:u,LISTEN_AND_SPEAK_IMAGE_GROUP:u,LISTEN_AND_SPEAK_QUESTION_LIST:u,LISTEN_AND_SPEAK_COMPARE_IMAGES:u,LISTEN_AND_SPEAK_WITH_STORY_IMAGES:u,LISTEN_AND_SPEAK_ODD_ONE_OUT:u,LISTEN_AND_SPEAK_INFO_EXCHANGE:u,SPEAKING_DESCRIBE_IMAGE:A,READ_DISPLAYED_CONTENT:A,SPONTANEOUS_QA:A,SPEAKING_CONVERSATION:u,SPEAKING_CUE_CARD:A,GN_SPEAKING_INTERVIEW:u};export function transformApiQuestionToFrontend(t){const n=String(t.questionType??t.question_type??t.type??""),s=(l[n]??E)(t),i=(t=>{const n=t.questionBank??t.question_bank;return e(n)?n:void 0})(t);return{id:o(t.id),type:n,content:s.content,answer:s.answer,points:a(t),level:(c=t.level,"Pre-A1"===c||"A1"===c||"A2"===c||"B1"===c||"B2"===c||"C1"===c||"C2"===c?c:void 0),difficulty:_(o(t.difficulty??t.difficult_level)),skill:p(o(t.questionSkillType??t.question_skill_type??t.skill)),explanation:o(t.explanation),partId:o(t.partId??t.part_id),questionNumber:r(t.questionNumber??t.question_number,1),isCompleted:!0,questionGroup:t.questionGroup,questionBank:i?{id:o(i.id),code:o(i.code),title:o(i.title)}:void 0};var c}export function transformApiQuestionsToFrontend(e){return e.map(transformApiQuestionToFrontend)}
+const isRecord = (value) => typeof value === 'object' && value !== null && !Array.isArray(value);
+const asRecord = (value) => isRecord(value) ? value : {};
+const asArray = (value) => Array.isArray(value) ? value : [];
+const asString = (value, fallback = '') => typeof value === 'string' ? value : fallback;
+const asNumber = (value, fallback) => typeof value === 'number' && Number.isFinite(value) ? value : fallback;
+const readAnswer = (apiQuestion) => asRecord(apiQuestion.correctAnswer ?? apiQuestion.correct_answer);
+const readQuestionGroup = (apiQuestion) => asRecord(apiQuestion.questionGroup ?? apiQuestion.question_group);
+const readQuestionBank = (apiQuestion) => {
+    const questionBank = apiQuestion.questionBank ?? apiQuestion.question_bank;
+    return isRecord(questionBank) ? questionBank : undefined;
+};
+const readPoints = (apiQuestion) => Number.parseFloat(String(apiQuestion.total_points ?? apiQuestion.points ?? 1)) || 1;
+const mapDifficulty = (value) => {
+    const normalized = value?.toUpperCase();
+    return normalized === 'EASY' || normalized === 'MEDIUM' || normalized === 'HARD' ? normalized : undefined;
+};
+const mapLevel = (value) => {
+    return value === 'Pre-A1' || value === 'A1' || value === 'A2' || value === 'B1' || value === 'B2' || value === 'C1' || value === 'C2'
+        ? value
+        : undefined;
+};
+const mapSkill = (value) => {
+    const normalized = value?.toUpperCase();
+    return normalized === 'LISTENING' || normalized === 'READING' || normalized === 'WRITING' || normalized === 'SPEAKING' ? normalized : undefined;
+};
+const defaultReverse = (apiQuestion) => ({
+    content: apiQuestion.content,
+    answer: readAnswer(apiQuestion),
+});
+const reverseChooseTheCorrectAnswer = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const rawAnswer = answer.answer ?? -1;
+    const multipleAnswers = Boolean(content.multipleAnswers ?? answer.multipleAnswers ?? Array.isArray(rawAnswer));
+    return {
+        content: '',
+        answer: {
+            question: asString(content.question),
+            optionType: asString(content.optionType, 'text'),
+            options: asArray(content.options),
+            imageUrl: asString(content.imageUrl),
+            askerName: asString(content.askerName),
+            answererName: asString(content.answererName),
+            correctAnswer: multipleAnswers ? (Array.isArray(rawAnswer) ? rawAnswer : rawAnswer === -1 ? [] : [rawAnswer]) : (Array.isArray(rawAnswer) ? rawAnswer[0] ?? -1 : rawAnswer),
+            multipleAnswers,
+            explanation: asString(apiQuestion.explanation),
+            points: readPoints(apiQuestion),
+        },
+    };
+};
+const reversePictureChoice = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    return {
+        content: '',
+        answer: {
+            imageUrl: asString(content.imageUrl),
+            question: asString(content.question),
+            options: asArray(content.options).map((option) => typeof option === 'string' ? option : asString(asRecord(option).text)),
+            correctAnswer: answer.answer ?? answer.correctAnswer ?? -1,
+            explanation: asString(apiQuestion.explanation),
+            points: readPoints(apiQuestion),
+        },
+    };
+};
+const reverseFillInBlank = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const firstBlank = asRecord(asArray(content.blanks)[0]);
+    return {
+        content: '',
+        answer: {
+            question: asString(content.question ?? firstBlank.text),
+            answers: Array.isArray(answer.answers) ? answer.answers : [],
+            caseSensitive: Boolean(answer.caseSensitive ?? false),
+            imageUrl: asString(content.imageUrl),
+            showHints: Boolean(content.showHints ?? false),
+            hints: asArray(content.hints),
+            explanation: asString(apiQuestion.explanation),
+            points: readPoints(apiQuestion),
+            blanks: asArray(content.blanks),
+        },
+    };
+};
+const reverseReadPassage = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const questionGroup = readQuestionGroup(apiQuestion);
+    const payload = asRecord(questionGroup.payload);
+    return {
+        content: '',
+        answer: {
+            passage: asString(payload.passage ?? content.passage),
+            passageTitle: asString(payload.passageTitle ?? content.passageTitle),
+            instructions: asString(payload.instructions ?? content.instructions),
+            singleQuestion: {
+                id: asString(apiQuestion.id, `question-${String(apiQuestion.question_number ?? apiQuestion.questionNumber ?? 1)}`),
+                question: asString(content.question),
+                options: asArray(content.options),
+                correctAnswer: answer.correctAnswer ?? answer.answer ?? -1,
+                points: readPoints(apiQuestion),
+                groupNumber: asNumber(questionGroup.groupNumber, 1),
+            },
+        },
+    };
+};
+const reverseLabelPicture = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const answers = asRecord(answer.labels ?? answer.answers);
+    return {
+        content: '',
+        answer: {
+            imageUrl: asString(content.imageUrl),
+            wordBank: asArray(content.wordBank),
+            labels: asArray(content.labels).map((rawLabel) => {
+                const label = asRecord(rawLabel);
+                const labelId = asString(label.id);
+                return {
+                    ...label,
+                    correctAnswer: label.correctAnswer ?? answers[labelId] ?? '',
+                };
+            }),
+        },
+    };
+};
+const reverseGrid = (apiQuestion) => ({
+    content: apiQuestion.content ?? {},
+    answer: readAnswer(apiQuestion),
+});
+const reverseGroupPayload = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const questionGroup = readQuestionGroup(apiQuestion);
+    const payload = asRecord(questionGroup.payload);
+    return {
+        content: '',
+        answer: {
+            ...payload,
+            ...content,
+            ...answer,
+            groupNumber: asNumber(questionGroup.groupNumber, 1),
+            explanation: asString(apiQuestion.explanation),
+            points: readPoints(apiQuestion),
+        },
+    };
+};
+const reverseChooseTheCorrectAnswerGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer).map((item) => asString(item));
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(item.correctAnswer);
+        const options = asArray(itemContent.options).map((rawOption, optionIndex) => {
+            const option = asRecord(rawOption);
+            return {
+                id: asString(option.id, `opt-${optionIndex + 1}`),
+                text: asString(option.text),
+            };
+        });
+        const isExample = item.isExample === true;
+        return {
+            question: asString(itemContent.question),
+            optionType: asString(itemContent.optionType, 'text') === 'image' ? 'image' : 'text',
+            options: options.length >= 2 ? options : [
+                { id: 'opt-1', text: '' },
+                { id: 'opt-2', text: '' },
+                { id: 'opt-3', text: '' },
+            ],
+            correctAnswer: asString(itemAnswer.answer) || fallbackAnswers[index] || options[0]?.id || 'opt-1',
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            instruction: asString(asRecord(content.meta).instruction, 'Choose the correct answer.'),
+            passage: asString(asRecord(content.meta).passage),
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
+const reverseTrueFalseGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(item.correctAnswer);
+        const isExample = item.isExample === true;
+        const ansVal = typeof itemAnswer.answer === 'boolean'
+            ? itemAnswer.answer
+            : typeof fallbackAnswers[index] === 'boolean'
+                ? fallbackAnswers[index]
+                : true;
+        return {
+            question: asString(itemContent.question),
+            correctAnswer: ansVal,
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            instruction: asString(asRecord(content.meta).instruction, 'Tick True or False.'),
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
+const reverseCrossOutWordGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const items = asArray(content.items).map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const itemAnswer = asRecord(asRecord(item.correctAnswer).answer);
+        const fallback = asRecord(fallbackAnswers[index]);
+        const answerRaw = Object.keys(itemAnswer).length > 0 ? itemAnswer : fallback;
+        const isExample = item.isExample === true;
+        const type = itemContent.type === 'CROSS_OUT_AND_REPLACE' ||
+            answerRaw.type === 'CROSS_OUT_AND_REPLACE'
+            ? 'CROSS_OUT_AND_REPLACE'
+            : 'CROSS_OUT';
+        const correctAnswer = type === 'CROSS_OUT_AND_REPLACE'
+            ? {
+                type: 'CROSS_OUT_AND_REPLACE',
+                crossOut: asString(answerRaw.crossOut),
+                replaceWith: asString(answerRaw.replaceWith),
+            }
+            : {
+                type: 'CROSS_OUT',
+                crossOut: asString(answerRaw.crossOut),
+            };
+        return {
+            type,
+            question: asString(itemContent.question),
+            correctAnswer,
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            instruction: asString(asRecord(content.meta).instruction, 'Cross out the extra or incorrect word. If the word is incorrect, write the correct word. If the line is correct, leave it blank.'),
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
+const reverseWordOrderAndMatchGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const fallbackAnswers = asArray(answer.answer);
+    const rawList = asRecord(apiQuestion.wordOrderMatchList ?? content.wordOrderMatchList ?? content);
+    const meta = asRecord(rawList.meta ?? content.meta);
+    const itemsSource = asArray(rawList.items ?? content.items);
+    const matchOptions = Array.isArray(meta.matchOptions)
+        ? meta.matchOptions.map((opt) => String(opt || '').trim().toUpperCase()).filter(Boolean)
+        : ['A', 'B', 'C', 'D', 'E', 'F'];
+    const items = itemsSource.map((rawItem, index) => {
+        const item = asRecord(rawItem);
+        const itemContent = asRecord(item.content);
+        const correctAnswerRaw = asRecord(item.correctAnswer);
+        const fallback = asRecord(fallbackAnswers[index]);
+        const answerObj = isRecord(correctAnswerRaw.answer)
+            ? correctAnswerRaw.answer
+            : isRecord(correctAnswerRaw) && (correctAnswerRaw.orderedPhrase || correctAnswerRaw.matchLabel)
+                ? correctAnswerRaw
+                : fallback;
+        const words = Array.isArray(itemContent.scrambledWords)
+            ? itemContent.scrambledWords.map((w) => String(w || '').trim()).filter(Boolean)
+            : [];
+        const isExample = item.isExample === true;
+        return {
+            scrambledWords: words,
+            orderedPhrase: asString(answerObj.orderedPhrase) || asString(item.orderedPhrase),
+            matchLabel: asString(answerObj.matchLabel) || asString(item.matchLabel) || 'A',
+            isExample,
+            points: isExample ? 0 : asNumber(item.points, 1),
+            questionNumber: asNumber(item.questionNumber, index + 1),
+        };
+    });
+    return {
+        content: '',
+        answer: {
+            instruction: asString(meta.instruction, 'Put the useful phrases in order, then match them to parts A–F in Exercise 4.'),
+            matchOptions,
+            items,
+            explanation: asString(apiQuestion.explanation),
+            points: items.reduce((total, item) => (item.isExample ? total : total + item.points), 0),
+        },
+    };
+};
+const reverseSpontaneousQaGroup = (apiQuestion) => {
+    const content = asRecord(apiQuestion.content);
+    const answer = readAnswer(apiQuestion);
+    const meta = asRecord(content.meta);
+    const items = asArray(content.items);
+    const flattenedAnswers = asArray(answer.answer);
+    const hasNestedParts = items.some((item) => Array.isArray(asRecord(item).questions));
+    const sourceParts = hasNestedParts
+        ? items
+        : [{ partNumber: 1, partTitle: 'PART 1', topic: '', questions: items }];
+    const parts = sourceParts.map((item, partIndex) => {
+        const record = asRecord(item);
+        const questions = asArray(record.questions);
+        return {
+            partNumber: asNumber(record.partNumber, partIndex + 1),
+            partTitle: asString(record.partTitle, `PART ${partIndex + 1}`),
+            topic: asString(record.topic),
+            questions: questions.map((question, questionIndex) => {
+                const child = asRecord(question);
+                const childContent = asRecord(child.content);
+                const childAnswer = asRecord(child.correctAnswer);
+                const fallback = asRecord(flattenedAnswers[questionIndex]);
+                const expected = asArray(childAnswer.expectedAnswers ?? fallback.expectedAnswers)
+                    .filter((value) => typeof value === 'string');
+                return {
+                    questionText: asString(childContent.questionText),
+                    inputType: asString(childContent.inputType, 'TEXT') === 'AUDIO' ? 'AUDIO' : 'TEXT',
+                    audioUrl: asString(childContent.audioUrl),
+                    expectedAnswers: expected.length > 0 ? expected : [''],
+                    points: asNumber(child.points, 1),
+                    questionNumber: asNumber(child.questionNumber, questionIndex + 1),
+                };
+            }),
+        };
+    });
+    return {
+        content: apiQuestion.content ?? '',
+        answer: {
+            instruction: asString(meta.instruction, 'In pairs, ask and answer the questions.'),
+            parts,
+            explanation: asString(apiQuestion.explanation),
+            points: readPoints(apiQuestion),
+        },
+    };
+};
+const reverseSimpleAnswer = (apiQuestion) => {
+    const answer = readAnswer(apiQuestion);
+    const content = asRecord(apiQuestion.content);
+    return {
+        content: apiQuestion.content ?? '',
+        answer: {
+            ...answer,
+            ...content,
+            explanation: asString(apiQuestion.explanation),
+            points: readPoints(apiQuestion),
+        },
+    };
+};
+const handlers = {
+    CHOOSE_THE_CORRECT_ANSWER: reverseChooseTheCorrectAnswer,
+    CHOOSE_THE_CORRECT_ANSWER_GROUP: reverseChooseTheCorrectAnswerGroup,
+    TRUE_FALSE_GROUP: reverseTrueFalseGroup,
+    CROSS_OUT_WORD_GROUP: reverseCrossOutWordGroup,
+    WORD_ORDER_AND_MATCH_GROUP: reverseWordOrderAndMatchGroup,
+    WORD_ORDER_AND_MATCH: reverseWordOrderAndMatchGroup,
+    LOOK_PICTURE_CHOOSE_CORRECT_ANSWER: reversePictureChoice,
+    LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER: reversePictureChoice,
+    FILL_IN_BLANK: reverseFillInBlank,
+    READ_PASSAGE_AND_ANSWER_QUESTIONS: reverseReadPassage,
+    LABEL_THE_PICTURE: reverseLabelPicture,
+    READ_AND_COLOR_OBJECTS: reverseGroupPayload,
+    IMAGE_OBJECT_MATCHING: reverseGroupPayload,
+    FILL_MISSING_WORDS_IN_GRID: reverseGrid,
+    LOOK_PICTURE_FILL_WORD_HINT: reverseGroupPayload,
+    ANSWER_THE_QUESTION: reverseGroupPayload,
+    TRUE_FALSE: reverseSimpleAnswer,
+    WORD_ORDERING: reverseSimpleAnswer,
+    WORD_FILL_PARAGRAPH: reverseSimpleAnswer,
+    MATCH_BY_WRITING_ANSWER: reverseGroupPayload,
+    WRITE_SENTENCES: reverseGroupPayload,
+    WRITE_A_SHORT_LETTER: reverseSimpleAnswer,
+    WRITE_CORRECT_VERB_FORM: reverseSimpleAnswer,
+    CHOOSE_CORRECT_ADJECTIVE: reverseSimpleAnswer,
+    WORD_FILL_STRUCTURED_FORM: reverseGroupPayload,
+    LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP: reverseGroupPayload,
+    LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE: reverseGroupPayload,
+    LISTEN_AND_DRAG_OBJECTS_INTO_SCENE: reverseGroupPayload,
+    LISTEN_AND_SPEAK_ANSWER: reverseGroupPayload,
+    LISTEN_AND_SPEAK_IMAGE_GROUP: reverseGroupPayload,
+    LISTEN_AND_SPEAK_QUESTION_LIST: reverseGroupPayload,
+    LISTEN_AND_SPEAK_COMPARE_IMAGES: reverseGroupPayload,
+    LISTEN_AND_SPEAK_WITH_STORY_IMAGES: reverseGroupPayload,
+    LISTEN_AND_SPEAK_ODD_ONE_OUT: reverseGroupPayload,
+    LISTEN_AND_SPEAK_INFO_EXCHANGE: reverseGroupPayload,
+    SPEAKING_DESCRIBE_IMAGE: reverseSimpleAnswer,
+    READ_DISPLAYED_CONTENT: reverseSimpleAnswer,
+    SPONTANEOUS_QA: reverseSimpleAnswer,
+    SPONTANEOUS_QA_GROUP: reverseSpontaneousQaGroup,
+    SPEAKING_CONVERSATION: reverseGroupPayload,
+    SPEAKING_CUE_CARD: reverseSimpleAnswer,
+    GN_SPEAKING_INTERVIEW: reverseGroupPayload,
+};
+export function transformApiQuestionToFrontend(apiQuestion) {
+    const questionType = String(apiQuestion.questionType ?? apiQuestion.question_type ?? apiQuestion.type ?? '');
+    const handlerResult = (handlers[questionType] ?? defaultReverse)(apiQuestion);
+    const questionBank = readQuestionBank(apiQuestion);
+    return {
+        id: asString(apiQuestion.id),
+        type: questionType,
+        content: handlerResult.content,
+        answer: handlerResult.answer,
+        points: readPoints(apiQuestion),
+        level: mapLevel(apiQuestion.level),
+        difficulty: mapDifficulty(asString(apiQuestion.difficulty ?? apiQuestion.difficult_level)),
+        skill: mapSkill(asString(apiQuestion.questionSkillType ?? apiQuestion.question_skill_type ?? apiQuestion.skill)),
+        explanation: asString(apiQuestion.explanation),
+        partId: asString(apiQuestion.partId ?? apiQuestion.part_id),
+        questionNumber: asNumber(apiQuestion.questionNumber ?? apiQuestion.question_number, 1),
+        isCompleted: true,
+        questionGroup: apiQuestion.questionGroup,
+        questionBank: questionBank ? {
+            id: asString(questionBank.id),
+            code: asString(questionBank.code),
+            title: asString(questionBank.title),
+        } : undefined,
+    };
+}
+export function transformApiQuestionsToFrontend(apiQuestions) {
+    return apiQuestions.map(transformApiQuestionToFrontend);
+}

package/dist/shared/lib/utils/question-transform-types.js

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