@studious-lms/server 1.22.0 → 1.24.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.d.ts","sourceRoot":"/","sources":["services/transcript.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAKH,OAAO,EAIL,KAAK,uBAAuB,EAC7B,MAAM,yBAAyB,CAAC;AAUjC,MAAM,WAAW,uBAAuB;IACtC,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,EAAE,CAAC,EAAE,IAAI,CAAC;IACV;;;OAGG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAkID,wBAAsB,kBAAkB,CACtC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,uBAAuB;;;;;;IAoF5B,yDAAyD;;;;GAK5D;AAED,wBAAsB,mBAAmB,CACvC,MAAM,EAAE,MAAM,EACd,KAAK,EAAE;IACL,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,IAAI,CAAC,EAAE,IAAI,CAAC;IACZ,EAAE,CAAC,EAAE,IAAI,CAAC;IACV,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;;;;;;;QAfC,yDAAyD;;;;;;mBA6BhC,MAAM;iBAAW,MAAM;;GAwBnD"}

package/dist/services/transcript.js

@@ -0,0 +1,243 @@
+/**
+ * School-admin branded transcripts / progress reports (A4 — Nepal pilot).
+ *
+ * Aggregates per-class gradebook grades + grading boundaries + attendance %
+ * into a pdf-lib PDF. Branding: school name + logo (letterhead optional when
+ * present on School; schema does not include it yet — do not block).
+ *
+ * AcademicTerm (C1) is not modelled yet — accept `from`/`to` date range and/or
+ * a free-text `schoolYear` string for the report header.
+ *
+ * Attendance is read via the existing present/late/absent M2M lists only
+ * (same shaping as getStudentTimeline). Do not conflict with A1 Attendance
+ * refactor — rate math lives in attendanceRate.ts.
+ */
+
+!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]="c7eb65fe-e18f-5b5b-9897-ce16dc61c93d")}catch(e){}}();
+import { TRPCError } from "@trpc/server";
+import { prisma } from "../lib/prisma.js";
+import { bucket } from "../lib/googleCloudStorage.js";
+import { buildTranscriptPdf, isLevelBasedBoundary, } from "../lib/transcriptPdf.js";
+import { findActiveSchoolAdminMembership, getSchoolById, } from "../models/school.js";
+import { computeAttendanceRate } from "./attendanceRate.js";
+import { computeStudentGradeInClass } from "./gradebook.js";
+const MAX_BULK = 50;
+async function requireSchoolAdmin(schoolId, userId) {
+    const membership = await findActiveSchoolAdminMembership(schoolId, userId);
+    if (!membership) {
+        throw new TRPCError({
+            code: "FORBIDDEN",
+            message: "Only school admins can generate transcripts",
+        });
+    }
+    return membership;
+}
+async function loadFileBytes(path) {
+    if (!path)
+        return null;
+    try {
+        const [bytes] = await bucket.file(path).download();
+        return new Uint8Array(bytes);
+    }
+    catch {
+        return null;
+    }
+}
+function formatPeriodLabel(from, to) {
+    if (!from && !to)
+        return null;
+    const fmt = (d) => d.toISOString().slice(0, 10);
+    if (from && to)
+        return `${fmt(from)} – ${fmt(to)}`;
+    if (from)
+        return `From ${fmt(from)}`;
+    return `Through ${fmt(to)}`;
+}
+function slugify(value) {
+    return value
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-|-$/g, "")
+        .slice(0, 48);
+}
+async function fetchStudentAttendance(studentId, from, to) {
+    const range = {
+        ...(from ? { gte: from } : {}),
+        ...(to ? { lte: to } : {}),
+    };
+    const hasRange = Object.keys(range).length > 0;
+    // Same M2M present/late/absent read path as getStudentTimeline (A1-safe).
+    const attendance = await prisma.attendance.findMany({
+        where: {
+            OR: [
+                { present: { some: { id: studentId } } },
+                { late: { some: { id: studentId } } },
+                { absent: { some: { id: studentId } } },
+            ],
+            ...(hasRange ? { date: range } : {}),
+        },
+        select: {
+            id: true,
+            present: { where: { id: studentId }, select: { id: true } },
+            late: { where: { id: studentId }, select: { id: true } },
+            absent: { where: { id: studentId }, select: { id: true } },
+        },
+    });
+    return attendance.map((record) => ({
+        status: record.present.length
+            ? "PRESENT"
+            : record.late.length
+                ? "LATE"
+                : "ABSENT",
+    }));
+}
+async function buildClassRows(schoolId, studentId) {
+    const classes = await prisma.class.findMany({
+        where: {
+            schoolId,
+            students: { some: { id: studentId } },
+        },
+        select: {
+            id: true,
+            name: true,
+            subject: true,
+            section: true,
+        },
+        orderBy: [{ subject: "asc" }, { name: "asc" }],
+    });
+    const rows = [];
+    let levelVotes = 0;
+    let letterVotes = 0;
+    for (const cls of classes) {
+        const grade = await computeStudentGradeInClass(cls.id, studentId);
+        if (!grade)
+            continue;
+        if (isLevelBasedBoundary(grade.gradingBoundary?.structured)) {
+            levelVotes += 1;
+        }
+        else if (grade.gradingBoundary) {
+            letterVotes += 1;
+        }
+        rows.push({
+            className: cls.name,
+            subject: cls.subject,
+            section: cls.section,
+            percentage: grade.result.percentage,
+            gradeLabel: grade.letterGrade,
+            categorySummaries: grade.result.categories.map((c) => ({
+                name: c.name,
+                average: c.average,
+            })),
+        });
+    }
+    const variant = levelVotes > 0 && levelVotes >= letterVotes ? "level" : "letter";
+    return { rows, variant };
+}
+export async function generateTranscript(userId, input) {
+    await requireSchoolAdmin(input.schoolId, userId);
+    const school = await getSchoolById(input.schoolId);
+    if (!school) {
+        throw new TRPCError({ code: "NOT_FOUND", message: "School not found" });
+    }
+    const membership = await prisma.schoolMembership.findFirst({
+        where: {
+            schoolId: input.schoolId,
+            userId: input.studentId,
+            status: "ACTIVE",
+            role: "STUDENT",
+        },
+        select: {
+            user: {
+                select: {
+                    id: true,
+                    username: true,
+                    profile: { select: { displayName: true } },
+                },
+            },
+        },
+    });
+    if (!membership) {
+        throw new TRPCError({
+            code: "NOT_FOUND",
+            message: "Student is not an active student in this school",
+        });
+    }
+    const studentName = membership.user.profile?.displayName || membership.user.username;
+    const [{ rows, variant }, attendanceStatuses, logoBytes] = await Promise.all([
+        buildClassRows(input.schoolId, input.studentId),
+        fetchStudentAttendance(input.studentId, input.from, input.to),
+        loadFileBytes(school.logo?.path),
+    ]);
+    // Soft letterhead support when schema later adds it — never required.
+    const schoolAny = school;
+    const letterheadPath = schoolAny.letterhead?.path ?? schoolAny.letterheadPath ?? null;
+    const letterheadType = schoolAny.letterhead?.type ?? schoolAny.letterheadType ?? null;
+    const letterheadBytes = await loadFileBytes(letterheadPath);
+    const attendance = computeAttendanceRate(attendanceStatuses);
+    const generatedAt = new Date();
+    const pdfBytes = await buildTranscriptPdf({
+        schoolName: school.name,
+        studentName,
+        studentUsername: membership.user.username,
+        schoolYear: input.schoolYear ?? null,
+        periodLabel: formatPeriodLabel(input.from, input.to),
+        variant,
+        classes: rows,
+        attendance,
+        logoBytes,
+        logoContentType: school.logo?.type ?? null,
+        letterheadBytes,
+        letterheadContentType: letterheadType,
+        generatedAt,
+    });
+    const yearSlug = input.schoolYear
+        ? slugify(input.schoolYear)
+        : generatedAt.toISOString().slice(0, 10);
+    const fileName = `progress-report-${slugify(studentName) || membership.user.username}-${yearSlug}.pdf`;
+    return {
+        pdfBase64: Buffer.from(pdfBytes).toString("base64"),
+        fileName,
+        variant,
+        studentId: input.studentId,
+        studentName,
+        /** C1 blocker: AcademicTerm model does not exist yet. */
+        academicTermSupported: false,
+        attendance,
+        classCount: rows.length,
+    };
+}
+export async function generateTranscripts(userId, input) {
+    await requireSchoolAdmin(input.schoolId, userId);
+    const uniqueIds = [...new Set(input.studentIds)].slice(0, MAX_BULK);
+    if (uniqueIds.length === 0) {
+        throw new TRPCError({
+            code: "BAD_REQUEST",
+            message: "Select at least one student",
+        });
+    }
+    const results = [];
+    const errors = [];
+    for (const studentId of uniqueIds) {
+        try {
+            const result = await generateTranscript(userId, {
+                schoolId: input.schoolId,
+                studentId,
+                from: input.from,
+                to: input.to,
+                schoolYear: input.schoolYear,
+            });
+            results.push(result);
+        }
+        catch (error) {
+            const message = error instanceof TRPCError
+                ? error.message
+                : error instanceof Error
+                    ? error.message
+                    : "Failed to generate transcript";
+            errors.push({ studentId, message });
+        }
+    }
+    return { transcripts: results, errors };
+}
+//# sourceMappingURL=transcript.js.map
+//# debugId=c7eb65fe-e18f-5b5b-9897-ce16dc61c93d

