@studious-lms/server 1.23.0 → 1.25.0

package/dist/models/attendance.d.ts

@@ -1,5 +1,107 @@
+/**
+ * Attendance model – session-level lists + per-student AttendanceRecord,
+ * and school-scoped StudentExcusal persistence.
+ */
+import { AttendanceStatus, Prisma } from "@prisma/client";
+declare const attendanceInclude: {
+    readonly event: {
+        readonly select: {
+            readonly id: true;
+            readonly name: true;
+            readonly startTime: true;
+            readonly endTime: true;
+            readonly location: true;
+            readonly color: true;
+        };
+    };
+    readonly present: {
+        readonly select: {
+            readonly id: true;
+            readonly username: true;
+            readonly profile: {
+                readonly select: {
+                    readonly displayName: true;
+                    readonly profilePicture: true;
+                    readonly profilePictureThumbnail: true;
+                    readonly bio: true;
+                    readonly location: true;
+                    readonly website: true;
+                };
+            };
+        };
+    };
+    readonly late: {
+        readonly select: {
+            readonly id: true;
+            readonly username: true;
+            readonly profile: {
+                readonly select: {
+                    readonly displayName: true;
+                    readonly profilePicture: true;
+                    readonly profilePictureThumbnail: true;
+                    readonly bio: true;
+                    readonly location: true;
+                    readonly website: true;
+                };
+            };
+        };
+    };
+    readonly absent: {
+        readonly select: {
+            readonly id: true;
+            readonly username: true;
+            readonly profile: {
+                readonly select: {
+                    readonly displayName: true;
+                    readonly profilePicture: true;
+                    readonly profilePictureThumbnail: true;
+                    readonly bio: true;
+                    readonly location: true;
+                    readonly website: true;
+                };
+            };
+        };
+    };
+    readonly records: {
+        readonly select: {
+            readonly id: true;
+            readonly studentId: true;
+            readonly status: true;
+            readonly note: true;
+            readonly excusedByExcusalId: true;
+            readonly updatedById: true;
+            readonly updatedAt: true;
+            readonly student: {
+                readonly select: {
+                    readonly id: true;
+                    readonly username: true;
+                    readonly profile: {
+                        readonly select: {
+                            readonly displayName: true;
+                            readonly profilePicture: true;
+                            readonly profilePictureThumbnail: true;
+                            readonly bio: true;
+                            readonly location: true;
+                            readonly website: true;
+                        };
+                    };
+                };
+            };
+            readonly excusedByExcusal: {
+                readonly select: {
+                    readonly id: true;
+                    readonly reason: true;
+                    readonly note: true;
+                    readonly startDate: true;
+                    readonly endDate: true;
+                    readonly revokedAt: true;
+                };
+            };
+        };
+    };
+};
 /** @returns Class with students for attendance. */
