@studious-lms/server 1.4.6 → 1.4.9

package/src/services/school.ts

@@ -0,0 +1,308 @@
+/**
+ * School service - school admin workflow, memberships, and invites.
+ */
+import { SchoolMembershipRole } from "@prisma/client";
+import { TRPCError } from "@trpc/server";
+import { v4 as uuidv4 } from "uuid";
+import { env } from "../lib/config/env.js";
+import { prisma } from "../lib/prisma.js";
+import { sendMail } from "../utils/email.js";
+import { logger } from "../utils/logger.js";
+import {
+  acceptSchoolInvite,
+  countActiveAdmins,
+  createSchoolInvite,
+  createSchoolWithAdmin,
+  findActiveSchoolAdminMembership,
+  findPendingInviteByToken,
+  findSchoolMembership,
+  findUserByIdForSchool,
+  getSchoolById,
+  getSchoolOverview,
+  listSchoolClasses,
+  listSchoolInvites,
+  listSchoolMembers,
+  listUserSchoolMemberships,
+  removeSchoolMembershipPreservingContent,
+  revokeSchoolInvite,
+  updateSchoolMembershipRole,
+  upsertSchoolMembership,
+} from "../models/school.js";
+
+async function requireSchoolAdmin(schoolId: string, userId: string) {
+  const membership = await findActiveSchoolAdminMembership(schoolId, userId);
+  if (!membership) {
+    throw new TRPCError({
+      code: "FORBIDDEN",
+      message: "Only school admins can perform this action",
+    });
+  }
+  return membership;
+}
+
+async function requireSchoolMember(schoolId: string, userId: string) {
+  const membership = await findSchoolMembership(schoolId, userId);
+  if (!membership || membership.status !== "ACTIVE") {
+    throw new TRPCError({
+      code: "FORBIDDEN",
+      message: "You are not a member of this school",
+    });
+  }
+  return membership;
+}
+
+export async function getCurrentSchool(userId: string, schoolId?: string) {
+  const memberships = await listUserSchoolMemberships(userId);
+  const activeMembership = schoolId
+    ? memberships.find((membership) => membership.schoolId === schoolId)
+    : memberships[0];
+
+  return {
+    activeSchool: activeMembership?.school ?? null,
+    activeRole: activeMembership?.role ?? null,
+    memberships,
+  };
+}
+
+export async function createSchoolRecord(
+  userId: string,
+  input: { name: string; subdomain?: string; logoId?: string }
+) {
+  const school = await createSchoolWithAdmin({
+    userId,
+    name: input.name,
+    subdomain: input.subdomain,
+    logoId: input.logoId,
+  });
+
+  return { school };
+}
+
+export async function getAdminOverview(userId: string, schoolId: string) {
+  await requireSchoolAdmin(schoolId, userId);
+  const school = await getSchoolOverview(schoolId);
+  if (!school) {
+    throw new TRPCError({ code: "NOT_FOUND", message: "School not found" });
+  }
+
+  const roleCounts = school.memberships.reduce(
+    (counts, membership) => {
+      counts[membership.role] += 1;
+      return counts;
+    },
+    { ADMIN: 0, TEACHER: 0, STUDENT: 0 } satisfies Record<SchoolMembershipRole, number>
+  );
+
+  return {
+    school: {
+      id: school.id,
+      name: school.name,
+      subdomain: school.subdomain,
+      counts: {
+        classes: school._count.classes,
+        members: school._count.memberships,
+        pendingInvites: school._count.invites,
+        ...roleCounts,
+      },
+      recentClasses: school.classes,
+      recentInvites: school.invites,
+    },
+  };
+}
+
+export async function listClasses(userId: string, schoolId: string) {
+  await requireSchoolAdmin(schoolId, userId);
+  return { classes: await listSchoolClasses(schoolId) };
+}
+
+export async function createSchoolClass(
+  userId: string,
+  input: {
+    schoolId: string;
+    name: string;
+    section: string;
+    subject: string;
+    color?: string;
+    teachers?: string[];
+    students?: string[];
+  }
+) {
+  await requireSchoolAdmin(input.schoolId, userId);
+  const createdClass = await prisma.class.create({
+    data: {
+      name: input.name,
+      section: input.section,
+      subject: input.subject,
+      color: input.color,
+      schoolId: input.schoolId,
+      teachers: input.teachers?.length
+        ? { connect: input.teachers.map((id) => ({ id })) }
+        : undefined,
+      students: input.students?.length
+        ? { connect: input.students.map((id) => ({ id })) }
+        : undefined,
+    },
+    include: { teachers: true, students: true },
+  });
+
+  return { class: createdClass };
+}
+
+export async function listMembers(userId: string, schoolId: string) {
+  await requireSchoolAdmin(schoolId, userId);
+  return { members: await listSchoolMembers(schoolId) };
+}
+
+export async function addMember(
+  userId: string,
+  input: { schoolId: string; memberUserId: string; role: SchoolMembershipRole }
+) {
+  await requireSchoolAdmin(input.schoolId, userId);
+  const membership = await upsertSchoolMembership({
+    schoolId: input.schoolId,
+    userId: input.memberUserId,
+    role: input.role,
+  });
+  return { membership };
+}
+
+export async function updateMemberRole(
+  userId: string,
+  input: { schoolId: string; memberUserId: string; role: SchoolMembershipRole }
+) {
+  await requireSchoolAdmin(input.schoolId, userId);
+  const current = await findSchoolMembership(input.schoolId, input.memberUserId);
+  if (!current) {
+    throw new TRPCError({ code: "NOT_FOUND", message: "Member not found" });
+  }
+
+  if (current.role === "ADMIN" && input.role !== "ADMIN") {
+    const adminCount = await countActiveAdmins(input.schoolId);
+    if (adminCount <= 1) {
+      throw new TRPCError({
+        code: "BAD_REQUEST",
+        message: "A school must have at least one active admin",
+      });
+    }
+  }
+
+  const membership = await updateSchoolMembershipRole(
+    input.schoolId,
+    input.memberUserId,
+    input.role
+  );
+  return { membership };
+}
+
+export async function removeMember(
+  userId: string,
+  input: { schoolId: string; memberUserId: string }
+) {
+  await requireSchoolAdmin(input.schoolId, userId);
+  const current = await findSchoolMembership(input.schoolId, input.memberUserId);
+  if (!current) {
+    throw new TRPCError({ code: "NOT_FOUND", message: "Member not found" });
+  }
+
+  if (current.role === "ADMIN" && current.status === "ACTIVE") {
+    const adminCount = await countActiveAdmins(input.schoolId);
+    if (adminCount <= 1) {
+      throw new TRPCError({
+        code: "BAD_REQUEST",
+        message: "A school must have at least one active admin",
+      });
+    }
+  }
+
+  await removeSchoolMembershipPreservingContent(input.schoolId, input.memberUserId);
+  return { success: true };
+}
+
+export async function listInvites(userId: string, schoolId: string) {
+  await requireSchoolAdmin(schoolId, userId);
+  return { invites: await listSchoolInvites(schoolId) };
+}
+
+export async function createInvite(
+  userId: string,
+  input: { schoolId: string; email: string; role: SchoolMembershipRole }
+) {
+  await requireSchoolAdmin(input.schoolId, userId);
+  const token = uuidv4();
+  const invite = await createSchoolInvite({
+    schoolId: input.schoolId,
+    invitedById: userId,
+    email: input.email,
+    role: input.role,
+    token,
+    expiresAt: new Date(Date.now() + 1000 * 60 * 60 * 24 * 14),
+  });
+
+  try {
+    await sendMail({
+      from: "hello@studious.sh",
+      to: input.email,
+      subject: `Join ${invite.school.name} on Studious`,
+      text: `Click the link to join ${invite.school.name}: ${env.NEXT_PUBLIC_APP_URL}/school/invite/${token}`,
+    });
+  } catch (err) {
+    logger.error("Failed to send school invite email", {
+      schoolId: input.schoolId,
+      email: input.email,
+      err,
+    });
+  }
+
+  return { invite };
+}
+
+export async function revokeInvite(
+  userId: string,
+  input: { schoolId: string; inviteId: string }
+) {
+  await requireSchoolAdmin(input.schoolId, userId);
+  return { invite: await revokeSchoolInvite(input.inviteId, input.schoolId) };
+}
+
+export async function getInvite(token: string) {
+  const invite = await findPendingInviteByToken(token);
+  if (!invite || invite.status !== "PENDING") {
+    throw new TRPCError({ code: "NOT_FOUND", message: "Invite not found" });
+  }
+  if (invite.expiresAt < new Date()) {
+    throw new TRPCError({ code: "UNAUTHORIZED", message: "Invite expired" });
+  }
+  return {
+    invite: {
+      id: invite.id,
+      email: invite.email,
+      role: invite.role,
+      school: invite.school,
+      expiresAt: invite.expiresAt,
+    },
+  };
+}
+
+export async function acceptInvite(userId: string, token: string) {
+  const invite = await findPendingInviteByToken(token);
+  if (!invite || invite.status !== "PENDING") {
+    throw new TRPCError({ code: "NOT_FOUND", message: "Invite not found" });
+  }
+  if (invite.expiresAt < new Date()) {
+    throw new TRPCError({ code: "UNAUTHORIZED", message: "Invite expired" });
+  }
+
+  const user = await findUserByIdForSchool(userId);
+  if (!user) {
+    throw new TRPCError({ code: "NOT_FOUND", message: "User not found" });
+  }
+  if (user.email.toLowerCase() !== invite.email.toLowerCase()) {
+    throw new TRPCError({
+      code: "FORBIDDEN",
+      message: "This invite was sent to a different account",
+    });
+  }
+
+  const membership = await acceptSchoolInvite(invite.id, userId);
+  return { membership };
+}

