academe-kit 0.15.0 → 0.17.0

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

@@ -21,6 +21,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'];
@@ -167,6 +168,7 @@ export declare function createQuizService(apiClient: AcademeApiClient): {
                             options?: {
                                 text?: string;
                                 is_correct?: boolean;
+                                explanation?: string;
                             }[];
                         }[];
                     };
@@ -496,6 +498,7 @@ export declare function createQuizService(apiClient: AcademeApiClient): {
                         options?: {
                             text?: string;
                             is_correct?: boolean;
+                            explanation?: string;
                         }[];
                     }[];
                 };
@@ -527,10 +530,60 @@ export 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<import("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
      */
@@ -728,6 +781,7 @@ export declare function createQuizService(apiClient: AcademeApiClient): {
             questionId: string;
             answer: string;
             isCorrect: boolean;
+            explanation?: string;
         };
     }, `${string}/${string}`>>;
     /**
@@ -773,6 +827,7 @@ export declare function createQuizService(apiClient: AcademeApiClient): {
         body: {
             answer?: string;
             isCorrect?: boolean;
+            explanation?: string;
         };
     }, `${string}/${string}`>>;
     /**

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

@@ -203,14 +203,17 @@ export 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"];
@@ -248,20 +251,61 @@ export 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<import("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
      */