@studious-lms/server 1.2.52 → 1.3.0

package/src/models/comment.ts

@@ -0,0 +1,152 @@
+/**
+ * Comment model – comments, replies, and reactions (for announcements/worksheets).
+ */
+import { prisma } from "../lib/prisma.js";
+import type { ReactionType } from "@prisma/client";
+
+export const commentSelect = {
+  id: true,
+  content: true,
+  createdAt: true,
+  modifiedAt: true,
+  author: {
+    select: {
+      id: true,
+      username: true,
+      profile: {
+        select: {
+          displayName: true,
+          profilePicture: true,
+          profilePictureThumbnail: true,
+        },
+      },
+    },
+  },
+  reactions: {
+    select: {
+      type: true,
+      user: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+              profilePicture: true,
+              profilePictureThumbnail: true,
+            },
+          },
+        },
+      },
+    },
+  },
+} as const;
+
+/** @returns Comment by ID with author and reactions. */
+export function findCommentById(id: string) {
+  return prisma.comment.findUnique({
+    where: { id },
+    select: commentSelect,
+  });
+}
+
+/** @returns Replies to a comment. */
+export function findRepliesByCommentId(commentId: string) {
+  return prisma.comment.findMany({
+    where: { parentCommentId: commentId },
+    include: {
+      author: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+              profilePicture: true,
+              profilePictureThumbnail: true,
+            },
+          },
+        },
+      },
+    },
+  });
+}
+
+/** Create a comment (reply). */
+export function createComment(data: {
+  parentCommentId: string;
+  content: string;
+  authorId: string;
+}) {
+  return prisma.comment.create({
+    data,
+  });
+}
+
+/** @returns User's reaction on a comment. */
+export function findReactionByUserAndComment(userId: string, commentId: string) {
+  return prisma.reaction.findUnique({
+    where: {
+      userId_commentId: { userId, commentId },
+    },
+  });
+}
+
+/** Add or update reaction on a comment. */
+export function upsertReaction(data: {
+  userId: string;
+  commentId: string;
+  type: string;
+}) {
+  return prisma.reaction.upsert({
+    where: {
+      userId_commentId: {
+        userId: data.userId,
+        commentId: data.commentId,
+      },
+    },
+    update: { type: data.type as ReactionType },
+    create: { ...data, type: data.type as ReactionType },
+    include: {
+      user: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+              profilePicture: true,
+              profilePictureThumbnail: true,
+            },
+          },
+        },
+      },
+    },
+  });
+}
+
+/** Delete a reaction. */
+export function deleteReactionById(id: string) {
+  return prisma.reaction.delete({
+    where: { id },
+  });
+}
+
+/** @returns Comment with announcement classId. */
+export function findCommentWithAnnouncement(commentId: string) {
+  return prisma.comment.findUnique({
+    where: { id: commentId },
+    include: {
+      announcement: { select: { classId: true } },
+    },
+  });
+}
+
+/** @returns Reaction counts by type for a comment. */
+export function getReactionCountsByCommentId(commentId: string) {
+  return prisma.reaction.groupBy({
+    by: ["type"],
+    where: { commentId },
+    _count: { type: true },
+  });
+}

package/src/models/conversation.ts

