@studious-lms/server 1.13.0 → 1.15.0

package/dist/services/userPrivacy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userPrivacy.js","sources":["services/userPrivacy.ts"],"sourceRoot":"/","sourcesContent":["/**\n * User privacy service — data export and account erasure (anonymization).\n */\nimport { TRPCError } from \"@trpc/server\";\nimport { randomBytes } from \"node:crypto\";\nimport { hash } from \"bcryptjs\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { deleteSessionsByUserId } from \"../models/auth.js\";\n\nasync function assertAccountCanBeErased(userId: string) {\n  const user = await prisma.user.findUnique({\n    where: { id: userId },\n    select: {\n      id: true,\n      teacherIn: {\n        select: {\n          id: true,\n          name: true,\n          _count: { select: { students: true } },\n        },\n      },\n      _count: {\n        select: {\n          assignments: true,\n          createdLabChats: true,\n        },\n      },\n    },\n  });\n\n  if (!user) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"User not found\" });\n  }\n\n  const classesWithStudents = user.teacherIn.filter(\n    (cls) => cls._count.students > 0,\n  );\n  if (classesWithStudents.length > 0) {\n    throw new TRPCError({\n      code: \"PRECONDITION_FAILED\",\n      message:\n        \"Delete or transfer your classes before deleting your account.\",\n    });\n  }\n\n  if (user._count.assignments > 0) {\n    throw new TRPCError({\n      code: \"PRECONDITION_FAILED\",\n      message:\n        \"Remove or reassign your assignments before deleting your account.\",\n    });\n  }\n\n  if (user._count.createdLabChats > 0) {\n    throw new TRPCError({\n      code: \"PRECONDITION_FAILED\",\n      message: \"Remove your AI lab chats before deleting your account.\",\n    });\n  }\n}\n\n/** Export a portable snapshot of the authenticated user's personal data. */\nexport async function exportUserData(userId: string) {\n  const user = await prisma.user.findUnique({\n    where: { id: userId },\n    select: {\n      id: true,\n      username: true,\n      email: true,\n      verified: true,\n      termsAcceptedAt: true,\n      termsVersion: true,\n      profile: true,\n      teacherIn: {\n        select: { id: true, name: true, subject: true, section: true },\n      },\n      studentIn: {\n        select: { id: true, name: true, subject: true, section: true },\n      },\n      schoolMemberships: {\n        select: {\n          role: true,\n          status: true,\n          school: { select: { id: true, name: true } },\n        },\n      },\n      submissions: {\n        select: {\n          id: true,\n          createdAt: true,\n          submittedAt: true,\n          gradeReceived: true,\n          extendedResponse: true,\n          assignment: { select: { id: true, title: true, classId: true } },\n        },\n      },\n      events: {\n        select: {\n          id: true,\n          name: true,\n          startTime: true,\n          endTime: true,\n          location: true,\n          remarks: true,\n        },\n      },\n      sentMessages: {\n        select: {\n          id: true,\n          content: true,\n          createdAt: true,\n          conversationId: true,\n        },\n        take: 500,\n        orderBy: { createdAt: \"desc\" },\n      },\n      notificationsReceived: {\n        select: {\n          id: true,\n          title: true,\n          content: true,\n          read: true,\n          createdAt: true,\n        },\n        take: 200,\n        orderBy: { createdAt: \"desc\" },\n      },\n    },\n  });\n\n  if (!user) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"User not found\" });\n  }\n\n  return {\n    exportedAt: new Date().toISOString(),\n    user,\n  };\n}\n\n/**\n * Erase personal account data by anonymizing the user record and removing\n * sessions and memberships. Educational records tied to classes (e.g.\n * submissions) remain with an anonymized identity where required.\n */\nexport async function deleteUserAccount(userId: string) {\n  await assertAccountCanBeErased(userId);\n  await deleteSessionsByUserId(userId);\n\n  const anonUsername = `deleted_${userId.slice(0, 8)}`;\n  const anonEmail = `deleted+${userId}@studious.invalid`;\n  const randomPassword = await hash(randomBytes(32).toString(\"hex\"), 10);\n\n  await prisma.$transaction([\n    prisma.conversationMember.deleteMany({ where: { userId } }),\n    prisma.notification.deleteMany({\n      where: { OR: [{ senderId: userId }, { receiverId: userId }] },\n    }),\n    prisma.schoolMembership.deleteMany({ where: { userId } }),\n    prisma.permission.deleteMany({\n      where: { OR: [{ userId }, { grantedById: userId }] },\n    }),\n    prisma.user.update({\n      where: { id: userId },\n      data: {\n        teacherIn: { set: [] },\n        studentIn: { set: [] },\n        departments: { set: [] },\n        tags: { set: [] },\n        specificAssignments: { set: [] },\n        presentAttendance: { set: [] },\n        lateAttendance: { set: [] },\n        absentAttendance: { set: [] },\n        schoolId: null,\n        username: anonUsername,\n        email: anonEmail,\n        password: randomPassword,\n        verified: false,\n        termsAcceptedAt: null,\n        termsVersion: null,\n        profile: {\n          update: {\n            displayName: null,\n            bio: null,\n            location: null,\n            website: null,\n            profilePicture: null,\n            profilePictureThumbnail: null,\n          },\n        },\n      },\n    }),\n  ]);\n\n  return { success: true };\n}\n"],"names":[],"mappings":"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","debug_id":"7184e3ea-1921-5a91-936e-6fa9a92f8a03"}

