@studious-lms/server 1.23.0 → 1.25.0

package/dist/routers/school.d.ts

@@ -29,6 +29,9 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
                 logoId: string | null;
                 logoPath: string | null;
                 logoType: string | null;
+                letterheadFileId: string | null;
+                letterheadPath: string | null;
+                letterheadType: string | null;
             } | null;
             activeRole: import(".prisma/client").$Enums.SchoolMembershipRole | null;
             memberships: ({
@@ -39,12 +42,19 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
                     name: string;
                     description: string | null;
                     logoId: string | null;
+                    letterheadFileId: string | null;
                     subdomain: string | null;
                     logo: {
                         path: string;
                         type: string;
                         id: string;
                     } | null;
+                    letterhead: {
+                        path: string;
+                        type: string;
+                        id: string;
+                        name: string;
+                    } | null;
                 };
             } & {
                 status: import(".prisma/client").$Enums.SchoolMembershipStatus;
@@ -83,6 +93,7 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
                 name: string;
                 description: string | null;
                 logoId: string | null;
+                letterheadFileId: string | null;
                 subdomain: string | null;
             };
         };
@@ -94,6 +105,7 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
             name?: string | undefined;
             description?: string | null | undefined;
             logoId?: string | null | undefined;
+            letterheadFileId?: string | null | undefined;
             subdomain?: string | null | undefined;
         };
         output: {
@@ -102,6 +114,7 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
                 name: string;
                 description: string | null;
                 logoId: string | null;
+                letterheadFileId: string | null;
                 subdomain: string | null;
             };
         };
@@ -112,7 +125,7 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
             query: string;
             schoolId: string;
             limit?: number | undefined;
-            role?: "ADMIN" | "TEACHER" | "STUDENT" | undefined;
+            role?: "ADMIN" | "TEACHER" | "STUDENT" | "ACCOUNTANT" | "PARENT" | undefined;
         };
         output: {
             id: string;
@@ -209,13 +222,17 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
             }[];
             attendance: {
                 id: string;
+                recordId: string;
                 date: Date;
                 class: {
                     id: string;
                     name: string;
                     color: string | null;
                 };
-                status: "PRESENT" | "LATE" | "ABSENT";
+                status: import(".prisma/client").$Enums.AttendanceStatus;
+                note: string | null;
+                lockedFromExcusal: boolean;
+                reason: string | null;
             }[];
         };
         meta: object;
@@ -276,13 +293,17 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
             }[];
             attendance: {
                 id: string;
+                recordId: string;
                 date: Date;
                 class: {
                     id: string;
                     name: string;
                     color: string | null;
                 };
-                status: "PRESENT" | "LATE" | "ABSENT";
+                status: import(".prisma/client").$Enums.AttendanceStatus;
+                note: string | null;
+                lockedFromExcusal: boolean;
+                reason: string | null;
             }[];
             classes?: undefined;
         } | {
@@ -335,6 +356,8 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
                     ADMIN: number;
                     TEACHER: number;
                     STUDENT: number;
+                    ACCOUNTANT: number;
+                    PARENT: number;
                     classes: number;
                     members: number;
                     pendingInvites: number;
@@ -378,6 +401,251 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
         };
         meta: object;
     }>;
