@eeplatform/basic-edu 1.8.6 → 1.8.8

package/dist/index.mjs

@@ -2875,7 +2875,7 @@ var learnerInfoSchema = Joi5.object({
 });
 var schemaUpdateStatus = Joi5.object({
   _id: Joi5.string().hex().length(24).required(),
-  status: Joi5.string().valid("pending", "accepted", "rejected").required()
+  status: Joi5.string().valid("pending", "accepted", "rejected", "cancelled").required()
 });
 var gradeLevels = [
   "K1",
@@ -3580,17 +3580,16 @@ function useLearnerRepo() {
       school: Joi7.string().hex().required(),
       schoolYear: Joi7.string().required(),
       gradeLevel: Joi7.string().required(),
+      specialProgram: Joi7.string().hex().optional().allow(null, ""),
       status: Joi7.string().optional()
     });
     const { error } = validation.validate(value);
     if (error) {
       throw new BadRequestError9(`Invalid data: ${error.message}`);
     }
-    const status = value.status ?? "active";
     const query = {
       schoolYear: value.schoolYear,
-      gradeLevel: value.gradeLevel,
-      status
+      gradeLevel: value.gradeLevel
     };
     const cacheKeyOptions = {
       ...query,
@@ -3604,6 +3603,16 @@ function useLearnerRepo() {
       }
       cacheKeyOptions.school = value.school.toString();
     }
+    if (value.specialProgram) {
+      try {
+        query["learnerInfo.specialProgram"] = new ObjectId7(
+          value.specialProgram
+        );
+      } catch (error2) {
+        throw new BadRequestError9("Invalid special program ID.");
+      }
+      cacheKeyOptions.specialProgram = value.specialProgram.toString();
+    }
     const cacheKey = makeCacheKey4(namespace_collection, cacheKeyOptions);
     const cachedData = await getCache(cacheKey);
     if (cachedData !== void 0 && cachedData !== null) {
@@ -4337,6 +4346,51 @@ function useProgramScreeningRepo() {
       }
     }
   }
