academe-kit 0.15.0 → 0.17.0

package/dist/index.d.ts

@@ -9403,7 +9403,7 @@ interface paths {
             };
             requestBody?: never;
             responses: {
-                /** @description provider, embedUrl, videoExternalId, startTimeSeconds, durationSeconds, progress */
+                /** @description provider, embedUrl, videoExternalId, startTimeSeconds, durationSeconds, progress e `ambient` (mídia do Ambient Glow — spriteUrlTemplate com placeholder `{n}`, thumbnailUrl e metadados da grade de seek; null quando o provider não é panda) */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -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;
                                 }[];
                             }[];
                         };
@@ -13906,85 +13966,486 @@ interface paths {
                 500: components["responses"]["ServerError"];
             };
         };
-        put?: never;
-        post?: never;
-        /**
-         * Delete a step
-         * @description Permanently remove a step from the catalog
-         */
-        delete: {
+        put?: never;
+        post?: never;
+        /**
+         * Delete a step
+         * @description Permanently remove a step from the catalog
+         */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Step deleted */
+                204: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        options?: never;
+        head?: never;
+        /**
+         * Update a step
+         * @description Partially update a step from the catalog
+         */
+        patch: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description Resource ID */
+                    id: components["parameters"]["id"];
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        name?: string;
+                        color?: string;
+                        icon?: string;
+                        /** @enum {string} */
+                        type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+                        isActive?: boolean;
+                    };
+                };
+            };
+            responses: {
+                /** @description Step updated */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["Step"];
+                        };
+                    };
+                };
+                400: components["responses"]["BadRequest"];
+                401: components["responses"]["Unauthorized"];
+                404: components["responses"]["NotFound"];
+                500: components["responses"]["ServerError"];
+            };
+        };
+        trace?: never;
+    };
+    "/studio/state": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Estado do Estúdio (publicado + MEUS rascunhos mesclados) */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description Escola do contexto (hero da escola + preview) */
+                    institutionId?: string;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description hero{global,institution,myDrafts} + playlists[{id,draft,items,meta{state,hasMyDraft,stale,othersDrafts}}] + layout{order,hasMyDraft} + myDraftCount */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Não é staff */
+                403: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/studio/drafts/playlist/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Upsert do MEU rascunho de uma playlist (id pode ser de playlist nova — isNew) */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** @enum {string} */
+                        op?: "upsert" | "delete";
+                        isNew?: boolean;
+                        playlist?: {
+                            title?: string;
+                            subtitle?: string | null;
+                            /** @enum {string} */
+                            status?: "draft" | "published";
+                            /** @enum {string} */
+                            source?: "curated" | "continue_watching" | "trending" | "watchlist" | "recent" | "continue_playlist";
+                            /** @enum {string} */
+                            variant?: "common" | "featured";
+                            /** @enum {string} */
+                            cardOrientation?: "horizontal" | "vertical" | "square" | "fullImage";
+                            itemsPerViewDesktop?: number;
+                            itemsPerViewMobile?: number;
+                            autoplay?: boolean;
+                            isGlobal?: boolean;
+                        };
+                        targets?: {
+                            institutionId?: string;
+                            organizationId?: string;
+                        }[];
+                        groupIds?: string[];
+                        /** @description ordem do array = position */
+                        items?: {
+                            courseId?: string;
+                            courseModuleId?: string;
+                            courseModuleLessonId?: string;
+                        }[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Rascunho salvo (não altera o publicado) */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/studio/drafts/hero": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Upsert do MEU rascunho do hero (institutionId no body; ausente = global) */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        /** Format: uuid */
+                        institutionId?: string | null;
+                        /** @enum {string} */
+                        op?: "upsert" | "delete";
+                        hero?: {
+                            eyebrow?: string | null;
+                            title?: string;
+                            subtitle?: string | null;
+                            ctaLabel?: string | null;
+                            ctaUrl?: string | null;
+                            /** @enum {string} */
+                            mediaType?: "gradient" | "image" | "video";
+                            mediaUrl?: string | null;
+                            mediaLoop?: boolean;
+                        };
+                    };
+                };
+            };
+            responses: {
+                /** @description Rascunho salvo */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/studio/drafts/layout": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        /** Upsert do MEU rascunho de ordem das rails (lista completa de ids) */
+        put: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody: {
+                content: {
+                    "application/json": {
+                        order?: string[];
+                    };
+                };
+            };
+            responses: {
+                /** @description Rascunho salvo */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/studio/drafts/{entityType}/{entityId}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        post?: never;
+        /** Desfaz UM rascunho meu (playlist/hero por entidade) */
+        delete: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    entityType: "playlist" | "hero" | "layout";
+                    entityId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description { deleted: n } */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/studio/discard": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Descarta TODOS os meus rascunhos */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description { discarded: n } */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/studio/publish": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Publica atomicamente os MEUS rascunhos (playlists+layout+heroes); nunca os de outro editor */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description { applied{...}, warnings[] (staleness/missing) } */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Nenhuma alteração para publicar */
+                409: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Falha (ex. conteúdo excluído) — nada foi aplicado */
+                422: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
+    "/studio/catalog": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Busca de conteúdo p/ o picker (cursos/módulos/aulas, com flag published) */
+        get: {
             parameters: {
-                query?: never;
-                header?: never;
-                path: {
-                    /** @description Resource ID */
-                    id: components["parameters"]["id"];
+                query?: {
+                    q?: string;
+                    kind?: "course" | "module" | "lesson";
+                    limit?: number;
+                    offset?: number;
                 };
+                header?: never;
+                path?: never;
                 cookie?: never;
             };
             requestBody?: never;
             responses: {
-                /** @description Step deleted */
-                204: {
+                /** @description { counts{courses,modules,lessons}, results[{kind,id,courseId,title,subtitle,coverUrl,published}] } */
+                200: {
                     headers: {
                         [name: string]: unknown;
                     };
                     content?: never;
                 };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                500: components["responses"]["ServerError"];
             };
         };
+        put?: never;
+        post?: never;
+        delete?: never;
         options?: never;
         head?: never;
-        /**
-         * Update a step
-         * @description Partially update a step from the catalog
-         */
-        patch: {
+        patch?: never;
+        trace?: never;
+    };
+    "/studio/audiences": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /** Chips de escopo do drawer (escolas, organizações e perfis) */
+        get: {
             parameters: {
                 query?: never;
                 header?: never;
-                path: {
-                    /** @description Resource ID */
-                    id: components["parameters"]["id"];
-                };
+                path?: never;
                 cookie?: never;
             };
-            requestBody: {
-                content: {
-                    "application/json": {
-                        name?: string;
-                        color?: string;
-                        icon?: string;
-                        /** @enum {string} */
-                        type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
-                        isActive?: boolean;
-                    };
-                };
-            };
+            requestBody?: never;
             responses: {
-                /** @description Step updated */
+                /** @description { institutions[], organizations[], groups[] } */
                 200: {
                     headers: {
                         [name: string]: unknown;
                     };
-                    content: {
-                        "application/json": {
-                            /** @example success */
-                            status?: string;
-                            data?: components["schemas"]["Step"];
-                        };
-                    };
+                    content?: never;
                 };
-                400: components["responses"]["BadRequest"];
-                401: components["responses"]["Unauthorized"];
-                404: components["responses"]["NotFound"];
-                500: components["responses"]["ServerError"];
             };
         };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
         trace?: never;
     };
     "/submissions": {
@@ -16627,6 +17088,92 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/users/{id}/courses/{courseId}/lessons": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Drill-down por aula de um curso para um aluno (drawer do backoffice)
+         * @description Lista as aulas publicadas do curso na ordem de módulo/aula, com o progresso consolidado (user_lesson_progress_v2) e o agregado de sessões por aula. watchedRanges são os intervalos do vídeo efetivamente assistidos (merged), para o heatmap de cobertura. Só leitura — nenhuma migration.
+         */
+        get: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description id do aluno */
+                    id: string;
+                    courseId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Aulas do curso com progresso do aluno */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: {
+                                /** Format: uuid */
+                                courseId?: string;
+                                courseTitle?: string;
+                                totalLessons?: number;
+                                completedLessons?: number;
+                                hoursWatched?: number;
+                                avgPlaybackRate?: number | null;
+                                modules?: {
+                                    /** Format: uuid */
+                                    moduleId?: string;
+                                    title?: string;
+                                    position?: number;
+                                    lessons?: {
+                                        /** Format: uuid */
+                                        lessonId?: string;
+                                        title?: string;
+                                        position?: number;
+                                        durationSeconds?: number;
+                                        completed?: boolean;
+                                        /** Format: date-time */
+                                        completedAt?: string | null;
+                                        positionSeconds?: number;
+                                        watchedSeconds?: number;
+                                        watchedPct?: number;
+                                        /** Format: date-time */
+                                        lastActivityAt?: string | null;
+                                        sessions?: number;
+                                        ranges?: number[][];
+                                    }[];
+                                }[];
+                            };
+                        };
+                    };
+                };
+                /** @description Curso não encontrado */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                500: components["responses"]["ServerError"];
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/vitrine/home": {
         parameters: {
             query?: never;
@@ -16873,7 +17420,12 @@ interface components {
              * Format: email
              * @example john.doe@example.com
              */
-            email: string;
+            email: string | null;
+            /**
+             * @description Login do usuário (gerado quando não informado)
+             * @example johndoe
+             */
+            username?: string;
             /** @example +5511999999999 */
             phone?: string | null;
             /** @example 12345678901 */
@@ -17073,9 +17625,15 @@ interface components {
             lastName: string;
             /**
              * Format: email
+             * @description Optional. When omitted, the user logs in with the generated username
              * @example john.doe@example.com
              */
-            email: string;
+            email?: string | null;
+            /**
+             * @description Optional. Auto-generated from firstName + lastName when omitted
+             * @example johndoe
+             */
+            username?: string | null;
             /**
              * @description Password for the user's Keycloak account
              * @example SecurePassword123!
@@ -17084,7 +17642,7 @@ interface components {
             /** @example +5511999999999 */
             phone?: string | null;
             /** @example 12345678901 */
-            document: string;
+            document?: string | null;
             /**
              * @example male
              * @enum {string|null}
@@ -17107,6 +17665,18 @@ interface components {
              * @example 550e8400-e29b-41d4-a716-446655440001
              */
             institutionId?: string | null;
+            /**
+             * Format: uuid
+             * @description Optional classroom ID to enroll the user (requires groupId)
+             * @example 550e8400-e29b-41d4-a716-446655440003
+             */
+            institutionClassroomId?: string | null;
+            /**
+             * Format: uuid
+             * @description Optional ID that groups this request with other creation requests
+             * @example 550e8400-e29b-41d4-a716-446655440004
+             */
+            userCreationRequestsGroupId?: string | null;
             /**
              * Format: uuid
              * @description Seat code ID to register the user
@@ -17236,7 +17806,12 @@ interface components {
              * Format: email
              * @example john.doe@example.com
              */
-            email?: string;
+            email?: string | null;
+            /**
+             * @description Login do usuário (gerado quando não informado)
+             * @example johndoe
+             */
+            username?: string;
             /** @example +5511999999999 */
             phone?: string | null;
             /** @example 12345678901 */
@@ -19426,9 +20001,11 @@ interface components {
             requestId?: string;
             /**
              * Format: email
-             * @description Email of the user being created
+             * @description Email of the user being created (optional)
              */
-            email?: string;
+            email?: string | null;
+            /** @description Login of the created user, generated by the worker when not provided (available after processing) */
+            username?: string | null;
             /**
              * @description Current status of the creation request
              * @enum {string}
@@ -19939,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 */
@@ -19951,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 */
@@ -20432,14 +21018,17 @@ declare function createUserService(apiClient: AcademeApiClient): {
         body: {
             firstName: string;
             lastName: string;
-            email: string;
+            email?: string | null;
+            username?: string | null;
             password: string;
             phone?: string | null;
-            document: string;
+            document?: string | null;
             gender?: "male" | "female" | "other" | null;
             birthdate?: string | null;
             groupId?: string | null;
             institutionId?: string | null;
+            institutionClassroomId?: string | null;
+            userCreationRequestsGroupId?: string | null;
             seatCodeId?: string | null;
             guardianId?: string | null;
             guardian?: components["schemas"]["CreateGuardianInlineDto"];
@@ -20477,20 +21066,61 @@ declare function createUserService(apiClient: AcademeApiClient): {
         body: {
             firstName: string;
             lastName: string;
-            email: string;
+            email?: string | null;
+            username?: string | null;
             password: string;
             phone?: string | null;
-            document: string;
+            document?: string | null;
             gender?: "male" | "female" | "other" | null;
             birthdate?: string | null;
             groupId?: string | null;
             institutionId?: string | null;
+            institutionClassroomId?: string | null;
+            userCreationRequestsGroupId?: string | null;
             seatCodeId?: string | null;
             guardianId?: string | null;
             guardian?: components["schemas"]["CreateGuardianInlineDto"];
             avatarFileId?: string | null;
         };
     }, `${string}/${string}`>>;
+    /**
+     * Consulta o status de uma criação assíncrona de usuário, a partir do
+     * requestId devolvido pelo POST /users. Traz o `username` (login) gerado
+     * pelo worker — útil quando o usuário foi criado sem email.
+     */
+    getUserCreationRequest(requestId: string): Promise<openapi_fetch.FetchResponse<{
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                requestId: string;
+            };
+            cookie?: never;
+        };
+        requestBody?: never;
+        responses: {
+            200: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": {
+                        status?: string;
+                        data?: components["schemas"]["UserCreationRequest"];
+                    };
+                };
+            };
+            401: components["responses"]["Unauthorized"];
+            404: components["responses"]["NotFound"];
+            500: components["responses"]["ServerError"];
+        };
+    }, {
+        params: {
+            path: {
+                requestId: string;
+            };
+        };
+    }, `${string}/${string}`>>;
     /**
      * Update user information
      */
@@ -25097,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'];
@@ -25243,6 +25874,7 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                             options?: {
                                 text?: string;
                                 is_correct?: boolean;
+                                explanation?: string;
                             }[];
                         }[];
                     };
@@ -25572,6 +26204,7 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                         options?: {
                             text?: string;
                             is_correct?: boolean;
+                            explanation?: string;
                         }[];
                     }[];
                 };
@@ -25603,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
      */
@@ -25804,6 +26487,7 @@ declare function createQuizService(apiClient: AcademeApiClient): {
             questionId: string;
             answer: string;
             isCorrect: boolean;
+            explanation?: string;
         };
     }, `${string}/${string}`>>;
     /**
@@ -25849,6 +26533,7 @@ declare function createQuizService(apiClient: AcademeApiClient): {
         body: {
             answer?: string;
             isCorrect?: boolean;
+            explanation?: string;
         };
     }, `${string}/${string}`>>;
     /**