@studious-lms/server 1.4.9 → 1.6.0

package/dist/services/school.js.map

@@ -1 +1 @@
-{"version":3,"file":"school.js","sources":["services/school.ts"],"sourceRoot":"/","sourcesContent":["/**\n * School service - school admin workflow, memberships, and invites.\n */\nimport { SchoolMembershipRole } from \"@prisma/client\";\nimport { TRPCError } from \"@trpc/server\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport { env } from \"../lib/config/env.js\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { sendMail } from \"../utils/email.js\";\nimport { logger } from \"../utils/logger.js\";\nimport {\n  acceptSchoolInvite,\n  countActiveAdmins,\n  createSchoolInvite,\n  createSchoolWithAdmin,\n  findActiveSchoolAdminMembership,\n  findPendingInviteByToken,\n  findSchoolMembership,\n  findUserByIdForSchool,\n  getSchoolById,\n  getSchoolOverview,\n  listSchoolClasses,\n  listSchoolInvites,\n  listSchoolMembers,\n  listUserSchoolMemberships,\n  removeSchoolMembershipPreservingContent,\n  revokeSchoolInvite,\n  updateSchoolMembershipRole,\n  upsertSchoolMembership,\n} from \"../models/school.js\";\n\nasync function requireSchoolAdmin(schoolId: string, userId: string) {\n  const membership = await findActiveSchoolAdminMembership(schoolId, userId);\n  if (!membership) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only school admins can perform this action\",\n    });\n  }\n  return membership;\n}\n\nasync function requireSchoolMember(schoolId: string, userId: string) {\n  const membership = await findSchoolMembership(schoolId, userId);\n  if (!membership || membership.status !== \"ACTIVE\") {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You are not a member of this school\",\n    });\n  }\n  return membership;\n}\n\nexport async function getCurrentSchool(userId: string, schoolId?: string) {\n  const memberships = await listUserSchoolMemberships(userId);\n  const activeMembership = schoolId\n    ? memberships.find((membership) => membership.schoolId === schoolId)\n    : memberships[0];\n\n  return {\n    activeSchool: activeMembership?.school ?? null,\n    activeRole: activeMembership?.role ?? null,\n    memberships,\n  };\n}\n\nexport async function createSchoolRecord(\n  userId: string,\n  input: { name: string; subdomain?: string; logoId?: string }\n) {\n  const school = await createSchoolWithAdmin({\n    userId,\n    name: input.name,\n    subdomain: input.subdomain,\n    logoId: input.logoId,\n  });\n\n  return { school };\n}\n\nexport async function getAdminOverview(userId: string, schoolId: string) {\n  await requireSchoolAdmin(schoolId, userId);\n  const school = await getSchoolOverview(schoolId);\n  if (!school) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"School not found\" });\n  }\n\n  const roleCounts = school.memberships.reduce(\n    (counts, membership) => {\n      counts[membership.role] += 1;\n      return counts;\n    },\n    { ADMIN: 0, TEACHER: 0, STUDENT: 0 } satisfies Record<SchoolMembershipRole, number>\n  );\n\n  return {\n    school: {\n      id: school.id,\n      name: school.name,\n      subdomain: school.subdomain,\n      counts: {\n        classes: school._count.classes,\n        members: school._count.memberships,\n        pendingInvites: school._count.invites,\n        ...roleCounts,\n      },\n      recentClasses: school.classes,\n      recentInvites: school.invites,\n    },\n  };\n}\n\nexport async function listClasses(userId: string, schoolId: string) {\n  await requireSchoolAdmin(schoolId, userId);\n  return { classes: await listSchoolClasses(schoolId) };\n}\n\nexport async function createSchoolClass(\n  userId: string,\n  input: {\n    schoolId: string;\n    name: string;\n    section: string;\n    subject: string;\n    color?: string;\n    teachers?: string[];\n    students?: string[];\n  }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  const createdClass = await prisma.class.create({\n    data: {\n      name: input.name,\n      section: input.section,\n      subject: input.subject,\n      color: input.color,\n      schoolId: input.schoolId,\n      teachers: input.teachers?.length\n        ? { connect: input.teachers.map((id) => ({ id })) }\n        : undefined,\n      students: input.students?.length\n        ? { connect: input.students.map((id) => ({ id })) }\n        : undefined,\n    },\n    include: { teachers: true, students: true },\n  });\n\n  return { class: createdClass };\n}\n\nexport async function listMembers(userId: string, schoolId: string) {\n  await requireSchoolAdmin(schoolId, userId);\n  return { members: await listSchoolMembers(schoolId) };\n}\n\nexport async function addMember(\n  userId: string,\n  input: { schoolId: string; memberUserId: string; role: SchoolMembershipRole }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  const membership = await upsertSchoolMembership({\n    schoolId: input.schoolId,\n    userId: input.memberUserId,\n    role: input.role,\n  });\n  return { membership };\n}\n\nexport async function updateMemberRole(\n  userId: string,\n  input: { schoolId: string; memberUserId: string; role: SchoolMembershipRole }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  const current = await findSchoolMembership(input.schoolId, input.memberUserId);\n  if (!current) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"Member not found\" });\n  }\n\n  if (current.role === \"ADMIN\" && input.role !== \"ADMIN\") {\n    const adminCount = await countActiveAdmins(input.schoolId);\n    if (adminCount <= 1) {\n      throw new TRPCError({\n        code: \"BAD_REQUEST\",\n        message: \"A school must have at least one active admin\",\n      });\n    }\n  }\n\n  const membership = await updateSchoolMembershipRole(\n    input.schoolId,\n    input.memberUserId,\n    input.role\n  );\n  return { membership };\n}\n\nexport async function removeMember(\n  userId: string,\n  input: { schoolId: string; memberUserId: string }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  const current = await findSchoolMembership(input.schoolId, input.memberUserId);\n  if (!current) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"Member not found\" });\n  }\n\n  if (current.role === \"ADMIN\" && current.status === \"ACTIVE\") {\n    const adminCount = await countActiveAdmins(input.schoolId);\n    if (adminCount <= 1) {\n      throw new TRPCError({\n        code: \"BAD_REQUEST\",\n        message: \"A school must have at least one active admin\",\n      });\n    }\n  }\n\n  await removeSchoolMembershipPreservingContent(input.schoolId, input.memberUserId);\n  return { success: true };\n}\n\nexport async function listInvites(userId: string, schoolId: string) {\n  await requireSchoolAdmin(schoolId, userId);\n  return { invites: await listSchoolInvites(schoolId) };\n}\n\nexport async function createInvite(\n  userId: string,\n  input: { schoolId: string; email: string; role: SchoolMembershipRole }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  const token = uuidv4();\n  const invite = await createSchoolInvite({\n    schoolId: input.schoolId,\n    invitedById: userId,\n    email: input.email,\n    role: input.role,\n    token,\n    expiresAt: new Date(Date.now() + 1000 * 60 * 60 * 24 * 14),\n  });\n\n  try {\n    await sendMail({\n      from: \"hello@studious.sh\",\n      to: input.email,\n      subject: `Join ${invite.school.name} on Studious`,\n      text: `Click the link to join ${invite.school.name}: ${env.NEXT_PUBLIC_APP_URL}/school/invite/${token}`,\n    });\n  } catch (err) {\n    logger.error(\"Failed to send school invite email\", {\n      schoolId: input.schoolId,\n      email: input.email,\n      err,\n    });\n  }\n\n  return { invite };\n}\n\nexport async function revokeInvite(\n  userId: string,\n  input: { schoolId: string; inviteId: string }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  return { invite: await revokeSchoolInvite(input.inviteId, input.schoolId) };\n}\n\nexport async function getInvite(token: string) {\n  const invite = await findPendingInviteByToken(token);\n  if (!invite || invite.status !== \"PENDING\") {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"Invite not found\" });\n  }\n  if (invite.expiresAt < new Date()) {\n    throw new TRPCError({ code: \"UNAUTHORIZED\", message: \"Invite expired\" });\n  }\n  return {\n    invite: {\n      id: invite.id,\n      email: invite.email,\n      role: invite.role,\n      school: invite.school,\n      expiresAt: invite.expiresAt,\n    },\n  };\n}\n\nexport async function acceptInvite(userId: string, token: string) {\n  const invite = await findPendingInviteByToken(token);\n  if (!invite || invite.status !== \"PENDING\") {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"Invite not found\" });\n  }\n  if (invite.expiresAt < new Date()) {\n    throw new TRPCError({ code: \"UNAUTHORIZED\", message: \"Invite expired\" });\n  }\n\n  const user = await findUserByIdForSchool(userId);\n  if (!user) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"User not found\" });\n  }\n  if (user.email.toLowerCase() !== invite.email.toLowerCase()) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"This invite was sent to a different account\",\n    });\n  }\n\n  const membership = await acceptSchoolInvite(invite.id, userId);\n  return { membership };\n}\n"],"names":[],"mappings":"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","debug_id":"eb106c0e-5f2a-504b-9b64-f273c0b7478e"}
+{"version":3,"file":"school.js","sources":["services/school.ts"],"sourceRoot":"/","sourcesContent":["/**\n * School service - school admin workflow, memberships, and invites.\n */\nimport { SchoolMembershipRole, SessionType } from \"@prisma/client\";\nimport { TRPCError } from \"@trpc/server\";\nimport { hash } from \"bcryptjs\";\nimport { v4 as uuidv4 } from \"uuid\";\nimport { env } from \"../lib/config/env.js\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { sendMail } from \"../utils/email.js\";\nimport { generateUniqueUsername } from \"../utils/generateUsername.js\";\nimport { logger } from \"../utils/logger.js\";\nimport {\n  createSession,\n  createUser,\n  findUserByEmail,\n  findUserById,\n  findUserByUsername,\n} from \"../models/auth.js\";\nimport { upsertUserProfile } from \"../models/user.js\";\nimport {\n  acceptSchoolInvite,\n  countActiveAdmins,\n  createSchoolInvite,\n  createSchoolWithAdmin,\n  findActiveSchoolAdminMembership,\n  findPendingInviteByToken,\n  findSchoolMembership,\n  getSchoolById,\n  getSchoolOverview,\n  listSchoolClasses,\n  listSchoolInvites,\n  listSchoolMembers,\n  listUserSchoolMemberships,\n  removeSchoolMembershipPreservingContent,\n  revokeSchoolInvite,\n  updateSchoolMembershipRole,\n  upsertSchoolMembership,\n} from \"../models/school.js\";\n\nasync function requireSchoolAdmin(schoolId: string, userId: string) {\n  const membership = await findActiveSchoolAdminMembership(schoolId, userId);\n  if (!membership) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only school admins can perform this action\",\n    });\n  }\n  return membership;\n}\n\nasync function requireSchoolMember(schoolId: string, userId: string) {\n  const membership = await findSchoolMembership(schoolId, userId);\n  if (!membership || membership.status !== \"ACTIVE\") {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You are not a member of this school\",\n    });\n  }\n  return membership;\n}\n\nexport async function getCurrentSchool(userId: string, schoolId?: string) {\n  const memberships = await listUserSchoolMemberships(userId);\n  const activeMembership = schoolId\n    ? memberships.find((membership) => membership.schoolId === schoolId)\n    : memberships[0];\n\n  return {\n    activeSchool: activeMembership?.school ?? null,\n    activeRole: activeMembership?.role ?? null,\n    memberships,\n  };\n}\n\nexport async function createSchoolRecord(\n  userId: string,\n  input: { name: string; subdomain?: string; logoId?: string }\n) {\n  const school = await createSchoolWithAdmin({\n    userId,\n    name: input.name,\n    subdomain: input.subdomain,\n    logoId: input.logoId,\n  });\n\n  return { school };\n}\n\nexport async function getAdminOverview(userId: string, schoolId: string) {\n  await requireSchoolAdmin(schoolId, userId);\n  const school = await getSchoolOverview(schoolId);\n  if (!school) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"School not found\" });\n  }\n\n  const roleCounts = school.memberships.reduce(\n    (counts, membership) => {\n      counts[membership.role] += 1;\n      return counts;\n    },\n    { ADMIN: 0, TEACHER: 0, STUDENT: 0 } satisfies Record<SchoolMembershipRole, number>\n  );\n\n  return {\n    school: {\n      id: school.id,\n      name: school.name,\n      subdomain: school.subdomain,\n      counts: {\n        classes: school._count.classes,\n        members: school._count.memberships,\n        pendingInvites: school._count.invites,\n        ...roleCounts,\n      },\n      recentClasses: school.classes,\n      recentInvites: school.invites,\n    },\n  };\n}\n\nexport async function listClasses(userId: string, schoolId: string) {\n  await requireSchoolAdmin(schoolId, userId);\n  return { classes: await listSchoolClasses(schoolId) };\n}\n\nexport async function createSchoolClass(\n  userId: string,\n  input: {\n    schoolId: string;\n    name: string;\n    section: string;\n    subject: string;\n    color?: string;\n    teachers?: string[];\n    students?: string[];\n  }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  const createdClass = await prisma.class.create({\n    data: {\n      name: input.name,\n      section: input.section,\n      subject: input.subject,\n      color: input.color,\n      schoolId: input.schoolId,\n      teachers: input.teachers?.length\n        ? { connect: input.teachers.map((id) => ({ id })) }\n        : undefined,\n      students: input.students?.length\n        ? { connect: input.students.map((id) => ({ id })) }\n        : undefined,\n    },\n    include: { teachers: true, students: true },\n  });\n\n  return { class: createdClass };\n}\n\nexport async function listMembers(userId: string, schoolId: string) {\n  await requireSchoolAdmin(schoolId, userId);\n  return { members: await listSchoolMembers(schoolId) };\n}\n\nexport async function addMember(\n  userId: string,\n  input: { schoolId: string; memberUserId: string; role: SchoolMembershipRole }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  const membership = await upsertSchoolMembership({\n    schoolId: input.schoolId,\n    userId: input.memberUserId,\n    role: input.role,\n  });\n  return { membership };\n}\n\nexport async function updateMemberRole(\n  userId: string,\n  input: { schoolId: string; memberUserId: string; role: SchoolMembershipRole }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  const current = await findSchoolMembership(input.schoolId, input.memberUserId);\n  if (!current) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"Member not found\" });\n  }\n\n  if (current.role === \"ADMIN\" && input.role !== \"ADMIN\") {\n    const adminCount = await countActiveAdmins(input.schoolId);\n    if (adminCount <= 1) {\n      throw new TRPCError({\n        code: \"BAD_REQUEST\",\n        message: \"A school must have at least one active admin\",\n      });\n    }\n  }\n\n  const membership = await updateSchoolMembershipRole(\n    input.schoolId,\n    input.memberUserId,\n    input.role\n  );\n  return { membership };\n}\n\nexport async function removeMember(\n  userId: string,\n  input: { schoolId: string; memberUserId: string }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  const current = await findSchoolMembership(input.schoolId, input.memberUserId);\n  if (!current) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"Member not found\" });\n  }\n\n  if (current.role === \"ADMIN\" && current.status === \"ACTIVE\") {\n    const adminCount = await countActiveAdmins(input.schoolId);\n    if (adminCount <= 1) {\n      throw new TRPCError({\n        code: \"BAD_REQUEST\",\n        message: \"A school must have at least one active admin\",\n      });\n    }\n  }\n\n  await removeSchoolMembershipPreservingContent(input.schoolId, input.memberUserId);\n  return { success: true };\n}\n\nexport async function listInvites(userId: string, schoolId: string) {\n  await requireSchoolAdmin(schoolId, userId);\n  return { invites: await listSchoolInvites(schoolId) };\n}\n\nexport async function createInvite(\n  userId: string,\n  input: {\n    schoolId: string;\n    email: string;\n    role: SchoolMembershipRole;\n    username?: string;\n    displayName?: string;\n  }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n\n  const existingUser = await findUserByEmail(input.email);\n\n  let createdUser: { id: string; username: string } | null = null;\n  let passwordResetToken: string | null = null;\n\n  if (!existingUser) {\n    let username: string;\n    if (input.username) {\n      const taken = await findUserByUsername(input.username);\n      if (taken) {\n        throw new TRPCError({\n          code: \"CONFLICT\",\n          message: \"Username already taken\",\n        });\n      }\n      username = input.username;\n    } else {\n      username = await generateUniqueUsername(async (candidate) => {\n        const existing = await findUserByUsername(candidate);\n        return Boolean(existing);\n      });\n    }\n\n    const placeholderPassword = await hash(uuidv4(), 10);\n    const user = await createUser({\n      username,\n      email: input.email,\n      password: placeholderPassword,\n      verified: true,\n    });\n    createdUser = { id: user.id, username: user.username };\n\n    if (input.displayName) {\n      await upsertUserProfile(user.id, { displayName: input.displayName });\n    }\n\n    const resetSession = await createSession({\n      id: uuidv4(),\n      type: SessionType.PASSWORD_RESET,\n      userId: user.id,\n      expiresAt: new Date(Date.now() + 1000 * 60 * 60 * 24 * 14),\n    });\n    passwordResetToken = resetSession.id;\n  }\n\n  const token = uuidv4();\n  const invite = await createSchoolInvite({\n    schoolId: input.schoolId,\n    invitedById: userId,\n    email: input.email,\n    role: input.role,\n    token,\n    expiresAt: new Date(Date.now() + 1000 * 60 * 60 * 24 * 14),\n  });\n\n  if (createdUser) {\n    await acceptSchoolInvite(invite.id, createdUser.id);\n  }\n\n  const inviteUrl = `${env.NEXT_PUBLIC_APP_URL}/school/invite/${token}`;\n  const passwordResetUrl = passwordResetToken\n    ? `${env.NEXT_PUBLIC_APP_URL}/reset-password/${passwordResetToken}`\n    : null;\n\n  const emailLines = [\n    `You've been invited to ${invite.school.name} on Studious.`,\n    \"\",\n  ];\n  if (createdUser && passwordResetUrl) {\n    emailLines.push(\n      `We created an account for you with the username \"${createdUser.username}\" and added you to ${invite.school.name}.`,\n      `Set your password to get started: ${passwordResetUrl}`\n    );\n  } else {\n    emailLines.push(`Click the link to confirm: ${inviteUrl}`);\n  }\n\n  try {\n    await sendMail({\n      from: \"hello@studious.sh\",\n      to: input.email,\n      subject: `Join ${invite.school.name} on Studious`,\n      text: emailLines.join(\"\\n\"),\n    });\n  } catch (err) {\n    logger.error(\"Failed to send school invite email\", {\n      schoolId: input.schoolId,\n      email: input.email,\n      err,\n    });\n  }\n\n  return { invite, createdUser };\n}\n\nexport async function revokeInvite(\n  userId: string,\n  input: { schoolId: string; inviteId: string }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n  return { invite: await revokeSchoolInvite(input.inviteId, input.schoolId) };\n}\n\nexport async function getInvite(token: string) {\n  const invite = await findPendingInviteByToken(token);\n  if (!invite || invite.status !== \"PENDING\") {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"Invite not found\" });\n  }\n  if (invite.expiresAt < new Date()) {\n    throw new TRPCError({ code: \"UNAUTHORIZED\", message: \"Invite expired\" });\n  }\n  return {\n    invite: {\n      id: invite.id,\n      email: invite.email,\n      role: invite.role,\n      school: invite.school,\n      expiresAt: invite.expiresAt,\n    },\n  };\n}\n\nexport async function acceptInvite(userId: string, token: string) {\n  const invite = await findPendingInviteByToken(token);\n  if (!invite || invite.status !== \"PENDING\") {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"Invite not found\" });\n  }\n  if (invite.expiresAt < new Date()) {\n    throw new TRPCError({ code: \"UNAUTHORIZED\", message: \"Invite expired\" });\n  }\n\n  const user = await findUserById(userId);\n  if (!user) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"User not found\" });\n  }\n  if (user.email.toLowerCase() !== invite.email.toLowerCase()) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"This invite was sent to a different account\",\n    });\n  }\n\n  const membership = await acceptSchoolInvite(invite.id, userId);\n  return { membership };\n}\n"],"names":[],"mappings":"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","debug_id":"eab19eca-0947-5015-a1af-d1dcf6c40a4d"}

