@studious-lms/server 1.23.0 → 1.24.0

package/dist/services/studentImport.js

@@ -0,0 +1,236 @@
+/**
+ * C3: Bulk student CSV onboarding under school admin.
+ *
+ * CSV columns (header row required):
+ *   displayName, username?, email?, password?, classId?
+ *
+ * Username/password are generated when omitted. Email is optional — a
+ * placeholder local-part is used so the User.email uniqueness constraint holds.
+ */
+
+!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]="ce1c4284-8c8b-5ddd-bed4-ff674956801e")}catch(e){}}();
+import { randomBytes } from "crypto";
+import { hash } from "bcryptjs";
+import { TRPCError } from "@trpc/server";
+import { prisma } from "../lib/prisma.js";
+import { createUser, findUserByEmail, findUserByUsername } from "../models/auth.js";
+import { findActiveSchoolAdminMembership, upsertSchoolMembership } from "../models/school.js";
+import { upsertUserProfile } from "../models/user.js";
+import { generateUniqueUsername } from "../utils/generateUsername.js";
+function parseCsvLine(line) {
+    const cells = [];
+    let current = "";
+    let inQuotes = false;
+    for (let i = 0; i < line.length; i += 1) {
+        const ch = line[i];
+        if (inQuotes) {
+            if (ch === '"') {
+                if (line[i + 1] === '"') {
+                    current += '"';
+                    i += 1;
+                }
+                else {
+                    inQuotes = false;
+                }
+            }
+            else {
+                current += ch;
+            }
+        }
+        else if (ch === '"') {
+            inQuotes = true;
+        }
+        else if (ch === ",") {
+            cells.push(current.trim());
+            current = "";
+        }
+        else {
+            current += ch;
+        }
+    }
+    cells.push(current.trim());
+    return cells;
+}
+function normalizeHeader(h) {
+    return h.trim().toLowerCase().replace(/[\s_]+/g, "");
+}
+function generatePassword(length = 12) {
+    const alphabet = "ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz23456789";
+    const bytes = randomBytes(length);
+    let out = "";
+    for (let i = 0; i < length; i += 1) {
+        out += alphabet[bytes[i] % alphabet.length];
+    }
+    return out;
+}
+function placeholderEmail(username) {
+    const safe = username.toLowerCase().replace(/[^a-z0-9._-]/g, "");
+    return `${safe || "student"}.${randomBytes(3).toString("hex")}@noemail.studious.local`;
+}
+export function parseStudentCsv(csvText) {
+    const lines = csvText
+        .replace(/^\uFEFF/, "")
+        .split(/\r?\n/)
+        .map((l) => l.trim())
+        .filter((l) => l.length > 0);
+    if (lines.length < 2) {
+        throw new TRPCError({
+            code: "BAD_REQUEST",
+            message: "CSV must include a header row and at least one data row",
+        });
+    }
+    const headers = parseCsvLine(lines[0]).map(normalizeHeader);
+    const rows = lines.slice(1).map((line) => {
+        const cells = parseCsvLine(line);
+        const row = {};
+        headers.forEach((h, i) => {
+            row[h] = cells[i] ?? "";
+        });
+        return row;
+    });
+    return { headers, rows };
+}
+export async function importStudentsCsv(userId, input) {
+    const membership = await findActiveSchoolAdminMembership(input.schoolId, userId);
+    if (!membership) {
+        throw new TRPCError({
+            code: "FORBIDDEN",
+            message: "Only school admins can perform this action",
+        });
+    }
+    const { rows } = parseStudentCsv(input.csvText);
+    if (rows.length > 500) {
+        throw new TRPCError({
+            code: "BAD_REQUEST",
+            message: "CSV import is limited to 500 rows per request",
+        });
+    }
+    const results = [];
+    let created = 0;
+    let failed = 0;
+    for (let i = 0; i < rows.length; i += 1) {
+        const rowNum = i + 2; // 1-indexed + header
+        const row = rows[i];
+        const displayName = row.displayname || row.name || row.fullname || row.fullname || "";
+        const requestedUsername = row.username || "";
+        const requestedEmail = (row.email || "").toLowerCase();
+        const requestedPassword = row.password || "";
+        const classId = row.classid || row.class || "";
+        try {
+            if (!displayName && !requestedUsername && !requestedEmail) {
+                throw new Error("Row needs displayName, username, or email");
+            }
+            let username = requestedUsername;
+            let generatedUsername = false;
+            if (!username) {
+                username = await generateUniqueUsername(async (candidate) => {
+                    const existing = await findUserByUsername(candidate);
+                    return Boolean(existing);
+                });
+                generatedUsername = true;
+            }
+            else {
+                const taken = await findUserByUsername(username);
+                if (taken) {
+                    throw new Error(`Username "${username}" already taken`);
+                }
+            }
+            let email = requestedEmail;
+            let placeholderEmailUsed = false;
+            if (!email) {
+                email = placeholderEmail(username);
+                placeholderEmailUsed = true;
+            }
+            else {
+                const existing = await findUserByEmail(email);
+                if (existing) {
+                    throw new Error(`Email "${email}" already in use`);
+                }
+            }
+            let password = requestedPassword;
+            let generatedPassword = false;
+            if (!password) {
+                password = generatePassword();
+                generatedPassword = true;
+            }
+            if (classId) {
+                const cls = await prisma.class.findFirst({
+                    where: { id: classId, schoolId: input.schoolId },
+                    select: { id: true },
+                });
+                if (!cls) {
+                    throw new Error(`classId "${classId}" not found in this school`);
+                }
+            }
+            if (input.dryRun) {
+                results.push({
+                    ok: true,
+                    row: rowNum,
+                    userId: "dry-run",
+                    username,
+                    email,
+                    password,
+                    displayName: displayName || null,
+                    classId: classId || null,
+                    generatedUsername,
+                    generatedPassword,
+                    placeholderEmail: placeholderEmailUsed,
+                });
+                created += 1;
+                continue;
+            }
+            const hashed = await hash(password, 10);
+            const user = await createUser({
+                username,
+                email,
+                password: hashed,
+                verified: true,
+            });
+            if (displayName) {
+                await upsertUserProfile(user.id, { displayName });
+            }
+            await upsertSchoolMembership({
+                schoolId: input.schoolId,
+                userId: user.id,
+                role: "STUDENT",
+            });
+            if (classId) {
+                await prisma.class.update({
+                    where: { id: classId },
+                    data: { students: { connect: { id: user.id } } },
+                });
+            }
+            results.push({
+                ok: true,
+                row: rowNum,
+                userId: user.id,
+                username: user.username,
+                email: user.email,
+                password,
+                displayName: displayName || null,
+                classId: classId || null,
+                generatedUsername,
+                generatedPassword,
+                placeholderEmail: placeholderEmailUsed,
+            });
+            created += 1;
+        }
+        catch (err) {
+            failed += 1;
+            results.push({
+                ok: false,
+                row: rowNum,
+                error: err instanceof Error ? err.message : "Unknown error",
+            });
+        }
+    }
+    return {
+        dryRun: Boolean(input.dryRun),
+        created,
+        failed,
+        total: rows.length,
+        results,
+    };
+}
+//# sourceMappingURL=studentImport.js.map
+//# debugId=ce1c4284-8c8b-5ddd-bed4-ff674956801e

