@studious-lms/server 1.2.53 → 1.3.0

package/src/models/folder.ts

@@ -0,0 +1,225 @@
+/**
+ * Folder model – class folders, hierarchy, contents. Teacher permission checks.
+ */
+import { prisma } from "../lib/prisma.js";
+
+const fileSelect = {
+  id: true,
+  name: true,
+  type: true,
+  size: true,
+  uploadedAt: true,
+  user: { select: { id: true, username: true } },
+};
+
+const childFolderSelect = {
+  id: true,
+  name: true,
+  color: true,
+  _count: { select: { files: true, childFolders: true } },
+};
+
+/** @returns Class if user is a teacher. */
+export function findClassWithTeacher(classId: string, teacherId: string) {
+  return prisma.class.findFirst({
+    where: {
+      id: classId,
+      teachers: { some: { id: teacherId } },
+    },
+  });
+}
+
+/** @returns Folder by ID. */
+export function findFolderById(folderId: string) {
+  return prisma.folder.findFirst({
+    where: { id: folderId },
+  });
+}
+
+/** @returns Folder with class. */
+export function findFolderByIdWithClass(folderId: string) {
+  return prisma.folder.findUnique({
+    where: { id: folderId },
+    include: { class: true },
+  });
+}
+
+/** @returns Root folder for a class. */
+export function findRootFolderByClassId(classId: string) {
+  return prisma.folder.findFirst({
+    where: {
+      classId,
+      parentFolderId: null,
+    },
+  });
+}
+
+/** Get or create root folder for a class. */
+export async function findOrCreateRootFolder(classId: string) {
+  let parent = await findRootFolderByClassId(classId);
+  if (!parent) {
+    parent = await prisma.folder.create({
+      data: {
+        name: "Class Files",
+        class: { connect: { id: classId } },
+      },
+    });
+  }
+  return parent;
+}
+
+/** Create a folder. */
+export function createFolder(data: {
+  name: string;
+  parentFolderId?: string | null;
+  classId?: string;
+  color?: string;
+}) {
+  return prisma.folder.create({
+    data: {
+      name: data.name,
+      ...(data.parentFolderId && {
+        parentFolder: { connect: { id: data.parentFolderId } },
+      }),
+      ...(data.classId && { class: { connect: { id: data.classId } } }),
+      ...(data.color && { color: data.color }),
+    },
+    include: {
+      files: {
+        select: fileSelect,
+        orderBy: { uploadedAt: "desc" as const },
+      },
+      childFolders: {
+        select: childFolderSelect,
+        orderBy: { name: "asc" as const },
+      },
+    },
+  });
+}
+
+const folderIncludeWithFiles = {
+  files: {
+    select: fileSelect,
+    orderBy: { uploadedAt: "desc" as const },
+  },
+  childFolders: {
+    select: childFolderSelect,
+    orderBy: { name: "asc" as const },
+  },
+  parentFolder: { select: { id: true, name: true } },
+};
+
+/** @returns Folder with files and child folders. */
+export function findFolderWithContents(folderId: string) {
+  return prisma.folder.findFirst({
+    where: { id: folderId },
+    include: folderIncludeWithFiles,
+  });
+}
+
+/** @returns Direct child folders. */
+export function findChildFolders(parentFolderId: string) {
+  return prisma.folder.findMany({
+    where: { parentFolderId },
+    include: {
+      files: {
+        select: fileSelect,
+        orderBy: { uploadedAt: "desc" as const },
+      },
+      childFolders: {
+        select: childFolderSelect,
+        orderBy: { name: "asc" as const },
+      },
+    },
+    orderBy: { name: "asc" },
+  });
+}
+
+/** @returns Root folder with contents for a class. */
+export function findRootFolderWithContents(classId: string) {
+  return prisma.folder.findFirst({
+    where: { classId, parentFolderId: null },
+    include: {
+      files: {
+        select: fileSelect,
+        orderBy: { uploadedAt: "desc" as const },
+      },
+      childFolders: {
+        select: {
+          ...childFolderSelect,
+          files: { select: { id: true } },
+          childFolders: { select: { id: true } },
+        },
+        orderBy: { name: "asc" as const },
+      },
+    },
+  });
+}
+
+/** @returns Folder with file/folder counts. */
+export function findFolderWithCount(folderId: string, classId: string) {
+  return prisma.folder.findFirst({
+    where: { id: folderId, classId },
+    include: {
+      _count: { select: { files: true, childFolders: true } },
+    },
+  });
+}
+
+/** @returns Folder with file/folder counts. */
+export function findFolderByIdWithCount(folderId: string) {
+  return prisma.folder.findFirst({
+    where: { id: folderId },
+    include: {
+      _count: { select: { files: true, childFolders: true } },
+    },
+  });
+}
+
+/** Delete a folder. */
+export function deleteFolderById(folderId: string) {
+  return prisma.folder.delete({
+    where: { id: folderId },
+  });
+}
+
+/** Move folder to new parent. */
+export function updateFolderParent(folderId: string, parentFolderId: string) {
+  return prisma.folder.update({
+    where: { id: folderId },
+    data: { parentFolderId },
+    include: {
+      files: { select: fileSelect },
+      childFolders: { select: childFolderSelect },
+    },
+  });
+}
+
+/** Update folder name and color. */
+export function updateFolder(
+  folderId: string,
+  data: { name?: string; color?: string }
+) {
+  return prisma.folder.update({
+    where: { id: folderId },
+    data,
+    include: {
+      files: { select: fileSelect },
+      childFolders: { select: childFolderSelect },
+    },
+  });
+}
+
+/** @returns Folder for path traversal. */
+export function findFolderByIdForTraversal(id: string) {
+  return prisma.folder.findUnique({
+    where: { id },
+  });
+}
+
+/** @returns Folder by ID. */
+export function findFolderParents(folderId: string) {
+  return prisma.folder.findFirst({
+    where: { id: folderId },
+  });
+}

