@tinyweb_dev/oe-exam-sdk 0.1.28 → 0.1.29

package/dist/components/exams/rooms/contest-rooms.utils.js

@@ -1 +1,93 @@
-export function unwrap(t){return function(t){return"object"==typeof t&&null!==t&&"data"in t}(t)?t.data:t}export function canRetakeRoom(t,i){return!0===t.allowMultipleSubmissions||!1!==t.allowMultipleSubmissions&&!0===i?.allowMultipleSubmissions}export function canEnterRoom(t,i){const e=canRetakeRoom(t,i);return!(t.isCompleted&&!e)&&(!t.isLocked&&"IN_PROGRESS"===t.status&&("internal"!==t.visibility||"APPROVED"===t.registrationStatus))}export function needsRegisterAndEnter(t,i){return!1}export function needsRegistration(t){return"internal"===t.visibility&&!t.registrationStatus}export function hasRegistrationStatus(t){return"internal"===t.visibility&&!!t.registrationStatus&&"APPROVED"!==t.registrationStatus}export function canCancelRegistration(t){return!t.hasAttempt&&!t.isCompleted&&("PENDING"===t.registrationStatus||"APPROVED"===t.registrationStatus)}export function isUserEngaged(t){return!(!t.isCompleted&&!t.hasAttempt)||("APPROVED"===t.registrationStatus||"PENDING"===t.registrationStatus)}export function getRoomSortPriority(t){return t.hasAttempt&&"IN_PROGRESS"===t.attemptStatus?0:"IN_PROGRESS"!==t.status||t.isLocked||t.isCompleted||"internal"===t.visibility&&"APPROVED"!==t.registrationStatus?("internal"!==t.visibility||"APPROVED"!==t.registrationStatus||t.isCompleted)&&("internal"===t.visibility||t.hasAttempt||"UPCOMING"!==t.status)?"internal"===t.visibility&&"PENDING"===t.registrationStatus?3:t.isCompleted||t.hasAttempt?4:"internal"!==t.visibility||t.registrationStatus?"internal"===t.visibility&&"REJECTED"===t.registrationStatus?6:"COMPLETED"===t.status||t.isLocked?7:8:5:2:1}export function getCountdownParts(t){const i=new Date(t).getTime()-Date.now();return i<=0?null:{days:Math.floor(i/864e5),hours:Math.floor(i%864e5/36e5),minutes:Math.floor(i%36e5/6e4),seconds:Math.floor(i%6e4/1e3)}}
+export function unwrap(value) {
+    return hasData(value) ? value.data : value;
+}
+function hasData(value) {
+    return typeof value === 'object' && value !== null && 'data' in value;
+}
+/** Whether a student can retake a room (room override, falling back to contest default). */
+export function canRetakeRoom(room, contest) {
+    if (room.allowMultipleSubmissions === true)
+        return true;
+    if (room.allowMultipleSubmissions === false)
+        return false;
+    return contest?.allowMultipleSubmissions === true;
+}
+/** Whether the student can enter the room right now (status + registration gating). */
+export function canEnterRoom(room, contest) {
+    const retake = canRetakeRoom(room, contest);
+    if (room.isCompleted && !retake)
+        return false;
+    if (room.isLocked || room.status !== 'IN_PROGRESS')
+        return false;
+    if (room.visibility === 'internal')
+        return room.registrationStatus === 'APPROVED';
+    return true;
+}
+/**
+ * Public/private rooms need no student-initiated registration — the student
+ * enters directly (the backend auto-approves participation on first attempt).
+ * Registration is an internal-room concept only, so this is always false and
+ * public/private rooms fall through to the plain "enter" button. Kept as a
+ * named helper so the container's button logic reads intently.
+ */
+export function needsRegisterAndEnter(_room, _contest) {
+    return false;
+}
+/** Internal room the student hasn't requested registration for yet. */
+export function needsRegistration(room) {
+    return room.visibility === 'internal' && !room.registrationStatus;
+}
+/** Internal room registration is pending/rejected (i.e. not approved yet). */
+export function hasRegistrationStatus(room) {
+    return room.visibility === 'internal' && !!room.registrationStatus && room.registrationStatus !== 'APPROVED';
+}
+/** Whether a "cancel registration" action should be offered. */
+export function canCancelRegistration(room) {
+    if (room.hasAttempt || room.isCompleted)
+        return false;
+    return room.registrationStatus === 'PENDING' || room.registrationStatus === 'APPROVED';
+}
+/** Whether the student has any meaningful engagement with this room. */
+export function isUserEngaged(room) {
+    if (room.isCompleted || room.hasAttempt)
+        return true;
+    return room.registrationStatus === 'APPROVED' || room.registrationStatus === 'PENDING';
+}
+/** Sort priority for a room; lower = shown first. */
+export function getRoomSortPriority(room) {
+    if (room.hasAttempt && room.attemptStatus === 'IN_PROGRESS')
+        return 0;
+    if (room.status === 'IN_PROGRESS' && !room.isLocked && !room.isCompleted) {
+        if (room.visibility !== 'internal' || room.registrationStatus === 'APPROVED')
+            return 1;
+    }
+    if (room.visibility === 'internal' && room.registrationStatus === 'APPROVED' && !room.isCompleted)
+        return 2;
+    if (room.visibility !== 'internal' && !room.hasAttempt && room.status === 'UPCOMING')
+        return 2;
+    if (room.visibility === 'internal' && room.registrationStatus === 'PENDING')
+        return 3;
+    if (room.isCompleted)
+        return 4;
+    if (room.hasAttempt)
+        return 4;
+    if (room.visibility === 'internal' && !room.registrationStatus)
+        return 5;
+    if (room.visibility === 'internal' && room.registrationStatus === 'REJECTED')
+        return 6;
+    if (room.status === 'COMPLETED' || room.isLocked)
+        return 7;
+    return 8;
+}
+/** Human-friendly seconds-remaining breakdown for a room's start countdown. */
+export function getCountdownParts(targetIso) {
+    const diff = new Date(targetIso).getTime() - Date.now();
+    if (diff <= 0)
+        return null;
+    return {
+        days: Math.floor(diff / 86400000),
+        hours: Math.floor((diff % 86400000) / 3600000),
+        minutes: Math.floor((diff % 3600000) / 60000),
+        seconds: Math.floor((diff % 60000) / 1000),
+    };
+}

