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

package/dist/schemas/index.d.ts

@@ -1,1039 +1,708 @@
-import { z } from 'zod';
+import * as z from 'zod';
 
-declare const uuidSchema: z.ZodString;
-declare const paginationSchema: z.ZodObject<{
-    page: z.ZodDefault<z.ZodNumber>;
-    limit: z.ZodDefault<z.ZodNumber>;
-}, "strip", z.ZodTypeAny, {
-    page: number;
-    limit: number;
-}, {
-    page?: number | undefined;
-    limit?: number | undefined;
-}>;
-declare const dateRangeSchema: z.ZodObject<{
-    from: z.ZodOptional<z.ZodString>;
-    to: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    from?: string | undefined;
-    to?: string | undefined;
-}, {
-    from?: string | undefined;
-    to?: string | undefined;
-}>;
-declare const genderEnum: z.ZodEnum<["male", "female"]>;
-declare const userStatusEnum: z.ZodEnum<["active", "inactive", "suspended"]>;
-declare const systemRoleEnum: z.ZodEnum<["DIRECTOR", "PRINCIPAL", "DEPUTY_PRINCIPAL", "HOD", "CLASS_TEACHER", "SUBJECT_TEACHER", "BURSAR", "HR_ADMIN", "SCHOOL_NURSE", "LIBRARIAN", "LAB_TECHNICIAN", "SPORTS_COACH", "COUNSELLOR", "CARETAKER", "SECURITY", "KITCHEN_STAFF", "DRIVER", "IT_ADMIN", "STUDENT", "PARENT", "ORG_SPONSOR", "INDIVIDUAL_SPONSOR"]>;
-type SystemRole = z.infer<typeof systemRoleEnum>;
-declare const loginInputSchema: z.ZodObject<{
-    email: z.ZodString;
+/**
+ * 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;
-    deviceFingerprint: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    email: string;
-    password: string;
-    deviceFingerprint?: string | undefined;
-}, {
-    email: string;
-    password: string;
-    deviceFingerprint?: string | undefined;
-}>;
-declare const loginOutputSchema: z.ZodObject<{
+    branchId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+declare const LoginOutputSchema: z.ZodObject<{
     accessToken: z.ZodString;
-    refreshToken: z.ZodOptional<z.ZodString>;
+    refreshToken: z.ZodString;
+    expiresIn: z.ZodInt;
     user: z.ZodObject<{
         id: z.ZodString;
+        email: z.ZodEmail;
         firstName: z.ZodString;
-        middleName: z.ZodNullable<z.ZodString>;
         lastName: z.ZodString;
-        email: z.ZodString;
-        avatarUrl: z.ZodNullable<z.ZodString>;
+        activeBranchId: z.ZodString;
         roles: z.ZodArray<z.ZodObject<{
             id: z.ZodString;
             name: z.ZodString;
-            branchId: z.ZodNullable<z.ZodString>;
-        }, "strip", z.ZodTypeAny, {
-            id: string;
-            name: string;
-            branchId: string | null;
-        }, {
-            id: string;
-            name: string;
-            branchId: string | null;
-        }>, "many">;
-        activeBranchId: z.ZodNullable<z.ZodString>;
-        isMfaEnabled: z.ZodBoolean;
-    }, "strip", z.ZodTypeAny, {
-        email: string;
-        id: string;
-        firstName: string;
-        middleName: string | null;
-        lastName: string;
-        avatarUrl: string | null;
-        roles: {
-            id: string;
-            name: string;
-            branchId: string | null;
-        }[];
-        activeBranchId: string | null;
-        isMfaEnabled: boolean;
-    }, {
-        email: string;
-        id: string;
-        firstName: string;
-        middleName: string | null;
-        lastName: string;
-        avatarUrl: string | null;
-        roles: {
-            id: string;
-            name: string;
-            branchId: string | null;
-        }[];
-        activeBranchId: string | null;
-        isMfaEnabled: boolean;
-    }>;
-}, "strip", z.ZodTypeAny, {
-    accessToken: string;
-    user: {
-        email: string;
-        id: string;
-        firstName: string;
-        middleName: string | null;
-        lastName: string;
-        avatarUrl: string | null;
-        roles: {
-            id: string;
-            name: string;
-            branchId: string | null;
-        }[];
-        activeBranchId: string | null;
-        isMfaEnabled: boolean;
-    };
-    refreshToken?: string | undefined;
-}, {
-    accessToken: string;
-    user: {
-        email: string;
-        id: string;
-        firstName: string;
-        middleName: string | null;
-        lastName: string;
-        avatarUrl: string | null;
-        roles: {
-            id: string;
-            name: string;
-            branchId: string | null;
-        }[];
-        activeBranchId: string | null;
-        isMfaEnabled: boolean;
-    };
-    refreshToken?: string | undefined;
-}>;
-declare const refreshTokenOutputSchema: z.ZodObject<{
+            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;
-}, "strip", z.ZodTypeAny, {
-    accessToken: string;
-}, {
-    accessToken: string;
-}>;
-declare const refreshInputSchema: z.ZodObject<{
-    refreshToken: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    refreshToken?: string | undefined;
-}, {
-    refreshToken?: string | undefined;
-}>;
-declare const mfaVerifyInputSchema: z.ZodObject<{
-    totp: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    totp: string;
-}, {
-    totp: string;
-}>;
-declare const changePasswordInputSchema: z.ZodObject<{
+    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;
-}, "strip", z.ZodTypeAny, {
-    currentPassword: string;
-    newPassword: string;
-}, {
-    currentPassword: string;
-    newPassword: string;
+    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 userSchema: z.ZodObject<{
-    id: z.ZodString;
+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;
-    phone: z.ZodNullable<z.ZodString>;
-    avatarUrl: z.ZodNullable<z.ZodString>;
-    isActive: z.ZodBoolean;
-    isMfaEnabled: z.ZodBoolean;
-    lastLoginAt: z.ZodNullable<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;
-}, "strip", z.ZodTypeAny, {
-    email: string;
-    id: string;
-    firstName: string;
-    middleName: string | null;
-    lastName: string;
-    avatarUrl: string | null;
-    isMfaEnabled: boolean;
-    phone: string | null;
-    isActive: boolean;
-    lastLoginAt: string | null;
-    createdAt: string;
-}, {
-    email: string;
-    id: string;
-    firstName: string;
-    middleName: string | null;
-    lastName: string;
-    avatarUrl: string | null;
-    isMfaEnabled: boolean;
-    phone: string | null;
-    isActive: boolean;
-    lastLoginAt: string | null;
-    createdAt: string;
-}>;
-declare const branchSchema: z.ZodObject<{
-    id: 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;
-    code: z.ZodString;
-    address: z.ZodString;
-    county: z.ZodString;
-    phone: z.ZodNullable<z.ZodString>;
-    email: z.ZodNullable<z.ZodString>;
-    logoUrl: z.ZodNullable<z.ZodString>;
-    motto: z.ZodNullable<z.ZodString>;
-    principalId: z.ZodNullable<z.ZodString>;
-    mpesaPaybill: z.ZodNullable<z.ZodString>;
-    featureFlags: z.ZodRecord<z.ZodString, z.ZodBoolean>;
-    createdAt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    code: string;
-    email: string | null;
-    id: string;
-    name: string;
-    phone: string | null;
-    createdAt: string;
-    address: string;
-    county: string;
-    logoUrl: string | null;
-    motto: string | null;
-    principalId: string | null;
-    mpesaPaybill: string | null;
-    featureFlags: Record<string, boolean>;
-}, {
-    code: string;
-    email: string | null;
-    id: string;
-    name: string;
-    phone: string | null;
-    createdAt: string;
-    address: string;
-    county: string;
-    logoUrl: string | null;
-    motto: string | null;
-    principalId: string | null;
-    mpesaPaybill: string | null;
-    featureFlags: Record<string, boolean>;
-}>;
-declare const createBranchInputSchema: z.ZodObject<{
+    hodId: z.ZodNullable<z.ZodUUID>;
+}, z.core.$strip>;
+type Department = z.infer<typeof DepartmentSchema>;
+declare const CreateDepartmentInputSchema: z.ZodObject<{
     name: z.ZodString;
-    code: z.ZodString;
-    address: z.ZodString;
-    county: z.ZodString;
-    phone: z.ZodOptional<z.ZodString>;
-    email: z.ZodOptional<z.ZodString>;
-    motto: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    code: string;
-    name: string;
-    address: string;
-    county: string;
-    email?: string | undefined;
-    phone?: string | undefined;
-    motto?: string | undefined;
-}, {
-    code: string;
-    name: string;
-    address: string;
-    county: string;
-    email?: string | undefined;
-    phone?: string | undefined;
-    motto?: string | undefined;
+    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 studentStatusEnum: z.ZodEnum<["active", "transferred", "graduated", "suspended", "withdrawn"]>;
-declare const studentSchema: z.ZodObject<{
-    id: z.ZodString;
-    branchId: z.ZodString;
+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", "female"]>;
+    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", "transferred", "graduated", "suspended", "withdrawn"]>;
-    currentClassId: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        active: "active";
+        transferred: "transferred";
+        graduated: "graduated";
+        suspended: "suspended";
+        withdrawn: "withdrawn";
+    }>;
     createdAt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    status: "active" | "suspended" | "transferred" | "graduated" | "withdrawn";
-    id: string;
-    firstName: string;
-    middleName: string | null;
-    lastName: string;
-    branchId: string;
-    createdAt: string;
-    admissionNo: string;
-    nemisNo: string | null;
-    dateOfBirth: string;
-    gender: "male" | "female";
-    photoUrl: string | null;
-    bloodGroup: string | null;
-    admissionDate: string;
-    currentClassId: string | null;
-}, {
-    status: "active" | "suspended" | "transferred" | "graduated" | "withdrawn";
-    id: string;
-    firstName: string;
-    middleName: string | null;
-    lastName: string;
-    branchId: string;
-    createdAt: string;
-    admissionNo: string;
-    nemisNo: string | null;
-    dateOfBirth: string;
-    gender: "male" | "female";
-    photoUrl: string | null;
-    bloodGroup: string | null;
-    admissionDate: string;
-    currentClassId: string | null;
-}>;
-declare const createStudentInputSchema: z.ZodObject<{
+    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;
-    nemisNo: z.ZodOptional<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.ZodEnum<["male", "female"]>;
-    admissionDate: z.ZodString;
-    guardianId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    firstName: string;
-    lastName: string;
-    admissionNo: string;
-    dateOfBirth: string;
-    gender: "male" | "female";
-    admissionDate: string;
-    middleName?: string | undefined;
-    nemisNo?: string | undefined;
-    guardianId?: string | undefined;
-}, {
-    firstName: string;
-    lastName: string;
-    admissionNo: string;
-    dateOfBirth: string;
-    gender: "male" | "female";
-    admissionDate: string;
-    middleName?: string | undefined;
-    nemisNo?: string | undefined;
-    guardianId?: string | undefined;
-}>;
-declare const listStudentsInputSchema: z.ZodObject<{
-    page: z.ZodDefault<z.ZodNumber>;
-    limit: z.ZodDefault<z.ZodNumber>;
-} & {
-    branchId: z.ZodOptional<z.ZodString>;
-    classId: z.ZodOptional<z.ZodString>;
-    gradeId: z.ZodOptional<z.ZodString>;
-    search: z.ZodOptional<z.ZodString>;
-    status: z.ZodOptional<z.ZodEnum<["active", "transferred", "graduated", "suspended", "withdrawn"]>>;
-    termId: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    page: number;
-    limit: number;
-    status?: "active" | "suspended" | "transferred" | "graduated" | "withdrawn" | undefined;
-    branchId?: string | undefined;
-    classId?: string | undefined;
-    gradeId?: string | undefined;
-    search?: string | undefined;
-    termId?: string | undefined;
-}, {
-    page?: number | undefined;
-    limit?: number | undefined;
-    status?: "active" | "suspended" | "transferred" | "graduated" | "withdrawn" | undefined;
-    branchId?: string | undefined;
-    classId?: string | undefined;
-    gradeId?: string | undefined;
-    search?: string | undefined;
-    termId?: string | undefined;
-}>;
-declare const guardianSchema: z.ZodObject<{
-    id: z.ZodString;
-    userId: 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.ZodNullable<z.ZodString>;
+    middleName: z.ZodOptional<z.ZodString>;
     lastName: z.ZodString;
     relationship: z.ZodString;
     phone: z.ZodString;
-    email: z.ZodNullable<z.ZodString>;
-    nationalId: z.ZodNullable<z.ZodString>;
-    occupation: z.ZodNullable<z.ZodString>;
-    address: z.ZodNullable<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    email: string | null;
-    id: string;
-    firstName: string;
-    middleName: string | null;
-    lastName: string;
-    phone: string;
-    address: string | null;
-    userId: string;
-    relationship: string;
-    nationalId: string | null;
-    occupation: string | null;
-}, {
-    email: string | null;
-    id: string;
-    firstName: string;
-    middleName: string | null;
-    lastName: string;
-    phone: string;
-    address: string | null;
-    userId: string;
-    relationship: string;
-    nationalId: string | null;
-    occupation: string | null;
-}>;
-declare const sponsorTypeEnum: z.ZodEnum<["organisation", "individual"]>;
-declare const sponsorSchema: z.ZodObject<{
-    id: z.ZodString;
-    branchId: z.ZodString;
-    type: z.ZodEnum<["organisation", "individual"]>;
-    organisationName: z.ZodNullable<z.ZodString>;
-    firstName: z.ZodNullable<z.ZodString>;
-    middleName: z.ZodNullable<z.ZodString>;
-    lastName: z.ZodNullable<z.ZodString>;
-    contactUserId: z.ZodNullable<z.ZodString>;
-    phone: z.ZodString;
-    email: z.ZodNullable<z.ZodString>;
-    address: z.ZodNullable<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    type: "organisation" | "individual";
-    email: string | null;
-    id: string;
-    firstName: string | null;
-    middleName: string | null;
-    lastName: string | null;
-    branchId: string;
-    phone: string;
-    address: string | null;
-    organisationName: string | null;
-    contactUserId: string | null;
-}, {
-    type: "organisation" | "individual";
-    email: string | null;
-    id: string;
-    firstName: string | null;
-    middleName: string | null;
-    lastName: string | null;
-    branchId: string;
-    phone: string;
-    address: string | null;
-    organisationName: string | null;
-    contactUserId: string | null;
-}>;
-declare const gradeLevelEnum: z.ZodEnum<["PP1", "PP2", "G1", "G2", "G3", "G4", "G5", "G6", "G7", "G8", "G9"]>;
-declare const assessmentTypeEnum: z.ZodEnum<["formative", "summative", "knec_national", "informal"]>;
-declare const rubricBandEnum: z.ZodEnum<["EE", "ME", "AE", "BE"]>;
-declare const subjectSchema: z.ZodObject<{
-    id: z.ZodString;
-    branchId: z.ZodString;
-    name: z.ZodString;
-    code: z.ZodString;
-    gradeLevel: z.ZodEnum<["PP1", "PP2", "G1", "G2", "G3", "G4", "G5", "G6", "G7", "G8", "G9"]>;
-    departmentId: z.ZodNullable<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    code: string;
-    id: string;
-    name: string;
-    branchId: string;
-    gradeLevel: "PP1" | "PP2" | "G1" | "G2" | "G3" | "G4" | "G5" | "G6" | "G7" | "G8" | "G9";
-    departmentId: string | null;
-}, {
-    code: string;
-    id: string;
-    name: string;
-    branchId: string;
-    gradeLevel: "PP1" | "PP2" | "G1" | "G2" | "G3" | "G4" | "G5" | "G6" | "G7" | "G8" | "G9";
-    departmentId: string | null;
-}>;
-declare const assessmentScoreInputSchema: z.ZodObject<{
-    assessmentId: z.ZodString;
-    studentId: z.ZodString;
-    subStrandId: z.ZodString;
-    numericScore: z.ZodNumber;
-    comments: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    assessmentId: string;
-    studentId: string;
-    subStrandId: string;
-    numericScore: number;
-    comments?: string | undefined;
-}, {
-    assessmentId: string;
-    studentId: string;
-    subStrandId: string;
-    numericScore: number;
-    comments?: string | undefined;
-}>;
-declare const reportCardStatusEnum: z.ZodEnum<["draft", "hod_review", "principal_review", "released", "blocked"]>;
-declare const feeItemCategoryEnum: z.ZodEnum<["compulsory", "class_specific", "additive"]>;
-declare const paymentMethodEnum: z.ZodEnum<["mpesa", "bank", "card", "cash", "cheque"]>;
-declare const invoiceStatusEnum: z.ZodEnum<["draft", "sent", "partial", "paid", "overdue", "cancelled"]>;
-declare const feeItemSchema: z.ZodObject<{
-    id: z.ZodString;
-    branchId: 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;
-    category: z.ZodEnum<["compulsory", "class_specific", "additive"]>;
-    defaultAmount: z.ZodNumber;
-    applicableGrades: z.ZodArray<z.ZodEnum<["PP1", "PP2", "G1", "G2", "G3", "G4", "G5", "G6", "G7", "G8", "G9"]>, "many">;
-    isActive: z.ZodBoolean;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    name: string;
-    branchId: string;
-    isActive: boolean;
-    category: "compulsory" | "class_specific" | "additive";
-    defaultAmount: number;
-    applicableGrades: ("PP1" | "PP2" | "G1" | "G2" | "G3" | "G4" | "G5" | "G6" | "G7" | "G8" | "G9")[];
-}, {
-    id: string;
-    name: string;
-    branchId: string;
-    isActive: boolean;
-    category: "compulsory" | "class_specific" | "additive";
-    defaultAmount: number;
-    applicableGrades: ("PP1" | "PP2" | "G1" | "G2" | "G3" | "G4" | "G5" | "G6" | "G7" | "G8" | "G9")[];
-}>;
-declare const recordPaymentInputSchema: z.ZodObject<{
-    studentId: z.ZodString;
-    invoiceId: z.ZodString;
-    amount: z.ZodNumber;
-    method: z.ZodEnum<["mpesa", "bank", "card", "cash", "cheque"]>;
-    reference: z.ZodOptional<z.ZodString>;
-    mpesaReceipt: z.ZodOptional<z.ZodString>;
-    paymentDate: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    studentId: string;
-    invoiceId: string;
-    amount: number;
-    method: "mpesa" | "bank" | "card" | "cash" | "cheque";
-    paymentDate: string;
-    reference?: string | undefined;
-    mpesaReceipt?: string | undefined;
-}, {
-    studentId: string;
-    invoiceId: string;
-    amount: number;
-    method: "mpesa" | "bank" | "card" | "cash" | "cheque";
-    paymentDate: string;
-    reference?: string | undefined;
-    mpesaReceipt?: string | undefined;
-}>;
-declare const employmentTypeEnum: z.ZodEnum<["permanent", "contract", "temporary", "intern"]>;
-declare const staffSchema: z.ZodObject<{
-    id: z.ZodString;
-    branchId: z.ZodString;
-    userId: z.ZodString;
-    firstName: z.ZodString;
-    middleName: z.ZodNullable<z.ZodString>;
-    lastName: z.ZodString;
-    tscNumber: z.ZodNullable<z.ZodString>;
-    nationalId: z.ZodString;
-    kraPin: z.ZodNullable<z.ZodString>;
-    nhifNo: z.ZodNullable<z.ZodString>;
-    nssfNo: z.ZodNullable<z.ZodString>;
-    phone: z.ZodString;
-    departmentId: z.ZodNullable<z.ZodString>;
-    designation: z.ZodString;
-    employmentType: z.ZodEnum<["permanent", "contract", "temporary", "intern"]>;
-    contractStart: z.ZodString;
-    contractEnd: z.ZodNullable<z.ZodString>;
-    basicSalary: z.ZodNumber;
-    houseAllowance: z.ZodDefault<z.ZodNumber>;
-    transportAllowance: z.ZodDefault<z.ZodNumber>;
-    bankName: z.ZodNullable<z.ZodString>;
-    bankAccount: z.ZodNullable<z.ZodString>;
-    status: z.ZodEnum<["active", "inactive", "suspended"]>;
-}, "strip", z.ZodTypeAny, {
-    status: "active" | "inactive" | "suspended";
-    id: string;
-    firstName: string;
-    middleName: string | null;
-    lastName: string;
-    branchId: string;
-    phone: string;
-    userId: string;
-    nationalId: string;
-    departmentId: string | null;
-    tscNumber: string | null;
-    kraPin: string | null;
-    nhifNo: string | null;
-    nssfNo: string | null;
-    designation: string;
-    employmentType: "permanent" | "contract" | "temporary" | "intern";
-    contractStart: string;
-    contractEnd: string | null;
-    basicSalary: number;
-    houseAllowance: number;
-    transportAllowance: number;
-    bankName: string | null;
-    bankAccount: string | null;
-}, {
-    status: "active" | "inactive" | "suspended";
-    id: string;
-    firstName: string;
-    middleName: string | null;
-    lastName: string;
-    branchId: string;
-    phone: string;
-    userId: string;
-    nationalId: string;
-    departmentId: string | null;
-    tscNumber: string | null;
-    kraPin: string | null;
-    nhifNo: string | null;
-    nssfNo: string | null;
-    designation: string;
-    employmentType: "permanent" | "contract" | "temporary" | "intern";
-    contractStart: string;
-    contractEnd: string | null;
-    basicSalary: number;
-    bankName: string | null;
-    bankAccount: string | null;
-    houseAllowance?: number | undefined;
-    transportAllowance?: number | undefined;
-}>;
-declare const leaveStatusEnum: z.ZodEnum<["pending", "approved", "rejected", "cancelled"]>;
-declare const leaveRequestInputSchema: z.ZodObject<{
-    leaveTypeId: z.ZodString;
-    startDate: z.ZodString;
-    endDate: z.ZodString;
-    reason: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    leaveTypeId: string;
-    startDate: string;
-    endDate: string;
-    reason: string;
-}, {
-    leaveTypeId: string;
-    startDate: string;
-    endDate: string;
-    reason: string;
-}>;
-declare const vehicleOwnershipEnum: z.ZodEnum<["owned", "contracted"]>;
-declare const vehicleTypeEnum: z.ZodEnum<["bus", "van", "pickup", "other"]>;
-declare const busRegisterStatusEnum: z.ZodEnum<["boarded", "alighted", "absent"]>;
-declare const tripLogInputSchema: z.ZodObject<{
-    vehicleId: z.ZodString;
-    routeId: z.ZodString;
-    departureTime: z.ZodString;
-    tripType: z.ZodEnum<["morning", "evening", "errand"]>;
-}, "strip", z.ZodTypeAny, {
-    vehicleId: string;
-    routeId: string;
-    departureTime: string;
-    tripType: "morning" | "evening" | "errand";
-}, {
-    vehicleId: string;
-    routeId: string;
-    departureTime: string;
-    tripType: "morning" | "evening" | "errand";
-}>;
-declare const busRegisterEntrySchema: z.ZodObject<{
-    studentId: z.ZodString;
-    status: z.ZodEnum<["boarded", "alighted", "absent"]>;
-}, "strip", z.ZodTypeAny, {
-    status: "boarded" | "alighted" | "absent";
-    studentId: string;
-}, {
-    status: "boarded" | "alighted" | "absent";
-    studentId: string;
-}>;
-declare const vehicleStatusEnum: z.ZodEnum<["active", "in_maintenance", "decommissioned"]>;
-declare const tripCategoryEnum: z.ZodEnum<["regular", "special"]>;
-declare const tripStatusEnum: z.ZodEnum<["scheduled", "in_progress", "completed", "cancelled"]>;
-declare const transportAppStatusEnum: z.ZodEnum<["pending", "approved", "rejected", "cancelled"]>;
-declare const maintenanceRequestStatusEnum: z.ZodEnum<["pending", "approved", "rejected", "resolved"]>;
-declare const vehicleSchema: z.ZodObject<{
-    id: z.ZodString;
-    branchId: z.ZodString;
-    plateNo: z.ZodString;
-    make: z.ZodNullable<z.ZodString>;
-    model: z.ZodNullable<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>;
-    type: z.ZodString;
-    ownershipType: z.ZodEnum<["owned", "contracted"]>;
-    insuranceExpiry: z.ZodNullable<z.ZodString>;
-    inspectionDate: z.ZodNullable<z.ZodString>;
-    status: z.ZodEnum<["active", "in_maintenance", "decommissioned"]>;
-    driverUserId: z.ZodNullable<z.ZodString>;
-    notes: z.ZodNullable<z.ZodString>;
-    createdAt: z.ZodString;
-}, "strip", z.ZodTypeAny, {
-    type: string;
-    status: "active" | "in_maintenance" | "decommissioned";
-    id: string;
-    branchId: string;
-    createdAt: string;
-    plateNo: string;
-    make: string | null;
-    model: string | null;
-    capacity: number | null;
-    ownershipType: "owned" | "contracted";
-    insuranceExpiry: string | null;
-    inspectionDate: string | null;
-    driverUserId: string | null;
-    notes: string | null;
-}, {
-    type: string;
-    status: "active" | "in_maintenance" | "decommissioned";
-    id: string;
-    branchId: string;
-    createdAt: string;
-    plateNo: string;
-    make: string | null;
-    model: string | null;
-    capacity: number | null;
-    ownershipType: "owned" | "contracted";
-    insuranceExpiry: string | null;
-    inspectionDate: string | null;
-    driverUserId: string | null;
-    notes: string | null;
-}>;
-declare const routeSchema: z.ZodObject<{
-    id: z.ZodString;
-    branchId: z.ZodString;
-    name: z.ZodString;
-    description: z.ZodNullable<z.ZodString>;
-    isActive: z.ZodBoolean;
-    vehicleId: z.ZodNullable<z.ZodString>;
-    routeCategory: z.ZodString;
-    departureTime: z.ZodNullable<z.ZodString>;
-    returnTime: z.ZodNullable<z.ZodString>;
-    fare: z.ZodNullable<z.ZodNumber>;
-    vehicle: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        plateNo: z.ZodString;
-        type: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        type: string;
-        plateNo: string;
-    }, {
-        type: string;
-        plateNo: string;
-    }>>>;
-    stops: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        id: z.ZodString;
-        stopName: z.ZodString;
-        stopOrder: z.ZodNumber;
-        estimatedTime: z.ZodNullable<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        id: string;
-        stopName: string;
-        stopOrder: number;
-        estimatedTime: string | null;
-    }, {
-        id: string;
-        stopName: string;
-        stopOrder: number;
-        estimatedTime: string | null;
-    }>, "many">>;
-    roster: z.ZodOptional<z.ZodArray<z.ZodObject<{
-        studentId: z.ZodString;
-        studentName: z.ZodString;
-        admissionNo: z.ZodString;
-        pickupStop: z.ZodNullable<z.ZodString>;
-        dropoffStop: z.ZodNullable<z.ZodString>;
-    }, "strip", z.ZodTypeAny, {
-        admissionNo: string;
-        studentId: string;
-        studentName: string;
-        pickupStop: string | null;
-        dropoffStop: string | null;
-    }, {
-        admissionNo: string;
-        studentId: string;
-        studentName: string;
-        pickupStop: string | null;
-        dropoffStop: string | null;
-    }>, "many">>;
-}, "strip", z.ZodTypeAny, {
-    id: string;
-    name: string;
-    branchId: string;
-    isActive: boolean;
-    vehicleId: string | null;
-    departureTime: string | null;
-    description: string | null;
-    routeCategory: string;
-    returnTime: string | null;
-    fare: number | null;
-    vehicle?: {
-        type: string;
-        plateNo: string;
-    } | null | undefined;
-    stops?: {
-        id: string;
-        stopName: string;
-        stopOrder: number;
-        estimatedTime: string | null;
-    }[] | undefined;
-    roster?: {
-        admissionNo: string;
-        studentId: string;
-        studentName: string;
-        pickupStop: string | null;
-        dropoffStop: string | null;
-    }[] | undefined;
-}, {
-    id: string;
-    name: string;
-    branchId: string;
-    isActive: boolean;
-    vehicleId: string | null;
-    departureTime: string | null;
-    description: string | null;
-    routeCategory: string;
-    returnTime: string | null;
-    fare: number | null;
-    vehicle?: {
-        type: string;
-        plateNo: string;
-    } | null | undefined;
-    stops?: {
-        id: string;
-        stopName: string;
-        stopOrder: number;
-        estimatedTime: string | null;
-    }[] | undefined;
-    roster?: {
-        admissionNo: string;
-        studentId: string;
-        studentName: string;
-        pickupStop: string | null;
-        dropoffStop: string | null;
-    }[] | undefined;
-}>;
-declare const tripLogSchema: z.ZodObject<{
-    id: z.ZodString;
-    branchId: z.ZodString;
-    vehicleId: z.ZodString;
-    routeId: z.ZodNullable<z.ZodString>;
-    driverUserId: z.ZodString;
-    departureTime: z.ZodString;
-    arrivalTime: z.ZodNullable<z.ZodString>;
-    returnTime: z.ZodNullable<z.ZodString>;
-    tripType: z.ZodString;
-    tripCategory: z.ZodEnum<["regular", "special"]>;
-    status: z.ZodEnum<["scheduled", "in_progress", "completed", "cancelled"]>;
-    title: z.ZodNullable<z.ZodString>;
-    description: z.ZodNullable<z.ZodString>;
-    destination: z.ZodNullable<z.ZodString>;
-    expectedStudents: z.ZodNullable<z.ZodNumber>;
-    notes: z.ZodNullable<z.ZodString>;
-    createdAt: z.ZodString;
-    vehicle: z.ZodOptional<z.ZodObject<{
-        plateNo: z.ZodString;
-        type: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        type: string;
-        plateNo: string;
-    }, {
-        type: string;
-        plateNo: string;
-    }>>;
-    route: z.ZodOptional<z.ZodNullable<z.ZodObject<{
-        name: z.ZodString;
-    }, "strip", z.ZodTypeAny, {
-        name: string;
-    }, {
-        name: string;
-    }>>>;
-}, "strip", z.ZodTypeAny, {
-    status: "cancelled" | "scheduled" | "in_progress" | "completed";
-    id: string;
-    branchId: string;
-    createdAt: string;
-    vehicleId: string;
-    routeId: string | null;
-    departureTime: string;
-    tripType: string;
-    driverUserId: string;
-    notes: string | null;
-    description: string | null;
-    returnTime: string | null;
-    arrivalTime: string | null;
-    tripCategory: "regular" | "special";
-    title: string | null;
-    destination: string | null;
-    expectedStudents: number | null;
-    vehicle?: {
-        type: string;
-        plateNo: string;
-    } | undefined;
-    route?: {
-        name: string;
-    } | null | undefined;
-}, {
-    status: "cancelled" | "scheduled" | "in_progress" | "completed";
-    id: string;
-    branchId: string;
-    createdAt: string;
-    vehicleId: string;
-    routeId: string | null;
-    departureTime: string;
-    tripType: string;
-    driverUserId: string;
-    notes: string | null;
-    description: string | null;
-    returnTime: string | null;
-    arrivalTime: string | null;
-    tripCategory: "regular" | "special";
-    title: string | null;
-    destination: string | null;
-    expectedStudents: number | null;
-    vehicle?: {
-        type: string;
-        plateNo: string;
-    } | undefined;
-    route?: {
-        name: string;
-    } | null | undefined;
-}>;
-declare const maintenanceRequestSchema: z.ZodObject<{
-    id: z.ZodString;
-    vehicleId: z.ZodString;
-    requestedBy: z.ZodString;
-    issue: z.ZodString;
-    severity: z.ZodString;
-    status: z.ZodEnum<["pending", "approved", "rejected", "resolved"]>;
-    reviewedBy: z.ZodNullable<z.ZodString>;
-    reviewNotes: z.ZodNullable<z.ZodString>;
-    reviewedAt: z.ZodNullable<z.ZodString>;
-    createdAt: z.ZodString;
-    vehiclePlate: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    status: "pending" | "approved" | "rejected" | "resolved";
-    id: string;
-    createdAt: string;
-    vehicleId: string;
-    requestedBy: string;
-    issue: string;
-    severity: string;
-    reviewedBy: string | null;
-    reviewNotes: string | null;
-    reviewedAt: string | null;
-    vehiclePlate?: string | undefined;
-}, {
-    status: "pending" | "approved" | "rejected" | "resolved";
-    id: string;
-    createdAt: string;
-    vehicleId: string;
-    requestedBy: string;
-    issue: string;
-    severity: string;
-    reviewedBy: string | null;
-    reviewNotes: string | null;
-    reviewedAt: string | null;
-    vehiclePlate?: string | undefined;
-}>;
-declare const transportApplicationSchema: z.ZodObject<{
-    id: z.ZodString;
-    branchId: z.ZodString;
-    studentId: z.ZodString;
-    applicationType: z.ZodEnum<["route", "trip"]>;
-    routeId: z.ZodNullable<z.ZodString>;
-    tripLogId: z.ZodNullable<z.ZodString>;
-    status: z.ZodEnum<["pending", "approved", "rejected", "cancelled"]>;
-    appliedBy: z.ZodString;
-    reviewedBy: z.ZodNullable<z.ZodString>;
-    reviewNotes: z.ZodNullable<z.ZodString>;
-    feeItemId: z.ZodNullable<z.ZodString>;
-    invoiceUpdated: z.ZodBoolean;
-    createdAt: z.ZodString;
-    studentName: z.ZodOptional<z.ZodString>;
-    routeName: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-    tripTitle: z.ZodOptional<z.ZodNullable<z.ZodString>>;
-}, "strip", z.ZodTypeAny, {
-    status: "cancelled" | "pending" | "approved" | "rejected";
-    id: string;
-    branchId: string;
-    createdAt: string;
-    studentId: string;
-    routeId: string | null;
-    reviewedBy: string | null;
-    reviewNotes: string | null;
-    applicationType: "route" | "trip";
-    tripLogId: string | null;
-    appliedBy: string;
-    feeItemId: string | null;
-    invoiceUpdated: boolean;
-    studentName?: string | undefined;
-    routeName?: string | null | undefined;
-    tripTitle?: string | null | undefined;
-}, {
-    status: "cancelled" | "pending" | "approved" | "rejected";
-    id: string;
-    branchId: string;
-    createdAt: string;
-    studentId: string;
-    routeId: string | null;
-    reviewedBy: string | null;
-    reviewNotes: string | null;
-    applicationType: "route" | "trip";
-    tripLogId: string | null;
-    appliedBy: string;
-    feeItemId: string | null;
-    invoiceUpdated: boolean;
-    studentName?: string | undefined;
-    routeName?: string | null | undefined;
-    tripTitle?: string | null | undefined;
-}>;
-declare const assetCategoryEnum: z.ZodEnum<["furniture", "lab_equipment", "ict_device", "vehicle", "sports_equipment", "kitchen_equipment", "musical_instrument", "classroom_supply", "library_book", "other"]>;
-declare const assetConditionEnum: z.ZodEnum<["excellent", "good", "fair", "poor", "condemned"]>;
-declare const maintenanceTicketStatusEnum: z.ZodEnum<["open", "in_progress", "resolved", "closed"]>;
-declare const borrowingStatusEnum: z.ZodEnum<["active", "returned", "overdue", "lost"]>;
-declare const incidentSeverityEnum: z.ZodEnum<["minor", "moderate", "serious", "critical"]>;
-declare const incidentStatusEnum: z.ZodEnum<["open", "counsellor_review", "hod_review", "principal_ruling", "resolved"]>;
-declare const disciplineRulingEnum: z.ZodEnum<["verbal_warning", "written_warning", "suspension", "expulsion", "dismissed"]>;
-declare const payrollRunStatusEnum: z.ZodEnum<["draft", "approved", "paid"]>;
-declare const notificationTypeEnum: z.ZodEnum<["report_card", "fee_invoice", "fee_reminder", "fee_block", "attendance_absent", "bus_departed", "bus_arrived", "discipline_incident", "assignment", "notice", "leave", "payslip"]>;
-declare const sendBulkSmsInputSchema: z.ZodObject<{
-    branchId: z.ZodString;
-    message: z.ZodString;
-    recipientType: z.ZodEnum<["class", "grade", "whole_school", "custom"]>;
-    recipientIds: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
-    scheduleAt: z.ZodOptional<z.ZodString>;
-}, "strip", z.ZodTypeAny, {
-    message: string;
-    branchId: string;
-    recipientType: "custom" | "class" | "grade" | "whole_school";
-    recipientIds?: string[] | undefined;
-    scheduleAt?: string | undefined;
-}, {
-    message: string;
-    branchId: string;
-    recipientType: "custom" | "class" | "grade" | "whole_school";
-    recipientIds?: string[] | undefined;
-    scheduleAt?: string | undefined;
-}>;
+    enrolledCount: z.ZodNumber;
+    classTeacherId: z.ZodNullable<z.ZodUUID>;
+}, z.core.$strip>;
+type ClassSummary = z.infer<typeof ClassSummarySchema>;
 
-export { type SystemRole, assessmentScoreInputSchema, assessmentTypeEnum, assetCategoryEnum, assetConditionEnum, borrowingStatusEnum, branchSchema, busRegisterEntrySchema, busRegisterStatusEnum, changePasswordInputSchema, createBranchInputSchema, createStudentInputSchema, dateRangeSchema, disciplineRulingEnum, employmentTypeEnum, feeItemCategoryEnum, feeItemSchema, genderEnum, gradeLevelEnum, guardianSchema, incidentSeverityEnum, incidentStatusEnum, invoiceStatusEnum, leaveRequestInputSchema, leaveStatusEnum, listStudentsInputSchema, loginInputSchema, loginOutputSchema, maintenanceRequestSchema, maintenanceRequestStatusEnum, maintenanceTicketStatusEnum, mfaVerifyInputSchema, notificationTypeEnum, paginationSchema, paymentMethodEnum, payrollRunStatusEnum, recordPaymentInputSchema, refreshInputSchema, refreshTokenOutputSchema, reportCardStatusEnum, routeSchema, rubricBandEnum, sendBulkSmsInputSchema, sponsorSchema, sponsorTypeEnum, staffSchema, studentSchema, studentStatusEnum, subjectSchema, systemRoleEnum, transportAppStatusEnum, transportApplicationSchema, tripCategoryEnum, tripLogInputSchema, tripLogSchema, tripStatusEnum, userSchema, userStatusEnum, uuidSchema, vehicleOwnershipEnum, vehicleSchema, vehicleStatusEnum, vehicleTypeEnum };
+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 };