academe-kit 0.12.1 → 0.14.0

package/dist/index.d.ts

@@ -2503,7 +2503,6 @@ 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.
@@ -2534,8 +2533,6 @@ interface paths {
                         tutorialTitle?: string;
                         tutorialDescription?: string;
                         tutorialVideoUrl?: string;
-                        /** @description Required when parent step type=redirect */
-                        redirectUrl?: string;
                         /** @default true */
                         isActive?: boolean;
                     };
@@ -9808,69 +9805,6 @@ 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;
@@ -9965,6 +9899,67 @@ 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;
@@ -10186,7 +10181,7 @@ 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. 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.
+         * @description Retrieve a paginated list of quizzes, each enriched with the course, module and category it belongs to. `context` is null for standalone quizzes.
          */
         get: {
             parameters: {
@@ -10222,20 +10217,16 @@ 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;
@@ -10267,7 +10258,7 @@ interface paths {
         put?: never;
         /**
          * Generate quiz questions with AI
-         * @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.
+         * @description Gera perguntas a partir de um texto base via IA. Não persiste — apenas devolve.
          */
         post: {
             parameters: {
@@ -10279,23 +10270,16 @@ 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 Perguntas geradas */
+                /** @description Generated questions */
                 200: {
                     headers: {
                         [name: string]: unknown;
@@ -10305,13 +10289,12 @@ interface paths {
                             /** @example success */
                             status?: string;
                             data?: {
-                                question_text?: string;
-                                /** @enum {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;
                                 }[];
                             }[];
                         };
@@ -12013,7 +11996,7 @@ interface paths {
             parameters: {
                 query?: {
                     /** @description Filter by step type */
-                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
                     /** @description Filter by active status */
                     isActive?: boolean;
                 };
@@ -12062,7 +12045,7 @@ interface paths {
                         /** @example play-circle */
                         icon: string;
                         /** @enum {string} */
-                        type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+                        type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
                         /** @default true */
                         isActive?: boolean;
                     };
@@ -12189,7 +12172,7 @@ interface paths {
                         color?: string;
                         icon?: string;
                         /** @enum {string} */
-                        type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+                        type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
                         isActive?: boolean;
                     };
                 };
@@ -15814,11 +15797,6 @@ 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 */
@@ -16090,7 +16068,7 @@ interface components {
             /** @example play-circle */
             icon?: string;
             /** @enum {string} */
-            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
             /** @example true */
             isActive?: boolean;
             /** Format: date-time */
@@ -16188,8 +16166,6 @@ 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;
@@ -16319,10 +16295,7 @@ interface components {
              * @example Introdução a IA
              */
             courseModuleName?: string | null;
-            /**
-             * @description URL de redirecionamento desta etapa (apenas quando type=redirect)
-             * @example https://exemplo.com/atividade
-             */
+            /** @description URL de redirecionamento desta etapa (apenas quando type=redirect) */
             redirectUrl?: string | null;
         };
         /** @description Desafio da jornada com suas etapas e status computados */
@@ -18274,6 +18247,30 @@ type GetUsersParams = {
     page?: number;
     limit?: number;
 };
+/** Série acessível ao aluno (item do seletor de séries da jornada). */
+type AccessibleSerie = {
+    serieId: string;
+    serieValue: number;
+    serieLabel: string;
+    level: "fundamental" | "medio";
+};
+/** Turma do aluno (resumo) — para a listagem de turmas no perfil. */
+type ClassroomSummary = {
+    institutionClassroomId: string;
+    classroomId: string;
+    classroomName: string;
+    shiftName: string | null;
+    serie: AccessibleSerie | null;
+    institutionId: string;
+    institutionName: string | null;
+};
+/** Contexto de matrícula do usuário: turmas + escola atual + séries distintas. */
+type UserEnrollment = {
+    classrooms: ClassroomSummary[];
+    /** Escola atual resolvida pelo backend (1ª matrícula) — tem turma. */
+    currentInstitutionId: string | null;
+    series: AccessibleSerie[];
+};
 declare function createUserService(apiClient: AcademeApiClient): {
     /**
      * Get current authenticated user
@@ -18325,6 +18322,13 @@ declare function createUserService(apiClient: AcademeApiClient): {
             500: components["responses"]["ServerError"];
         };
     }> | undefined, `${string}/${string}`>>;
+    /**
+     * Contexto de matrícula do usuário: turmas (para o perfil) + séries
+     * distintas (para o seletor de séries da jornada) + escola atual. Fonte
+     * única, deduplicada e ordenada no backend. Normaliza os campos opcionais do
+     * OpenAPI. Espelha o app-academe (user.service.getMyEnrollment).
+     */
+    getMyEnrollment(): Promise<UserEnrollment>;
     /**
      * List all users with optional filters
      */
@@ -23239,12 +23243,12 @@ 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;
                             }[];
                         }[];
                     };
@@ -23572,8 +23576,8 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                         type: "multiple_choice" | "true_false" | "open";
                         points?: number;
                         options?: {
-                            text?: string;
-                            is_correct?: boolean;
+                            text: string;
+                            is_correct: boolean;
                         }[];
                     }[];
                 };
@@ -23603,8 +23607,8 @@ declare function createQuizService(apiClient: AcademeApiClient): {
                 type: "multiple_choice" | "true_false" | "open";
                 points?: number;
                 options?: {
-                    text?: string;
-                    is_correct?: boolean;
+                    text: string;
+                    is_correct: boolean;
                 }[];
             }[];
         };
@@ -26666,7 +26670,6 @@ declare function createChallengeService(apiClient: AcademeApiClient): {
                     tutorialTitle?: string;
                     tutorialDescription?: string;
                     tutorialVideoUrl?: string;
-                    redirectUrl?: string;
                     isActive?: boolean;
                 };
             };
@@ -26701,7 +26704,6 @@ declare function createChallengeService(apiClient: AcademeApiClient): {
             tutorialTitle?: string;
             tutorialDescription?: string;
             tutorialVideoUrl?: string;
-            redirectUrl?: string;
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;
@@ -27065,7 +27067,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
     getAll(params?: GetStepsParams): Promise<openapi_fetch.FetchResponse<{
         parameters: {
             query?: {
-                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
                 isActive?: boolean;
             };
             header?: never;
@@ -27091,7 +27093,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
     }, {
         params: {
             query: {
-                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
                 isActive?: boolean;
             } | undefined;
         };
@@ -27149,7 +27151,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
                     name: string;
                     color: string;
                     icon: string;
-                    type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+                    type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
                     isActive?: boolean;
                 };
             };
@@ -27175,7 +27177,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
             name: string;
             color: string;
             icon: string;
-            type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+            type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;
@@ -27197,7 +27199,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
                     name?: string;
                     color?: string;
                     icon?: string;
-                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
                     isActive?: boolean;
                 };
             };
@@ -27229,7 +27231,7 @@ declare function createStepService(apiClient: AcademeApiClient): {
             name?: string;
             color?: string;
             icon?: string;
-            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
+            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;
@@ -27673,8 +27675,15 @@ declare function createUserProgressService(apiClient: AcademeApiClient): {
      * `userId` é [Admin]: quando informado, retorna a jornada do usuário-alvo
      * (ex.: backoffice visualizando a jornada de um aluno); omitido = jornada
      * do próprio usuário autenticado.
+     *
+     * `institutionId` é a escola ATUAL: a jornada é POR ESCOLA (o usuário pode
+     * estar em várias). Omitido = 1ª matrícula resolvida no backend.
+     *
+     * ⚠️ Ordem dos parâmetros: `institutionId` foi adicionado como 3º parâmetro
+     * (após `userId`) para NÃO quebrar chamadas posicionais existentes — o
+     * backoffice chama `getJourney(undefined, userId)`.
      */
-    getJourney(serieId?: string, userId?: string): Promise<JourneyView>;
+    getJourney(serieId?: string, userId?: string, institutionId?: string): Promise<JourneyView>;
     /**
      * Visão step-by-step do progresso do usuário em um desafio. Cada step traz
      * `myStartedAt`, `myCompletedAt` e (em desafios em grupo) os agregados do
@@ -27960,6 +27969,86 @@ declare function createUserProgressService(apiClient: AcademeApiClient): {
 };
 type UserProgressService = ReturnType<typeof createUserProgressService>;
 
+/**
+ * Vitrine (Home) do aluno — rails/playlists estilo Netflix.
+ * Consome `GET /vitrine/home` do api-academe-v2.
+ *
+ * ⚠️ O endpoint ainda NÃO está no OpenAPI gerado (`academe-api.ts`), então os
+ * tipos abaixo são MANTIDOS À MÃO e a chamada usa cast — mesmo padrão de
+ * `InstitutionService.setUserClassrooms`. Quando o backend expuser o schema,
+ * regenerar os tipos e apertar.
+ */
+type VitrineCardKind = "course" | "module" | "lesson" | "playlist";
+type VitrinePlaylistSource = "curated" | "continue_watching" | "trending" | "watchlist" | "recent" | "continue_playlist";
+type VitrineCardOrientation = "horizontal" | "vertical" | "square" | "fullImage";
+interface VitrineCard {
+    kind: VitrineCardKind;
+    id: string;
+    courseId?: string | null;
+    title: string;
+    subtitle?: string | null;
+    coverUrl?: string | null;
+    durationSeconds?: number | null;
+    progressPct?: number | null;
+    courseTitle?: string | null;
+    lessonLabel?: string | null;
+    rank?: number | null;
+}
+interface VitrinePlaylist {
+    id: string;
+    title: string;
+    subtitle: string | null;
+    source: VitrinePlaylistSource;
+    variant: "common" | "featured";
+    cardOrientation: VitrineCardOrientation;
+    itemsPerViewDesktop: number;
+    itemsPerViewMobile: number;
+    autoplay: boolean;
+    style: Record<string, unknown>;
+    items: VitrineCard[];
+}
+interface VitrineHome {
+    institutionId: string | null;
+    playlists: VitrinePlaylist[];
+}
+declare function createVitrineService(apiClient: AcademeApiClient): {
+    /**
+     * Home do aluno para a escola atual. `institutionId` omitido = 1ª matrícula
+     * (o backend resolve). Recarregar ao trocar de escola no app.
+     */
+    getHome(institutionId?: string): Promise<VitrineHome>;
+};
+type VitrineService = ReturnType<typeof createVitrineService>;
+
+/**
+ * "Minha lista" (watchlist) do aluno. Consome `/me/watchlist` do api-academe-v2.
+ * Endpoint ainda NÃO no OpenAPI gerado → cast + tipos à mão (padrão do repo).
+ */
+type WatchlistType = "course" | "module" | "lesson";
+interface WatchlistItem {
+    /** id da linha (para remover pela tela). */
+    id: string;
+    type: WatchlistType;
+    /** id do conteúdo (curso/módulo/aula). */
+    contentId: string;
+    courseId: string | null;
+    title: string;
+    coverUrl: string | null;
+}
+interface WatchlistResponse {
+    items: WatchlistItem[];
+    count: number;
+}
+declare function createWatchlistService(apiClient: AcademeApiClient): {
+    /** Itens da "Minha lista" + contagem. */
+    getMine(): Promise<WatchlistResponse>;
+    /** Adiciona um conteúdo (idempotente). */
+    add(type: WatchlistType, id: string): Promise<void>;
+    /** Remove um conteúdo pelo alvo. */
+    remove(type: WatchlistType, id: string): Promise<void>;
+};
+type WatchlistService = ReturnType<typeof createWatchlistService>;
+
 type AcademeApiClient = ReturnType<typeof openapi_fetch__default<paths>>;
 declare function createAcademeApiClient(baseUrl: string): AcademeApiClient;
 interface AcademeServices {
@@ -27985,6 +28074,8 @@ interface AcademeServices {
     step: StepService;
     submission: SubmissionService;
     userProgress: UserProgressService;
+    vitrine: VitrineService;
+    watchlist: WatchlistService;
 }
 
 type AcademeKeycloakContextProps = {
@@ -28081,4 +28172,4 @@ declare enum NINA_ROLES {
 }
 
 export { AcademeAuthProvider, AcademeLoading, BACKOFFICE_ROLES, Button, CosmicDecor, CosmicStarsCanvas, DASHBOARD_ROLES, GLOBAL_ROLES, JourneyCrystalPin, JourneyStep, LogoA, MIKE_ROLES, NINA_ROLES, ProtectedApp, ProtectedComponent, ProtectedRouter, STREAMING_ROLES, Spinner, WIDGET_ROLES, academeApi_d as apiTypes, cn, createAcademeApiClient, index_d as types, useAcademeAuth, useProtectedAppColors };
-export type { AcademeApiClient, AcademeKeycloakContextProps, AcademeLoadingColors, AcademeLoadingProps, AcademeLoadingTheme, AcademeServices, AcademeUser, ButtonProps, ChallengeUserQuizAttempt, ChallengeUserQuizAttemptsResponse, CosmicDecorProps, CosmicDecorVariant, CosmicPlanet, CosmicStarsCanvasProps, FrameKind, JourneyChallengeView, JourneyCrystalPinProps, JourneyStepProps, JourneyStepSize, JourneyStepType, JourneyStepView, JourneyView, KeycloakUser, LogoAProps, RequiredClientRoles, SecurityContextType, SecurityProviderProps };
+export type { AcademeApiClient, AcademeKeycloakContextProps, AcademeLoadingColors, AcademeLoadingProps, AcademeLoadingTheme, AcademeServices, AcademeUser, AccessibleSerie, ButtonProps, ChallengeUserQuizAttempt, ChallengeUserQuizAttemptsResponse, ClassroomSummary, CosmicDecorProps, CosmicDecorVariant, CosmicPlanet, CosmicStarsCanvasProps, FrameKind, JourneyChallengeView, JourneyCrystalPinProps, JourneyStepProps, JourneyStepSize, JourneyStepType, JourneyStepView, JourneyView, KeycloakUser, LogoAProps, RequiredClientRoles, SecurityContextType, SecurityProviderProps, UserEnrollment, VitrineCard, VitrineCardKind, VitrineCardOrientation, VitrineHome, VitrinePlaylist, VitrinePlaylistSource, WatchlistItem, WatchlistResponse, WatchlistType };