@tinyweb_dev/oe-exam-sdk 0.1.28 → 0.1.30

package/README.md

@@ -1,6 +1,6 @@
 # @tinyweb_dev/oe-exam-sdk
 
-SDK tái sử dụng cho hệ thống OE Exam: màn tạo đề, quản lý câu hỏi, làm bài, xem kết quả, theme giao diện và MCP tools.
+SDK tái sử dụng cho hệ thống OE Exam: màn tạo đề, quản lý câu hỏi, làm bài, xem kết quả và theme giao diện.
 
 ## Cài đặt
 
@@ -240,16 +240,16 @@ Các report shell, renderer, transform helper, polling/status helper và result-
 
 ## MCP server
 
-SDK expose bin:
+MCP đã tách sang package riêng:
 
 ```bash
-oe-exam-mcp
+npm install @tinyweb_dev/oe-exam-mcp-server
 ```
 
 Chạy bằng PAT/API token. Nếu token có dạng `oeexam_...`, MCP tự gửi qua `X-API-Key`; token khác sẽ gửi qua `Authorization: Bearer`.
 
 ```bash
-OE_API_URL=http://localhost:3000 OE_API_TOKEN=... npx oe-exam-mcp
+OE_API_URL=http://localhost:3000 OE_API_TOKEN=... npx @tinyweb_dev/oe-exam-mcp-server
 ```
 
 Tools hiện có:

package/dist/api/contest-rooms.js

@@ -1 +1,54 @@
-import{API_BASE_URL as t,API_ENDPOINTS as e}from"../shared/constants/ApiConstant";export function createContestRoomsApi(n={}){const o=function({baseUrl:e=t??"",fetcher:n=fetch,headers:o}){return async function(t,s){const r=await n(`${e}${t}`,{credentials:"include",...s,headers:{"Content-Type":"application/json",...o,...s?.headers}});if(!r.ok)throw new Error(await async function(t){const e=await t.json().catch(()=>{});if("object"==typeof e&&null!==e&&"message"in e&&"string"==typeof e.message)return e.message;return t.statusText}(r));if(204!==r.status)return r.json()}}(n);return{getContestDetail:t=>o(e.STUDENT.CONTEST_DETAIL(t)),getContestRooms:t=>o(e.STUDENT.CONTEST_ROOMS(t)),registerRoom:(t,n)=>o(e.STUDENT.CONTEST_ROOM_REGISTER(t,n),{method:"POST"}),cancelRoomRegistration:(t,n)=>o(e.STUDENT.CONTEST_ROOM_REGISTER(t,n),{method:"DELETE"})}}export function createMockContestRoomsApi(t){const e=[...t.rooms];return{getContestDetail:async()=>t.contest,getContestRooms:async()=>e,registerRoom:async(t,n)=>{const o=e.find(t=>t.id===n);o&&(o.registrationStatus="PENDING")},cancelRoomRegistration:async(t,n)=>{const o=e.find(t=>t.id===n);o&&(o.registrationStatus=null)}}}
+import { API_BASE_URL, API_ENDPOINTS } from '../shared/constants/ApiConstant';
+/**
+ * Default fetch-based adapter for the student contest rooms-list flow. Mirrors
+ * the host app endpoints used by the original `/student/contests/:contestId/rooms`
+ * page: contest detail, room list and room registration.
+ */
+export function createContestRoomsApi(options = {}) {
+    const request = createRequest(options);
+    return {
+        getContestDetail: (contestId) => request(API_ENDPOINTS.STUDENT.CONTEST_DETAIL(contestId)),
+        getContestRooms: (contestId) => request(API_ENDPOINTS.STUDENT.CONTEST_ROOMS(contestId)),
+        registerRoom: (contestId, roomId) => request(API_ENDPOINTS.STUDENT.CONTEST_ROOM_REGISTER(contestId, roomId), { method: 'POST' }),
+        cancelRoomRegistration: (contestId, roomId) => request(API_ENDPOINTS.STUDENT.CONTEST_ROOM_REGISTER(contestId, roomId), { method: 'DELETE' }),
+    };
+}
+/** In-memory mock adapter for demo/storybook/tests. */
+export function createMockContestRoomsApi(seed) {
+    const rooms = [...seed.rooms];
+    return {
+        getContestDetail: async () => seed.contest,
+        getContestRooms: async () => rooms,
+        registerRoom: async (_contestId, roomId) => {
+            const room = rooms.find((r) => r.id === roomId);
+            if (room)
+                room.registrationStatus = 'PENDING';
+        },
+        cancelRoomRegistration: async (_contestId, roomId) => {
+            const room = rooms.find((r) => r.id === roomId);
+            if (room)
+                room.registrationStatus = null;
+        },
+    };
+}
+function createRequest({ baseUrl = API_BASE_URL ?? '', fetcher = fetch, headers }) {
+    return async function request(path, init) {
+        const response = await fetcher(`${baseUrl}${path}`, {
+            credentials: 'include',
+            ...init,
+            headers: { 'Content-Type': 'application/json', ...headers, ...init?.headers },
+        });
+        if (!response.ok)
+            throw new Error(await readErrorMessage(response));
+        if (response.status === 204)
+            return undefined;
+        return response.json();
+    };
+}
+async function readErrorMessage(response) {
+    const body = await response.json().catch(() => undefined);
+    if (typeof body === 'object' && body !== null && 'message' in body && typeof body.message === 'string') {
+        return body.message;
+    }
+    return response.statusText;
+}

package/dist/api/contest-rooms.types.js

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

package/dist/api/exam-create.js