-export declare function findClassWithStudents(classId: string): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<import(".prisma/client").Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
+export declare function findClassWithStudents(classId: string): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
     result: {
         userProfile: {
             profilePicture: () => {
@@ -37,9 +139,10 @@ export declare function findClassWithStudents(classId: string): import("@prisma/
             profilePictureThumbnail: string | null;
         } | null;
     }[];
+    schoolId: string | null;
 } | null>;
 /** @returns Class if user is a teacher or school admin. */
-export declare function findClassWithTeacher(classId: string, teacherId: string): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<import(".prisma/client").Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
+export declare function findClassWithTeacher(classId: string, teacherId: string): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
     result: {
         userProfile: {
             profilePicture: () => {
@@ -69,6 +172,7 @@ export declare function findClassWithTeacher(classId: string, teacherId: string)
     students: {
         id: string;
     }[];
+    schoolId: string | null;
 } | null>;
 /** @returns Events for a class. */
 export declare function findEventsByClassId(classId: string): import("@prisma/client/runtime/library.js").PrismaPromise<{
@@ -83,7 +187,7 @@ export declare function findEventsByClassId(classId: string): import("@prisma/cl
     remarks: string | null;
 }[]>;
 /** @returns Attendance record for an event. */
-export declare function findAttendanceByEventId(eventId: string): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<import(".prisma/client").Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
+export declare function findAttendanceByEventId(eventId: string): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
     result: {
         userProfile: {
             profilePicture: () => {
@@ -107,14 +211,20 @@ export declare function findAttendanceByEventId(eventId: string): import("@prism
     model: {};
     query: {};
     client: {};
-}, {}>, "Attendance", "findFirst", null> & import("@prisma/client/runtime/library.js").PrismaPromise<{
+}, {}>, "Attendance", "findFirst", null> & import("@prisma/client/runtime/library.js").PrismaPromise<({
+    records: {
+        status: import(".prisma/client").$Enums.AttendanceStatus;
+        studentId: string;
+        excusedByExcusalId: string | null;
+    }[];
+} & {
     id: string;
     classId: string;
     eventId: string | null;
     date: Date;
-} | null>;
+}) | null>;
 /** @returns Attendance for class and event (eventId null = class-level). */
-export declare function findAttendanceByClassAndEvent(classId: string, eventId: string | null): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<import(".prisma/client").Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
+export declare function findAttendanceByClassAndEvent(classId: string, eventId: string | null): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
     result: {
         userProfile: {
             profilePicture: () => {
@@ -142,6 +252,7 @@ export declare function findAttendanceByClassAndEvent(classId: string, eventId:
     event: {
         id: string;
         name: string | null;
+        startTime: Date;
     } | null;
     late: {
         id: string;
@@ -149,6 +260,12 @@ export declare function findAttendanceByClassAndEvent(classId: string, eventId:
     absent: {
         id: string;
     }[];
+    records: {
+        status: import(".prisma/client").$Enums.AttendanceStatus;
+        studentId: string;
+        note: string | null;
+        excusedByExcusalId: string | null;
+    }[];
 } & {
     id: string;
     classId: string;
@@ -201,20 +318,59 @@ export declare function findManyAttendance(classId: string, eventId?: string): i
             profilePictureThumbnail: string | null;
         } | null;
     }[];
+    records: {
+        status: import(".prisma/client").$Enums.AttendanceStatus;
+        id: string;
+        updatedAt: Date;
+        student: {
+            id: string;
+            username: string;
+            profile: {
+                profilePicture: string | null;
+                displayName: string | null;
+                bio: string | null;
+                location: string | null;
+                website: string | null;
+                profilePictureThumbnail: string | null;
+            } | null;
+        };
+        studentId: string;
+        note: string | null;
+        excusedByExcusalId: string | null;
+        updatedById: string | null;
+        excusedByExcusal: {
+            id: string;
+            reason: string;
+            startDate: Date;
+            endDate: Date;
+            revokedAt: Date | null;
+            note: string | null;
+        } | null;
+    }[];
 } & {
     id: string;
     classId: string;
     eventId: string | null;
     date: Date;
 })[]>;
-/** Create an attendance record. */
+/** Create an attendance session with legacy lists + per-student records. */
 export declare function createAttendance(data: {
     classId: string;
     eventId?: string | null;
+    date?: Date;
     presentIds: string[];
     lateIds?: string[];
     absentIds?: string[];
-}): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<import(".prisma/client").Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
+    excusedIds?: string[];
+    records?: Array<{
+        studentId: string;
+        status: AttendanceStatus;
+        note?: string | null;
+        excusedByExcusalId?: string | null;
+        updatedById?: string | null;
+    }>;
+    updatedById?: string | null;
+}): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
     result: {
         userProfile: {
             profilePicture: () => {
@@ -258,6 +414,24 @@ export declare function createAttendance(data: {
         id: string;
         username: string;
     }[];
+    records: {
+        status: import(".prisma/client").$Enums.AttendanceStatus;
+        id: string;
+        updatedAt: Date;
+        student: {
+            id: string;
+            username: string;
+        };
+        studentId: string;
+        note: string | null;
+        excusedByExcusalId: string | null;
+        updatedById: string | null;
+        excusedByExcusal: {
+            id: string;
+            reason: string;
+            note: string | null;
+        } | null;
+    }[];
 } & {
     id: string;
     classId: string;
@@ -268,8 +442,19 @@ export declare function createAttendance(data: {
 export declare function createAttendanceForEvent(data: {
     classId: string;
     eventId: string;
+    date?: Date;
     presentIds: string[];
-}): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<import(".prisma/client").Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
+    lateIds?: string[];
+    absentIds?: string[];
+    excusedIds?: string[];
+    records?: Array<{
+        studentId: string;
+        status: AttendanceStatus;
+        note?: string | null;
+        excusedByExcusalId?: string | null;
+        updatedById?: string | null;
+    }>;
+}): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
     result: {
         userProfile: {
             profilePicture: () => {
@@ -294,17 +479,195 @@ export declare function createAttendanceForEvent(data: {
     query: {};
     client: {};
 }, {}>, "Attendance", "create", never> & import("@prisma/client/runtime/library.js").PrismaPromise<{
+    event: {
+        id: string;
+        location: string | null;
+        name: string | null;
+        startTime: Date;
+        endTime: Date;
+    } | null;
+    present: {
+        id: string;
+        username: string;
+    }[];
+    late: {
+        id: string;
+        username: string;
+    }[];
+    absent: {
+        id: string;
+        username: string;
+    }[];
+    records: {
+        status: import(".prisma/client").$Enums.AttendanceStatus;
+        id: string;
+        updatedAt: Date;
+        student: {
+            id: string;
+            username: string;
+        };
+        studentId: string;
+        note: string | null;
+        excusedByExcusalId: string | null;
+        updatedById: string | null;
+        excusedByExcusal: {
+            id: string;
+            reason: string;
+            note: string | null;
+        } | null;
+    }[];
+} & {
     id: string;
     classId: string;
     eventId: string | null;
     date: Date;
 }>;
-/** Update attendance present/late/absent lists. */
+/** Update attendance present/late/absent lists and sync per-student records. */
 export declare function updateAttendance(id: string, data: {
     presentIds: string[];
     lateIds: string[];
     absentIds: string[];
-}): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<import(".prisma/client").Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
+    records: Array<{
+        studentId: string;
+        status: AttendanceStatus;
+        note?: string | null;
+        excusedByExcusalId?: string | null;
+        updatedById?: string | null;
+    }>;
+}): Promise<{
+    event: {
+        id: string;
+        location: string | null;
+        name: string | null;
+        startTime: Date;
+        endTime: Date;
+    } | null;
+    present: {
+        id: string;
+        username: string;
+    }[];
+    late: {
+        id: string;
+        username: string;
+    }[];
+    absent: {
+        id: string;
+        username: string;
+    }[];
+    records: {
+        status: import(".prisma/client").$Enums.AttendanceStatus;
+        id: string;
+        updatedAt: Date;
+        student: {
+            id: string;
+            username: string;
+        };
+        studentId: string;
+        note: string | null;
+        excusedByExcusalId: string | null;
+        updatedById: string | null;
+        excusedByExcusal: {
+            id: string;
+            reason: string;
+            note: string | null;
+        } | null;
+    }[];
+} & {
+    id: string;
+    classId: string;
+    eventId: string | null;
+    date: Date;
+}>;
+/** Active (non-revoked) excusals covering a calendar date for given students. */
+export declare function findActiveExcusalsForStudents(input: {
+    schoolId: string;
+    studentIds: string[];
+    date: Date;
+}): Promise<never[]> | import("@prisma/client/runtime/library.js").PrismaPromise<({
+    students: {
+        studentId: string;
+    }[];
+} & {
+    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;
+})[]>;
+/** Active excusals overlapping a date range for school students. */
+export declare function findActiveExcusalsInRange(input: {
+    schoolId: string;
+    studentIds?: string[];
+    startDate: Date;
+    endDate: Date;
+}): import("@prisma/client/runtime/library.js").PrismaPromise<({
+    students: {
+        studentId: string;
+    }[];
+} & {
+    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;
+})[]>;
+export declare function listExcusalsForSchool(input: {
+    schoolId: string;
+    includeRevoked?: boolean;
+    studentId?: string;
+}): import("@prisma/client/runtime/library.js").PrismaPromise<({
+    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;
+})[]>;
+export declare function findExcusalById(excusalId: string): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
     result: {
         userProfile: {
             profilePicture: () => {
@@ -328,30 +691,305 @@ export declare function updateAttendance(id: string, data: {
     model: {};
     query: {};
     client: {};
-}, {}>, "Attendance", "update", never> & import("@prisma/client/runtime/library.js").PrismaPromise<{
-    event: {
+}, {}>, "StudentExcusal", "findUnique", null> & import("@prisma/client/runtime/library.js").PrismaPromise<({
+    students: {
+        studentId: string;
+    }[];
+    createdBy: {
         id: string;
-        location: string | null;
-        name: string | null;
-        startTime: Date;
-        endTime: Date;
-    } | null;
-    present: {
+        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;
+}) | null>;
+export declare function createStudentExcusal(data: {
+    schoolId: string;
+    studentIds: string[];
+    startDate: Date;
+    endDate: Date;
+    reason: string;
+    note?: string | null;
+    createdById: string;
+}): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
+    result: {
+        userProfile: {
+            profilePicture: () => {
+                needs: {
+                    profilePicture: true;
+                };
+                compute(profile: {
+                    profilePicture: string | null;
+                }): string | null;
+            };
+            profilePictureThumbnail: () => {
+                needs: {
+                    profilePictureThumbnail: true;
+                };
+                compute(profile: {
+                    profilePictureThumbnail: string | null;
+                }): string | null;
+            };
+        };
+    };
+    model: {};
+    query: {};
+    client: {};
+}, {}>, "StudentExcusal", "create", never> & import("@prisma/client/runtime/library.js").PrismaPromise<{
+    students: {
+        student: {
+            id: string;
+            username: string;
+            profile: {
+                profilePicture: string | null;
+                displayName: string | null;
+                profilePictureThumbnail: string | null;
+            } | null;
+        };
+        studentId: string;
     }[];
-    late: {
+    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;
+}>;
+export declare function updateStudentExcusal(excusalId: string, data: {
+    studentIds?: string[];
+    startDate?: Date;
+    endDate?: Date;
+    reason?: string;
+    note?: string | null;
+}): Promise<{
+    students: {
+        student: {
+            id: string;
+            username: string;
+            profile: {
+                profilePicture: string | null;
+                displayName: string | null;
+                profilePictureThumbnail: string | null;
+            } | null;
+        };
+        studentId: string;
     }[];
-    absent: {
+    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;
+}>;
+export declare function revokeStudentExcusal(excusalId: string, revokedById: string): import("@prisma/client/runtime/library.js").DynamicModelExtensionFluentApi<Prisma.TypeMap<import("@prisma/client/runtime/library.js").InternalArgs & {
+    result: {
+        userProfile: {
+            profilePicture: () => {
+                needs: {
+                    profilePicture: true;
+                };
+                compute(profile: {
+                    profilePicture: string | null;
+                }): string | null;
+            };
+            profilePictureThumbnail: () => {
+                needs: {
+                    profilePictureThumbnail: true;
+                };
+                compute(profile: {
+                    profilePictureThumbnail: string | null;
+                }): string | null;
+            };
+        };
+    };
+    model: {};
+    query: {};
+    client: {};
+}, {}>, "StudentExcusal", "update", never> & import("@prisma/client/runtime/library.js").PrismaPromise<{
+    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;
+}>;
+/** Apply EXCUSED status for an excusal across matching class attendance sessions. */
+export declare function applyExcusalToAttendance(input: {
+    schoolId: string;
+    excusalId: string;
+    studentIds: string[];
+    startDate: Date;
+    endDate: Date;
+    updatedById?: string | null;
+}): Promise<{
+    sessionsTouched: number;
+    recordsUpserted: number;
+}>;
+/** Clear EXCUSED locks tied to a revoked/updated excusal (leave status EXCUSED unless cleared). */
+export declare function clearExcusalLocks(excusalId: string): Promise<import("@prisma/client/runtime/library.js").GetBatchResult>;
+export declare function listSchoolStudentMemberships(schoolId: string): import("@prisma/client/runtime/library.js").PrismaPromise<{
+    user: {
+        id: string;
+        username: string;
+        profile: {
+            profilePicture: string | null;
+            displayName: string | null;
+            profilePictureThumbnail: string | null;
+        } | null;
+        studentIn: {
+            section: string;
+            id: string;
+            name: string;
+            subject: string;
+        }[];
+    };
+    userId: string;
+}[]>;
+export declare function listAttendanceRecordsForSchoolStudents(input: {
+    schoolId: string;
+    studentIds: string[];
+    from?: Date;
+    to?: Date;
+}): Promise<never[]> | import("@prisma/client/runtime/library.js").PrismaPromise<{
+    status: import(".prisma/client").$Enums.AttendanceStatus;
+    attendance: {
+        class: {
+            id: string;
+            name: string;
+        };
+        event: {
+            id: string;
+            name: string | null;
+            startTime: Date;
+        } | null;
+        id: string;
+        classId: string;
+        eventId: string | null;
+        date: Date;
+    };
+    studentId: string;
+}[]>;
+export declare function listTodaySchoolAttendanceSessions(schoolId: string, day: Date): import("@prisma/client/runtime/library.js").PrismaPromise<{
+    class: {
+        section: string;
+        id: string;
+        name: string;
+        _count: {
+            students: number;
+        };
+        subject: string;
+    };
+    event: {
+        id: string;
+        name: string | null;
+        startTime: Date;
+        endTime: Date;
+    } | null;
     id: string;
     classId: string;
     eventId: string | null;
     date: Date;
+    records: {
+        status: import(".prisma/client").$Enums.AttendanceStatus;
+        studentId: string;
+    }[];
+}[]>;
+export declare function toDateOnly(date: Date): Date;
+export declare function startOfUtcDay(date: Date): Date;
+export declare function endOfUtcDay(date: Date): Date;
+export type { AttendanceStatus };
+export type AttendanceIncludeResult = Prisma.AttendanceGetPayload<{
+    include: typeof attendanceInclude;
 }>;
 //# sourceMappingURL=attendance.d.ts.map