@tinyweb_dev/oe-exam-sdk 0.1.1 → 0.1.3

package/dist/shared/lib/stores/examQuestionStore.js

@@ -1,212 +1 @@
-import { create } from 'zustand';
-const createEmptyQuestionEntry = () => ({
-    data: {},
-    isCompleted: false,
-});
-export const useExamQuestionStore = create((set, get) => ({
-    examId: null,
-    templateId: null,
-    totalQuestions: 0,
-    currentQuestionIndex: 0,
-    questions: {},
-    initialized: false,
-    sharedHintLetters: {},
-    sharedPassageData: {},
-    sharedSceneData: {},
-    sharedAnswerGroupData: {},
-    sharedListData: {},
-    sharedCompareImagesData: {},
-    sharedInfoExchangeData: {},
-    initializeExam: ({ examId, templateId, totalQuestions }) => {
-        const questions = {};
-        // Initialize empty questions (no localStorage loading)
-        for (let index = 0; index < totalQuestions; index++) {
-            questions[index] = createEmptyQuestionEntry();
-        }
-        set({
-            examId,
-            templateId,
-            totalQuestions,
-            currentQuestionIndex: 0,
-            questions,
-            initialized: true,
-        });
-    },
-    setCurrentQuestionIndex: (questionIndex) => {
-        set({ currentQuestionIndex: questionIndex });
-    },
-    upsertQuestionData: (questionIndex, data) => {
-        set((state) => {
-            const existingEntry = state.questions[questionIndex] ?? createEmptyQuestionEntry();
-            return {
-                questions: {
-                    ...state.questions,
-                    [questionIndex]: {
-                        ...existingEntry,
-                        data: {
-                            ...existingEntry.data,
-                            ...data,
-                        },
-                    },
-                },
-            };
-        });
-    },
-    // Clear/reset question data to empty state (used when discarding unsaved changes for new questions)
-    clearQuestionData: (questionIndex) => {
-        set((state) => ({
-            questions: {
-                ...state.questions,
-                [questionIndex]: createEmptyQuestionEntry(),
-            },
-        }));
-    },
-    markQuestionCompleted: (questionIndex, isCompleted) => {
-        set((state) => {
-            const existingEntry = state.questions[questionIndex] ?? createEmptyQuestionEntry();
-            return {
-                questions: {
-                    ...state.questions,
-                    [questionIndex]: {
-                        ...existingEntry,
-                        data: {
-                            ...existingEntry.data,
-                            isCompleted,
-                        },
-                        isCompleted,
-                    },
-                },
-            };
-        });
-    },
-    getQuestionData: (questionIndex) => {
-        return get().questions[questionIndex]?.data;
-    },
-    getCompletedQuestionIndices: () => {
-        return Object.entries(get().questions)
-            .filter(([, entry]) => entry.isCompleted)
-            .map(([index]) => Number(index))
-            .sort((a, b) => a - b);
-    },
-    // Set shared hintLetters for a specific partId + groupNumber combination
-    setSharedHintLetters: (partId, groupNumber, hintLetters) => {
-        const key = `${partId}_${groupNumber}`;
-        set((state) => ({
-            sharedHintLetters: {
-                ...state.sharedHintLetters,
-                [key]: hintLetters,
-            },
-        }));
-    },
-    // Get shared hintLetters for a specific partId + groupNumber combination
-    getSharedHintLetters: (partId, groupNumber) => {
-        const key = `${partId}_${groupNumber}`;
-        return get().sharedHintLetters[key];
-    },
-    // Set shared passage data for a specific partId + groupNumber combination
-    setSharedPassageData: (partId, groupNumber, data) => {
-        const key = `${partId}_${groupNumber}`;
-        set((state) => ({
-            sharedPassageData: {
-                ...state.sharedPassageData,
-                [key]: data,
-            },
-        }));
-    },
-    // Get shared passage data for a specific partId + groupNumber combination
-    getSharedPassageData: (partId, groupNumber) => {
-        const key = `${partId}_${groupNumber}`;
-        return get().sharedPassageData[key];
-    },
-    // Set shared scene data for a specific partId + groupNumber combination
-    setSharedSceneData: (partId, groupNumber, data) => {
-        const key = `${partId}_${groupNumber}`;
-        set((state) => ({
-            sharedSceneData: {
-                ...state.sharedSceneData,
-                [key]: data,
-            },
-        }));
-    },
-    // Get shared scene data for a specific partId + groupNumber combination
-    getSharedSceneData: (partId, groupNumber) => {
-        const key = `${partId}_${groupNumber}`;
-        return get().sharedSceneData[key];
-    },
-    // Set shared answer group data for a specific partId + groupNumber combination
-    setSharedAnswerGroupData: (partId, groupNumber, data) => {
-        const key = `${partId}_${groupNumber}`;
-        set((state) => ({
-            sharedAnswerGroupData: {
-                ...state.sharedAnswerGroupData,
-                [key]: data,
-            },
-        }));
-    },
-    // Get shared answer group data for a specific partId + groupNumber combination
-    getSharedAnswerGroupData: (partId, groupNumber) => {
-        const key = `${partId}_${groupNumber}`;
-        return get().sharedAnswerGroupData[key];
-    },
-    // Set shared list data for a specific partId + groupNumber combination
-    setSharedListData: (partId, groupNumber, data) => {
-        const key = `${partId}_${groupNumber}`;
-        set((state) => ({
-            sharedListData: {
-                ...state.sharedListData,
-                [key]: data,
-            },
-        }));
-    },
-    // Get shared list data for a specific partId + groupNumber combination
-    getSharedListData: (partId, groupNumber) => {
-        const key = `${partId}_${groupNumber}`;
-        return get().sharedListData[key];
-    },
-    // Set shared compare images data for a specific partId + groupNumber combination
-    setSharedCompareImagesData: (partId, groupNumber, data) => {
-        const key = `${partId}_${groupNumber}`;
-        set((state) => ({
-            sharedCompareImagesData: {
-                ...state.sharedCompareImagesData,
-                [key]: data,
-            },
-        }));
-    },
-    // Get shared compare images data for a specific partId + groupNumber combination
-    getSharedCompareImagesData: (partId, groupNumber) => {
-        const key = `${partId}_${groupNumber}`;
-        return get().sharedCompareImagesData[key];
-    },
-    // Set shared info exchange data for a specific partId + groupNumber combination
-    setSharedInfoExchangeData: (partId, groupNumber, data) => {
-        const key = `${partId}_${groupNumber}`;
-        set((state) => ({
-            sharedInfoExchangeData: {
-                ...state.sharedInfoExchangeData,
-                [key]: data,
-            },
-        }));
-    },
-    // Get shared info exchange data for a specific partId + groupNumber combination
-    getSharedInfoExchangeData: (partId, groupNumber) => {
-        const key = `${partId}_${groupNumber}`;
-        return get().sharedInfoExchangeData[key];
-    },
-    resetStore: () => {
-        set({
-            examId: null,
-            templateId: null,
-            totalQuestions: 0,
-            currentQuestionIndex: 0,
-            questions: {},
-            initialized: false,
-            sharedHintLetters: {},
-            sharedPassageData: {},
-            sharedSceneData: {},
-            sharedAnswerGroupData: {},
-            sharedListData: {},
-            sharedCompareImagesData: {},
-        });
-    },
-}));
+import{create as e}from"zustand";const a=()=>({data:{},isCompleted:!1});export const useExamQuestionStore=e((e,t)=>({examId:null,templateId:null,totalQuestions:0,currentQuestionIndex:0,questions:{},initialized:!1,sharedHintLetters:{},sharedPassageData:{},sharedSceneData:{},sharedAnswerGroupData:{},sharedListData:{},sharedCompareImagesData:{},sharedInfoExchangeData:{},initializeExam:({examId:t,templateId:s,totalQuestions:r})=>{const n={};for(let e=0;e<r;e++)n[e]=a();e({examId:t,templateId:s,totalQuestions:r,currentQuestionIndex:0,questions:n,initialized:!0})},setCurrentQuestionIndex:a=>{e({currentQuestionIndex:a})},upsertQuestionData:(a,t)=>{e(e=>{const s=e.questions[a]??{data:{},isCompleted:!1};return{questions:{...e.questions,[a]:{...s,data:{...s.data,...t}}}}})},clearQuestionData:a=>{e(e=>({questions:{...e.questions,[a]:{data:{},isCompleted:!1}}}))},markQuestionCompleted:(a,t)=>{e(e=>{const s=e.questions[a]??{data:{},isCompleted:!1};return{questions:{...e.questions,[a]:{...s,data:{...s.data,isCompleted:t},isCompleted:t}}}})},getQuestionData:e=>t().questions[e]?.data,getCompletedQuestionIndices:()=>Object.entries(t().questions).filter(([,e])=>e.isCompleted).map(([e])=>Number(e)).sort((e,a)=>e-a),setSharedHintLetters:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedHintLetters:{...e.sharedHintLetters,[r]:s}}))},getSharedHintLetters:(e,a)=>{const s=`${e}_${a}`;return t().sharedHintLetters[s]},setSharedPassageData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedPassageData:{...e.sharedPassageData,[r]:s}}))},getSharedPassageData:(e,a)=>{const s=`${e}_${a}`;return t().sharedPassageData[s]},setSharedSceneData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedSceneData:{...e.sharedSceneData,[r]:s}}))},getSharedSceneData:(e,a)=>{const s=`${e}_${a}`;return t().sharedSceneData[s]},setSharedAnswerGroupData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedAnswerGroupData:{...e.sharedAnswerGroupData,[r]:s}}))},getSharedAnswerGroupData:(e,a)=>{const s=`${e}_${a}`;return t().sharedAnswerGroupData[s]},setSharedListData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedListData:{...e.sharedListData,[r]:s}}))},getSharedListData:(e,a)=>{const s=`${e}_${a}`;return t().sharedListData[s]},setSharedCompareImagesData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedCompareImagesData:{...e.sharedCompareImagesData,[r]:s}}))},getSharedCompareImagesData:(e,a)=>{const s=`${e}_${a}`;return t().sharedCompareImagesData[s]},setSharedInfoExchangeData:(a,t,s)=>{const r=`${a}_${t}`;e(e=>({sharedInfoExchangeData:{...e.sharedInfoExchangeData,[r]:s}}))},getSharedInfoExchangeData:(e,a)=>{const s=`${e}_${a}`;return t().sharedInfoExchangeData[s]},resetStore:()=>{e({examId:null,templateId:null,totalQuestions:0,currentQuestionIndex:0,questions:{},initialized:!1,sharedHintLetters:{},sharedPassageData:{},sharedSceneData:{},sharedAnswerGroupData:{},sharedListData:{},sharedCompareImagesData:{}})}}));