@@ -1 +1,179 @@
-import{API_BASE_URL as e,API_ENDPOINTS as t}from"../shared/constants/ApiConstant";const a=["PRE_A1","A1","A2","B1","B2","C1","C2"].map(e=>({id:e,name:"PRE_A1"===e?"Pre-A1":e}));export function createExamCreateApi(n={}){const s=function({baseUrl:t=e??"",fetcher:a=fetch,headers:n,apiKey:s}){return async function(e,i){const o=s?{"X-API-Key":s}:void 0,r=await a(`${t}${e}`,{...s?{}:{credentials:"include"},...i,headers:{"Content-Type":"application/json",...o,...n,...i?.headers}});if(!r.ok)throw new Error(await async function(e){const t=await e.json().catch(()=>{});return"object"==typeof t&&null!==t&&"message"in t&&"string"==typeof t.message?t.message:e.statusText}(r));return r.json()}}(n);return{getExamLevels:async()=>a,getExamTemplates:async({page:e,search:a})=>{const n=e||1,i=new URLSearchParams({page:String(n),size:String(9)});a&&i.set("filter",`name:like:${a}`);const o=await s(`${t.SHARED.EXAM_TEMPLATES}?${i}`),r=Array.isArray(o.data)?o.data:o.data.data,l=o.meta??{},p=l.totalItems??r.length;return{items:r,page:l.page??n,totalPages:l.totalPages??Math.max(1,Math.ceil(p/9)),totalItems:p}},getExamTemplateDetail:e=>s(t.SHARED.EXAM_TEMPLATE_DETAIL(e)),createExam:e=>s(t.MANAGE.EXAMS,{method:"POST",body:JSON.stringify(i(e))}),updateExamTemplate:async({examId:e,template:a})=>{await s(t.MANAGE.EXAM_TEMPLATE(e),{method:"PATCH",body:JSON.stringify({template:a})})}}}export function createMockCreateExamApi(e){let t=1;return{getExamLevels:async()=>e.levels??a,getExamTemplates:async({page:t,search:a})=>{const s=e.templates.filter(e=>!a||e.name.toLowerCase().includes(a.toLowerCase())).map(n),i=t||1,o=s.length,r=Math.max(1,Math.ceil(o/9)),l=9*(i-1);return{items:s.slice(l,l+9),page:i,totalPages:r,totalItems:o}},getExamTemplateDetail:async t=>{const a=e.templates.find(e=>e.id===t);if(!a)throw new Error(`Mock exam template not found: ${t}`);return{data:s(a)}},createExam:async e=>({data:{id:"mock-exam-"+t++,code:e.code,name:e.name,examLevel:e.examLevel,difficulty:e.difficulty,totalScore:e.totalScore,durationMinutes:e.durationMinutes,description:e.description,examTemplateId:e.examTemplateId}}),updateExamTemplate:async()=>{}}}function n(e){return{id:e.id,title:e.name,subTitle:e.description,theme:e.theme,type:e.type,totalQuestions:e.totalQuestions,totalParts:e.parts.length,examLevel:e.level??""}}function s(e){return{id:e.id,title:e.name,subTitle:e.description,description:e.description,theme:e.theme,type:e.type,totalQuestions:e.totalQuestions,totalParts:e.parts.length,examLevel:e.level??"",parts:e.parts.map(e=>({...e,title:e.name}))}}export function buildExamTemplatePayload(e){return{id:e.id,title:e.name,subTitle:"",theme:e.theme||"",totalQuestions:e.totalQuestions,totalParts:e.parts.length,description:e.description||"",examLevel:e.level||"",type:e.type,parts:e.parts.map(e=>({...e,name:e.name||"",category:e.category||"",instructions:e.instructions||"",skill:e.skill||"",questionCount:e.questionCount,isGroup:e.isGroup??!1}))}}export function mapTemplateDetailToExamTemplate(e){return{id:e.id,name:e.title,description:e.description||e.subTitle||"",theme:e.theme,totalQuestions:e.totalQuestions,totalTime:0,level:e.examLevel,type:e.type,parts:(e.parts??[]).map(e=>({id:e.id,name:e.name||e.title||"",description:e.description||"",questionCount:e.questionCount,questionType:e.questionType,skill:e.skill,startIndex:e.startIndex,endIndex:e.endIndex,points:e.points,audioUrl:e.audioUrl,optionCount:e.optionCount,optionMode:e.optionMode,defaultValue:e.defaultValue,defaultQuestion:e.defaultQuestion,viewMode:e.viewMode,instructions:e.instructions,group:e.group,groups:e.groups,groupConfig:e.groupConfig,groupType:e.groupType,articleCount:e.articleCount,questionConfig:e.questionConfig,isGroup:e.isGroup,suggestedAnswers:e.suggestedAnswers,hasSuggestedAnswers:e.hasSuggestedAnswers,category:e.category,sections:e.sections}))}}function i(e){return Object.fromEntries(Object.entries(e).filter(([,e])=>void 0!==e&&""!==e))}
+import { API_BASE_URL, API_ENDPOINTS } from '../shared/constants/ApiConstant';
+const TEMPLATES_PAGE_SIZE = 9;
+const EXAM_LEVELS = ['PRE_A1', 'A1', 'A2', 'B1', 'B2', 'C1', 'C2'].map((id) => ({ id, name: id === 'PRE_A1' ? 'Pre-A1' : id }));
+export function createExamCreateApi(options = {}) {
+    const request = createRequest(options);
+    return {
+        getExamLevels: async () => EXAM_LEVELS,
+        getExamTemplates: async ({ page, search }) => {
+            const currentPage = page || 1;
+            const query = new URLSearchParams({ page: String(currentPage), size: String(TEMPLATES_PAGE_SIZE) });
+            if (search)
+                query.set('filter', `name:like:${search}`);
+            const result = await request(`${API_ENDPOINTS.SHARED.EXAM_TEMPLATES}?${query}`);
+            const items = Array.isArray(result.data) ? result.data : result.data.data;
+            const meta = result.meta ?? {};
+            const totalItems = meta.totalItems ?? items.length;
+            return {
+                items,
+                page: meta.page ?? currentPage,
+                totalPages: meta.totalPages ?? Math.max(1, Math.ceil(totalItems / TEMPLATES_PAGE_SIZE)),
+                totalItems,
+            };
+        },
+        getExamTemplateDetail: (id) => request(API_ENDPOINTS.SHARED.EXAM_TEMPLATE_DETAIL(id)),
+        createExam: (payload) => request(API_ENDPOINTS.MANAGE.EXAMS, {
+            method: 'POST',
+            body: JSON.stringify(cleanPayload(payload)),
+        }),
+        updateExamTemplate: async ({ examId, template }) => {
+            await request(API_ENDPOINTS.MANAGE.EXAM_TEMPLATE(examId), {
+                method: 'PATCH',
+                body: JSON.stringify({ template }),
+            });
+        },
+    };
+}
+export function createMockCreateExamApi(seed) {
+    let nextId = 1;
+    return {
+        getExamLevels: async () => seed.levels ?? EXAM_LEVELS,
+        getExamTemplates: async ({ page, search }) => {
+            const filtered = seed.templates
+                .filter((template) => !search || template.name.toLowerCase().includes(search.toLowerCase()))
+                .map(examTemplateToSummary);
+            const currentPage = page || 1;
+            const totalItems = filtered.length;
+            const totalPages = Math.max(1, Math.ceil(totalItems / TEMPLATES_PAGE_SIZE));
+            const start = (currentPage - 1) * TEMPLATES_PAGE_SIZE;
+            return {
+                items: filtered.slice(start, start + TEMPLATES_PAGE_SIZE),
+                page: currentPage,
+                totalPages,
+                totalItems,
+            };
+        },
+        getExamTemplateDetail: async (id) => {
+            const template = seed.templates.find((t) => t.id === id);
+            if (!template)
+                throw new Error(`Mock exam template not found: ${id}`);
+            return { data: examTemplateToDetail(template) };
+        },
+        createExam: async (payload) => ({ data: { id: `mock-exam-${nextId++}`, code: payload.code, name: payload.name, examLevel: payload.examLevel, difficulty: payload.difficulty, totalScore: payload.totalScore, durationMinutes: payload.durationMinutes, description: payload.description, examTemplateId: payload.examTemplateId } }),
+        updateExamTemplate: async () => undefined,
+    };
+}
+/** Derive a list-row summary from a full mock `ExamTemplate`. */
+function examTemplateToSummary(template) {
+    return {
+        id: template.id,
+        title: template.name,
+        subTitle: template.description,
+        theme: template.theme,
+        type: template.type,
+        totalQuestions: template.totalQuestions,
+        totalParts: template.parts.length,
+        examLevel: template.level ?? '',
+    };
+}
+/** Derive a detail DTO from a full mock `ExamTemplate` (carries parts through). */
+function examTemplateToDetail(template) {
+    return {
+        id: template.id,
+        title: template.name,
+        subTitle: template.description,
+        description: template.description,
+        theme: template.theme,
+        type: template.type,
+        totalQuestions: template.totalQuestions,
+        totalParts: template.parts.length,
+        examLevel: template.level ?? '',
+        parts: template.parts.map((part) => ({ ...part, title: part.name })),
+    };
+}
+export function buildExamTemplatePayload(template) {
+    return {
+        id: template.id,
+        title: template.name,
+        subTitle: '',
+        theme: template.theme || '',
+        totalQuestions: template.totalQuestions,
+        totalParts: template.parts.length,
+        description: template.description || '',
+        examLevel: template.level || '',
+        type: template.type,
+        parts: template.parts.map((part) => ({ ...part, name: part.name || '', category: part.category || '', instructions: part.instructions || '', skill: part.skill || '', questionCount: part.questionCount, isGroup: part.isGroup ?? false })),
+    };
+}
+/**
+ * Map the template detail DTO (`title`/`subTitle`/`examLevel`/`parts[].title`) returned by
+ * `getExamTemplateDetail` into the full `ExamTemplate` entity the create flow expects
+ * (`name`/`description`/`level`/`parts[].name`). Ported from the original oe-exam-fe
+ * `TemplateSelector.handleConfirm`. Mapping is lenient (`|| ''`, optional fields) so a missing
+ * field never throws.
+ */
+export function mapTemplateDetailToExamTemplate(detail) {
+    return {
+        id: detail.id,
+        name: detail.title,
+        description: detail.description || detail.subTitle || '',
+        theme: detail.theme,
+        totalQuestions: detail.totalQuestions,
+        totalTime: 0,
+        level: detail.examLevel,
+        type: detail.type,
+        parts: (detail.parts ?? []).map((part) => ({
+            id: part.id,
+            name: part.name || part.title || '',
+            description: part.description || '',
+            questionCount: part.questionCount,
+            questionType: part.questionType,
+            skill: part.skill,
+            startIndex: part.startIndex,
+            endIndex: part.endIndex,
+            points: part.points,
+            audioUrl: part.audioUrl,
+            optionCount: part.optionCount,
+            optionMode: part.optionMode,
+            defaultValue: part.defaultValue,
+            defaultQuestion: part.defaultQuestion,
+            viewMode: part.viewMode,
+            instructions: part.instructions,
+            group: part.group,
+            groups: part.groups,
+            groupConfig: part.groupConfig,
+            groupType: part.groupType,
+            articleCount: part.articleCount,
+            questionConfig: part.questionConfig,
+            isGroup: part.isGroup,
+            suggestedAnswers: part.suggestedAnswers,
+            hasSuggestedAnswers: part.hasSuggestedAnswers,
+            category: part.category,
+            sections: part.sections,
+        })),
+    };
+}
+function createRequest({ baseUrl = API_BASE_URL ?? '', fetcher = fetch, headers, apiKey }) {
+    return async function request(path, init) {
+        const authHeaders = apiKey ? { 'X-API-Key': apiKey } : undefined;
+        const response = await fetcher(`${baseUrl}${path}`, {
+            // When authenticating via API key, do NOT send browser cookies.
+            ...(apiKey ? {} : { credentials: 'include' }),
+            ...init,
+            headers: { 'Content-Type': 'application/json', ...authHeaders, ...headers, ...init?.headers },
+        });
+        if (!response.ok) {
+            throw new Error(await readErrorMessage(response));
+        }
+        return response.json();
+    };
+}
+async function readErrorMessage(response) {
+    const body = await response.json().catch(() => undefined);
+    if (typeof body === 'object' && body !== null && 'message' in body && typeof body.message === 'string')
+        return body.message;
+    return response.statusText;
+}
+function cleanPayload(payload) {
+    return Object.fromEntries(Object.entries(payload).filter(([, value]) => value !== undefined && value !== ''));
+}

