academe-kit 0.13.0 → 0.15.0

package/dist/types/index.d.ts

@@ -20,8 +20,10 @@ export { createAcademeApiClient } from "./services";
 export type { AcademeApiClient, AcademeServices } from "./services";
 export type { ChallengeUserQuizAttempt, ChallengeUserQuizAttemptsResponse, } from "./services/ChallengeService";
 export type { JourneyStepView, JourneyChallengeView, JourneyView, } from "./services/UserProgressService";
+export type { ChallengeGroupDTO, ChallengeGroupMember, ChallengeGroupUserRef, GroupInviteDTO, GroupInviteStatus, EligibleClassmate, ClassmateMembership, CreateGroupInput, ListInvitesParams, } from "./services/ChallengeGroupService";
 export type { AccessibleSerie, ClassroomSummary, UserEnrollment, } from "./services/userService";
 export type { VitrineHome, VitrinePlaylist, VitrineCard, VitrineCardKind, VitrinePlaylistSource, VitrineCardOrientation, } from "./services/VitrineService";
+export type { WatchlistItem, WatchlistResponse, WatchlistType, } from "./services/WatchlistService";
 export { cn } from "./lib/utils";
 import "./index.css";
 import "./styles/globals.css";

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

@@ -0,0 +1,124 @@
+import type { AcademeApiClient } from "./index";
+/**
+ * Service de GRUPOS e CONVITES de desafio (desafios em grupo).
+ *
+ * Espelha app-academe-v2/src/services/academe/challenge-group.service.ts.
+ *
+ * ⚠️ Os endpoints de convite (`/challenge-group-invites`) e o de colegas
+ * elegíveis (`/challenges/{id}/eligible-classmates`) ainda NÃO estão no schema
+ * OpenAPI gerado deste kit, então usamos o mesmo padrão do mobile:
+ * `(apiClient.X as any)` + tipos escritos à mão. Ao regerar o schema com
+ * `npm run generate:api-types` (backend em http://localhost:3002), trocar os
+ * casts por chamadas tipadas e derivar os DTOs de `components["schemas"]`.
+ *
+ * NÃO confundir com `GroupService` (`services.group`), que trata de grupos
+ * RBAC/Keycloak (usuários↔roles) — sem relação com desafios em grupo.
+ */
+/** Envelope padrão das respostas do backend: `{ status, data }`. */
+type ApiEnvelope<T> = {
+    data?: {
+        status?: string;
+        data?: T;
+    };
+    error?: unknown;
+};
+export interface ChallengeGroupUserRef {
+    id: string;
+    firstName?: string | null;
+    lastName?: string | null;
+    /** Avatar resolvido pelo backend (padrão do app). Preferir a `avatarFile`. */
+    avatarUrl?: string | null;
+    avatarFile?: {
+        url?: string | null;
+    } | null;
+}
+export interface ChallengeGroupMember {
+    id: string;
+    groupId: string;
+    userId: string;
+    user?: ChallengeGroupUserRef | null;
+    createdAt?: string;
+}
+export interface ChallengeGroupDTO {
+    id: string;
+    challengeId: string;
+    name: string;
+    description?: string | null;
+    members?: ChallengeGroupMember[];
+    createdAt?: string;
+    updatedAt?: string;
+}
+/** Estado do colega frente aos grupos deste desafio. */
+export type ClassmateMembership = "free" | "in_group" | "invited";
+export interface EligibleClassmate {
+    userId: string;
+    name: string;
+    avatarUrl: string | null;
+    classroomId: string | null;
+    classroomName: string | null;
+    membership: ClassmateMembership;
+}
+export type GroupInviteStatus = "pending" | "accepted" | "declined" | "cancelled";
+export interface GroupInviteDTO {
+    id: string;
+    groupId: string;
+    challengeId: string;
+    inviterUserId: string;
+    inviteeUserId: string;
+    status: GroupInviteStatus;
+    respondedAt?: string | null;
+    createdAt?: string;
+    updatedAt?: string;
+    group?: ChallengeGroupDTO | null;
+    challenge?: {
+        id: string;
+        title?: string;
+    } | null;
+    inviter?: ChallengeGroupUserRef | null;
+    invitee?: ChallengeGroupUserRef | null;
+}
+export interface CreateGroupInput {
+    challengeId: string;
+    name: string;
+    description?: string;
+    /** Quando true, o usuário autenticado entra como primeiro membro (líder). */
+    joinAsMember?: boolean;
+}
+export interface ListInvitesParams {
+    role?: "received" | "sent";
+    status?: GroupInviteStatus;
+}
+export declare function createChallengeGroupService(apiClient: AcademeApiClient): {
+    /** Lista os grupos de um desafio (com membros). */
+    listGroups(challengeId: string): Promise<ApiEnvelope<ChallengeGroupDTO[]>>;
+    /** Detalha um grupo (com desafio e membros). */
+    getGroup(groupId: string): Promise<ApiEnvelope<ChallengeGroupDTO>>;
+    /** Cria um grupo. Com `joinAsMember`, o criador entra como líder. */
+    createGroup(body: CreateGroupInput): Promise<ApiEnvelope<ChallengeGroupDTO>>;
+    /** Lista membros de um grupo. */
+    listMembers(groupId: string): Promise<ApiEnvelope<ChallengeGroupMember[]>>;
+    /** Remove um membro do grupo (sair/expulsar). */
+    removeMember(groupId: string, userId: string): Promise<ApiEnvelope<null>>;
+    /** Remove o grupo. */
+    deleteGroup(groupId: string): Promise<ApiEnvelope<null>>;
+    /**
+     * Colegas de turma elegíveis para convidar (mesma turma do aluno, anotados
+     * com `membership`: free | in_group | invited).
+     */
+    getEligibleClassmates(challengeId: string, institutionId?: string): Promise<ApiEnvelope<EligibleClassmate[]>>;
+    /** Meus convites (recebidos por padrão), opcionalmente filtrados por status. */
+    listInvites(params?: ListInvitesParams): Promise<ApiEnvelope<GroupInviteDTO[]>>;
+    /** Convida um colega para um grupo. */
+    createInvite(body: {
+        groupId: string;
+        inviteeUserId: string;
+    }): Promise<ApiEnvelope<GroupInviteDTO>>;
+    /** Aceita um convite recebido (cria a membership no backend). */
+    acceptInvite(inviteId: string): Promise<ApiEnvelope<GroupInviteDTO>>;
+    /** Recusa um convite recebido. */
+    declineInvite(inviteId: string): Promise<ApiEnvelope<GroupInviteDTO>>;
+    /** Cancela um convite pendente que EU enviei. */
+    cancelInvite(inviteId: string): Promise<ApiEnvelope<GroupInviteDTO>>;
+};
+export type ChallengeGroupService = ReturnType<typeof createChallengeGroupService>;
+export {};

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

