@studious-lms/server 1.21.0 → 1.22.0

package/dist/services/gradeCalculation.js

@@ -0,0 +1,148 @@
+/**
+ * Grade calculation – pure functions for computing final class grades from
+ * categories, weights, and grade-calculation policies. No I/O; unit-testable.
+ *
+ * Future policies (standards-based grading, etc.) should extend
+ * `GradeCalculationPolicies` and be handled inside `computeFinalGrade` so
+ * callers never need to change.
+ */
+/** Synthetic category used for scores without a category. */
+
+!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]="f05b8c2d-15ff-58b1-b01e-d40dba432326")}catch(e){}}();
+export const DEFAULT_CATEGORY = {
+    id: null,
+    weight: 1,
+    dropLowest: 0,
+};
+export function roundPercentage(value, mode) {
+    switch (mode) {
+        case "HALF_UP":
+            return Math.round(value);
+        case "FLOOR":
+            return Math.floor(value);
+        case "CEILING":
+            return Math.ceil(value);
+        case "NONE":
+        default:
+            return value;
+    }
+}
+function collectCountableScores(scores, policies) {
+    const countable = [];
+    for (const score of scores) {
+        if (score.maxPoints <= 0)
+            continue;
+        if (score.pointsEarned === null) {
+            if (!policies.treatMissingAsZero)
+                continue;
+            countable.push({ percentage: 0, weight: score.weight ?? 1 });
+            continue;
+        }
+        countable.push({
+            percentage: (score.pointsEarned / score.maxPoints) * 100,
+            weight: score.weight ?? 1,
+        });
+    }
+    return countable;
+}
+function averageCategory(countable, dropLowest) {
+    // Always keep at least one score so a category never collapses to null
+    // just because dropLowest >= score count.
+    const dropCount = Math.min(Math.max(dropLowest, 0), countable.length - 1);
+    const kept = dropCount > 0
+        ? [...countable]
+            .sort((a, b) => a.percentage - b.percentage)
+            .slice(dropCount)
+        : countable;
+    const totalWeight = kept.reduce((sum, s) => sum + s.weight, 0);
+    if (kept.length === 0 || totalWeight <= 0) {
+        return { average: null, counted: 0, dropped: 0 };
+    }
+    const weighted = kept.reduce((sum, s) => sum + s.percentage * s.weight, 0);
+    return {
+        average: weighted / totalWeight,
+        counted: kept.length,
+        dropped: dropCount,
+    };
+}
+/**
+ * Computes the final class grade as the weighted average of category
+ * averages. Scores with no category fall into a default category with
+ * weight `DEFAULT_CATEGORY.weight`. Categories without counted scores are
+ * excluded from the weighted average.
+ */
+export function computeFinalGrade(policies, categories, scores, options) {
+    const knownIds = new Set(categories.map((c) => c.id));
+    const byCategory = new Map();
+    for (const score of scores) {
+        const key = score.categoryId !== null && knownIds.has(score.categoryId)
+            ? score.categoryId
+            : null;
+        const bucket = byCategory.get(key);
+        if (bucket) {
+            bucket.push(score);
+        }
+        else {
+            byCategory.set(key, [score]);
+        }
+    }
+    const categoryAverages = [];
+    for (const category of categories) {
+        const countable = collectCountableScores(byCategory.get(category.id) ?? [], policies);
+        const { average, counted, dropped } = averageCategory(countable, category.dropLowest);
+        categoryAverages.push({
+            categoryId: category.id,
+            name: category.name,
+            weight: category.weight,
+            average,
+            countedScores: counted,
+            droppedScores: dropped,
+        });
+    }
+    const uncategorized = byCategory.get(null) ?? [];
+    if (uncategorized.length > 0) {
+        const countable = collectCountableScores(uncategorized, policies);
+        const { average, counted, dropped } = averageCategory(countable, DEFAULT_CATEGORY.dropLowest);
+        categoryAverages.push({
+            categoryId: DEFAULT_CATEGORY.id,
+            name: options?.defaultCategoryName ?? "Uncategorized",
+            weight: DEFAULT_CATEGORY.weight,
+            average,
+            countedScores: counted,
+            droppedScores: dropped,
+        });
+    }
+    const contributing = categoryAverages.filter((c) => c.average !== null && c.weight > 0);
+    const totalWeight = contributing.reduce((sum, c) => sum + c.weight, 0);
+    const percentage = totalWeight > 0
+        ? roundPercentage(contributing.reduce((sum, c) => sum + c.average * c.weight, 0) / totalWeight, policies.roundingMode)
+        : null;
+    return { percentage, categories: categoryAverages };
+}
+/**
+ * Maps a percentage to a letter grade using a GradingBoundary `structured`
+ * JSON payload (`{ boundaries: [{ grade, minPercentage, maxPercentage }] }`).
+ * Returns null when the payload is unparseable or nothing matches.
+ */
+export function resolveLetterGrade(structured, percentage) {
+    let boundaries;
+    try {
+        const parsed = JSON.parse(structured);
+        if (!Array.isArray(parsed.boundaries))
+            return null;
+        boundaries = parsed.boundaries;
+    }
+    catch {
+        return null;
+    }
+    const sorted = [...boundaries].sort((a, b) => b.minPercentage - a.minPercentage);
+    for (const boundary of sorted) {
+        if (typeof boundary.minPercentage === "number" &&
+            percentage >= boundary.minPercentage) {
+            return boundary.grade ?? null;
+        }
+    }
+    return null;
+}
+//# sourceMappingURL=gradeCalculation.js.map
+//# debugId=f05b8c2d-15ff-58b1-b01e-d40dba432326