package/dist/services/worksheet.d.ts

@@ -24,11 +24,14 @@ export declare function getWorksheet(worksheetId: string, userId: string): Promi
         answer: string;
     }[];
 } & {
+    status: import(".prisma/client").$Enums.JobStatus | null;
     name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
     classId: string;
+    runJobId: string | null;
+    sourceUrl: string | null;
 }>;
 /** Check if worksheet exists. */
 export declare function worksheetExists(id: string): Promise<boolean>;
@@ -37,66 +40,96 @@ export declare function listWorksheets(classId: string): Promise<{
     questions: {
         id: string;
     }[];
+    status: import(".prisma/client").$Enums.JobStatus | null;
     name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
     classId: string;
+    runJobId: string | null;
+    sourceUrl: string | null;
 }[]>;
 export declare function updateWorksheetRecord(worksheetId: string, userId: string, data: {
     name?: string;
 }): Promise<{
+    status: import(".prisma/client").$Enums.JobStatus | null;
     name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
     classId: string;
+    runJobId: string | null;
+    sourceUrl: string | null;
 }>;
 export declare function deleteWorksheetRecord(worksheetId: string, userId: string): Promise<{
+    status: import(".prisma/client").$Enums.JobStatus | null;
     name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
     classId: string;
+    runJobId: string | null;
+    sourceUrl: string | null;
 }>;
 export declare function createWorksheetRecord(classId: string, name: string): Promise<{
+    status: import(".prisma/client").$Enums.JobStatus | null;
     name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
     classId: string;
+    runJobId: string | null;
+    sourceUrl: string | null;
 }>;
 /**
  * Duplicate a worksheet into another class. Caller must teach both the source worksheet's class
  * and the target class.
  */
 export declare function duplicateWorksheetRecord(worksheetId: string, classId: string, name: string, userId: string): Promise<{
+    status: import(".prisma/client").$Enums.JobStatus | null;
     name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
     classId: string;
+    runJobId: string | null;
+    sourceUrl: string | null;
 }>;
 /**
- * Create a worksheet by converting a PDF (URL) into structured questions.
- * Uses the `pdfToWorksheet` pipeline to do inference + persistence.
+ * Kick off PDF-to-worksheet conversion asynchronously.
+ *
+ * We synchronously create a placeholder Worksheet row (status PENDING) so the
+ * caller has an id to navigate to immediately, then enqueue a BullMQ job that
+ * fills in the real title and questions. Progress is broadcast on the
+ * per-worksheet job Pusher channel; clients should subscribe there to drive
+ * loading UI.
  */
