academe-kit 0.12.0 → 0.12.1

package/dist/types/services/ChallengeService.d.ts

@@ -397,6 +397,7 @@ export declare function createChallengeService(apiClient: AcademeApiClient): {
                     tutorialTitle?: string;
                     tutorialDescription?: string;
                     tutorialVideoUrl?: string;
+                    redirectUrl?: string;
                     isActive?: boolean;
                 };
             };
@@ -431,6 +432,7 @@ export declare function createChallengeService(apiClient: AcademeApiClient): {
             tutorialTitle?: string;
             tutorialDescription?: string;
             tutorialVideoUrl?: string;
+            redirectUrl?: string;
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;

package/dist/types/services/QuizService.d.ts

@@ -161,12 +161,12 @@ export 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;
                             }[];
                         }[];
                     };
@@ -494,8 +494,8 @@ export declare function createQuizService(apiClient: AcademeApiClient): {
                         type: "multiple_choice" | "true_false" | "open";
                         points?: number;
                         options?: {
-                            text: string;
-                            is_correct: boolean;
+                            text?: string;
+                            is_correct?: boolean;
                         }[];
                     }[];
                 };
@@ -525,8 +525,8 @@ export declare function createQuizService(apiClient: AcademeApiClient): {
                 type: "multiple_choice" | "true_false" | "open";
                 points?: number;
                 options?: {
-                    text: string;
-                    is_correct: boolean;
+                    text?: string;
+                    is_correct?: boolean;
                 }[];
             }[];
         };

package/dist/types/services/StepService.d.ts

@@ -10,7 +10,7 @@ export declare function createStepService(apiClient: AcademeApiClient): {
     getAll(params?: GetStepsParams): Promise<import("openapi-fetch").FetchResponse<{
         parameters: {
             query?: {
-                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                 isActive?: boolean;
             };
             header?: never;
@@ -36,7 +36,7 @@ export 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;
         };
@@ -94,7 +94,7 @@ export 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;
                 };
             };
@@ -120,7 +120,7 @@ export 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}`>>;
@@ -142,7 +142,7 @@ export 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;
                 };
             };
@@ -174,7 +174,7 @@ export 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/types/types/academe-api.d.ts

@@ -2335,6 +2335,7 @@ export 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.
@@ -2365,6 +2366,8 @@ export interface paths {
                         tutorialTitle?: string;
                         tutorialDescription?: string;
                         tutorialVideoUrl?: string;
+                        /** @description Required when parent step type=redirect */
+                        redirectUrl?: string;
                         /** @default true */
                         isActive?: boolean;
                     };
@@ -9637,6 +9640,69 @@ export 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;
@@ -9731,67 +9797,6 @@ export 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;
@@ -10013,7 +10018,7 @@ export 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: {
@@ -10049,16 +10054,20 @@ export 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;
@@ -10090,7 +10099,7 @@ export 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: {
@@ -10102,16 +10111,23 @@ export 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;
@@ -10121,12 +10137,13 @@ export 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;
                                 }[];
                             }[];
                         };
@@ -11828,7 +11845,7 @@ export 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;
                 };
@@ -11877,7 +11894,7 @@ export 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;
                     };
@@ -12004,7 +12021,7 @@ export 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;
                     };
                 };
@@ -15629,6 +15646,11 @@ export 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 */
@@ -15900,7 +15922,7 @@ export 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 */
@@ -15998,6 +16020,8 @@ export 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;
@@ -16127,7 +16151,10 @@ export interface components {
              * @example Introdução a IA
              */
             courseModuleName?: string | null;
-            /** @description URL de redirecionamento desta etapa (apenas quando type=redirect) */
+            /**
+             * @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 */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "academe-kit",
-  "version": "0.12.0",
+  "version": "0.12.1",
   "type": "module",
   "description": "Official React SDK for Academe ecosystem - Authentication, protected routes, API services, and UI components for educational management applications",
   "main": "dist/index.cjs",
@@ -99,4 +99,4 @@
     "tailwind-merge": "^3.3.1",
     "tailwindcss-animate": "^1.0.7"
   }
-}
+}