@studious-lms/server 1.23.0 → 1.25.0

package/dist/services/attendance.d.ts

@@ -1,3 +1,5 @@
+import { toDateOnly, startOfUtcDay, endOfUtcDay } from "../models/attendance.js";
+import { type StudentRef } from "./attendanceMerge.js";
 /** Get attendance for a class (optionally filtered by event). Creates missing records. */
 export declare function getAttendance(classId: string, eventId?: string): Promise<({
     event: {
@@ -44,26 +46,73 @@ export declare function getAttendance(classId: string, eventId?: string): Promis
             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;
-})[]>;
-/** Update attendance record (present/late/absent). Teacher-only. */
-export declare function updateAttendanceRecord(userId: string, classId: string, eventId: string | null | undefined, attendance: {
-    present: {
-        id: string;
-        username: string;
-    }[];
-    late: {
+} & {
+    excused: {
         id: string;
         username: string;
     }[];
-    absent: {
+    records: {
+        lockedFromExcusal: boolean;
+        reason: string | null;
+        excusalNote: string | null;
         id: string;
-        username: string;
+        studentId: string;
+        status: string;
+        note: string | null;
+        excusedByExcusalId: string | null;
+        updatedById: string | null;
+        updatedAt: Date;
+        student: {
+            id: string;
+            username: string;
+        };
+        excusedByExcusal: {
+            id: string;
+            reason: string;
+            note: string | null;
+        } | null;
     }[];
+})[]>;
+/** Update attendance record (present/late/absent/excused). Teacher-only. */
+export declare function updateAttendanceRecord(userId: string, classId: string, eventId: string | null | undefined, attendance: {
+    present: StudentRef[];
+    late: StudentRef[];
+    absent: StudentRef[];
+    excused?: StudentRef[];
 }): Promise<{
     event: {
         id: string;
@@ -84,10 +133,278 @@ export declare function updateAttendanceRecord(userId: string, classId: string,
         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;
+} & {
+    excused: {
+        id: string;
+        username: string;
+    }[];
+    records: {
+        lockedFromExcusal: boolean;
+        reason: string | null;
+        excusalNote: string | null;
+        id: string;
+        studentId: string;
+        status: string;
+        note: string | null;
+        excusedByExcusalId: string | null;
+        updatedById: string | null;
+        updatedAt: Date;
+        student: {
+            id: string;
+            username: string;
+        };
+        excusedByExcusal: {
+            id: string;
+            reason: string;
+            note: string | null;
+        } | null;
+    }[];
+}>;
+/**
+ * School-admin: today's attendance rollup across classes.
+ * `percentage` is session-weighted (share of attended class-session records),
+ * not a share of `totalStudents`; a student in six classes contributes six records.
+ */
+export declare function listTodayAttendanceSummary(userId: string, schoolId: string): Promise<{
+    date: Date;
+    totalStudents: number;
+    totals: import("./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;
+    }[];
+}>;
+/** School-admin: per-student attendance counts + % (excused excluded from %). */
+export declare function listStudentAttendanceStats(userId: string, input: {
+    schoolId: string;
+    from?: Date;
+    to?: Date;
+    studentId?: string;
+}): Promise<{
+    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;
+}[]>;
+export declare function listExcusals(userId: string, input: {
+    schoolId: string;
+    includeRevoked?: boolean;
+    studentId?: string;
+}): Promise<{
+    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;
+}[]>;
+export declare function createExcusal(userId: string, input: {
+    schoolId: string;
+    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;
+    }[];
+    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 updateExcusal(userId: string, input: {
+    schoolId: string;
+    excusalId: string;
+    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;
+    }[];
+    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 revokeExcusal(userId: string, input: {
+    schoolId: string;
+    excusalId: string;
+}): Promise<{
+    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 { toDateOnly, startOfUtcDay, endOfUtcDay };
 //# sourceMappingURL=attendance.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"attendance.d.ts","sourceRoot":"/","sources":["services/attendance.ts"],"names":[],"mappings":"AAmBA,0FAA0F;AAC1F,wBAAsB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;MAwBpE;AAED,oEAAoE;AACpE,wBAAsB,sBAAsB,CAC1C,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,EAClC,UAAU,EAAE;IACV,OAAO,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IAC5C,IAAI,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;IACzC,MAAM,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,EAAE,CAAC;CAC5C;;;;;;;;;;;;;;;;;;;;;;;;;GA0DF"}
+{"version":3,"file":"attendance.d.ts","sourceRoot":"/","sources":["services/attendance.ts"],"names":[],"mappings":"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"}