package/src/models/labChat.ts

@@ -0,0 +1,213 @@
+/**
+ * Lab chat model – AI lab conversations, members, posts. Teacher/student access.
+ */
+import { prisma } from "../lib/prisma.js";
+
+const labChatInclude = {
+  conversation: {
+    include: {
+      members: {
+        include: {
+          user: {
+            select: {
+              id: true,
+              username: true,
+              profile: {
+                select: {
+                  displayName: true,
+                  profilePicture: true,
+                },
+              },
+            },
+          },
+        },
+      },
+    },
+  },
+  createdBy: {
+    select: {
+      id: true,
+      username: true,
+      profile: {
+        select: {
+          displayName: true,
+          profilePicture: true,
+        },
+      },
+    },
+  },
+  class: {
+    select: {
+      id: true,
+      name: true,
+      subject: true,
+      section: true,
+    },
+  },
+};
+
+/** @returns Class with students and teachers for lab creation. */
+export function findClassWithTeachersForLab(classId: string, teacherId: string) {
+  return prisma.class.findFirst({
+    where: {
+      id: classId,
+      teachers: { some: { id: teacherId } },
+    },
+    include: {
+      students: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+              profilePicture: true,
+            },
+          },
+        },
+      },
+      teachers: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+              profilePicture: true,
+            },
+          },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Lab chat if user is a conversation member. */
+export function findLabChatByMember(labChatId: string, userId: string) {
+  return prisma.labChat.findFirst({
+    where: {
+      id: labChatId,
+      conversation: {
+        members: { some: { userId } },
+      },
+    },
+    include: labChatInclude,
+  });
+}
+
+/** @returns Lab chat if user is class teacher. */
+export function findLabChatByTeacher(labChatId: string, userId: string) {
+  return prisma.labChat.findFirst({
+    where: {
+      id: labChatId,
+      class: {
+        teachers: { some: { id: userId } },
+      },
+    },
+    include: {
+      conversation: { select: { id: true } },
+    },
+  });
+}
+
+/** @returns Lab chat by ID. */
+export function findLabChatById(labChatId: string) {
+  return prisma.labChat.findFirst({
+    where: { id: labChatId },
+    include: labChatInclude,
+  });
+}
+
+/** @returns Class if user is student or teacher. */
+export function findClassMembership(classId: string, userId: string) {
+  return prisma.class.findFirst({
+    where: {
+      id: classId,
+      OR: [
+        { students: { some: { id: userId } } },
+        { teachers: { some: { id: userId } } },
+      ],
+    },
+  });
+}
+
+/** @returns Lab chats for a class. */
+export function findLabChatsByClass(classId: string) {
+  return prisma.labChat.findMany({
+    where: { classId },
+    include: {
+      createdBy: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+            },
+          },
+        },
+      },
+      conversation: {
+        include: {
+          messages: {
+            orderBy: { createdAt: "desc" as const },
+            take: 1,
+            include: {
+              sender: {
+                select: {
+                  id: true,
+                  username: true,
+                  profile: {
+                    select: {
+                      displayName: true,
+                    },
+                  },
+                },
+              },
+            },
+          },
+          _count: { select: { messages: true } },
+        },
+      },
+    },
+    orderBy: { createdAt: "desc" as const },
+  });
+}
+
+/** @returns Lab chat if user can post (member or teacher). */
+export function findLabChatForPost(labChatId: string, userId: string) {
+  return prisma.labChat.findFirst({
+    where: {
+      id: labChatId,
+      conversation: {
+        members: { some: { userId } },
+      },
+    },
+    include: {
+      conversation: { select: { id: true } },
+    },
+  });
+}
+
+/** @returns Lab chat if user can delete (teacher). */
+export function findLabChatForDelete(labChatId: string, userId: string) {
+  return prisma.labChat.findFirst({
+    where: {
+      id: labChatId,
+      createdById: userId,
+    },
+  });
+}
+
+/** @returns Conversation members for mentioned user IDs. */
+export function findMentionedMemberships(
+  conversationId: string,
+  userIds: string[]
+) {
+  return prisma.conversationMember.findMany({
+    where: {
+      conversationId,
+      userId: { in: userIds },
+    },
+  });
+}