package/dist/services/worksheet.d.ts

@@ -1,38 +1,44 @@
-import { type WorksheetQuestionType } from "@prisma/client";
+import { Prisma, type WorksheetQuestionType } from "@prisma/client";
 /** Get worksheet with questions and mark schemes. */
 export declare function getWorksheet(worksheetId: string, userId: string): Promise<{
     class: {
-        name: string;
+        section: string;
         id: string;
+        name: string;
         schoolId: string | null;
-        subject: string;
         color: string | null;
-        section: string;
+        subject: string;
         syllabus: string | null;
         departmentId: string | null;
         discussionsEnabled: boolean;
         studentsCanCreateDiscussions: boolean;
         studentsCanReply: boolean;
     } | null;
+    tags: {
+        id: string;
+        name: string;
+        color: string;
+        classId: string;
+    }[];
     questions: {
         type: import(".prisma/client").$Enums.WorksheetQuestionType;
-        options: import("@prisma/client/runtime/library.js").JsonValue | null;
+        options: Prisma.JsonValue | null;
+        markScheme: Prisma.JsonValue | null;
         id: string;
         createdAt: Date;
         updatedAt: Date;
-        order: number | null;
         points: number;
-        worksheetId: string;
-        markScheme: import("@prisma/client/runtime/library.js").JsonValue | null;
         question: string;
+        worksheetId: string;
+        order: number | null;
         answer: string;
     }[];
 } & {
     status: import(".prisma/client").$Enums.JobStatus | null;
-    name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
+    name: string;
     classId: string;
     runJobId: string | null;
     sourceUrl: string | null;
@@ -41,14 +47,20 @@ export declare function getWorksheet(worksheetId: string, userId: string): Promi
 export declare function worksheetExists(id: string): Promise<boolean>;
 export declare function listWorksheets(classId: string): Promise<{
     questionCount: number;
+    tags: {
+        id: string;
+        name: string;
+        color: string;
+        classId: string;
+    }[];
     questions: {
         id: string;
     }[];
     status: import(".prisma/client").$Enums.JobStatus | null;
-    name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
+    name: string;
     classId: string;
     runJobId: string | null;
     sourceUrl: string | null;
@@ -57,30 +69,30 @@ export declare function updateWorksheetRecord(worksheetId: string, userId: strin
     name?: string;
 }): Promise<{
     status: import(".prisma/client").$Enums.JobStatus | null;
-    name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
+    name: string;
     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;
+    name: string;
     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;
+    name: string;
     classId: string;
     runJobId: string | null;
     sourceUrl: string | null;
@@ -91,10 +103,10 @@ export declare function createWorksheetRecord(classId: string, name: string): Pr
  */
 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;
+    name: string;
     classId: string;
     runJobId: string | null;
     sourceUrl: string | null;
@@ -113,10 +125,10 @@ export declare function createWorksheetFromPdf(classId: string, url: string, use
 }): Promise<{
     runJobId: string;
     status: import(".prisma/client").$Enums.JobStatus | null;
-    name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
+    name: string;
     classId: string;
     sourceUrl: string | null;
 }>;
@@ -128,10 +140,10 @@ export declare function createWorksheetFromUploadedPdf(classId: string, fileId:
 }): Promise<{
     runJobId: string;
     status: import(".prisma/client").$Enums.JobStatus | null;
-    name: string;
     id: string;
     createdAt: Date;
     updatedAt: Date;
+    name: string;
     classId: string;
     sourceUrl: string | null;
 }>;
