academe-kit 0.9.9 → 0.10.1

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

@@ -573,14 +573,29 @@ export declare function createReportService(apiClient: AcademeApiClient): {
     /**
      * Get encourage dashboard for an institution
      * Retorna o payload agregado da tela /new-dashboard:
-     * overview, KPIs, licenças (alunos), jornada (cursos), submissões,
-     * desempenho por turma, top alunos e top professores.
+     * overview (com lista de períodos do ano letivo + flag isAllPeriods),
+     * KPIs, licenças (alunos), jornada (cursos do bimestre selecionado ou do
+     * ano letivo quando allPeriods), submissões do bimestre corrente,
+     * desempenho por turma, top alunos e top professores do bimestre.
      *
-     * @param id UUID da instituição.
+     * @param id                UUID da instituição.
+     * @param params.periodId   UUID do educational_model_period. Quando omitido,
+     *                          o backend resolve para o período corrente (NOW).
+     *                          Ignorado quando allPeriods=true.
+     * @param params.allPeriods Quando true, desliga o recorte por período em
+     *                          Jornada/Classes/TopTeachers — passa a refletir
+     *                          o ano letivo inteiro. SubmissionsCard continua
+     *                          sempre no bimestre corrente.
      */
-    getEncourageDashboardByInstitution(id: string): Promise<import("openapi-fetch").FetchResponse<{
+    getEncourageDashboardByInstitution(id: string, params?: {
+        periodId?: string;
+        allPeriods?: boolean;
+    }): Promise<import("openapi-fetch").FetchResponse<{
         parameters: {
-            query?: never;
+            query?: {
+                periodId?: string;
+                allPeriods?: "true";
+            };
             header?: never;
             path: {
                 id: string;
@@ -624,6 +639,10 @@ export declare function createReportService(apiClient: AcademeApiClient): {
             path: {
                 id: string;
             };
+            query: {
+                periodId?: string;
+                allPeriods?: "true";
+            } | undefined;
         };
     }, `${string}/${string}`>>;
 };

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

@@ -10644,7 +10644,12 @@ export interface paths {
          */
         get: {
             parameters: {
-                query?: never;
+                query?: {
+                    /** @description UUID do educational_model_period. Quando omitido, o backend resolve para o período corrente (NOW). Ignorado quando allPeriods=true. */
+                    periodId?: string;
+                    /** @description Quando 'true', desliga o recorte por período em Jornada/Classes/TopTeachers — passa a refletir o ano letivo inteiro. SubmissionsCard continua sempre no bimestre corrente. */
+                    allPeriods?: "true";
+                };
                 header?: never;
                 path: {
                     /** @description ID da instituição */

package/package.json

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