academe-kit 0.10.1 → 0.10.3

package/dist/types/types/academe-api.d.ts

@@ -10703,6 +10703,80 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/reports/students-journey-status/{id}": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        /**
+         * Status de jornada dos alunos por bimestre (cards de /students)
+         * @description Recorta os alunos ativos da escola em 4 categorias mutuamente exclusivas
+         *     (notStarted, inJourney, inReview, completed) considerando os challenges
+         *     do bimestre alvo. Cada aluno cai na categoria mais avançada que alcançou.
+         */
+        get: {
+            parameters: {
+                query?: {
+                    /** @description UUID do educational_model_period, OU a string literal `"all"` para considerar todos os bimestres do ano letivo. Omitido = corrente. */
+                    periodId?: string;
+                    /** @description Quando presente, restringe o cálculo a UM challenge específico dentro do recorte temporal. */
+                    challengeId?: string;
+                };
+                header?: never;
+                path: {
+                    /** @description UUID da instituição */
+                    id: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description Status agregado */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: components["schemas"]["StudentsJourneyStatusResponse"];
+                        };
+                    };
+                };
+                /** @description institutionId inválido ou querystring inválida */
+                400: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Não autenticado */
+                401: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+                /** @description Erro interno */
+                500: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/roles": {
         parameters: {
             query?: never;
@@ -11687,7 +11761,13 @@ export interface paths {
                     userId?: string;
                     groupId?: string;
                     institutionId?: string;
+                    /** @description Filtra por turma (institution_classroom) do aluno na instituição */
+                    institutionClassroomId?: string;
+                    /** @description Filtra por série (serie) da turma do aluno na instituição */
+                    serieId?: string;
                     status?: "submitted" | "ai_evaluated" | "approved" | "rejected";
+                    /** @description Busca por nome ou e-mail do aluno (submissão) */
+                    search?: string;
                     /** @description Page number */
                     page?: components["parameters"]["page"];
                     /** @description Items per page */
@@ -12424,6 +12504,11 @@ export interface paths {
                      *     Útil para pré-visualização administrativa ou quando o aluno pertence a múltiplas séries.
                      */
                     serieId?: string;
+                    /**
+                     * @description [Admin] Quando presente, retorna a jornada do usuário-alvo em vez da do
+                     *     autenticado. Usado pelo backoffice para visualizar a jornada de um aluno.
+                     */
+                    userId?: string;
                 };
                 header?: never;
                 path?: never;
@@ -12815,6 +12900,86 @@ export interface paths {
         patch?: never;
         trace?: never;
     };
+    "/user-challenge-progress/challenges/{id}/users/{userId}/complete-all": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /**
+         * [Admin] Force-complete ALL steps of a challenge for a target user
+         * @description Marks every active step (challenges_steps) of the challenge as completed for the
+         *     given target user, creating the user_challenge_progress row when it does not exist.
+         *     Idempotent: steps already completed are left untouched.
+         *
+         *     Unlike POST /challenges/{id}/advance (which advances one tick at a time for the
+         *     authenticated user), this endpoint completes the whole challenge at once for the
+         *     user identified in the path. For group challenges, only the target user's progress
+         *     is completed — other group members are not affected.
+         */
+        post: {
+            parameters: {
+                query?: never;
+                header?: never;
+                path: {
+                    /** @description ID of the challenge */
+                    id: string;
+                    /** @description ID of the target user whose progress will be completed */
+                    userId: string;
+                };
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description All steps completed for the target user */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": {
+                            /** @example success */
+                            status?: string;
+                            data?: {
+                                /** Format: uuid */
+                                challengeId?: string;
+                                /** Format: uuid */
+                                userId?: string;
+                                /** @description Number of active steps in the challenge */
+                                total?: number;
+                                completedSteps?: {
+                                    /** Format: uuid */
+                                    id?: string;
+                                    index?: number;
+                                    name?: string;
+                                    /** Format: date-time */
+                                    completedAt?: string | null;
+                                }[];
+                            };
+                        };
+                    };
+                };
+                401: components["responses"]["Unauthorized"];
+                /** @description Challenge not found or has no active steps */
+                404: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content: {
+                        "application/json": components["schemas"]["Error"];
+                    };
+                };
+            };
+        };
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/user-creation-requests": {
         parameters: {
             query?: never;
@@ -14660,10 +14825,10 @@ export interface components {
             maxStudents: number;
             /** @example true */
             isActive: boolean;
-            /** Format: uri */
-            logoUrl?: string | null;
-            /** Format: uri */
-            capaUrl?: string | null;
+            /** Format: uuid */
+            logoFileId?: string | null;
+            /** Format: uuid */
+            capaFileId?: string | null;
             /** Format: uuid */
             addressId?: string | null;
             /** Format: uuid */
@@ -14672,8 +14837,8 @@ export interface components {
             createdAt: string;
             /** Format: date-time */
             updatedAt: string;
-            organization?: components["schemas"]["Organization"] | null;
-            address?: components["schemas"]["Address"] | null;
+            organization?: components["schemas"]["Organization"];
+            address?: components["schemas"]["Address"];
             institutionReward?: Record<string, never> | null;
         };
         Organization: {
@@ -16467,10 +16632,12 @@ export interface components {
             courses?: components["schemas"]["EncourageJourneyCourse"][];
         };
         EncourageSubmissions: {
+            /** @description Total de alunos ativos da escola (denominador para % concluído) */
             total?: number;
-            evaluated?: number;
+            /** @description Última submissão por (aluno, challenge do bimestre corrente) com teacher_score preenchido */
+            finalized?: number;
+            /** @description Última submissão por (aluno, challenge do bimestre corrente) ainda SEM teacher_score */
             awaitingTeacher?: number;
-            awaitingAi?: number;
         };
         EncourageClassPerformance: {
             /** Format: uuid */
@@ -16521,6 +16688,36 @@ export interface components {
             topStudents?: components["schemas"]["EncourageTopStudent"][];
             topTeachers?: components["schemas"]["EncourageTopTeacher"][];
         };
+        StudentsJourneyStatusSummary: {
+            /** @description Alunos sem step concluído nos challenges do recorte */
+            notStarted?: number;
+            /** @description Tem step concluído mas sem submissão */
+            inJourney?: number;
+            /** @description Submissão pendente de avaliação (teacher_score nulo) */
+            inReview?: number;
+            /** @description Submissão já avaliada (teacher_score preenchido) */
+            completed?: number;
+        };
+        StudentsJourneyStatusScope: {
+            /**
+             * Format: uuid
+             * @description UUID do bimestre alvo; null quando allPeriods
+             */
+            periodId?: string | null;
+            /**
+             * Format: uuid
+             * @description UUID do challenge alvo; null quando todos do recorte
+             */
+            challengeId?: string | null;
+            /** @description Quantidade de challenges no recorte */
+            challengesCount?: number;
+            /** @description Total de alunos ativos da escola — fecha com a soma dos 4 status */
+            totalStudents?: number;
+        };
+        StudentsJourneyStatusResponse: {
+            summary?: components["schemas"]["StudentsJourneyStatusSummary"];
+            scope?: components["schemas"]["StudentsJourneyStatusScope"];
+        };
         UserCreationRequest: {
             /**
              * Format: uuid
@@ -16595,15 +16792,15 @@ export interface components {
              */
             isActive: boolean;
             /**
-             * Format: uri
-             * @example https://example.com/logo.png
+             * Format: uuid
+             * @description ID do storage_file usado como logo
              */
-            logoUrl?: string;
+            logoFileId?: string;
             /**
-             * Format: uri
-             * @example https://example.com/capa.png
+             * Format: uuid
+             * @description ID do storage_file usado como capa/banner
              */
-            capaUrl?: string;
+            capaFileId?: string;
             /** Format: uuid */
             addressId?: string;
             /** Format: uuid */
@@ -16628,15 +16825,15 @@ export interface components {
             /** @example true */
             isActive?: boolean;
             /**
-             * Format: uri
-             * @example https://example.com/logo.png
+             * Format: uuid
+             * @description ID do storage_file usado como logo
              */
-            logoUrl?: string;
+            logoFileId?: string;
             /**
-             * Format: uri
-             * @example https://example.com/capa.png
+             * Format: uuid
+             * @description ID do storage_file usado como capa/banner
              */
-            capaUrl?: string;
+            capaFileId?: string;
             /** Format: uuid */
             addressId?: string;
             /** Format: uuid */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "academe-kit",
-  "version": "0.10.1",
+  "version": "0.10.3",
   "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",