package/dist/api/exam-create.types.js

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

package/dist/api/exam-entry.js

@@ -1 +1,68 @@
-import{API_BASE_URL as t,API_ENDPOINTS as e}from"../shared/constants/ApiConstant";export function createExamEntryApi(n={}){const o=function({baseUrl:e=t??"",fetcher:n=fetch,headers:o}){return async function(t,a){const r=await n(`${e}${t}`,{credentials:"include",...a,headers:{"Content-Type":"application/json",...o,...a?.headers}});if(!r.ok)throw new Error(await async function(t){const e=await t.json().catch(()=>{});if("object"==typeof e&&null!==e&&"message"in e&&"string"==typeof e.message)return e.message;return t.statusText}(r));if(204!==r.status)return r.json()}}(n);return{getRoom:t=>o(e.STUDENT.ROOM_DETAIL(t)),getActiveAttemptByRoom:t=>o(e.STUDENT.ATTEMPTS_ACTIVE_BY_ROOM(t)),startAttempt:t=>o(e.STUDENT.ATTEMPTS_START,{method:"POST",body:JSON.stringify({examRoomId:t})}),deleteAttempt:t=>o(e.STUDENT.ATTEMPT_DELETE(t),{method:"DELETE"}),joinViaInvite:(t,n)=>o(e.STUDENT.ROOM_JOIN_INVITE(t,n),{method:"POST"}),registerContest:(t,n)=>o(e.STUDENT.CONTEST_REGISTER(t),{method:"POST",body:JSON.stringify(n)})}}export function createMockExamEntryApi(t){let e=t.attempt??null;return{getRoom:async()=>t.room,getActiveAttemptByRoom:async()=>e,startAttempt:async()=>(e={id:`mock-attempt-${Date.now()}`,startedAt:(new Date).toISOString(),durationMinutes:t.room.exam?.durationMinutes??30,examRoomId:t.room.id,status:"IN_PROGRESS"},e),deleteAttempt:async()=>{e=null},joinViaInvite:async()=>{},registerContest:async()=>{}}}
+import { API_BASE_URL, API_ENDPOINTS } from '../shared/constants/ApiConstant';
+/**
+ * Default fetch-based adapter for the student exam entry flow. Mirrors the host
+ * app endpoints used by the original `/student/exams/:roomId/enter` page:
+ * room detail, active attempt by room, start/delete attempt, invite join and
+ * contest registration.
+ */
+export function createExamEntryApi(options = {}) {
+    const request = createRequest(options);
+    return {
+        getRoom: (roomId) => request(API_ENDPOINTS.STUDENT.ROOM_DETAIL(roomId)),
+        getActiveAttemptByRoom: (roomId) => request(API_ENDPOINTS.STUDENT.ATTEMPTS_ACTIVE_BY_ROOM(roomId)),
+        startAttempt: (roomId) => request(API_ENDPOINTS.STUDENT.ATTEMPTS_START, {
+            method: 'POST',
+            body: JSON.stringify({ examRoomId: roomId }),
+        }),
+        deleteAttempt: (attemptId) => request(API_ENDPOINTS.STUDENT.ATTEMPT_DELETE(attemptId), { method: 'DELETE' }),
+        joinViaInvite: (roomId, inviteToken) => request(API_ENDPOINTS.STUDENT.ROOM_JOIN_INVITE(roomId, inviteToken), { method: 'POST' }),
+        registerContest: (contestId, formData) => request(API_ENDPOINTS.STUDENT.CONTEST_REGISTER(contestId), {
+            method: 'POST',
+            body: JSON.stringify(formData),
+        }),
+    };
+}
+/** In-memory mock adapter for demo/storybook/tests. */
+export function createMockExamEntryApi(seed) {
+    let activeAttempt = seed.attempt ?? null;
+    return {
+        getRoom: async () => seed.room,
+        getActiveAttemptByRoom: async () => activeAttempt,
+        startAttempt: async () => {
+            activeAttempt = {
+                id: `mock-attempt-${Date.now()}`,
+                startedAt: new Date().toISOString(),
+                durationMinutes: seed.room.exam?.durationMinutes ?? 30,
+                examRoomId: seed.room.id,
+                status: 'IN_PROGRESS',
+            };
+            return activeAttempt;
+        },
+        deleteAttempt: async () => {
+            activeAttempt = null;
+        },
+        joinViaInvite: async () => undefined,
+        registerContest: async () => undefined,
+    };
+}
+function createRequest({ baseUrl = API_BASE_URL ?? '', fetcher = fetch, headers }) {
+    return async function request(path, init) {
+        const response = await fetcher(`${baseUrl}${path}`, {
+            credentials: 'include',
+            ...init,
+            headers: { 'Content-Type': 'application/json', ...headers, ...init?.headers },
+        });
+        if (!response.ok)
+            throw new Error(await readErrorMessage(response));
+        if (response.status === 204)
+            return undefined;
+        return response.json();
+    };
+}
+async function readErrorMessage(response) {
+    const body = await response.json().catch(() => undefined);
+    if (typeof body === 'object' && body !== null && 'message' in body && typeof body.message === 'string') {
+        return body.message;
+    }
+    return response.statusText;
+}