package/dist/services/gradeCalculation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"gradeCalculation.js","sources":["services/gradeCalculation.ts"],"sourceRoot":"/","sourcesContent":["/**\n * Grade calculation – pure functions for computing final class grades from\n * categories, weights, and grade-calculation policies. No I/O; unit-testable.\n *\n * Future policies (standards-based grading, etc.) should extend\n * `GradeCalculationPolicies` and be handled inside `computeFinalGrade` so\n * callers never need to change.\n */\n\nexport type GradeRoundingMode = \"NONE\" | \"HALF_UP\" | \"FLOOR\" | \"CEILING\";\n\nexport interface GradeCalculationPolicies {\n  /** Count ungraded/missing scores as 0% instead of excluding them. */\n  treatMissingAsZero: boolean;\n  /** How the final percentage is rounded to a whole number. */\n  roundingMode: GradeRoundingMode;\n}\n\nexport interface GradeCategoryInput {\n  id: string;\n  name: string;\n  /** Relative weight of this category toward the final grade. */\n  weight: number;\n  /** Number of lowest-percentage scores dropped within this category. */\n  dropLowest: number;\n}\n\nexport interface ScoreInput {\n  /** Category the score belongs to; null falls into the default category. */\n  categoryId: string | null;\n  /** Points earned; null means missing/ungraded. */\n  pointsEarned: number | null;\n  /** Maximum points for the item; items with maxPoints <= 0 are ignored. */\n  maxPoints: number;\n  /** Relative weight of the item within its category (defaults to 1). */\n  weight?: number;\n}\n\nexport interface CategoryAverage {\n  categoryId: string | null;\n  name: string;\n  weight: number;\n  /** Percentage 0–100, or null when no scores counted. */\n  average: number | null;\n  countedScores: number;\n  droppedScores: number;\n}\n\nexport interface FinalGradeResult {\n  /** Final percentage 0–100 (rounded per policy), or null when no data. */\n  percentage: number | null;\n  categories: CategoryAverage[];\n}\n\n/** Synthetic category used for scores without a category. */\nexport const DEFAULT_CATEGORY = {\n  id: null,\n  weight: 1,\n  dropLowest: 0,\n} as const;\n\nexport function roundPercentage(\n  value: number,\n  mode: GradeRoundingMode\n): number {\n  switch (mode) {\n    case \"HALF_UP\":\n      return Math.round(value);\n    case \"FLOOR\":\n      return Math.floor(value);\n    case \"CEILING\":\n      return Math.ceil(value);\n    case \"NONE\":\n    default:\n      return value;\n  }\n}\n\ninterface CountableScore {\n  percentage: number;\n  weight: number;\n}\n\nfunction collectCountableScores(\n  scores: ScoreInput[],\n  policies: GradeCalculationPolicies\n): CountableScore[] {\n  const countable: CountableScore[] = [];\n  for (const score of scores) {\n    if (score.maxPoints <= 0) continue;\n    if (score.pointsEarned === null) {\n      if (!policies.treatMissingAsZero) continue;\n      countable.push({ percentage: 0, weight: score.weight ?? 1 });\n      continue;\n    }\n    countable.push({\n      percentage: (score.pointsEarned / score.maxPoints) * 100,\n      weight: score.weight ?? 1,\n    });\n  }\n  return countable;\n}\n\nfunction averageCategory(\n  countable: CountableScore[],\n  dropLowest: number\n): { average: number | null; counted: number; dropped: number } {\n  // Always keep at least one score so a category never collapses to null\n  // just because dropLowest >= score count.\n  const dropCount = Math.min(Math.max(dropLowest, 0), countable.length - 1);\n  const kept =\n    dropCount > 0\n      ? [...countable]\n          .sort((a, b) => a.percentage - b.percentage)\n          .slice(dropCount)\n      : countable;\n\n  const totalWeight = kept.reduce((sum, s) => sum + s.weight, 0);\n  if (kept.length === 0 || totalWeight <= 0) {\n    return { average: null, counted: 0, dropped: 0 };\n  }\n\n  const weighted = kept.reduce((sum, s) => sum + s.percentage * s.weight, 0);\n  return {\n    average: weighted / totalWeight,\n    counted: kept.length,\n    dropped: dropCount,\n  };\n}\n\n/**\n * Computes the final class grade as the weighted average of category\n * averages. Scores with no category fall into a default category with\n * weight `DEFAULT_CATEGORY.weight`. Categories without counted scores are\n * excluded from the weighted average.\n */\nexport function computeFinalGrade(\n  policies: GradeCalculationPolicies,\n  categories: GradeCategoryInput[],\n  scores: ScoreInput[],\n  options?: { defaultCategoryName?: string }\n): FinalGradeResult {\n  const knownIds = new Set(categories.map((c) => c.id));\n  const byCategory = new Map<string | null, ScoreInput[]>();\n  for (const score of scores) {\n    const key =\n      score.categoryId !== null && knownIds.has(score.categoryId)\n        ? score.categoryId\n        : null;\n    const bucket = byCategory.get(key);\n    if (bucket) {\n      bucket.push(score);\n    } else {\n      byCategory.set(key, [score]);\n    }\n  }\n\n  const categoryAverages: CategoryAverage[] = [];\n\n  for (const category of categories) {\n    const countable = collectCountableScores(\n      byCategory.get(category.id) ?? [],\n      policies\n    );\n    const { average, counted, dropped } = averageCategory(\n      countable,\n      category.dropLowest\n    );\n    categoryAverages.push({\n      categoryId: category.id,\n      name: category.name,\n      weight: category.weight,\n      average,\n      countedScores: counted,\n      droppedScores: dropped,\n    });\n  }\n\n  const uncategorized = byCategory.get(null) ?? [];\n  if (uncategorized.length > 0) {\n    const countable = collectCountableScores(uncategorized, policies);\n    const { average, counted, dropped } = averageCategory(\n      countable,\n      DEFAULT_CATEGORY.dropLowest\n    );\n    categoryAverages.push({\n      categoryId: DEFAULT_CATEGORY.id,\n      name: options?.defaultCategoryName ?? \"Uncategorized\",\n      weight: DEFAULT_CATEGORY.weight,\n      average,\n      countedScores: counted,\n      droppedScores: dropped,\n    });\n  }\n\n  const contributing = categoryAverages.filter(\n    (c) => c.average !== null && c.weight > 0\n  );\n  const totalWeight = contributing.reduce((sum, c) => sum + c.weight, 0);\n\n  const percentage =\n    totalWeight > 0\n      ? roundPercentage(\n          contributing.reduce(\n            (sum, c) => sum + (c.average as number) * c.weight,\n            0\n          ) / totalWeight,\n          policies.roundingMode\n        )\n      : null;\n\n  return { percentage, categories: categoryAverages };\n}\n\ninterface ParsedBoundary {\n  grade: string;\n  minPercentage: number;\n  maxPercentage: number;\n}\n\n/**\n * Maps a percentage to a letter grade using a GradingBoundary `structured`\n * JSON payload (`{ boundaries: [{ grade, minPercentage, maxPercentage }] }`).\n * Returns null when the payload is unparseable or nothing matches.\n */\nexport function resolveLetterGrade(\n  structured: string,\n  percentage: number\n): string | null {\n  let boundaries: ParsedBoundary[];\n  try {\n    const parsed = JSON.parse(structured) as {\n      boundaries?: ParsedBoundary[];\n    };\n    if (!Array.isArray(parsed.boundaries)) return null;\n    boundaries = parsed.boundaries;\n  } catch {\n    return null;\n  }\n\n  const sorted = [...boundaries].sort(\n    (a, b) => b.minPercentage - a.minPercentage\n  );\n  for (const boundary of sorted) {\n    if (\n      typeof boundary.minPercentage === \"number\" &&\n      percentage >= boundary.minPercentage\n    ) {\n      return boundary.grade ?? null;\n    }\n  }\n  return null;\n}\n"],"names":[],"mappings":"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","debug_id":"f05b8c2d-15ff-58b1-b01e-d40dba432326"}

