academe-kit 0.11.7 → 0.12.1

package/dist/index.d.ts

@@ -72,7 +72,7 @@ declare function CosmicStarsCanvas({ containerRef }: CosmicStarsCanvasProps): re
 type FrameKind = 'sphere' | 'pentagon' | 'hexagonWings' | 'circleLaurel' | 'hexagonRibbon' | 'shieldWings' | 'pentagonCrown';
 
 type JourneyStepSize = 'sm' | 'md';
-type JourneyStepType = 'challenge' | 'course' | 'tutorial' | 'publication' | 'evaluation' | 'certificate';
+type JourneyStepType = 'challenge' | 'course' | 'tutorial' | 'publication' | 'evaluation' | 'certificate' | 'redirect';
 interface JourneyStepProps {
     color?: string;
     stepType?: JourneyStepType;
@@ -2503,6 +2503,7 @@ interface paths {
          * Add a step to the challenge
          * @description Polymorphic validation:
          *     - When step.type=tutorial, tutorialVideoUrl is required
+         *     - When step.type=redirect, redirectUrl is required
          *     - The course of a step is determined by the parent challenge's courseId.
          *       Optionally, courseModuleId pinpoints a specific module within that course.
          *     - tutorial fields are optional on any step type.
@@ -2533,6 +2534,8 @@ interface paths {
                         tutorialTitle?: string;
                         tutorialDescription?: string;
                         tutorialVideoUrl?: string;
+                        /** @description Required when parent step type=redirect */
+                        redirectUrl?: string;
                         /** @default true */
                         isActive?: boolean;
                     };
@@ -9805,6 +9808,69 @@ interface paths {
         };
         trace?: never;
     };
+    "/quiz-questions/bulk": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Bulk create quiz questions
+         * @description Cria várias perguntas (com suas respostas) de uma vez para um quiz. A ordem é atribuída sequencialmente a partir da última pergunta existente.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        quizId: string;
+                        questions: {
+                            text: string;
+                            /** @enum {string} */
+                            type: "multiple_choice" | "true_false" | "open";
+                            points?: number;
+                            options?: {
+                                text?: string;
+                                is_correct?: boolean;
+                            }[];
+                        }[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Perguntas criadas */
+                201: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestion"][];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/quiz-questions": {
         parameters: {
             query?: never;
@@ -9899,67 +9965,6 @@ interface paths {
         patch?: never;
         trace?: never;
     };
-    "/quiz-questions/bulk": {
-        parameters: {
-            query?: never;
-            header?: never;
-            path?: never;
-            cookie?: never;
-        };
-        get?: never;
-        put?: never;
-        /**
-         * Bulk create quiz questions
-         * @description Cria várias perguntas (com respostas) de uma vez para um quiz.
-         */
-        post: {
-            parameters: {
-                query?: never;
-                header?: never;
-                path?: never;
-                cookie?: never;
-            };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        quizId: string;
-                        questions: {
-                            text: string;
-                            type: "multiple_choice" | "true_false" | "open";
-                            points?: number;
-                            options?: {
-                                text: string;
-                                is_correct: boolean;
-                            }[];
-                        }[];
-                    };
-                };
-            };
-            responses: {
-                /** @description Questions created */
-                201: {
-                    headers: {
-                        [name: string]: unknown;
-                    };
-                    content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            data?: components["schemas"]["QuizQuestion"][];
-                        };
-                    };
-                };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                500: components["responses"]["ServerError"];
-            };
-        };
-        delete?: never;
-        options?: never;
-        head?: never;
-        patch?: never;
-        trace?: never;
-    };
     "/quiz-questions/{id}": {
         parameters: {
             query?: never;
@@ -10181,7 +10186,7 @@ interface paths {
         };
         /**
          * List quizzes with course/module/category context
-         * @description Retrieve a paginated list of quizzes, each enriched with the course, module and category it belongs to. `context` is null for standalone quizzes.
+         * @description Retrieve a paginated list of quizzes, each enriched with the course, module and category it belongs to. The relation is resolved on the server (Course.quizId / CourseModule.quizId), so consumers don't need to load every course to build the link map. `context` is null for standalone quizzes.
          */
         get: {
             parameters: {
@@ -10217,16 +10222,20 @@ interface paths {
                             data?: (components["schemas"]["Quiz"] & {
                                 context?: {
                                     course?: {
+                                        /** Format: uuid */
                                         id?: string;
                                         title?: string;
                                     } | null;
                                     module?: {
+                                        /** Format: uuid */
                                         id?: string;
                                         title?: string;
                                     } | null;
                                     category?: {
+                                        /** Format: uuid */
                                         id?: string;
                                         name?: string;
+                                        /** @example #44bd32 */
                                         color?: string | null;
                                     } | null;
                                 } | null;
@@ -10258,7 +10267,7 @@ interface paths {
         put?: never;
         /**
          * Generate quiz questions with AI
-         * @description Gera perguntas a partir de um texto base via IA. Não persiste — apenas devolve.
+         * @description Gera perguntas de quiz a partir de um texto base usando IA (OpenRouter). NÃO persiste nada — apenas devolve as perguntas geradas para revisão no frontend. A chave da IA vive apenas no servidor.
          */
         post: {
             parameters: {
@@ -10270,16 +10279,23 @@ interface paths {
             requestBody: {
                 content: {
                     "application/json": {
+                        /** @description Texto base para gerar as perguntas */
                         text: string;
                         numQuestions: number;
+                        /**
+                         * @default normal
+                         * @enum {string}
+                         */
                         difficulty?: "facil" | "normal" | "dificil";
+                        /** @description Textos de perguntas já existentes (para não repetir) */
                         existingQuestions?: string[];
+                        /** @description Modelo de IA a usar (OpenRouter); default do servidor quando omitido */
                         model?: string;
                     };
                 };
             };
             responses: {
-                /** @description Generated questions */
+                /** @description Perguntas geradas */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -10289,12 +10305,13 @@ interface paths {
                             /** @example success */
                             status?: string;
                             data?: {
-                                question_text: string;
-                                question_type: "multiple_choice" | "true_false";
-                                points: number;
-                                options: {
-                                    text: string;
-                                    is_correct: boolean;
+                                question_text?: string;
+                                /** @enum {string} */
+                                question_type?: "multiple_choice" | "true_false";
+                                points?: number;
+                                options?: {
+                                    text?: string;
+                                    is_correct?: boolean;
                                 }[];
                             }[];
                         };
@@ -11996,7 +12013,7 @@ interface paths {
             parameters: {
                 query?: {
                     /** @description Filter by step type */
-                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                     /** @description Filter by active status */
                     isActive?: boolean;
                 };
@@ -12045,7 +12062,7 @@ interface paths {
                         /** @example play-circle */
                         icon: string;
                         /** @enum {string} */
-                        type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                        type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                         /** @default true */
                         isActive?: boolean;
                     };
@@ -12172,7 +12189,7 @@ interface paths {
                         color?: string;
                         icon?: string;
                         /** @enum {string} */
-                        type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                        type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                         isActive?: boolean;
                     };
                 };
@@ -15797,6 +15814,11 @@ interface components {
             id?: string;
             /** @example Essential Skills */
             name?: string;
+            /**
+             * @description Hex color code for backoffice display. Null when not set.
+             * @example #44bd32
+             */
+            color?: string | null;
             /** Format: date-time */
             createdAt?: string;
             /** Format: date-time */
@@ -16068,7 +16090,7 @@ interface components {
             /** @example play-circle */
             icon?: string;
             /** @enum {string} */
-            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
             /** @example true */
             isActive?: boolean;
             /** Format: date-time */
@@ -16166,6 +16188,8 @@ interface components {
             tutorialDescription?: string | null;
             /** @description Obrigatório quando step type=tutorial */
             tutorialVideoUrl?: string | null;
+            /** @description Obrigatório quando step type=redirect. URL para onde o aluno é redirecionado ao clicar na etapa. */
+            redirectUrl?: string | null;
             isActive?: boolean;
             /** Format: date-time */
             createdAt?: string;
@@ -16263,7 +16287,7 @@ interface components {
              * @example course
              * @enum {string}
              */
-            type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+            type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
             /**
              * @description Cor hex do step catalog
              * @example #8030D8
@@ -16295,6 +16319,11 @@ interface components {
              * @example Introdução a IA
              */
             courseModuleName?: string | null;
+            /**
+             * @description URL de redirecionamento desta etapa (apenas quando type=redirect)
+             * @example https://exemplo.com/atividade
+             */
+            redirectUrl?: string | null;
         };
         /** @description Desafio da jornada com suas etapas e status computados */
         JourneyChallengeView: {
@@ -23210,12 +23239,12 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                     "application/json": {
                         status?: string;
                         data?: {
-                            question_text: string;
-                            question_type: "multiple_choice" | "true_false";
-                            points: number;
-                            options: {
-                                text: string;
-                                is_correct: boolean;
+                            question_text?: string;
+                            question_type?: "multiple_choice" | "true_false";
+                            points?: number;
+                            options?: {
+                                text?: string;
+                                is_correct?: boolean;
                             }[];
                         }[];
                     };
@@ -23543,8 +23572,8 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                         type: "multiple_choice" | "true_false" | "open";
                         points?: number;
                         options?: {
-                            text: string;
-                            is_correct: boolean;
+                            text?: string;
+                            is_correct?: boolean;
                         }[];
                     }[];
                 };
@@ -23574,8 +23603,8 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                 type: "multiple_choice" | "true_false" | "open";
                 points?: number;
                 options?: {
-                    text: string;
-                    is_correct: boolean;
+                    text?: string;
+                    is_correct?: boolean;
                 }[];
             }[];
         };
@@ -26637,6 +26666,7 @@ declare function createChallengeService(apiClient: AcademeApiClient): {
                     tutorialTitle?: string;
                     tutorialDescription?: string;
                     tutorialVideoUrl?: string;
+                    redirectUrl?: string;
                     isActive?: boolean;
                 };
             };
@@ -26671,6 +26701,7 @@ declare function createChallengeService(apiClient: AcademeApiClient): {
             tutorialTitle?: string;
             tutorialDescription?: string;
             tutorialVideoUrl?: string;
+            redirectUrl?: string;
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;
@@ -27034,7 +27065,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
     getAll(params?: GetStepsParams): Promise<openapi_fetch.FetchResponse<{
         parameters: {
             query?: {
-                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                 isActive?: boolean;
             };
             header?: never;
@@ -27060,7 +27091,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
     }, {
         params: {
             query: {
-                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                 isActive?: boolean;
             } | undefined;
         };
@@ -27118,7 +27149,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
                     name: string;
                     color: string;
                     icon: string;
-                    type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                    type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                     isActive?: boolean;
                 };
             };
@@ -27144,7 +27175,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
             name: string;
             color: string;
             icon: string;
-            type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+            type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;
@@ -27166,7 +27197,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
                     name?: string;
                     color?: string;
                     icon?: string;
-                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                     isActive?: boolean;
                 };
             };
@@ -27198,7 +27229,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
             name?: string;
             color?: string;
             icon?: string;
-            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;

package/dist/index.esm.js

@@ -10739,6 +10739,7 @@ const STEP_TYPE_TO_THEME = {
     publication: 'orange',
     evaluation: 'gold',
     certificate: 'green',
+    redirect: 'blue',
 };
 // Espelha a página de journey do app: todo step é uma esfera 3D, diferenciada
 // apenas por cor (STEP_TYPE_TO_THEME) e ícone. Os frames de polígono seguem
@@ -10750,6 +10751,7 @@ const STEP_TYPE_TO_FRAME = {
     publication: 'sphere',
     evaluation: 'sphere',
     certificate: 'sphere',
+    redirect: 'sphere',
 };
 const INACTIVE_THEME = {
     shadow: '#0a0a0a',