package/dist/shared/lib/stores/localeStore.js

@@ -1,10 +1 @@
-import { create } from 'zustand';
-import { persist } from 'zustand/middleware';
-export const useLocaleStore = create()(persist((set) => ({
-    locale: 'vi',
-    setLocale: (locale) => {
-        set({ locale });
-    },
-}), {
-    name: 'locale-storage',
-}));
+import{create as e}from"zustand";import{persist as o}from"zustand/middleware";export const useLocaleStore=e()(o(e=>({locale:"vi",setLocale:o=>{e({locale:o})}}),{name:"locale-storage"}));

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

@@ -1,44 +1 @@
-/** 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;
-}
+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="))}

package/dist/shared/lib/utils/question-reverse-transform.d.ts

@@ -0,0 +1,6 @@
+import type { ExamQuestion } from '../../types/entities/exam.types';
+type JsonRecord = Record<string, unknown>;
+type ApiQuestion = JsonRecord;
+export declare function transformApiQuestionToFrontend(apiQuestion: ApiQuestion): Partial<ExamQuestion>;
+export declare function transformApiQuestionsToFrontend(apiQuestions: ApiQuestion[]): Partial<ExamQuestion>[];
+export {};

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

@@ -0,0 +1 @@
+const n=n=>"object"==typeof n&&null!==n&&!Array.isArray(n),e=e=>n(e)?e:{},t=n=>Array.isArray(n)?n:[],o=(n,e="")=>"string"==typeof n?n:e,r=(n,e)=>"number"==typeof n&&Number.isFinite(n)?n:e,s=n=>e(n.correctAnswer??n.correct_answer),i=n=>e(n.questionGroup??n.question_group),_=n=>Number.parseFloat(String(n.total_points??n.points??1))||1,a=n=>{const e=n?.toUpperCase();return"EASY"===e||"MEDIUM"===e||"HARD"===e?e:void 0},E=n=>{const e=n?.toUpperCase();return"LISTENING"===e||"READING"===e||"WRITING"===e||"SPEAKING"===e?e:void 0},A=n=>({content:n.content,answer:s(n)}),N=n=>{const r=e(n.content),i=s(n);return{content:"",answer:{imageUrl:o(r.imageUrl),question:o(r.question),options:t(r.options).map(n=>"string"==typeof n?n:o(e(n).text)),correctAnswer:i.answer??i.correctAnswer??-1,explanation:o(n.explanation),points:_(n)}}},p=n=>{const t=e(n.content),a=s(n),E=i(n);return{content:"",answer:{...e(E.payload),...t,...a,groupNumber:r(E.groupNumber,1),explanation:o(n.explanation),points:_(n)}}},u=n=>{const t=s(n),r=e(n.content);return{content:n.content??"",answer:{...t,...r,explanation:o(n.explanation),points:_(n)}}},S={CHOOSE_THE_CORRECT_ANSWER:n=>{const r=e(n.content),i=s(n),a=i.answer??-1,E=Boolean(r.multipleAnswers??i.multipleAnswers??Array.isArray(a));return{content:"",answer:{question:o(r.question),optionType:o(r.optionType,"text"),options:t(r.options),imageUrl:o(r.imageUrl),askerName:o(r.askerName),answererName:o(r.answererName),correctAnswer:E?Array.isArray(a)?a:-1===a?[]:[a]:Array.isArray(a)?a[0]??-1:a,multipleAnswers:E,explanation:o(n.explanation),points:_(n)}}},LOOK_PICTURE_CHOOSE_CORRECT_ANSWER:N,LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER:N,FILL_IN_BLANK:n=>{const r=e(n.content),i=s(n),a=e(t(r.blanks)[0]);return{content:"",answer:{question:o(r.question??a.text),answers:Array.isArray(i.answers)?i.answers:[],caseSensitive:Boolean(i.caseSensitive??!1),imageUrl:o(r.imageUrl),showHints:Boolean(r.showHints??!1),hints:t(r.hints),explanation:o(n.explanation),points:_(n),blanks:t(r.blanks)}}},READ_PASSAGE_AND_ANSWER_QUESTIONS:n=>{const a=e(n.content),E=s(n),A=i(n),N=e(A.payload);return{content:"",answer:{passage:o(N.passage??a.passage),passageTitle:o(N.passageTitle??a.passageTitle),instructions:o(N.instructions??a.instructions),singleQuestion:{id:o(n.id,`question-${String(n.question_number??n.questionNumber??1)}`),question:o(a.question),options:t(a.options),correctAnswer:E.correctAnswer??E.answer??-1,points:_(n),groupNumber:r(A.groupNumber,1)}}}},LABEL_THE_PICTURE:n=>{const r=e(n.content),i=s(n),_=e(i.labels??i.answers);return{content:"",answer:{imageUrl:o(r.imageUrl),wordBank:t(r.wordBank),labels:t(r.labels).map(n=>{const t=e(n),r=o(t.id);return{...t,correctAnswer:t.correctAnswer??_[r]??""}})}}},READ_AND_COLOR_OBJECTS:p,IMAGE_OBJECT_MATCHING:p,FILL_MISSING_WORDS_IN_GRID:n=>({content:n.content??{},answer:s(n)}),LOOK_PICTURE_FILL_WORD_HINT:p,ANSWER_THE_QUESTION:p,TRUE_FALSE:u,WORD_ORDERING:u,WORD_FILL_PARAGRAPH:u,MATCH_BY_WRITING_ANSWER:p,WRITE_SENTENCES:p,WRITE_A_SHORT_LETTER:u,WRITE_CORRECT_VERB_FORM:u,CHOOSE_CORRECT_ADJECTIVE:u,WORD_FILL_STRUCTURED_FORM:p,LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP:p,LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE:p,LISTEN_AND_DRAG_OBJECTS_INTO_SCENE:p,LISTEN_AND_SPEAK_ANSWER:p,LISTEN_AND_SPEAK_IMAGE_GROUP:p,LISTEN_AND_SPEAK_QUESTION_LIST:p,LISTEN_AND_SPEAK_COMPARE_IMAGES:p,LISTEN_AND_SPEAK_WITH_STORY_IMAGES:p,LISTEN_AND_SPEAK_ODD_ONE_OUT:p,LISTEN_AND_SPEAK_INFO_EXCHANGE:p,SPEAKING_DESCRIBE_IMAGE:u,READ_DISPLAYED_CONTENT:u,SPONTANEOUS_QA:u,SPEAKING_CONVERSATION:p,SPEAKING_CUE_CARD:u,GN_SPEAKING_INTERVIEW:p};export function transformApiQuestionToFrontend(e){const t=String(e.questionType??e.question_type??e.type??""),s=(S[t]??A)(e),i=(e=>{const t=e.questionBank??e.question_bank;return n(t)?t:void 0})(e);return{id:o(e.id),type:t,content:s.content,answer:s.answer,points:_(e),level:(N=e.level,"Pre-A1"===N||"A1"===N||"A2"===N||"B1"===N||"B2"===N||"C1"===N||"C2"===N?N:void 0),difficulty:a(o(e.difficulty??e.difficult_level)),skill:E(o(e.questionSkillType??e.question_skill_type??e.skill)),explanation:o(e.explanation),partId:o(e.partId??e.part_id),questionNumber:r(e.questionNumber??e.question_number,1),isCompleted:!0,questionGroup:e.questionGroup,questionBank:i?{id:o(i.id),code:o(i.code),title:o(i.title)}:void 0};var N}export function transformApiQuestionsToFrontend(n){return n.map(transformApiQuestionToFrontend)}

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

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

package/dist/shared/lib/utils/question-transform-validation.d.ts

@@ -0,0 +1,6 @@
+import type { ExamQuestion } from '../../types/entities/exam.types';
+export interface QuestionTransformValidationResult {
+    isValid: boolean;
+    errors: string[];
+}
+export declare function validateQuestionForTransform(question: Partial<ExamQuestion>): QuestionTransformValidationResult;

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

@@ -0,0 +1 @@
+const n=n=>"string"==typeof n&&n.trim().length>0,t=n=>Array.isArray(n)&&n.length>0,e=n=>"object"==typeof n&&null!==n&&!Array.isArray(n),s=n=>e(n)?n:void 0,u=n=>"number"==typeof n&&Number.isFinite(n)&&n>0;export function validateQuestionForTransform(r){const h=[];r.type||h.push("Question type is required");const o=s(r.answer),p=s(r.content);switch(r.type){case"FILL_MISSING_WORDS_IN_GRID":!function(n,t,s){Array.isArray(n?.grid)||s.push("Grid is required for FILL_MISSING_WORDS_IN_GRID");u(n?.rows)||s.push("Rows must be at least 1");u(n?.columns)||s.push("Columns must be at least 1");i=t?.answers,e(i)&&Object.keys(i).length>0||s.push("At least one missing letter is required");var i}(p,o,h);break;case"LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER":!function(t,e){n(t?.imageUrl)||e.push("Vui lòng upload hình ảnh");n(t?.question)||e.push("Vui lòng nhập nội dung câu hỏi");i(t?.options,e),(void 0===t?.correctAnswer||-1===t.correctAnswer)&&e.push("Vui lòng chọn đáp án đúng")}(o,h);break;case"LOOK_PICTURE_CHOOSE_CORRECT_ANSWER":!function(t,e){n(t?.imageUrl)||e.push("Vui lòng upload hình ảnh");i(t?.options,e),("number"!=typeof t?.correctAnswer||t.correctAnswer<0)&&e.push("Vui lòng chọn đáp án đúng")}(o,h);break;case"LOOK_PICTURE_FILL_WORD_HINT":!function(e,u){if(!t(e?.subQuestions))return void u.push("Vui lòng nhập dữ liệu câu hỏi");e.subQuestions.forEach(t=>{const e=s(t);n(e?.imageUrl)||u.push("Vui lòng upload hình ảnh"),n(e?.word)||u.push("Vui lòng nhập từ có chỗ trống"),n(e?.correctAnswer)||u.push("Vui lòng nhập đáp án đúng")})}(o,h);break;case"LABEL_THE_PICTURE":!function(e,s){n(e?.imageUrl)||s.push("Vui lòng upload hình ảnh");t(e?.labels)||s.push("Vui lòng thêm ít nhất một vị trí cần điền")}(o,h);break;case"READ_AND_COLOR_OBJECTS":case"IMAGE_OBJECT_MATCHING":!function(e,s){n(e?.backgroundImageUrl)||s.push("Vui lòng upload ảnh nền");t(e?.colorNodes)||s.push("Vui lòng thêm ít nhất một màu");t(e?.regionNodes)||s.push("Vui lòng thêm ít nhất một vùng tô màu")}(o,h);break;case"READ_PASSAGE_AND_ANSWER_QUESTIONS":!function(t,e){n(t?.passage)||e.push("Vui lòng nhập nội dung đoạn văn");const u=s(t?.singleQuestion);if(!u)return void e.push("Vui lòng nhập dữ liệu câu hỏi");n(u.question)||e.push("Vui lòng nhập câu hỏi");i(u.options,e),("number"!=typeof u.correctAnswer||u.correctAnswer<0)&&e.push("Vui lòng chọn đáp án đúng")}(o,h);break;case"CHOOSE_CORRECT_ADJECTIVE":!function(t,e,s){n(t?.sentence)||s.push("Vui lòng nhập câu hỏi");i(t?.options,s),("number"!=typeof e?.answer||e.answer<0)&&s.push("Vui lòng chọn đáp án đúng")}(p,o,h);break;case"ANSWER_THE_QUESTION":!function(t,e){n(t?.question)||e.push("Vui lòng nhập câu hỏi");n(t?.correctAnswer)||e.push("Vui lòng nhập đáp án")}(o,h);break;case"WORD_ORDERING":!function(n,e){(!t(n?.words)||n.words.length<2)&&e.push("Cần ít nhất 2 từ/chữ cái");(!t(n?.answer)||n.answer.length<2)&&e.push("Cần ít nhất 2 từ/chữ cái trong đáp án")}(o,h);break;case"WORD_FILL_PARAGRAPH":!function(e,s){n(e?.paragraph)||s.push("Vui lòng nhập đoạn văn");"DEFAULT"===e?.viewMode||"EMAIL"===e?.viewMode||t(e?.wordBank)||s.push("Cần ít nhất 1 chỗ trống");t(e?.answers)||s.push("Cần ít nhất 1 đáp án")}(o,h);break;case"LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP":!function(e,s){(!t(e?.options)||e.options.length<2)&&s.push("Cần tối thiểu 2 đáp án trong nhóm");n(e?.audioUrl)||s.push("Phải có file audio");n(e?.correctAnswer)||s.push("Phải chọn đáp án đúng")}(o,h);break;case"LISTEN_AND_SPEAK_QUESTION_LIST":!function(e,s){n(e?.audioUrl)||s.push("Vui lòng tải lên file âm thanh");n(e?.activeQuestionId)||s.push("Vui lòng chọn câu hỏi");t(e?.expectedAnswers)||s.push("Cần ít nhất 1 đáp án mong muốn")}(o,h);break;case"WRITE_A_SHORT_LETTER":!function(n,t){u(n?.minWords)||t.push("Số từ tối thiểu phải >= 1");"number"==typeof n?.maxWords&&"number"==typeof n.minWords&&n.maxWords<n.minWords&&t.push("Số từ tối đa phải >= số từ tối thiểu")}(o,h)}return{isValid:0===h.length,errors:h}}function i(e,u){if(!t(e)||e.length<2)return void u.push("Phải có ít nhất 2 lựa chọn");e.filter(t=>{const e="string"==typeof t?t:s(t)?.text;return n(e)}).length<2&&u.push("Phải có ít nhất 2 đáp án được điền")}

package/dist/shared/lib/utils/question-transform.d.ts

@@ -8,6 +8,8 @@ export interface TransformQuestionOptions {
     questionBankCode?: string;
     questionBankTitle?: string;
     sectionId?: number;
+    examLevel?: string;
+    subjectId?: string;
 }
 /**
  * Transform frontend question format to API format.
@@ -22,9 +24,11 @@ export interface TransformQuestionItem {
     addToQuestionBank?: boolean;
     questionBankCode?: string;
     questionBankTitle?: string;
+    examLevel?: string;
+    subjectId?: string;
 }
 /**
- * Transform multiple questions to API format. Mirrors the reference FE behaviour
- * but without the standalone validation pass (validation lives in the creator UI).
+ * Transform multiple questions to API format with the same validation gate used
+ * by the host frontend screen.
  */
 export declare function transformQuestionsToApiFormat(questions: TransformQuestionItem[]): TransformQuestionsResult;

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

