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

package/dist/contracts/index.cjs

@@ -33,28 +33,38 @@ __export(contracts_exports, {
   attendanceContract: () => attendanceContract,
   authContract: () => authContract,
   bulkUploadStudentsContract: () => bulkUploadStudentsContract,
+  calendarContract: () => calendarContract,
+  calendarListTermsContract: () => calendarListTermsContract,
   changePasswordContract: () => changePasswordContract,
   createDepartmentContract: () => createDepartmentContract,
+  createGradeContract: () => createGradeContract,
   createStaffContract: () => createStaffContract,
   createStudentContract: () => createStudentContract,
+  createTermContract: () => createTermContract,
+  createYearContract: () => createYearContract,
   getByClassContract: () => getByClassContract,
   getByStudentContract: () => getByStudentContract,
   getMeContract: () => getMeContract,
   getStaffByIdContract: () => getStaffByIdContract,
   getStudentByIdContract: () => getStudentByIdContract,
+  gradesContract: () => gradesContract,
   hrContract: () => hrContract,
   linkGuardianContract: () => linkGuardianContract,
   listClassesContract: () => listClassesContract,
   listDepartmentsContract: () => listDepartmentsContract,
+  listGradesContract: () => listGradesContract,
   listStaffContract: () => listStaffContract,
   listStudentsContract: () => listStudentsContract,
   listTermsContract: () => listTermsContract,
+  listYearsContract: () => listYearsContract,
   loginContract: () => loginContract,
   logoutContract: () => logoutContract,
   markAttendanceContract: () => markAttendanceContract,
   refreshTokenContract: () => refreshTokenContract,
   requestPasswordResetContract: () => requestPasswordResetContract,
   resetPasswordContract: () => resetPasswordContract,
+  setCurrentTermContract: () => setCurrentTermContract,
+  setCurrentYearContract: () => setCurrentYearContract,
   studentsContract: () => studentsContract,
   switchBranchContract: () => switchBranchContract,
   updateStaffStatusContract: () => updateStaffStatusContract
@@ -63,108 +73,82 @@ module.exports = __toCommonJS(contracts_exports);
 
 // src/contracts/auth.ts
 var import_contract = require("@orpc/contract");
-var z3 = __toESM(require("zod"), 1);
-
-// src/schemas/auth.ts
 var z2 = __toESM(require("zod"), 1);
 
-// src/schemas/base.ts
-var z = __toESM(require("zod"), 1);
-var CuidSchema = z.string().regex(/^[a-z][a-z0-9]{24}$/, "Invalid cuid2 identifier").meta({ description: "cuid2 \u2014 prefixed, collision-resistant identifier" });
-var UuidSchema = z.uuidv4().meta({ description: "RFC-4122 UUID v4" });
-var IsoDatetime = z.iso.datetime();
-var TimestampsSchema = z.object({
-  createdAt: IsoDatetime.meta({ description: "ISO-8601 creation time (UTC)" }),
-  updatedAt: IsoDatetime.meta({ description: "ISO-8601 last update time (UTC)" })
-});
-var SoftDeleteSchema = z.object({
-  deletedAt: IsoDatetime.nullable().meta({
-    description: "Set when the record is soft-deleted; null if active"
-  })
-});
-var PaginationInputSchema = z.object({
-  cursor: CuidSchema.optional().meta({
-    description: "Opaque cursor from the previous page response"
-  }),
-  limit: z.int().min(1).max(100).default(20).meta({ description: "Number of items to return (1\u2013100, default 20)" })
-});
-var BranchRefSchema = z.object({
-  branchId: CuidSchema.meta({ description: "The branch this record belongs to" })
-});
-
 // src/schemas/auth.ts
-var SessionUserRoleSchema = z2.object({
-  id: CuidSchema,
-  name: z2.string().meta({ description: "Role name, e.g. PRINCIPAL" }),
-  branchId: CuidSchema,
-  isPrimary: z2.boolean()
-});
-var SessionUserSubRoleSchema = z2.object({
-  id: CuidSchema,
-  name: z2.string().meta({ description: "Sub-role name, e.g. HEAD_PREFECT" }),
-  branchId: CuidSchema
-});
-var SessionUserOutputSchema = z2.object({
-  id: CuidSchema,
-  email: z2.email(),
-  firstName: z2.string(),
-  lastName: z2.string(),
-  activeBranchId: CuidSchema,
-  roles: z2.array(SessionUserRoleSchema),
-  subRoles: z2.array(SessionUserSubRoleSchema),
-  isActive: z2.boolean(),
-  mustChangePassword: z2.boolean()
-});
-var LoginInputSchema = z2.object({
-  email: z2.email().meta({ description: "User email address" }),
-  password: z2.string().min(1).meta({ description: "Plain-text password (sent over TLS)" }),
-  branchId: CuidSchema.optional().meta({
+var z = __toESM(require("zod"), 1);
+var SessionUserRoleSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string().meta({ description: "Role name, e.g. PRINCIPAL" }),
+  branchId: z.string().uuid(),
+  isPrimary: z.boolean()
+});
+var SessionUserSubRoleSchema = z.object({
+  id: z.string().uuid(),
+  name: z.string().meta({ description: "Sub-role name, e.g. HEAD_PREFECT" }),
+  branchId: z.string().uuid()
+});
+var SessionUserOutputSchema = z.object({
+  id: z.string().uuid(),
+  email: z.email(),
+  firstName: z.string(),
+  lastName: z.string(),
+  activeBranchId: z.string().uuid(),
+  roles: z.array(SessionUserRoleSchema),
+  subRoles: z.array(SessionUserSubRoleSchema),
+  isActive: z.boolean(),
+  mustChangePassword: z.boolean()
+});
+var LoginInputSchema = z.object({
+  email: z.email().meta({ description: "User email address" }),
+  password: z.string().min(1).meta({ description: "Plain-text password (sent over TLS)" }),
+  branchId: z.string().uuid().optional().meta({
     description: "Branch to activate on login; defaults to user primary branch"
   })
 });
-var LoginOutputSchema = z2.object({
-  accessToken: z2.string().meta({ description: "Short-lived JWT (15 min)" }),
-  refreshToken: z2.string().meta({ description: "Long-lived opaque refresh token (7 days)" }),
-  expiresIn: z2.int().positive().meta({ description: "Access token TTL in seconds" }),
+var LoginOutputSchema = z.object({
+  accessToken: z.string().meta({ description: "Short-lived JWT (15 min)" }),
+  refreshToken: z.string().meta({ description: "Long-lived opaque refresh token (7 days)" }),
+  expiresIn: z.int().positive().meta({ description: "Access token TTL in seconds" }),
   user: SessionUserOutputSchema
 });
-var RefreshTokenInputSchema = z2.object({
-  refreshToken: z2.string().min(1)
+var RefreshTokenInputSchema = z.object({
+  refreshToken: z.string().min(1)
 });
-var RefreshTokenOutputSchema = z2.object({
-  accessToken: z2.string(),
-  expiresIn: z2.int().positive()
+var RefreshTokenOutputSchema = z.object({
+  accessToken: z.string(),
+  expiresIn: z.int().positive()
 });
-var LogoutInputSchema = z2.object({
-  refreshToken: z2.string().min(1).meta({
+var LogoutInputSchema = z.object({
+  refreshToken: z.string().min(1).meta({
     description: "The refresh token to revoke; also invalidated server-side"
   })
 });
-var ChangePasswordInputSchema = z2.object({
-  currentPassword: z2.string().min(1),
-  newPassword: z2.string().min(8, { error: "Password must be at least 8 characters" }),
-  confirmPassword: z2.string().min(1)
+var ChangePasswordInputSchema = z.object({
+  currentPassword: z.string().min(1),
+  newPassword: z.string().min(8, { error: "Password must be at least 8 characters" }),
+  confirmPassword: z.string().min(1)
 }).refine((v) => v.newPassword === v.confirmPassword, {
   error: "Passwords do not match",
   path: ["confirmPassword"]
 });
-var RequestPasswordResetInputSchema = z2.object({
-  email: z2.email()
+var RequestPasswordResetInputSchema = z.object({
+  email: z.email()
 });
-var ResetPasswordInputSchema = z2.object({
-  token: z2.string().min(1).meta({ description: "One-time reset token from email link" }),
-  newPassword: z2.string().min(8, { error: "Password must be at least 8 characters" }),
-  confirmPassword: z2.string().min(1)
+var ResetPasswordInputSchema = z.object({
+  token: z.string().min(1).meta({ description: "One-time reset token from email link" }),
+  newPassword: z.string().min(8, { error: "Password must be at least 8 characters" }),
+  confirmPassword: z.string().min(1)
 }).refine((v) => v.newPassword === v.confirmPassword, {
   error: "Passwords do not match",
   path: ["confirmPassword"]
 });
-var SwitchBranchInputSchema = z2.object({
-  branchId: z2.string().uuid().meta({ description: "Branch to switch the active session to" })
+var SwitchBranchInputSchema = z.object({
+  branchId: z.string().uuid().meta({ description: "Branch to switch the active session to" })
 });
 
 // src/contracts/auth.ts
-var EmptyOutputSchema = z3.object({}).meta({ description: "Empty success response" });
+var EmptyOutputSchema = z2.object({}).meta({ description: "Empty success response" });
 var loginContract = import_contract.oc.route({ method: "POST", path: "/auth/login" }).input(LoginInputSchema).output(LoginOutputSchema);
 var refreshTokenContract = import_contract.oc.route({ method: "POST", path: "/auth/refresh" }).input(RefreshTokenInputSchema).output(RefreshTokenOutputSchema);
 var logoutContract = import_contract.oc.route({ method: "POST", path: "/auth/logout" }).input(LogoutInputSchema).output(EmptyOutputSchema);
@@ -188,6 +172,30 @@ var authContract = {
 var import_contract2 = require("@orpc/contract");
 var z5 = __toESM(require("zod"), 1);
 
+// src/schemas/base.ts
+var z3 = __toESM(require("zod"), 1);
+var CuidSchema = z3.string().regex(/^[a-z][a-z0-9]{24}$/, "Invalid cuid2 identifier").meta({ description: "cuid2 \u2014 prefixed, collision-resistant identifier" });
+var UuidSchema = z3.uuidv4().meta({ description: "RFC-4122 UUID v4" });
+var IsoDatetime = z3.iso.datetime();
+var TimestampsSchema = z3.object({
+  createdAt: IsoDatetime.meta({ description: "ISO-8601 creation time (UTC)" }),
+  updatedAt: IsoDatetime.meta({ description: "ISO-8601 last update time (UTC)" })
+});
+var SoftDeleteSchema = z3.object({
+  deletedAt: IsoDatetime.nullable().meta({
+    description: "Set when the record is soft-deleted; null if active"
+  })
+});
+var PaginationInputSchema = z3.object({
+  cursor: CuidSchema.optional().meta({
+    description: "Opaque cursor from the previous page response"
+  }),
+  limit: z3.int().min(1).max(100).default(20).meta({ description: "Number of items to return (1\u2013100, default 20)" })
+});
+var BranchRefSchema = z3.object({
+  branchId: CuidSchema.meta({ description: "The branch this record belongs to" })
+});
+
 // src/schemas/hr.ts
 var z4 = __toESM(require("zod"), 1);
 var EmploymentTypeSchema = z4.enum([
@@ -196,35 +204,6 @@ var EmploymentTypeSchema = z4.enum([
   "temporary",
   "intern"
 ]);
-var RoleNameSchema = z4.enum([
-  "PROPRIETOR",
-  "DIRECTOR",
-  "SYSTEM_ADMIN",
-  "PRINCIPAL",
-  "DEPUTY_PRINCIPAL",
-  "HOD",
-  "CLASS_TEACHER",
-  "SUBJECT_TEACHER",
-  "BURSAR",
-  "HR_ADMIN",
-  "SCHOOL_NURSE",
-  "LIBRARIAN",
-  "LAB_TECHNICIAN",
-  "SPORTS_COACH",
-  "COUNSELLOR",
-  "CARETAKER",
-  "SECURITY",
-  "KITCHEN_STAFF",
-  "KITCHEN_MANAGER",
-  "DRIVER",
-  "IT_ADMIN",
-  "BOARDING_MASTER",
-  "PREFECT",
-  "STUDENT",
-  "PARENT",
-  "ORG_SPONSOR",
-  "INDIVIDUAL_SPONSOR"
-]);
 var CreateStaffInputSchema = z4.object({
   // Personal details
   firstName: z4.string().min(1).max(100),
@@ -233,9 +212,9 @@ var CreateStaffInputSchema = z4.object({
   email: z4.email(),
   phone: z4.string().min(9).max(30),
   nationalId: z4.string().min(1).max(20),
-  // Role assignment
-  roleName: RoleNameSchema.meta({
-    description: "System role to assign \u2014 determines dashboard access and permissions"
+  // Role assignment — DB-driven, any valid role code accepted
+  roleName: z4.string().min(1).meta({
+    description: "Role code from the roles table \u2014 e.g. TEACHER, PRINCIPAL"
   }),
   isPrimaryRole: z4.boolean().default(true),
   // Employment details
@@ -246,24 +225,19 @@ var CreateStaffInputSchema = z4.object({
   employmentType: EmploymentTypeSchema,
   contractStart: z4.iso.date().meta({ description: "ISO date, e.g. 2026-01-15" }),
   contractEnd: z4.iso.date().optional(),
-  // Payroll
-  basicSalary: z4.number().positive(),
-  houseAllowance: z4.number().nonnegative().default(0),
-  transportAllowance: z4.number().nonnegative().default(0),
-  helbDeduction: z4.number().nonnegative().default(0),
-  saccoDeduction: z4.number().nonnegative().default(0),
-  // Banking
+  // Banking (optional at creation — can be completed later)
   bankName: z4.string().max(100).optional(),
   bankAccount: z4.string().max(30).optional(),
   bankBranch: z4.string().max(100).optional(),
-  // Statutory
+  // Statutory (optional at creation)
   tscNumber: z4.string().max(30).optional(),
   kraPin: z4.string().max(20).optional(),
   nhifNo: z4.string().max(20).optional(),
-  nssfNo: z4.string().max(20).optional()
+  nssfNo: z4.string().max(20).optional(),
+  helbNo: z4.string().max(20).optional(),
+  saccoNo: z4.string().max(20).optional()
 });
 var StaffProfileSchema = z4.object({
-  // Staff record
   id: UuidSchema,
   userId: UuidSchema,
   branchId: UuidSchema,
@@ -276,28 +250,23 @@ var StaffProfileSchema = z4.object({
   kraPin: z4.string().nullable(),
   nhifNo: z4.string().nullable(),
   nssfNo: z4.string().nullable(),
+  helbNo: z4.string().nullable(),
+  saccoNo: z4.string().nullable(),
   designation: z4.string(),
   employmentType: EmploymentTypeSchema,
   contractStart: z4.string(),
   contractEnd: z4.string().nullable(),
-  basicSalary: z4.string(),
-  houseAllowance: z4.string(),
-  transportAllowance: z4.string(),
-  helbDeduction: z4.string().nullable(),
-  saccoDeduction: z4.string().nullable(),
   bankName: z4.string().nullable(),
   bankAccount: z4.string().nullable(),
   bankBranch: z4.string().nullable(),
   status: z4.string(),
   createdAt: z4.string(),
-  // From users join
   email: z4.string(),
   mustChangePassword: z4.boolean(),
-  // Department (nullable — not all staff are in a department)
   departmentId: UuidSchema.nullable(),
   departmentName: z4.string().nullable(),
-  // Primary role
-  roleName: RoleNameSchema.nullable(),
+  // Role — DB-driven code string, not a fixed enum
+  roleName: z4.string().nullable(),
   roleId: UuidSchema.nullable()
 });
 var StaffListItemSchema = z4.object({
@@ -312,7 +281,7 @@ var StaffListItemSchema = z4.object({
   employmentType: EmploymentTypeSchema,
   status: z4.string(),
   departmentName: z4.string().nullable(),
-  roleName: RoleNameSchema.nullable(),
+  roleName: z4.string().nullable(),
   createdAt: z4.string()
 });
 var ListStaffInputSchema = PaginationInputSchema.extend({
@@ -320,14 +289,13 @@ var ListStaffInputSchema = PaginationInputSchema.extend({
     description: "Search by name or email"
   }),
   departmentId: UuidSchema.optional(),
-  roleName: RoleNameSchema.optional(),
+  roleName: z4.string().optional(),
   status: z4.enum(["active", "inactive"]).optional()
 });
 var CreateStaffOutputSchema = z4.object({
   staffId: UuidSchema,
   userId: UuidSchema,
   email: z4.string(),
-  /** Temp password was emailed — not returned in response for security */
   emailSent: z4.boolean()
 });
 var DepartmentSchema = z4.object({
@@ -646,33 +614,132 @@ var attendanceContract = {
   getByStudent: getByStudentContract,
   listTerms: listTermsContract
 };
+
+// src/contracts/calendar.ts
+var import_contract5 = require("@orpc/contract");
+var z11 = __toESM(require("zod"), 1);
+
+// src/schemas/calendar.ts
+var z10 = __toESM(require("zod"), 1);
+var AcademicYearSchema = z10.object({
+  id: z10.string().uuid(),
+  branchId: z10.string().uuid(),
+  name: z10.string(),
+  startDate: z10.string(),
+  endDate: z10.string(),
+  isCurrent: z10.boolean(),
+  createdAt: z10.string()
+});
+var CreateYearInputSchema = z10.object({
+  name: z10.string().min(1).max(50),
+  startDate: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Must be YYYY-MM-DD"),
+  endDate: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Must be YYYY-MM-DD")
+});
+var SetCurrentYearInputSchema = z10.object({
+  yearId: z10.string().uuid()
+});
+var AcademicTermSchema = z10.object({
+  id: z10.string().uuid(),
+  branchId: z10.string().uuid(),
+  academicYearId: z10.string().uuid(),
+  name: z10.string(),
+  startDate: z10.string(),
+  endDate: z10.string(),
+  isCurrent: z10.boolean(),
+  createdAt: z10.string()
+});
+var CreateTermInputSchema = z10.object({
+  academicYearId: z10.string().uuid(),
+  name: z10.string().min(1).max(50),
+  startDate: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Must be YYYY-MM-DD"),
+  endDate: z10.string().regex(/^\d{4}-\d{2}-\d{2}$/, "Must be YYYY-MM-DD")
+});
+var SetCurrentTermInputSchema = z10.object({
+  termId: z10.string().uuid()
+});
+var ListTermsInputSchema = z10.object({
+  yearId: z10.string().uuid().optional()
+});
+
+// src/contracts/calendar.ts
+var listYearsContract = import_contract5.oc.route({ method: "GET", path: "/calendar/years" }).input(z11.object({})).output(z11.array(AcademicYearSchema));
+var createYearContract = import_contract5.oc.route({ method: "POST", path: "/calendar/years" }).input(CreateYearInputSchema).output(AcademicYearSchema);
+var setCurrentYearContract = import_contract5.oc.route({ method: "POST", path: "/calendar/years/current" }).input(SetCurrentYearInputSchema).output(AcademicYearSchema);
+var calendarListTermsContract = import_contract5.oc.route({ method: "GET", path: "/calendar/terms" }).input(ListTermsInputSchema).output(z11.array(AcademicTermSchema));
+var createTermContract = import_contract5.oc.route({ method: "POST", path: "/calendar/terms" }).input(CreateTermInputSchema).output(AcademicTermSchema);
+var setCurrentTermContract = import_contract5.oc.route({ method: "POST", path: "/calendar/terms/current" }).input(SetCurrentTermInputSchema).output(AcademicTermSchema);
+var calendarContract = {
+  listYears: listYearsContract,
+  createYear: createYearContract,
+  setCurrentYear: setCurrentYearContract,
+  listTerms: calendarListTermsContract,
+  createTerm: createTermContract,
+  setCurrentTerm: setCurrentTermContract
+};
+
+// src/contracts/grades.ts
+var import_contract6 = require("@orpc/contract");
+var z13 = __toESM(require("zod"), 1);
+
+// src/schemas/grades.ts
+var z12 = __toESM(require("zod"), 1);
+var GradeSchema = z12.object({
+  id: z12.string().uuid(),
+  branchId: z12.string().uuid(),
+  name: z12.string(),
+  level: GradeLevelSchema,
+  description: z12.string().nullable()
+});
+var CreateGradeInputSchema = z12.object({
+  name: z12.string().min(1).max(50),
+  level: GradeLevelSchema,
+  description: z12.string().max(300).optional()
+});
+
+// src/contracts/grades.ts
+var listGradesContract = import_contract6.oc.route({ method: "GET", path: "/grades" }).input(z13.object({})).output(z13.array(GradeSchema));
+var createGradeContract = import_contract6.oc.route({ method: "POST", path: "/grades" }).input(CreateGradeInputSchema).output(GradeSchema);
+var gradesContract = {
+  list: listGradesContract,
+  create: createGradeContract
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   attendanceContract,
   authContract,
   bulkUploadStudentsContract,
+  calendarContract,
+  calendarListTermsContract,
   changePasswordContract,
   createDepartmentContract,
+  createGradeContract,
   createStaffContract,
   createStudentContract,
+  createTermContract,
+  createYearContract,
   getByClassContract,
   getByStudentContract,
   getMeContract,
   getStaffByIdContract,
   getStudentByIdContract,
+  gradesContract,
   hrContract,
   linkGuardianContract,
   listClassesContract,
   listDepartmentsContract,
+  listGradesContract,
   listStaffContract,
   listStudentsContract,
   listTermsContract,
+  listYearsContract,
   loginContract,
   logoutContract,
   markAttendanceContract,
   refreshTokenContract,
   requestPasswordResetContract,
   resetPasswordContract,
+  setCurrentTermContract,
+  setCurrentYearContract,
   studentsContract,
   switchBranchContract,
   updateStaffStatusContract