@studious-lms/server 1.5.0 → 1.7.0

package/dist/services/worksheet.d.ts

@@ -96,30 +96,39 @@ export declare function duplicateWorksheetRecord(worksheetId: string, classId: s
     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;
-    runJobId: string | null;
     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;
-    runJobId: string | null;
     sourceUrl: string | null;
 }>;
 export declare function addQuestionToWorksheet(worksheetId: string, userId: string, data: {

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]="50a37b50-4ec1-5efd-8393-2b0082129103")}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 { 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);
@@ -396,4 +442,4 @@ export async function addCommentToResponse(responseId, comment, authorId) {
     });
 }
 //# sourceMappingURL=worksheet.js.map
-//# debugId=50a37b50-4ec1-5efd-8393-2b0082129103
+//# 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 { 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 { 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  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":"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","debug_id":"50a37b50-4ec1-5efd-8393-2b0082129103"}
+{"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":"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","debug_id":"d5088046-353b-5b26-b9c3-10f78d48d45e"}

package/dist/utils/inference.d.ts

@@ -3,7 +3,7 @@
  */
 import OpenAI from 'openai';
 import type { ResponseInput } from "openai/resources/responses/responses.js";
-import { Prisma } from '@prisma/client';
+import { JobStatus, Prisma } from '@prisma/client';
 import { ZodSchema } from 'zod';
 export declare const inferenceClient: OpenAI;
 export declare const openAIClient: OpenAI;
@@ -55,6 +55,54 @@ export declare function sendAIMessage(content: string, conversationId: string, o
     createdAt: Date;
     meta?: Record<string, any>;
 }>;
+interface AIMessageSenderInfo {
+    displayName?: string;
+    profilePicture?: string | null;
+}
+/**
+ * Create an AI message placeholder in PENDING state and broadcast it.
+ *
+ * The AI message lifecycle == job lifecycle: this row is the bubble the
+ * client renders for "AI is thinking..." and is later flipped by
+ * {@link completePendingAIMessage} / {@link failPendingAIMessage}.
+ */
+export declare function createPendingAIMessage(conversationId: string, options?: {
+    customSender?: AIMessageSenderInfo;
+}): Promise<{
+    id: string;
+    conversationId: string;
+    createdAt: Date;
+    senderId: string;
+    status: JobStatus;
+}>;
+/**
+ * Fill a PENDING AI message with its generated content and flip it to
+ * COMPLETED. Broadcasts a `message-updated` event so clients that already
+ * rendered the placeholder can patch it in place.
+ */
+export declare function completePendingAIMessage(messageId: string, content: string, options?: {
+    attachments?: {
+        connect: {
+            id: string;
+        }[];
+    };
+    meta?: Record<string, any>;
+    customSender?: AIMessageSenderInfo;
+}): Promise<{
+    id: string;
+    content: string;
+    conversationId: string;
+    createdAt: Date;
+    status: JobStatus;
+}>;
+/**
+ * Flip a PENDING AI message to FAILED and broadcast the status change.
+ * Does NOT throw — failure paths in the pipelines call this in catch blocks
+ * and we do not want broadcast/DB errors to mask the original error.
+ */
+export declare function failPendingAIMessage(messageId: string, options?: {
+    reason?: string;
+}): Promise<void>;
 export declare function inference<T>(content: string | OpenAI.Chat.Completions.ChatCompletionMessageParam[] | ResponseInput, format?: ZodSchema, options?: InferenceOptions): Promise<T>;
 /**
  * Get available inference models (for admin/config purposes)
@@ -64,4 +112,5 @@ export declare function getAvailableModels(): Promise<string[]>;
  * Estimate token count for a message (rough approximation)
  */
 export declare function estimateTokenCount(text: string): number;