+    /** School-admin: today's attendance rollup across classes. */
+    listTodayAttendanceSummary: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            schoolId: string;
+        };
+        output: {
+            date: Date;
+            totalStudents: number;
+            totals: import("../services/attendanceStats.js").AttendanceStatusCount;
+            percentage: number | null;
+            sessions: {
+                attendanceId: string;
+                classId: string;
+                className: string;
+                section: string;
+                subject: string;
+                eventId: string | null;
+                eventName: string | null;
+                date: Date;
+                present: number;
+                late: number;
+                absent: number;
+                excused: number;
+                unmarked: number;
+                classStudentCount: number;
+            }[];
+        };
+        meta: object;
+    }>;
+    /** School-admin: per-student attendance counts + % (excused excluded from %). */
+    listStudentAttendanceStats: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            schoolId: string;
+            studentId?: string | undefined;
+            from?: Date | undefined;
+            to?: Date | undefined;
+        };
+        output: {
+            studentId: string;
+            username: string;
+            displayName: string | null;
+            profilePicture: string | null;
+            profilePictureThumbnail: string | null;
+            classes: {
+                section: string;
+                id: string;
+                name: string;
+                subject: string;
+            }[];
+            present: number;
+            late: number;
+            absent: number;
+            excused: number;
+            attendancePercentage: number | null;
+        }[];
+        meta: object;
+    }>;
+    listExcusals: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            schoolId: string;
+            studentId?: string | undefined;
+            includeRevoked?: boolean | undefined;
+        };
+        output: {
+            id: string;
+            schoolId: string;
+            startDate: Date;
+            endDate: Date;
+            reason: string;
+            note: string | null;
+            revokedAt: Date | null;
+            createdAt: Date;
+            updatedAt: Date;
+            status: "ACTIVE" | "REVOKED" | "EXPIRED" | "UPCOMING";
+            studentIds: string[];
+            students: {
+                id: string;
+                username: string;
+                displayName: string | null;
+                profilePicture: string | null;
+                profilePictureThumbnail: string | null;
+            }[];
+            createdBy: {
+                id: string;
+                username: string;
+                displayName: string | null;
+            };
+            revokedBy: {
+                id: string;
+                username: string;
+                displayName: string | null;
+            } | null;
+        }[];
+        meta: object;
+    }>;
+    createExcusal: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            reason: string;
+            startDate: Date;
+            endDate: Date;
+            studentIds: string[];
+            note?: string | null | undefined;
+        };
+        output: {
+            students: {
+                student: {
+                    id: string;
+                    username: string;
+                    profile: {
+                        profilePicture: string | null;
+                        displayName: string | null;
+                        profilePictureThumbnail: string | null;
+                    } | null;
+                };
+                studentId: string;
+            }[];
+            createdBy: {
+                id: string;
+                username: string;
+                profile: {
+                    displayName: string | null;
+                } | null;
+            };
+            revokedBy: {
+                id: string;
+                username: string;
+                profile: {
+                    displayName: string | null;
+                } | null;
+            } | null;
+        } & {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            schoolId: string;
+            reason: string;
+            startDate: Date;
+            endDate: Date;
+            createdById: string;
+            revokedAt: Date | null;
+            note: string | null;
+            revokedById: string | null;
+        };
+        meta: object;
+    }>;
+    updateExcusal: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            excusalId: string;
+            reason?: string | undefined;
+            startDate?: Date | undefined;
+            endDate?: Date | undefined;
+            studentIds?: string[] | undefined;
+            note?: string | null | undefined;
+        };
+        output: {
+            students: {
+                student: {
+                    id: string;
+                    username: string;
+                    profile: {
+                        profilePicture: string | null;
+                        displayName: string | null;
+                        profilePictureThumbnail: string | null;
+                    } | null;
+                };
+                studentId: string;
+            }[];
+            createdBy: {
+                id: string;
+                username: string;
+                profile: {
+                    displayName: string | null;
+                } | null;
+            };
+            revokedBy: {
+                id: string;
+                username: string;
+                profile: {
+                    displayName: string | null;
+                } | null;
+            } | null;
+        } & {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            schoolId: string;
+            reason: string;
+            startDate: Date;
+            endDate: Date;
+            createdById: string;
+            revokedAt: Date | null;
+            note: string | null;
+            revokedById: string | null;
+        };
+        meta: object;
+    }>;
+    revokeExcusal: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            excusalId: string;
+        };
+        output: {
+            students: {
+                student: {
+                    id: string;
+                    username: string;
+                    profile: {
+                        profilePicture: string | null;
+                        displayName: string | null;
+                        profilePictureThumbnail: string | null;
+                    } | null;
+                };
+                studentId: string;
+            }[];
+            createdBy: {
+                id: string;
+                username: string;
+                profile: {
+                    displayName: string | null;
+                } | null;
+            };
+            revokedBy: {
+                id: string;
+                username: string;
+                profile: {
+                    displayName: string | null;
+                } | null;
+            } | null;
+        } & {
+            id: string;
+            createdAt: Date;
+            updatedAt: Date;
+            schoolId: string;
+            reason: string;
+            startDate: Date;
+            endDate: Date;
+            createdById: string;
+            revokedAt: Date | null;
+            note: string | null;
+            revokedById: string | null;
+        };
+        meta: object;
+    }>;
     getAiUsage: import("@trpc/server").TRPCQueryProcedure<{
         input: {
             schoolId: string;
@@ -444,6 +712,7 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
                 discussionsEnabled: boolean;
                 studentsCanCreateDiscussions: boolean;
                 studentsCanReply: boolean;
+                sidebarFeatures: import("@prisma/client/runtime/library.js").JsonValue | null;
                 treatMissingAsZero: boolean;
                 gradeRoundingMode: import(".prisma/client").$Enums.GradeRoundingMode;
             })[];
