@brite-future-schools-contracts/contracts 2.0.10 → 2.0.15

package/dist/schemas/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/schemas/index.ts","../../src/schemas/base.ts","../../src/schemas/auth.ts","../../src/schemas/hr.ts","../../src/schemas/students.ts","../../src/schemas/attendance.ts"],"sourcesContent":["/**\n * Brite Future Schools — bfs-contracts\n * Schemas barrel.\n *\n * Phase History:\n *   Phase 0.1 (2026-06-05): Initial creation\n *   Phase 1   (2026-06-07): Added hr and students schemas\n *   Phase 2.1 (2026-06-08): Added attendance schemas\n *\n * @module src/schemas/index\n * @since Phase 0.1\n */\nexport * from './base.js'\nexport * from './auth.js'\nexport * from './hr.js'\nexport * from './students.js'\nexport * from './attendance.js'","/**\n * Brite Future Schools — bfs-contracts\n * Base Zod schemas: reusable primitives shared across all domain schemas.\n *\n * Phase History:\n *   Phase 0.1 (2026-06-05): Initial creation\n *\n * @module src/schemas/base\n * @since Phase 0.1\n */\n\nimport * as z from 'zod'\n\n// ── ID ─────────────────────────────────────────────────────────────────────────\n\nexport const CuidSchema = z\n    .string()\n    .regex(/^[a-z][a-z0-9]{24}$/, 'Invalid cuid2 identifier')\n    .meta({ description: 'cuid2 — prefixed, collision-resistant identifier' })\n\n// ── UUID ───────────────────────────────────────────────────────────────────────\n\nexport const UuidSchema = z\n    .uuidv4()\n    .meta({ description: 'RFC-4122 UUID v4' })\n\n// ── Timestamps ─────────────────────────────────────────────────────────────────\n\nconst IsoDatetime = z.iso.datetime()\n\nexport const TimestampsSchema = z.object({\n    createdAt: IsoDatetime.meta({ description: 'ISO-8601 creation time (UTC)' }),\n    updatedAt: IsoDatetime.meta({ description: 'ISO-8601 last update time (UTC)' }),\n})\n\n// ── Soft-delete ────────────────────────────────────────────────────────────────\n\nexport const SoftDeleteSchema = z.object({\n    deletedAt: IsoDatetime.nullable().meta({\n        description: 'Set when the record is soft-deleted; null if active',\n    }),\n})\n\n// ── Pagination ─────────────────────────────────────────────────────────────────\n\nexport const PaginationInputSchema = z.object({\n    cursor: CuidSchema.optional().meta({\n        description: 'Opaque cursor from the previous page response',\n    }),\n    limit: z\n        .int()\n        .min(1)\n        .max(100)\n        .default(20)\n        .meta({ description: 'Number of items to return (1–100, default 20)' }),\n})\n\nexport function paginatedOutputSchema<T extends z.ZodTypeAny>(itemSchema: T) {\n    return z.object({\n        items: z.array(itemSchema),\n        nextCursor: CuidSchema.nullable().meta({\n            description: 'Pass as `cursor` on the next request; null when no more pages',\n        }),\n        total: z\n            .int()\n            .nonnegative()\n            .meta({ description: 'Total matching records (before pagination)' }),\n    })\n}\n\n// ── Branch reference ───────────────────────────────────────────────────────────\n\nexport const BranchRefSchema = z.object({\n    branchId: CuidSchema.meta({ description: 'The branch this record belongs to' }),\n})\n\n// ── Inferred types ─────────────────────────────────────────────────────────────\n\nexport type Timestamps = z.infer<typeof TimestampsSchema>\nexport type SoftDelete = z.infer<typeof SoftDeleteSchema>\nexport type PaginationInput = z.infer<typeof PaginationInputSchema>","/**\n * Brite Future Schools — bfs-contracts\n * Auth-related Zod schemas.\n *\n * Phase History:\n *   Phase 0.1 (2026-06-05): Initial creation\n *\n * @module src/schemas/auth\n * @since Phase 0.1\n */\n\nimport * as z from 'zod'\nimport { CuidSchema } from './base.js'\n\n// ── Session user (defined first — referenced by LoginOutputSchema below) ───────\n\nexport const SessionUserRoleSchema = z.object({\n    id: CuidSchema,\n    name: z.string().meta({ description: 'Role name, e.g. PRINCIPAL' }),\n    branchId: CuidSchema,\n    isPrimary: z.boolean(),\n})\n\nexport const SessionUserSubRoleSchema = z.object({\n    id: CuidSchema,\n    name: z.string().meta({ description: 'Sub-role name, e.g. HEAD_PREFECT' }),\n    branchId: CuidSchema,\n})\n\nexport const SessionUserOutputSchema = z.object({\n    id: CuidSchema,\n    email: z.email(),\n    firstName: z.string(),\n    lastName: z.string(),\n    activeBranchId: CuidSchema,\n    roles: z.array(SessionUserRoleSchema),\n    subRoles: z.array(SessionUserSubRoleSchema),\n    isActive: z.boolean(),\n    mustChangePassword: z.boolean(),\n})\n\n// ── Login ──────────────────────────────────────────────────────────────────────\n\nexport const LoginInputSchema = z.object({\n    email: z.email().meta({ description: 'User email address' }),\n    password: z.string().min(1).meta({ description: 'Plain-text password (sent over TLS)' }),\n    branchId: CuidSchema.optional().meta({\n        description: 'Branch to activate on login; defaults to user primary branch',\n    }),\n})\n\nexport const LoginOutputSchema = z.object({\n    accessToken: z.string().meta({ description: 'Short-lived JWT (15 min)' }),\n    refreshToken: z.string().meta({ description: 'Long-lived opaque refresh token (7 days)' }),\n    expiresIn: z.int().positive().meta({ description: 'Access token TTL in seconds' }),\n    user: SessionUserOutputSchema,\n})\n\n// ── Token refresh ──────────────────────────────────────────────────────────────\n\nexport const RefreshTokenInputSchema = z.object({\n    refreshToken: z.string().min(1),\n})\n\nexport const RefreshTokenOutputSchema = z.object({\n    accessToken: z.string(),\n    expiresIn: z.int().positive(),\n})\n\n// ── Logout ─────────────────────────────────────────────────────────────────────\n\nexport const LogoutInputSchema = z.object({\n    refreshToken: z.string().min(1).meta({\n        description: 'The refresh token to revoke; also invalidated server-side',\n    }),\n})\n\n// ── Password change ─────────────────────────────────────────────────────────────\n\nexport const ChangePasswordInputSchema = z\n    .object({\n        currentPassword: z.string().min(1),\n        newPassword: z\n            .string()\n            .min(8, { error: 'Password must be at least 8 characters' }),\n        confirmPassword: z.string().min(1),\n    })\n    .refine((v) => v.newPassword === v.confirmPassword, {\n        error: 'Passwords do not match',\n        path: ['confirmPassword'],\n    })\n\n// ── Password reset ─────────────────────────────────────────────────────────────\n\nexport const RequestPasswordResetInputSchema = z.object({\n    email: z.email(),\n})\n\nexport const ResetPasswordInputSchema = z\n    .object({\n        token: z.string().min(1).meta({ description: 'One-time reset token from email link' }),\n        newPassword: z.string().min(8, { error: 'Password must be at least 8 characters' }),\n        confirmPassword: z.string().min(1),\n    })\n    .refine((v) => v.newPassword === v.confirmPassword, {\n        error: 'Passwords do not match',\n        path: ['confirmPassword'],\n    })\n\n// ── Branch switch ───────────────────────────────────────────────────────────────\n\nexport const SwitchBranchInputSchema = z.object({\n    branchId: z.string().uuid().meta({ description: 'Branch to switch the active session to' }),\n})\n\n// ── Inferred types ──────────────────────────────────────────────────────────────\n\nexport type LoginInput = z.infer<typeof LoginInputSchema>\nexport type LoginOutput = z.infer<typeof LoginOutputSchema>\nexport type SessionUserOutput = z.infer<typeof SessionUserOutputSchema>\nexport type RefreshTokenInput = z.infer<typeof RefreshTokenInputSchema>\nexport type RefreshTokenOutput = z.infer<typeof RefreshTokenOutputSchema>\nexport type ChangePasswordInput = z.infer<typeof ChangePasswordInputSchema>\nexport type SwitchBranchInput = z.infer<typeof SwitchBranchInputSchema>","/**\n * Brite Future Schools — bfs-contracts\n * HR domain Zod schemas — staff creation, listing, and profiles.\n *\n * Phase History:\n *   Phase 1 (2026-06-07): Initial creation — staff.create, staff.list,\n *                          staff.getById wire types\n *\n * @module src/schemas/hr\n * @since Phase 1\n */\n\nimport * as z from 'zod'\nimport { UuidSchema, PaginationInputSchema } from './base.js'\n\n// ── Enums ──────────────────────────────────────────────────────────────────────\n\nexport const EmploymentTypeSchema = z.enum([\n    'permanent',\n    'contract',\n    'temporary',\n    'intern',\n])\n\nexport const RoleNameSchema = z.enum([\n    'PROPRIETOR',\n    'DIRECTOR',\n    'SYSTEM_ADMIN',\n    'PRINCIPAL',\n    'DEPUTY_PRINCIPAL',\n    'HOD',\n    'CLASS_TEACHER',\n    'SUBJECT_TEACHER',\n    'BURSAR',\n    'HR_ADMIN',\n    'SCHOOL_NURSE',\n    'LIBRARIAN',\n    'LAB_TECHNICIAN',\n    'SPORTS_COACH',\n    'COUNSELLOR',\n    'CARETAKER',\n    'SECURITY',\n    'KITCHEN_STAFF',\n    'KITCHEN_MANAGER',\n    'DRIVER',\n    'IT_ADMIN',\n    'BOARDING_MASTER',\n    'PREFECT',\n    'STUDENT',\n    'PARENT',\n    'ORG_SPONSOR',\n    'INDIVIDUAL_SPONSOR',\n])\n\n// ── Create staff ───────────────────────────────────────────────────────────────\n\nexport const CreateStaffInputSchema = z.object({\n    // Personal details\n    firstName: z.string().min(1).max(100),\n    middleName: z.string().max(100).optional(),\n    lastName: z.string().min(1).max(100),\n    email: z.email(),\n    phone: z.string().min(9).max(30),\n    nationalId: z.string().min(1).max(20),\n\n    // Role assignment\n    roleName: RoleNameSchema.meta({\n        description: 'System role to assign — determines dashboard access and permissions',\n    }),\n    isPrimaryRole: z.boolean().default(true),\n\n    // Employment details\n    departmentId: UuidSchema.optional(),\n    designation: z.string().min(1).max(100).meta({\n        description: 'Job title, e.g. \"Mathematics Teacher\", \"Head of Finance\"',\n    }),\n    employmentType: EmploymentTypeSchema,\n    contractStart: z.iso.date().meta({ description: 'ISO date, e.g. 2026-01-15' }),\n    contractEnd: z.iso.date().optional(),\n\n    // Payroll\n    basicSalary: z.number().positive(),\n    houseAllowance: z.number().nonnegative().default(0),\n    transportAllowance: z.number().nonnegative().default(0),\n    helbDeduction: z.number().nonnegative().default(0),\n    saccoDeduction: z.number().nonnegative().default(0),\n\n    // Banking\n    bankName: z.string().max(100).optional(),\n    bankAccount: z.string().max(30).optional(),\n    bankBranch: z.string().max(100).optional(),\n\n    // Statutory\n    tscNumber: z.string().max(30).optional(),\n    kraPin: z.string().max(20).optional(),\n    nhifNo: z.string().max(20).optional(),\n    nssfNo: z.string().max(20).optional(),\n})\n\nexport type CreateStaffInput = z.infer<typeof CreateStaffInputSchema>\n\n// ── Staff profile (output) ─────────────────────────────────────────────────────\n\nexport const StaffProfileSchema = z.object({\n    // Staff record\n    id: UuidSchema,\n    userId: UuidSchema,\n    branchId: UuidSchema,\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    phone: z.string(),\n    nationalId: z.string(),\n    tscNumber: z.string().nullable(),\n    kraPin: z.string().nullable(),\n    nhifNo: z.string().nullable(),\n    nssfNo: z.string().nullable(),\n    designation: z.string(),\n    employmentType: EmploymentTypeSchema,\n    contractStart: z.string(),\n    contractEnd: z.string().nullable(),\n    basicSalary: z.string(),\n    houseAllowance: z.string(),\n    transportAllowance: z.string(),\n    helbDeduction: z.string().nullable(),\n    saccoDeduction: z.string().nullable(),\n    bankName: z.string().nullable(),\n    bankAccount: z.string().nullable(),\n    bankBranch: z.string().nullable(),\n    status: z.string(),\n    createdAt: z.string(),\n\n    // From users join\n    email: z.string(),\n    mustChangePassword: z.boolean(),\n\n    // Department (nullable — not all staff are in a department)\n    departmentId: UuidSchema.nullable(),\n    departmentName: z.string().nullable(),\n\n    // Primary role\n    roleName: RoleNameSchema.nullable(),\n    roleId: UuidSchema.nullable(),\n})\n\nexport type StaffProfile = z.infer<typeof StaffProfileSchema>\n\n// ── Staff list item (lighter than full profile) ────────────────────────────────\n\nexport const StaffListItemSchema = z.object({\n    id: UuidSchema,\n    userId: UuidSchema,\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    email: z.string(),\n    phone: z.string(),\n    designation: z.string(),\n    employmentType: EmploymentTypeSchema,\n    status: z.string(),\n    departmentName: z.string().nullable(),\n    roleName: RoleNameSchema.nullable(),\n    createdAt: z.string(),\n})\n\nexport type StaffListItem = z.infer<typeof StaffListItemSchema>\n\n// ── List staff input ───────────────────────────────────────────────────────────\n\nexport const ListStaffInputSchema = PaginationInputSchema.extend({\n    search: z.string().optional().meta({\n        description: 'Search by name or email',\n    }),\n    departmentId: UuidSchema.optional(),\n    roleName: RoleNameSchema.optional(),\n    status: z.enum(['active', 'inactive']).optional(),\n})\n\nexport type ListStaffInput = z.infer<typeof ListStaffInputSchema>\n\n// ── Create staff output ────────────────────────────────────────────────────────\n\nexport const CreateStaffOutputSchema = z.object({\n    staffId: UuidSchema,\n    userId: UuidSchema,\n    email: z.string(),\n    /** Temp password was emailed — not returned in response for security */\n    emailSent: z.boolean(),\n})\n\nexport type CreateStaffOutput = z.infer<typeof CreateStaffOutputSchema>\n\n// ── Department ─────────────────────────────────────────────────────────────────\n\nexport const DepartmentSchema = z.object({\n    id: UuidSchema,\n    branchId: UuidSchema,\n    name: z.string(),\n    hodId: UuidSchema.nullable(),\n})\n\nexport type Department = z.infer<typeof DepartmentSchema>\n\nexport const CreateDepartmentInputSchema = z.object({\n    name: z.string().min(1).max(100),\n    hodId: UuidSchema.optional(),\n})\n\nexport type CreateDepartmentInput = z.infer<typeof CreateDepartmentInputSchema>","/**\n * Brite Future Schools — bfs-contracts\n * Students domain Zod schemas.\n *\n * Phase History:\n *   Phase 1 (2026-06-07): Initial creation — student create, list,\n *                          bulk upload, guardian linkage\n *\n * @module src/schemas/students\n * @since Phase 1\n */\n\nimport * as z from 'zod'\nimport { UuidSchema, PaginationInputSchema } from './base.js'\n\n// ── Enums ──────────────────────────────────────────────────────────────────────\n\nexport const GenderSchema = z.enum(['male', 'female'])\n\nexport const StudentStatusSchema = z.enum([\n    'active',\n    'transferred',\n    'graduated',\n    'suspended',\n    'withdrawn',\n])\n\nexport const GradeLevelSchema = z.enum([\n    'PP1', 'PP2',\n    'G1', 'G2', 'G3', 'G4', 'G5', 'G6', 'G7', 'G8', 'G9',\n])\n\n// ── Create single student ──────────────────────────────────────────────────────\n\nexport const CreateStudentInputSchema = z.object({\n    // Identity\n    firstName: z.string().min(1).max(100),\n    middleName: z.string().max(100).optional(),\n    lastName: z.string().min(1).max(100),\n    dateOfBirth: z.iso.date().meta({ description: 'ISO date, e.g. 2015-03-22' }),\n    gender: GenderSchema,\n    admissionNo: z.string().min(1).max(50).meta({\n        description: 'School-assigned admission number — must be unique per branch',\n    }),\n    nemisNo: z.string().max(50).optional(),\n    admissionDate: z.iso.date(),\n    bloodGroup: z.string().max(10).optional(),\n    medicalNotes: z.string().optional(),\n\n    // Class placement (optional at creation — can be enrolled later)\n    classId: UuidSchema.optional().meta({\n        description: 'Class to enrol student in for the current term',\n    }),\n    termId: UuidSchema.optional().meta({\n        description: 'Term for class enrolment — required if classId is provided',\n    }),\n\n    // Guardian (optional at creation — can be linked later)\n    guardian: z.object({\n        firstName: z.string().min(1).max(100),\n        middleName: z.string().max(100).optional(),\n        lastName: z.string().min(1).max(100),\n        relationship: z.string().min(1).max(50).meta({\n            description: 'e.g. mother, father, uncle, guardian',\n        }),\n        phone: z.string().min(9).max(30),\n        email: z.email().optional(),\n        nationalId: z.string().max(20).optional(),\n        occupation: z.string().max(100).optional(),\n    }).optional(),\n})\n\nexport type CreateStudentInput = z.infer<typeof CreateStudentInputSchema>\n\n// ── Student profile (output) ───────────────────────────────────────────────────\n\nexport const StudentProfileSchema = z.object({\n    id: UuidSchema,\n    branchId: UuidSchema,\n    admissionNo: z.string(),\n    nemisNo: z.string().nullable(),\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    dateOfBirth: z.string(),\n    gender: GenderSchema,\n    photoUrl: z.string().nullable(),\n    bloodGroup: z.string().nullable(),\n    medicalNotes: z.string().nullable(),\n    admissionDate: z.string(),\n    status: StudentStatusSchema,\n    createdAt: z.string(),\n\n    // Current class (from latest enrollment)\n    currentClass: z.object({\n        classId: UuidSchema,\n        className: z.string(),\n        gradeLevel: GradeLevelSchema,\n        termId: UuidSchema,\n        termName: z.string(),\n    }).nullable(),\n\n    // Guardians\n    guardians: z.array(z.object({\n        id: UuidSchema,\n        firstName: z.string(),\n        middleName: z.string().nullable(),\n        lastName: z.string(),\n        relationship: z.string(),\n        phone: z.string(),\n        email: z.string().nullable(),\n        isPrimary: z.boolean(),\n    })),\n})\n\nexport type StudentProfile = z.infer<typeof StudentProfileSchema>\n\n// ── Student list item ──────────────────────────────────────────────────────────\n\nexport const StudentListItemSchema = z.object({\n    id: UuidSchema,\n    admissionNo: z.string(),\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    gender: GenderSchema,\n    status: StudentStatusSchema,\n    className: z.string().nullable(),\n    gradeLevel: GradeLevelSchema.nullable(),\n    primaryGuardianName: z.string().nullable(),\n    primaryGuardianPhone: z.string().nullable(),\n    createdAt: z.string(),\n})\n\nexport type StudentListItem = z.infer<typeof StudentListItemSchema>\n\n// ── List students input ────────────────────────────────────────────────────────\n\nexport const ListStudentsInputSchema = PaginationInputSchema.extend({\n    search: z.string().optional().meta({\n        description: 'Search by name or admission number',\n    }),\n    classId: UuidSchema.optional(),\n    gradeLevel: GradeLevelSchema.optional(),\n    status: StudentStatusSchema.optional(),\n    termId: UuidSchema.optional(),\n})\n\nexport type ListStudentsInput = z.infer<typeof ListStudentsInputSchema>\n\n// ── Bulk upload ────────────────────────────────────────────────────────────────\n\n/**\n * One row from a CSV bulk upload.\n * Column mapping is flexible — the upload endpoint accepts this shape\n * after the CSV parser maps headers to these field names.\n */\nexport const BulkUploadStudentRowSchema = z.object({\n    firstName: z.string().min(1),\n    middleName: z.string().optional(),\n    lastName: z.string().min(1),\n    dateOfBirth: z.string().min(1).meta({ description: 'Any parseable date string' }),\n    gender: z.string().min(1).meta({ description: 'male | female (case-insensitive)' }),\n    admissionNo: z.string().min(1),\n    nemisNo: z.string().optional(),\n    admissionDate: z.string().optional(),\n    bloodGroup: z.string().optional(),\n\n    // Guardian columns (all optional in CSV)\n    guardianFirstName: z.string().optional(),\n    guardianLastName: z.string().optional(),\n    guardianRelationship: z.string().optional(),\n    guardianPhone: z.string().optional(),\n    guardianEmail: z.string().optional(),\n})\n\nexport type BulkUploadStudentRow = z.infer<typeof BulkUploadStudentRowSchema>\n\nexport const BulkUploadStudentsInputSchema = z.object({\n    classId: UuidSchema.meta({\n        description: 'Class to enrol all uploaded students into',\n    }),\n    termId: UuidSchema,\n    rows: z.array(BulkUploadStudentRowSchema).min(1).max(500),\n})\n\nexport type BulkUploadStudentsInput = z.infer<typeof BulkUploadStudentsInputSchema>\n\nexport const BulkUploadStudentsOutputSchema = z.object({\n    created: z.int().nonnegative(),\n    skipped: z.int().nonnegative(),\n    errors: z.array(z.object({\n        row: z.int().positive(),\n        admissionNo: z.string().optional(),\n        reason: z.string(),\n    })),\n})\n\nexport type BulkUploadStudentsOutput = z.infer<typeof BulkUploadStudentsOutputSchema>\n\n// ── Create student output ──────────────────────────────────────────────────────\n\nexport const CreateStudentOutputSchema = z.object({\n    studentId: UuidSchema,\n    admissionNo: z.string(),\n})\n\nexport type CreateStudentOutput = z.infer<typeof CreateStudentOutputSchema>\n\n// ── Link guardian ──────────────────────────────────────────────────────────────\n\nexport const LinkGuardianInputSchema = z.object({\n    studentId: UuidSchema,\n    firstName: z.string().min(1).max(100),\n    middleName: z.string().max(100).optional(),\n    lastName: z.string().min(1).max(100),\n    relationship: z.string().min(1).max(50),\n    phone: z.string().min(9).max(30),\n    email: z.email().optional(),\n    nationalId: z.string().max(20).optional(),\n    occupation: z.string().max(100).optional(),\n    isPrimary: z.boolean().default(false),\n})\n\nexport type LinkGuardianInput = z.infer<typeof LinkGuardianInputSchema>\n\n// ── Classes (for selectors) ────────────────────────────────────────────────────\n\nexport const ClassSummarySchema = z.object({\n    id: UuidSchema,\n    name: z.string(),\n    gradeLevel: GradeLevelSchema,\n    gradeName: z.string(),\n    capacity: z.number().nullable(),\n    enrolledCount: z.number(),\n    classTeacherId: UuidSchema.nullable(),\n})\n\nexport type ClassSummary = z.infer<typeof ClassSummarySchema>","/**\n * Brite Future Schools — bfs-contracts\n * Attendance domain Zod schemas.\n *\n * Phase History:\n *   Phase 2.1 (2026-06-08): Initial — class attendance mark, getByClass,\n *                            getByStudent, listTerms\n *\n * @module src/schemas/attendance\n * @since Phase 2.1\n */\n\nimport * as z from 'zod'\nimport { UuidSchema } from './base.js'\n\n// ── Enums ──────────────────────────────────────────────────────────────────────\n\nexport const AttendanceStatusSchema = z.enum([\n    'present',\n    'absent',\n    'late',\n    'excused',\n])\n\nexport type AttendanceStatusEnum = z.infer<typeof AttendanceStatusSchema>\n\n// ── Term ───────────────────────────────────────────────────────────────────────\n\nexport const TermSchema = z.object({\n    id: UuidSchema,\n    branchId: UuidSchema,\n    academicYearId: UuidSchema,\n    name: z.string(),\n    startDate: z.string(),\n    endDate: z.string(),\n    isCurrent: z.boolean(),\n})\n\nexport type Term = z.infer<typeof TermSchema>\n\n// ── Mark attendance ────────────────────────────────────────────────────────────\n\nexport const AttendanceRecordInputSchema = z.object({\n    studentId: UuidSchema,\n    status: AttendanceStatusSchema,\n    notes: z.string().max(500).optional(),\n})\n\nexport const MarkAttendanceInputSchema = z.object({\n    classId: UuidSchema,\n    termId: UuidSchema,\n    date: z.iso.date(),\n    records: z.array(AttendanceRecordInputSchema).min(1),\n})\n\nexport type MarkAttendanceInput = z.infer<typeof MarkAttendanceInputSchema>\n\nexport const MarkAttendanceOutputSchema = z.object({\n    count: z.number(),\n    date: z.string(),\n    classId: UuidSchema,\n})\n\nexport type MarkAttendanceOutput = z.infer<typeof MarkAttendanceOutputSchema>\n\n// ── Get by class ───────────────────────────────────────────────────────────────\n\nexport const GetByClassInputSchema = z.object({\n    classId: UuidSchema,\n    date: z.iso.date(),\n})\n\nexport type GetByClassInput = z.infer<typeof GetByClassInputSchema>\n\nexport const ClassAttendanceRowSchema = z.object({\n    id: UuidSchema,\n    studentId: UuidSchema,\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    admissionNo: z.string(),\n    status: AttendanceStatusSchema,\n    notes: z.string().nullable(),\n    markedBy: UuidSchema,\n    updatedAt: z.string(),\n})\n\nexport type ClassAttendanceRow = z.infer<typeof ClassAttendanceRowSchema>\n\n// ── Get by student ─────────────────────────────────────────────────────────────\n\nexport const GetByStudentInputSchema = z.object({\n    studentId: UuidSchema,\n    termId: UuidSchema,\n})\n\nexport type GetByStudentInput = z.infer<typeof GetByStudentInputSchema>\n\nexport const StudentAttendanceRowSchema = z.object({\n    id: UuidSchema,\n    date: z.string(),\n    status: AttendanceStatusSchema,\n    notes: z.string().nullable(),\n    classId: UuidSchema,\n    className: z.string(),\n})\n\nexport type StudentAttendanceRow = z.infer<typeof StudentAttendanceRowSchema>"],"mappings":"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","names":["z","z","z","z"]}
+{"version":3,"sources":["../../src/schemas/index.ts","../../src/schemas/base.ts","../../src/schemas/auth.ts","../../src/schemas/hr.ts","../../src/schemas/students.ts","../../src/schemas/attendance.ts","../../src/schemas/calendar.ts","../../src/schemas/grades.ts"],"sourcesContent":["/**\n * Brite Future Schools — bfs-contracts\n * Schemas barrel.\n *\n * Phase History:\n *   Phase 0.1 (2026-06-05): Initial creation\n *   Phase 1   (2026-06-07): Added hr and students schemas\n *   Phase 2.1 (2026-06-08): Added attendance schemas\n *   Phase 4.1 (2026-06-12): Added calendar and grades schemas\n *\n * @module src/schemas/index\n * @since Phase 0.1\n */\n\nexport * from './base.js'\nexport * from './auth.js'\nexport * from './hr.js'\nexport * from './students.js'\nexport * from './attendance.js'\nexport * from './calendar.js'\nexport * from './grades.js'","/**\n * Brite Future Schools — bfs-contracts\n * Base Zod schemas: reusable primitives shared across all domain schemas.\n *\n * Phase History:\n *   Phase 0.1 (2026-06-05): Initial creation\n *\n * @module src/schemas/base\n * @since Phase 0.1\n */\n\nimport * as z from 'zod'\n\n// ── ID ─────────────────────────────────────────────────────────────────────────\n\nexport const CuidSchema = z\n    .string()\n    .regex(/^[a-z][a-z0-9]{24}$/, 'Invalid cuid2 identifier')\n    .meta({ description: 'cuid2 — prefixed, collision-resistant identifier' })\n\n// ── UUID ───────────────────────────────────────────────────────────────────────\n\nexport const UuidSchema = z\n    .uuidv4()\n    .meta({ description: 'RFC-4122 UUID v4' })\n\n// ── Timestamps ─────────────────────────────────────────────────────────────────\n\nconst IsoDatetime = z.iso.datetime()\n\nexport const TimestampsSchema = z.object({\n    createdAt: IsoDatetime.meta({ description: 'ISO-8601 creation time (UTC)' }),\n    updatedAt: IsoDatetime.meta({ description: 'ISO-8601 last update time (UTC)' }),\n})\n\n// ── Soft-delete ────────────────────────────────────────────────────────────────\n\nexport const SoftDeleteSchema = z.object({\n    deletedAt: IsoDatetime.nullable().meta({\n        description: 'Set when the record is soft-deleted; null if active',\n    }),\n})\n\n// ── Pagination ─────────────────────────────────────────────────────────────────\n\nexport const PaginationInputSchema = z.object({\n    cursor: CuidSchema.optional().meta({\n        description: 'Opaque cursor from the previous page response',\n    }),\n    limit: z\n        .int()\n        .min(1)\n        .max(100)\n        .default(20)\n        .meta({ description: 'Number of items to return (1–100, default 20)' }),\n})\n\nexport function paginatedOutputSchema<T extends z.ZodTypeAny>(itemSchema: T) {\n    return z.object({\n        items: z.array(itemSchema),\n        nextCursor: CuidSchema.nullable().meta({\n            description: 'Pass as `cursor` on the next request; null when no more pages',\n        }),\n        total: z\n            .int()\n            .nonnegative()\n            .meta({ description: 'Total matching records (before pagination)' }),\n    })\n}\n\n// ── Branch reference ───────────────────────────────────────────────────────────\n\nexport const BranchRefSchema = z.object({\n    branchId: CuidSchema.meta({ description: 'The branch this record belongs to' }),\n})\n\n// ── Inferred types ─────────────────────────────────────────────────────────────\n\nexport type Timestamps = z.infer<typeof TimestampsSchema>\nexport type SoftDelete = z.infer<typeof SoftDeleteSchema>\nexport type PaginationInput = z.infer<typeof PaginationInputSchema>","/**\n * Brite Future Schools — bfs-contracts\n * Auth-related Zod schemas.\n *\n * Phase History:\n *   Phase 0.1 (2026-06-05): Initial creation\n *   Phase 3   (2026-06-10): Replaced CuidSchema with z.string().uuid() per R-052\n *\n * @module src/schemas/auth\n * @since Phase 0.1\n */\n\nimport * as z from 'zod'\n\n// ── Session user (defined first — referenced by LoginOutputSchema below) ───────\n\nexport const SessionUserRoleSchema = z.object({\n    id: z.string().uuid(),\n    name: z.string().meta({ description: 'Role name, e.g. PRINCIPAL' }),\n    branchId: z.string().uuid(),\n    isPrimary: z.boolean(),\n})\n\nexport const SessionUserSubRoleSchema = z.object({\n    id: z.string().uuid(),\n    name: z.string().meta({ description: 'Sub-role name, e.g. HEAD_PREFECT' }),\n    branchId: z.string().uuid(),\n})\n\nexport const SessionUserOutputSchema = z.object({\n    id: z.string().uuid(),\n    email: z.email(),\n    firstName: z.string(),\n    lastName: z.string(),\n    activeBranchId: z.string().uuid(),\n    roles: z.array(SessionUserRoleSchema),\n    subRoles: z.array(SessionUserSubRoleSchema),\n    isActive: z.boolean(),\n    mustChangePassword: z.boolean(),\n})\n\n// ── Login ──────────────────────────────────────────────────────────────────────\n\nexport const LoginInputSchema = z.object({\n    email: z.email().meta({ description: 'User email address' }),\n    password: z.string().min(1).meta({ description: 'Plain-text password (sent over TLS)' }),\n    branchId: z.string().uuid().optional().meta({\n        description: 'Branch to activate on login; defaults to user primary branch',\n    }),\n})\n\nexport const LoginOutputSchema = z.object({\n    accessToken: z.string().meta({ description: 'Short-lived JWT (15 min)' }),\n    refreshToken: z.string().meta({ description: 'Long-lived opaque refresh token (7 days)' }),\n    expiresIn: z.int().positive().meta({ description: 'Access token TTL in seconds' }),\n    user: SessionUserOutputSchema,\n})\n\n// ── Token refresh ──────────────────────────────────────────────────────────────\n\nexport const RefreshTokenInputSchema = z.object({\n    refreshToken: z.string().min(1),\n})\n\nexport const RefreshTokenOutputSchema = z.object({\n    accessToken: z.string(),\n    expiresIn: z.int().positive(),\n})\n\n// ── Logout ─────────────────────────────────────────────────────────────────────\n\nexport const LogoutInputSchema = z.object({\n    refreshToken: z.string().min(1).meta({\n        description: 'The refresh token to revoke; also invalidated server-side',\n    }),\n})\n\n// ── Password change ─────────────────────────────────────────────────────────────\n\nexport const ChangePasswordInputSchema = z\n    .object({\n        currentPassword: z.string().min(1),\n        newPassword: z\n            .string()\n            .min(8, { error: 'Password must be at least 8 characters' }),\n        confirmPassword: z.string().min(1),\n    })\n    .refine((v) => v.newPassword === v.confirmPassword, {\n        error: 'Passwords do not match',\n        path: ['confirmPassword'],\n    })\n\n// ── Password reset ─────────────────────────────────────────────────────────────\n\nexport const RequestPasswordResetInputSchema = z.object({\n    email: z.email(),\n})\n\nexport const ResetPasswordInputSchema = z\n    .object({\n        token: z.string().min(1).meta({ description: 'One-time reset token from email link' }),\n        newPassword: z.string().min(8, { error: 'Password must be at least 8 characters' }),\n        confirmPassword: z.string().min(1),\n    })\n    .refine((v) => v.newPassword === v.confirmPassword, {\n        error: 'Passwords do not match',\n        path: ['confirmPassword'],\n    })\n\n// ── Branch switch ───────────────────────────────────────────────────────────────\n\nexport const SwitchBranchInputSchema = z.object({\n    branchId: z.string().uuid().meta({ description: 'Branch to switch the active session to' }),\n})\n\n// ── Inferred types ──────────────────────────────────────────────────────────────\n\nexport type LoginInput = z.infer<typeof LoginInputSchema>\nexport type LoginOutput = z.infer<typeof LoginOutputSchema>\nexport type SessionUserOutput = z.infer<typeof SessionUserOutputSchema>\nexport type RefreshTokenInput = z.infer<typeof RefreshTokenInputSchema>\nexport type RefreshTokenOutput = z.infer<typeof RefreshTokenOutputSchema>\nexport type ChangePasswordInput = z.infer<typeof ChangePasswordInputSchema>\nexport type SwitchBranchInput = z.infer<typeof SwitchBranchInputSchema>","/**\n * Brite Future Schools — bfs-contracts\n * HR domain Zod schemas — staff creation, listing, and profiles.\n *\n * Phase History:\n *   Phase 1   (2026-06-07): Initial creation\n *   Phase 4.2 (2026-06-13): Removed hardcoded RoleNameSchema — role is now\n *                            a plain string (DB-driven). Removed salary fields\n *                            from CreateStaffInput — remuneration module owns\n *                            salary. Added helbNo, saccoNo statutory fields.\n *                            Updated StaffProfile to remove salary columns.\n *\n * @module src/schemas/hr\n * @since Phase 1\n */\n\nimport * as z from 'zod'\nimport { UuidSchema, PaginationInputSchema } from './base.js'\n\n// ── Enums ──────────────────────────────────────────────────────────────────────\n\nexport const EmploymentTypeSchema = z.enum([\n    'permanent',\n    'contract',\n    'temporary',\n    'intern',\n])\n\n// ── Create staff ───────────────────────────────────────────────────────────────\n\nexport const CreateStaffInputSchema = z.object({\n    // Personal details\n    firstName: z.string().min(1).max(100),\n    middleName: z.string().max(100).optional(),\n    lastName: z.string().min(1).max(100),\n    email: z.email(),\n    phone: z.string().min(9).max(30),\n    nationalId: z.string().min(1).max(20),\n\n    // Role assignment — DB-driven, any valid role code accepted\n    roleName: z.string().min(1).meta({\n        description: 'Role code from the roles table — e.g. TEACHER, PRINCIPAL',\n    }),\n    isPrimaryRole: z.boolean().default(true),\n\n    // Employment details\n    departmentId: UuidSchema.optional(),\n    designation: z.string().min(1).max(100).meta({\n        description: 'Job title, e.g. \"Mathematics Teacher\", \"Head of Finance\"',\n    }),\n    employmentType: EmploymentTypeSchema,\n    contractStart: z.iso.date().meta({ description: 'ISO date, e.g. 2026-01-15' }),\n    contractEnd: z.iso.date().optional(),\n\n    // Banking (optional at creation — can be completed later)\n    bankName: z.string().max(100).optional(),\n    bankAccount: z.string().max(30).optional(),\n    bankBranch: z.string().max(100).optional(),\n\n    // Statutory (optional at creation)\n    tscNumber: z.string().max(30).optional(),\n    kraPin: z.string().max(20).optional(),\n    nhifNo: z.string().max(20).optional(),\n    nssfNo: z.string().max(20).optional(),\n    helbNo: z.string().max(20).optional(),\n    saccoNo: z.string().max(20).optional(),\n})\n\nexport type CreateStaffInput = z.infer<typeof CreateStaffInputSchema>\n\n// ── Staff profile (output) ─────────────────────────────────────────────────────\n\nexport const StaffProfileSchema = z.object({\n    id: UuidSchema,\n    userId: UuidSchema,\n    branchId: UuidSchema,\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    phone: z.string(),\n    nationalId: z.string(),\n    tscNumber: z.string().nullable(),\n    kraPin: z.string().nullable(),\n    nhifNo: z.string().nullable(),\n    nssfNo: z.string().nullable(),\n    helbNo: z.string().nullable(),\n    saccoNo: z.string().nullable(),\n    designation: z.string(),\n    employmentType: EmploymentTypeSchema,\n    contractStart: z.string(),\n    contractEnd: z.string().nullable(),\n    bankName: z.string().nullable(),\n    bankAccount: z.string().nullable(),\n    bankBranch: z.string().nullable(),\n    status: z.string(),\n    createdAt: z.string(),\n    email: z.string(),\n    mustChangePassword: z.boolean(),\n    departmentId: UuidSchema.nullable(),\n    departmentName: z.string().nullable(),\n    // Role — DB-driven code string, not a fixed enum\n    roleName: z.string().nullable(),\n    roleId: UuidSchema.nullable(),\n})\n\nexport type StaffProfile = z.infer<typeof StaffProfileSchema>\n\n// ── Staff list item ────────────────────────────────────────────────────────────\n\nexport const StaffListItemSchema = z.object({\n    id: UuidSchema,\n    userId: UuidSchema,\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    email: z.string(),\n    phone: z.string(),\n    designation: z.string(),\n    employmentType: EmploymentTypeSchema,\n    status: z.string(),\n    departmentName: z.string().nullable(),\n    roleName: z.string().nullable(),\n    createdAt: z.string(),\n})\n\nexport type StaffListItem = z.infer<typeof StaffListItemSchema>\n\n// ── List staff input ───────────────────────────────────────────────────────────\n\nexport const ListStaffInputSchema = PaginationInputSchema.extend({\n    search: z.string().optional().meta({\n        description: 'Search by name or email',\n    }),\n    departmentId: UuidSchema.optional(),\n    roleName: z.string().optional(),\n    status: z.enum(['active', 'inactive']).optional(),\n})\n\nexport type ListStaffInput = z.infer<typeof ListStaffInputSchema>\n\n// ── Create staff output ────────────────────────────────────────────────────────\n\nexport const CreateStaffOutputSchema = z.object({\n    staffId: UuidSchema,\n    userId: UuidSchema,\n    email: z.string(),\n    emailSent: z.boolean(),\n})\n\nexport type CreateStaffOutput = z.infer<typeof CreateStaffOutputSchema>\n\n// ── Department ─────────────────────────────────────────────────────────────────\n\nexport const DepartmentSchema = z.object({\n    id: UuidSchema,\n    branchId: UuidSchema,\n    name: z.string(),\n    hodId: UuidSchema.nullable(),\n})\n\nexport type Department = z.infer<typeof DepartmentSchema>\n\nexport const CreateDepartmentInputSchema = z.object({\n    name: z.string().min(1).max(100),\n    hodId: UuidSchema.optional(),\n})\n\nexport type CreateDepartmentInput = z.infer<typeof CreateDepartmentInputSchema>","/**\n * Brite Future Schools — bfs-contracts\n * Students domain Zod schemas.\n *\n * Phase History:\n *   Phase 1 (2026-06-07): Initial creation — student create, list,\n *                          bulk upload, guardian linkage\n *\n * @module src/schemas/students\n * @since Phase 1\n */\n\nimport * as z from 'zod'\nimport { UuidSchema, PaginationInputSchema } from './base.js'\n\n// ── Enums ──────────────────────────────────────────────────────────────────────\n\nexport const GenderSchema = z.enum(['male', 'female'])\n\nexport const StudentStatusSchema = z.enum([\n    'active',\n    'transferred',\n    'graduated',\n    'suspended',\n    'withdrawn',\n])\n\nexport const GradeLevelSchema = z.enum([\n    'PP1', 'PP2',\n    'G1', 'G2', 'G3', 'G4', 'G5', 'G6', 'G7', 'G8', 'G9',\n])\n\n// ── Create single student ──────────────────────────────────────────────────────\n\nexport const CreateStudentInputSchema = z.object({\n    // Identity\n    firstName: z.string().min(1).max(100),\n    middleName: z.string().max(100).optional(),\n    lastName: z.string().min(1).max(100),\n    dateOfBirth: z.iso.date().meta({ description: 'ISO date, e.g. 2015-03-22' }),\n    gender: GenderSchema,\n    admissionNo: z.string().min(1).max(50).meta({\n        description: 'School-assigned admission number — must be unique per branch',\n    }),\n    nemisNo: z.string().max(50).optional(),\n    admissionDate: z.iso.date(),\n    bloodGroup: z.string().max(10).optional(),\n    medicalNotes: z.string().optional(),\n\n    // Class placement (optional at creation — can be enrolled later)\n    classId: UuidSchema.optional().meta({\n        description: 'Class to enrol student in for the current term',\n    }),\n    termId: UuidSchema.optional().meta({\n        description: 'Term for class enrolment — required if classId is provided',\n    }),\n\n    // Guardian (optional at creation — can be linked later)\n    guardian: z.object({\n        firstName: z.string().min(1).max(100),\n        middleName: z.string().max(100).optional(),\n        lastName: z.string().min(1).max(100),\n        relationship: z.string().min(1).max(50).meta({\n            description: 'e.g. mother, father, uncle, guardian',\n        }),\n        phone: z.string().min(9).max(30),\n        email: z.email().optional(),\n        nationalId: z.string().max(20).optional(),\n        occupation: z.string().max(100).optional(),\n    }).optional(),\n})\n\nexport type CreateStudentInput = z.infer<typeof CreateStudentInputSchema>\n\n// ── Student profile (output) ───────────────────────────────────────────────────\n\nexport const StudentProfileSchema = z.object({\n    id: UuidSchema,\n    branchId: UuidSchema,\n    admissionNo: z.string(),\n    nemisNo: z.string().nullable(),\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    dateOfBirth: z.string(),\n    gender: GenderSchema,\n    photoUrl: z.string().nullable(),\n    bloodGroup: z.string().nullable(),\n    medicalNotes: z.string().nullable(),\n    admissionDate: z.string(),\n    status: StudentStatusSchema,\n    createdAt: z.string(),\n\n    // Current class (from latest enrollment)\n    currentClass: z.object({\n        classId: UuidSchema,\n        className: z.string(),\n        gradeLevel: GradeLevelSchema,\n        termId: UuidSchema,\n        termName: z.string(),\n    }).nullable(),\n\n    // Guardians\n    guardians: z.array(z.object({\n        id: UuidSchema,\n        firstName: z.string(),\n        middleName: z.string().nullable(),\n        lastName: z.string(),\n        relationship: z.string(),\n        phone: z.string(),\n        email: z.string().nullable(),\n        isPrimary: z.boolean(),\n    })),\n})\n\nexport type StudentProfile = z.infer<typeof StudentProfileSchema>\n\n// ── Student list item ──────────────────────────────────────────────────────────\n\nexport const StudentListItemSchema = z.object({\n    id: UuidSchema,\n    admissionNo: z.string(),\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    gender: GenderSchema,\n    status: StudentStatusSchema,\n    className: z.string().nullable(),\n    gradeLevel: GradeLevelSchema.nullable(),\n    primaryGuardianName: z.string().nullable(),\n    primaryGuardianPhone: z.string().nullable(),\n    createdAt: z.string(),\n})\n\nexport type StudentListItem = z.infer<typeof StudentListItemSchema>\n\n// ── List students input ────────────────────────────────────────────────────────\n\nexport const ListStudentsInputSchema = PaginationInputSchema.extend({\n    search: z.string().optional().meta({\n        description: 'Search by name or admission number',\n    }),\n    classId: UuidSchema.optional(),\n    gradeLevel: GradeLevelSchema.optional(),\n    status: StudentStatusSchema.optional(),\n    termId: UuidSchema.optional(),\n})\n\nexport type ListStudentsInput = z.infer<typeof ListStudentsInputSchema>\n\n// ── Bulk upload ────────────────────────────────────────────────────────────────\n\n/**\n * One row from a CSV bulk upload.\n * Column mapping is flexible — the upload endpoint accepts this shape\n * after the CSV parser maps headers to these field names.\n */\nexport const BulkUploadStudentRowSchema = z.object({\n    firstName: z.string().min(1),\n    middleName: z.string().optional(),\n    lastName: z.string().min(1),\n    dateOfBirth: z.string().min(1).meta({ description: 'Any parseable date string' }),\n    gender: z.string().min(1).meta({ description: 'male | female (case-insensitive)' }),\n    admissionNo: z.string().min(1),\n    nemisNo: z.string().optional(),\n    admissionDate: z.string().optional(),\n    bloodGroup: z.string().optional(),\n\n    // Guardian columns (all optional in CSV)\n    guardianFirstName: z.string().optional(),\n    guardianLastName: z.string().optional(),\n    guardianRelationship: z.string().optional(),\n    guardianPhone: z.string().optional(),\n    guardianEmail: z.string().optional(),\n})\n\nexport type BulkUploadStudentRow = z.infer<typeof BulkUploadStudentRowSchema>\n\nexport const BulkUploadStudentsInputSchema = z.object({\n    classId: UuidSchema.meta({\n        description: 'Class to enrol all uploaded students into',\n    }),\n    termId: UuidSchema,\n    rows: z.array(BulkUploadStudentRowSchema).min(1).max(500),\n})\n\nexport type BulkUploadStudentsInput = z.infer<typeof BulkUploadStudentsInputSchema>\n\nexport const BulkUploadStudentsOutputSchema = z.object({\n    created: z.int().nonnegative(),\n    skipped: z.int().nonnegative(),\n    errors: z.array(z.object({\n        row: z.int().positive(),\n        admissionNo: z.string().optional(),\n        reason: z.string(),\n    })),\n})\n\nexport type BulkUploadStudentsOutput = z.infer<typeof BulkUploadStudentsOutputSchema>\n\n// ── Create student output ──────────────────────────────────────────────────────\n\nexport const CreateStudentOutputSchema = z.object({\n    studentId: UuidSchema,\n    admissionNo: z.string(),\n})\n\nexport type CreateStudentOutput = z.infer<typeof CreateStudentOutputSchema>\n\n// ── Link guardian ──────────────────────────────────────────────────────────────\n\nexport const LinkGuardianInputSchema = z.object({\n    studentId: UuidSchema,\n    firstName: z.string().min(1).max(100),\n    middleName: z.string().max(100).optional(),\n    lastName: z.string().min(1).max(100),\n    relationship: z.string().min(1).max(50),\n    phone: z.string().min(9).max(30),\n    email: z.email().optional(),\n    nationalId: z.string().max(20).optional(),\n    occupation: z.string().max(100).optional(),\n    isPrimary: z.boolean().default(false),\n})\n\nexport type LinkGuardianInput = z.infer<typeof LinkGuardianInputSchema>\n\n// ── Classes (for selectors) ────────────────────────────────────────────────────\n\nexport const ClassSummarySchema = z.object({\n    id: UuidSchema,\n    name: z.string(),\n    gradeLevel: GradeLevelSchema,\n    gradeName: z.string(),\n    capacity: z.number().nullable(),\n    enrolledCount: z.number(),\n    classTeacherId: UuidSchema.nullable(),\n})\n\nexport type ClassSummary = z.infer<typeof ClassSummarySchema>","/**\n * Brite Future Schools — bfs-contracts\n * Attendance domain Zod schemas.\n *\n * Phase History:\n *   Phase 2.1 (2026-06-08): Initial — class attendance mark, getByClass,\n *                            getByStudent, listTerms\n *\n * @module src/schemas/attendance\n * @since Phase 2.1\n */\n\nimport * as z from 'zod'\nimport { UuidSchema } from './base.js'\n\n// ── Enums ──────────────────────────────────────────────────────────────────────\n\nexport const AttendanceStatusSchema = z.enum([\n    'present',\n    'absent',\n    'late',\n    'excused',\n])\n\nexport type AttendanceStatusEnum = z.infer<typeof AttendanceStatusSchema>\n\n// ── Term ───────────────────────────────────────────────────────────────────────\n\nexport const TermSchema = z.object({\n    id: UuidSchema,\n    branchId: UuidSchema,\n    academicYearId: UuidSchema,\n    name: z.string(),\n    startDate: z.string(),\n    endDate: z.string(),\n    isCurrent: z.boolean(),\n})\n\nexport type Term = z.infer<typeof TermSchema>\n\n// ── Mark attendance ────────────────────────────────────────────────────────────\n\nexport const AttendanceRecordInputSchema = z.object({\n    studentId: UuidSchema,\n    status: AttendanceStatusSchema,\n    notes: z.string().max(500).optional(),\n})\n\nexport const MarkAttendanceInputSchema = z.object({\n    classId: UuidSchema,\n    termId: UuidSchema,\n    date: z.iso.date(),\n    records: z.array(AttendanceRecordInputSchema).min(1),\n})\n\nexport type MarkAttendanceInput = z.infer<typeof MarkAttendanceInputSchema>\n\nexport const MarkAttendanceOutputSchema = z.object({\n    count: z.number(),\n    date: z.string(),\n    classId: UuidSchema,\n})\n\nexport type MarkAttendanceOutput = z.infer<typeof MarkAttendanceOutputSchema>\n\n// ── Get by class ───────────────────────────────────────────────────────────────\n\nexport const GetByClassInputSchema = z.object({\n    classId: UuidSchema,\n    date: z.iso.date(),\n})\n\nexport type GetByClassInput = z.infer<typeof GetByClassInputSchema>\n\nexport const ClassAttendanceRowSchema = z.object({\n    id: UuidSchema,\n    studentId: UuidSchema,\n    firstName: z.string(),\n    middleName: z.string().nullable(),\n    lastName: z.string(),\n    admissionNo: z.string(),\n    status: AttendanceStatusSchema,\n    notes: z.string().nullable(),\n    markedBy: UuidSchema,\n    updatedAt: z.string(),\n})\n\nexport type ClassAttendanceRow = z.infer<typeof ClassAttendanceRowSchema>\n\n// ── Get by student ─────────────────────────────────────────────────────────────\n\nexport const GetByStudentInputSchema = z.object({\n    studentId: UuidSchema,\n    termId: UuidSchema,\n})\n\nexport type GetByStudentInput = z.infer<typeof GetByStudentInputSchema>\n\nexport const StudentAttendanceRowSchema = z.object({\n    id: UuidSchema,\n    date: z.string(),\n    status: AttendanceStatusSchema,\n    notes: z.string().nullable(),\n    classId: UuidSchema,\n    className: z.string(),\n})\n\nexport type StudentAttendanceRow = z.infer<typeof StudentAttendanceRowSchema>","/**\n * Brite Future Schools — bfs-contracts\n * Calendar schemas — academic years and terms.\n *\n * Phase History:\n *   Phase 4.1 (2026-06-12): Initial creation\n *\n * @module src/schemas/calendar\n * @since Phase 4.1\n */\n\nimport * as z from 'zod'\n\n// ── Academic Year ──────────────────────────────────────────────────────────────\n\nexport const AcademicYearSchema = z.object({\n    id: z.string().uuid(),\n    branchId: z.string().uuid(),\n    name: z.string(),\n    startDate: z.string(),\n    endDate: z.string(),\n    isCurrent: z.boolean(),\n    createdAt: z.string(),\n})\n\nexport const CreateYearInputSchema = z.object({\n    name: z.string().min(1).max(50),\n    startDate: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/, 'Must be YYYY-MM-DD'),\n    endDate: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/, 'Must be YYYY-MM-DD'),\n})\n\nexport const SetCurrentYearInputSchema = z.object({\n    yearId: z.string().uuid(),\n})\n\n// ── Academic Term ──────────────────────────────────────────────────────────────\n// Prefixed with \"Academic\" to avoid clash with attendance.ts TermSchema / Term\n\nexport const AcademicTermSchema = z.object({\n    id: z.string().uuid(),\n    branchId: z.string().uuid(),\n    academicYearId: z.string().uuid(),\n    name: z.string(),\n    startDate: z.string(),\n    endDate: z.string(),\n    isCurrent: z.boolean(),\n    createdAt: z.string(),\n})\n\nexport const CreateTermInputSchema = z.object({\n    academicYearId: z.string().uuid(),\n    name: z.string().min(1).max(50),\n    startDate: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/, 'Must be YYYY-MM-DD'),\n    endDate: z.string().regex(/^\\d{4}-\\d{2}-\\d{2}$/, 'Must be YYYY-MM-DD'),\n})\n\nexport const SetCurrentTermInputSchema = z.object({\n    termId: z.string().uuid(),\n})\n\nexport const ListTermsInputSchema = z.object({\n    yearId: z.string().uuid().optional(),\n})\n\n// ── Inferred types ─────────────────────────────────────────────────────────────\n\nexport type AcademicYear = z.infer<typeof AcademicYearSchema>\nexport type AcademicTerm = z.infer<typeof AcademicTermSchema>\nexport type CreateYearInput = z.infer<typeof CreateYearInputSchema>\nexport type CreateTermInput = z.infer<typeof CreateTermInputSchema>","/**\n * Brite Future Schools — bfs-contracts\n * Grades schemas.\n *\n * Phase History:\n *   Phase 4.1 (2026-06-12): Initial creation\n *\n * @module src/schemas/grades\n * @since Phase 4.1\n */\n\nimport * as z from 'zod'\nimport { GradeLevelSchema } from './students.js'\n\n// Re-export so consumers can import GradeLevel from grades if needed\nexport { GradeLevelSchema }\n\nexport const GRADE_LEVELS = [\n    'PP1', 'PP2',\n    'G1', 'G2', 'G3', 'G4', 'G5', 'G6',\n    'G7', 'G8', 'G9',\n] as const\n\nexport type GradeLevel = typeof GRADE_LEVELS[number]\n\nexport const GradeSchema = z.object({\n    id: z.string().uuid(),\n    branchId: z.string().uuid(),\n    name: z.string(),\n    level: GradeLevelSchema,\n    description: z.string().nullable(),\n})\n\nexport const CreateGradeInputSchema = z.object({\n    name: z.string().min(1).max(50),\n    level: GradeLevelSchema,\n    description: z.string().max(300).optional(),\n})\n\n// ── Inferred types ─────────────────────────────────────────────────────────────\n\nexport type Grade = z.infer<typeof GradeSchema>\nexport type CreateGradeInput = z.infer<typeof CreateGradeInputSchema>"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACWA,QAAmB;AAIZ,IAAM,aACR,SAAO,EACP,MAAM,uBAAuB,0BAA0B,EACvD,KAAK,EAAE,aAAa,wDAAmD,CAAC;AAItE,IAAM,aACR,SAAO,EACP,KAAK,EAAE,aAAa,mBAAmB,CAAC;AAI7C,IAAM,cAAgB,MAAI,SAAS;AAE5B,IAAM,mBAAqB,SAAO;AAAA,EACrC,WAAW,YAAY,KAAK,EAAE,aAAa,+BAA+B,CAAC;AAAA,EAC3E,WAAW,YAAY,KAAK,EAAE,aAAa,kCAAkC,CAAC;AAClF,CAAC;AAIM,IAAM,mBAAqB,SAAO;AAAA,EACrC,WAAW,YAAY,SAAS,EAAE,KAAK;AAAA,IACnC,aAAa;AAAA,EACjB,CAAC;AACL,CAAC;AAIM,IAAM,wBAA0B,SAAO;AAAA,EAC1C,QAAQ,WAAW,SAAS,EAAE,KAAK;AAAA,IAC/B,aAAa;AAAA,EACjB,CAAC;AAAA,EACD,OACK,MAAI,EACJ,IAAI,CAAC,EACL,IAAI,GAAG,EACP,QAAQ,EAAE,EACV,KAAK,EAAE,aAAa,qDAAgD,CAAC;AAC9E,CAAC;AAEM,SAAS,sBAA8C,YAAe;AACzE,SAAS,SAAO;AAAA,IACZ,OAAS,QAAM,UAAU;AAAA,IACzB,YAAY,WAAW,SAAS,EAAE,KAAK;AAAA,MACnC,aAAa;AAAA,IACjB,CAAC;AAAA,IACD,OACK,MAAI,EACJ,YAAY,EACZ,KAAK,EAAE,aAAa,6CAA6C,CAAC;AAAA,EAC3E,CAAC;AACL;AAIO,IAAM,kBAAoB,SAAO;AAAA,EACpC,UAAU,WAAW,KAAK,EAAE,aAAa,oCAAoC,CAAC;AAClF,CAAC;;;AC9DD,IAAAA,KAAmB;AAIZ,IAAM,wBAA0B,UAAO;AAAA,EAC1C,IAAM,UAAO,EAAE,KAAK;AAAA,EACpB,MAAQ,UAAO,EAAE,KAAK,EAAE,aAAa,4BAA4B,CAAC;AAAA,EAClE,UAAY,UAAO,EAAE,KAAK;AAAA,EAC1B,WAAa,WAAQ;AACzB,CAAC;AAEM,IAAM,2BAA6B,UAAO;AAAA,EAC7C,IAAM,UAAO,EAAE,KAAK;AAAA,EACpB,MAAQ,UAAO,EAAE,KAAK,EAAE,aAAa,mCAAmC,CAAC;AAAA,EACzE,UAAY,UAAO,EAAE,KAAK;AAC9B,CAAC;AAEM,IAAM,0BAA4B,UAAO;AAAA,EAC5C,IAAM,UAAO,EAAE,KAAK;AAAA,EACpB,OAAS,SAAM;AAAA,EACf,WAAa,UAAO;AAAA,EACpB,UAAY,UAAO;AAAA,EACnB,gBAAkB,UAAO,EAAE,KAAK;AAAA,EAChC,OAAS,SAAM,qBAAqB;AAAA,EACpC,UAAY,SAAM,wBAAwB;AAAA,EAC1C,UAAY,WAAQ;AAAA,EACpB,oBAAsB,WAAQ;AAClC,CAAC;AAIM,IAAM,mBAAqB,UAAO;AAAA,EACrC,OAAS,SAAM,EAAE,KAAK,EAAE,aAAa,qBAAqB,CAAC;AAAA,EAC3D,UAAY,UAAO,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,sCAAsC,CAAC;AAAA,EACvF,UAAY,UAAO,EAAE,KAAK,EAAE,SAAS,EAAE,KAAK;AAAA,IACxC,aAAa;AAAA,EACjB,CAAC;AACL,CAAC;AAEM,IAAM,oBAAsB,UAAO;AAAA,EACtC,aAAe,UAAO,EAAE,KAAK,EAAE,aAAa,2BAA2B,CAAC;AAAA,EACxE,cAAgB,UAAO,EAAE,KAAK,EAAE,aAAa,2CAA2C,CAAC;AAAA,EACzF,WAAa,OAAI,EAAE,SAAS,EAAE,KAAK,EAAE,aAAa,8BAA8B,CAAC;AAAA,EACjF,MAAM;AACV,CAAC;AAIM,IAAM,0BAA4B,UAAO;AAAA,EAC5C,cAAgB,UAAO,EAAE,IAAI,CAAC;AAClC,CAAC;AAEM,IAAM,2BAA6B,UAAO;AAAA,EAC7C,aAAe,UAAO;AAAA,EACtB,WAAa,OAAI,EAAE,SAAS;AAChC,CAAC;AAIM,IAAM,oBAAsB,UAAO;AAAA,EACtC,cAAgB,UAAO,EAAE,IAAI,CAAC,EAAE,KAAK;AAAA,IACjC,aAAa;AAAA,EACjB,CAAC;AACL,CAAC;AAIM,IAAM,4BACR,UAAO;AAAA,EACJ,iBAAmB,UAAO,EAAE,IAAI,CAAC;AAAA,EACjC,aACK,UAAO,EACP,IAAI,GAAG,EAAE,OAAO,yCAAyC,CAAC;AAAA,EAC/D,iBAAmB,UAAO,EAAE,IAAI,CAAC;AACrC,CAAC,EACA,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,iBAAiB;AAAA,EAChD,OAAO;AAAA,EACP,MAAM,CAAC,iBAAiB;AAC5B,CAAC;AAIE,IAAM,kCAAoC,UAAO;AAAA,EACpD,OAAS,SAAM;AACnB,CAAC;AAEM,IAAM,2BACR,UAAO;AAAA,EACJ,OAAS,UAAO,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,uCAAuC,CAAC;AAAA,EACrF,aAAe,UAAO,EAAE,IAAI,GAAG,EAAE,OAAO,yCAAyC,CAAC;AAAA,EAClF,iBAAmB,UAAO,EAAE,IAAI,CAAC;AACrC,CAAC,EACA,OAAO,CAAC,MAAM,EAAE,gBAAgB,EAAE,iBAAiB;AAAA,EAChD,OAAO;AAAA,EACP,MAAM,CAAC,iBAAiB;AAC5B,CAAC;AAIE,IAAM,0BAA4B,UAAO;AAAA,EAC5C,UAAY,UAAO,EAAE,KAAK,EAAE,KAAK,EAAE,aAAa,yCAAyC,CAAC;AAC9F,CAAC;;;ACjGD,IAAAC,KAAmB;AAKZ,IAAM,uBAAyB,QAAK;AAAA,EACvC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAIM,IAAM,yBAA2B,UAAO;AAAA;AAAA,EAE3C,WAAa,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACpC,YAAc,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EACzC,UAAY,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACnC,OAAS,SAAM;AAAA,EACf,OAAS,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EAC/B,YAAc,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA;AAAA,EAGpC,UAAY,UAAO,EAAE,IAAI,CAAC,EAAE,KAAK;AAAA,IAC7B,aAAa;AAAA,EACjB,CAAC;AAAA,EACD,eAAiB,WAAQ,EAAE,QAAQ,IAAI;AAAA;AAAA,EAGvC,cAAc,WAAW,SAAS;AAAA,EAClC,aAAe,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG,EAAE,KAAK;AAAA,IACzC,aAAa;AAAA,EACjB,CAAC;AAAA,EACD,gBAAgB;AAAA,EAChB,eAAiB,OAAI,KAAK,EAAE,KAAK,EAAE,aAAa,4BAA4B,CAAC;AAAA,EAC7E,aAAe,OAAI,KAAK,EAAE,SAAS;AAAA;AAAA,EAGnC,UAAY,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EACvC,aAAe,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EACzC,YAAc,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA;AAAA,EAGzC,WAAa,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EACvC,QAAU,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EACpC,QAAU,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EACpC,QAAU,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EACpC,QAAU,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EACpC,SAAW,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AACzC,CAAC;AAMM,IAAM,qBAAuB,UAAO;AAAA,EACvC,IAAI;AAAA,EACJ,QAAQ;AAAA,EACR,UAAU;AAAA,EACV,WAAa,UAAO;AAAA,EACpB,YAAc,UAAO,EAAE,SAAS;AAAA,EAChC,UAAY,UAAO;AAAA,EACnB,OAAS,UAAO;AAAA,EAChB,YAAc,UAAO;AAAA,EACrB,WAAa,UAAO,EAAE,SAAS;AAAA,EAC/B,QAAU,UAAO,EAAE,SAAS;AAAA,EAC5B,QAAU,UAAO,EAAE,SAAS;AAAA,EAC5B,QAAU,UAAO,EAAE,SAAS;AAAA,EAC5B,QAAU,UAAO,EAAE,SAAS;AAAA,EAC5B,SAAW,UAAO,EAAE,SAAS;AAAA,EAC7B,aAAe,UAAO;AAAA,EACtB,gBAAgB;AAAA,EAChB,eAAiB,UAAO;AAAA,EACxB,aAAe,UAAO,EAAE,SAAS;AAAA,EACjC,UAAY,UAAO,EAAE,SAAS;AAAA,EAC9B,aAAe,UAAO,EAAE,SAAS;AAAA,EACjC,YAAc,UAAO,EAAE,SAAS;AAAA,EAChC,QAAU,UAAO;AAAA,EACjB,WAAa,UAAO;AAAA,EACpB,OAAS,UAAO;AAAA,EAChB,oBAAsB,WAAQ;AAAA,EAC9B,cAAc,WAAW,SAAS;AAAA,EAClC,gBAAkB,UAAO,EAAE,SAAS;AAAA;AAAA,EAEpC,UAAY,UAAO,EAAE,SAAS;AAAA,EAC9B,QAAQ,WAAW,SAAS;AAChC,CAAC;AAMM,IAAM,sBAAwB,UAAO;AAAA,EACxC,IAAI;AAAA,EACJ,QAAQ;AAAA,EACR,WAAa,UAAO;AAAA,EACpB,YAAc,UAAO,EAAE,SAAS;AAAA,EAChC,UAAY,UAAO;AAAA,EACnB,OAAS,UAAO;AAAA,EAChB,OAAS,UAAO;AAAA,EAChB,aAAe,UAAO;AAAA,EACtB,gBAAgB;AAAA,EAChB,QAAU,UAAO;AAAA,EACjB,gBAAkB,UAAO,EAAE,SAAS;AAAA,EACpC,UAAY,UAAO,EAAE,SAAS;AAAA,EAC9B,WAAa,UAAO;AACxB,CAAC;AAMM,IAAM,uBAAuB,sBAAsB,OAAO;AAAA,EAC7D,QAAU,UAAO,EAAE,SAAS,EAAE,KAAK;AAAA,IAC/B,aAAa;AAAA,EACjB,CAAC;AAAA,EACD,cAAc,WAAW,SAAS;AAAA,EAClC,UAAY,UAAO,EAAE,SAAS;AAAA,EAC9B,QAAU,QAAK,CAAC,UAAU,UAAU,CAAC,EAAE,SAAS;AACpD,CAAC;AAMM,IAAM,0BAA4B,UAAO;AAAA,EAC5C,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,OAAS,UAAO;AAAA,EAChB,WAAa,WAAQ;AACzB,CAAC;AAMM,IAAM,mBAAqB,UAAO;AAAA,EACrC,IAAI;AAAA,EACJ,UAAU;AAAA,EACV,MAAQ,UAAO;AAAA,EACf,OAAO,WAAW,SAAS;AAC/B,CAAC;AAIM,IAAM,8BAAgC,UAAO;AAAA,EAChD,MAAQ,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EAC/B,OAAO,WAAW,SAAS;AAC/B,CAAC;;;ACzJD,IAAAC,KAAmB;AAKZ,IAAM,eAAiB,QAAK,CAAC,QAAQ,QAAQ,CAAC;AAE9C,IAAM,sBAAwB,QAAK;AAAA,EACtC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAEM,IAAM,mBAAqB,QAAK;AAAA,EACnC;AAAA,EAAO;AAAA,EACP;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AACpD,CAAC;AAIM,IAAM,2BAA6B,UAAO;AAAA;AAAA,EAE7C,WAAa,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACpC,YAAc,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EACzC,UAAY,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACnC,aAAe,OAAI,KAAK,EAAE,KAAK,EAAE,aAAa,4BAA4B,CAAC;AAAA,EAC3E,QAAQ;AAAA,EACR,aAAe,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK;AAAA,IACxC,aAAa;AAAA,EACjB,CAAC;AAAA,EACD,SAAW,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EACrC,eAAiB,OAAI,KAAK;AAAA,EAC1B,YAAc,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EACxC,cAAgB,UAAO,EAAE,SAAS;AAAA;AAAA,EAGlC,SAAS,WAAW,SAAS,EAAE,KAAK;AAAA,IAChC,aAAa;AAAA,EACjB,CAAC;AAAA,EACD,QAAQ,WAAW,SAAS,EAAE,KAAK;AAAA,IAC/B,aAAa;AAAA,EACjB,CAAC;AAAA;AAAA,EAGD,UAAY,UAAO;AAAA,IACf,WAAa,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,IACpC,YAAc,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,IACzC,UAAY,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,IACnC,cAAgB,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,KAAK;AAAA,MACzC,aAAa;AAAA,IACjB,CAAC;AAAA,IACD,OAAS,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,IAC/B,OAAS,SAAM,EAAE,SAAS;AAAA,IAC1B,YAAc,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,IACxC,YAAc,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EAC7C,CAAC,EAAE,SAAS;AAChB,CAAC;AAMM,IAAM,uBAAyB,UAAO;AAAA,EACzC,IAAI;AAAA,EACJ,UAAU;AAAA,EACV,aAAe,UAAO;AAAA,EACtB,SAAW,UAAO,EAAE,SAAS;AAAA,EAC7B,WAAa,UAAO;AAAA,EACpB,YAAc,UAAO,EAAE,SAAS;AAAA,EAChC,UAAY,UAAO;AAAA,EACnB,aAAe,UAAO;AAAA,EACtB,QAAQ;AAAA,EACR,UAAY,UAAO,EAAE,SAAS;AAAA,EAC9B,YAAc,UAAO,EAAE,SAAS;AAAA,EAChC,cAAgB,UAAO,EAAE,SAAS;AAAA,EAClC,eAAiB,UAAO;AAAA,EACxB,QAAQ;AAAA,EACR,WAAa,UAAO;AAAA;AAAA,EAGpB,cAAgB,UAAO;AAAA,IACnB,SAAS;AAAA,IACT,WAAa,UAAO;AAAA,IACpB,YAAY;AAAA,IACZ,QAAQ;AAAA,IACR,UAAY,UAAO;AAAA,EACvB,CAAC,EAAE,SAAS;AAAA;AAAA,EAGZ,WAAa,SAAQ,UAAO;AAAA,IACxB,IAAI;AAAA,IACJ,WAAa,UAAO;AAAA,IACpB,YAAc,UAAO,EAAE,SAAS;AAAA,IAChC,UAAY,UAAO;AAAA,IACnB,cAAgB,UAAO;AAAA,IACvB,OAAS,UAAO;AAAA,IAChB,OAAS,UAAO,EAAE,SAAS;AAAA,IAC3B,WAAa,WAAQ;AAAA,EACzB,CAAC,CAAC;AACN,CAAC;AAMM,IAAM,wBAA0B,UAAO;AAAA,EAC1C,IAAI;AAAA,EACJ,aAAe,UAAO;AAAA,EACtB,WAAa,UAAO;AAAA,EACpB,YAAc,UAAO,EAAE,SAAS;AAAA,EAChC,UAAY,UAAO;AAAA,EACnB,QAAQ;AAAA,EACR,QAAQ;AAAA,EACR,WAAa,UAAO,EAAE,SAAS;AAAA,EAC/B,YAAY,iBAAiB,SAAS;AAAA,EACtC,qBAAuB,UAAO,EAAE,SAAS;AAAA,EACzC,sBAAwB,UAAO,EAAE,SAAS;AAAA,EAC1C,WAAa,UAAO;AACxB,CAAC;AAMM,IAAM,0BAA0B,sBAAsB,OAAO;AAAA,EAChE,QAAU,UAAO,EAAE,SAAS,EAAE,KAAK;AAAA,IAC/B,aAAa;AAAA,EACjB,CAAC;AAAA,EACD,SAAS,WAAW,SAAS;AAAA,EAC7B,YAAY,iBAAiB,SAAS;AAAA,EACtC,QAAQ,oBAAoB,SAAS;AAAA,EACrC,QAAQ,WAAW,SAAS;AAChC,CAAC;AAWM,IAAM,6BAA+B,UAAO;AAAA,EAC/C,WAAa,UAAO,EAAE,IAAI,CAAC;AAAA,EAC3B,YAAc,UAAO,EAAE,SAAS;AAAA,EAChC,UAAY,UAAO,EAAE,IAAI,CAAC;AAAA,EAC1B,aAAe,UAAO,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,4BAA4B,CAAC;AAAA,EAChF,QAAU,UAAO,EAAE,IAAI,CAAC,EAAE,KAAK,EAAE,aAAa,mCAAmC,CAAC;AAAA,EAClF,aAAe,UAAO,EAAE,IAAI,CAAC;AAAA,EAC7B,SAAW,UAAO,EAAE,SAAS;AAAA,EAC7B,eAAiB,UAAO,EAAE,SAAS;AAAA,EACnC,YAAc,UAAO,EAAE,SAAS;AAAA;AAAA,EAGhC,mBAAqB,UAAO,EAAE,SAAS;AAAA,EACvC,kBAAoB,UAAO,EAAE,SAAS;AAAA,EACtC,sBAAwB,UAAO,EAAE,SAAS;AAAA,EAC1C,eAAiB,UAAO,EAAE,SAAS;AAAA,EACnC,eAAiB,UAAO,EAAE,SAAS;AACvC,CAAC;AAIM,IAAM,gCAAkC,UAAO;AAAA,EAClD,SAAS,WAAW,KAAK;AAAA,IACrB,aAAa;AAAA,EACjB,CAAC;AAAA,EACD,QAAQ;AAAA,EACR,MAAQ,SAAM,0BAA0B,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAC5D,CAAC;AAIM,IAAM,iCAAmC,UAAO;AAAA,EACnD,SAAW,OAAI,EAAE,YAAY;AAAA,EAC7B,SAAW,OAAI,EAAE,YAAY;AAAA,EAC7B,QAAU,SAAQ,UAAO;AAAA,IACrB,KAAO,OAAI,EAAE,SAAS;AAAA,IACtB,aAAe,UAAO,EAAE,SAAS;AAAA,IACjC,QAAU,UAAO;AAAA,EACrB,CAAC,CAAC;AACN,CAAC;AAMM,IAAM,4BAA8B,UAAO;AAAA,EAC9C,WAAW;AAAA,EACX,aAAe,UAAO;AAC1B,CAAC;AAMM,IAAM,0BAA4B,UAAO;AAAA,EAC5C,WAAW;AAAA,EACX,WAAa,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACpC,YAAc,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EACzC,UAAY,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,GAAG;AAAA,EACnC,cAAgB,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EACtC,OAAS,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EAC/B,OAAS,SAAM,EAAE,SAAS;AAAA,EAC1B,YAAc,UAAO,EAAE,IAAI,EAAE,EAAE,SAAS;AAAA,EACxC,YAAc,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAAA,EACzC,WAAa,WAAQ,EAAE,QAAQ,KAAK;AACxC,CAAC;AAMM,IAAM,qBAAuB,UAAO;AAAA,EACvC,IAAI;AAAA,EACJ,MAAQ,UAAO;AAAA,EACf,YAAY;AAAA,EACZ,WAAa,UAAO;AAAA,EACpB,UAAY,UAAO,EAAE,SAAS;AAAA,EAC9B,eAAiB,UAAO;AAAA,EACxB,gBAAgB,WAAW,SAAS;AACxC,CAAC;;;AChOD,IAAAC,KAAmB;AAKZ,IAAM,yBAA2B,QAAK;AAAA,EACzC;AAAA,EACA;AAAA,EACA;AAAA,EACA;AACJ,CAAC;AAMM,IAAM,aAAe,UAAO;AAAA,EAC/B,IAAI;AAAA,EACJ,UAAU;AAAA,EACV,gBAAgB;AAAA,EAChB,MAAQ,UAAO;AAAA,EACf,WAAa,UAAO;AAAA,EACpB,SAAW,UAAO;AAAA,EAClB,WAAa,WAAQ;AACzB,CAAC;AAMM,IAAM,8BAAgC,UAAO;AAAA,EAChD,WAAW;AAAA,EACX,QAAQ;AAAA,EACR,OAAS,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AACxC,CAAC;AAEM,IAAM,4BAA8B,UAAO;AAAA,EAC9C,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,MAAQ,OAAI,KAAK;AAAA,EACjB,SAAW,SAAM,2BAA2B,EAAE,IAAI,CAAC;AACvD,CAAC;AAIM,IAAM,6BAA+B,UAAO;AAAA,EAC/C,OAAS,UAAO;AAAA,EAChB,MAAQ,UAAO;AAAA,EACf,SAAS;AACb,CAAC;AAMM,IAAM,wBAA0B,UAAO;AAAA,EAC1C,SAAS;AAAA,EACT,MAAQ,OAAI,KAAK;AACrB,CAAC;AAIM,IAAM,2BAA6B,UAAO;AAAA,EAC7C,IAAI;AAAA,EACJ,WAAW;AAAA,EACX,WAAa,UAAO;AAAA,EACpB,YAAc,UAAO,EAAE,SAAS;AAAA,EAChC,UAAY,UAAO;AAAA,EACnB,aAAe,UAAO;AAAA,EACtB,QAAQ;AAAA,EACR,OAAS,UAAO,EAAE,SAAS;AAAA,EAC3B,UAAU;AAAA,EACV,WAAa,UAAO;AACxB,CAAC;AAMM,IAAM,0BAA4B,UAAO;AAAA,EAC5C,WAAW;AAAA,EACX,QAAQ;AACZ,CAAC;AAIM,IAAM,6BAA+B,UAAO;AAAA,EAC/C,IAAI;AAAA,EACJ,MAAQ,UAAO;AAAA,EACf,QAAQ;AAAA,EACR,OAAS,UAAO,EAAE,SAAS;AAAA,EAC3B,SAAS;AAAA,EACT,WAAa,UAAO;AACxB,CAAC;;;AC9FD,IAAAC,KAAmB;AAIZ,IAAM,qBAAuB,UAAO;AAAA,EACvC,IAAM,UAAO,EAAE,KAAK;AAAA,EACpB,UAAY,UAAO,EAAE,KAAK;AAAA,EAC1B,MAAQ,UAAO;AAAA,EACf,WAAa,UAAO;AAAA,EACpB,SAAW,UAAO;AAAA,EAClB,WAAa,WAAQ;AAAA,EACrB,WAAa,UAAO;AACxB,CAAC;AAEM,IAAM,wBAA0B,UAAO;AAAA,EAC1C,MAAQ,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EAC9B,WAAa,UAAO,EAAE,MAAM,uBAAuB,oBAAoB;AAAA,EACvE,SAAW,UAAO,EAAE,MAAM,uBAAuB,oBAAoB;AACzE,CAAC;AAEM,IAAM,4BAA8B,UAAO;AAAA,EAC9C,QAAU,UAAO,EAAE,KAAK;AAC5B,CAAC;AAKM,IAAM,qBAAuB,UAAO;AAAA,EACvC,IAAM,UAAO,EAAE,KAAK;AAAA,EACpB,UAAY,UAAO,EAAE,KAAK;AAAA,EAC1B,gBAAkB,UAAO,EAAE,KAAK;AAAA,EAChC,MAAQ,UAAO;AAAA,EACf,WAAa,UAAO;AAAA,EACpB,SAAW,UAAO;AAAA,EAClB,WAAa,WAAQ;AAAA,EACrB,WAAa,UAAO;AACxB,CAAC;AAEM,IAAM,wBAA0B,UAAO;AAAA,EAC1C,gBAAkB,UAAO,EAAE,KAAK;AAAA,EAChC,MAAQ,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EAC9B,WAAa,UAAO,EAAE,MAAM,uBAAuB,oBAAoB;AAAA,EACvE,SAAW,UAAO,EAAE,MAAM,uBAAuB,oBAAoB;AACzE,CAAC;AAEM,IAAM,4BAA8B,UAAO;AAAA,EAC9C,QAAU,UAAO,EAAE,KAAK;AAC5B,CAAC;AAEM,IAAM,uBAAyB,UAAO;AAAA,EACzC,QAAU,UAAO,EAAE,KAAK,EAAE,SAAS;AACvC,CAAC;;;ACnDD,IAAAC,KAAmB;AAMZ,IAAM,eAAe;AAAA,EACxB;AAAA,EAAO;AAAA,EACP;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAAM;AAAA,EAC9B;AAAA,EAAM;AAAA,EAAM;AAChB;AAIO,IAAM,cAAgB,UAAO;AAAA,EAChC,IAAM,UAAO,EAAE,KAAK;AAAA,EACpB,UAAY,UAAO,EAAE,KAAK;AAAA,EAC1B,MAAQ,UAAO;AAAA,EACf,OAAO;AAAA,EACP,aAAe,UAAO,EAAE,SAAS;AACrC,CAAC;AAEM,IAAM,yBAA2B,UAAO;AAAA,EAC3C,MAAQ,UAAO,EAAE,IAAI,CAAC,EAAE,IAAI,EAAE;AAAA,EAC9B,OAAO;AAAA,EACP,aAAe,UAAO,EAAE,IAAI,GAAG,EAAE,SAAS;AAC9C,CAAC;","names":["z","z","z","z","z","z"]}

package/dist/schemas/index.d.cts

@@ -42,6 +42,7 @@ type PaginationInput = z.infer<typeof PaginationInputSchema>;
  *
  * Phase History:
  *   Phase 0.1 (2026-06-05): Initial creation
+ *   Phase 3   (2026-06-10): Replaced CuidSchema with z.string().uuid() per R-052
  *
  * @module src/schemas/auth
  * @since Phase 0.1
@@ -147,8 +148,12 @@ type SwitchBranchInput = z.infer<typeof SwitchBranchInputSchema>;
  * 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
+ *   Phase 1   (2026-06-07): Initial creation
+ *   Phase 4.2 (2026-06-13): Removed hardcoded RoleNameSchema — role is now
+ *                            a plain string (DB-driven). Removed salary fields
+ *                            from CreateStaffInput — remuneration module owns
+ *                            salary. Added helbNo, saccoNo statutory fields.
+ *                            Updated StaffProfile to remove salary columns.
  *
  * @module src/schemas/hr
  * @since Phase 1
@@ -160,35 +165,6 @@ declare const EmploymentTypeSchema: z.ZodEnum<{
     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>;
@@ -196,35 +172,7 @@ declare const CreateStaffInputSchema: z.ZodObject<{
     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";
-    }>;
+    roleName: z.ZodString;
     isPrimaryRole: z.ZodDefault<z.ZodBoolean>;
     departmentId: z.ZodOptional<z.ZodUUID>;
     designation: z.ZodString;
@@ -236,11 +184,6 @@ declare const CreateStaffInputSchema: z.ZodObject<{
     }>;
     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>;
@@ -248,6 +191,8 @@ declare const CreateStaffInputSchema: z.ZodObject<{
     kraPin: z.ZodOptional<z.ZodString>;
     nhifNo: z.ZodOptional<z.ZodString>;
     nssfNo: z.ZodOptional<z.ZodString>;
+    helbNo: z.ZodOptional<z.ZodString>;
+    saccoNo: z.ZodOptional<z.ZodString>;
 }, z.core.$strip>;
 type CreateStaffInput = z.infer<typeof CreateStaffInputSchema>;
 declare const StaffProfileSchema: z.ZodObject<{
@@ -263,6 +208,8 @@ declare const StaffProfileSchema: z.ZodObject<{
     kraPin: z.ZodNullable<z.ZodString>;
     nhifNo: z.ZodNullable<z.ZodString>;
     nssfNo: z.ZodNullable<z.ZodString>;
+    helbNo: z.ZodNullable<z.ZodString>;
+    saccoNo: z.ZodNullable<z.ZodString>;
     designation: z.ZodString;
     employmentType: z.ZodEnum<{
         permanent: "permanent";
@@ -272,11 +219,6 @@ declare const StaffProfileSchema: z.ZodObject<{
     }>;
     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>;
@@ -286,35 +228,7 @@ declare const StaffProfileSchema: z.ZodObject<{
     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";
-    }>>;
+    roleName: z.ZodNullable<z.ZodString>;
     roleId: z.ZodNullable<z.ZodUUID>;
 }, z.core.$strip>;
 type StaffProfile = z.infer<typeof StaffProfileSchema>;
@@ -335,35 +249,7 @@ declare const StaffListItemSchema: z.ZodObject<{
     }>;
     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";
-    }>>;
+    roleName: z.ZodNullable<z.ZodString>;
     createdAt: z.ZodString;
 }, z.core.$strip>;
 type StaffListItem = z.infer<typeof StaffListItemSchema>;
@@ -372,35 +258,7 @@ declare const ListStaffInputSchema: z.ZodObject<{
     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";
-    }>>;
+    roleName: z.ZodOptional<z.ZodString>;
     status: z.ZodOptional<z.ZodEnum<{
         active: "active";
         inactive: "inactive";
@@ -809,4 +667,111 @@ declare const StudentAttendanceRowSchema: z.ZodObject<{
 }, z.core.$strip>;
 type StudentAttendanceRow = z.infer<typeof StudentAttendanceRowSchema>;
 
-export { AttendanceRecordInputSchema, type AttendanceStatusEnum, AttendanceStatusSchema, BranchRefSchema, type BulkUploadStudentRow, BulkUploadStudentRowSchema, type BulkUploadStudentsInput, BulkUploadStudentsInputSchema, type BulkUploadStudentsOutput, BulkUploadStudentsOutputSchema, type ChangePasswordInput, ChangePasswordInputSchema, type ClassAttendanceRow, ClassAttendanceRowSchema, type ClassSummary, ClassSummarySchema, type CreateDepartmentInput, CreateDepartmentInputSchema, type CreateStaffInput, CreateStaffInputSchema, type CreateStaffOutput, CreateStaffOutputSchema, type CreateStudentInput, CreateStudentInputSchema, type CreateStudentOutput, CreateStudentOutputSchema, CuidSchema, type Department, DepartmentSchema, EmploymentTypeSchema, GenderSchema, type GetByClassInput, GetByClassInputSchema, type GetByStudentInput, GetByStudentInputSchema, GradeLevelSchema, type LinkGuardianInput, LinkGuardianInputSchema, type ListStaffInput, ListStaffInputSchema, type ListStudentsInput, ListStudentsInputSchema, type LoginInput, LoginInputSchema, type LoginOutput, LoginOutputSchema, LogoutInputSchema, type MarkAttendanceInput, MarkAttendanceInputSchema, type MarkAttendanceOutput, MarkAttendanceOutputSchema, 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 StudentAttendanceRow, StudentAttendanceRowSchema, type StudentListItem, StudentListItemSchema, type StudentProfile, StudentProfileSchema, StudentStatusSchema, type SwitchBranchInput, SwitchBranchInputSchema, type Term, TermSchema, type Timestamps, TimestampsSchema, UuidSchema, paginatedOutputSchema };
+/**
+ * Brite Future Schools — bfs-contracts
+ * Calendar schemas — academic years and terms.
+ *
+ * Phase History:
+ *   Phase 4.1 (2026-06-12): Initial creation
+ *
+ * @module src/schemas/calendar
+ * @since Phase 4.1
+ */
+
+declare const AcademicYearSchema: z.ZodObject<{
+    id: z.ZodString;
+    branchId: z.ZodString;
+    name: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    isCurrent: z.ZodBoolean;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+declare const CreateYearInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+}, z.core.$strip>;
+declare const SetCurrentYearInputSchema: z.ZodObject<{
+    yearId: z.ZodString;
+}, z.core.$strip>;
+declare const AcademicTermSchema: z.ZodObject<{
+    id: z.ZodString;
+    branchId: z.ZodString;
+    academicYearId: z.ZodString;
+    name: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+    isCurrent: z.ZodBoolean;
+    createdAt: z.ZodString;
+}, z.core.$strip>;
+declare const CreateTermInputSchema: z.ZodObject<{
+    academicYearId: z.ZodString;
+    name: z.ZodString;
+    startDate: z.ZodString;
+    endDate: z.ZodString;
+}, z.core.$strip>;
+declare const SetCurrentTermInputSchema: z.ZodObject<{
+    termId: z.ZodString;
+}, z.core.$strip>;
+declare const ListTermsInputSchema: z.ZodObject<{
+    yearId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type AcademicYear = z.infer<typeof AcademicYearSchema>;
+type AcademicTerm = z.infer<typeof AcademicTermSchema>;
+type CreateYearInput = z.infer<typeof CreateYearInputSchema>;
+type CreateTermInput = z.infer<typeof CreateTermInputSchema>;
+
+/**
+ * Brite Future Schools — bfs-contracts
+ * Grades schemas.
+ *
+ * Phase History:
+ *   Phase 4.1 (2026-06-12): Initial creation
+ *
+ * @module src/schemas/grades
+ * @since Phase 4.1
+ */
+
+declare const GRADE_LEVELS: readonly ["PP1", "PP2", "G1", "G2", "G3", "G4", "G5", "G6", "G7", "G8", "G9"];
+type GradeLevel = typeof GRADE_LEVELS[number];
+declare const GradeSchema: z.ZodObject<{
+    id: z.ZodString;
+    branchId: z.ZodString;
+    name: z.ZodString;
+    level: z.ZodEnum<{
+        PP1: "PP1";
+        PP2: "PP2";
+        G1: "G1";
+        G2: "G2";
+        G3: "G3";
+        G4: "G4";
+        G5: "G5";
+        G6: "G6";
+        G7: "G7";
+        G8: "G8";
+        G9: "G9";
+    }>;
+    description: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+declare const CreateGradeInputSchema: z.ZodObject<{
+    name: z.ZodString;
+    level: z.ZodEnum<{
+        PP1: "PP1";
+        PP2: "PP2";
+        G1: "G1";
+        G2: "G2";
+        G3: "G3";
+        G4: "G4";
+        G5: "G5";
+        G6: "G6";
+        G7: "G7";
+        G8: "G8";
+        G9: "G9";
+    }>;
+    description: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+type Grade = z.infer<typeof GradeSchema>;
+type CreateGradeInput = z.infer<typeof CreateGradeInputSchema>;
+
+export { type AcademicTerm, AcademicTermSchema, type AcademicYear, AcademicYearSchema, AttendanceRecordInputSchema, type AttendanceStatusEnum, AttendanceStatusSchema, BranchRefSchema, type BulkUploadStudentRow, BulkUploadStudentRowSchema, type BulkUploadStudentsInput, BulkUploadStudentsInputSchema, type BulkUploadStudentsOutput, BulkUploadStudentsOutputSchema, type ChangePasswordInput, ChangePasswordInputSchema, type ClassAttendanceRow, ClassAttendanceRowSchema, type ClassSummary, ClassSummarySchema, type CreateDepartmentInput, CreateDepartmentInputSchema, type CreateGradeInput, CreateGradeInputSchema, type CreateStaffInput, CreateStaffInputSchema, type CreateStaffOutput, CreateStaffOutputSchema, type CreateStudentInput, CreateStudentInputSchema, type CreateStudentOutput, CreateStudentOutputSchema, type CreateTermInput, CreateTermInputSchema, type CreateYearInput, CreateYearInputSchema, CuidSchema, type Department, DepartmentSchema, EmploymentTypeSchema, GRADE_LEVELS, GenderSchema, type GetByClassInput, GetByClassInputSchema, type GetByStudentInput, GetByStudentInputSchema, type Grade, type GradeLevel, GradeLevelSchema, GradeSchema, type LinkGuardianInput, LinkGuardianInputSchema, type ListStaffInput, ListStaffInputSchema, type ListStudentsInput, ListStudentsInputSchema, ListTermsInputSchema, type LoginInput, LoginInputSchema, type LoginOutput, LoginOutputSchema, LogoutInputSchema, type MarkAttendanceInput, MarkAttendanceInputSchema, type MarkAttendanceOutput, MarkAttendanceOutputSchema, type PaginationInput, PaginationInputSchema, type RefreshTokenInput, RefreshTokenInputSchema, type RefreshTokenOutput, RefreshTokenOutputSchema, RequestPasswordResetInputSchema, ResetPasswordInputSchema, type SessionUserOutput, SessionUserOutputSchema, SessionUserRoleSchema, SessionUserSubRoleSchema, SetCurrentTermInputSchema, SetCurrentYearInputSchema, type SoftDelete, SoftDeleteSchema, type StaffListItem, StaffListItemSchema, type StaffProfile, StaffProfileSchema, type StudentAttendanceRow, StudentAttendanceRowSchema, type StudentListItem, StudentListItemSchema, type StudentProfile, StudentProfileSchema, StudentStatusSchema, type SwitchBranchInput, SwitchBranchInputSchema, type Term, TermSchema, type Timestamps, TimestampsSchema, UuidSchema, paginatedOutputSchema };