package/src/models/marketing.ts

@@ -0,0 +1,45 @@
+/**
+ * Marketing model – school development programs, early access requests.
+ */
+import { prisma } from "../lib/prisma.js";
+
+/** Create a school development program application. */
+export function createSchoolDevelopmentProgram(data: {
+  id: string;
+  name: string;
+  type: string;
+  address: string;
+  city: string;
+  country: string;
+  numberOfStudents: number;
+  numberOfTeachers: number;
+  website?: string;
+  contactName?: string;
+  contactRole?: string;
+  contactEmail?: string;
+  contactPhone?: string;
+  eligibilityInformation?: string;
+  whyHelp?: string;
+  additionalInformation?: string;
+}) {
+  return prisma.schoolDevelopementProgram.create({
+    data,
+  });
+}
+
+/** @returns School development program by ID. */
+export function findSchoolDevelopmentProgramById(id: string) {
+  return prisma.schoolDevelopementProgram.findUnique({
+    where: { id },
+  });
+}
+
+/** Create an early access request. */
+export function createEarlyAccessRequest(data: {
+  email: string;
+  institutionSize: string;
+}) {
+  return prisma.earlyAccessRequest.create({
+    data,
+  });
+}

package/src/models/message.ts

@@ -0,0 +1,153 @@
+/**
+ * Message model – messages, attachments, mentions, unread counts.
+ */
+import { prisma } from "../lib/prisma.js";
+
+const messageInclude = {
+  attachments: {
+    select: {
+      id: true,
+      name: true,
+      type: true,
+    },
+  },
+  sender: {
+    select: {
+      id: true,
+      username: true,
+      profile: {
+        select: {
+          displayName: true,
+          profilePicture: true,
+        },
+      },
+    },
+  },
+  mentions: {
+    include: {
+      user: {
+        select: {
+          id: true,
+          username: true,
+          profile: {
+            select: {
+              displayName: true,
+            },
+          },
+        },
+      },
+    },
+  },
+};
+
+const senderSelect = {
+  id: true,
+  username: true,
+  profile: {
+    select: {
+      displayName: true,
+      profilePicture: true,
+    },
+  },
+};
+
+/** @returns User's membership in a conversation. */
+export function findConversationMembership(conversationId: string, userId: string) {
+  return prisma.conversationMember.findFirst({
+    where: {
+      conversationId,
+      userId,
+    },
+  });
+}
+
+/** @returns Messages in conversation with cursor pagination. */
+export function findMessages(
+  conversationId: string,
+  options: {
+    cursor?: Date;
+    limit: number;
+  }
+) {
+  return prisma.message.findMany({
+    where: {
+      conversationId,
+      ...(options.cursor && {
+        createdAt: { lt: options.cursor },
+      }),
+    },
+    include: messageInclude,
+    orderBy: { createdAt: "desc" as const },
+    take: options.limit + 1,
+  });
+}
+
+/** @returns Memberships for mentioned users. */
+export function findMentionedMemberships(
+  conversationId: string,
+  userIds: string[]
+) {
+  return prisma.conversationMember.findMany({
+    where: {
+      conversationId,
+      userId: { in: userIds },
+    },
+  });
+}
+
+/** @returns Message by ID with sender. */
+export function findMessageById(messageId: string) {
+  return prisma.message.findUnique({
+    where: { id: messageId },
+    include: {
+      sender: {
+        select: senderSelect,
+      },
+    },
+  });
+}
+
+/** @returns Message by ID with minimal sender. */
+export function findMessageByIdMinimal(messageId: string) {
+  return prisma.message.findUnique({
+    where: { id: messageId },
+    include: {
+      sender: {
+        select: { id: true, username: true },
+      },
+    },
+  });
+}
+
+/** Count messages in conversation after date, excluding sender's own. */
+export function countUnreadMessages(
+  conversationId: string,
+  userId: string,
+  after?: Date
+) {
+  return prisma.message.count({
+    where: {
+      conversationId,
+      senderId: { not: userId },
+      ...(after && { createdAt: { gt: after } }),
+    },
+  });
+}
+
+/** Count mentions of user in conversation after date. */
+export function countUnreadMentions(
+  conversationId: string,
+  userId: string,
+  after?: Date
+) {
+  return prisma.mention.count({
+    where: {
+      userId,
+      message: {
+        conversationId,
+        senderId: { not: userId },
+        ...(after && { createdAt: { gt: after } }),
+      },
+    },
+  });
+}