package/dist/api/exam-entry.types.js

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

package/dist/api/exam-questions.js

@@ -1 +1,149 @@
-import{API_BASE_URL as t,API_ENDPOINTS as e}from"../shared/constants/ApiConstant";import{transformQuestionToApiFormat as s}from"../shared/lib/utils/question-transform";import{transformApiQuestionsToFrontend as a}from"../shared/lib/utils/question-reverse-transform";export function createExamQuestionsApi(n={}){const i=function({baseUrl:e=t??"",fetcher:s=fetch,headers:a,apiKey:n}){return async function(t,i){const o=n?{"X-API-Key":n}:void 0,r=await s(`${e}${t}`,{...n?{}:{credentials:"include"},...i,headers:{"Content-Type":"application/json",...o,...a,...i?.headers}});if(!r.ok){const t=await r.json().catch(()=>({}));throw new Error(t.message||r.statusText)}return r.json()}}(n);return{getExam:t=>i(e.MANAGE.EXAM_DETAIL(t)),getQuestions:async t=>{const s=await i(e.MANAGE.EXAM_QUESTIONS(t)),n=Array.isArray(s.data)?s.data:s.data.questions??[];return a(n)},saveQuestion:async t=>{const{examId:a,question:n,template:o}=t;if(!a)throw new Error("examId is required");const r=s(n,function(t){const{question:e,template:s,addToQuestionBank:a,questionBankCode:n,questionBankTitle:i,sectionId:o,examLevel:r,subjectId:u}=t,d=s?.parts.findIndex(t=>t.id===e.partId)??-1,p=d>=0?d+1:void 0,c=e.sectionId;return{partId:e.partId,partNo:p,questionNumber:e.questionNumber,sectionId:o??c,addToQuestionBank:a,questionBankCode:n,questionBankTitle:i,examLevel:r,subjectId:u}}(t)),u=await i(e.MANAGE.EXAM_QUESTIONS(a),{method:"POST",body:JSON.stringify({examId:a,questions:[r]})});if((u.data.summary?.errorCount??0)>0)throw new Error("Unable to save question");const d=u.data.results?.[0]?.data,p={...n,id:d?.id??n.id,...d?.questionGroup?{questionGroup:d.questionGroup}:{},isCompleted:!0},c=(m=d?.questionBank,"object"!=typeof m||null===m||Array.isArray(m)?void 0:m);var m;return{question:p,questionBank:c?{id:String(c.id??""),code:String(c.code??""),title:String(c.title??"")}:void 0}},saveExam:async()=>{},updatePartAudio:t=>async function(t,{examId:s,partId:a,audioUrl:n,template:i}){await t(e.MANAGE.EXAM_TEMPLATE(s),{method:"PATCH",body:JSON.stringify({id:i.id,title:i.name,subTitle:"",theme:i.theme||"",totalQuestions:i.totalQuestions,totalParts:i.parts.length,description:i.description||"",examLevel:i.level||"",type:i.type,parts:i.parts.map(t=>({...t,audioUrl:t.id===a?n:t.audioUrl}))})})}(i,t),searchQuestions:async({questionType:t,keyword:s,page:a,size:n})=>{const o=new URLSearchParams;t&&o.set("questionType",t),s&&o.set("keyword",s),o.set("page",String(a)),o.set("size",String(n));const r=o.toString()?`?${o.toString()}`:"";return i(`${e.MANAGE.QUESTION_BANKS}${r}`)}}}export const createExamQuestionsFetchApi=createExamQuestionsApi;export function createMockExamQuestionsApi(t){const e=new Map((t.questions??[]).map(t=>[(t.questionNumber??1)-1,t]));let s=t.exam;return{getExam:async()=>({data:s}),getQuestions:async()=>Array.from(e.values()),saveQuestion:async({question:t,questionIndex:s})=>{const a={...t,questionNumber:t.questionNumber??s+1,isCompleted:!0};return e.set(s,a),{question:a}},saveExam:async()=>{},updatePartAudio:async({partId:t,audioUrl:e})=>{s.template&&"parts"in s.template&&(s={...s,template:{...s.template,parts:s.template.parts.map(s=>s.id===t?{...s,audioUrl:e}:s)}})},searchQuestions:async({questionType:t})=>({data:Array.from(e.values()).filter(e=>!t||e.type===t).map(t=>({id:t.id??String(t.questionNumber??""),questionType:t.type??"",content:t.content,correctAnswer:t.answer,points:t.points,difficulty:t.difficulty,skill:t.skill,explanation:t.explanation})),meta:{totalItems:e.size}})}}
+import { API_BASE_URL, API_ENDPOINTS } from '../shared/constants/ApiConstant';
+import { transformQuestionToApiFormat } from '../shared/lib/utils/question-transform';
+import { transformApiQuestionsToFrontend } from '../shared/lib/utils/question-reverse-transform';
+export function createExamQuestionsApi(options = {}) {
+    const request = createRequest(options);
+    return {
+        getExam: (examId) => request(API_ENDPOINTS.MANAGE.EXAM_DETAIL(examId)),
+        getQuestions: async (examId) => {
+            const result = await request(API_ENDPOINTS.MANAGE.EXAM_QUESTIONS(examId));
+            const questions = Array.isArray(result.data) ? result.data : result.data.questions ?? [];
+            return transformApiQuestionsToFrontend(questions);
+        },
+        saveQuestion: async (input) => {
+            const { examId, question, template } = input;
+            if (!examId)
+                throw new Error('examId is required');
+            const apiQuestion = transformQuestionToApiFormat(question, resolveTransformOptions(input));
+            const result = await request(API_ENDPOINTS.MANAGE.EXAM_QUESTIONS(examId), {
+                method: 'POST',
+                body: JSON.stringify({ examId, questions: [apiQuestion] }),
+            });
+            if ((result.data.summary?.errorCount ?? 0) > 0) {
+                throw new Error('Unable to save question');
+            }
+            const savedData = result.data.results?.[0]?.data;
+            const savedQuestion = {
+                ...question,
+                id: savedData?.id ?? question.id,
+                ...(savedData?.questionGroup ? { questionGroup: savedData.questionGroup } : {}),
+                isCompleted: true,
+            };
+            const savedQuestionBank = toRecord(savedData?.questionBank);
+            const questionBank = savedQuestionBank
+                ? {
+                    id: String(savedQuestionBank.id ?? ''),
+                    code: String(savedQuestionBank.code ?? ''),
+                    title: String(savedQuestionBank.title ?? ''),
+                }
+                : undefined;
+            return { question: savedQuestion, questionBank };
+        },
+        saveExam: async () => undefined,
+        updatePartAudio: (input) => updatePartAudio(request, input),
+        searchQuestions: async ({ questionType, keyword, page, size }) => {
+            const query = new URLSearchParams();
+            if (questionType)
+                query.set('questionType', questionType);
+            if (keyword)
+                query.set('keyword', keyword);
+            query.set('page', String(page));
+            query.set('size', String(size));
+            const suffix = query.toString() ? `?${query.toString()}` : '';
+            return request(`${API_ENDPOINTS.MANAGE.QUESTION_BANKS}${suffix}`);
+        },
+    };
+}
+export const createExamQuestionsFetchApi = createExamQuestionsApi;
+export function createMockExamQuestionsApi(seed) {
+    const questions = new Map((seed.questions ?? []).map((question) => [(question.questionNumber ?? 1) - 1, question]));
+    let exam = seed.exam;
+    return {
+        getExam: async () => ({ data: exam }),
+        getQuestions: async () => Array.from(questions.values()),
+        saveQuestion: async ({ question, questionIndex }) => {
+            const saved = { ...question, questionNumber: question.questionNumber ?? questionIndex + 1, isCompleted: true };
+            questions.set(questionIndex, saved);
+            return { question: saved };
+        },
+        saveExam: async () => undefined,
+        updatePartAudio: async ({ partId, audioUrl }) => {
+            if (!exam.template || !('parts' in exam.template))
+                return;
+            exam = {
+                ...exam,
+                template: {
+                    ...exam.template,
+                    parts: exam.template.parts.map((part) => part.id === partId ? { ...part, audioUrl } : part),
+                },
+            };
+        },
+        searchQuestions: async ({ questionType }) => ({
+            data: Array.from(questions.values())
+                .filter((question) => !questionType || question.type === questionType)
+                .map((question) => ({
+                id: question.id ?? String(question.questionNumber ?? ''),
+                questionType: question.type ?? '',
+                content: question.content,
+                correctAnswer: question.answer,
+                points: question.points,
+                difficulty: question.difficulty,
+                skill: question.skill,
+                explanation: question.explanation,
+            })),
+            meta: { totalItems: questions.size },
+        }),
+    };
+}
+function resolveTransformOptions(input) {
+    const { question, template, addToQuestionBank, questionBankCode, questionBankTitle, sectionId, examLevel, subjectId } = input;
+    const partIndex = template?.parts.findIndex((part) => part.id === question.partId) ?? -1;
+    const partNo = partIndex >= 0 ? partIndex + 1 : undefined;
+    const fallbackSectionId = question.sectionId;
+    return {
+        partId: question.partId,
+        partNo,
+        questionNumber: question.questionNumber,
+        sectionId: sectionId ?? fallbackSectionId,
+        addToQuestionBank,
+        questionBankCode,
+        questionBankTitle,
+        examLevel,
+        subjectId,
+    };
+}
+function createRequest({ baseUrl = API_BASE_URL ?? '', fetcher = fetch, headers, apiKey }) {
+    return async function request(path, init) {
+        const authHeaders = apiKey ? { 'X-API-Key': apiKey } : undefined;
+        const response = await fetcher(`${baseUrl}${path}`, {
+            ...(apiKey ? {} : { credentials: 'include' }),
+            ...init,
+            headers: { 'Content-Type': 'application/json', ...authHeaders, ...headers, ...init?.headers },
+        });
+        if (!response.ok) {
+            const body = await response.json().catch(() => ({}));
+            throw new Error(body.message || response.statusText);
+        }
+        return response.json();
+    };
+}
+function toRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value) ? value : undefined;
+}
+async function updatePartAudio(request, { examId, partId, audioUrl, template }) {
+    await request(API_ENDPOINTS.MANAGE.EXAM_TEMPLATE(examId), {
+        method: 'PATCH',
+        body: JSON.stringify({
+            id: template.id,
+            title: template.name,
+            subTitle: '',
+            theme: template.theme || '',
+            totalQuestions: template.totalQuestions,
+            totalParts: template.parts.length,
+            description: template.description || '',
+            examLevel: template.level || '',
+            type: template.type,
+            parts: template.parts.map((part) => ({ ...part, audioUrl: part.id === partId ? audioUrl : part.audioUrl })),
+        }),
+    });
+}

