@studious-lms/server 1.22.0 → 1.24.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;
@@ -357,10 +380,272 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
                     expiresAt: Date;
                     role: import(".prisma/client").$Enums.SchoolMembershipRole;
                 }[];
+                recentMembers: {
+                    status: import(".prisma/client").$Enums.SchoolMembershipStatus;
+                    user: {
+                        id: string;
+                        username: string;
+                        email: string;
+                        profile: {
+                            profilePicture: string | null;
+                            displayName: string | null;
+                            profilePictureThumbnail: string | null;
+                        } | null;
+                    };
+                    id: string;
+                    createdAt: Date;
+                    updatedAt: Date;
+                    role: import(".prisma/client").$Enums.SchoolMembershipRole;
+                }[];
             };
         };
         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" | "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;
@@ -427,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;
             })[];
@@ -480,12 +766,45 @@ 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;
             };
         };
         meta: object;
     }>;
+    deleteClass: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            classId: string;
+        };
+        output: {
+            deletedClass: {
+                id: string;
+            };
+        };
+        meta: object;
+    }>;
+    updateClassMembers: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            classId: string;
+            addTeacherIds?: string[] | undefined;
+            removeTeacherIds?: string[] | undefined;
+            addStudentIds?: string[] | undefined;
+            removeStudentIds?: string[] | undefined;
+        };
+        output: {
+            class: {
+                id: string;
+                _count: {
+                    teachers: number;
+                    students: number;
+                };
+            };
+        };
+        meta: object;
+    }>;
     listMembers: import("@trpc/server").TRPCQueryProcedure<{
         input: {
             schoolId: string;
@@ -514,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: {
@@ -533,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: {
@@ -559,6 +878,141 @@ export declare const schoolRouter: import("@trpc/server").TRPCBuiltRouter<{
         };
         meta: object;
     }>;
+    getMemberDetail: import("@trpc/server").TRPCQueryProcedure<{
+        input: {
+            schoolId: string;
+            memberUserId: string;
+        };
+        output: {
+            membership: {
+                status: import(".prisma/client").$Enums.SchoolMembershipStatus;
+                user: {
+                    id: string;
+                    username: string;
+                    email: string;
+                    profile: {
+                        profilePicture: string | null;
+                        displayName: string | null;
+                        profilePictureThumbnail: string | null;
+                    } | null;
+                };
+                id: string;
+                createdAt: Date;
+                updatedAt: Date;
+                role: import(".prisma/client").$Enums.SchoolMembershipRole;
+            };
+            teachingClasses: {
+                id: string;
+                name: string;
+                section: string;
+                subject: string;
+                color: string | null;
+                teacherCount: number;
+                studentCount: number;
+            }[];
+            enrolledClasses: {
+                id: string;
+                name: string;
+                section: string;
+                subject: string;
+                color: string | null;
+                teacherCount: number;
+                studentCount: number;
+            }[];
+        };
+        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" | "ACCOUNTANT" | "PARENT";
+            memberUserIds: string[];
+        };
+        output: {
+            updatedCount: number;
+        };
+        meta: object;
+    }>;
+    bulkRemoveMembers: import("@trpc/server").TRPCMutationProcedure<{
+        input: {
+            schoolId: string;
+            memberUserIds: string[];
+        };
+        output: {
+            removedCount: number;
+        };
+        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;
@@ -588,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;
         };
@@ -678,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;AAqCxB,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqMvB,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;;;;;;;;;;;;;;;;;;;;;IASH;;;OAGG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA4BH,+EAA+E;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;IA2C/E,kFAAkF;;;;;;;;;;;;;;;;GAUlF,CAAC"}