package/dist/services/studentImport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"studentImport.js","sources":["services/studentImport.ts"],"sourceRoot":"/","sourcesContent":["/**\n * C3: Bulk student CSV onboarding under school admin.\n *\n * CSV columns (header row required):\n *   displayName, username?, email?, password?, classId?\n *\n * Username/password are generated when omitted. Email is optional — a\n * placeholder local-part is used so the User.email uniqueness constraint holds.\n */\nimport { randomBytes } from \"crypto\";\nimport { hash } from \"bcryptjs\";\nimport { TRPCError } from \"@trpc/server\";\nimport { prisma } from \"../lib/prisma.js\";\nimport { createUser, findUserByEmail, findUserByUsername } from \"../models/auth.js\";\nimport { findActiveSchoolAdminMembership, upsertSchoolMembership } from \"../models/school.js\";\nimport { upsertUserProfile } from \"../models/user.js\";\nimport { generateUniqueUsername } from \"../utils/generateUsername.js\";\n\nexport type StudentCsvRowResult =\n  | {\n      ok: true;\n      row: number;\n      userId: string;\n      username: string;\n      email: string;\n      password: string;\n      displayName: string | null;\n      classId: string | null;\n      generatedUsername: boolean;\n      generatedPassword: boolean;\n      placeholderEmail: boolean;\n    }\n  | {\n      ok: false;\n      row: number;\n      error: string;\n      raw?: string;\n    };\n\nfunction parseCsvLine(line: string): string[] {\n  const cells: string[] = [];\n  let current = \"\";\n  let inQuotes = false;\n  for (let i = 0; i < line.length; i += 1) {\n    const ch = line[i];\n    if (inQuotes) {\n      if (ch === '\"') {\n        if (line[i + 1] === '\"') {\n          current += '\"';\n          i += 1;\n        } else {\n          inQuotes = false;\n        }\n      } else {\n        current += ch;\n      }\n    } else if (ch === '\"') {\n      inQuotes = true;\n    } else if (ch === \",\") {\n      cells.push(current.trim());\n      current = \"\";\n    } else {\n      current += ch;\n    }\n  }\n  cells.push(current.trim());\n  return cells;\n}\n\nfunction normalizeHeader(h: string) {\n  return h.trim().toLowerCase().replace(/[\\s_]+/g, \"\");\n}\n\nfunction generatePassword(length = 12) {\n  const alphabet = \"ABCDEFGHJKLMNPQRSTUVWXYZabcdefghijkmnopqrstuvwxyz23456789\";\n  const bytes = randomBytes(length);\n  let out = \"\";\n  for (let i = 0; i < length; i += 1) {\n    out += alphabet[bytes[i]! % alphabet.length];\n  }\n  return out;\n}\n\nfunction placeholderEmail(username: string) {\n  const safe = username.toLowerCase().replace(/[^a-z0-9._-]/g, \"\");\n  return `${safe || \"student\"}.${randomBytes(3).toString(\"hex\")}@noemail.studious.local`;\n}\n\nexport function parseStudentCsv(csvText: string): {\n  headers: string[];\n  rows: Record<string, string>[];\n} {\n  const lines = csvText\n    .replace(/^\\uFEFF/, \"\")\n    .split(/\\r?\\n/)\n    .map((l) => l.trim())\n    .filter((l) => l.length > 0);\n  if (lines.length < 2) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"CSV must include a header row and at least one data row\",\n    });\n  }\n  const headers = parseCsvLine(lines[0]!).map(normalizeHeader);\n  const rows = lines.slice(1).map((line) => {\n    const cells = parseCsvLine(line);\n    const row: Record<string, string> = {};\n    headers.forEach((h, i) => {\n      row[h] = cells[i] ?? \"\";\n    });\n    return row;\n  });\n  return { headers, rows };\n}\n\nexport async function importStudentsCsv(\n  userId: string,\n  input: { schoolId: string; csvText: string; dryRun?: boolean }\n) {\n  const membership = await findActiveSchoolAdminMembership(input.schoolId, userId);\n  if (!membership) {\n    throw new TRPCError({\n      code: \"FORBIDDEN\",\n      message: \"Only school admins can perform this action\",\n    });\n  }\n\n  const { rows } = parseStudentCsv(input.csvText);\n  if (rows.length > 500) {\n    throw new TRPCError({\n      code: \"BAD_REQUEST\",\n      message: \"CSV import is limited to 500 rows per request\",\n    });\n  }\n\n  const results: StudentCsvRowResult[] = [];\n  let created = 0;\n  let failed = 0;\n\n  for (let i = 0; i < rows.length; i += 1) {\n    const rowNum = i + 2; // 1-indexed + header\n    const row = rows[i]!;\n    const displayName =\n      row.displayname || row.name || row.fullname || row.fullname || \"\";\n    const requestedUsername = row.username || \"\";\n    const requestedEmail = (row.email || \"\").toLowerCase();\n    const requestedPassword = row.password || \"\";\n    const classId = row.classid || row.class || \"\";\n\n    try {\n      if (!displayName && !requestedUsername && !requestedEmail) {\n        throw new Error(\"Row needs displayName, username, or email\");\n      }\n\n      let username = requestedUsername;\n      let generatedUsername = false;\n      if (!username) {\n        username = await generateUniqueUsername(async (candidate) => {\n          const existing = await findUserByUsername(candidate);\n          return Boolean(existing);\n        });\n        generatedUsername = true;\n      } else {\n        const taken = await findUserByUsername(username);\n        if (taken) {\n          throw new Error(`Username \"${username}\" already taken`);\n        }\n      }\n\n      let email = requestedEmail;\n      let placeholderEmailUsed = false;\n      if (!email) {\n        email = placeholderEmail(username);\n        placeholderEmailUsed = true;\n      } else {\n        const existing = await findUserByEmail(email);\n        if (existing) {\n          throw new Error(`Email \"${email}\" already in use`);\n        }\n      }\n\n      let password = requestedPassword;\n      let generatedPassword = false;\n      if (!password) {\n        password = generatePassword();\n        generatedPassword = true;\n      }\n\n      if (classId) {\n        const cls = await prisma.class.findFirst({\n          where: { id: classId, schoolId: input.schoolId },\n          select: { id: true },\n        });\n        if (!cls) {\n          throw new Error(`classId \"${classId}\" not found in this school`);\n        }\n      }\n\n      if (input.dryRun) {\n        results.push({\n          ok: true,\n          row: rowNum,\n          userId: \"dry-run\",\n          username,\n          email,\n          password,\n          displayName: displayName || null,\n          classId: classId || null,\n          generatedUsername,\n          generatedPassword,\n          placeholderEmail: placeholderEmailUsed,\n        });\n        created += 1;\n        continue;\n      }\n\n      const hashed = await hash(password, 10);\n      const user = await createUser({\n        username,\n        email,\n        password: hashed,\n        verified: true,\n      });\n\n      if (displayName) {\n        await upsertUserProfile(user.id, { displayName });\n      }\n\n      await upsertSchoolMembership({\n        schoolId: input.schoolId,\n        userId: user.id,\n        role: \"STUDENT\",\n      });\n\n      if (classId) {\n        await prisma.class.update({\n          where: { id: classId },\n          data: { students: { connect: { id: user.id } } },\n        });\n      }\n\n      results.push({\n        ok: true,\n        row: rowNum,\n        userId: user.id,\n        username: user.username,\n        email: user.email,\n        password,\n        displayName: displayName || null,\n        classId: classId || null,\n        generatedUsername,\n        generatedPassword,\n        placeholderEmail: placeholderEmailUsed,\n      });\n      created += 1;\n    } catch (err) {\n      failed += 1;\n      results.push({\n        ok: false,\n        row: rowNum,\n        error: err instanceof Error ? err.message : \"Unknown error\",\n      });\n    }\n  }\n\n  return {\n    dryRun: Boolean(input.dryRun),\n    created,\n    failed,\n    total: rows.length,\n    results,\n  };\n}\n"],"names":[],"mappings":"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","debug_id":"ce1c4284-8c8b-5ddd-bed4-ff674956801e"}