@@ -397,6 +397,7 @@ export declare function createChallengeService(apiClient: AcademeApiClient): {
                     tutorialTitle?: string;
                     tutorialDescription?: string;
                     tutorialVideoUrl?: string;
+                    redirectUrl?: string;
                     isActive?: boolean;
                 };
             };
@@ -431,6 +432,7 @@ export declare function createChallengeService(apiClient: AcademeApiClient): {
             tutorialTitle?: string;
             tutorialDescription?: string;
             tutorialVideoUrl?: string;
+            redirectUrl?: string;
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;

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

@@ -161,12 +161,12 @@ export 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;
                             }[];
                         }[];
                     };
@@ -494,8 +494,8 @@ export declare function createQuizService(apiClient: AcademeApiClient): {
                         type: "multiple_choice" | "true_false" | "open";
                         points?: number;
                         options?: {
-                            text: string;
-                            is_correct: boolean;
+                            text?: string;
+                            is_correct?: boolean;
                         }[];
                     }[];
                 };
@@ -525,8 +525,8 @@ export declare function createQuizService(apiClient: AcademeApiClient): {
                 type: "multiple_choice" | "true_false" | "open";
                 points?: number;
                 options?: {
-                    text: string;
-                    is_correct: boolean;
+                    text?: string;
+                    is_correct?: boolean;
                 }[];
             }[];
         };

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

