@brite-future-schools-contracts/contracts 1.0.8 → 2.0.3

package/dist/schemas/index.d.cts

@@ -0,0 +1,708 @@
+import * as z from 'zod';
+
+/**
+ * Brite Future Schools — bfs-contracts
+ * Base Zod schemas: reusable primitives shared across all domain schemas.
+ *
+ * Phase History:
+ *   Phase 0.1 (2026-06-05): Initial creation
+ *
+ * @module src/schemas/base
+ * @since Phase 0.1
+ */
+
+declare const CuidSchema: z.ZodString;
+declare const UuidSchema: z.ZodUUID;
+declare const TimestampsSchema: z.ZodObject<{
+    createdAt: z.ZodISODateTime;
+    updatedAt: z.ZodISODateTime;
+}, z.core.$strip>;
+declare const SoftDeleteSchema: z.ZodObject<{
+    deletedAt: z.ZodNullable<z.ZodISODateTime>;
+}, z.core.$strip>;
+declare const PaginationInputSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodInt>;
+}, z.core.$strip>;
+declare function paginatedOutputSchema<T extends z.ZodTypeAny>(itemSchema: T): z.ZodObject<{
+    items: z.ZodArray<T>;
+    nextCursor: z.ZodNullable<z.ZodString>;
+    total: z.ZodInt;
+}, z.core.$strip>;
+declare const BranchRefSchema: z.ZodObject<{
+    branchId: z.ZodString;
+}, z.core.$strip>;
+type Timestamps = z.infer<typeof TimestampsSchema>;
+type SoftDelete = z.infer<typeof SoftDeleteSchema>;
+type PaginationInput = z.infer<typeof PaginationInputSchema>;
+
+/**
+ * Brite Future Schools — bfs-contracts
+ * Auth-related Zod schemas.
+ *
+ * Phase History:
+ *   Phase 0.1 (2026-06-05): Initial creation
+ *
+ * @module src/schemas/auth
+ * @since Phase 0.1
+ */
+
+declare const SessionUserRoleSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    branchId: z.ZodString;
+    isPrimary: z.ZodBoolean;
+}, z.core.$strip>;
+declare const SessionUserSubRoleSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    branchId: z.ZodString;
+}, z.core.$strip>;
+declare const SessionUserOutputSchema: z.ZodObject<{
+    id: z.ZodString;
+    email: z.ZodEmail;
+    firstName: z.ZodString;
+    lastName: z.ZodString;
+    activeBranchId: z.ZodString;
+    roles: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        branchId: z.ZodString;
+        isPrimary: z.ZodBoolean;
+    }, z.core.$strip>>;
+    subRoles: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        branchId: z.ZodString;
+    }, z.core.$strip>>;
+    isActive: z.ZodBoolean;
+    mustChangePassword: z.ZodBoolean;
+}, z.core.$strip>;
+declare const LoginInputSchema: z.ZodObject<{
+    email: z.ZodEmail;
+    password: z.ZodString;
+    branchId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const LoginOutputSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    refreshToken: z.ZodString;
+    expiresIn: z.ZodInt;
+    user: z.ZodObject<{
+        id: z.ZodString;
+        email: z.ZodEmail;
+        firstName: z.ZodString;
+        lastName: z.ZodString;
+        activeBranchId: z.ZodString;
+        roles: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            branchId: z.ZodString;
+            isPrimary: z.ZodBoolean;
+        }, z.core.$strip>>;
+        subRoles: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            branchId: z.ZodString;
+        }, z.core.$strip>>;
+        isActive: z.ZodBoolean;
+        mustChangePassword: z.ZodBoolean;
+    }, z.core.$strip>;
+}, z.core.$strip>;
+declare const RefreshTokenInputSchema: z.ZodObject<{
+    refreshToken: z.ZodString;
+}, z.core.$strip>;
+declare const RefreshTokenOutputSchema: z.ZodObject<{
+    accessToken: z.ZodString;
+    expiresIn: z.ZodInt;
+}, z.core.$strip>;
+declare const LogoutInputSchema: z.ZodObject<{
+    refreshToken: z.ZodString;
+}, z.core.$strip>;
+declare const ChangePasswordInputSchema: z.ZodObject<{
+    currentPassword: z.ZodString;
+    newPassword: z.ZodString;
+    confirmPassword: z.ZodString;
+}, z.core.$strip>;
+declare const RequestPasswordResetInputSchema: z.ZodObject<{
+    email: z.ZodEmail;
+}, z.core.$strip>;
+declare const ResetPasswordInputSchema: z.ZodObject<{
+    token: z.ZodString;
+    newPassword: z.ZodString;
+    confirmPassword: z.ZodString;
+}, z.core.$strip>;
+declare const SwitchBranchInputSchema: z.ZodObject<{
+    branchId: z.ZodString;
+}, z.core.$strip>;
+type LoginInput = z.infer<typeof LoginInputSchema>;
+type LoginOutput = z.infer<typeof LoginOutputSchema>;
+type SessionUserOutput = z.infer<typeof SessionUserOutputSchema>;
+type RefreshTokenInput = z.infer<typeof RefreshTokenInputSchema>;
+type RefreshTokenOutput = z.infer<typeof RefreshTokenOutputSchema>;
+type ChangePasswordInput = z.infer<typeof ChangePasswordInputSchema>;
+type SwitchBranchInput = z.infer<typeof SwitchBranchInputSchema>;
+
+/**
+ * Brite Future Schools — bfs-contracts
+ * HR domain Zod schemas — staff creation, listing, and profiles.
+ *
+ * Phase History:
+ *   Phase 1 (2026-06-07): Initial creation — staff.create, staff.list,
+ *                          staff.getById wire types
+ *
+ * @module src/schemas/hr
+ * @since Phase 1
+ */
+
+declare const EmploymentTypeSchema: z.ZodEnum<{
+    permanent: "permanent";
+    contract: "contract";
+    temporary: "temporary";
+    intern: "intern";
+}>;
+declare const RoleNameSchema: z.ZodEnum<{
+    PROPRIETOR: "PROPRIETOR";
+    DIRECTOR: "DIRECTOR";
+    SYSTEM_ADMIN: "SYSTEM_ADMIN";
+    PRINCIPAL: "PRINCIPAL";
+    DEPUTY_PRINCIPAL: "DEPUTY_PRINCIPAL";
+    HOD: "HOD";
+    CLASS_TEACHER: "CLASS_TEACHER";
+    SUBJECT_TEACHER: "SUBJECT_TEACHER";
+    BURSAR: "BURSAR";
+    HR_ADMIN: "HR_ADMIN";
+    SCHOOL_NURSE: "SCHOOL_NURSE";
+    LIBRARIAN: "LIBRARIAN";
+    LAB_TECHNICIAN: "LAB_TECHNICIAN";
+    SPORTS_COACH: "SPORTS_COACH";
+    COUNSELLOR: "COUNSELLOR";
+    CARETAKER: "CARETAKER";
+    SECURITY: "SECURITY";
+    KITCHEN_STAFF: "KITCHEN_STAFF";
+    KITCHEN_MANAGER: "KITCHEN_MANAGER";
+    DRIVER: "DRIVER";
+    IT_ADMIN: "IT_ADMIN";
+    BOARDING_MASTER: "BOARDING_MASTER";
+    PREFECT: "PREFECT";
+    STUDENT: "STUDENT";
+    PARENT: "PARENT";
+    ORG_SPONSOR: "ORG_SPONSOR";
+    INDIVIDUAL_SPONSOR: "INDIVIDUAL_SPONSOR";
+}>;
+declare const CreateStaffInputSchema: z.ZodObject<{
+    firstName: z.ZodString;
+    middleName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodString;
+    email: z.ZodEmail;
+    phone: z.ZodString;
+    nationalId: z.ZodString;
+    roleName: z.ZodEnum<{
+        PROPRIETOR: "PROPRIETOR";
+        DIRECTOR: "DIRECTOR";
+        SYSTEM_ADMIN: "SYSTEM_ADMIN";
+        PRINCIPAL: "PRINCIPAL";
+        DEPUTY_PRINCIPAL: "DEPUTY_PRINCIPAL";
+        HOD: "HOD";
+        CLASS_TEACHER: "CLASS_TEACHER";
+        SUBJECT_TEACHER: "SUBJECT_TEACHER";
+        BURSAR: "BURSAR";
+        HR_ADMIN: "HR_ADMIN";
+        SCHOOL_NURSE: "SCHOOL_NURSE";
+        LIBRARIAN: "LIBRARIAN";
+        LAB_TECHNICIAN: "LAB_TECHNICIAN";
+        SPORTS_COACH: "SPORTS_COACH";
+        COUNSELLOR: "COUNSELLOR";
+        CARETAKER: "CARETAKER";
+        SECURITY: "SECURITY";
+        KITCHEN_STAFF: "KITCHEN_STAFF";
+        KITCHEN_MANAGER: "KITCHEN_MANAGER";
+        DRIVER: "DRIVER";
+        IT_ADMIN: "IT_ADMIN";
+        BOARDING_MASTER: "BOARDING_MASTER";
+        PREFECT: "PREFECT";
+        STUDENT: "STUDENT";
+        PARENT: "PARENT";
+        ORG_SPONSOR: "ORG_SPONSOR";
+        INDIVIDUAL_SPONSOR: "INDIVIDUAL_SPONSOR";
+    }>;
+    isPrimaryRole: z.ZodDefault<z.ZodBoolean>;
+    departmentId: z.ZodOptional<z.ZodUUID>;
+    designation: z.ZodString;
+    employmentType: z.ZodEnum<{
+        permanent: "permanent";
+        contract: "contract";
+        temporary: "temporary";
+        intern: "intern";
+    }>;
+    contractStart: z.ZodISODate;
+    contractEnd: z.ZodOptional<z.ZodISODate>;
+    basicSalary: z.ZodNumber;
+    houseAllowance: z.ZodDefault<z.ZodNumber>;
+    transportAllowance: z.ZodDefault<z.ZodNumber>;
+    helbDeduction: z.ZodDefault<z.ZodNumber>;
+    saccoDeduction: z.ZodDefault<z.ZodNumber>;
+    bankName: z.ZodOptional<z.ZodString>;
+    bankAccount: z.ZodOptional<z.ZodString>;
+    bankBranch: z.ZodOptional<z.ZodString>;
+    tscNumber: z.ZodOptional<z.ZodString>;
+    kraPin: z.ZodOptional<z.ZodString>;
+    nhifNo: z.ZodOptional<z.ZodString>;
+    nssfNo: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type CreateStaffInput = z.infer<typeof CreateStaffInputSchema>;
+declare const StaffProfileSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    userId: z.ZodUUID;
+    branchId: z.ZodUUID;
+    firstName: z.ZodString;
+    middleName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodString;
+    phone: z.ZodString;
+    nationalId: z.ZodString;
+    tscNumber: z.ZodNullable<z.ZodString>;
+    kraPin: z.ZodNullable<z.ZodString>;
+    nhifNo: z.ZodNullable<z.ZodString>;
+    nssfNo: z.ZodNullable<z.ZodString>;
+    designation: z.ZodString;
+    employmentType: z.ZodEnum<{
+        permanent: "permanent";
+        contract: "contract";
+        temporary: "temporary";
+        intern: "intern";
+    }>;
+    contractStart: z.ZodString;
+    contractEnd: z.ZodNullable<z.ZodString>;
+    basicSalary: z.ZodString;
+    houseAllowance: z.ZodString;
+    transportAllowance: z.ZodString;
+    helbDeduction: z.ZodNullable<z.ZodString>;
+    saccoDeduction: z.ZodNullable<z.ZodString>;
+    bankName: z.ZodNullable<z.ZodString>;
+    bankAccount: z.ZodNullable<z.ZodString>;
+    bankBranch: z.ZodNullable<z.ZodString>;
+    status: z.ZodString;
+    createdAt: z.ZodString;
+    email: z.ZodString;
+    mustChangePassword: z.ZodBoolean;
+    departmentId: z.ZodNullable<z.ZodUUID>;
+    departmentName: z.ZodNullable<z.ZodString>;
+    roleName: z.ZodNullable<z.ZodEnum<{
+        PROPRIETOR: "PROPRIETOR";
+        DIRECTOR: "DIRECTOR";
+        SYSTEM_ADMIN: "SYSTEM_ADMIN";
+        PRINCIPAL: "PRINCIPAL";
+        DEPUTY_PRINCIPAL: "DEPUTY_PRINCIPAL";
+        HOD: "HOD";
+        CLASS_TEACHER: "CLASS_TEACHER";
+        SUBJECT_TEACHER: "SUBJECT_TEACHER";
+        BURSAR: "BURSAR";
+        HR_ADMIN: "HR_ADMIN";
+        SCHOOL_NURSE: "SCHOOL_NURSE";
+        LIBRARIAN: "LIBRARIAN";
+        LAB_TECHNICIAN: "LAB_TECHNICIAN";
+        SPORTS_COACH: "SPORTS_COACH";
+        COUNSELLOR: "COUNSELLOR";
+        CARETAKER: "CARETAKER";
+        SECURITY: "SECURITY";
+        KITCHEN_STAFF: "KITCHEN_STAFF";
+        KITCHEN_MANAGER: "KITCHEN_MANAGER";
+        DRIVER: "DRIVER";
+        IT_ADMIN: "IT_ADMIN";
+        BOARDING_MASTER: "BOARDING_MASTER";
+        PREFECT: "PREFECT";
+        STUDENT: "STUDENT";
+        PARENT: "PARENT";
+        ORG_SPONSOR: "ORG_SPONSOR";
+        INDIVIDUAL_SPONSOR: "INDIVIDUAL_SPONSOR";
+    }>>;
+    roleId: z.ZodNullable<z.ZodUUID>;
+}, z.core.$strip>;
+type StaffProfile = z.infer<typeof StaffProfileSchema>;
+declare const StaffListItemSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    userId: z.ZodUUID;
+    firstName: z.ZodString;
+    middleName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodString;
+    email: z.ZodString;
+    phone: z.ZodString;
+    designation: z.ZodString;
+    employmentType: z.ZodEnum<{
+        permanent: "permanent";
+        contract: "contract";
+        temporary: "temporary";
+        intern: "intern";
+    }>;
+    status: z.ZodString;
+    departmentName: z.ZodNullable<z.ZodString>;
+    roleName: z.ZodNullable<z.ZodEnum<{
+        PROPRIETOR: "PROPRIETOR";
+        DIRECTOR: "DIRECTOR";
+        SYSTEM_ADMIN: "SYSTEM_ADMIN";
+        PRINCIPAL: "PRINCIPAL";
+        DEPUTY_PRINCIPAL: "DEPUTY_PRINCIPAL";
+        HOD: "HOD";
+        CLASS_TEACHER: "CLASS_TEACHER";
+        SUBJECT_TEACHER: "SUBJECT_TEACHER";
+        BURSAR: "BURSAR";
+        HR_ADMIN: "HR_ADMIN";
+        SCHOOL_NURSE: "SCHOOL_NURSE";
+        LIBRARIAN: "LIBRARIAN";
+        LAB_TECHNICIAN: "LAB_TECHNICIAN";
+        SPORTS_COACH: "SPORTS_COACH";
+        COUNSELLOR: "COUNSELLOR";
+        CARETAKER: "CARETAKER";
+        SECURITY: "SECURITY";
+        KITCHEN_STAFF: "KITCHEN_STAFF";
+        KITCHEN_MANAGER: "KITCHEN_MANAGER";
+        DRIVER: "DRIVER";
+        IT_ADMIN: "IT_ADMIN";
+        BOARDING_MASTER: "BOARDING_MASTER";
+        PREFECT: "PREFECT";
+        STUDENT: "STUDENT";
+        PARENT: "PARENT";
+        ORG_SPONSOR: "ORG_SPONSOR";
+        INDIVIDUAL_SPONSOR: "INDIVIDUAL_SPONSOR";
+    }>>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type StaffListItem = z.infer<typeof StaffListItemSchema>;
+declare const ListStaffInputSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodInt>;
+    search: z.ZodOptional<z.ZodString>;
+    departmentId: z.ZodOptional<z.ZodUUID>;
+    roleName: z.ZodOptional<z.ZodEnum<{
+        PROPRIETOR: "PROPRIETOR";
+        DIRECTOR: "DIRECTOR";
+        SYSTEM_ADMIN: "SYSTEM_ADMIN";
+        PRINCIPAL: "PRINCIPAL";
+        DEPUTY_PRINCIPAL: "DEPUTY_PRINCIPAL";
+        HOD: "HOD";
+        CLASS_TEACHER: "CLASS_TEACHER";
+        SUBJECT_TEACHER: "SUBJECT_TEACHER";
+        BURSAR: "BURSAR";
+        HR_ADMIN: "HR_ADMIN";
+        SCHOOL_NURSE: "SCHOOL_NURSE";
+        LIBRARIAN: "LIBRARIAN";
+        LAB_TECHNICIAN: "LAB_TECHNICIAN";
+        SPORTS_COACH: "SPORTS_COACH";
+        COUNSELLOR: "COUNSELLOR";
+        CARETAKER: "CARETAKER";
+        SECURITY: "SECURITY";
+        KITCHEN_STAFF: "KITCHEN_STAFF";
+        KITCHEN_MANAGER: "KITCHEN_MANAGER";
+        DRIVER: "DRIVER";
+        IT_ADMIN: "IT_ADMIN";
+        BOARDING_MASTER: "BOARDING_MASTER";
+        PREFECT: "PREFECT";
+        STUDENT: "STUDENT";
+        PARENT: "PARENT";
+        ORG_SPONSOR: "ORG_SPONSOR";
+        INDIVIDUAL_SPONSOR: "INDIVIDUAL_SPONSOR";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        inactive: "inactive";
+    }>>;
+}, z.core.$strip>;
+type ListStaffInput = z.infer<typeof ListStaffInputSchema>;
+declare const CreateStaffOutputSchema: z.ZodObject<{
+    staffId: z.ZodUUID;
+    userId: z.ZodUUID;
+    email: z.ZodString;
+    emailSent: z.ZodBoolean;
+}, z.core.$strip>;
+type CreateStaffOutput = z.infer<typeof CreateStaffOutputSchema>;
+declare const DepartmentSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    branchId: z.ZodUUID;
+    name: z.ZodString;
+    hodId: z.ZodNullable<z.ZodUUID>;
+}, z.core.$strip>;
+type Department = z.infer<typeof DepartmentSchema>;
+declare const CreateDepartmentInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    hodId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+type CreateDepartmentInput = z.infer<typeof CreateDepartmentInputSchema>;
+
+/**
+ * Brite Future Schools — bfs-contracts
+ * Students domain Zod schemas.
+ *
+ * Phase History:
+ *   Phase 1 (2026-06-07): Initial creation — student create, list,
+ *                          bulk upload, guardian linkage
+ *
+ * @module src/schemas/students
+ * @since Phase 1
+ */
+
+declare const GenderSchema: z.ZodEnum<{
+    male: "male";
+    female: "female";
+}>;
+declare const StudentStatusSchema: z.ZodEnum<{
+    active: "active";
+    transferred: "transferred";
+    graduated: "graduated";
+    suspended: "suspended";
+    withdrawn: "withdrawn";
+}>;
+declare const GradeLevelSchema: z.ZodEnum<{
+    PP1: "PP1";
+    PP2: "PP2";
+    G1: "G1";
+    G2: "G2";
+    G3: "G3";
+    G4: "G4";
+    G5: "G5";
+    G6: "G6";
+    G7: "G7";
+    G8: "G8";
+    G9: "G9";
+}>;
+declare const CreateStudentInputSchema: z.ZodObject<{
+    firstName: z.ZodString;
+    middleName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodString;
+    dateOfBirth: z.ZodISODate;
+    gender: z.ZodEnum<{
+        male: "male";
+        female: "female";
+    }>;
+    admissionNo: z.ZodString;
+    nemisNo: z.ZodOptional<z.ZodString>;
+    admissionDate: z.ZodISODate;
+    bloodGroup: z.ZodOptional<z.ZodString>;
+    medicalNotes: z.ZodOptional<z.ZodString>;
+    classId: z.ZodOptional<z.ZodUUID>;
+    termId: z.ZodOptional<z.ZodUUID>;
+    guardian: z.ZodOptional<z.ZodObject<{
+        firstName: z.ZodString;
+        middleName: z.ZodOptional<z.ZodString>;
+        lastName: z.ZodString;
+        relationship: z.ZodString;
+        phone: z.ZodString;
+        email: z.ZodOptional<z.ZodEmail>;
+        nationalId: z.ZodOptional<z.ZodString>;
+        occupation: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type CreateStudentInput = z.infer<typeof CreateStudentInputSchema>;
+declare const StudentProfileSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    branchId: z.ZodUUID;
+    admissionNo: z.ZodString;
+    nemisNo: z.ZodNullable<z.ZodString>;
+    firstName: z.ZodString;
+    middleName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodString;
+    dateOfBirth: z.ZodString;
+    gender: z.ZodEnum<{
+        male: "male";
+        female: "female";
+    }>;
+    photoUrl: z.ZodNullable<z.ZodString>;
+    bloodGroup: z.ZodNullable<z.ZodString>;
+    medicalNotes: z.ZodNullable<z.ZodString>;
+    admissionDate: z.ZodString;
+    status: z.ZodEnum<{
+        active: "active";
+        transferred: "transferred";
+        graduated: "graduated";
+        suspended: "suspended";
+        withdrawn: "withdrawn";
+    }>;
+    createdAt: z.ZodString;
+    currentClass: z.ZodNullable<z.ZodObject<{
+        classId: z.ZodUUID;
+        className: z.ZodString;
+        gradeLevel: z.ZodEnum<{
+            PP1: "PP1";
+            PP2: "PP2";
+            G1: "G1";
+            G2: "G2";
+            G3: "G3";
+            G4: "G4";
+            G5: "G5";
+            G6: "G6";
+            G7: "G7";
+            G8: "G8";
+            G9: "G9";
+        }>;
+        termId: z.ZodUUID;
+        termName: z.ZodString;
+    }, z.core.$strip>>;
+    guardians: z.ZodArray<z.ZodObject<{
+        id: z.ZodUUID;
+        firstName: z.ZodString;
+        middleName: z.ZodNullable<z.ZodString>;
+        lastName: z.ZodString;
+        relationship: z.ZodString;
+        phone: z.ZodString;
+        email: z.ZodNullable<z.ZodString>;
+        isPrimary: z.ZodBoolean;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type StudentProfile = z.infer<typeof StudentProfileSchema>;
+declare const StudentListItemSchema: z.ZodObject<{
+    id: z.ZodUUID;
+    admissionNo: z.ZodString;
+    firstName: z.ZodString;
+    middleName: z.ZodNullable<z.ZodString>;
+    lastName: z.ZodString;
+    gender: z.ZodEnum<{
+        male: "male";
+        female: "female";
+    }>;
+    status: z.ZodEnum<{
+        active: "active";
+        transferred: "transferred";
+        graduated: "graduated";
+        suspended: "suspended";
+        withdrawn: "withdrawn";
+    }>;
+    className: z.ZodNullable<z.ZodString>;
+    gradeLevel: z.ZodNullable<z.ZodEnum<{
+        PP1: "PP1";
+        PP2: "PP2";
+        G1: "G1";
+        G2: "G2";
+        G3: "G3";
+        G4: "G4";
+        G5: "G5";
+        G6: "G6";
+        G7: "G7";
+        G8: "G8";
+        G9: "G9";
+    }>>;
+    primaryGuardianName: z.ZodNullable<z.ZodString>;
+    primaryGuardianPhone: z.ZodNullable<z.ZodString>;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+type StudentListItem = z.infer<typeof StudentListItemSchema>;
+declare const ListStudentsInputSchema: z.ZodObject<{
+    cursor: z.ZodOptional<z.ZodString>;
+    limit: z.ZodDefault<z.ZodInt>;
+    search: z.ZodOptional<z.ZodString>;
+    classId: z.ZodOptional<z.ZodUUID>;
+    gradeLevel: z.ZodOptional<z.ZodEnum<{
+        PP1: "PP1";
+        PP2: "PP2";
+        G1: "G1";
+        G2: "G2";
+        G3: "G3";
+        G4: "G4";
+        G5: "G5";
+        G6: "G6";
+        G7: "G7";
+        G8: "G8";
+        G9: "G9";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        active: "active";
+        transferred: "transferred";
+        graduated: "graduated";
+        suspended: "suspended";
+        withdrawn: "withdrawn";
+    }>>;
+    termId: z.ZodOptional<z.ZodUUID>;
+}, z.core.$strip>;
+type ListStudentsInput = z.infer<typeof ListStudentsInputSchema>;
+/**
+ * One row from a CSV bulk upload.
+ * Column mapping is flexible — the upload endpoint accepts this shape
+ * after the CSV parser maps headers to these field names.
+ */
+declare const BulkUploadStudentRowSchema: z.ZodObject<{
+    firstName: z.ZodString;
+    middleName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodString;
+    dateOfBirth: z.ZodString;
+    gender: z.ZodString;
+    admissionNo: z.ZodString;
+    nemisNo: z.ZodOptional<z.ZodString>;
+    admissionDate: z.ZodOptional<z.ZodString>;
+    bloodGroup: z.ZodOptional<z.ZodString>;
+    guardianFirstName: z.ZodOptional<z.ZodString>;
+    guardianLastName: z.ZodOptional<z.ZodString>;
+    guardianRelationship: z.ZodOptional<z.ZodString>;
+    guardianPhone: z.ZodOptional<z.ZodString>;
+    guardianEmail: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type BulkUploadStudentRow = z.infer<typeof BulkUploadStudentRowSchema>;
+declare const BulkUploadStudentsInputSchema: z.ZodObject<{
+    classId: z.ZodUUID;
+    termId: z.ZodUUID;
+    rows: z.ZodArray<z.ZodObject<{
+        firstName: z.ZodString;
+        middleName: z.ZodOptional<z.ZodString>;
+        lastName: z.ZodString;
+        dateOfBirth: z.ZodString;
+        gender: z.ZodString;
+        admissionNo: z.ZodString;
+        nemisNo: z.ZodOptional<z.ZodString>;
+        admissionDate: z.ZodOptional<z.ZodString>;
+        bloodGroup: z.ZodOptional<z.ZodString>;
+        guardianFirstName: z.ZodOptional<z.ZodString>;
+        guardianLastName: z.ZodOptional<z.ZodString>;
+        guardianRelationship: z.ZodOptional<z.ZodString>;
+        guardianPhone: z.ZodOptional<z.ZodString>;
+        guardianEmail: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type BulkUploadStudentsInput = z.infer<typeof BulkUploadStudentsInputSchema>;
+declare const BulkUploadStudentsOutputSchema: z.ZodObject<{
+    created: z.ZodInt;
+    skipped: z.ZodInt;
+    errors: z.ZodArray<z.ZodObject<{
+        row: z.ZodInt;
+        admissionNo: z.ZodOptional<z.ZodString>;
+        reason: z.ZodString;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+type BulkUploadStudentsOutput = z.infer<typeof BulkUploadStudentsOutputSchema>;
+declare const CreateStudentOutputSchema: z.ZodObject<{
+    studentId: z.ZodUUID;
+    admissionNo: z.ZodString;
+}, z.core.$strip>;
+type CreateStudentOutput = z.infer<typeof CreateStudentOutputSchema>;
+declare const LinkGuardianInputSchema: z.ZodObject<{
+    studentId: z.ZodUUID;
+    firstName: z.ZodString;
+    middleName: z.ZodOptional<z.ZodString>;
+    lastName: z.ZodString;
+    relationship: z.ZodString;
+    phone: z.ZodString;
+    email: z.ZodOptional<z.ZodEmail>;
+    nationalId: z.ZodOptional<z.ZodString>;
+    occupation: z.ZodOptional<z.ZodString>;
+    isPrimary: z.ZodDefault<z.ZodBoolean>;
+}, z.core.$strip>;
+type LinkGuardianInput = z.infer<typeof LinkGuardianInputSchema>;
+declare const ClassSummarySchema: z.ZodObject<{
+    id: z.ZodUUID;
+    name: z.ZodString;
+    gradeLevel: z.ZodEnum<{
+        PP1: "PP1";
+        PP2: "PP2";
+        G1: "G1";
+        G2: "G2";
+        G3: "G3";
+        G4: "G4";
+        G5: "G5";
+        G6: "G6";
+        G7: "G7";
+        G8: "G8";
+        G9: "G9";
+    }>;
+    gradeName: z.ZodString;
+    capacity: z.ZodNullable<z.ZodNumber>;
+    enrolledCount: z.ZodNumber;
+    classTeacherId: z.ZodNullable<z.ZodUUID>;
+}, z.core.$strip>;
+type ClassSummary = z.infer<typeof ClassSummarySchema>;
+
+export { BranchRefSchema, type BulkUploadStudentRow, BulkUploadStudentRowSchema, type BulkUploadStudentsInput, BulkUploadStudentsInputSchema, type BulkUploadStudentsOutput, BulkUploadStudentsOutputSchema, type ChangePasswordInput, ChangePasswordInputSchema, type ClassSummary, ClassSummarySchema, type CreateDepartmentInput, CreateDepartmentInputSchema, type CreateStaffInput, CreateStaffInputSchema, type CreateStaffOutput, CreateStaffOutputSchema, type CreateStudentInput, CreateStudentInputSchema, type CreateStudentOutput, CreateStudentOutputSchema, CuidSchema, type Department, DepartmentSchema, EmploymentTypeSchema, GenderSchema, GradeLevelSchema, type LinkGuardianInput, LinkGuardianInputSchema, type ListStaffInput, ListStaffInputSchema, type ListStudentsInput, ListStudentsInputSchema, type LoginInput, LoginInputSchema, type LoginOutput, LoginOutputSchema, LogoutInputSchema, type PaginationInput, PaginationInputSchema, type RefreshTokenInput, RefreshTokenInputSchema, type RefreshTokenOutput, RefreshTokenOutputSchema, RequestPasswordResetInputSchema, ResetPasswordInputSchema, RoleNameSchema, type SessionUserOutput, SessionUserOutputSchema, SessionUserRoleSchema, SessionUserSubRoleSchema, type SoftDelete, SoftDeleteSchema, type StaffListItem, StaffListItemSchema, type StaffProfile, StaffProfileSchema, type StudentListItem, StudentListItemSchema, type StudentProfile, StudentProfileSchema, StudentStatusSchema, type SwitchBranchInput, SwitchBranchInputSchema, type Timestamps, TimestampsSchema, UuidSchema, paginatedOutputSchema };