@@ -1,174 +1 @@
-// ─── Import transforms từ từng question type ────────────────────────────────
-import { transformLookPictureChooseCorrectAnswer } from '../../../components/questions/types/look-picture-choose-correct-answer/transform';
-import { transformLookPictureFillBlankChooseAnswer } from '../../../components/questions/types/look-picture-fill-blank-choose-answer/transform';
-import { transformLookPictureFillWordHint } from '../../../components/questions/types/look-picture-fill-word-hint/transform';
-import { transformReadAndColorObjects } from '../../../components/questions/types/read-and-color-objects/transform';
-import { transformReadPassageAndAnswerQuestions } from '../../../components/questions/types/read-passage-and-answer-questions/transform';
-import { transformArrangeLettersIntoWords } from '../../../components/questions/types/arrange-letters-into-words/transform';
-import { transformWriteShortParagraph } from '../../../components/questions/types/write-short-paragraph/transform';
-import { transformWriteAShortLetter } from '../../../components/questions/types/write-a-short-letter/transform';
-import { transformFillMissingWordsInGrid } from '../../../components/questions/types/fill-missing-words-in-grid/transform';
-import { transformLabelThePicture } from '../../../components/questions/types/label-the-picture/transform';
-import { transformChooseTheCorrectAnswer } from '../../../components/questions/types/choose-the-correct-answer/transform';
-import { transformFillInBlank } from '../../../components/questions/types/fill-in-blank/transform';
-import { transformWriteCorrectVerbForm } from '../../../components/questions/types/write-correct-verb-form/transform';
-import { transformChooseCorrectAdjective } from '../../../components/questions/types/choose-correct-adjective/transform';
-import { transformAnswerTheQuestion } from '../../../components/questions/types/answer-the-question/transform';
-import { transformTrueFalse } from '../../../components/questions/types/true-false/transform';
-import { transformWordOrdering } from '../../../components/questions/types/word-ordering/transform';
-import { transformWordFillParagraph } from '../../../components/questions/types/word-fill-paragraph/transform';
-import { transformMatchByWritingAnswer } from '../../../components/questions/types/match-by-writing-answer/transform';
-import { transformWriteSentences } from '../../../components/questions/types/write-sentences/transform';
-import { transformListenAndChooseFromAnswerGroup } from '../../../components/questions/types/listen-and-choose-from-answer-group/transform';
-import { transformListenAndChooseObjectsInScene } from '../../../components/questions/types/listen-and-choose-objects-in-scene/transform';
-import { transformListenAndDragObjectsIntoScene } from '../../../components/questions/types/listen-and-drag-objects-into-scene/transform';
-import { transformListenAndSpeakAnswer } from '../../../components/questions/types/listen-and-speak-answer/transform';
-import { transformListenAndSpeakImageGroup } from '../../../components/questions/types/listen-and-speak-image-group/transform';
-import { transformListenAndSpeakQuestionList } from '../../../components/questions/types/listen-and-speak-question-list/transform';
-import { transformListenAndSpeakCompareImages } from '../../../components/questions/types/listen-and-speak-compare-images/transform';
-import { transformListenAndSpeakOddOneOut } from '../../../components/questions/types/listen-and-speak-odd-one-out/transform';
-import { transformListenAndSpeakWithStoryImages } from '../../../components/questions/types/listen-and-speak-with-story-images/transform';
-import { transformListenAndSpeakInfoExchange } from '../../../components/questions/types/listen-and-speak-info-exchange/transform';
-import { transformSpeakingDescribeImage } from '../../../components/questions/types/speaking-describe-image/transform';
-import { transformReadDisplayedContent } from '../../../components/questions/types/read-displayed-content/transform';
-import { transformSpontaneousQA } from '../../../components/questions/types/spontaneous-qa/transform';
-import { transformSpeakingConversation } from '../../../components/questions/types/speaking-conversation/transform';
-import { transformSpeakingCueCard } from '../../../components/questions/types/speaking-cue-card/transform';
-import { transformGNSpeakingInterview } from '../../../components/questions/types/gn-speaking-interview/transform';
-import { transformWordFillStructuredForm } from '../../../components/questions/types/word-fill-structured-form/transform';
-// ─── Handler map ────────────────────────────────────────────────────────────
-const questionTransformHandlers = {
-    // Look picture
-    LOOK_PICTURE_CHOOSE_CORRECT_ANSWER: transformLookPictureChooseCorrectAnswer,
-    LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER: transformLookPictureFillBlankChooseAnswer,
-    LOOK_PICTURE_FILL_WORD_HINT: transformLookPictureFillWordHint,
-    // Reading
-    READ_AND_COLOR_OBJECTS: transformReadAndColorObjects,
-    IMAGE_OBJECT_MATCHING: transformReadAndColorObjects,
-    READ_PASSAGE_AND_ANSWER_QUESTIONS: transformReadPassageAndAnswerQuestions,
-    // Fill / Write / General
-    ARRANGE_LETTERS_INTO_WORDS: transformArrangeLettersIntoWords,
-    WRITE_SHORT_PARAGRAPH: transformWriteShortParagraph,
-    WRITE_A_SHORT_LETTER: transformWriteAShortLetter,
-    FILL_MISSING_WORDS_IN_GRID: transformFillMissingWordsInGrid,
-    LABEL_THE_PICTURE: transformLabelThePicture,
-    CHOOSE_THE_CORRECT_ANSWER: transformChooseTheCorrectAnswer,
-    FILL_IN_BLANK: transformFillInBlank,
-    WRITE_CORRECT_VERB_FORM: transformWriteCorrectVerbForm,
-    CHOOSE_CORRECT_ADJECTIVE: transformChooseCorrectAdjective,
-    ANSWER_THE_QUESTION: transformAnswerTheQuestion,
-    TRUE_FALSE: transformTrueFalse,
-    WORD_ORDERING: transformWordOrdering,
-    WORD_FILL_PARAGRAPH: transformWordFillParagraph,
-    MATCH_BY_WRITING_ANSWER: transformMatchByWritingAnswer,
-    WRITE_SENTENCES: transformWriteSentences,
-    LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP: transformListenAndChooseFromAnswerGroup,
-    LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE: transformListenAndChooseObjectsInScene,
-    LISTEN_AND_DRAG_OBJECTS_INTO_SCENE: transformListenAndDragObjectsIntoScene,
-    LISTEN_AND_SPEAK_ANSWER: transformListenAndSpeakAnswer,
-    LISTEN_AND_SPEAK_IMAGE_GROUP: transformListenAndSpeakImageGroup,
-    LISTEN_AND_SPEAK_QUESTION_LIST: transformListenAndSpeakQuestionList,
-    LISTEN_AND_SPEAK_COMPARE_IMAGES: transformListenAndSpeakCompareImages,
-    LISTEN_AND_SPEAK_ODD_ONE_OUT: transformListenAndSpeakOddOneOut,
-    LISTEN_AND_SPEAK_WITH_STORY_IMAGES: transformListenAndSpeakWithStoryImages,
-    LISTEN_AND_SPEAK_INFO_EXCHANGE: transformListenAndSpeakInfoExchange,
-    SPEAKING_DESCRIBE_IMAGE: transformSpeakingDescribeImage,
-    READ_DISPLAYED_CONTENT: transformReadDisplayedContent,
-    SPONTANEOUS_QA: transformSpontaneousQA,
-    SPEAKING_CONVERSATION: transformSpeakingConversation,
-    SPEAKING_CUE_CARD: transformSpeakingCueCard,
-    GN_SPEAKING_INTERVIEW: transformGNSpeakingInterview,
-    WORD_FILL_STRUCTURED_FORM: transformWordFillStructuredForm,
-};
-/**
- * Transform frontend question format to API format.
- * API expects camelCase: questionType, content, correctAnswer, points, explanation, questionNumber.
- */
-export function transformQuestionToApiFormat(question, options = {}) {
-    const { partId, partNo, questionNumber, addToQuestionBank, questionBankCode, questionBankTitle, sectionId } = options;
-    const { id, type, points, explanation } = question;
-    const handler = type ? questionTransformHandlers[type] : undefined;
-    const handlerResult = handler ? handler(question) : { apiContent: {}, apiCorrectAnswer: {} };
-    const { apiContent, apiCorrectAnswer, totalPoints, hintLetters, groupNumber, passageData, imageData, basicGroupData, questionListGroupData, sceneData, answerGroupData, compareImagesGroupData, infoExchangeGroupData, conversationGroupData, isExample, suggestedAnswers, } = handlerResult;
-    const answerData = question.answer;
-    const contentData = question.content;
-    const handlerExplanation = handlerResult.explanation;
-    const finalExplanation = handlerExplanation || explanation || answerData?.explanation || contentData?.explanation || '';
-    const finalPoints = totalPoints ?? points ?? 1;
-    const payload = {
-        id,
-        questionType: type || '',
-        content: apiContent,
-        correctAnswer: apiCorrectAnswer || {},
-        points: finalPoints,
-        explanation: finalExplanation,
-        questionNumber,
-        partId,
-        partNo,
-        ...(sectionId != null ? { sectionId } : {}),
-        questionSkillType: question.skill,
-        addToQuestionBank: addToQuestionBank ?? false,
-        questionBank: addToQuestionBank && questionBankCode && questionBankTitle
-            ? { code: questionBankCode, title: questionBankTitle }
-            : undefined,
-        isExample: isExample || false,
-    };
-    if (suggestedAnswers && suggestedAnswers.length > 0) {
-        payload.suggestedAnswers = suggestedAnswers;
-    }
-    const groupPayload = resolveQuestionGroupPayload({
-        hintLetters,
-        passageData,
-        imageData,
-        basicGroupData,
-        sceneData,
-        answerGroupData,
-        questionListGroupData,
-        compareImagesGroupData,
-        infoExchangeGroupData,
-        conversationGroupData,
-    });
-    if (groupPayload) {
-        payload.isGroup = true;
-        payload.questionGroup = { payload: groupPayload, groupNumber: groupNumber || 1 };
-    }
-    return payload;
-}
-function resolveQuestionGroupPayload(sources) {
-    const { hintLetters, passageData, imageData, basicGroupData, sceneData, answerGroupData, questionListGroupData, compareImagesGroupData, infoExchangeGroupData, conversationGroupData, } = sources;
-    if (hintLetters && hintLetters.length > 0)
-        return { hintLetters };
-    if (passageData)
-        return passageData;
-    if (imageData)
-        return imageData;
-    if (basicGroupData && (basicGroupData.title || basicGroupData.subtitle || basicGroupData.content || basicGroupData.imageUrl || basicGroupData.articles)) {
-        return basicGroupData;
-    }
-    if (sceneData)
-        return sceneData;
-    if (answerGroupData)
-        return answerGroupData;
-    if (questionListGroupData)
-        return questionListGroupData;
-    if (compareImagesGroupData)
-        return compareImagesGroupData;
-    if (infoExchangeGroupData)
-        return infoExchangeGroupData;
-    if (conversationGroupData)
-        return conversationGroupData;
-    return undefined;
-}
-/**
- * Transform multiple questions to API format. Mirrors the reference FE behaviour
- * but without the standalone validation pass (validation lives in the creator UI).
- */
-export function transformQuestionsToApiFormat(questions) {
-    const validQuestions = [];
-    questions.forEach((item, index) => {
-        const { question, partId, partNo, sectionId, addToQuestionBank, questionBankCode, questionBankTitle } = item;
-        const questionNumber = question.questionNumber ?? index + 1;
-        validQuestions.push(transformQuestionToApiFormat(question, { partId, partNo, questionNumber, addToQuestionBank, questionBankCode, questionBankTitle, sectionId }));
-    });
-    return { validQuestions, invalidQuestions: [] };
-}
+import{validateQuestionForTransform as o}from"./question-transform-validation";import{transformLookPictureChooseCorrectAnswer as t}from"../../../components/questions/types/look-picture-choose-correct-answer/transform";import{transformLookPictureFillBlankChooseAnswer as s}from"../../../components/questions/types/look-picture-fill-blank-choose-answer/transform";import{transformLookPictureFillWordHint as e}from"../../../components/questions/types/look-picture-fill-word-hint/transform";import{transformReadAndColorObjects as n}from"../../../components/questions/types/read-and-color-objects/transform";import{transformReadPassageAndAnswerQuestions as r}from"../../../components/questions/types/read-passage-and-answer-questions/transform";import{transformArrangeLettersIntoWords as a}from"../../../components/questions/types/arrange-letters-into-words/transform";import{transformWriteShortParagraph as i}from"../../../components/questions/types/write-short-paragraph/transform";import{transformWriteAShortLetter as p}from"../../../components/questions/types/write-a-short-letter/transform";import{transformFillMissingWordsInGrid as m}from"../../../components/questions/types/fill-missing-words-in-grid/transform";import{transformLabelThePicture as u}from"../../../components/questions/types/label-the-picture/transform";import{transformChooseTheCorrectAnswer as c}from"../../../components/questions/types/choose-the-correct-answer/transform";import{transformFillInBlank as _}from"../../../components/questions/types/fill-in-blank/transform";import{transformWriteCorrectVerbForm as E}from"../../../components/questions/types/write-correct-verb-form/transform";import{transformChooseCorrectAdjective as f}from"../../../components/questions/types/choose-correct-adjective/transform";import{transformAnswerTheQuestion as N}from"../../../components/questions/types/answer-the-question/transform";import{transformTrueFalse as A}from"../../../components/questions/types/true-false/transform";import{transformWordOrdering as I}from"../../../components/questions/types/word-ordering/transform";import{transformWordFillParagraph as d}from"../../../components/questions/types/word-fill-paragraph/transform";import{transformMatchByWritingAnswer as T}from"../../../components/questions/types/match-by-writing-answer/transform";import{transformWriteSentences as l}from"../../../components/questions/types/write-sentences/transform";import{transformListenAndChooseFromAnswerGroup as S}from"../../../components/questions/types/listen-and-choose-from-answer-group/transform";import{transformListenAndChooseObjectsInScene as R}from"../../../components/questions/types/listen-and-choose-objects-in-scene/transform";import{transformListenAndDragObjectsIntoScene as q}from"../../../components/questions/types/listen-and-drag-objects-into-scene/transform";import{transformListenAndSpeakAnswer as D}from"../../../components/questions/types/listen-and-speak-answer/transform";import{transformListenAndSpeakImageGroup as O}from"../../../components/questions/types/listen-and-speak-image-group/transform";import{transformListenAndSpeakQuestionList as L}from"../../../components/questions/types/listen-and-speak-question-list/transform";import{transformListenAndSpeakCompareImages as y}from"../../../components/questions/types/listen-and-speak-compare-images/transform";import{transformListenAndSpeakOddOneOut as C}from"../../../components/questions/types/listen-and-speak-odd-one-out/transform";import{transformListenAndSpeakWithStoryImages as G}from"../../../components/questions/types/listen-and-speak-with-story-images/transform";import{transformListenAndSpeakInfoExchange as g}from"../../../components/questions/types/listen-and-speak-info-exchange/transform";import{transformSpeakingDescribeImage as w}from"../../../components/questions/types/speaking-describe-image/transform";import{transformReadDisplayedContent as h}from"../../../components/questions/types/read-displayed-content/transform";import{transformSpontaneousQA as k}from"../../../components/questions/types/spontaneous-qa/transform";import{transformSpeakingConversation as P}from"../../../components/questions/types/speaking-conversation/transform";import{transformSpeakingCueCard as b}from"../../../components/questions/types/speaking-cue-card/transform";import{transformGNSpeakingInterview as B}from"../../../components/questions/types/gn-speaking-interview/transform";import{transformWordFillStructuredForm as W}from"../../../components/questions/types/word-fill-structured-form/transform";const v={LOOK_PICTURE_CHOOSE_CORRECT_ANSWER:t,LOOK_PICTURE_FILL_BLANK_CHOOSE_ANSWER:s,LOOK_PICTURE_FILL_WORD_HINT:e,READ_AND_COLOR_OBJECTS:n,IMAGE_OBJECT_MATCHING:n,READ_PASSAGE_AND_ANSWER_QUESTIONS:r,ARRANGE_LETTERS_INTO_WORDS:a,WRITE_SHORT_PARAGRAPH:i,WRITE_A_SHORT_LETTER:p,FILL_MISSING_WORDS_IN_GRID:m,LABEL_THE_PICTURE:u,CHOOSE_THE_CORRECT_ANSWER:c,FILL_IN_BLANK:_,WRITE_CORRECT_VERB_FORM:E,CHOOSE_CORRECT_ADJECTIVE:f,ANSWER_THE_QUESTION:N,TRUE_FALSE:A,WORD_ORDERING:I,WORD_FILL_PARAGRAPH:d,MATCH_BY_WRITING_ANSWER:T,WRITE_SENTENCES:l,LISTEN_AND_CHOOSE_FROM_ANSWER_GROUP:S,LISTEN_AND_CHOOSE_OBJECTS_IN_SCENE:R,LISTEN_AND_DRAG_OBJECTS_INTO_SCENE:q,LISTEN_AND_SPEAK_ANSWER:D,LISTEN_AND_SPEAK_IMAGE_GROUP:O,LISTEN_AND_SPEAK_QUESTION_LIST:L,LISTEN_AND_SPEAK_COMPARE_IMAGES:y,LISTEN_AND_SPEAK_ODD_ONE_OUT:C,LISTEN_AND_SPEAK_WITH_STORY_IMAGES:G,LISTEN_AND_SPEAK_INFO_EXCHANGE:g,SPEAKING_DESCRIBE_IMAGE:w,READ_DISPLAYED_CONTENT:h,SPONTANEOUS_QA:k,SPEAKING_CONVERSATION:P,SPEAKING_CUE_CARD:b,GN_SPEAKING_INTERVIEW:B,WORD_FILL_STRUCTURED_FORM:W};export function transformQuestionToApiFormat(o,t={}){const{partId:s,partNo:e,questionNumber:n,addToQuestionBank:r,questionBankCode:a,questionBankTitle:i,sectionId:p,examLevel:m,subjectId:u}=t,{id:c,type:_,points:E,explanation:f}=o,N=_?v[_]:void 0,A=N?N(o):{apiContent:{},apiCorrectAnswer:{}},{apiContent:I,apiCorrectAnswer:d,totalPoints:T,hintLetters:l,groupNumber:S,passageData:R,imageData:q,basicGroupData:D,questionListGroupData:O,sceneData:L,answerGroupData:y,compareImagesGroupData:C,infoExchangeGroupData:G,conversationGroupData:g,isExample:w,suggestedAnswers:h}=A,k=o.answer,P=o.content,b={id:c,questionType:_||"",content:I,correctAnswer:d||{},points:T??E??1,explanation:A.explanation||f||k?.explanation||P?.explanation||"",questionNumber:n,partId:s,partNo:e,...null!=p?{sectionId:p}:{},questionSkillType:o.skill,examLevel:m,subjectId:u,addToQuestionBank:r??!1,questionBank:r&&a&&i?{code:a,title:i}:void 0,isExample:w||!1};h&&h.length>0&&(b.suggestedAnswers=h);const B=function(o){const{hintLetters:t,passageData:s,imageData:e,basicGroupData:n,sceneData:r,answerGroupData:a,questionListGroupData:i,compareImagesGroupData:p,infoExchangeGroupData:m,conversationGroupData:u}=o;if(t&&t.length>0)return{hintLetters:t};if(s)return s;if(e)return e;if(n&&(n.title||n.subtitle||n.content||n.imageUrl||n.articles))return n;return r||(a||(i||(p||(m||(u||void 0)))))}({hintLetters:l,passageData:R,imageData:q,basicGroupData:D,sceneData:L,answerGroupData:y,questionListGroupData:O,compareImagesGroupData:C,infoExchangeGroupData:G,conversationGroupData:g});return B&&(b.isGroup=!0,b.questionGroup={payload:B,groupNumber:S||1}),b}export function transformQuestionsToApiFormat(t){const s=[],e=[];return t.forEach((t,n)=>{const{question:r,partId:a,partNo:i,sectionId:p,addToQuestionBank:m,questionBankCode:u,questionBankTitle:c,examLevel:_,subjectId:E}=t,f=o(r);if(!f.isValid)return void e.push({index:n,errors:f.errors});const N=r.questionNumber??n+1;s.push(transformQuestionToApiFormat(r,{partId:a,partNo:i,questionNumber:N,addToQuestionBank:m,questionBankCode:u,questionBankTitle:c,sectionId:p,examLevel:_,subjectId:E}))}),{validQuestions:s,invalidQuestions:e}}