package/dist/services/transcript.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transcript.js","sources":["services/transcript.ts"],"sourceRoot":"/","sourcesContent":["/**\n * School-admin branded transcripts / progress reports (A4 — Nepal pilot).\n *\n * Aggregates per-class gradebook grades + grading boundaries + attendance %\n * into a pdf-lib PDF. Branding: school name + logo (letterhead optional when\n * present on School; schema does not include it yet — do not block).\n *\n * AcademicTerm (C1) is not modelled yet — accept `from`/`to` date range and/or\n * a free-text `schoolYear` string for the report header.\n *\n * Attendance is read via the existing present/late/absent M2M lists only\n * (same shaping as getStudentTimeline). Do not conflict with A1 Attendance\n * refactor — rate math lives in attendanceRate.ts.\n */\n\nimport { TRPCError } from \"@trpc/server\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { bucket } from \"../lib/googleCloudStorage.js\";\nimport {\n  buildTranscriptPdf,\n  isLevelBasedBoundary,\n  type TranscriptClassRow,\n  type TranscriptReportVariant,\n} from \"../lib/transcriptPdf.js\";\nimport {\n  findActiveSchoolAdminMembership,\n  getSchoolById,\n} from \"../models/school.js\";\nimport { computeAttendanceRate } from \"./attendanceRate.js\";\nimport { computeStudentGradeInClass } from \"./gradebook.js\";\n\nconst MAX_BULK = 50;\n\nexport interface GenerateTranscriptInput {\n  schoolId: string;\n  studentId: string;\n  from?: Date;\n  to?: Date;\n  /**\n   * Free-text school year label (e.g. \"2082 BS\", \"2025–2026\").\n   * Prefer AcademicTerm (C1) once available.\n   */\n  schoolYear?: string;\n}\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 generate transcripts\",\n    });\n  }\n  return membership;\n}\n\nasync function loadFileBytes(\n  path: string | null | undefined\n): Promise<Uint8Array | null> {\n  if (!path) return null;\n  try {\n    const [bytes] = await bucket.file(path).download();\n    return new Uint8Array(bytes);\n  } catch {\n    return null;\n  }\n}\n\nfunction formatPeriodLabel(from?: Date, to?: Date): string | null {\n  if (!from && !to) return null;\n  const fmt = (d: Date) => d.toISOString().slice(0, 10);\n  if (from && to) return `${fmt(from)} – ${fmt(to)}`;\n  if (from) return `From ${fmt(from)}`;\n  return `Through ${fmt(to!)}`;\n}\n\nfunction slugify(value: string): string {\n  return value\n    .toLowerCase()\n    .replace(/[^a-z0-9]+/g, \"-\")\n    .replace(/^-|-$/g, \"\")\n    .slice(0, 48);\n}\n\nasync function fetchStudentAttendance(\n  studentId: string,\n  from?: Date,\n  to?: Date\n) {\n  const range = {\n    ...(from ? { gte: from } : {}),\n    ...(to ? { lte: to } : {}),\n  };\n  const hasRange = Object.keys(range).length > 0;\n\n  // Same M2M present/late/absent read path as getStudentTimeline (A1-safe).\n  const attendance = await prisma.attendance.findMany({\n    where: {\n      OR: [\n        { present: { some: { id: studentId } } },\n        { late: { some: { id: studentId } } },\n        { absent: { some: { id: studentId } } },\n      ],\n      ...(hasRange ? { date: range } : {}),\n    },\n    select: {\n      id: true,\n      present: { where: { id: studentId }, select: { id: true } },\n      late: { where: { id: studentId }, select: { id: true } },\n      absent: { where: { id: studentId }, select: { id: true } },\n    },\n  });\n\n  return attendance.map((record) => ({\n    status: record.present.length\n      ? (\"PRESENT\" as const)\n      : record.late.length\n        ? (\"LATE\" as const)\n        : (\"ABSENT\" as const),\n  }));\n}\n\nasync function buildClassRows(\n  schoolId: string,\n  studentId: string\n): Promise<{ rows: TranscriptClassRow[]; variant: TranscriptReportVariant }> {\n  const classes = await prisma.class.findMany({\n    where: {\n      schoolId,\n      students: { some: { id: studentId } },\n    },\n    select: {\n      id: true,\n      name: true,\n      subject: true,\n      section: true,\n    },\n    orderBy: [{ subject: \"asc\" }, { name: \"asc\" }],\n  });\n\n  const rows: TranscriptClassRow[] = [];\n  let levelVotes = 0;\n  let letterVotes = 0;\n\n  for (const cls of classes) {\n    const grade = await computeStudentGradeInClass(cls.id, studentId);\n    if (!grade) continue;\n\n    if (isLevelBasedBoundary(grade.gradingBoundary?.structured)) {\n      levelVotes += 1;\n    } else if (grade.gradingBoundary) {\n      letterVotes += 1;\n    }\n\n    rows.push({\n      className: cls.name,\n      subject: cls.subject,\n      section: cls.section,\n      percentage: grade.result.percentage,\n      gradeLabel: grade.letterGrade,\n      categorySummaries: grade.result.categories.map((c) => ({\n        name: c.name,\n        average: c.average,\n      })),\n    });\n  }\n\n  const variant: TranscriptReportVariant =\n    levelVotes > 0 && levelVotes >= letterVotes ? \"level\" : \"letter\";\n\n  return { rows, variant };\n}\n\nexport async function generateTranscript(\n  userId: string,\n  input: GenerateTranscriptInput\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n\n  const school = await getSchoolById(input.schoolId);\n  if (!school) {\n    throw new TRPCError({ code: \"NOT_FOUND\", message: \"School not found\" });\n  }\n\n  const membership = await prisma.schoolMembership.findFirst({\n    where: {\n      schoolId: input.schoolId,\n      userId: input.studentId,\n      status: \"ACTIVE\",\n      role: \"STUDENT\",\n    },\n    select: {\n      user: {\n        select: {\n          id: true,\n          username: true,\n          profile: { select: { displayName: true } },\n        },\n      },\n    },\n  });\n  if (!membership) {\n    throw new TRPCError({\n      code: \"NOT_FOUND\",\n      message: \"Student is not an active student in this school\",\n    });\n  }\n\n  const studentName =\n    membership.user.profile?.displayName || membership.user.username;\n\n  const [{ rows, variant }, attendanceStatuses, logoBytes] = await Promise.all([\n    buildClassRows(input.schoolId, input.studentId),\n    fetchStudentAttendance(input.studentId, input.from, input.to),\n    loadFileBytes(school.logo?.path),\n  ]);\n\n  // Soft letterhead support when schema later adds it — never required.\n  const schoolAny = school as {\n    letterhead?: { path?: string | null; type?: string | null } | null;\n    letterheadPath?: string | null;\n    letterheadType?: string | null;\n  };\n  const letterheadPath =\n    schoolAny.letterhead?.path ?? schoolAny.letterheadPath ?? null;\n  const letterheadType =\n    schoolAny.letterhead?.type ?? schoolAny.letterheadType ?? null;\n  const letterheadBytes = await loadFileBytes(letterheadPath);\n\n  const attendance = computeAttendanceRate(attendanceStatuses);\n  const generatedAt = new Date();\n\n  const pdfBytes = await buildTranscriptPdf({\n    schoolName: school.name,\n    studentName,\n    studentUsername: membership.user.username,\n    schoolYear: input.schoolYear ?? null,\n    periodLabel: formatPeriodLabel(input.from, input.to),\n    variant,\n    classes: rows,\n    attendance,\n    logoBytes,\n    logoContentType: school.logo?.type ?? null,\n    letterheadBytes,\n    letterheadContentType: letterheadType,\n    generatedAt,\n  });\n\n  const yearSlug = input.schoolYear\n    ? slugify(input.schoolYear)\n    : generatedAt.toISOString().slice(0, 10);\n  const fileName = `progress-report-${slugify(studentName) || membership.user.username}-${yearSlug}.pdf`;\n\n  return {\n    pdfBase64: Buffer.from(pdfBytes).toString(\"base64\"),\n    fileName,\n    variant,\n    studentId: input.studentId,\n    studentName,\n    /** C1 blocker: AcademicTerm model does not exist yet. */\n    academicTermSupported: false as const,\n    attendance,\n    classCount: rows.length,\n  };\n}\n\nexport async function generateTranscripts(\n  userId: string,\n  input: {\n    schoolId: string;\n    studentIds: string[];\n    from?: Date;\n    to?: Date;\n    schoolYear?: string;\n  }\n) {\n  await requireSchoolAdmin(input.schoolId, userId);\n\n  const uniqueIds = [...new Set(input.studentIds)].slice(0, MAX_BULK);\n  if (uniqueIds.length === 0) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"Select at least one student\",\n    });\n  }\n\n  type TranscriptResult = Awaited<ReturnType<typeof generateTranscript>>;\n  const results: TranscriptResult[] = [];\n  const errors: { studentId: string; message: string }[] = [];\n\n  for (const studentId of uniqueIds) {\n    try {\n      const result = await generateTranscript(userId, {\n        schoolId: input.schoolId,\n        studentId,\n        from: input.from,\n        to: input.to,\n        schoolYear: input.schoolYear,\n      });\n      results.push(result);\n    } catch (error) {\n      const message =\n        error instanceof TRPCError\n          ? error.message\n          : error instanceof Error\n            ? error.message\n            : \"Failed to generate transcript\";\n      errors.push({ studentId, message });\n    }\n  }\n\n  return { transcripts: results, errors };\n}\n"],"names":[],"mappings":"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","debug_id":"c7eb65fe-e18f-5b5b-9897-ce16dc61c93d"}

