academe-kit 0.10.2 → 0.11.0

package/dist/index.cjs

@@ -6371,10 +6371,19 @@ function createUserProgressService(apiClient) {
         /**
          * Jornada pré-computada do usuário (status, progress, color, icon,
          * isUpcoming, série) — base de renderização direta da tela de jornada.
+         *
+         * `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.
          */
-        async getJourney(serieId) {
+        async getJourney(serieId, userId) {
+            const query = {};
+            if (serieId)
+                query.serieId = serieId;
+            if (userId)
+                query.userId = userId;
             const res = await apiClient.GET("/user-challenge-progress/journey", {
-                params: { query: serieId ? { serieId } : undefined },
+                params: { query: Object.keys(query).length > 0 ? query : undefined },
             });
             return res.data.data;
         },
@@ -6435,6 +6444,19 @@ function createUserProgressService(apiClient) {
                 params: { path: { stepId } },
             });
         },
+        /**
+         * [Admin] Conclui de uma vez TODAS as etapas ativas de um desafio para um
+         * usuário-alvo, criando a linha de progresso quando não existir. Idempotente
+         * — etapas já concluídas não são alteradas.
+         *
+         * Diferente de `advance` (que avança um tick por vez para o usuário
+         * autenticado), aqui o desafio inteiro é concluído de uma vez para o usuário
+         * identificado no path. Em desafios em grupo, apenas o progresso do
+         * usuário-alvo é concluído; os demais membros não são afetados.
+         */
+        completeAllForUser(challengeId, userId) {
+            return apiClient.POST("/user-challenge-progress/challenges/{id}/users/{userId}/complete-all", { params: { path: { id: challengeId, userId } } });
+        },
     };
 }