+export {};
 //# sourceMappingURL=inference.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"inference.d.ts","sourceRoot":"/","sources":["utils/inference.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,yCAAyC,CAAC;AAM7E,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AACxC,OAAO,EAAE,SAAS,EAAE,MAAM,KAAK,CAAC;AAGhC,eAAO,MAAM,eAAe,QAG1B,CAAC;AAEH,eAAO,MAAM,YAAY,QAAe,CAAC;AASzC,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC,cAAc,CAAC;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAoBD,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,UAAU,GAAG,cAAc,GAAG,UAAU,CAAC;IACrD,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,EAAE,MAAM,EAAE,CAAC;IACtB,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC;IACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,iBAAiB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAgHD;;;GAGG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,MAAM,EACf,cAAc,EAAE,MAAM,EACtB,OAAO,GAAE;IACP,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE;QACZ,OAAO,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,EAAE,CAAC;KAC3B,CAAC;IACF,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;IAC3B,YAAY,CAAC,EAAE;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;KAChC,CAAC;CACE,GACL,OAAO,CAAC;IACT,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,IAAI,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;CAC5B,CAAC,CAoED;AAsCD,wBAAsB,SAAS,CAAC,CAAC,EAC/B,OAAO,EACH,MAAM,GACN,MAAM,CAAC,IAAI,CAAC,WAAW,CAAC,0BAA0B,EAAE,GACpD,aAAa,EACjB,MAAM,CAAC,EAAE,SAAS,EAClB,OAAO,CAAC,EAAE,gBAAgB,GACzB,OAAO,CAAC,CAAC,CAAC,CA6GZ;AAED;;GAEG;AACH,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC,CAW5D;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEvD"}
+{"version":3,"file":"inference.d.ts","sourceRoot":"/","sources":["utils/inference.ts"],"names":[],"mappings":"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"}

package/dist/utils/inference.js

@@ -2,13 +2,14 @@
  * Inference util – OpenAI client, inference() for structured output, sendAIMessage for chat.
  */
 
-!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]="621b1d59-2865-5a51-8bea-88c27023731f")}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]="7fa949f6-b6c7-5f82-bc61-5de02fa8f775")}catch(e){}}();
 import OpenAI from 'openai';
 import { logger } from './logger.js';
 import { prisma } from '../lib/prisma.js';
 import { chatChannel, pusher } from '../lib/pusher.js';
 import { ensureAIUserExists, getAIUserId } from './aiUser.js';
 import { env } from '../lib/config/env.js';