package/src/models/newtonChat.ts

@@ -0,0 +1,70 @@
+/**
+ * Newton chat model – tutor conversations linked to submissions.
+ */
+import { prisma } from "../lib/prisma.js";
+
+/** @returns Class if user is a student. */
+export function findClassWithStudent(classId: string, studentId: string) {
+  return prisma.class.findFirst({
+    where: {
+      id: classId,
+      students: { some: { id: studentId } },
+    },
+  });
+}
+
+/** @returns Submission for assignment and student. */
+export function findSubmissionByAssignmentAndStudent(
+  assignmentId: string,
+  studentId: string
+) {
+  return prisma.submission.findFirst({
+    where: {
+      assignmentId,
+      studentId,
+    },
+  });
+}
+
+/** @returns Newton chat if user is a member, with conversation and assignment. */
+export function findNewtonChatByIdAndMember(
+  newtonChatId: string,
+  userId: string
+) {
+  return prisma.newtonChat.findFirst({
+    where: {
+      id: newtonChatId,
+      conversation: {
+        members: { some: { userId } },
+      },
+    },
+    include: {
+      conversation: { select: { id: true } },
+      submission: {
+        include: {
+          assignment: {
+            select: {
+              id: true,
+              title: true,
+              instructions: true,
+              class: { select: { subject: true } },
+            },
+          },
+        },
+      },
+    },
+  });
+}
+
+/** @returns Conversation members for given user IDs. */
+export function findConversationMembersByUserIds(
+  conversationId: string,
+  userIds: string[]
+) {
+  return prisma.conversationMember.findMany({
+    where: {
+      conversationId,
+      userId: { in: userIds },
+    },
+  });
+}