@@ -497,6 +766,7 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
                 discussionsEnabled: boolean;
                 studentsCanCreateDiscussions: boolean;
                 studentsCanReply: boolean;
+                sidebarFeatures: import("@prisma/client/runtime/library.js").JsonValue | null;
                 treatMissingAsZero: boolean;
                 gradeRoundingMode: import(".prisma/client").$Enums.GradeRoundingMode;
             };
@@ -563,7 +833,7 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
     addMember: import("@trpc/server").TRPCMutationProcedure<{
         input: {
             schoolId: string;
-            role: "ADMIN" | "TEACHER" | "STUDENT";
+            role: "ADMIN" | "TEACHER" | "STUDENT" | "ACCOUNTANT" | "PARENT";
             memberUserId: string;
         };
         output: {
@@ -582,7 +852,7 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
     updateMemberRole: import("@trpc/server").TRPCMutationProcedure<{
         input: {
             schoolId: string;
-            role: "ADMIN" | "TEACHER" | "STUDENT";
+            role: "ADMIN" | "TEACHER" | "STUDENT" | "ACCOUNTANT" | "PARENT";
             memberUserId: string;
         };
         output: {
@@ -652,10 +922,65 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
         };
         meta: object;
     }>;
+    /**
+     * Generate a branded transcript / progress-report PDF for one student.
+     * School admin only. Uses gradebook + attendance (present/late/absent).
+     * No AcademicTerm yet — pass schoolYear and/or from/to (C1 dependency).
+     */
+    generateTranscript: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            studentId: string;
+            from?: Date | undefined;
+            to?: Date | undefined;
+            schoolYear?: string | undefined;
+        };
+        output: {
+            pdfBase64: string;
+            fileName: string;
+            variant: import("../lib/transcriptPdf.js").TranscriptReportVariant;
+            studentId: string;
+            studentName: string;
+            academicTermSupported: false;
+            attendance: import("../services/attendanceRate.js").AttendanceRateSummary;
+            classCount: number;
+        };
+        meta: object;
+    }>;
+    /**
+     * Bulk generate transcripts for multiple students (max 50).
+     * Returns per-student PDFs plus any per-student errors.
+     */
+    generateTranscripts: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            studentIds: string[];
+            from?: Date | undefined;
+            to?: Date | undefined;
+            schoolYear?: string | undefined;
+        };
+        output: {
+            transcripts: {
+                pdfBase64: string;
+                fileName: string;
+                variant: import("../lib/transcriptPdf.js").TranscriptReportVariant;
+                studentId: string;
+                studentName: string;
+                academicTermSupported: false;
+                attendance: import("../services/attendanceRate.js").AttendanceRateSummary;
+                classCount: number;
+            }[];
+            errors: {
+                studentId: string;
+                message: string;
+            }[];
+        };
+        meta: object;
+    }>;
     bulkUpdateMemberRoles: import("@trpc/server").TRPCMutationProcedure<{
         input: {
             schoolId: string;
-            role: "ADMIN" | "TEACHER" | "STUDENT";
+            role: "ADMIN" | "TEACHER" | "STUDENT" | "ACCOUNTANT" | "PARENT";
             memberUserIds: string[];
         };
         output: {
@@ -673,6 +998,21 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
         };
         meta: object;
     }>;
+    /** Generate a bulk PDF of front-side student ID cards for selected members. */
+    generateIdCards: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            studentUserIds: string[];
+        };
+        output: {
+            pdfBase64: string;
+            fileName: string;
+            mimeType: "application/pdf";
+            studentCount: number;
+            skippedCount: number;
+        };
+        meta: object;
+    }>;
     listInvites: import("@trpc/server").TRPCQueryProcedure<{
         input: {
             schoolId: string;
@@ -702,7 +1042,7 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
         input: {
             email: string;
             schoolId: string;
-            role: "ADMIN" | "TEACHER" | "STUDENT";
+            role: "ADMIN" | "TEACHER" | "STUDENT" | "ACCOUNTANT" | "PARENT";
             displayName?: string | undefined;
             username?: string | undefined;
         };
@@ -792,5 +1132,21 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
         };
         meta: object;
     }>;
+    /** C3: Bulk student CSV onboarding (username/password generated when omitted). */
+    importStudentsCsv: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            csvText: string;
+            dryRun?: boolean | undefined;
+        };
+        output: {
+            dryRun: boolean;
+            created: number;
+            failed: number;
+            total: number;
+            results: import("../services/studentImport.js").StudentCsvRowResult[];
+        };
+        meta: object;
+    }>;
 }>>;
 //# sourceMappingURL=school.d.ts.map