@@ -145,17 +157,34 @@ export declare function addQuestionToWorksheet(worksheetId: string, userId: stri
     order?: number;
 }): Promise<{
     type: import(".prisma/client").$Enums.WorksheetQuestionType;
-    options: import("@prisma/client/runtime/library.js").JsonValue | null;
+    options: Prisma.JsonValue | null;
+    markScheme: Prisma.JsonValue | null;
     id: string;
     createdAt: Date;
     updatedAt: Date;
-    order: number | null;
     points: number;
-    worksheetId: string;
-    markScheme: import("@prisma/client/runtime/library.js").JsonValue | null;
     question: string;
+    worksheetId: string;
+    order: number | null;
     answer: string;
 }>;
+/** A question's full editable state as captured before an AI modifier run. */
+export interface WorksheetQuestionSnapshot {
+    id: string;
+    type: WorksheetQuestionType;
+    question: string;
+    answer: string;
+    options: unknown;
+    markScheme: unknown;
+    points: number;
+    order: number | null;
+}
+/**
+ * Restore a worksheet's questions to a snapshot: deletes questions not in the
+ * snapshot, re-creates deleted ones (with their original ids), and reverts
+ * edited ones. Used by AI modifier undo.
+ */
+export declare function restoreWorksheetQuestions(worksheetId: string, userId: string, questions: WorksheetQuestionSnapshot[]): Promise<void>;
 export declare function reorderWorksheetQuestions(worksheetId: string, userId: string, movedId: string, position: "before" | "after", targetId: string): Promise<{
     id: string;
 }[]>;