package/dist/services/gradebook.d.ts

@@ -0,0 +1,197 @@
+/**
+ * Gradebook service – grade categories, custom columns/entries, class
+ * grade-calculation policies, the computed gradebook, and CSV export.
+ *
+ * All grade math lives in `gradeCalculation.ts` (pure, unit-tested); this
+ * service only assembles inputs and persists configuration.
+ */
+import { GradeRoundingMode as PrismaGradeRoundingMode } from "@prisma/client";
+import { type FinalGradeResult } from "./gradeCalculation.js";
+export declare function listGradeCategories(classId: string): Promise<{
+    id: string;
+    name: string;
+    classId: string;
+    weight: number;
+    dropLowest: number;
+    position: number;
+}[]>;
+export declare function createGradeCategory(classId: string, data: {
+    name: string;
+    weight: number;
+    dropLowest?: number;
+    position?: number;
+}): Promise<{
+    id: string;
+    name: string;
+    classId: string;
+    weight: number;
+    dropLowest: number;
+    position: number;
+}>;
+export declare function updateGradeCategory(categoryId: string, classId: string, data: {
+    name?: string;
+    weight?: number;
+    dropLowest?: number;
+    position?: number;
+}): Promise<{
+    id: string;
+    name: string;
+    classId: string;
+    weight: number;
+    dropLowest: number;
+    position: number;
+}>;
+export declare function deleteGradeCategory(categoryId: string, classId: string): Promise<{
+    id: string;
+    name: string;
+    classId: string;
+    weight: number;
+    dropLowest: number;
+    position: number;
+}>;
+export declare function assignAssignmentCategory(classId: string, assignmentId: string, gradeCategoryId: string | null): Promise<{
+    type: import(".prisma/client").$Enums.AssignmentType;
+    id: string;
+    createdAt: Date | null;
+    classId: string;
+    title: string;
+    dueDate: Date;
+    maxGrade: number | null;
+    eventId: string | null;
+    instructions: string;
+    modifiedAt: Date | null;
+    teacherId: string;
+    acceptFiles: boolean;
+    acceptExtendedResponse: boolean;
+    acceptWorksheet: boolean;
+    gradeWithAI: boolean;
+    aiPolicyLevel: number;
+    sectionId: string | null;
+    graded: boolean;
+    weight: number;
+    inProgress: boolean;
+    template: boolean;
+    markSchemeId: string | null;
+    order: number | null;
+    gradingBoundaryId: string | null;
+    gradeCategoryId: string | null;
+}>;
+export declare function listCustomGradeColumns(classId: string): Promise<({
+    entries: {
+        id: string;
+        points: number;
+        studentId: string;
+        note: string | null;
+    }[];
+} & {
+    id: string;
+    name: string;
+    classId: string;
+    gradeCategoryId: string | null;
+    position: number;
+    maxPoints: number;
+})[]>;
+export declare function createCustomGradeColumn(classId: string, data: {
+    name: string;
+    maxPoints: number;
+    gradeCategoryId?: string | null;
+    position?: number;
+}): Promise<{
+    id: string;
+    name: string;
+    classId: string;
+    gradeCategoryId: string | null;
+    position: number;
+    maxPoints: number;
+}>;
+export declare function updateCustomGradeColumn(columnId: string, classId: string, data: {
+    name?: string;
+    maxPoints?: number;
+    gradeCategoryId?: string | null;
+    position?: number;
+}): Promise<{
+    id: string;
+    name: string;
+    classId: string;
+    gradeCategoryId: string | null;
+    position: number;
+    maxPoints: number;
+}>;
+export declare function deleteCustomGradeColumn(columnId: string, classId: string): Promise<{
+    id: string;
+    name: string;
+    classId: string;
+    gradeCategoryId: string | null;
+    position: number;
+    maxPoints: number;
+}>;
+export declare function setCustomGradeEntry(classId: string, columnId: string, studentId: string, points: number | null, note?: string | null): Promise<{
+    id: string;
+    points: number;
+    studentId: string;
+    columnId: string;
+    note: string | null;
+} | null>;
+export declare function getGradePolicies(classId: string): Promise<{
+    id: string;
+    treatMissingAsZero: boolean;
+    gradeRoundingMode: import(".prisma/client").$Enums.GradeRoundingMode;
+}>;
+export declare function updateGradePolicies(classId: string, data: {
+    treatMissingAsZero?: boolean;
+    gradeRoundingMode?: PrismaGradeRoundingMode;
+}): Promise<{
+    id: string;
+    treatMissingAsZero: boolean;
+    gradeRoundingMode: import(".prisma/client").$Enums.GradeRoundingMode;
+}>;
+export interface GradebookStudentRow {
+    studentId: string;
+    studentName: string;
+    assignmentScores: Record<string, number | null>;
+    customScores: Record<string, {
+        points: number | null;
+        note: string | null;
+    }>;
+    result: FinalGradeResult;
+    letterGrade: string | null;
+}
+export declare function getComputedGradebook(classId: string, userId: string): Promise<{
+    policies: {
+        treatMissingAsZero: boolean;
+        roundingMode: import(".prisma/client").$Enums.GradeRoundingMode;
+    };
+    categories: {
+        id: string;
+        name: string;
+        classId: string;
+        weight: number;
+        dropLowest: number;
+        position: number;
+    }[];
+    assignments: {
+        id: string;
+        title: string;
+        maxGrade: number | null;
+        weight: number;
+        gradeCategoryId: string | null;
+        dueDate: Date;
+    }[];
+    customColumns: {
+        id: string;
+        name: string;
+        maxPoints: number;
+        gradeCategoryId: string | null;
+        position: number;
+    }[];
+    gradingBoundary: {
+        id: string;
+        name: string | null;
+        structured: string;
+    };
+    students: GradebookStudentRow[];
+}>;
+export declare function exportGradebookCsv(classId: string, userId: string): Promise<{
+    csv: string;
+}>;
+//# sourceMappingURL=gradebook.d.ts.map

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

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