package/dist/services/transcript.d.ts

@@ -0,0 +1,61 @@
+/**
+ * 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.
+ */
+import { type TranscriptReportVariant } from "../lib/transcriptPdf.js";
+export interface GenerateTranscriptInput {
+    schoolId: string;
+    studentId: string;
+    from?: Date;
+    to?: Date;
+    /**
+     * Free-text school year label (e.g. "2082 BS", "2025–2026").
+     * Prefer AcademicTerm (C1) once available.
+     */
+    schoolYear?: string;
+}
+export declare function generateTranscript(userId: string, input: GenerateTranscriptInput): Promise<{
+    pdfBase64: string;
+    fileName: string;
+    variant: TranscriptReportVariant;
+    studentId: string;
+    studentName: string;
+    /** C1 blocker: AcademicTerm model does not exist yet. */
+    academicTermSupported: false;
+    attendance: import("./attendanceRate.js").AttendanceRateSummary;
+    classCount: number;
+}>;
+export declare function generateTranscripts(userId: string, input: {
+    schoolId: string;
+    studentIds: string[];
+    from?: Date;
+    to?: Date;
+    schoolYear?: string;
+}): Promise<{
+    transcripts: {
+        pdfBase64: string;
+        fileName: string;
+        variant: TranscriptReportVariant;
+        studentId: string;
+        studentName: string;
+        /** C1 blocker: AcademicTerm model does not exist yet. */
+        academicTermSupported: false;
+        attendance: import("./attendanceRate.js").AttendanceRateSummary;
+        classCount: number;
+    }[];
+    errors: {
+        studentId: string;
+        message: string;
+    }[];
+}>;
+//# sourceMappingURL=transcript.d.ts.map

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"}