+import { JobStatus } from '@prisma/client';
 import { zodTextFormat } from 'openai/helpers/zod';
 export const inferenceClient = new OpenAI({
     apiKey: env.INFERENCE_API_KEY,
@@ -163,6 +164,170 @@ export async function sendAIMessage(content, conversationId, options = {}) {
         meta: aiMessage.meta,
     };
 }
+function buildAISenderInfo(customSender) {
+    return {
+        id: getAIUserId(),
+        username: 'Newton_AI',
+        profile: {
+            displayName: customSender?.displayName ?? 'Newton AI',
+            profilePicture: customSender?.profilePicture ?? null,
+        },
+    };
+}
+/**
+ * Create an AI message placeholder in PENDING state and broadcast it.
+ *
+ * The AI message lifecycle == job lifecycle: this row is the bubble the
+ * client renders for "AI is thinking..." and is later flipped by
+ * {@link completePendingAIMessage} / {@link failPendingAIMessage}.
+ */
+export async function createPendingAIMessage(conversationId, options = {}) {
+    await ensureAIUserExists();
+    const aiMessage = await prisma.message.create({
+        data: {
+            content: '',
+            senderId: getAIUserId(),
+            conversationId,
+            status: JobStatus.PENDING,
+        },
+    });
+    logger.info('AI placeholder message created', {
+        messageId: aiMessage.id,
+        conversationId,
+    });
+    const senderInfo = buildAISenderInfo(options.customSender);
+    try {
+        await pusher.trigger(chatChannel(conversationId), 'new-message', {
+            id: aiMessage.id,
+            content: '',
+            senderId: getAIUserId(),
+            conversationId: aiMessage.conversationId,
+            status: JobStatus.PENDING,
+            createdAt: aiMessage.createdAt,
+            sender: senderInfo,
+            mentionedUserIds: [],
+            meta: {},
+            attachments: [],
+        });
+    }
+    catch (error) {
+        logger.error('Failed to broadcast pending AI message:', {
+            error,
+            messageId: aiMessage.id,
+        });
+    }
+    return {
+        id: aiMessage.id,
+        conversationId: aiMessage.conversationId,
+        createdAt: aiMessage.createdAt,
+        senderId: aiMessage.senderId,
+        status: JobStatus.PENDING,
+    };
+}
+/**
+ * Fill a PENDING AI message with its generated content and flip it to
+ * COMPLETED. Broadcasts a `message-updated` event so clients that already
+ * rendered the placeholder can patch it in place.
+ */
+export async function completePendingAIMessage(messageId, content, options = {}) {
+    const updated = await prisma.message.update({
+        where: { id: messageId },
+        data: {
+            content,
+            status: JobStatus.COMPLETED,
+            ...(options.attachments && {
+                attachments: {
+                    connect: options.attachments.connect,
+                },
+            }),
+            ...(options.meta !== undefined && {
+                meta: options.meta,
+            }),
+        },
+        include: {
+            attachments: true,
+        },
+    });
+    logger.info('AI message completed', {
+        messageId: updated.id,
+        conversationId: updated.conversationId,
+        contentLength: content.length,
+    });
+    const senderInfo = buildAISenderInfo(options.customSender);
+    try {
+        await pusher.trigger(chatChannel(updated.conversationId), 'message-updated', {
+            id: updated.id,
+            content: updated.content,
+            senderId: updated.senderId,
+            conversationId: updated.conversationId,
+            status: updated.status,
+            createdAt: updated.createdAt,
+            sender: senderInfo,
+            mentionedUserIds: [],
+            meta: updated.meta ?? {},
+            attachments: updated.attachments.map((attachment) => ({
+                id: attachment.id,
+                attachmentId: attachment.id,
+                name: attachment.name,
+                type: attachment.type,
+                size: attachment.size,
+                path: attachment.path,
+            })),
+        });
+    }
+    catch (error) {
+        logger.error('Failed to broadcast completed AI message:', {
+            error,
+            messageId,
+        });
+    }
+    return {
+        id: updated.id,
+        content: updated.content,
+        conversationId: updated.conversationId,
+        createdAt: updated.createdAt,
+        status: (updated.status ?? JobStatus.COMPLETED),
+    };
+}
+/**
+ * Flip a PENDING AI message to FAILED and broadcast the status change.
+ * Does NOT throw — failure paths in the pipelines call this in catch blocks
+ * and we do not want broadcast/DB errors to mask the original error.
+ */
+export async function failPendingAIMessage(messageId, options = {}) {
+    try {
+        const updated = await prisma.message.update({
+            where: { id: messageId },
+            data: { status: JobStatus.FAILED },
+            select: { id: true, conversationId: true, status: true },
+        });
+        logger.info('AI message marked as failed', {
+            messageId: updated.id,
+            conversationId: updated.conversationId,
+            reason: options.reason,
+        });
+        try {
+            await pusher.trigger(chatChannel(updated.conversationId), 'message-updated', {
+                id: updated.id,
+                conversationId: updated.conversationId,
+                status: updated.status,
+            });
+        }
+        catch (broadcastError) {
+            logger.error('Failed to broadcast failed AI message:', {
+                error: broadcastError,
+                messageId,
+            });
+        }
+    }
+    catch (error) {
+        logger.error('Failed to mark AI message as failed:', {
+            error,
+            messageId,
+            reason: options.reason,
+        });
+    }
+}
 /** Responses API user parts use `type: "input_*"`; chat completions use `text` / `image_url` / etc. */
 function isResponseInputWithInputParts(content) {
     if (!Array.isArray(content))
@@ -304,4 +469,4 @@ export function estimateTokenCount(text) {
     return Math.ceil(text.length / 4);
 }
 //# sourceMappingURL=inference.js.map
-//# debugId=621b1d59-2865-5a51-8bea-88c27023731f
+//# debugId=7fa949f6-b6c7-5f82-bc61-5de02fa8f775