package/src/services/worksheet.ts

@@ -14,6 +14,7 @@ import {
   findWorksheetByIdForTeacher,
   findWorksheetsByClassId,
   createWorksheet,
+  duplicateWorksheet,
   updateWorksheet,
   deleteWorksheet,
   findQuestionsByWorksheetId,
@@ -123,6 +124,51 @@ export async function createWorksheetRecord(classId: string, name: string) {
   return createWorksheet({ classId, name });
 }
 
+/**
+ * Duplicate a worksheet into another class. Caller must teach both the source worksheet's class
+ * and the target class.
+ */
+export async function duplicateWorksheetRecord(
+  worksheetId: string,
+  classId: string,
+  name: string,
+  userId: string
+) {
+  const source = await findWorksheetByIdForTeacher(worksheetId, userId);
+  if (!source) {
+    throw new TRPCError({
+      code: "NOT_FOUND",
+      message:
+        "Worksheet not found or you are not a teacher of the class it belongs to",
+    });
+  }
+
+  const targetOk = await prisma.class.findFirst({
+    where: {
+      id: classId,
+      teachers: { some: { id: userId } },
+    },
+    select: { id: true },
+  });
+
+  if (!targetOk) {
+    throw new TRPCError({
+      code: "FORBIDDEN",
+      message: "You are not a teacher of the target class",
+    });
+  }
+
+  const created = await duplicateWorksheet(worksheetId, classId, name);
+  if (!created) {
+    throw new TRPCError({
+      code: "NOT_FOUND",
+      message: "Worksheet not found",
+    });
+  }
+
+  return created;
+}
+
 /**
  * Create a worksheet by converting a PDF (URL) into structured questions.
  * Uses the `pdfToWorksheet` pipeline to do inference + persistence.

package/dist/lib/notificationHandler.d.ts

@@ -1,25 +0,0 @@
-interface notificationData {
-    title: string;
-    content: string;
-}
-export declare function sendNotification(receiver: string, data: notificationData): Promise<{
-    id: string;
-    title: string;
-    content: string;
-    createdAt: Date;
-    read: boolean;
-    senderId: string | null;
-    receiverId: string;
-}>;
-export declare function sendNotifications(receiverIds: Array<string>, data: notificationData): Promise<import(".prisma/client").Prisma.BatchPayload>;
-export declare function markRead(id: string, read?: boolean): Promise<{
-    id: string;
-    title: string;
-    content: string;
-    createdAt: Date;
-    read: boolean;
-    senderId: string | null;
-    receiverId: string;
-}>;
-export {};
-//# sourceMappingURL=notificationHandler.d.ts.map

package/dist/lib/notificationHandler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"notificationHandler.d.ts","sourceRoot":"/","sources":["lib/notificationHandler.ts"],"names":[],"mappings":"AAEA,UAAU,gBAAgB;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAA;CAClB;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,gBAAgB;;;;;;;;GAS9E;AAED,wBAAsB,iBAAiB,CAAC,WAAW,EAAE,KAAK,CAAC,MAAM,CAAC,EAAE,IAAI,EAAE,gBAAgB,yDASzF;AAED,wBAAsB,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,GAAE,OAAc;;;;;;;;GAM9D"}

package/dist/lib/notificationHandler.js

@@ -1,32 +0,0 @@
-
-!function(){try{var e="undefined"!=typeof window?window:"undefined"!=typeof global?global:"undefined"!=typeof globalThis?globalThis:"undefined"!=typeof self?self:{},n=(new e.Error).stack;n&&(e._sentryDebugIds=e._sentryDebugIds||{},e._sentryDebugIds[n]="e0e01d37-e6fd-5751-a9d2-fece72c46422")}catch(e){}}();
-import { prisma } from "./prisma.js";
-export async function sendNotification(receiver, data) {
-    const notification = await prisma.notification.create({
-        data: {
-            receiverId: receiver,
-            title: data.title,
-            content: data.content,
-        },
-    });
-    return notification;
-}
-export async function sendNotifications(receiverIds, data) {
-    const notifications = await prisma.notification.createMany({
-        data: receiverIds.map(receiverId => ({
-            receiverId: receiverId,
-            title: data.title,
-            content: data.content,
-        })),
-    });
-    return notifications;
-}
-export async function markRead(id, read = true) {
-    const notification = await prisma.notification.update({
-        where: { id },
-        data: { read: read },
-    });
-    return notification;
-}
-//# sourceMappingURL=notificationHandler.js.map
-//# debugId=e0e01d37-e6fd-5751-a9d2-fece72c46422

package/dist/lib/notificationHandler.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"notificationHandler.js","sources":["lib/notificationHandler.ts"],"sourceRoot":"/","sourcesContent":["import { prisma } from \"./prisma.js\";\n\ninterface notificationData {\n    title: string,\n    content: string\n}\n\nexport async function sendNotification(receiver: string, data: notificationData) {\n    const notification = await prisma.notification.create({\n        data: {\n            receiverId: receiver,\n            title: data.title,\n            content: data.content,\n        },\n    });\n    return notification;\n}\n\nexport async function sendNotifications(receiverIds: Array<string>, data: notificationData) {\n    const notifications = await prisma.notification.createMany({\n        data: receiverIds.map(receiverId => ({\n            receiverId: receiverId,\n            title: data.title,\n            content: data.content,\n        })),\n    });\n    return notifications;\n}\n\nexport async function markRead(id: string, read: boolean = true) {\n    const notification = await prisma.notification.update({\n        where: {id},\n        data: {read: read},\n    });\n    return notification;\n}\n"],"names":[],"mappings":";;AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAOrC,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,QAAgB,EAAE,IAAsB;IAC3E,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;QAClD,IAAI,EAAE;YACF,UAAU,EAAE,QAAQ;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB;KACJ,CAAC,CAAC;IACH,OAAO,YAAY,CAAC;AACxB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,WAA0B,EAAE,IAAsB;IACtF,MAAM,aAAa,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,UAAU,CAAC;QACvD,IAAI,EAAE,WAAW,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC,CAAC;YACjC,UAAU,EAAE,UAAU;YACtB,KAAK,EAAE,IAAI,CAAC,KAAK;YACjB,OAAO,EAAE,IAAI,CAAC,OAAO;SACxB,CAAC,CAAC;KACN,CAAC,CAAC;IACH,OAAO,aAAa,CAAC;AACzB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAAC,EAAU,EAAE,OAAgB,IAAI;IAC3D,MAAM,YAAY,GAAG,MAAM,MAAM,CAAC,YAAY,CAAC,MAAM,CAAC;QAClD,KAAK,EAAE,EAAC,EAAE,EAAC;QACX,IAAI,EAAE,EAAC,IAAI,EAAE,IAAI,EAAC;KACrB,CAAC,CAAC;IACH,OAAO,YAAY,CAAC;AACxB,CAAC","debug_id":"e0e01d37-e6fd-5751-a9d2-fece72c46422"}

package/dist/server/pipelines/aiLabChat.d.ts

@@ -1,21 +0,0 @@
-import { Assignment, Class, File, Section, User } from "@prisma/client";
-export declare const getBaseSystemPrompt: (context: Class, members: User[], assignments: Assignment[], files: File[], sections: Section[]) => string;
-/**
- * Generate labchat responses
- * Allow for the generation of the following:
- * - Assignment(s) either individual or bulk as an lesson / course plan.
- * - Worksheet(s) either individual or bulk as an lesson / course plan.
- * - Files (PDFs)
- * @param labChatId
- */
-/**
- * Generate and send AI introduction for lab chat
- * Uses the stored context directly from database
- */
-export declare const generateAndSendLabIntroduction: (labChatId: string, conversationId: string, contextString: string, subject: string) => Promise<void>;
-/**
- * Generate and send AI response to teacher message
- * Uses the stored context directly from database
- */
-export declare const generateAndSendLabResponse: (labChatId: string, teacherMessage: string, conversationId: string) => Promise<void>;
-//# sourceMappingURL=aiLabChat.d.ts.map

package/dist/server/pipelines/aiLabChat.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"aiLabChat.d.ts","sourceRoot":"/","sources":["server/pipelines/aiLabChat.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,gBAAgB,CAAC;AA4ExE,eAAO,MAAM,mBAAmB,GAAI,SAAS,KAAK,EAAE,SAAS,IAAI,EAAE,EAAE,aAAa,UAAU,EAAE,EAAE,OAAO,IAAI,EAAE,EAAE,UAAU,OAAO,EAAE,WA6BjI,CAAA;AAID;;;;;;;GAOG;AAoBH;;;GAGG;AACH,eAAO,MAAM,8BAA8B,GACvC,WAAW,MAAM,EACjB,gBAAgB,MAAM,EACtB,eAAe,MAAM,EACrB,SAAS,MAAM,KACd,OAAO,CAAC,IAAI,CA2Dd,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,0BAA0B,GACrC,WAAW,MAAM,EACjB,gBAAgB,MAAM,EACtB,gBAAgB,MAAM,KACrB,OAAO,CAAC,IAAI,CAkSd,CAAA"}