package/dist/routers/school.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"school.d.ts","sourceRoot":"/","sources":["routers/school.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AA0CxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6OvB,CAAC"}
+{"version":3,"file":"school.d.ts","sourceRoot":"/","sources":["routers/school.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuExB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA6GvB,8DAA8D;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAO9D,iFAAiF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAqIjF;;;;OAIG;;;;;;;;;;;;;;;;;;;;;IAcH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IAiCH,+EAA+E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2C/E,kFAAkF;;;;;;;;;;;;;;;;GAUlF,CAAC"}

package/dist/routers/school.js

@@ -1,13 +1,31 @@
 
-!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]="dbf0db95-caa5-5600-ac0e-7d370691bb74")}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]="e365815a-3112-5d63-972f-390a63a4a409")}catch(e){}}();
 import { z } from "zod";
 import { createTRPCRouter, protectedProcedure, publicProcedure, } from "../trpc.js";
 import { acceptInvite, addMember, bulkRemoveMembers, bulkUpdateMemberRoles, confirmSchoolAssetUpload, createInvite, createSchoolClass, createSchoolRecord, deleteSchoolClass, getAdminOverview, getCurrentSchool, getInvite, getMemberDetail, getMemberTimeline, getSchoolAssetUploadUrl, getStudentTimeline, listClasses, listInvites, listMemberIds, listMembers, removeMember, revokeInvite, searchMembers, updateClassMembers, updateMemberRole, updateSchoolDetails, } from "../services/school.js";
 import { getSchoolAiUsage } from "../services/aiUsage.js";
-const schoolRoleSchema = z.enum(["ADMIN", "TEACHER", "STUDENT"]);
+import { listTodayAttendanceSummary, listStudentAttendanceStats, listExcusals, createExcusal, updateExcusal, revokeExcusal, } from "../services/attendance.js";
+import { generateStudentIdCards } from "../services/idCard.js";
+import { generateTranscript, generateTranscripts, } from "../services/transcript.js";
+import { importStudentsCsv } from "../services/studentImport.js";
+const schoolRoleSchema = z.enum([
+    "ADMIN",
+    "TEACHER",
+    "STUDENT",
+    "ACCOUNTANT",
+    "PARENT",
+]);
 const schoolIdSchema = z.object({
     schoolId: z.string(),
 });