@@ -10,7 +10,7 @@ export declare function createStepService(apiClient: AcademeApiClient): {
     getAll(params?: GetStepsParams): Promise<import("openapi-fetch").FetchResponse<{
         parameters: {
             query?: {
-                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                 isActive?: boolean;
             };
             header?: never;
@@ -36,7 +36,7 @@ export declare function createStepService(apiClient: AcademeApiClient): {
     }, {
         params: {
             query: {
-                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                 isActive?: boolean;
             } | undefined;
         };
@@ -94,7 +94,7 @@ export declare function createStepService(apiClient: AcademeApiClient): {
                     name: string;
                     color: string;
                     icon: string;
-                    type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                    type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                     isActive?: boolean;
                 };
             };
@@ -120,7 +120,7 @@ export declare function createStepService(apiClient: AcademeApiClient): {
             name: string;
             color: string;
             icon: string;
-            type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+            type: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;
@@ -142,7 +142,7 @@ export declare function createStepService(apiClient: AcademeApiClient): {
                     name?: string;
                     color?: string;
                     icon?: string;
-                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+                    type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
                     isActive?: boolean;
                 };
             };
@@ -174,7 +174,7 @@ export declare function createStepService(apiClient: AcademeApiClient): {
             name?: string;
             color?: string;
             icon?: string;
-            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate";
+            type?: "challenge" | "course" | "tutorial" | "publication" | "evaluation" | "certificate" | "redirect";
             isActive?: boolean;
         };
     }, `${string}/${string}`>>;

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

@@ -6,7 +6,7 @@ type CreateSubmissionBody = paths["/submissions"]["post"]["requestBody"]["conten
     institutionId: string;
 };
 type AttachFilesBody = paths["/submissions/{id}/files"]["post"]["requestBody"]["content"]["application/json"];
-type AiEvaluationBody = paths["/submissions/{id}/ai-evaluation"]["post"]["requestBody"]["content"]["application/json"];
+type AiEvaluationBody = Record<string, unknown>;
 type TeacherEvaluationBody = paths["/submissions/{id}/teacher-evaluation"]["patch"]["requestBody"]["content"]["application/json"];
 export declare function createSubmissionService(apiClient: AcademeApiClient): {
     /**
@@ -274,69 +274,7 @@ export declare function createSubmissionService(apiClient: AcademeApiClient): {
      * Register AI evaluation (called by the AI service callback).
      * Moves status from submitted → ai_evaluated.
      */
-    aiEvaluate(submissionId: string, data: AiEvaluationBody): Promise<import("openapi-fetch").FetchResponse<{
-        parameters: {
-            query?: never;
-            header?: never;
-            path: {
-                id: import("../types/academe-api").components["parameters"]["id"];
-            };
-            cookie?: never;
-        };
-        requestBody: {
-            content: {
-                "application/json": {
-                    aiScore: number;
-                    aiFeedback?: string;
-                    aiExtractedContent?: Record<string, never>;
-                    criterionScores?: {
-                        challengeEvaluationCriterionId: string;
-                        score: number;
-                        comment?: string;
-                    }[];
-                };
-            };
-        };
-        responses: {
-            200: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": {
-                        status?: string;
-                        data?: import("../types/academe-api").components["schemas"]["Submission"];
-                    };
-                };
-            };
-            400: {
-                headers: {
-                    [name: string]: unknown;
-                };
-                content: {
-                    "application/json": import("../types/academe-api").components["schemas"]["Error"];
-                };
-            };
-            404: import("../types/academe-api").components["responses"]["NotFound"];
-            409: import("../types/academe-api").components["responses"]["Conflict"];
-        };
-    }, {
-        params: {
-            path: {
-                id: string;
-            };
-        };
-        body: {
-            aiScore: number;
-            aiFeedback?: string;
-            aiExtractedContent?: Record<string, never>;
-            criterionScores?: {
-                challengeEvaluationCriterionId: string;
-                score: number;
-                comment?: string;
-            }[];
-        };
-    }, `${string}/${string}`>>;
+    aiEvaluate(submissionId: string, data: AiEvaluationBody): any;
     /**
      * Teacher approves or rejects a submission.
      * Only allowed when status is submitted or ai_evaluated.

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

@@ -90,7 +90,13 @@ export declare function createUserProgressService(apiClient: AcademeApiClient):
             };
             cookie?: never;
         };
-        requestBody?: never;
+        requestBody?: {
+            content: {
+                "application/json": {
+                    fromStepId?: string;
+                };
+            };
+        };
         responses: {
             200: {
                 headers: {
@@ -100,8 +106,11 @@ export declare function createUserProgressService(apiClient: AcademeApiClient):
                     "application/json": {
                         status?: string;
                         data?: {
-                            action?: "started" | "completed" | "finished";
+                            action?: "started" | "completed" | "finished" | "noop" | "waiting";
                             challengeId?: string;
+                            groupWaiting?: boolean;
+                            completedMembers?: number;
+                            totalMembers?: number;
                             currentStep?: {
                                 id?: string;
                                 index?: number;
@@ -238,6 +247,12 @@ export declare function createUserProgressService(apiClient: AcademeApiClient):
             };
             401: components["responses"]["Unauthorized"];
             404: components["responses"]["NotFound"];
+            409: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
         };
     }, {
         params: {

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

@@ -0,0 +1,29 @@
+import type { AcademeApiClient } from "./index";
+/**
+ * "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).
+ */
+export type WatchlistType = "course" | "module" | "lesson";
+export 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;
+}
+export interface WatchlistResponse {
+    items: WatchlistItem[];
+    count: number;
+}
+export 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>;
+};
+export type WatchlistService = ReturnType<typeof createWatchlistService>;

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

