@eeplatform/basic-edu 1.8.7 → 1.8.8

package/dist/index.mjs

@@ -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) {
@@ -6252,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;
@@ -6423,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
   };
 }
 
@@ -39050,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) {
@@ -42519,7 +42553,8 @@ function useSectionService() {
         {
           school: value.school,
           schoolYear: value.schoolYear,
-          gradeLevel: value.gradeLevel
+          gradeLevel: value.gradeLevel,
+          specialProgram: value.specialProgram
         },
         session
       );
@@ -42536,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(
@@ -42683,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
@@ -42699,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);
@@ -42736,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({
@@ -42927,6 +43037,7 @@ function useSectionController() {
   return {
     add,
     generateSections,
+    generateSectionPreview,
     getAll,
     getById,
     getByName,