+  async function getByApplicantId(_id) {
+    try {
+      _id = new ObjectId10(_id);
+    } catch (error) {
+      throw new BadRequestError14("Invalid ID.");
+    }
+    const cacheKey = makeCacheKey6(namespace_collection, {
+      applicant: String(_id)
+    });
+    try {
+      const cached = await getCache(cacheKey);
+      if (cached) {
+        logger11.log({
+          level: "info",
+          message: `Cache hit for getById program screening: ${cacheKey}`
+        });
+        return cached;
+      }
+      const result = await collection.findOne({
+        applicant: _id,
+        status: { $ne: "deleted" }
+      });
+      if (!result) {
+        throw new BadRequestError14("Program screening not found.");
+      }
+      setCache(cacheKey, result, 300).then(() => {
+        logger11.log({
+          level: "info",
+          message: `Cache set for program screening by id: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger11.log({
+          level: "error",
+          message: `Failed to set cache for program screening by id: ${err.message}`
+        });
+      });
+      return result;
+    } catch (error) {
+      if (error instanceof AppError7) {
+        throw error;
+      } else {
+        throw new InternalServerError5("Failed to get program screening.");
+      }
+    }
+  }
   async function getByCode(code, school) {
     try {
       school = new ObjectId10(school);
@@ -4460,6 +4514,26 @@ function useProgramScreeningRepo() {
       );
     }
   }
+  async function updateStatusByApplicantId(_id, status, session) {
+    try {
+      _id = new ObjectId10(_id);
+    } catch (error) {
+      throw new BadRequestError14("Invalid ID.");
+    }
+    try {
+      await collection.updateOne(
+        { applicant: _id },
+        { $set: { status, updatedAt: /* @__PURE__ */ new Date() } },
+        { session }
+      );
+      delCachedData();
+      return "Successfully updated program screening status.";
+    } catch (error) {
+      throw new InternalServerError5(
+        "Failed to update program screening status."
+      );
+    }
+  }
   return {
     createIndexes,
     add,
@@ -4468,7 +4542,9 @@ function useProgramScreeningRepo() {
     getByCode,
     updateFieldById,
     deleteById,
-    updateById
+    updateById,
+    updateStatusByApplicantId,
+    getByApplicantId
   };
 }
 
@@ -5364,7 +5440,11 @@ function useEnrollmentService() {
     getById: _getById,
     updateStatusById: _updateStatusById
   } = useEnrollmentRepo();
-  const { add: addProgramScreening } = useProgramScreeningRepo();
+  const {
+    add: addProgramScreening,
+    updateStatusByApplicantId,
+    getByApplicantId
+  } = useProgramScreeningRepo();
   const { getById: getProgramById } = useProgramRepo();
   async function add(value) {
     const session = useAtlas10.getClient()?.startSession();
@@ -5495,6 +5575,11 @@ function useEnrollmentService() {
       if (status === "rejected" && enrollment.status == "accepted") {
         throw new BadRequestError19("Accepted enrollments cannot be rejected.");
       }
+      if (status === "withdrawn" && enrollment.status !== "screening") {
+        throw new BadRequestError19(
+          "Only enrollments in screening status can be withdrawn."
+        );
+      }
       const result = await _updateStatusById(_id, status, session);
       if (result.modifiedCount === 0) {
         throw new InternalServerError7("Failed to accept enrollment");
@@ -5534,6 +5619,14 @@ function useEnrollmentService() {
         enrollment.createdBy = enrollment.createdBy?.toString();
         await addLearner(enrollment, session);
       }
+      const programScreening = await getByApplicantId(_id);
+      if (programScreening) {
+        if (["cancelled", "withdrawn"].includes(status)) {
+          await updateStatusByApplicantId(_id, "cancelled", session);
+        } else {
+          await updateStatusByApplicantId(_id, status, session);
+        }
+      }
       await session.commitTransaction();
       return "Enrollment accepted successfully";
     } catch (error2) {
@@ -6168,7 +6261,8 @@ function useGradeLevelController() {
     add: _add,
     updateById: _updateById,
     deleteById: _deleteById,
-    getByEducationLevel: _getByEducationLevel
+    getByEducationLevel: _getByEducationLevel,
+    getByGradeLevel: _getByGradeLevel
   } = useGradeLevelRepo();
   async function add(req, res, next) {
     const value = req.body;
@@ -6339,13 +6433,34 @@ function useGradeLevelController() {
       next(error2);
     }
   }
+  async function getByGradeLevel(req, res, next) {
+    const gradeLevel = req.params.gradeLevel;
+    const school = req.params.school;
+    const validation = Joi16.object({
+      gradeLevel: Joi16.string().required(),
+      school: Joi16.string().hex().required()
+    });
+    const { error } = validation.validate({ gradeLevel, school });
+    if (error) {
+      next(new BadRequestError23(error.message));
+      return;
+    }
+    try {
+      const data = await _getByGradeLevel({ gradeLevel, school });
+      res.json(data);
+      return;
+    } catch (error2) {
+      next(error2);
+    }
+  }
   return {
     add,
     getAll,
     getById,
     updateById,
     deleteById,
-    getByEducationLevel
+    getByEducationLevel,
+    getByGradeLevel
   };
 }
 
@@ -38966,6 +39081,9 @@ var schemaGenerateSections = Joi31.object({
   school: Joi31.string().hex().required(),
   schoolYear: Joi31.string().required(),
   gradeLevel: Joi31.string().required(),
+  minStudents: Joi31.number().integer().min(1).required(),
+  maxStudents: Joi31.number().integer().min(Joi31.ref("minStudents")).required(),
+  specialProgram: Joi31.string().hex().optional().allow(null, ""),
   set: Joi31.array().items(Joi31.string().min(1).max(100)).required()
 });
 function modelSection(value) {
@@ -42435,7 +42553,8 @@ function useSectionService() {
         {
           school: value.school,
           schoolYear: value.schoolYear,
-          gradeLevel: value.gradeLevel
+          gradeLevel: value.gradeLevel,
+          specialProgram: value.specialProgram
         },
         session
       );
@@ -42452,8 +42571,8 @@ function useSectionService() {
       if (!gradeLevelData) {
         throw new BadRequestError64("Grade level not found.");
       }
-      const minPerSection = gradeLevelData.minNumberOfLearners;
-      const maxPerSection = gradeLevelData.maxNumberOfLearners;
+      const minPerSection = value.minStudents ?? gradeLevelData.minNumberOfLearners;
+      const maxPerSection = value.maxStudents ?? gradeLevelData.maxNumberOfLearners;
       const sectionsNeeded = Math.ceil(studentCount / minPerSection);
       if (sectionsNeeded > value.set.length) {
         throw new BadRequestError64(
@@ -42599,7 +42718,64 @@ function useSectionService() {
       await session?.endSession();
     }
   }
-  return { generateSections };
+  async function generateSectionPreview(value) {
+    const { error } = schemaGenerateSections.validate(value);
+    if (error) {
+      throw new BadRequestError64(
+        `Invalid section generation data: ${error.message}`
+      );
+    }
+    try {
+      const studentCount = await getCountByGradeLevel({
+        school: value.school,
+        schoolYear: value.schoolYear,
+        gradeLevel: value.gradeLevel,
+        specialProgram: value.specialProgram
+      });
+      if (studentCount === 0) {
+        throw new BadRequestError64("No learners found for this grade level.");
+      }
+      const gradeLevelData = await getByGradeLevel({
+        school: value.school,
+        gradeLevel: value.gradeLevel
+      });
+      if (!gradeLevelData) {
+        throw new BadRequestError64("Grade level not found.");
+      }
+      const minPerSection = value.minStudents ?? gradeLevelData.minNumberOfLearners;
+      const maxPerSection = value.maxStudents ?? gradeLevelData.maxNumberOfLearners;
+      const sectionsNeeded = Math.ceil(studentCount / minPerSection);
+      if (sectionsNeeded > value.set.length) {
+        throw new BadRequestError64(
+          "Insufficient number of section names in set[]."
+        );
+      }
+      const sectionSizes = distributeStudents(
+        studentCount,
+        minPerSection,
+        maxPerSection
+      );
+      if (sectionSizes.length === 0) {
+        throw new BadRequestError64("Unable to compute section sizes.");
+      }
+      const sections = sectionSizes.map((size, index) => ({
+        name: value.set[index],
+        value: size
+      }));
+      return {
+        totalSectionsGenerated: sectionSizes.length,
+        totalStudentsAssigned: studentCount,
+        sections
+      };
+    } catch (error2) {
+      if (error2 instanceof AppError25) {
+        throw error2;
+      } else {
+        throw new InternalServerError21("Failed to generate section preview.");
+      }
+    }
+  }
+  return { generateSections, generateSectionPreview };
 }
 
 // src/resources/section/section.controller.ts
@@ -42615,7 +42791,10 @@ function useSectionController() {
     removeStudentFromSection: _removeStudentFromSection,
     deleteById: _deleteById
   } = useSectionRepo();
-  const { generateSections: _generateSections } = useSectionService();
+  const {
+    generateSections: _generateSections,
+    generateSectionPreview: _generateSectionPreview
+  } = useSectionService();
   async function add(req, res, next) {
     const value = req.body;
     const { error } = schemaSection.validate(value);
@@ -42652,6 +42831,21 @@ function useSectionController() {
       next(error2);
     }
   }
+  async function generateSectionPreview(req, res, next) {
+    const value = req.body;
+    const { error } = schemaGenerateSections.validate(value);
+    if (error) {
+      next(new BadRequestError65(error.message));
+      return;
+    }
+    try {
+      const data = await _generateSectionPreview(value);
+      res.json(data);
+      return;
+    } catch (error2) {
+      next(error2);
+    }
+  }
   async function getAll(req, res, next) {
     const query = req.query;
     const validation = Joi43.object({
@@ -42843,6 +43037,7 @@ function useSectionController() {
   return {
     add,
     generateSections,
+    generateSectionPreview,
     getAll,
     getById,
     getByName,