package/dist/api/exam-questions.types.js

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

package/dist/api/exam-taking.js

@@ -1 +1,84 @@
-import{API_BASE_URL as t,API_ENDPOINTS as e}from"../shared/constants/ApiConstant";export function createExamTakingApi(T={}){const n=function({baseUrl:e=t??"",fetcher:T=fetch,headers:n}){return async function(t,a){const o="undefined"!=typeof FormData&&a?.body instanceof FormData,s=await T(`${e}${t}`,{credentials:"include",...a,headers:{...!o&&{"Content-Type":"application/json"},...n,...a?.headers}});if(!s.ok)throw new Error(await async function(t){const e=await t.json().catch(()=>{});return"object"==typeof e&&null!==e&&"message"in e&&"string"==typeof e.message?e.message:t.statusText}(s));if(204!==s.status)return s.json()}}(T);return{getActiveAttempt:t=>n(e.STUDENT.ATTEMPTS_ACTIVE_BY_ROOM(t)),getActive:()=>n(e.STUDENT.ATTEMPTS_ACTIVE),getAttempt:(t,T)=>n(`${e.STUDENT.ATTEMPT_DETAIL(t)}${T?`?token=${encodeURIComponent(T)}`:""}`),deleteAttempt:t=>n(e.STUDENT.ATTEMPT_DELETE(t),{method:"DELETE"}),getRoom:t=>n(e.STUDENT.ROOM_DETAIL(t)),startAttempt:t=>n(e.STUDENT.ATTEMPTS_START,{method:"POST",body:JSON.stringify({examRoomId:t})}),getQuestions:t=>n(e.STUDENT.ATTEMPT_QUESTIONS(t)),saveAnswers:async({attemptId:t,answers:T,keepalive:a})=>{await n(e.STUDENT.ATTEMPT_ANSWERS(t),{method:"POST",keepalive:a,body:JSON.stringify({answers:T})})},submitAttempt:t=>n(e.STUDENT.ATTEMPT_SUBMIT(t),{method:"POST"}),cancelAttempt:t=>n(e.STUDENT.ATTEMPT_CANCEL(t),{method:"POST"}),uploadAudioAnswer:({attemptId:t,questionId:T,audioBlob:a,durationMs:o})=>{const s=new FormData,i="audio/webm"===a.type?"webm":"audio/ogg"===a.type?"ogg":"mp3";return s.append("file",a,`recording.${i}`),s.append("questionId",T),void 0!==o&&s.append("durationMs",String(o)),n(e.STUDENT.ATTEMPT_AUDIO_ANSWER(t),{method:"POST",body:s})},uploadProctoringSnapshot:({attemptId:t,imageBlob:T})=>{const a=new FormData;return a.append("file",T,"snapshot.jpg"),n(e.STUDENT.ATTEMPT_PROCTORING_SNAPSHOT(t),{method:"POST",body:a})},realtimeGradeSingle:({attemptId:t,questionId:T,audioKey:a})=>n(e.SHARED.SPEAKING_REALTIME_GRADE,{method:"POST",body:JSON.stringify({attemptId:t,questionId:T,audioKey:a})}),getGradingSummary:t=>n(e.STUDENT.ATTEMPT_GRADING_SUMMARY(t)),getAnswerDetail:(t,T)=>n(e.STUDENT.ATTEMPT_ANSWER_DETAIL(t,T)),getAnswersGradingStatus:(t,T)=>n(e.STUDENT.ATTEMPT_ANSWERS_GRADING_STATUS(t),{method:"POST",body:JSON.stringify({answerIds:T})})}}export function createMockExamTakingApi(t){const e=new Map;return{getActiveAttempt:async()=>t.attempt,startAttempt:async()=>t.attempt,getQuestions:async()=>t.questions,saveAnswers:async({answers:t})=>{t.forEach(t=>e.set(t.questionId,t.answer))},submitAttempt:async()=>({answers:Object.fromEntries(e)})}}
+import { API_BASE_URL, API_ENDPOINTS } from '../shared/constants/ApiConstant';
+export function createExamTakingApi(options = {}) {
+    const request = createRequest(options);
+    return {
+        getActiveAttempt: (examId) => request(API_ENDPOINTS.STUDENT.ATTEMPTS_ACTIVE_BY_ROOM(examId)),
+        getActive: () => request(API_ENDPOINTS.STUDENT.ATTEMPTS_ACTIVE),
+        getAttempt: (attemptId, token) => request(`${API_ENDPOINTS.STUDENT.ATTEMPT_DETAIL(attemptId)}${token ? `?token=${encodeURIComponent(token)}` : ''}`),
+        deleteAttempt: (attemptId) => request(API_ENDPOINTS.STUDENT.ATTEMPT_DELETE(attemptId), { method: 'DELETE' }),
+        getRoom: (roomId) => request(API_ENDPOINTS.STUDENT.ROOM_DETAIL(roomId)),
+        startAttempt: (examId) => request(API_ENDPOINTS.STUDENT.ATTEMPTS_START, {
+            method: 'POST',
+            body: JSON.stringify({ examRoomId: examId }),
+        }),
+        getQuestions: (attemptId) => request(API_ENDPOINTS.STUDENT.ATTEMPT_QUESTIONS(attemptId)),
+        saveAnswers: async ({ attemptId, answers, keepalive }) => {
+            await request(API_ENDPOINTS.STUDENT.ATTEMPT_ANSWERS(attemptId), {
+                method: 'POST',
+                keepalive,
+                body: JSON.stringify({ answers }),
+            });
+        },
+        submitAttempt: (attemptId) => request(API_ENDPOINTS.STUDENT.ATTEMPT_SUBMIT(attemptId), { method: 'POST' }),
+        cancelAttempt: (attemptId) => request(API_ENDPOINTS.STUDENT.ATTEMPT_CANCEL(attemptId), { method: 'POST' }),
+        uploadAudioAnswer: ({ attemptId, questionId, audioBlob, durationMs }) => {
+            const formData = new FormData();
+            const ext = audioBlob.type === 'audio/webm' ? 'webm' : audioBlob.type === 'audio/ogg' ? 'ogg' : 'mp3';
+            formData.append('file', audioBlob, `recording.${ext}`);
+            formData.append('questionId', questionId);
+            if (durationMs !== undefined)
+                formData.append('durationMs', String(durationMs));
+            return request(API_ENDPOINTS.STUDENT.ATTEMPT_AUDIO_ANSWER(attemptId), { method: 'POST', body: formData });
+        },
+        uploadGroupItemAudio: ({ attemptId, questionId, itemIndex, audioBlob, durationMs }) => {
+            const formData = new FormData();
+            const ext = audioBlob.type === 'audio/webm' ? 'webm' : audioBlob.type === 'audio/ogg' ? 'ogg' : 'mp3';
+            formData.append('file', audioBlob, `recording.${ext}`);
+            formData.append('questionId', questionId);
+            formData.append('itemIndex', String(itemIndex));
+            if (durationMs !== undefined)
+                formData.append('durationMs', String(durationMs));
+            return request(API_ENDPOINTS.STUDENT.ATTEMPT_AUDIO_ANSWER_ITEM(attemptId), { method: 'POST', body: formData });
+        },
+        uploadProctoringSnapshot: ({ attemptId, imageBlob }) => {
+            const formData = new FormData();
+            formData.append('file', imageBlob, 'snapshot.jpg');
+            return request(API_ENDPOINTS.STUDENT.ATTEMPT_PROCTORING_SNAPSHOT(attemptId), { method: 'POST', body: formData });
+        },
+        realtimeGradeSingle: ({ attemptId, questionId, audioKey }) => request(API_ENDPOINTS.SHARED.SPEAKING_REALTIME_GRADE, { method: 'POST', body: JSON.stringify({ attemptId, questionId, audioKey }) }),
+        getGradingSummary: (attemptId) => request(API_ENDPOINTS.STUDENT.ATTEMPT_GRADING_SUMMARY(attemptId)),
+        getAnswerDetail: (attemptId, answerId) => request(API_ENDPOINTS.STUDENT.ATTEMPT_ANSWER_DETAIL(attemptId, answerId)),
+        getAnswersGradingStatus: (attemptId, answerIds) => request(API_ENDPOINTS.STUDENT.ATTEMPT_ANSWERS_GRADING_STATUS(attemptId), { method: 'POST', body: JSON.stringify({ answerIds }) }),
+    };
+}
+export function createMockExamTakingApi(seed) {
+    const answers = new Map();
+    return {
+        getActiveAttempt: async () => seed.attempt,
+        startAttempt: async () => seed.attempt,
+        getQuestions: async () => seed.questions,
+        saveAnswers: async ({ answers: input }) => { input.forEach((item) => answers.set(item.questionId, item.answer)); },
+        submitAttempt: async () => ({ answers: Object.fromEntries(answers) }),
+    };
+}
+function createRequest({ baseUrl = API_BASE_URL ?? '', fetcher = fetch, headers }) {
+    return async function request(path, init) {
+        const isFormData = typeof FormData !== 'undefined' && init?.body instanceof FormData;
+        const response = await fetcher(`${baseUrl}${path}`, {
+            credentials: 'include',
+            ...init,
+            headers: { ...(!isFormData && { 'Content-Type': 'application/json' }), ...headers, ...init?.headers },
+        });
+        if (!response.ok)
+            throw new Error(await readErrorMessage(response));
+        if (response.status === 204)
+            return undefined;
+        return response.json();
+    };
+}
+async function readErrorMessage(response) {
+    const body = await response.json().catch(() => undefined);
+    if (typeof body === 'object' && body !== null && 'message' in body && typeof body.message === 'string')
+        return body.message;
+    return response.statusText;
+}

