academe-kit 0.16.0 → 0.17.0

package/dist/index.d.ts

@@ -11579,6 +11579,62 @@ interface paths {
         };
         trace?: never;
     };
+    "/quiz-questions/{id}/generate-explanations": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * Generate answer explanations with AI
+         * @description Preenche via IA a explicação de cada alternativa de uma pergunta que já existe — o backfill dos quizzes criados antes da feature. Sobrescreve as explicações existentes; o backoffice confirma antes de chamar.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: {
+                content: {
+                    "application/json": {
+                        /** @description Modelo OpenRouter a usar. Omitido, usa o padrão do servidor. */
+                        model?: string;
+                    };
+                };
+            };
+            responses: {
+                /** @description Pergunta com as alternativas atualizadas */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["QuizQuestion"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/quiz-questions/bulk": {
         parameters: {
             query?: never;
@@ -11612,6 +11668,8 @@ interface paths {
                             options?: {
                                 text?: string;
                                 is_correct?: boolean;
+                                /** @description Resumo revelado ao aluno ao confirmar a resposta. */
+                                explanation?: string;
                             }[];
                         }[];
                     };
@@ -12083,6 +12141,8 @@ interface paths {
                                 options?: {
                                     text?: string;
                                     is_correct?: boolean;
+                                    /** @description Resumo revelado ao aluno ao confirmar a resposta. String vazia quando a IA não produziu. */
+                                    explanation?: string;
                                 }[];
                             }[];
                         };
@@ -20456,6 +20516,11 @@ interface components {
             answer?: string;
             /** @example true */
             isCorrect?: boolean;
+            /**
+             * @description Resumo revelado ao aluno ao confirmar a resposta. Na alternativa correta explica o conceito; nas incorretas, o erro que a opção representa. NULL nas perguntas anteriores à feature.
+             * @example O 'S' significa 'Secure' e indica que o protocolo utiliza SSL/TLS.
+             */
+            explanation?: string | null;
             /** Format: date-time */
             createdAt?: string;
             /** Format: date-time */
@@ -20468,10 +20533,14 @@ interface components {
             answer: string;
             /** @example true */
             isCorrect: boolean;
+            /** @description Resumo revelado ao aluno ao confirmar a resposta. String vazia limpa. */
+            explanation?: string;
         };
         UpdateQuizQuestionAnswerDto: {
             answer?: string;
             isCorrect?: boolean;
+            /** @description Resumo revelado ao aluno ao confirmar a resposta. String vazia limpa. */
+            explanation?: string;
         };
         QuizAttempt: {
             /** Format: uuid */
@@ -25658,6 +25727,7 @@ type GetQuizzesParams = {
 type GetQuizzesWithContextParams = paths['/quiz/with-context']['get']['parameters']['query'];
 type GenerateQuizQuestionsBody = paths['/quiz/generate-questions']['post']['requestBody']['content']['application/json'];
 type BulkCreateQuizQuestionsBody = paths['/quiz-questions/bulk']['post']['requestBody']['content']['application/json'];
+type GenerateQuizExplanationsBody = NonNullable<paths['/quiz-questions/{id}/generate-explanations']['post']['requestBody']>['content']['application/json'];
 type GetQuizQuestionsParams = paths['/quiz-questions']['get']['parameters']['query'];
 type GetQuizQuestionAnswersParams = paths['/quiz-question-answers']['get']['parameters']['query'];
 type GetQuizAttemptsParams = paths['/quiz-attempts']['get']['parameters']['query'];
@@ -25804,6 +25874,7 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                             options?: {
                                 text?: string;
                                 is_correct?: boolean;
+                                explanation?: string;
                             }[];
                         }[];
                     };
@@ -26133,6 +26204,7 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                         options?: {
                             text?: string;
                             is_correct?: boolean;
+                            explanation?: string;
                         }[];
                     }[];
                 };
@@ -26164,10 +26236,60 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                 options?: {
                     text?: string;
                     is_correct?: boolean;
+                    explanation?: string;
                 }[];
             }[];
         };
     }, `${string}/${string}`>>;
+    /**
+     * Generate the explanation of every answer of an existing question, with AI.
+     *
+     * Backfill das perguntas criadas antes de a explicação existir. Sobrescreve
+     * o que houver — confirme com o usuário antes de chamar.
+     */
+    generateQuestionExplanations(id: string, body?: GenerateQuizExplanationsBody): Promise<openapi_fetch.FetchResponse<{
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                id: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: {
+            content: {
+                "application/json": {
+                    model?: string;
+                };
+            };
+        };
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        status?: string;
+                        data?: components["schemas"]["QuizQuestion"];
+                    };
+                };
+            };
+            400: components["responses"]["BadRequest"];
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["ServerError"];
+        };
+    }, {
+        params: {
+            path: {
+                id: string;
+            };
+        };
+        body: {
+            model?: string;
+        };
+    }, `${string}/${string}`>>;
     /**
      * Update quiz question
      */
@@ -26365,6 +26487,7 @@ declare function createQuizService(apiClient: AcademeApiClient): {
             questionId: string;
             answer: string;
             isCorrect: boolean;
+            explanation?: string;
         };
     }, `${string}/${string}`>>;
     /**
@@ -26410,6 +26533,7 @@ declare function createQuizService(apiClient: AcademeApiClient): {
         body: {
             answer?: string;
             isCorrect?: boolean;
+            explanation?: string;
         };
     }, `${string}/${string}`>>;
     /**

package/dist/index.esm.js

@@ -5515,6 +5515,18 @@ function createQuizService(apiClient) {
                 body,
             });
         },
+        /**
+         * Generate the explanation of every answer of an existing question, with AI.
+         *
+         * Backfill das perguntas criadas antes de a explicação existir. Sobrescreve
+         * o que houver — confirme com o usuário antes de chamar.
+         */
+        generateQuestionExplanations(id, body) {
+            return apiClient.POST('/quiz-questions/{id}/generate-explanations', {
+                params: { path: { id } },
+                body: body ?? {},
+            });
+        },
         /**
          * Update quiz question
          */