academe-kit 0.15.0 → 0.16.0

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
      */

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

@@ -9235,7 +9235,7 @@ export 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;
@@ -13819,6 +13819,407 @@ export interface paths {
         };
         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?: {
+                    q?: string;
+                    kind?: "course" | "module" | "lesson";
+                    limit?: number;
+                    offset?: number;
+                };
+                header?: never;
+                path?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description { counts{courses,modules,lessons}, results[{kind,id,courseId,title,subtitle,coverUrl,published}] } */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        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?: never;
+                cookie?: never;
+            };
+            requestBody?: never;
+            responses: {
+                /** @description { institutions[], organizations[], groups[] } */
+                200: {
+                    headers: {
+                        [name: string]: unknown;
+                    };
+                    content?: never;
+                };
+            };
+        };
+        put?: never;
+        post?: never;
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/submissions": {
         parameters: {
             query?: never;
@@ -16459,6 +16860,92 @@ export 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;
@@ -16705,7 +17192,12 @@ export 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 */
@@ -16905,9 +17397,15 @@ export 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!
@@ -16916,7 +17414,7 @@ export interface components {
             /** @example +5511999999999 */
             phone?: string | null;
             /** @example 12345678901 */
-            document: string;
+            document?: string | null;
             /**
              * @example male
              * @enum {string|null}
@@ -16939,6 +17437,18 @@ export 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
@@ -17068,7 +17578,12 @@ export 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 */
@@ -19258,9 +19773,11 @@ export 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}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "academe-kit",
-  "version": "0.15.0",
+  "version": "0.16.0",
   "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",
@@ -22,7 +22,8 @@
     "dev": "storybook dev -p 6006",
     "build": "rollup -c",
     "build:watch": "rollup -c --watch",
-    "build-storybook": "storybook build",
+    "build-storybook": "storybook build && cp storybook-static/llms.txt storybook-static/llms-full.txt",
+    "serve-storybook": "serve storybook-static -l ${PORT:-6006}",
     "storybook": "storybook dev -p 6006",
     "generate:api-types": "npx openapi-typescript http://localhost:3002/api/openapi.json -o ./src/types/academe-api.ts"
   },
@@ -79,6 +80,7 @@
     "rollup-plugin-dts": "^6.1.0",
     "rollup-plugin-peer-deps-external": "^2.2.4",
     "rollup-plugin-postcss": "^4.0.2",
+    "serve": "^14.2.4",
     "storybook": "^8.0.0",
     "tailwindcss": "^3.4.1",
     "tslib": "^2.6.2",