package/dist/services/worksheet.d.ts

@@ -14,6 +14,7 @@ export declare function getWorksheet(worksheetId: string, userId: string): Promi
         discussionsEnabled: boolean;
         studentsCanCreateDiscussions: boolean;
         studentsCanReply: boolean;
+        sidebarFeatures: Prisma.JsonValue | null;
         treatMissingAsZero: boolean;
         gradeRoundingMode: import(".prisma/client").$Enums.GradeRoundingMode;
     } | null;
@@ -35,6 +36,7 @@ export declare function getWorksheet(worksheetId: string, userId: string): Promi
         worksheetId: string;
         order: number | null;
         answer: string;
+        parentQuestionId: string | null;
     }[];
 } & {
     status: import(".prisma/client").$Enums.JobStatus | null;
@@ -159,6 +161,7 @@ export declare function addQuestionToWorksheet(worksheetId: string, userId: stri
     markScheme?: object;
     type: WorksheetQuestionType;
     order?: number;
+    parentQuestionId?: string | null;
 }): Promise<{
     type: import(".prisma/client").$Enums.WorksheetQuestionType;
     options: Prisma.JsonValue | null;
@@ -171,6 +174,7 @@ export declare function addQuestionToWorksheet(worksheetId: string, userId: stri
     worksheetId: string;
     order: number | null;
     answer: string;
+    parentQuestionId: string | null;
 }>;
 /** A question's full editable state as captured before an AI modifier run. */
 export interface WorksheetQuestionSnapshot {
@@ -199,6 +203,7 @@ export declare function updateWorksheetQuestionRecord(worksheetId: string, quest
     options?: object;
     markScheme?: object;
     type?: WorksheetQuestionType;
+    parentQuestionId?: string | null;
 }): Promise<{
     type: import(".prisma/client").$Enums.WorksheetQuestionType;
     options: Prisma.JsonValue | null;
@@ -211,7 +216,23 @@ export declare function updateWorksheetQuestionRecord(worksheetId: string, quest
     worksheetId: string;
     order: number | null;
     answer: string;
+    parentQuestionId: string | null;
 }>;
+/** Answering statistics for each question — shown in the teacher worksheet editor. */
+export declare function getWorksheetQuestionStats(worksheetId: string, userId: string): Promise<{
+    questionId: string;
+    parentQuestionId: string | null;
+    order: number | null;
+    type: import(".prisma/client").$Enums.WorksheetQuestionType;
+    points: number;
+    promptPreview: string;
+    totalResponses: number;
+    answeredCount: number;
+    submittedCount: number;
+    correctCount: number;
+    averagePoints: number | null;
+    correctRate: number | null;
+}[]>;
 export declare function deleteWorksheetQuestionRecord(worksheetId: string, questionId: string, userId: string): Promise<{
     type: import(".prisma/client").$Enums.WorksheetQuestionType;
     options: Prisma.JsonValue | null;
@@ -224,6 +245,7 @@ export declare function deleteWorksheetQuestionRecord(worksheetId: string, quest
     worksheetId: string;
     order: number | null;
     answer: string;
+    parentQuestionId: string | null;
 }>;
 export declare function getWorksheetSubmission(worksheetId: string, submissionId: string, userId: string): Promise<{
     responses: ({

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,7 +3,7 @@
  * 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]="ca197d66-f140-5936-afe3-f5567f566d05")}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]="8196c4a5-acef-500c-8732-025782486e87")}catch(e){}}();
 import { TRPCError } from "@trpc/server";
 import { JobStatus, Prisma } from "@prisma/client";
 import { prisma } from "../lib/prisma.js";