@@ -23,6 +23,8 @@ import { type StepService } from './StepService';
 import { type SubmissionService } from './SubmissionService';
 import { type UserProgressService } from './UserProgressService';
 import { type VitrineService } from './VitrineService';
+import { type WatchlistService } from './WatchlistService';
+import { type ChallengeGroupService } from './ChallengeGroupService';
 export type AcademeApiClient = ReturnType<typeof createClient<paths>>;
 export declare function createAcademeApiClient(baseUrl: string): AcademeApiClient;
 export interface AcademeServices {
@@ -49,6 +51,8 @@ export interface AcademeServices {
     submission: SubmissionService;
     userProgress: UserProgressService;
     vitrine: VitrineService;
+    watchlist: WatchlistService;
+    challengeGroup: ChallengeGroupService;
 }
 export declare function createAcademeServices(apiClient: AcademeApiClient): AcademeServices;
 export { createUserService, type UserService } from "./userService";
@@ -73,3 +77,5 @@ export { createStepService, type StepService } from './StepService';
 export { createSubmissionService, type SubmissionService } from './SubmissionService';
 export { createUserProgressService, type UserProgressService } from './UserProgressService';
 export { createVitrineService, type VitrineService } from './VitrineService';
+export { createWatchlistService, type WatchlistService } from './WatchlistService';
+export { createChallengeGroupService, type ChallengeGroupService, type ChallengeGroupDTO, type ChallengeGroupMember, type ChallengeGroupUserRef, type GroupInviteDTO, type GroupInviteStatus, type EligibleClassmate, type ClassmateMembership, type CreateGroupInput, type ListInvitesParams, } from './ChallengeGroupService';