-export declare function createWorksheetFromPdf(classId: string, url: string): Promise<{
+export declare function createWorksheetFromPdf(classId: string, url: string, userId?: string, options?: {
+    name?: string;
+}): Promise<{
+    runJobId: string;
+    status: import(".prisma/client").$Enums.JobStatus | null;
     name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
     classId: string;
+    sourceUrl: string | null;
 }>;
 /**
  * Create a worksheet from a PDF that was uploaded through the direct-upload flow.
  */
-export declare function createWorksheetFromUploadedPdf(classId: string, fileId: string, userId: string): Promise<{
+export declare function createWorksheetFromUploadedPdf(classId: string, fileId: string, userId: string, options?: {
+    name?: string;
+}): Promise<{
+    runJobId: string;
+    status: import(".prisma/client").$Enums.JobStatus | null;
     name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
     classId: string;
+    sourceUrl: string | null;
 }>;
 export declare function addQuestionToWorksheet(worksheetId: string, userId: string, data: {
     question: string;
@@ -160,7 +193,7 @@ export declare function getWorksheetSubmission(worksheetId: string, submissionId
             id: string;
         }[];
     } & {
-        status: import(".prisma/client").$Enums.GenerationStatus | null;
+        status: import(".prisma/client").$Enums.JobStatus | null;
         id: string;
         createdAt: Date;
         updatedAt: Date | null;
@@ -172,6 +205,7 @@ export declare function getWorksheetSubmission(worksheetId: string, submissionId
         points: number;
         feedback: string | null;
         studentWorksheetResponseId: string | null;
+        runJobId: string | null;
     })[];
 } & {
     id: string;
@@ -185,7 +219,7 @@ export declare function getWorksheetSubmission(worksheetId: string, submissionId
 }>;
 export declare function answerWorksheetQuestion(worksheetResponseId: string, questionId: string, response: string, userId: string): Promise<{
     responses: {
-        status: import(".prisma/client").$Enums.GenerationStatus | null;
+        status: import(".prisma/client").$Enums.JobStatus | null;
         id: string;
         createdAt: Date;
         updatedAt: Date | null;
@@ -197,6 +231,7 @@ export declare function answerWorksheetQuestion(worksheetResponseId: string, que
         points: number;
         feedback: string | null;
         studentWorksheetResponseId: string | null;
+        runJobId: string | null;
     }[];
 } & {
     id: string;
@@ -209,7 +244,7 @@ export declare function answerWorksheetQuestion(worksheetResponseId: string, que
     worksheetId: string;
 }>;
 export declare function cancelGrading(worksheetResponseId: string, progressId: string, userId: string): Promise<{
-    status: import(".prisma/client").$Enums.GenerationStatus | null;
+    status: import(".prisma/client").$Enums.JobStatus | null;
     id: string;
     createdAt: Date;
     updatedAt: Date | null;
@@ -221,9 +256,10 @@ export declare function cancelGrading(worksheetResponseId: string, progressId: s
     points: number;
     feedback: string | null;
     studentWorksheetResponseId: string | null;
+    runJobId: string | null;
 }>;
 export declare function regradeQuestion(worksheetResponseId: string, progressId: string, userId: string): Promise<{
-    status: import(".prisma/client").$Enums.GenerationStatus | null;
+    status: import(".prisma/client").$Enums.JobStatus | null;
     id: string;
     createdAt: Date;
     updatedAt: Date | null;
@@ -235,7 +271,8 @@ export declare function regradeQuestion(worksheetResponseId: string, progressId:
     points: number;
     feedback: string | null;
     studentWorksheetResponseId: string | null;
-}>;
+    runJobId: string | null;
+} | null>;
 export declare function gradeAnswer(questionId: string, studentWorksheetResponseId: string, userId: string, data: {
     responseId?: string;
     response?: string;
@@ -244,7 +281,7 @@ export declare function gradeAnswer(questionId: string, studentWorksheetResponse
     markschemeState?: object;
     points?: number;
 }): Promise<{
-    status: import(".prisma/client").$Enums.GenerationStatus | null;
+    status: import(".prisma/client").$Enums.JobStatus | null;
     id: string;
     createdAt: Date;
     updatedAt: Date | null;
@@ -256,9 +293,9 @@ export declare function gradeAnswer(questionId: string, studentWorksheetResponse
     points: number;
     feedback: string | null;
     studentWorksheetResponseId: string | null;
+    runJobId: string | null;
 }>;
 export declare function addCommentToResponse(responseId: string, comment: string, authorId: string): Promise<{
-    status: import(".prisma/client").$Enums.GenerationStatus | null;
     id: string;
     createdAt: Date;
     assignmentId: string | null;

package/dist/services/worksheet.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worksheet.d.ts","sourceRoot":"/","sources":["services/worksheet.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"worksheet.d.ts","sourceRoot":"/","sources":["services/worksheet.ts"],"names":[],"mappings":"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"}

package/dist/services/worksheet.js

@@ -3,13 +3,14 @@
  * Integrates with gradeWorksheet pipeline for auto-grading.
  */
 
-!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]="d15dc113-0231-5e3c-b956-9b5c549c4073")}catch(e){}}();
+!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]="d5088046-353b-5b26-b9c3-10f78d48d45e")}catch(e){}}();
 import { TRPCError } from "@trpc/server";
-import { GenerationStatus } from "@prisma/client";
+import { JobStatus } from "@prisma/client";
 import { prisma } from "../lib/prisma.js";
 import { getFileUrl } from "../lib/fileUpload.js";
 import { cancelGradePipeline, regradeWorksheetPipeline } from "../pipelines/gradeWorksheet.js";
