@studious-lms/server 1.9.0 → 1.12.0

package/src/routers/discussion.ts

@@ -0,0 +1,205 @@
+import { z } from "zod";
+import { createTRPCRouter, protectedProcedure } from "../trpc.js";
+import {
+  createDiscussion,
+  createDiscussionTag,
+  deleteDiscussion,
+  deleteDiscussionReply,
+  deleteDiscussionTag,
+  getDiscussionClassAccess,
+  getDiscussion,
+  getUnreadCounts,
+  listDiscussionTags,
+  listDiscussions,
+  lockDiscussion,
+  markAcceptedAnswer,
+  markDiscussionRead,
+  pinDiscussion,
+  replyToDiscussion,
+  toggleDiscussionReaction,
+  updateDiscussion,
+  updateDiscussionReply,
+  updateDiscussionTag,
+} from "../services/discussion.js";
+import { confirmDirectUpload, createDirectUploadFiles } from "../lib/fileUpload.js";
+import { prisma } from "../lib/prisma.js";
+import { TRPCError } from "@trpc/server";
+
+const discussionTypeSchema = z.enum(["DISCUSSION", "QUESTION", "ANNOUNCEMENT"]);
+const reactionTypeSchema = z.enum(["THUMBSUP", "CELEBRATE", "CARE", "HEART", "IDEA", "HAPPY"]);
+const hexColorSchema = z.string().regex(/^#[0-9A-Fa-f]{6}$/);
+const MAX_DISCUSSION_UPLOAD_FILES = 20;
+const MAX_DISCUSSION_FILE_BYTES = 25 * 1024 * 1024;
+const reactionToggleInputSchema = z
+  .object({
+    discussionId: z.string().optional(),
+    discussionReplyId: z.string().optional(),
+    type: reactionTypeSchema,
+  })
+  .refine(
+    ({ discussionId, discussionReplyId }) => Boolean(discussionId) !== Boolean(discussionReplyId),
+    { message: "must provide exactly one of discussionId or discussionReplyId" }
+  );
+const directFileSchema = z.object({
+  name: z.string().trim().min(1).max(255),
+  type: z.string().trim().min(1).max(127),
+  size: z.number().int().nonnegative().max(MAX_DISCUSSION_FILE_BYTES),
+});
+
+export const discussionRouter = createTRPCRouter({
+  list: protectedProcedure
+    .input(
+      z.object({
+        classId: z.string(),
+        tagId: z.string().optional(),
+        type: discussionTypeSchema.optional(),
+        search: z.string().optional(),
+        sort: z.enum(["recent", "activity", "top"]).default("activity"),
+        cursor: z.string().optional(),
+        limit: z.number().min(1).max(50).default(20),
+      })
+    )
+    .query(({ ctx, input }) => listDiscussions(ctx.user!.id, input)),
+
+  get: protectedProcedure
+    .input(z.object({ discussionId: z.string() }))
+    .query(({ ctx, input }) => getDiscussion(ctx.user!.id, input.discussionId)),
+
+  create: protectedProcedure
+    .input(
+      z.object({
+        classId: z.string(),
+        title: z.string().trim().min(1).max(160),
+        body: z.string().trim().min(1),
+        type: discussionTypeSchema.default("DISCUSSION"),
+        tagIds: z.array(z.string()).optional(),
+        attachmentIds: z.array(z.string()).optional(),
+      })
+    )
+    .mutation(({ ctx, input }) => createDiscussion(ctx.user!.id, input)),
+
+  getUploadUrls: protectedProcedure
+    .input(
+      z.object({
+        classId: z.string(),
+        files: z.array(directFileSchema).min(1).max(MAX_DISCUSSION_UPLOAD_FILES),
+      })
+    )
+    .mutation(async ({ ctx, input }) => {
+      await getDiscussionClassAccess(input.classId, ctx.user!.id);
+      return {
+        uploadFiles: await createDirectUploadFiles(input.files, ctx.user!.id),
+      };
+    }),
+
+  confirmUpload: protectedProcedure
+    .input(
+      z.object({
+        fileId: z.string(),
+        uploadSuccess: z.boolean(),
+        errorMessage: z.string().optional(),
+      })
+    )
+    .mutation(async ({ ctx, input }) => {
+      const file = await prisma.file.findFirst({
+        where: {
+          id: input.fileId,
+          userId: ctx.user!.id,
+          discussionId: null,
+          discussionReplyId: null,
+        },
+        select: { id: true },
+      });
+      if (!file) {
+        throw new TRPCError({ code: "NOT_FOUND", message: "File not found or you do not have permission" });
+      }
+      await confirmDirectUpload(input.fileId, input.uploadSuccess, input.errorMessage);
+      return { success: true };
+    }),
+
+  update: protectedProcedure
+    .input(
+      z.object({
+        discussionId: z.string(),
+        title: z.string().trim().min(1).max(160).optional(),
+        body: z.string().trim().min(1).optional(),
+        type: discussionTypeSchema.optional(),
+        tagIds: z.array(z.string()).optional(),
+        allowReplies: z.boolean().optional(),
+      })
+    )
+    .mutation(({ ctx, input }) => updateDiscussion(ctx.user!.id, input)),
+
+  delete: protectedProcedure
+    .input(z.object({ discussionId: z.string() }))
+    .mutation(({ ctx, input }) => deleteDiscussion(ctx.user!.id, input.discussionId)),
+
+  reply: protectedProcedure
+    .input(
+      z.object({
+        discussionId: z.string(),
+        parentReplyId: z.string().optional(),
+        body: z.string().trim().min(1),
+        attachmentIds: z.array(z.string()).optional(),
+      })
+    )
+    .mutation(({ ctx, input }) => replyToDiscussion(ctx.user!.id, input)),
+
+  updateReply: protectedProcedure
+    .input(
+      z.object({
+        replyId: z.string(),
+        body: z.string().trim().min(1),
+        attachmentIds: z.array(z.string()).optional(),
+      })
+    )
+    .mutation(({ ctx, input }) => updateDiscussionReply(ctx.user!.id, input)),
+
+  deleteReply: protectedProcedure
+    .input(z.object({ replyId: z.string() }))
+    .mutation(({ ctx, input }) => deleteDiscussionReply(ctx.user!.id, input.replyId)),
+
+  pin: protectedProcedure
+    .input(z.object({ discussionId: z.string(), isPinned: z.boolean() }))
+    .mutation(({ ctx, input }) => pinDiscussion(ctx.user!.id, input.discussionId, input.isPinned)),
+
+  lock: protectedProcedure
+    .input(z.object({ discussionId: z.string(), isLocked: z.boolean() }))
+    .mutation(({ ctx, input }) => lockDiscussion(ctx.user!.id, input.discussionId, input.isLocked)),
+
+  markAcceptedAnswer: protectedProcedure
+    .input(z.object({ replyId: z.string(), accepted: z.boolean() }))
+    .mutation(({ ctx, input }) => markAcceptedAnswer(ctx.user!.id, input.replyId, input.accepted)),
+
+  markRead: protectedProcedure
+    .input(z.object({ discussionId: z.string() }))
+    .mutation(({ ctx, input }) => markDiscussionRead(ctx.user!.id, input.discussionId)),
+
+  getUnreadCounts: protectedProcedure
+    .input(z.object({ classIds: z.array(z.string()).max(100) }))
+    .query(({ ctx, input }) => getUnreadCounts(ctx.user!.id, input.classIds)),
+
+  reactions: createTRPCRouter({
+    toggle: protectedProcedure
+      .input(reactionToggleInputSchema)
+      .mutation(({ ctx, input }) => toggleDiscussionReaction(ctx.user!.id, input)),
+  }),
+
+  tags: createTRPCRouter({
+    list: protectedProcedure
+      .input(z.object({ classId: z.string() }))
+      .query(({ ctx, input }) => listDiscussionTags(ctx.user!.id, input.classId)),
+
+    create: protectedProcedure
+      .input(z.object({ classId: z.string(), name: z.string().trim().min(1).max(32), color: hexColorSchema }))
+      .mutation(({ ctx, input }) => createDiscussionTag(ctx.user!.id, input)),
+
+    update: protectedProcedure
+      .input(z.object({ tagId: z.string(), name: z.string().trim().min(1).max(32).optional(), color: hexColorSchema.optional() }))
+      .mutation(({ ctx, input }) => updateDiscussionTag(ctx.user!.id, input)),
+
+    delete: protectedProcedure
+      .input(z.object({ tagId: z.string() }))
+      .mutation(({ ctx, input }) => deleteDiscussionTag(ctx.user!.id, input.tagId)),
+  }),
+});

package/src/routers/studentProgress.ts

@@ -8,6 +8,9 @@ import {
   chatAboutStudentProgress,
   dismissStudentRecommendation,
   getClassProgressRecommendations,
+  getStudentProgressFocus,
+  getStudentProgressForecast,
+  getStudentProgressInsights,
   getStudentProgressRecommendations,
 } from "../services/studentProgress.js";
 
@@ -27,6 +30,24 @@ export const studentProgressRouter = createTRPCRouter({
       ),
     ),
 
+  getInsights: protectedClassMemberProcedure
+    .input(progressInputSchema)
+    .query(({ ctx, input }) =>
+      getStudentProgressInsights(ctx.user!.id, input.classId, input.studentId),
+    ),
+
+  getForecast: protectedClassMemberProcedure
+    .input(progressInputSchema)
+    .query(({ ctx, input }) =>
+      getStudentProgressForecast(ctx.user!.id, input.classId, input.studentId),
+    ),
+
+  getStudentFocus: protectedClassMemberProcedure
+    .input(progressInputSchema)
+    .query(({ ctx, input }) =>
+      getStudentProgressFocus(ctx.user!.id, input.classId, input.studentId),
+    ),
+
   getClassRecommendations: protectedTeacherProcedure
     .input(z.object({ classId: z.string() }))
     .query(({ ctx, input }) =>