@@ -221,6 +221,21 @@ export async function addQuestionToWorksheet(worksheetId, userId, data) {
             message: "Only class teachers can modify worksheet questions",
         });
     }
+    if (data.parentQuestionId) {
+        const parent = await findWorksheetQuestionByIdInWorksheet(data.parentQuestionId, worksheetId);
+        if (!parent) {
+            throw new TRPCError({
+                code: "BAD_REQUEST",
+                message: "Parent question not found in this worksheet",
+            });
+        }
+        if (parent.parentQuestionId) {
+            throw new TRPCError({
+                code: "BAD_REQUEST",
+                message: "Subquestions cannot themselves have children",
+            });
+        }
+    }
     return createWorksheetQuestion({
         worksheetId,
         ...data,
@@ -322,8 +337,85 @@ export async function updateWorksheetQuestionRecord(worksheetId, questionId, use
             message: "Only class teachers can update worksheet questions",
         });
     }
+    if (data.parentQuestionId) {
+        if (data.parentQuestionId === questionId) {
+            throw new TRPCError({
+                code: "BAD_REQUEST",
+                message: "A question cannot be its own parent",
+            });
+        }
+        const parent = await findWorksheetQuestionByIdInWorksheet(data.parentQuestionId, worksheetId);
+        if (!parent) {
+            throw new TRPCError({
+                code: "BAD_REQUEST",
+                message: "Parent question not found in this worksheet",
+            });
+        }
+        if (parent.parentQuestionId) {
+            throw new TRPCError({
+                code: "BAD_REQUEST",
+                message: "Subquestions cannot themselves have children",
+            });
+        }
+    }
     return updateWorksheetQuestion(questionId, data);
 }