@@ -0,0 +1,200 @@
+/**
+ * Conversation model – DM/group conversations, members, unread counts.
+ */
+import { prisma } from "../lib/prisma.js";
+
+const conversationListInclude = {
+  labChat: { select: { id: true, title: true } },
+  members: {
+    include: {
+      user: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: { displayName: true, profilePicture: true },
+          },
+        },
+      },
+    },
+  },
+  messages: {
+    orderBy: { createdAt: "desc" as const },
+    take: 1,
+    include: {
+      sender: {
+        select: {
+          id: true,
+          username: true,
+          profile: { select: { displayName: true } },
+        },
+      },
+    },
+  },
+};
+
+/** @returns User's conversations with members and last message. */
+export function findConversationsByUserId(userId: string) {
+  return prisma.conversation.findMany({
+    where: {
+      members: { some: { userId } },
+    },
+    include: conversationListInclude,
+    orderBy: { updatedAt: "desc" },
+  });
+}
+
+/** Count unread messages in conversation for user. */
+export function countUnreadMessages(
+  conversationId: string,
+  userId: string,
+  after?: Date
+) {
+  return prisma.message.count({
+    where: {
+      conversationId,
+      senderId: { not: userId },
+      ...(after && { createdAt: { gt: after } }),
+    },
+  });
+}
+
+/** Count unread mentions for user in conversation. */
+export function countUnreadMentions(
+  conversationId: string,
+  userId: string,
+  after?: Date
+) {
+  return prisma.mention.count({
+    where: {
+      userId,
+      message: {
+        conversationId,
+        senderId: { not: userId },
+        ...(after && { createdAt: { gt: after } }),
+      },
+    },
+  });
+}
+
+/** @returns User by username (id, username only). */
+export function findUserByUsername(username: string) {
+  return prisma.user.findFirst({
+    where: { username },
+    select: { id: true, username: true },
+  });
+}
+
+/** @returns User's DM conversations. */
+export function findDmConversationsByUserId(userId: string) {
+  return prisma.conversation.findMany({
+    where: {
+      type: "DM",
+      members: { some: { userId } },
+    },
+    include: {
+      members: { select: { userId: true } },
+    },
+  });
+}
+
+/** @returns Users by IDs or usernames. */
+export function findUsersByIdsOrUsernames(identifiers: string[]) {
+  if (identifiers.length === 0) return Promise.resolve([]);
+  return prisma.user.findMany({
+    where: {
+      OR: [
+        { id: { in: identifiers } },
+        { username: { in: identifiers } },
+      ],
+    },
+    select: { id: true, username: true },
+  });
+}
+
+/** Create a DM or group conversation with members. */
+export function createConversation(data: {
+  type: "DM" | "GROUP";
+  name?: string;
+  members: { userId: string; role: string }[];
+}) {
+  return prisma.conversation.create({
+    data: {
+      type: data.type,
+      name: data.name,
+      members: {
+        create: data.members.map((m) => ({
+          userId: m.userId,
+          role: m.role as "ADMIN" | "MEMBER",
+        })),
+      },
+    },
+    include: {
+      members: {
+        include: {
+          user: {
+            select: {
+              id: true,
+              username: true,
+              profile: {
+                select: { displayName: true, profilePicture: true },
+              },
+            },
+          },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Conversation if user is a member. */
+export function findConversationByIdAndMember(
+  conversationId: string,
+  userId: string
+) {
+  return prisma.conversation.findFirst({
+    where: {
+      id: conversationId,
+      members: { some: { userId } },
+    },
+    include: {
+      members: {
+        include: {
+          user: {
+            select: {
+              id: true,
+              username: true,
+              profile: {
+                select: { displayName: true, profilePicture: true },
+              },
+            },
+          },
+        },
+      },
+    },
+  });
+}
+
+/** Add a member to a conversation. */
+export function createConversationMember(data: {
+  userId: string;
+  conversationId: string;
+  role: string;
+}) {
+  return prisma.conversationMember.create({
+    data: {
+      userId: data.userId,
+      conversationId: data.conversationId,
+      role: data.role as "ADMIN" | "MEMBER",
+    },
+  });
+}
+
+/** Remove a member from a conversation. */
+export function deleteConversationMember(userId: string, conversationId: string) {
+  return prisma.conversationMember.delete({
+    where: {
+      userId_conversationId: { userId, conversationId },
+    },
+  });
+}

package/src/models/event.ts

@@ -0,0 +1,177 @@
+/**
+ * Event model – calendar events, assignment attachment/detachment.
+ */
+import { prisma } from "../lib/prisma.js";
+
+const eventGetInclude = {
+  class: true,
+  user: true,
+  assignmentsAttached: {
+    select: {
+      id: true,
+      title: true,
+      instructions: true,
+      dueDate: true,
+      type: true,
+      graded: true,
+      maxGrade: true,
+      weight: true,
+      attachments: { select: { id: true, name: true, type: true } },
+      section: { select: { id: true, name: true } },
+      teacher: { select: { id: true, username: true } },
+    },
+  },
+};
+
+const eventCreateSelect = {
+  id: true,
+  name: true,
+  location: true,
+  remarks: true,
+  startTime: true,
+  endTime: true,
+  color: true,
+  classId: true,
+  userId: true,
+  class: { select: { id: true, name: true } },
+};
+
+const assignmentUpdateInclude = {
+  attachments: { select: { id: true, name: true, type: true } },
+  section: { select: { id: true, name: true } },
+  teacher: { select: { id: true, username: true } },
+};
+
+/** @returns Event by ID with class, user, attached assignments. */
+export function findEventById(id: string) {
+  return prisma.event.findUnique({
+    where: { id },
+    include: eventGetInclude,
+  });
+}
+
+/** @returns Class if user is a teacher. */
+export function findClassWithTeachers(classId: string, teacherId: string) {
+  return prisma.class.findUnique({
+    where: {
+      id: classId,
+      teachers: { some: { id: teacherId } },
+    },
+  });
+}
+
+/** Create a calendar event. */
+export function createEvent(data: {
+  name?: string;
+  location?: string;
+  remarks?: string;
+  startTime: Date;
+  endTime: Date;
+  userId: string;
+  color?: string;
+  classId?: string;
+}) {
+  return prisma.event.create({
+    data,
+    select: eventCreateSelect,
+  });
+}
+
+/** Update an event. */
+export function updateEvent(
+  id: string,
+  data: {
+    name?: string;
+    location?: string;
+    remarks?: string;
+    startTime?: Date;
+    endTime?: Date;
+    color?: string;
+    classId?: string;
+  }
+) {
+  return prisma.event.update({
+    where: { id },
+    data,
+  });
+}
+
+/** Delete an event. */
+export function deleteEventById(id: string) {
+  return prisma.event.delete({
+    where: { id },
+  });
+}
+
+/** @returns Event with class and teachers. */
+export function findEventWithClass(eventId: string) {
+  return prisma.event.findUnique({
+    where: { id: eventId },
+    include: {
+      class: {
+        include: {
+          teachers: { select: { id: true } },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Assignment with class and teachers. */
+export function findAssignmentWithClass(assignmentId: string) {
+  return prisma.assignment.findUnique({
+    where: { id: assignmentId },
+    include: {
+      class: {
+        include: {
+          teachers: { select: { id: true } },
+        },
+      },
+    },
+  });
+}
+
+/** Attach assignment to an event. */
+export function attachAssignmentToEvent(
+  assignmentId: string,
+  eventId: string
+) {
+  return prisma.assignment.update({
+    where: { id: assignmentId },
+    data: { eventAttached: { connect: { id: eventId } } },
+    include: assignmentUpdateInclude,
+  });
+}
+
+/** Detach assignment from its event. */
+export function detachAssignmentFromEvent(assignmentId: string) {
+  return prisma.assignment.update({
+    where: { id: assignmentId },
+    data: { eventAttached: { disconnect: true } },
+    include: assignmentUpdateInclude,
+  });
+}
+
+/** @returns Assignments not attached to any event. */
+export function findAvailableAssignmentsForClass(classId: string) {
+  return prisma.assignment.findMany({
+    where: {
+      classId,
+      eventId: null,
+    },
+    select: {
+      id: true,
+      title: true,
+      instructions: true,
+      dueDate: true,
+      type: true,
+      graded: true,
+      maxGrade: true,
+      weight: true,
+      section: { select: { id: true, name: true } },
+      attachments: { select: { id: true, name: true, type: true } },
+      teacher: { select: { id: true, username: true } },
+    },
+    orderBy: { createdAt: "desc" },
+  });
+}

package/src/models/file.ts

@@ -0,0 +1,129 @@
+/**
+ * File model – file lookup by ID, folder, assignment, submission. Permission checks.
+ */
+import { prisma } from "../lib/prisma.js";
+
+/** @returns File with assignment, submission, annotations, folder, announcement for permission checks. */
+export function findFileById(fileId: string) {
+  return prisma.file.findUnique({
+    where: { id: fileId },
+    include: {
+      assignment: {
+        include: {
+          class: {
+            include: {
+              students: true,
+              teachers: true,
+            },
+          },
+        },
+      },
+      submission: {
+        include: {
+          student: true,
+          assignment: {
+            include: {
+              class: {
+                include: {
+                  teachers: true,
+                },
+              },
+            },
+          },
+        },
+      },
+      annotations: {
+        include: {
+          student: true,
+          assignment: {
+            include: {
+              class: {
+                include: {
+                  teachers: true,
+                },
+              },
+            },
+          },
+        },
+      },
+      folder: {
+        include: {
+          class: {
+            include: {
+              students: true,
+              teachers: true,
+            },
+          },
+        },
+      },
+      announcement: {
+        include: {
+          class: {
+            include: {
+              students: true,
+              teachers: true,
+            },
+          },
+        },
+      },
+    },
+  });
+}
+
+/** @returns File with folder and class. */
+export function findFileWithFolder(fileId: string) {
+  return prisma.file.findUnique({
+    where: { id: fileId },
+    include: {
+      folder: { include: { class: true } },
+    },
+  });
+}
+
+/** @returns File with folder and thumbnail. */
+export function findFileWithFolderAndThumbnail(fileId: string) {
+  return prisma.file.findUnique({
+    where: { id: fileId },
+    include: {
+      folder: { include: { class: true } },
+      thumbnail: true,
+    },
+  });
+}
+
+/** @returns Folder by ID with class. */
+export function findFolderById(folderId: string) {
+  return prisma.folder.findUnique({
+    where: { id: folderId },
+    include: { class: true },
+  });
+}
+
+/** Move file to a folder. */
+export function updateFileFolder(fileId: string, folderId: string) {
+  return prisma.file.update({
+    where: { id: fileId },
+    data: { folderId },
+    include: {
+      user: { select: { id: true, username: true } },
+    },
+  });
+}
+
+/** Rename a file. */
+export function updateFileName(fileId: string, name: string) {
+  return prisma.file.update({
+    where: { id: fileId },
+    data: { name },
+    include: {
+      user: { select: { id: true, username: true } },
+    },
+  });
+}
+
+/** Delete a file record. */
+export function deleteFileById(fileId: string) {
+  return prisma.file.delete({
+    where: { id: fileId },
+  });
+}