-import { pdfToWorksheet } from "../pipelines/pdfToWorksheet.js";
+import { enqueueRunJob } from "../workers/queues.js";
+import { logger } from "../utils/logger.js";
 import { findWorksheetByIdMinimal, findWorksheetByIdForClassMember, findWorksheetByIdForTeacher, findWorksheetsByClassId, createWorksheet, duplicateWorksheet, updateWorksheet, deleteWorksheet, findQuestionsByWorksheetId, createWorksheetQuestion, updateWorksheetQuestion, deleteWorksheetQuestion, findSubmissionByIdForWorksheetAccess, findOrCreateWorksheetResponse, findWorksheetResponseByIdForTeacher, findWorksheetResponseWithResponsesForStudent, findWorksheetQuestionByIdForTeacher, findWorksheetQuestionByIdInWorksheet, updateStudentQuestionProgress, createStudentQuestionProgress, findStudentQuestionProgress, updateStudentQuestionProgressForGrading, createStudentQuestionProgressForGrading, createComment, findStudentQuestionProgressByIdForTeacher, findStudentQuestionProgressByIdForTeacherAndResponse, } from "../models/worksheet.js";
 const sanitizeQuestionOptionsForStudent = (options) => {
     if (!Array.isArray(options))
@@ -115,23 +116,65 @@ export async function duplicateWorksheetRecord(worksheetId, classId, name, userI
     return created;
 }
 /**
- * Create a worksheet by converting a PDF (URL) into structured questions.
- * Uses the `pdfToWorksheet` pipeline to do inference + persistence.
+ * Kick off PDF-to-worksheet conversion asynchronously.
+ *
+ * We synchronously create a placeholder Worksheet row (status PENDING) so the
+ * caller has an id to navigate to immediately, then enqueue a BullMQ job that
+ * fills in the real title and questions. Progress is broadcast on the
+ * per-worksheet job Pusher channel; clients should subscribe there to drive
+ * loading UI.
  */
-export async function createWorksheetFromPdf(classId, url) {
-    const created = await pdfToWorksheet(url, classId);
-    if (!created) {
+export async function createWorksheetFromPdf(classId, url, userId, options = {}) {
+    const placeholder = await prisma.worksheet.create({
+        data: {
+            classId,
+            name: options.name?.trim() || "Converting PDF…",
+            status: JobStatus.PENDING,
+        },
+    });
+    try {
+        const { runJobId } = await enqueueRunJob("PDF_TO_WORKSHEET", { gcsUrl: url, classId, worksheetId: placeholder.id }, { classId, userId: userId ?? null });
+        await prisma.worksheet
+            .update({
+            where: { id: placeholder.id },
+            data: { runJobId },
+        })
+            .catch((linkError) => {
+            logger.error("createWorksheetFromPdf: failed to link RunJob to Worksheet", {
+                worksheetId: placeholder.id,
+                runJobId,
+                error: linkError instanceof Error
+                    ? linkError.message
+                    : String(linkError),
+            });
+        });
+        return {
+            ...placeholder,
+            runJobId,
+        };
+    }
+    catch (error) {
+        await prisma.worksheet
+            .update({
+            where: { id: placeholder.id },
+            data: { status: JobStatus.FAILED },
+        })
+            .catch(() => undefined);
+        logger.error("createWorksheetFromPdf: failed to enqueue conversion", {
+            worksheetId: placeholder.id,
+            classId,
+            error: error instanceof Error ? error.message : String(error),
+        });
         throw new TRPCError({
             code: "INTERNAL_SERVER_ERROR",
-            message: "Failed to create worksheet from PDF",
+            message: "Failed to start worksheet conversion",
         });
     }
-    return created;
 }
 /**
  * Create a worksheet from a PDF that was uploaded through the direct-upload flow.
  */
-export async function createWorksheetFromUploadedPdf(classId, fileId, userId) {
+export async function createWorksheetFromUploadedPdf(classId, fileId, userId, options = {}) {
     const file = await prisma.file.findFirst({
         where: {
             id: fileId,
@@ -142,6 +185,7 @@ export async function createWorksheetFromUploadedPdf(classId, fileId, userId) {
             id: true,
             path: true,
             type: true,
+            name: true,
         },
     });
     if (!file) {
@@ -158,7 +202,9 @@ export async function createWorksheetFromUploadedPdf(classId, fileId, userId) {
         });
     }
     const signedUrl = await getFileUrl(file.path);
-    return createWorksheetFromPdf(classId, signedUrl);
+    return createWorksheetFromPdf(classId, signedUrl, userId, {
+        name: options.name ?? file.name ?? undefined,
+    });
 }
 export async function addQuestionToWorksheet(worksheetId, userId, data) {
     const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);
@@ -196,22 +242,20 @@ export async function reorderWorksheetQuestions(worksheetId, userId, movedId, po
             message: "Target question not found",
         });
     }
+    if (movedId === targetId) {
+        throw new TRPCError({
+            code: "BAD_REQUEST",
+            message: "Moved question and target question must be different",
+        });
+    }
     const withoutMoved = questions.filter((q) => q.id !== movedId);
-    const next = position === "before"
-        ? [
-            ...withoutMoved.slice(0, targetIdx).map((item) => ({ id: item.id })),
-            { id: movedId },
-            ...withoutMoved.slice(targetIdx).map((item) => ({ id: item.id })),
-        ]
-        : [
-            ...withoutMoved
-                .slice(0, targetIdx + 1)
-                .map((item) => ({ id: item.id })),
-            { id: movedId },
-            ...withoutMoved
-                .slice(targetIdx + 1)
-                .map((item) => ({ id: item.id })),
-        ];
+    const targetIdxWithoutMoved = withoutMoved.findIndex((q) => q.id === targetId);
+    const insertIdx = position === "before" ? targetIdxWithoutMoved : targetIdxWithoutMoved + 1;
+    const next = [
+        ...withoutMoved.slice(0, insertIdx).map((item) => ({ id: item.id })),
+        { id: movedId },
+        ...withoutMoved.slice(insertIdx).map((item) => ({ id: item.id })),
+    ];
     await prisma.$transaction(next.map((item, index) => prisma.worksheetQuestion.update({
         where: { id: item.id },
         data: { order: index },
@@ -287,7 +331,7 @@ export async function answerWorksheetQuestion(worksheetResponseId, questionId, r
             ...(isMarkableByAlgo && {
                 points: response === correctAnswer ? marksAwardedIfCorrect : 0,
             }),
-            status: GenerationStatus.NOT_STARTED,
+            status: JobStatus.NOT_STARTED,
         });
     }
     else {
@@ -398,4 +442,4 @@ export async function addCommentToResponse(responseId, comment, authorId) {
     });
 }
 //# sourceMappingURL=worksheet.js.map
-//# debugId=d15dc113-0231-5e3c-b956-9b5c549c4073
+//# debugId=d5088046-353b-5b26-b9c3-10f78d48d45e

package/dist/services/worksheet.js.map

@@ -1 +1 @@
-{"version":3,"file":"worksheet.js","sources":["services/worksheet.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Worksheet service – CRUD for worksheets, questions, submissions, and AI grading.\n * Integrates with gradeWorksheet pipeline for auto-grading.\n */\nimport { TRPCError } from \"@trpc/server\";\nimport { GenerationStatus, type WorksheetQuestionType } from \"@prisma/client\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { getFileUrl } from \"../lib/fileUpload.js\";\nimport { cancelGradePipeline, regradeWorksheetPipeline } from \"../pipelines/gradeWorksheet.js\";\nimport { pdfToWorksheet } from \"../pipelines/pdfToWorksheet.js\";\nimport {\n  findWorksheetByIdMinimal,\n  findWorksheetByIdForClassMember,\n  findWorksheetByIdForTeacher,\n  findWorksheetsByClassId,\n  createWorksheet,\n  duplicateWorksheet,\n  updateWorksheet,\n  deleteWorksheet,\n  findQuestionsByWorksheetId,\n  createWorksheetQuestion,\n  updateWorksheetQuestion,\n  deleteWorksheetQuestion,\n  findSubmissionByIdForWorksheetAccess,\n  findOrCreateWorksheetResponse,\n  findWorksheetResponseByIdForTeacher,\n  findWorksheetResponseWithResponsesForStudent,\n  findWorksheetQuestionByIdForTeacher,\n  findWorksheetQuestionByIdInWorksheet,\n  updateStudentQuestionProgress,\n  createStudentQuestionProgress,\n  findStudentQuestionProgress,\n  updateStudentQuestionProgressForGrading,\n  createStudentQuestionProgressForGrading,\n  createComment,\n  findStudentQuestionProgressByIdForTeacher,\n  findStudentQuestionProgressByIdForTeacherAndResponse,\n} from \"../models/worksheet.js\";\n\ntype MCQOptions = { id: string; text: string; isCorrect: boolean }[];\n\nconst sanitizeQuestionOptionsForStudent = (options: unknown) => {\n  if (!Array.isArray(options)) return options;\n\n  return options.map((option) => {\n    if (!option || typeof option !== \"object\") return option;\n\n    const { isCorrect: _isCorrect, ...rest } = option as Record<string, unknown>;\n    return rest;\n  });\n};\n\nconst sanitizeWorksheetForStudent = <T extends {\n  questions: Array<Record<string, unknown>>;\n}>(worksheet: T) => ({\n  ...worksheet,\n  questions: worksheet.questions.map((question) => ({\n    ...question,\n    answer: \"\",\n    markScheme: null,\n    options: sanitizeQuestionOptionsForStudent(question.options),\n  })),\n});\n\n/** Get worksheet with questions and mark schemes. */\nexport async function getWorksheet(worksheetId: string, userId: string) {\n  const teacherWorksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (teacherWorksheet) {\n    return teacherWorksheet;\n  }\n\n  const studentWorksheet = await findWorksheetByIdForClassMember(worksheetId, userId);\n  if (!studentWorksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet\",\n    });\n  }\n\n  return sanitizeWorksheetForStudent(studentWorksheet);\n}\n\n/** Check if worksheet exists. */\nexport async function worksheetExists(id: string) {\n  const worksheet = await findWorksheetByIdMinimal(id);\n  return !!worksheet;\n}\n\nexport async function listWorksheets(classId: string) {\n  const worksheets = await findWorksheetsByClassId(classId);\n  return worksheets.map((w) => ({\n    ...w,\n    questionCount: w.questions.length,\n  }));\n}\n\nexport async function updateWorksheetRecord(\n  worksheetId: string,\n  userId: string,\n  data: { name?: string }\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can update worksheets\",\n    });\n  }\n  return updateWorksheet(worksheetId, data);\n}\n\nexport async function deleteWorksheetRecord(worksheetId: string, userId: string) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can delete worksheets\",\n    });\n  }\n  return deleteWorksheet(worksheetId);\n}\n\nexport async function createWorksheetRecord(classId: string, name: string) {\n  return createWorksheet({ classId, name });\n}\n\n/**\n * Duplicate a worksheet into another class. Caller must teach both the source worksheet's class\n * and the target class.\n */\nexport async function duplicateWorksheetRecord(\n  worksheetId: string,\n  classId: string,\n  name: string,\n  userId: string\n) {\n  const source = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!source) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message:\n        \"Worksheet not found or you are not a teacher of the class it belongs to\",\n    });\n  }\n\n  const targetOk = await prisma.class.findFirst({\n    where: {\n      id: classId,\n      teachers: { some: { id: userId } },\n    },\n    select: { id: true },\n  });\n\n  if (!targetOk) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You are not a teacher of the target class\",\n    });\n  }\n\n  const created = await duplicateWorksheet(worksheetId, classId, name);\n  if (!created) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet not found\",\n    });\n  }\n\n  return created;\n}\n\n/**\n * Create a worksheet by converting a PDF (URL) into structured questions.\n * Uses the `pdfToWorksheet` pipeline to do inference + persistence.\n */\nexport async function createWorksheetFromPdf(\n  classId: string,\n  url: string\n) {\n  const created = await pdfToWorksheet(url, classId);\n  if (!created) {\n    throw new TRPCError({\n      code: \"INTERNAL_SERVER_ERROR\",\n      message: \"Failed to create worksheet from PDF\",\n    });\n  }\n  return created;\n}\n\n/**\n * Create a worksheet from a PDF that was uploaded through the direct-upload flow.\n */\nexport async function createWorksheetFromUploadedPdf(\n  classId: string,\n  fileId: string,\n  userId: string\n) {\n  const file = await prisma.file.findFirst({\n    where: {\n      id: fileId,\n      userId,\n      uploadStatus: \"COMPLETED\",\n    },\n    select: {\n      id: true,\n      path: true,\n      type: true,\n    },\n  });\n\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Uploaded file not found or not ready\",\n    });\n  }\n\n  const isPdf =\n    file.type === \"application/pdf\" || file.path.toLowerCase().endsWith(\".pdf\");\n  if (!isPdf) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Only PDF files can be converted into worksheets\",\n    });\n  }\n\n  const signedUrl = await getFileUrl(file.path);\n  return createWorksheetFromPdf(classId, signedUrl);\n}\n\nexport async function addQuestionToWorksheet(\n  worksheetId: string,\n  userId: string,\n  data: {\n    question: string;\n    answer: string;\n    points?: number;\n    options?: object;\n    markScheme?: object;\n    type: WorksheetQuestionType;\n  }\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can modify worksheet questions\",\n    });\n  }\n  return createWorksheetQuestion({\n    worksheetId,\n    ...data,\n  });\n}\n\nexport async function reorderWorksheetQuestions(\n  worksheetId: string,\n  userId: string,\n  movedId: string,\n  position: \"before\" | \"after\",\n  targetId: string\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can reorder worksheet questions\",\n    });\n  }\n\n  const questions = await findQuestionsByWorksheetId(worksheetId);\n  const movedIdx = questions.findIndex((q) => q.id === movedId);\n  if (movedIdx === -1) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Moved question not found\",\n    });\n  }\n  const targetIdx = questions.findIndex((q) => q.id === targetId);\n  if (targetIdx === -1) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Target question not found\",\n    });\n  }\n\n  const withoutMoved = questions.filter((q) => q.id !== movedId);\n  const next =\n    position === \"before\"\n      ? [\n          ...withoutMoved.slice(0, targetIdx).map((item) => ({ id: item.id })),\n          { id: movedId },\n          ...withoutMoved.slice(targetIdx).map((item) => ({ id: item.id })),\n        ]\n      : [\n          ...withoutMoved\n            .slice(0, targetIdx + 1)\n            .map((item) => ({ id: item.id })),\n          { id: movedId },\n          ...withoutMoved\n            .slice(targetIdx + 1)\n            .map((item) => ({ id: item.id })),\n        ];\n\n  await prisma.$transaction(\n    next.map((item, index) =>\n      prisma.worksheetQuestion.update({\n        where: { id: item.id },\n        data: { order: index },\n      })\n    )\n  );\n  return next;\n}\n\nexport async function updateWorksheetQuestionRecord(\n  worksheetId: string,\n  questionId: string,\n  userId: string,\n  data: {\n    question?: string;\n    answer?: string;\n    points?: number;\n    options?: object;\n    markScheme?: object;\n    type?: WorksheetQuestionType;\n  }\n) {\n  const question = await findWorksheetQuestionByIdForTeacher(questionId, userId);\n  if (!question || question.worksheetId !== worksheetId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can update worksheet questions\",\n    });\n  }\n  return updateWorksheetQuestion(questionId, data);\n}\n\nexport async function deleteWorksheetQuestionRecord(\n  worksheetId: string,\n  questionId: string,\n  userId: string\n) {\n  const question = await findWorksheetQuestionByIdForTeacher(questionId, userId);\n  if (!question || question.worksheetId !== worksheetId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can delete worksheet questions\",\n    });\n  }\n  return deleteWorksheetQuestion(questionId);\n}\n\nexport async function getWorksheetSubmission(\n  worksheetId: string,\n  submissionId: string,\n  userId: string\n) {\n  const worksheet = await findWorksheetByIdForClassMember(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet\",\n    });\n  }\n\n  const submission = await findSubmissionByIdForWorksheetAccess(\n    submissionId,\n    worksheetId,\n    worksheet.classId,\n    userId\n  );\n  if (!submission) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet submission\",\n    });\n  }\n  return findOrCreateWorksheetResponse(\n    submissionId,\n    worksheetId,\n    submission.studentId\n  );\n}\n\nexport async function answerWorksheetQuestion(\n  worksheetResponseId: string,\n  questionId: string,\n  response: string,\n  userId: string\n) {\n  const worksheetResponse = await findWorksheetResponseWithResponsesForStudent(\n    worksheetResponseId,\n    userId,\n    questionId\n  );\n  if (!worksheetResponse) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You can only answer your own worksheet responses\",\n    });\n  }\n\n  const question = await findWorksheetQuestionByIdInWorksheet(\n    questionId,\n    worksheetResponse.worksheetId\n  );\n  if (!question) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet question not found\",\n    });\n  }\n\n  const isMarkableByAlgo =\n    question.type === \"MULTIPLE_CHOICE\" || question.type === \"TRUE_FALSE\";\n  const marksAwardedIfCorrect = question.points || 0;\n  const correctAnswer = isMarkableByAlgo\n    ? question.type === \"MULTIPLE_CHOICE\"\n      ? (question.options as MCQOptions)?.find((o) => o.isCorrect)?.id\n      : question.answer?.toString()\n    : null;\n\n  const existingResponse = worksheetResponse.responses[0];\n\n  if (existingResponse) {\n    await updateStudentQuestionProgress(existingResponse.id, {\n      response,\n      ...(isMarkableByAlgo && {\n        isCorrect: response === correctAnswer,\n      }),\n      ...(isMarkableByAlgo && {\n        points: response === correctAnswer ? marksAwardedIfCorrect : 0,\n      }),\n      status: GenerationStatus.NOT_STARTED,\n    });\n  } else {\n    await createStudentQuestionProgress({\n      studentId: worksheetResponse.studentId,\n      questionId,\n      response,\n      studentWorksheetResponseId: worksheetResponseId,\n      ...(isMarkableByAlgo && {\n        isCorrect: response === correctAnswer,\n      }),\n      ...(isMarkableByAlgo && {\n        points: response === correctAnswer ? marksAwardedIfCorrect : 0,\n      }),\n    });\n  }\n\n  const updated = await prisma.studentWorksheetResponse.findUnique({\n    where: { id: worksheetResponseId },\n    include: { responses: true },\n  });\n  return updated!;\n}\n\nexport async function cancelGrading(\n  worksheetResponseId: string,\n  progressId: string,\n  userId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacherAndResponse(\n    progressId,\n    worksheetResponseId,\n    userId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can cancel worksheet grading\",\n    });\n  }\n  return cancelGradePipeline(worksheetResponseId, progressId);\n}\n\nexport async function regradeQuestion(\n  worksheetResponseId: string,\n  progressId: string,\n  userId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacherAndResponse(\n    progressId,\n    worksheetResponseId,\n    userId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can regrade worksheet answers\",\n    });\n  }\n  return regradeWorksheetPipeline(worksheetResponseId, progressId);\n}\n\nexport async function gradeAnswer(\n  questionId: string,\n  studentWorksheetResponseId: string,\n  userId: string,\n  data: {\n    responseId?: string;\n    response?: string;\n    isCorrect: boolean;\n    feedback?: string;\n    markschemeState?: object;\n    points?: number;\n  }\n) {\n  const worksheetResponse = await findWorksheetResponseByIdForTeacher(\n    studentWorksheetResponseId,\n    userId\n  );\n  if (!worksheetResponse) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can grade worksheet answers\",\n    });\n  }\n\n  const question = await findWorksheetQuestionByIdInWorksheet(\n    questionId,\n    worksheetResponse.worksheetId\n  );\n  if (!question) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet question not found\",\n    });\n  }\n\n  if (data.responseId) {\n    const existingProgress = await findStudentQuestionProgressByIdForTeacher(\n      data.responseId,\n      userId\n    );\n    if (\n      !existingProgress ||\n      existingProgress.studentWorksheetResponseId !== studentWorksheetResponseId ||\n      existingProgress.questionId !== questionId\n    ) {\n      throw new TRPCError({\n        code: \"FORBIDDEN\",\n        message: \"Only class teachers can grade worksheet answers\",\n      });\n    }\n\n    return updateStudentQuestionProgressForGrading(data.responseId, {\n      isCorrect: data.isCorrect,\n      feedback: data.feedback,\n      markschemeState: data.markschemeState,\n      points: data.points,\n    });\n  }\n\n  const existing = await findStudentQuestionProgress(\n    worksheetResponse.studentId,\n    questionId,\n    studentWorksheetResponseId\n  );\n\n  if (existing) {\n    return updateStudentQuestionProgressForGrading(existing.id, {\n      isCorrect: data.isCorrect,\n      response: data.response,\n      feedback: data.feedback,\n      markschemeState: data.markschemeState,\n      points: data.points,\n    });\n  }\n\n  return createStudentQuestionProgressForGrading({\n    studentId: worksheetResponse.studentId,\n    questionId,\n    studentWorksheetResponseId,\n    response: data.response || \"\",\n    isCorrect: data.isCorrect,\n    feedback: data.feedback,\n    markschemeState: data.markschemeState,\n    points: data.points || 0,\n  });\n}\n\nexport async function addCommentToResponse(\n  responseId: string,\n  comment: string,\n  authorId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacher(\n    responseId,\n    authorId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can comment on worksheet responses\",\n    });\n  }\n\n  return createComment({\n    studentQuestionProgressId: responseId,\n    content: comment,\n    authorId,\n  });\n}\n"],"names":[],"mappings":"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","debug_id":"d15dc113-0231-5e3c-b956-9b5c549c4073"}
+{"version":3,"file":"worksheet.js","sources":["services/worksheet.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Worksheet service – CRUD for worksheets, questions, submissions, and AI grading.\n * Integrates with gradeWorksheet pipeline for auto-grading.\n */\nimport { TRPCError } from \"@trpc/server\";\nimport { JobStatus, type WorksheetQuestionType } from \"@prisma/client\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { getFileUrl } from \"../lib/fileUpload.js\";\nimport { cancelGradePipeline, regradeWorksheetPipeline } from \"../pipelines/gradeWorksheet.js\";\nimport { enqueueRunJob } from \"../workers/queues.js\";\nimport { logger } from \"../utils/logger.js\";\nimport {\n  findWorksheetByIdMinimal,\n  findWorksheetByIdForClassMember,\n  findWorksheetByIdForTeacher,\n  findWorksheetsByClassId,\n  createWorksheet,\n  duplicateWorksheet,\n  updateWorksheet,\n  deleteWorksheet,\n  findQuestionsByWorksheetId,\n  createWorksheetQuestion,\n  updateWorksheetQuestion,\n  deleteWorksheetQuestion,\n  findSubmissionByIdForWorksheetAccess,\n  findOrCreateWorksheetResponse,\n  findWorksheetResponseByIdForTeacher,\n  findWorksheetResponseWithResponsesForStudent,\n  findWorksheetQuestionByIdForTeacher,\n  findWorksheetQuestionByIdInWorksheet,\n  updateStudentQuestionProgress,\n  createStudentQuestionProgress,\n  findStudentQuestionProgress,\n  updateStudentQuestionProgressForGrading,\n  createStudentQuestionProgressForGrading,\n  createComment,\n  findStudentQuestionProgressByIdForTeacher,\n  findStudentQuestionProgressByIdForTeacherAndResponse,\n} from \"../models/worksheet.js\";\n\ntype MCQOptions = { id: string; text: string; isCorrect: boolean }[];\n\nconst sanitizeQuestionOptionsForStudent = (options: unknown) => {\n  if (!Array.isArray(options)) return options;\n\n  return options.map((option) => {\n    if (!option || typeof option !== \"object\") return option;\n\n    const { isCorrect: _isCorrect, ...rest } = option as Record<string, unknown>;\n    return rest;\n  });\n};\n\nconst sanitizeWorksheetForStudent = <T extends {\n  questions: Array<Record<string, unknown>>;\n}>(worksheet: T) => ({\n  ...worksheet,\n  questions: worksheet.questions.map((question) => ({\n    ...question,\n    answer: \"\",\n    markScheme: null,\n    options: sanitizeQuestionOptionsForStudent(question.options),\n  })),\n});\n\n/** Get worksheet with questions and mark schemes. */\nexport async function getWorksheet(worksheetId: string, userId: string) {\n  const teacherWorksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (teacherWorksheet) {\n    return teacherWorksheet;\n  }\n\n  const studentWorksheet = await findWorksheetByIdForClassMember(worksheetId, userId);\n  if (!studentWorksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet\",\n    });\n  }\n\n  return sanitizeWorksheetForStudent(studentWorksheet);\n}\n\n/** Check if worksheet exists. */\nexport async function worksheetExists(id: string) {\n  const worksheet = await findWorksheetByIdMinimal(id);\n  return !!worksheet;\n}\n\nexport async function listWorksheets(classId: string) {\n  const worksheets = await findWorksheetsByClassId(classId);\n  return worksheets.map((w) => ({\n    ...w,\n    questionCount: w.questions.length,\n  }));\n}\n\nexport async function updateWorksheetRecord(\n  worksheetId: string,\n  userId: string,\n  data: { name?: string }\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can update worksheets\",\n    });\n  }\n  return updateWorksheet(worksheetId, data);\n}\n\nexport async function deleteWorksheetRecord(worksheetId: string, userId: string) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can delete worksheets\",\n    });\n  }\n  return deleteWorksheet(worksheetId);\n}\n\nexport async function createWorksheetRecord(classId: string, name: string) {\n  return createWorksheet({ classId, name });\n}\n\n/**\n * Duplicate a worksheet into another class. Caller must teach both the source worksheet's class\n * and the target class.\n */\nexport async function duplicateWorksheetRecord(\n  worksheetId: string,\n  classId: string,\n  name: string,\n  userId: string\n) {\n  const source = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!source) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message:\n        \"Worksheet not found or you are not a teacher of the class it belongs to\",\n    });\n  }\n\n  const targetOk = await prisma.class.findFirst({\n    where: {\n      id: classId,\n      teachers: { some: { id: userId } },\n    },\n    select: { id: true },\n  });\n\n  if (!targetOk) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You are not a teacher of the target class\",\n    });\n  }\n\n  const created = await duplicateWorksheet(worksheetId, classId, name);\n  if (!created) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet not found\",\n    });\n  }\n\n  return created;\n}\n\n/**\n * Kick off PDF-to-worksheet conversion asynchronously.\n *\n * We synchronously create a placeholder Worksheet row (status PENDING) so the\n * caller has an id to navigate to immediately, then enqueue a BullMQ job that\n * fills in the real title and questions. Progress is broadcast on the\n * per-worksheet job Pusher channel; clients should subscribe there to drive\n * loading UI.\n */\nexport async function createWorksheetFromPdf(\n  classId: string,\n  url: string,\n  userId?: string,\n  options: { name?: string } = {},\n) {\n  const placeholder = await prisma.worksheet.create({\n    data: {\n      classId,\n      name: options.name?.trim() || \"Converting PDF…\",\n      status: JobStatus.PENDING,\n    },\n  });\n\n  try {\n    const { runJobId } = await enqueueRunJob(\n      \"PDF_TO_WORKSHEET\",\n      { gcsUrl: url, classId, worksheetId: placeholder.id },\n      { classId, userId: userId ?? null },\n    );\n\n    await prisma.worksheet\n      .update({\n        where: { id: placeholder.id },\n        data: { runJobId },\n      })\n      .catch((linkError) => {\n        logger.error(\n          \"createWorksheetFromPdf: failed to link RunJob to Worksheet\",\n          {\n            worksheetId: placeholder.id,\n            runJobId,\n            error:\n              linkError instanceof Error\n                ? linkError.message\n                : String(linkError),\n          },\n        );\n      });\n\n    return {\n      ...placeholder,\n      runJobId,\n    };\n  } catch (error) {\n    await prisma.worksheet\n      .update({\n        where: { id: placeholder.id },\n        data: { status: JobStatus.FAILED },\n      })\n      .catch(() => undefined);\n\n    logger.error(\"createWorksheetFromPdf: failed to enqueue conversion\", {\n      worksheetId: placeholder.id,\n      classId,\n      error: error instanceof Error ? error.message : String(error),\n    });\n\n    throw new TRPCError({\n      code: \"INTERNAL_SERVER_ERROR\",\n      message: \"Failed to start worksheet conversion\",\n    });\n  }\n}\n\n/**\n * Create a worksheet from a PDF that was uploaded through the direct-upload flow.\n */\nexport async function createWorksheetFromUploadedPdf(\n  classId: string,\n  fileId: string,\n  userId: string,\n  options: { name?: string } = {},\n) {\n  const file = await prisma.file.findFirst({\n    where: {\n      id: fileId,\n      userId,\n      uploadStatus: \"COMPLETED\",\n    },\n    select: {\n      id: true,\n      path: true,\n      type: true,\n      name: true,\n    },\n  });\n\n  if (!file) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Uploaded file not found or not ready\",\n    });\n  }\n\n  const isPdf =\n    file.type === \"application/pdf\" || file.path.toLowerCase().endsWith(\".pdf\");\n  if (!isPdf) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Only PDF files can be converted into worksheets\",\n    });\n  }\n\n  const signedUrl = await getFileUrl(file.path);\n  return createWorksheetFromPdf(classId, signedUrl, userId, {\n    name: options.name ?? file.name ?? undefined,\n  });\n}\n\nexport async function addQuestionToWorksheet(\n  worksheetId: string,\n  userId: string,\n  data: {\n    question: string;\n    answer: string;\n    points?: number;\n    options?: object;\n    markScheme?: object;\n    type: WorksheetQuestionType;\n  }\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can modify worksheet questions\",\n    });\n  }\n  return createWorksheetQuestion({\n    worksheetId,\n    ...data,\n  });\n}\n\nexport async function reorderWorksheetQuestions(\n  worksheetId: string,\n  userId: string,\n  movedId: string,\n  position: \"before\" | \"after\",\n  targetId: string\n) {\n  const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can reorder worksheet questions\",\n    });\n  }\n\n  const questions = await findQuestionsByWorksheetId(worksheetId);\n  const movedIdx = questions.findIndex((q) => q.id === movedId);\n  if (movedIdx === -1) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Moved question not found\",\n    });\n  }\n  const targetIdx = questions.findIndex((q) => q.id === targetId);\n  if (targetIdx === -1) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Target question not found\",\n    });\n  }\n  if (movedId === targetId) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Moved question and target question must be different\",\n    });\n  }\n\n  const withoutMoved = questions.filter((q) => q.id !== movedId);\n  const targetIdxWithoutMoved = withoutMoved.findIndex((q) => q.id === targetId);\n  const insertIdx =\n    position === \"before\" ? targetIdxWithoutMoved : targetIdxWithoutMoved + 1;\n  const next = [\n    ...withoutMoved.slice(0, insertIdx).map((item) => ({ id: item.id })),\n    { id: movedId },\n    ...withoutMoved.slice(insertIdx).map((item) => ({ id: item.id })),\n  ];\n\n  await prisma.$transaction(\n    next.map((item, index) =>\n      prisma.worksheetQuestion.update({\n        where: { id: item.id },\n        data: { order: index },\n      })\n    )\n  );\n  return next;\n}\n\nexport async function updateWorksheetQuestionRecord(\n  worksheetId: string,\n  questionId: string,\n  userId: string,\n  data: {\n    question?: string;\n    answer?: string;\n    points?: number;\n    options?: object;\n    markScheme?: object;\n    type?: WorksheetQuestionType;\n  }\n) {\n  const question = await findWorksheetQuestionByIdForTeacher(questionId, userId);\n  if (!question || question.worksheetId !== worksheetId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can update worksheet questions\",\n    });\n  }\n  return updateWorksheetQuestion(questionId, data);\n}\n\nexport async function deleteWorksheetQuestionRecord(\n  worksheetId: string,\n  questionId: string,\n  userId: string\n) {\n  const question = await findWorksheetQuestionByIdForTeacher(questionId, userId);\n  if (!question || question.worksheetId !== worksheetId) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can delete worksheet questions\",\n    });\n  }\n  return deleteWorksheetQuestion(questionId);\n}\n\nexport async function getWorksheetSubmission(\n  worksheetId: string,\n  submissionId: string,\n  userId: string\n) {\n  const worksheet = await findWorksheetByIdForClassMember(worksheetId, userId);\n  if (!worksheet) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet\",\n    });\n  }\n\n  const submission = await findSubmissionByIdForWorksheetAccess(\n    submissionId,\n    worksheetId,\n    worksheet.classId,\n    userId\n  );\n  if (!submission) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You do not have access to this worksheet submission\",\n    });\n  }\n  return findOrCreateWorksheetResponse(\n    submissionId,\n    worksheetId,\n    submission.studentId\n  );\n}\n\nexport async function answerWorksheetQuestion(\n  worksheetResponseId: string,\n  questionId: string,\n  response: string,\n  userId: string\n) {\n  const worksheetResponse = await findWorksheetResponseWithResponsesForStudent(\n    worksheetResponseId,\n    userId,\n    questionId\n  );\n  if (!worksheetResponse) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"You can only answer your own worksheet responses\",\n    });\n  }\n\n  const question = await findWorksheetQuestionByIdInWorksheet(\n    questionId,\n    worksheetResponse.worksheetId\n  );\n  if (!question) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet question not found\",\n    });\n  }\n\n  const isMarkableByAlgo =\n    question.type === \"MULTIPLE_CHOICE\" || question.type === \"TRUE_FALSE\";\n  const marksAwardedIfCorrect = question.points || 0;\n  const correctAnswer = isMarkableByAlgo\n    ? question.type === \"MULTIPLE_CHOICE\"\n      ? (question.options as MCQOptions)?.find((o) => o.isCorrect)?.id\n      : question.answer?.toString()\n    : null;\n\n  const existingResponse = worksheetResponse.responses[0];\n\n  if (existingResponse) {\n    await updateStudentQuestionProgress(existingResponse.id, {\n      response,\n      ...(isMarkableByAlgo && {\n        isCorrect: response === correctAnswer,\n      }),\n      ...(isMarkableByAlgo && {\n        points: response === correctAnswer ? marksAwardedIfCorrect : 0,\n      }),\n      status: JobStatus.NOT_STARTED,\n    });\n  } else {\n    await createStudentQuestionProgress({\n      studentId: worksheetResponse.studentId,\n      questionId,\n      response,\n      studentWorksheetResponseId: worksheetResponseId,\n      ...(isMarkableByAlgo && {\n        isCorrect: response === correctAnswer,\n      }),\n      ...(isMarkableByAlgo && {\n        points: response === correctAnswer ? marksAwardedIfCorrect : 0,\n      }),\n    });\n  }\n\n  const updated = await prisma.studentWorksheetResponse.findUnique({\n    where: { id: worksheetResponseId },\n    include: { responses: true },\n  });\n  return updated!;\n}\n\nexport async function cancelGrading(\n  worksheetResponseId: string,\n  progressId: string,\n  userId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacherAndResponse(\n    progressId,\n    worksheetResponseId,\n    userId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can cancel worksheet grading\",\n    });\n  }\n  return cancelGradePipeline(worksheetResponseId, progressId);\n}\n\nexport async function regradeQuestion(\n  worksheetResponseId: string,\n  progressId: string,\n  userId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacherAndResponse(\n    progressId,\n    worksheetResponseId,\n    userId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can regrade worksheet answers\",\n    });\n  }\n  return regradeWorksheetPipeline(worksheetResponseId, progressId);\n}\n\nexport async function gradeAnswer(\n  questionId: string,\n  studentWorksheetResponseId: string,\n  userId: string,\n  data: {\n    responseId?: string;\n    response?: string;\n    isCorrect: boolean;\n    feedback?: string;\n    markschemeState?: object;\n    points?: number;\n  }\n) {\n  const worksheetResponse = await findWorksheetResponseByIdForTeacher(\n    studentWorksheetResponseId,\n    userId\n  );\n  if (!worksheetResponse) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can grade worksheet answers\",\n    });\n  }\n\n  const question = await findWorksheetQuestionByIdInWorksheet(\n    questionId,\n    worksheetResponse.worksheetId\n  );\n  if (!question) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Worksheet question not found\",\n    });\n  }\n\n  if (data.responseId) {\n    const existingProgress = await findStudentQuestionProgressByIdForTeacher(\n      data.responseId,\n      userId\n    );\n    if (\n      !existingProgress ||\n      existingProgress.studentWorksheetResponseId !== studentWorksheetResponseId ||\n      existingProgress.questionId !== questionId\n    ) {\n      throw new TRPCError({\n        code: \"FORBIDDEN\",\n        message: \"Only class teachers can grade worksheet answers\",\n      });\n    }\n\n    return updateStudentQuestionProgressForGrading(data.responseId, {\n      isCorrect: data.isCorrect,\n      feedback: data.feedback,\n      markschemeState: data.markschemeState,\n      points: data.points,\n    });\n  }\n\n  const existing = await findStudentQuestionProgress(\n    worksheetResponse.studentId,\n    questionId,\n    studentWorksheetResponseId\n  );\n\n  if (existing) {\n    return updateStudentQuestionProgressForGrading(existing.id, {\n      isCorrect: data.isCorrect,\n      response: data.response,\n      feedback: data.feedback,\n      markschemeState: data.markschemeState,\n      points: data.points,\n    });\n  }\n\n  return createStudentQuestionProgressForGrading({\n    studentId: worksheetResponse.studentId,\n    questionId,\n    studentWorksheetResponseId,\n    response: data.response || \"\",\n    isCorrect: data.isCorrect,\n    feedback: data.feedback,\n    markschemeState: data.markschemeState,\n    points: data.points || 0,\n  });\n}\n\nexport async function addCommentToResponse(\n  responseId: string,\n  comment: string,\n  authorId: string\n) {\n  const progress = await findStudentQuestionProgressByIdForTeacher(\n    responseId,\n    authorId\n  );\n  if (!progress) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only class teachers can comment on worksheet responses\",\n    });\n  }\n\n  return createComment({\n    studentQuestionProgressId: responseId,\n    content: comment,\n    authorId,\n  });\n}\n"],"names":[],"mappings":"AAAA;;;GAGG;;;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAA8B,MAAM,gBAAgB,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,kBAAkB,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,sBAAsB,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,gCAAgC,CAAC;AAC/F,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AACrD,OAAO,EAAE,MAAM,EAAE,MAAM,oBAAoB,CAAC;AAC5C,OAAO,EACL,wBAAwB,EACxB,+BAA+B,EAC/B,2BAA2B,EAC3B,uBAAuB,EACvB,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,eAAe,EACf,0BAA0B,EAC1B,uBAAuB,EACvB,uBAAuB,EACvB,uBAAuB,EACvB,oCAAoC,EACpC,6BAA6B,EAC7B,mCAAmC,EACnC,4CAA4C,EAC5C,mCAAmC,EACnC,oCAAoC,EACpC,6BAA6B,EAC7B,6BAA6B,EAC7B,2BAA2B,EAC3B,uCAAuC,EACvC,uCAAuC,EACvC,aAAa,EACb,yCAAyC,EACzC,oDAAoD,GACrD,MAAM,wBAAwB,CAAC;AAIhC,MAAM,iCAAiC,GAAG,CAAC,OAAgB,EAAE,EAAE;IAC7D,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IAE5C,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;QAC5B,IAAI,CAAC,MAAM,IAAI,OAAO,MAAM,KAAK,QAAQ;YAAE,OAAO,MAAM,CAAC;QAEzD,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,GAAG,MAAiC,CAAC;QAC7E,OAAO,IAAI,CAAC;IACd,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,MAAM,2BAA2B,GAAG,CAEjC,SAAY,EAAE,EAAE,CAAC,CAAC;IACnB,GAAG,SAAS;IACZ,SAAS,EAAE,SAAS,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;QAChD,GAAG,QAAQ;QACX,MAAM,EAAE,EAAE;QACV,UAAU,EAAE,IAAI;QAChB,OAAO,EAAE,iCAAiC,CAAC,QAAQ,CAAC,OAAO,CAAC;KAC7D,CAAC,CAAC;CACJ,CAAC,CAAC;AAEH,qDAAqD;AACrD,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB,EAAE,MAAc;IACpE,MAAM,gBAAgB,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAChF,IAAI,gBAAgB,EAAE,CAAC;QACrB,OAAO,gBAAgB,CAAC;IAC1B,CAAC;IAED,MAAM,gBAAgB,GAAG,MAAM,+BAA+B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACpF,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,0CAA0C;SACpD,CAAC,CAAC;IACL,CAAC;IAED,OAAO,2BAA2B,CAAC,gBAAgB,CAAC,CAAC;AACvD,CAAC;AAED,iCAAiC;AACjC,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,EAAU;IAC9C,MAAM,SAAS,GAAG,MAAM,wBAAwB,CAAC,EAAE,CAAC,CAAC;IACrD,OAAO,CAAC,CAAC,SAAS,CAAC;AACrB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,OAAe;IAClD,MAAM,UAAU,GAAG,MAAM,uBAAuB,CAAC,OAAO,CAAC,CAAC;IAC1D,OAAO,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC5B,GAAG,CAAC;QACJ,aAAa,EAAE,CAAC,CAAC,SAAS,CAAC,MAAM;KAClC,CAAC,CAAC,CAAC;AACN,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,WAAmB,EACnB,MAAc,EACd,IAAuB;IAEvB,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,2CAA2C;SACrD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,WAAmB,EAAE,MAAc;IAC7E,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,2CAA2C;SACrD,CAAC,CAAC;IACL,CAAC;IACD,OAAO,eAAe,CAAC,WAAW,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,OAAe,EAAE,IAAY;IACvE,OAAO,eAAe,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC5C,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAC5C,WAAmB,EACnB,OAAe,EACf,IAAY,EACZ,MAAc;IAEd,MAAM,MAAM,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACtE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EACL,yEAAyE;SAC5E,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC;QAC5C,KAAK,EAAE;YACL,EAAE,EAAE,OAAO;YACX,QAAQ,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE;SACnC;QACD,MAAM,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE;KACrB,CAAC,CAAC;IAEH,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,2CAA2C;SACrD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,kBAAkB,CAAC,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,CAAC;IACrE,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,qBAAqB;SAC/B,CAAC,CAAC;IACL,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,OAAe,EACf,GAAW,EACX,MAAe,EACf,UAA6B,EAAE;IAE/B,MAAM,WAAW,GAAG,MAAM,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC;QAChD,IAAI,EAAE;YACJ,OAAO;YACP,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,iBAAiB;YAC/C,MAAM,EAAE,SAAS,CAAC,OAAO;SAC1B;KACF,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,aAAa,CACtC,kBAAkB,EAClB,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,CAAC,EAAE,EAAE,EACrD,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,IAAI,IAAI,EAAE,CACpC,CAAC;QAEF,MAAM,MAAM,CAAC,SAAS;aACnB,MAAM,CAAC;YACN,KAAK,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE;YAC7B,IAAI,EAAE,EAAE,QAAQ,EAAE;SACnB,CAAC;aACD,KAAK,CAAC,CAAC,SAAS,EAAE,EAAE;YACnB,MAAM,CAAC,KAAK,CACV,4DAA4D,EAC5D;gBACE,WAAW,EAAE,WAAW,CAAC,EAAE;gBAC3B,QAAQ;gBACR,KAAK,EACH,SAAS,YAAY,KAAK;oBACxB,CAAC,CAAC,SAAS,CAAC,OAAO;oBACnB,CAAC,CAAC,MAAM,CAAC,SAAS,CAAC;aACxB,CACF,CAAC;QACJ,CAAC,CAAC,CAAC;QAEL,OAAO;YACL,GAAG,WAAW;YACd,QAAQ;SACT,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,MAAM,CAAC,SAAS;aACnB,MAAM,CAAC;YACN,KAAK,EAAE,EAAE,EAAE,EAAE,WAAW,CAAC,EAAE,EAAE;YAC7B,IAAI,EAAE,EAAE,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE;SACnC,CAAC;aACD,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;QAE1B,MAAM,CAAC,KAAK,CAAC,sDAAsD,EAAE;YACnE,WAAW,EAAE,WAAW,CAAC,EAAE;YAC3B,OAAO;YACP,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;SAC9D,CAAC,CAAC;QAEH,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,uBAAuB;YAC7B,OAAO,EAAE,sCAAsC;SAChD,CAAC,CAAC;IACL,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,OAAe,EACf,MAAc,EACd,MAAc,EACd,UAA6B,EAAE;IAE/B,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC;QACvC,KAAK,EAAE;YACL,EAAE,EAAE,MAAM;YACV,MAAM;YACN,YAAY,EAAE,WAAW;SAC1B;QACD,MAAM,EAAE;YACN,EAAE,EAAE,IAAI;YACR,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,IAAI;YACV,IAAI,EAAE,IAAI;SACX;KACF,CAAC,CAAC;IAEH,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,sCAAsC;SAChD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GACT,IAAI,CAAC,IAAI,KAAK,iBAAiB,IAAI,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;IAC9E,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,iDAAiD;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC9C,OAAO,sBAAsB,CAAC,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE;QACxD,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,IAAI,IAAI,SAAS;KAC7C,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,MAAc,EACd,IAOC;IAED,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,oDAAoD;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,uBAAuB,CAAC;QAC7B,WAAW;QACX,GAAG,IAAI;KACR,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,MAAc,EACd,OAAe,EACf,QAA4B,EAC5B,QAAgB;IAEhB,MAAM,SAAS,GAAG,MAAM,2BAA2B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzE,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,qDAAqD;SAC/D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,SAAS,GAAG,MAAM,0BAA0B,CAAC,WAAW,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAC9D,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,0BAA0B;SACpC,CAAC,CAAC;IACL,CAAC;IACD,MAAM,SAAS,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAChE,IAAI,SAAS,KAAK,CAAC,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,2BAA2B;SACrC,CAAC,CAAC;IACL,CAAC;IACD,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;QACzB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,aAAa;YACnB,OAAO,EAAE,sDAAsD;SAChE,CAAC,CAAC;IACL,CAAC;IAED,MAAM,YAAY,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,CAAC;IAC/D,MAAM,qBAAqB,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,QAAQ,CAAC,CAAC;IAC/E,MAAM,SAAS,GACb,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,qBAAqB,GAAG,CAAC,CAAC;IAC5E,MAAM,IAAI,GAAG;QACX,GAAG,YAAY,CAAC,KAAK,CAAC,CAAC,EAAE,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACpE,EAAE,EAAE,EAAE,OAAO,EAAE;QACf,GAAG,YAAY,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;KAClE,CAAC;IAEF,MAAM,MAAM,CAAC,YAAY,CACvB,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CACvB,MAAM,CAAC,iBAAiB,CAAC,MAAM,CAAC;QAC9B,KAAK,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,EAAE,EAAE;QACtB,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE;KACvB,CAAC,CACH,CACF,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,WAAmB,EACnB,UAAkB,EAClB,MAAc,EACd,IAOC;IAED,MAAM,QAAQ,GAAG,MAAM,mCAAmC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/E,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,oDAAoD;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,uBAAuB,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,WAAmB,EACnB,UAAkB,EAClB,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,mCAAmC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAC/E,IAAI,CAAC,QAAQ,IAAI,QAAQ,CAAC,WAAW,KAAK,WAAW,EAAE,CAAC;QACtD,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,oDAAoD;SAC9D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,uBAAuB,CAAC,UAAU,CAAC,CAAC;AAC7C,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,sBAAsB,CAC1C,WAAmB,EACnB,YAAoB,EACpB,MAAc;IAEd,MAAM,SAAS,GAAG,MAAM,+BAA+B,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IAC7E,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,0CAA0C;SACpD,CAAC,CAAC;IACL,CAAC;IAED,MAAM,UAAU,GAAG,MAAM,oCAAoC,CAC3D,YAAY,EACZ,WAAW,EACX,SAAS,CAAC,OAAO,EACjB,MAAM,CACP,CAAC;IACF,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,qDAAqD;SAC/D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,6BAA6B,CAClC,YAAY,EACZ,WAAW,EACX,UAAU,CAAC,SAAS,CACrB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,uBAAuB,CAC3C,mBAA2B,EAC3B,UAAkB,EAClB,QAAgB,EAChB,MAAc;IAEd,MAAM,iBAAiB,GAAG,MAAM,4CAA4C,CAC1E,mBAAmB,EACnB,MAAM,EACN,UAAU,CACX,CAAC;IACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,kDAAkD;SAC5D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,oCAAoC,CACzD,UAAU,EACV,iBAAiB,CAAC,WAAW,CAC9B,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,8BAA8B;SACxC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,gBAAgB,GACpB,QAAQ,CAAC,IAAI,KAAK,iBAAiB,IAAI,QAAQ,CAAC,IAAI,KAAK,YAAY,CAAC;IACxE,MAAM,qBAAqB,GAAG,QAAQ,CAAC,MAAM,IAAI,CAAC,CAAC;IACnD,MAAM,aAAa,GAAG,gBAAgB;QACpC,CAAC,CAAC,QAAQ,CAAC,IAAI,KAAK,iBAAiB;YACnC,CAAC,CAAE,QAAQ,CAAC,OAAsB,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,EAAE,EAAE;YAChE,CAAC,CAAC,QAAQ,CAAC,MAAM,EAAE,QAAQ,EAAE;QAC/B,CAAC,CAAC,IAAI,CAAC;IAET,MAAM,gBAAgB,GAAG,iBAAiB,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;IAExD,IAAI,gBAAgB,EAAE,CAAC;QACrB,MAAM,6BAA6B,CAAC,gBAAgB,CAAC,EAAE,EAAE;YACvD,QAAQ;YACR,GAAG,CAAC,gBAAgB,IAAI;gBACtB,SAAS,EAAE,QAAQ,KAAK,aAAa;aACtC,CAAC;YACF,GAAG,CAAC,gBAAgB,IAAI;gBACtB,MAAM,EAAE,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;aAC/D,CAAC;YACF,MAAM,EAAE,SAAS,CAAC,WAAW;SAC9B,CAAC,CAAC;IACL,CAAC;SAAM,CAAC;QACN,MAAM,6BAA6B,CAAC;YAClC,SAAS,EAAE,iBAAiB,CAAC,SAAS;YACtC,UAAU;YACV,QAAQ;YACR,0BAA0B,EAAE,mBAAmB;YAC/C,GAAG,CAAC,gBAAgB,IAAI;gBACtB,SAAS,EAAE,QAAQ,KAAK,aAAa;aACtC,CAAC;YACF,GAAG,CAAC,gBAAgB,IAAI;gBACtB,MAAM,EAAE,QAAQ,KAAK,aAAa,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,CAAC;aAC/D,CAAC;SACH,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,wBAAwB,CAAC,UAAU,CAAC;QAC/D,KAAK,EAAE,EAAE,EAAE,EAAE,mBAAmB,EAAE;QAClC,OAAO,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE;KAC7B,CAAC,CAAC;IACH,OAAO,OAAQ,CAAC;AAClB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,mBAA2B,EAC3B,UAAkB,EAClB,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,oDAAoD,CACzE,UAAU,EACV,mBAAmB,EACnB,MAAM,CACP,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,kDAAkD;SAC5D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,mBAAmB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,mBAA2B,EAC3B,UAAkB,EAClB,MAAc;IAEd,MAAM,QAAQ,GAAG,MAAM,oDAAoD,CACzE,UAAU,EACV,mBAAmB,EACnB,MAAM,CACP,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,mDAAmD;SAC7D,CAAC,CAAC;IACL,CAAC;IACD,OAAO,wBAAwB,CAAC,mBAAmB,EAAE,UAAU,CAAC,CAAC;AACnE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,UAAkB,EAClB,0BAAkC,EAClC,MAAc,EACd,IAOC;IAED,MAAM,iBAAiB,GAAG,MAAM,mCAAmC,CACjE,0BAA0B,EAC1B,MAAM,CACP,CAAC;IACF,IAAI,CAAC,iBAAiB,EAAE,CAAC;QACvB,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,iDAAiD;SAC3D,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,oCAAoC,CACzD,UAAU,EACV,iBAAiB,CAAC,WAAW,CAC9B,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,8BAA8B;SACxC,CAAC,CAAC;IACL,CAAC;IAED,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;QACpB,MAAM,gBAAgB,GAAG,MAAM,yCAAyC,CACtE,IAAI,CAAC,UAAU,EACf,MAAM,CACP,CAAC;QACF,IACE,CAAC,gBAAgB;YACjB,gBAAgB,CAAC,0BAA0B,KAAK,0BAA0B;YAC1E,gBAAgB,CAAC,UAAU,KAAK,UAAU,EAC1C,CAAC;YACD,MAAM,IAAI,SAAS,CAAC;gBAClB,IAAI,EAAE,WAAW;gBACjB,OAAO,EAAE,iDAAiD;aAC3D,CAAC,CAAC;QACL,CAAC;QAED,OAAO,uCAAuC,CAAC,IAAI,CAAC,UAAU,EAAE;YAC9D,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,2BAA2B,CAChD,iBAAiB,CAAC,SAAS,EAC3B,UAAU,EACV,0BAA0B,CAC3B,CAAC;IAEF,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,uCAAuC,CAAC,QAAQ,CAAC,EAAE,EAAE;YAC1D,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,eAAe,EAAE,IAAI,CAAC,eAAe;YACrC,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAC,CAAC;IACL,CAAC;IAED,OAAO,uCAAuC,CAAC;QAC7C,SAAS,EAAE,iBAAiB,CAAC,SAAS;QACtC,UAAU;QACV,0BAA0B;QAC1B,QAAQ,EAAE,IAAI,CAAC,QAAQ,IAAI,EAAE;QAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,QAAQ,EAAE,IAAI,CAAC,QAAQ;QACvB,eAAe,EAAE,IAAI,CAAC,eAAe;QACrC,MAAM,EAAE,IAAI,CAAC,MAAM,IAAI,CAAC;KACzB,CAAC,CAAC;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,UAAkB,EAClB,OAAe,EACf,QAAgB;IAEhB,MAAM,QAAQ,GAAG,MAAM,yCAAyC,CAC9D,UAAU,EACV,QAAQ,CACT,CAAC;IACF,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,SAAS,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,OAAO,EAAE,wDAAwD;SAClE,CAAC,CAAC;IACL,CAAC;IAED,OAAO,aAAa,CAAC;QACnB,yBAAyB,EAAE,UAAU;QACrC,OAAO,EAAE,OAAO;QAChB,QAAQ;KACT,CAAC,CAAC;AACL,CAAC","debug_id":"d5088046-353b-5b26-b9c3-10f78d48d45e"}

package/dist/utils/generateUsername.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Username generator – produces playful adjective+noun+number combos like "greenegg6767".
+ * Pass an `isTaken` checker to retry until a unique username is found.
+ */
+export declare function generateRandomUsername(): string;
+/** Generate a unique username, calling `isTaken` until one is free. */
+export declare function generateUniqueUsername(isTaken: (username: string) => Promise<boolean>, maxAttempts?: number): Promise<string>;
+//# sourceMappingURL=generateUsername.d.ts.map

package/dist/utils/generateUsername.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generateUsername.d.ts","sourceRoot":"/","sources":["utils/generateUsername.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAwFH,wBAAgB,sBAAsB,WAErC;AAED,uEAAuE;AACvE,wBAAsB,sBAAsB,CAC1C,OAAO,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,OAAO,CAAC,EAC/C,WAAW,SAAK,mBASjB"}