+/** Interim period params until AcademicTerm (C1) exists. */
+const transcriptPeriodSchema = z.object({
+    schoolId: z.string(),
+    from: z.date().optional(),
+    to: z.date().optional(),
+    /** Free-text school year label (e.g. "2082 BS"). Prefer AcademicTerm (C1) later. */
+    schoolYear: z.string().max(64).optional(),
+});
 export const schoolRouter = createTRPCRouter({
     getCurrent: protectedProcedure
         .input(z.object({ schoolId: z.string().optional() }).optional())
@@ -27,6 +45,7 @@ export const schoolRouter = createTRPCRouter({
         description: z.string().nullable().optional(),
         subdomain: z.string().nullable().optional(),
         logoId: z.string().nullable().optional(),
+        letterheadFileId: z.string().nullable().optional(),
     }))
         .mutation(({ ctx, input }) => updateSchoolDetails(ctx.user.id, input)),
     searchMembers: protectedProcedure
@@ -72,6 +91,50 @@ export const schoolRouter = createTRPCRouter({
     getAdminOverview: protectedProcedure
         .input(schoolIdSchema)
         .query(({ ctx, input }) => getAdminOverview(ctx.user.id, input.schoolId)),
+    /** School-admin: today's attendance rollup across classes. */
+    listTodayAttendanceSummary: protectedProcedure
+        .input(schoolIdSchema)
+        .query(({ ctx, input }) => listTodayAttendanceSummary(ctx.user.id, input.schoolId)),
+    /** School-admin: per-student attendance counts + % (excused excluded from %). */
+    listStudentAttendanceStats: protectedProcedure
+        .input(z.object({
+        schoolId: z.string(),
+        from: z.date().optional(),
+        to: z.date().optional(),
+        studentId: z.string().optional(),
+    }))
+        .query(({ ctx, input }) => listStudentAttendanceStats(ctx.user.id, input)),
+    listExcusals: protectedProcedure
+        .input(z.object({
+        schoolId: z.string(),
+        includeRevoked: z.boolean().optional(),
+        studentId: z.string().optional(),
+    }))
+        .query(({ ctx, input }) => listExcusals(ctx.user.id, input)),
+    createExcusal: protectedProcedure
+        .input(z.object({
+        schoolId: z.string(),
+        studentIds: z.array(z.string()).min(1),
+        startDate: z.date(),
+        endDate: z.date(),
+        reason: z.string().min(1),
+        note: z.string().nullable().optional(),
+    }))
+        .mutation(({ ctx, input }) => createExcusal(ctx.user.id, input)),
+    updateExcusal: protectedProcedure
+        .input(z.object({
+        schoolId: z.string(),
+        excusalId: z.string(),
+        studentIds: z.array(z.string()).min(1).optional(),
+        startDate: z.date().optional(),
+        endDate: z.date().optional(),
+        reason: z.string().min(1).optional(),
+        note: z.string().nullable().optional(),
+    }))
+        .mutation(({ ctx, input }) => updateExcusal(ctx.user.id, input)),
+    revokeExcusal: protectedProcedure
+        .input(z.object({ schoolId: z.string(), excusalId: z.string() }))
+        .mutation(({ ctx, input }) => revokeExcusal(ctx.user.id, input)),
     getAiUsage: protectedProcedure
         .input(z.object({
         schoolId: z.string(),
@@ -132,6 +195,35 @@ export const schoolRouter = createTRPCRouter({
     getMemberDetail: protectedProcedure
         .input(z.object({ schoolId: z.string(), memberUserId: z.string() }))
         .query(({ ctx, input }) => getMemberDetail(ctx.user.id, input)),
+    /**
+     * Generate a branded transcript / progress-report PDF for one student.
+     * School admin only. Uses gradebook + attendance (present/late/absent).
+     * No AcademicTerm yet — pass schoolYear and/or from/to (C1 dependency).
+     */
+    generateTranscript: protectedProcedure
+        .input(transcriptPeriodSchema
+        .extend({
+        studentId: z.string(),
+    })
+        .refine((v) => !v.from || !v.to || v.from <= v.to, {
+        message: "from must be on or before to",
+        path: ["from"],
+    }))
+        .mutation(({ ctx, input }) => generateTranscript(ctx.user.id, input)),
+    /**
+     * Bulk generate transcripts for multiple students (max 50).
+     * Returns per-student PDFs plus any per-student errors.
+     */
+    generateTranscripts: protectedProcedure
+        .input(transcriptPeriodSchema
+        .extend({
+        studentIds: z.array(z.string()).min(1).max(50),
+    })
+        .refine((v) => !v.from || !v.to || v.from <= v.to, {
+        message: "from must be on or before to",
+        path: ["from"],
+    }))
+        .mutation(({ ctx, input }) => generateTranscripts(ctx.user.id, input)),
     bulkUpdateMemberRoles: protectedProcedure
         .input(z.object({
         schoolId: z.string(),
@@ -145,6 +237,13 @@ export const schoolRouter = createTRPCRouter({
         memberUserIds: z.array(z.string()).min(1).max(200),
     }))
         .mutation(({ ctx, input }) => bulkRemoveMembers(ctx.user.id, input)),
+    /** Generate a bulk PDF of front-side student ID cards for selected members. */
+    generateIdCards: protectedProcedure
+        .input(z.object({
+        schoolId: z.string(),
+        studentUserIds: z.array(z.string()).min(1).max(100),
+    }))
+        .mutation(({ ctx, input }) => generateStudentIdCards(ctx.user.id, input)),
     listInvites: protectedProcedure
         .input(schoolIdSchema)
         .query(({ ctx, input }) => listInvites(ctx.user.id, input.schoolId)),
@@ -169,6 +268,14 @@ export const schoolRouter = createTRPCRouter({
     acceptInvite: protectedProcedure
         .input(z.object({ token: z.string() }))
         .mutation(({ ctx, input }) => acceptInvite(ctx.user.id, input.token)),
+    /** C3: Bulk student CSV onboarding (username/password generated when omitted). */
+    importStudentsCsv: protectedProcedure
+        .input(z.object({
+        schoolId: z.string(),
+        csvText: z.string().min(1).max(2000000),
+        dryRun: z.boolean().optional(),
+    }))
+        .mutation(({ ctx, input }) => importStudentsCsv(ctx.user.id, input)),
 });
 //# sourceMappingURL=school.js.map
-//# debugId=dbf0db95-caa5-5600-ac0e-7d370691bb74
+//# debugId=e365815a-3112-5d63-972f-390a63a4a409