@@ -168,28 +197,28 @@ export declare function updateWorksheetQuestionRecord(worksheetId: string, quest
     type?: WorksheetQuestionType;
 }): Promise<{
     type: import(".prisma/client").$Enums.WorksheetQuestionType;
-    options: import("@prisma/client/runtime/library.js").JsonValue | null;
+    options: Prisma.JsonValue | null;
+    markScheme: Prisma.JsonValue | null;
     id: string;
     createdAt: Date;
     updatedAt: Date;
-    order: number | null;
     points: number;
-    worksheetId: string;
-    markScheme: import("@prisma/client/runtime/library.js").JsonValue | null;
     question: string;
+    worksheetId: string;
+    order: number | null;
     answer: string;
 }>;
 export declare function deleteWorksheetQuestionRecord(worksheetId: string, questionId: string, userId: string): Promise<{
     type: import(".prisma/client").$Enums.WorksheetQuestionType;
-    options: import("@prisma/client/runtime/library.js").JsonValue | null;
+    options: Prisma.JsonValue | null;
+    markScheme: Prisma.JsonValue | null;
     id: string;
     createdAt: Date;
     updatedAt: Date;
-    order: number | null;
     points: number;
-    worksheetId: string;
-    markScheme: import("@prisma/client/runtime/library.js").JsonValue | null;
     question: string;
+    worksheetId: string;
+    order: number | null;
     answer: string;
 }>;
 export declare function getWorksheetSubmission(worksheetId: string, submissionId: string, userId: string): Promise<{
@@ -203,15 +232,15 @@ export declare function getWorksheetSubmission(worksheetId: string, submissionId
         id: string;
         createdAt: Date;
         updatedAt: Date | null;
-        studentId: string;
-        questionId: string;
+        feedback: string | null;
+        runJobId: string | null;
         response: string;
         isCorrect: boolean;
-        markschemeState: import("@prisma/client/runtime/library.js").JsonValue | null;
+        markschemeState: Prisma.JsonValue | null;
         points: number;
-        feedback: string | null;
+        studentId: string;
+        questionId: string;
         studentWorksheetResponseId: string | null;
-        runJobId: string | null;
     })[];
 } & {
     id: string;
@@ -219,9 +248,9 @@ export declare function getWorksheetSubmission(worksheetId: string, submissionId
     updatedAt: Date;
     submissionId: string | null;
     studentId: string;
+    worksheetId: string;
     submittedAt: Date | null;
     submitted: boolean;
-    worksheetId: string;
 }>;
 export declare function answerWorksheetQuestion(worksheetResponseId: string, questionId: string, response: string, userId: string): Promise<{
     responses: {
@@ -229,15 +258,15 @@ export declare function answerWorksheetQuestion(worksheetResponseId: string, que
         id: string;
         createdAt: Date;
         updatedAt: Date | null;
-        studentId: string;
-        questionId: string;
+        feedback: string | null;
+        runJobId: string | null;
         response: string;
         isCorrect: boolean;
-        markschemeState: import("@prisma/client/runtime/library.js").JsonValue | null;
+        markschemeState: Prisma.JsonValue | null;
         points: number;
-        feedback: string | null;
+        studentId: string;
+        questionId: string;
         studentWorksheetResponseId: string | null;
-        runJobId: string | null;
     }[];
 } & {
     id: string;
@@ -245,39 +274,39 @@ export declare function answerWorksheetQuestion(worksheetResponseId: string, que
     updatedAt: Date;
     submissionId: string | null;
     studentId: string;
+    worksheetId: string;
     submittedAt: Date | null;
     submitted: boolean;
-    worksheetId: string;
 }>;
 export declare function cancelGrading(worksheetResponseId: string, progressId: string, userId: string): Promise<{
     status: import(".prisma/client").$Enums.JobStatus | null;
     id: string;
     createdAt: Date;
     updatedAt: Date | null;
-    studentId: string;
-    questionId: string;
+    feedback: string | null;
+    runJobId: string | null;
     response: string;
     isCorrect: boolean;
-    markschemeState: import("@prisma/client/runtime/library.js").JsonValue | null;
+    markschemeState: Prisma.JsonValue | null;
     points: number;
-    feedback: string | null;
+    studentId: string;
+    questionId: string;
     studentWorksheetResponseId: string | null;
-    runJobId: string | null;
 }>;
 export declare function regradeQuestion(worksheetResponseId: string, progressId: string, userId: string): Promise<{
     status: import(".prisma/client").$Enums.JobStatus | null;
     id: string;
     createdAt: Date;
     updatedAt: Date | null;
-    studentId: string;
-    questionId: string;
+    feedback: string | null;
+    runJobId: string | null;
     response: string;
     isCorrect: boolean;
-    markschemeState: import("@prisma/client/runtime/library.js").JsonValue | null;
+    markschemeState: Prisma.JsonValue | null;
     points: number;
-    feedback: string | null;
+    studentId: string;
+    questionId: string;
     studentWorksheetResponseId: string | null;
-    runJobId: string | null;
 } | null>;
 export declare function gradeAnswer(questionId: string, studentWorksheetResponseId: string, userId: string, data: {
     responseId?: string;
@@ -291,27 +320,27 @@ export declare function gradeAnswer(questionId: string, studentWorksheetResponse
     id: string;
     createdAt: Date;
     updatedAt: Date | null;
-    studentId: string;
-    questionId: string;
+    feedback: string | null;
+    runJobId: string | null;
     response: string;
     isCorrect: boolean;
-    markschemeState: import("@prisma/client/runtime/library.js").JsonValue | null;
+    markschemeState: Prisma.JsonValue | null;
     points: number;
-    feedback: string | null;
+    studentId: string;
+    questionId: string;
     studentWorksheetResponseId: string | null;
-    runJobId: string | null;
 }>;
 export declare function addCommentToResponse(responseId: string, comment: string, authorId: string): Promise<{
     id: string;
     createdAt: Date;
+    content: string;
     assignmentId: string | null;
     submissionId: string | null;
     announcementId: string | null;
     modifiedAt: Date | null;
-    content: string;
     authorId: string;
-    parentCommentId: string | null;
     isPinned: boolean;
+    parentCommentId: string | null;
     studentQuestionProgressId: string | null;
 }>;
 //# sourceMappingURL=worksheet.d.ts.map

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,15 +3,16 @@
  * 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]="763e1691-86f4-53c9-8832-39f71889d16c")}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]="ecf79b03-756f-53ee-81b5-52a53a17b0e8")}catch(e){}}();
 import { TRPCError } from "@trpc/server";