package/dist/api/exam-taking.types.d.ts

@@ -123,6 +123,13 @@ export interface ExamTakingSdkApi {
         audioBlob: Blob;
         durationMs?: number;
     }) => Promise<ApiData<UploadAudioAnswerResult> | UploadAudioAnswerResult>;
+    uploadGroupItemAudio?: (input: {
+        attemptId: string;
+        questionId: string;
+        itemIndex: number;
+        audioBlob: Blob;
+        durationMs?: number;
+    }) => Promise<ApiData<UploadAudioAnswerResult> | UploadAudioAnswerResult>;
     uploadProctoringSnapshot?: (input: {
         attemptId: string;
         imageBlob: Blob;

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

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

package/dist/api/index.js

@@ -1 +1,8 @@
-export*from"./exam-create";export*from"./exam-questions";export*from"./exam-taking";export*from"./exam-entry";export*from"./contest-rooms";export*from"./result-review";export*from"../shared/constants/ApiConstant";export*from"../shared/constants/QueryKeyConstant";
+export * from './exam-create';
+export * from './exam-questions';
+export * from './exam-taking';
+export * from './exam-entry';
+export * from './contest-rooms';
+export * from './result-review';
+export * from '../shared/constants/ApiConstant';
+export * from '../shared/constants/QueryKeyConstant';