package/dist/services/gradebook.js

@@ -0,0 +1,263 @@
+
+!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]="2860d786-c6b1-5d9a-b1bd-880c5bef0f51")}catch(e){}}();
+import { TRPCError } from "@trpc/server";
+import { prisma } from "../lib/prisma.js";
+import { isTeacherInClass } from "../models/class.js";
+import { findGradeCategoriesByClassId, findGradeCategory, findCustomGradeColumnsByClassId, findCustomGradeColumn, findClassForGradebook, findClassGradePolicies, } from "../models/gradebook.js";
+import { computeFinalGrade, resolveLetterGrade, } from "./gradeCalculation.js";
+// ===== Categories =====
+export async function listGradeCategories(classId) {
+    return findGradeCategoriesByClassId(classId);
+}
+export async function createGradeCategory(classId, data) {
+    return prisma.gradeCategory.create({
+        data: {
+            classId,
+            name: data.name,
+            weight: data.weight,
+            dropLowest: data.dropLowest ?? 0,
+            position: data.position ?? (await findGradeCategoriesByClassId(classId)).length,
+        },
+    });
+}
+export async function updateGradeCategory(categoryId, classId, data) {
+    const category = await findGradeCategory(categoryId, classId);
+    if (!category) {
+        throw new TRPCError({ code: "NOT_FOUND", message: "Category not found" });
+    }
+    return prisma.gradeCategory.update({
+        where: { id: categoryId },
+        data,
+    });
+}
+export async function deleteGradeCategory(categoryId, classId) {
+    const category = await findGradeCategory(categoryId, classId);
+    if (!category) {
+        throw new TRPCError({ code: "NOT_FOUND", message: "Category not found" });
+    }
+    return prisma.gradeCategory.delete({ where: { id: categoryId } });
+}
+export async function assignAssignmentCategory(classId, assignmentId, gradeCategoryId) {
+    if (gradeCategoryId) {
+        const category = await findGradeCategory(gradeCategoryId, classId);
+        if (!category) {
+            throw new TRPCError({ code: "NOT_FOUND", message: "Category not found" });
+        }
+    }
+    return prisma.assignment.update({
+        where: { id: assignmentId, classId },
+        data: { gradeCategoryId },
+    });
+}
+// ===== Custom columns =====
+export async function listCustomGradeColumns(classId) {
+    return findCustomGradeColumnsByClassId(classId);
+}
+export async function createCustomGradeColumn(classId, data) {
+    if (data.gradeCategoryId) {
+        const category = await findGradeCategory(data.gradeCategoryId, classId);
+        if (!category) {
+            throw new TRPCError({ code: "NOT_FOUND", message: "Category not found" });
+        }
+    }
+    return prisma.customGradeColumn.create({
+        data: {
+            classId,
+            name: data.name,
+            maxPoints: data.maxPoints,
+            gradeCategoryId: data.gradeCategoryId ?? null,
+            position: data.position ?? (await findCustomGradeColumnsByClassId(classId)).length,
+        },
+    });
+}
+export async function updateCustomGradeColumn(columnId, classId, data) {
+    const column = await findCustomGradeColumn(columnId, classId);
+    if (!column) {
+        throw new TRPCError({ code: "NOT_FOUND", message: "Column not found" });
+    }
+    if (data.gradeCategoryId) {
+        const category = await findGradeCategory(data.gradeCategoryId, classId);
+        if (!category) {
+            throw new TRPCError({ code: "NOT_FOUND", message: "Category not found" });
+        }
+    }
+    return prisma.customGradeColumn.update({
+        where: { id: columnId },
+        data,
+    });
+}
+export async function deleteCustomGradeColumn(columnId, classId) {
+    const column = await findCustomGradeColumn(columnId, classId);
+    if (!column) {
+        throw new TRPCError({ code: "NOT_FOUND", message: "Column not found" });
+    }
+    return prisma.customGradeColumn.delete({ where: { id: columnId } });
+}
+export async function setCustomGradeEntry(classId, columnId, studentId, points, note) {
+    const column = await findCustomGradeColumn(columnId, classId);
+    if (!column) {
+        throw new TRPCError({ code: "NOT_FOUND", message: "Column not found" });
+    }
+    if (points === null) {
+        await prisma.customGradeEntry.deleteMany({
+            where: { columnId, studentId },
+        });
+        return null;
+    }
+    return prisma.customGradeEntry.upsert({
+        where: { columnId_studentId: { columnId, studentId } },
+        create: { columnId, studentId, points, note: note ?? null },
+        update: { points, ...(note !== undefined ? { note } : {}) },
+    });
+}
+// ===== Policies =====
+export async function getGradePolicies(classId) {
+    const policies = await findClassGradePolicies(classId);
+    if (!policies) {
+        throw new TRPCError({ code: "NOT_FOUND", message: "Class not found" });
+    }
+    return policies;
+}
+export async function updateGradePolicies(classId, data) {
+    return prisma.class.update({
+        where: { id: classId },
+        data,
+        select: {
+            id: true,
+            treatMissingAsZero: true,
+            gradeRoundingMode: true,
+        },
+    });
+}
+export async function getComputedGradebook(classId, userId) {
+    const [classData, categories, columns, isTeacher] = await Promise.all([
+        findClassForGradebook(classId),
+        findGradeCategoriesByClassId(classId),
+        findCustomGradeColumnsByClassId(classId),
+        isTeacherInClass(classId, userId),
+    ]);
+    if (!classData) {
+        throw new TRPCError({ code: "NOT_FOUND", message: "Class not found" });
+    }
+    // Students only ever see their own row.
+    const students = isTeacher
+        ? classData.students
+        : classData.students.filter((student) => student.id === userId);
+    const policies = {
+        treatMissingAsZero: classData.treatMissingAsZero,
+        roundingMode: classData.gradeRoundingMode,
+    };
+    const categoryInputs = categories.map((category) => ({
+        id: category.id,
+        name: category.name,
+        weight: category.weight,
+        dropLowest: category.dropLowest,
+    }));
+    const boundary = classData.gradingBoundaries[0] ?? null;
+    const rows = students.map((student) => {
+        const assignmentScores = {};
+        const scores = [];
+        for (const assignment of classData.assignments) {
+            const submission = assignment.submissions.find((item) => item.studentId === student.id);
+            const pointsEarned = submission?.gradeReceived ?? null;
+            assignmentScores[assignment.id] = pointsEarned;
+            scores.push({
+                categoryId: assignment.gradeCategoryId,
+                pointsEarned,
+                maxPoints: assignment.maxGrade ?? 0,
+                weight: assignment.weight,
+            });
+        }
+        const customScores = {};
+        for (const column of columns) {
+            const entry = column.entries.find((item) => item.studentId === student.id);
+            customScores[column.id] = {
+                points: entry?.points ?? null,
+                note: entry?.note ?? null,
+            };
+            scores.push({
+                categoryId: column.gradeCategoryId,
+                pointsEarned: entry?.points ?? null,
+                maxPoints: column.maxPoints,
+            });
+        }
+        const result = computeFinalGrade(policies, categoryInputs, scores);
+        const letterGrade = boundary && result.percentage !== null
+            ? resolveLetterGrade(boundary.structured, result.percentage)
+            : null;
+        return {
+            studentId: student.id,
+            studentName: student.profile?.displayName || student.username,
+            assignmentScores,
+            customScores,
+            result,
+            letterGrade,
+        };
+    });
+    return {
+        policies,
+        categories,
+        assignments: classData.assignments.map((assignment) => ({
+            id: assignment.id,
+            title: assignment.title,
+            maxGrade: assignment.maxGrade,
+            weight: assignment.weight,
+            gradeCategoryId: assignment.gradeCategoryId,
+            dueDate: assignment.dueDate,
+        })),
+        customColumns: columns.map((column) => ({
+            id: column.id,
+            name: column.name,
+            maxPoints: column.maxPoints,
+            gradeCategoryId: column.gradeCategoryId,
+            position: column.position,
+        })),
+        gradingBoundary: boundary,
+        students: rows,
+    };
+}
+// ===== CSV export =====
+function escapeCsvCell(value) {
+    if (/[",\n\r]/.test(value)) {
+        return `"${value.replace(/"/g, '""')}"`;
+    }
+    return value;
+}
+export async function exportGradebookCsv(classId, userId) {
+    const gradebook = await getComputedGradebook(classId, userId);
+    const header = [
+        "Student",
+        ...gradebook.assignments.map((assignment) => `${assignment.title} (/${assignment.maxGrade ?? 0})`),
+        ...gradebook.customColumns.map((column) => `${column.name} (/${column.maxPoints})`),
+        ...gradebook.categories.map((category) => `${category.name} Avg (%)`),
+        "Final (%)",
+        "Letter",
+    ];
+    const lines = [header.map(escapeCsvCell).join(",")];
+    for (const row of gradebook.students) {
+        const categoryCells = gradebook.categories.map((category) => {
+            const average = row.result.categories.find((item) => item.categoryId === category.id)?.average;
+            return average === null || average === undefined
+                ? ""
+                : average.toFixed(2);
+        });
+        const cells = [
+            row.studentName,
+            ...gradebook.assignments.map((assignment) => {
+                const points = row.assignmentScores[assignment.id];
+                return points === null || points === undefined ? "" : String(points);
+            }),
+            ...gradebook.customColumns.map((column) => {
+                const points = row.customScores[column.id]?.points;
+                return points === null || points === undefined ? "" : String(points);
+            }),
+            ...categoryCells,
+            row.result.percentage === null ? "" : row.result.percentage.toFixed(2),
+            row.letterGrade ?? "",
+        ];
+        lines.push(cells.map(escapeCsvCell).join(","));
+    }
+    return { csv: lines.join("\n") };
+}
+//# sourceMappingURL=gradebook.js.map
+//# debugId=2860d786-c6b1-5d9a-b1bd-880c5bef0f51