-import { JobStatus } from "@prisma/client";
+import { JobStatus, Prisma } from "@prisma/client";
 import { prisma } from "../lib/prisma.js";
 import { getFileUrl } from "../lib/fileUpload.js";
 import { cancelGradePipeline, regradeWorksheetPipeline } from "../pipelines/gradeWorksheet.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, findStudentQuestionProgressByIdForStudentOrTeacher, findStudentQuestionProgressByIdForTeacherAndResponse, } from "../models/worksheet.js";
+import { enqueueEmbedding } from "./embedding.js";
 const sanitizeQuestionOptionsForStudent = (options) => {
     if (!Array.isArray(options))
         return options;
@@ -66,7 +67,10 @@ export async function updateWorksheetRecord(worksheetId, userId, data) {
             message: "Only class teachers can update worksheets",
         });
     }
-    return updateWorksheet(worksheetId, data);
+    const updated = await updateWorksheet(worksheetId, data);
+    // Re-index worksheet for RAG search
+    enqueueEmbedding(worksheet.classId, 'WORKSHEET', worksheetId);
+    return updated;
 }
 export async function deleteWorksheetRecord(worksheetId, userId) {
     const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);
@@ -79,7 +83,10 @@ export async function deleteWorksheetRecord(worksheetId, userId) {
     return deleteWorksheet(worksheetId);
 }
 export async function createWorksheetRecord(classId, name) {
-    return createWorksheet({ classId, name });
+    const worksheet = await createWorksheet({ classId, name });
+    // Auto-index worksheet for RAG search
+    enqueueEmbedding(classId, 'WORKSHEET', worksheet.id);
+    return worksheet;
 }
 /**
  * Duplicate a worksheet into another class. Caller must teach both the source worksheet's class
@@ -219,6 +226,51 @@ export async function addQuestionToWorksheet(worksheetId, userId, data) {
         ...data,
     });
 }
+const toJsonInput = (value) => value === null || value === undefined
+    ? Prisma.JsonNull
+    : value;
+/**
+ * Restore a worksheet's questions to a snapshot: deletes questions not in the
+ * snapshot, re-creates deleted ones (with their original ids), and reverts
+ * edited ones. Used by AI modifier undo.
+ */
+export async function restoreWorksheetQuestions(worksheetId, userId, questions) {
+    const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);
+    if (!worksheet) {
+        throw new TRPCError({
+            code: "FORBIDDEN",
+            message: "Only class teachers can modify worksheet questions",
+        });
+    }
+    await prisma.$transaction([
+        prisma.worksheetQuestion.deleteMany({
+            where: { worksheetId, id: { notIn: questions.map((q) => q.id) } },
+        }),
+        ...questions.map((q) => prisma.worksheetQuestion.upsert({
+            where: { id: q.id },
+            create: {
+                id: q.id,
+                worksheetId,
+                type: q.type,
+                question: q.question,
+                answer: q.answer,
+                options: toJsonInput(q.options),
+                markScheme: toJsonInput(q.markScheme),
+                points: q.points,
+                order: q.order,
+            },
+            update: {
+                type: q.type,
+                question: q.question,
+                answer: q.answer,
+                options: toJsonInput(q.options),
+                markScheme: toJsonInput(q.markScheme),
+                points: q.points,
+                order: q.order,
+            },
+        })),
+    ]);
+}
 export async function reorderWorksheetQuestions(worksheetId, userId, movedId, position, targetId) {
     const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);
     if (!worksheet) {
@@ -442,4 +494,4 @@ export async function addCommentToResponse(responseId, comment, authorId) {
     });
 }
 //# sourceMappingURL=worksheet.js.map
-//# debugId=763e1691-86f4-53c9-8832-39f71889d16c
+//# debugId=ecf79b03-756f-53ee-81b5-52a53a17b0e8