package/dist/components/exams/rooms/index.js

@@ -1 +1,2 @@
-export{StudentContestRoomsPageContainer}from"./StudentContestRoomsPageContainer";export{canCancelRegistration,canEnterRoom,canRetakeRoom,getCountdownParts,getRoomSortPriority,hasRegistrationStatus,isUserEngaged,needsRegisterAndEnter,needsRegistration,unwrap}from"./contest-rooms.utils";
+export { StudentContestRoomsPageContainer } from './StudentContestRoomsPageContainer';
+export { canCancelRegistration, canEnterRoom, canRetakeRoom, getCountdownParts, getRoomSortPriority, hasRegistrationStatus, isUserEngaged, needsRegisterAndEnter, needsRegistration, unwrap, } from './contest-rooms.utils';

package/dist/components/exams/take/ExamTakingApiContext.js

@@ -1 +1,25 @@
-"use client";import{jsx as r}from"react/jsx-runtime";import{createContext as i,useContext as n}from"react";const e=i(null);export function ExamTakingApiProvider({api:i,children:n}){return r(e.Provider,{value:i,children:n})}export function useExamTakingApiOptional(){return n(e)}export function useExamTakingApi(){const r=n(e);if(!r)throw new Error("useExamTakingApi must be used within an <ExamTakingApiProvider>.");return r}
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { createContext, useContext } from 'react';
+/**
+ * Carries the injected {@link ExamTakingSdkApi} down to descendants (e.g. the
+ * speaking recorder) that are rendered deep inside question renderers, so those
+ * components can reach the host app's API without prop-drilling through every
+ * layer or importing a concrete `attemptsApi` client.
+ */
+const ExamTakingApiContext = createContext(null);
+export function ExamTakingApiProvider({ api, children }) {
+    return _jsx(ExamTakingApiContext.Provider, { value: api, children: children });
+}
+/** Returns the injected API, or `null` when rendered outside a provider. */
+export function useExamTakingApiOptional() {
+    return useContext(ExamTakingApiContext);
+}
+/** Returns the injected API; throws when rendered outside a provider. */
+export function useExamTakingApi() {
+    const api = useContext(ExamTakingApiContext);
+    if (!api) {
+        throw new Error('useExamTakingApi must be used within an <ExamTakingApiProvider>.');
+    }
+    return api;
+}