+/** Answering statistics for each question — shown in the teacher worksheet editor. */
+export async function getWorksheetQuestionStats(worksheetId, userId) {
+    const worksheet = await findWorksheetByIdForTeacher(worksheetId, userId);
+    if (!worksheet) {
+        throw new TRPCError({
+            code: "FORBIDDEN",
+            message: "Only class teachers can view worksheet answering statistics",
+        });
+    }
+    const questions = await prisma.worksheetQuestion.findMany({
+        where: { worksheetId },
+        select: {
+            id: true,
+            parentQuestionId: true,
+            order: true,
+            points: true,
+            question: true,
+            type: true,
+            studentResponses: {
+                select: {
+                    id: true,
+                    isCorrect: true,
+                    points: true,
+                    response: true,
+                    studentWorksheetResponse: {
+                        select: { submitted: true },
+                    },
+                },
+            },
+        },
+        orderBy: { order: "asc" },
+    });
+    return questions.map((q) => {
+        const responses = q.studentResponses;
+        const answered = responses.filter((r) => r.response !== null && r.response !== "");
+        const submitted = responses.filter((r) => r.studentWorksheetResponse?.submitted);
+        const correct = answered.filter((r) => r.isCorrect).length;
+        return {
+            questionId: q.id,
+            parentQuestionId: q.parentQuestionId,
+            order: q.order,
+            type: q.type,
+            points: q.points,
+            promptPreview: q.question.slice(0, 120),
+            totalResponses: responses.length,
+            answeredCount: answered.length,
+            submittedCount: submitted.length,
+            correctCount: correct,
+            averagePoints: answered.length === 0
+                ? null
+                : answered.reduce((sum, r) => sum + (r.points ?? 0), 0) /
+                    answered.length,
+            correctRate: answered.length === 0 ? null : correct / answered.length,
+        };
+    });
+}
 export async function deleteWorksheetQuestionRecord(worksheetId, questionId, userId) {
     const question = await findWorksheetQuestionByIdForTeacher(questionId, userId);
     if (!question || question.worksheetId !== worksheetId) {
@@ -504,4 +596,4 @@ export async function addCommentToResponse(responseId, comment, authorId) {
     });
 }
 //# sourceMappingURL=worksheet.js.map
-//# debugId=ca197d66-f140-5936-afe3-f5567f566d05
+//# debugId=8196c4a5-acef-500c-8732-025782486e87