@7365admin1/core 2.53.0 → 2.55.0

package/dist/index.mjs

@@ -4114,12 +4114,13 @@ function useOrgRepo() {
     status = "active",
     nature = ""
   }) {
-    page = page > 0 ? page - 1 : 0;
     const query = { status };
     sort = Object.keys(sort).length > 0 ? sort : { _id: -1 };
     const cacheOptions = {
       status,
-      sort
+      sort,
+      page,
+      limit
     };
     if (search) {
       query.$text = { $search: search };
@@ -4135,11 +4136,12 @@ function useOrgRepo() {
       logger10.info(`Cache hit for key: ${cacheKey}`);
       return cachedData;
     }
+    const normalizedPage = page > 0 ? page - 1 : 0;
     try {
       const items = await collection.aggregate([
         { $match: query },
         { $sort: sort },
-        { $skip: page * limit },
+        { $skip: normalizedPage * limit },
         { $limit: limit },
         {
           $project: {
@@ -4153,7 +4155,7 @@ function useOrgRepo() {
         }
       ]).toArray();
       const length = await collection.countDocuments(query);
-      const data = paginate7(items, page, limit, length);
+      const data = paginate7(items, normalizedPage, limit, length);
       setCache(cacheKey, data, 15 * 60).then(() => {
         logger10.info(`Cache set for key: ${cacheKey}`);
       }).catch((err) => {
@@ -5310,11 +5312,16 @@ function useVerificationService() {
     const existing = await useVerificationRepo().findOne({
       type,
       email,
-      "metadata.org": metadata?.org,
-      "metadata.siteId": metadata?.siteId
+      "metadata.app": metadata.app
     });
-    if (existing)
+    if (existing) {
+      if (existing.status === "complete") {
+        throw new BadRequestError20(
+          `User already completed invite for app: ${metadata.app}`
+        );
+      }
       return existing._id;
+    }
     const value = {
       type,
       email,
@@ -7571,6 +7578,7 @@ function useVerificationController() {
     createServiceProviderInvite: _createServiceProviderInvite,
     createForgetPassword: _createForgetPassword,
     verify: _verify,
+    updateStatusById: _updateStatusById,
     cancelUserInvitation: _cancelUserInvitation
   } = useVerificationService();
   const { getVerifications: _getVerifications } = useVerificationRepo();
@@ -7784,6 +7792,28 @@ function useVerificationController() {
       return;
     }
   }
+  async function updateVerificationStatus(req, res, next) {
+    const validation = Joi16.object({
+      id: Joi16.string().hex().required(),
+      status: Joi16.string().valid("pending", "complete", "expired", "cancelled").required()
+    });
+    const { error } = validation.validate(req.body);
+    if (error) {
+      logger22.log({ level: "error", message: error.message });
+      next(new BadRequestError31(error.message));
+      return;
+    }
+    try {
+      const { id, status } = req.body;
+      const result = await _updateStatusById(id, status);
+      res.json({ message: result });
+      return;
+    } catch (error2) {
+      logger22.log({ level: "error", message: error2.message });
+      next(error2);
+      return;
+    }
+  }
   async function cancelUserInvitation(req, res, next) {
     const validation = Joi16.string().hex().required();
     const otpId = req.params.id;
@@ -7811,6 +7841,7 @@ function useVerificationController() {
     createServiceProviderInvite,
     createForgetPassword,
     verify,
+    updateVerificationStatus,
     cancelUserInvitation,
     createSimpleUserInvite
   };
@@ -13708,9 +13739,26 @@ function useVisitorTransactionRepo() {
       ...status && { status },
       ...tab == "Overnight Parking" && { isOvernightParking: true }
     };
-    sort = Object.keys(sort).length > 0 ? sort : { _id: -1 };
+    sort = Object.keys(sort).length > 0 ? sort : { latestDate: -1 };
     try {
-      const basePipeline = [{ $match: query }];
+      const basePipeline = [
+        { $match: query },
+        {
+          $addFields: {
+            latestDate: {
+              $max: ["$createdAt", "$updatedAt"]
+            }
+          }
+        },
+        { $sort: { latestDate: -1 } },
+        { $skip: skip },
+        { $limit: limit },
+        {
+          $project: {
+            latestDate: 0
+          }
+        }
+      ];
       const [items, countResult] = await Promise.all([
         collection.aggregate([
           ...basePipeline,
@@ -13850,9 +13898,6 @@ function useVisitorTransactionRepo() {
               as: "passKeys"
             }
           },
-          { $sort: sort },
-          { $skip: skip },
-          { $limit: limit },
           {
             $lookup: {
               from: "users",
@@ -15863,14 +15908,16 @@ function MBuildingUnit(value) {
 
 // src/repositories/building-unit.repository.ts
 import { ObjectId as ObjectId45 } from "mongodb";
+var building_units_namespace_collection = "building-units";
 function useBuildingUnitRepo() {
   const db = useAtlas33.getDb();
   if (!db) {
     throw new Error("Unable to connect to server.");
   }
-  const namespace_collection = "building-units";
-  const collection = db.collection(namespace_collection);
-  const { getCache, setCache, delNamespace, delCache } = useCache25(namespace_collection);
+  const collection = db.collection(building_units_namespace_collection);
+  const { getCache, setCache, delNamespace, delCache } = useCache25(
+    building_units_namespace_collection
+  );
   async function createIndexes() {
     try {
       await collection.createIndexes([
@@ -15896,12 +15943,12 @@ function useBuildingUnitRepo() {
     delNamespace().then(() => {
       logger52.log({
         level: "info",
-        message: `Cache namespace cleared for ${namespace_collection}`
+        message: `Cache namespace cleared for ${building_units_namespace_collection}`
       });
     }).catch((err) => {
       logger52.log({
         level: "error",
-        message: `Failed to clear cache namespace for ${namespace_collection}: ${err.message}`
+        message: `Failed to clear cache namespace for ${building_units_namespace_collection}: ${err.message}`
       });
     });
   }
@@ -16048,7 +16095,10 @@ function useBuildingUnitRepo() {
       ...building && { building },
       ...status && { status }
     };
-    const cacheKey = makeCacheKey24(namespace_collection, cacheParams);
+    const cacheKey = makeCacheKey24(
+      building_units_namespace_collection,
+      cacheParams
+    );
     logger52.log({
       level: "info",
       message: `Cache key for getAll building units: ${cacheKey}`
@@ -16119,7 +16169,9 @@ function useBuildingUnitRepo() {
     } catch (error) {
       throw new BadRequestError71("Invalid ID.");
     }
-    const cacheKey = makeCacheKey24(namespace_collection, { _id: String(_id) });
+    const cacheKey = makeCacheKey24(building_units_namespace_collection, {
+      _id: String(_id)
+    });
     try {
       const cached = await getCache(cacheKey);
       if (cached) {
@@ -16162,7 +16214,7 @@ function useBuildingUnitRepo() {
     } catch (error) {
       throw new BadRequestError71("Invalid building ID.");
     }
-    const cacheKey = makeCacheKey24(namespace_collection, {
+    const cacheKey = makeCacheKey24(building_units_namespace_collection, {
       building: String(building),
       level
     });
@@ -16236,7 +16288,7 @@ function useBuildingUnitRepo() {
     } catch (error) {
       throw new BadRequestError71("Invalid building ID.");
     }
-    const cacheKey = makeCacheKey24(namespace_collection, {
+    const cacheKey = makeCacheKey24(building_units_namespace_collection, {
       building: String(building)
     });
     try {
@@ -16310,7 +16362,10 @@ function useBuildingUnitRepo() {
       block,
       level
     };
-    const cacheKey = makeCacheKey24(namespace_collection, cacheOptions);
+    const cacheKey = makeCacheKey24(
+      building_units_namespace_collection,
+      cacheOptions
+    );
     const cachedData = await getCache(cacheKey);
     if (cachedData) {
       logger52.info(`Cache hit for key: ${cacheKey}`);
@@ -16348,7 +16403,10 @@ function useBuildingUnitRepo() {
     const cacheOptions = {
       site: site.toString()
     };
-    const cacheKey = makeCacheKey24(namespace_collection, cacheOptions);
+    const cacheKey = makeCacheKey24(
+      building_units_namespace_collection,
+      cacheOptions
+    );
     const cachedData = await getCache(cacheKey);
     if (cachedData) {
       logger52.info(`Cache hit for key: ${cacheKey}`);
@@ -16396,7 +16454,10 @@ function useBuildingUnitRepo() {
         { deletedAt: "" }
       ]
     };
-    const cacheKey = makeCacheKey24(namespace_collection, cacheOptions);
+    const cacheKey = makeCacheKey24(
+      building_units_namespace_collection,
+      cacheOptions
+    );
     try {
       const cached = await getCache(cacheKey);
       if (cached) {
@@ -16432,6 +16493,54 @@ function useBuildingUnitRepo() {
       }
     }
   }
+  async function getBySiteBuildingLevel(site, block, level) {
+    try {
+      site = new ObjectId45(site);
+    } catch (error) {
+      throw new BadRequestError71("Invalid site ID.");
+    }
+    const cacheKey = makeCacheKey24(building_units_namespace_collection, {
+      site: site.toString(),
+      block,
+      level
+    });
+    try {
+      const cached = await getCache(cacheKey);
+      if (cached) {
+        logger52.log({
+          level: "info",
+          message: `Cache hit for getById building unit: ${cacheKey}`
+        });
+        return cached;
+      }
+      const query = {
+        site,
+        block,
+        level,
+        status: "active"
+      };
+      console.log(query);
+      const result = await collection.findOne(query);
+      setCache(cacheKey, result, 300).then(() => {
+        logger52.log({
+          level: "info",
+          message: `Cache set for building unit by id: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger52.log({
+          level: "error",
+          message: `Failed to set cache for building unit by id: ${err.message}`
+        });
+      });
+      return result;
+    } catch (error) {
+      if (error instanceof AppError10) {
+        throw error;
+      } else {
+        throw new InternalServerError27("Failed to get building unit.");
+      }
+    }
+  }
   return {
     createIndexes,
     add,
@@ -16445,7 +16554,8 @@ function useBuildingUnitRepo() {
     updateByBuildingId,
     getBuildingUnits,
     getBuildingUnitsWithOwner,
-    getUnitByBlockLevelUnitNumber
+    getUnitByBlockLevelUnitNumber,
+    getBySiteBuildingLevel
   };
 }
 
@@ -19121,6 +19231,7 @@ function useBuildingRepo() {
       throw new Error("Failed to create index on buildings. " + error.message);
     }
   }
+  const { getBySiteBuildingLevel: _getBySiteBuildingLevel } = useBuildingUnitRepo();
   async function add(value, session) {
     try {
       value = MBuilding(value);
@@ -19356,6 +19467,94 @@ function useBuildingRepo() {
       }
     }
   }
+  async function getBuildingLevelWithUnits(site, block) {
+    try {
+      site = new ObjectId49(site);
+    } catch (error) {
+      throw new BadRequestError79("Invalid ID.");
+    }
+    const query = {
+      site,
+      _id: new ObjectId49(block)
+    };
+    const cacheOptions = { ...query };
+    const cacheKey = makeCacheKey26(buildings_namespace_collection, cacheOptions);
+    try {
+      console.log(query);
+      const result = await collection.aggregate([
+        {
+          $match: {
+            ...query
+          }
+        },
+        {
+          $lookup: {
+            from: "building-levels",
+            let: { buildingId: "$_id" },
+            pipeline: [
+              {
+                $match: {
+                  $expr: { $eq: ["$block", "$$buildingId"] }
+                }
+              },
+              {
+                $lookup: {
+                  from: "building-units",
+                  let: { levelId: "$_id" },
+                  pipeline: [
+                    {
+                      $match: {
+                        $expr: {
+                          $and: [
+                            { $eq: ["$site", site] },
+                            { $eq: ["$block", "$$buildingId"] },
+                            { $eq: ["$level", "$$levelId"] },
+                            { $eq: ["$status", "active"] }
+                          ]
+                        }
+                      }
+                    }
+                  ],
+                  as: "buildingUnits"
+                }
+              },
+              // discard levels that have no active units
+              {
+                $match: {
+                  $expr: { $gt: [{ $size: "$buildingUnits" }, 0] }
+                }
+              }
+            ],
+            as: "buildingLevels"
+          }
+        },
+        {
+          $project: {
+            "_id": 1,
+            "site": 1,
+            "name": 1,
+            "block": 1,
+            "status": 1,
+            "buildingFloorPlan": 1,
+            "createdAt": 1,
+            "updatedAt": 1,
+            "deletedAt": 1,
+            "levels": "$buildingLevels"
+          }
+        }
+      ]).toArray();
+      if (!result) {
+        throw new BadRequestError79("Building not found.");
+      }
+      return result;
+    } catch (error) {
+      if (error instanceof AppError13) {
+        throw error;
+      } else {
+        throw new InternalServerError29("Failed to get building.");
+      }
+    }
+  }
   function delCachedData() {
     delNamespace().then(() => {
       logger60.log({
@@ -19376,7 +19575,8 @@ function useBuildingRepo() {
     getById,
     updateById,
     deleteById,
-    getBuildingLevel
+    getBuildingLevel,
+    getBuildingLevelWithUnits
   };
 }
 
@@ -19535,7 +19735,8 @@ function useBuildingController() {
   const {
     getAll: _getAll,
     getById: _getById,
-    getBuildingLevel: _getBuildingLevel
+    getBuildingLevel: _getBuildingLevel,
+    getBuildingLevelWithUnits: _getBuildingLevelWithUnits
   } = useBuildingRepo();
   const {
     updateById: _updateById,
@@ -19804,6 +20005,26 @@ function useBuildingController() {
       next(error);
     }
   }
+  async function getBuildingLevelWithUnits(req, res, next) {
+    const site = req.params.site ?? "";
+    let block = req.query.block;
+    const validation = Joi44.object({
+      site: Joi44.string().hex().required(),
+      block: Joi44.string().required()
+    });
+    const { error } = validation.validate({ site, block });
+    if (error) {
+      next(new BadRequestError81(error.message));
+      return;
+    }
+    try {
+      const siteBlock = await _getBuildingLevelWithUnits(site, block);
+      res.json(siteBlock);
+      return;
+    } catch (error2) {
+      next(error2);
+    }
+  }
   return {
     createBuilding,
     getAll,
@@ -19811,7 +20032,8 @@ function useBuildingController() {
     updateById,
     deleteById,
     getBuildingLevel,
-    uploadSpreadsheetBuilding
+    uploadSpreadsheetBuilding,
+    getBuildingLevelWithUnits
   };
 }
 
@@ -23718,7 +23940,10 @@ function useVisitorTransactionService() {
             nric: value.nric,
             start,
             end,
-            recNo: value.recNo
+            recNo: value.recNo,
+            ...value.block && { block: value.block },
+            ...value.level && { level: value.level },
+            ...value.unit && { unit: new ObjectId59(value.unit) }
           };
           await addVehicle(vehiclePayload);
         } else {
@@ -23850,6 +24075,8 @@ function useVisitorTransactionService() {
       }
       if (value.unit) {
         value.unit = typeof value.unit === "string" ? new ObjectId59(value.unit) : value.unit;
+        const unit = await _getUnitById(value.unit);
+        value.unitName = unit?.name;
       }
       await _updateVisitorTansactionById(id, value, session);
       await session?.commitTransaction();
@@ -32705,21 +32932,23 @@ function useEventManagementController() {
     }
   }
   async function deleteEventManagementById(req, res, next) {
-    const validation = Joi82.string().hex().required();
-    const _id = req.params.id;
-    const { error } = validation.validate(_id);
-    if (error) {
-      logger115.log({ level: "error", message: error.message });
-      next(new BadRequestError137(error.message));
-      return;
-    }
     try {
+      const schema2 = Joi82.object({
+        _id: Joi82.string().hex().length(24).required()
+      });
+      const { error, value } = schema2.validate({ _id: req.params.id });
+      if (error) {
+        logger115.log({ level: "error", message: error.message });
+        next(new BadRequestError137(error.message));
+        return;
+      }
+      const { _id } = value;
       await _deleteEventManagementById(_id);
       res.status(200).json({ message: "Successfully deleted event." });
       return;
-    } catch (error2) {
-      logger115.log({ level: "error", message: error2.message });
-      next(error2);
+    } catch (error) {
+      logger115.log({ level: "error", message: error.message });
+      next(error);
       return;
     }
   }
@@ -36307,7 +36536,111 @@ function UseAccessManagementRepo() {
       const items = result[0].items;
       return paginate39(items, page, limit, length);
     } catch (error) {
-      return Promise.reject("Server internal error.");
+      throw new Error(error.message);
+    }
+  }
+  async function assignMultipleCardsRepo({
+    assignees,
+    unit,
+    type,
+    acm_url
+  }) {
+    const session = useAtlas76.getClient()?.startSession();
+    try {
+      session?.startTransaction();
+      if (assignees.length < 1) {
+        throw new Error("No user to Assign.");
+      }
+      assignees = assignees.map((data) => new ObjectId90(data));
+      unit = new ObjectId90(unit);
+      let availableCards = [];
+      let update = [];
+      let cards = [];
+      availableCards = await collection().aggregate([
+        {
+          $match: {
+            $expr: {
+              $and: [
+                { $eq: ["$assignedUnit", unit] },
+                { $eq: ["$userId", null] },
+                { $eq: ["$type", type] },
+                { $eq: ["$isActivated", true] }
+              ]
+            }
+          }
+        }
+      ]).toArray();
+      if (assignees.length > availableCards.length) {
+        throw new Error(`Not enough ${type} cards available.`);
+      }
+      cards = availableCards?.slice(0, assignees.length).map((card, index) => {
+        const userId = new ObjectId90(assignees[index].toString());
+        card.staffNo = userId.toString().slice(-10);
+        return card;
+      });
+      update = availableCards.slice(0, assignees.length).map((card, index) => ({ _id: card._id, userId: new ObjectId90(assignees[index]) }));
+      const commands = cards.map((item, index) => {
+        let ag = null;
+        if (item.accessGroup !== void 0) {
+          if (item.accessGroup?.length > 0) {
+            ag = item.accessGroup.map((g) => `<GROUP_NAME>${g}</GROUP_NAME>`).join("\n  ");
+          }
+        }
+        const command = {
+          commandId1: index * 2 + 1,
+          commandId2: index * 2 + 2,
+          staffName: `STAFF-${item._id.toString().slice(-10)}`,
+          staffNo1: `STAFF-${item._id.toString().slice(-10)}`,
+          staffNo2: `STAFF-${item._id.toString().slice(-10)}`,
+          dateOfJoin: formatEntryPassDate(item.startDate),
+          accessLevel: item.accessLevel ?? "0",
+          cardNo: item.cardNo,
+          pin: typeof item.pin === "string" && item.pin.trim() !== "" ? item.pin : "123456",
+          startDate: formatEntryPassDate(item.startDate),
+          endDate: formatEntryPassDate(item.endDate),
+          cardType: 0,
+          isActivated: item.isActivated ? 1 : 0,
+          isAntiPassBack: item.isAntiPassBack ? 1 : 0,
+          isLiftCard: item.isLiftCard ? 1 : 0,
+          isLiftActivate: item.isLiftCard ? 1 : 0,
+          liftAccessLevel: item.liftAccessLevel || 1,
+          liftAccessStartDate: formatEntryPassDate(item.liftAccessStartDate) || "19770510",
+          liftAccessEndDate: formatEntryPassDate(item.liftAccessEndDate) || "19770510",
+          accessGroup: ag
+        };
+        return readTemplate(`${item.accessLevel !== null ? "add-card" : "add-card-lift"}`, { ...command });
+      }).flat();
+      const response = await sendCommand(commands.join("").toString(), acm_url);
+      const result = await parseStringPromise2(response, { explicitArray: false });
+      console.log("status code", result.RESULT.$.STCODE);
+      if (result && result.RESULT.$.STCODE !== "0") {
+        throw new Error("Command failed, server error.");
+      }
+      for (const { _id, userId } of update) {
+        await collection().updateOne({ _id }, { $set: { userId, staffNo: `STAFF-${userId.toString().slice(-10)}` } }, { session });
+      }
+      await session?.commitTransaction();
+      return "Cards assigned successfully.";
+    } catch (error) {
+      await session?.abortTransaction();
+      throw new Error(error.message);
+    } finally {
+      await session?.endSession();
+    }
+  }
+  async function visitorCheckoutRepo({ userId }) {
+    const session = useAtlas76.getClient()?.startSession();
+    try {
+      session?.startTransaction();
+      const id = new ObjectId90(userId);
+      await collection().updateMany({ userId: id }, { $set: { userId: null, status: "Available" } }, { session });
+      session?.commitTransaction();
+      return "Successful Checkout";
+    } catch (error) {
+      await session?.abortTransaction();
+      throw new Error(error.message);
+    } finally {
+      await session?.endSession();
     }
   }
   return {
@@ -36342,7 +36675,9 @@ function UseAccessManagementRepo() {
     checkoutVisitorRepo,
     getBlockLevelAndUnitListRepo,
     indexCombination,
-    getTransactionsRepo
+    getTransactionsRepo,
+    assignMultipleCardsRepo,
+    visitorCheckoutRepo
   };
 }
 
@@ -36383,7 +36718,9 @@ function useAccessManagementSvc() {
     signQrCodeRepo,
     checkoutVisitorRepo,
     getBlockLevelAndUnitListRepo,
-    getTransactionsRepo
+    getTransactionsRepo,
+    assignMultipleCardsRepo,
+    visitorCheckoutRepo
   } = UseAccessManagementRepo();
   const addPhysicalCardSvc = async (payload) => {
     try {
@@ -36679,6 +37016,22 @@ function useAccessManagementSvc() {
     try {
       const response = await getTransactionsRepo({ page, limit, site, cardNo, url });
       return response;
+    } catch (err) {
+      throw new Error(err.message);
+    }
+  };
+  const assignMultipleCardsSvc = async ({ assignees, unit, type, acm_url }) => {
+    try {
+      const response = await assignMultipleCardsRepo({ assignees, unit, type, acm_url });
+      return response;
+    } catch (err) {
+      throw new Error(err.message);
+    }
+  };
+  const visitorCheckoutSvc = async ({ userId }) => {
+    try {
+      const response = await visitorCheckoutRepo({ userId });
+      return response;
     } catch (err) {
       return Promise.reject("Server internal error.");
     }
@@ -36718,7 +37071,9 @@ function useAccessManagementSvc() {
     signQrCodeSvc,
     checkoutVisitorSvc,
     getBlockLevelAndUnitListSvc,
-    getTransactionsSvc
+    getTransactionsSvc,
+    assignMultipleCardsSvc,
+    visitorCheckoutSvc
   };
 }
 
@@ -36759,7 +37114,9 @@ function useAccessManagementController() {
     signQrCodeSvc,
     checkoutVisitorSvc,
     getBlockLevelAndUnitListSvc,
-    getTransactionsSvc
+    getTransactionsSvc,
+    assignMultipleCardsSvc,
+    visitorCheckoutSvc
   } = useAccessManagementSvc();
   const addPhysicalCard = async (req, res) => {
     try {
@@ -37543,6 +37900,39 @@ function useAccessManagementController() {
       });
       return res.json(result);
     } catch (error2) {
+      return res.status(400).json({
+        data: null,
+        message: error2.message
+      });
+    }
+  };
+  const assignMultipleCards = async (req, res) => {
+    try {
+      const { assignees, unit, type, acm_url } = req.body;
+      const schema2 = Joi85.object({
+        assignees: Joi85.array().items(Joi85.string().hex()).required(),
+        type: Joi85.string().required(),
+        unit: Joi85.string().hex().required()
+      });
+      const { error } = schema2.validate({ assignees, type, unit });
+      if (error) {
+        throw new Error(`${error.message}`);
+      }
+      const result = await assignMultipleCardsSvc({ assignees, unit, type, acm_url });
+      return res.status(200).json({ message: "Success", data: result });
+    } catch (error) {
+      return res.status(400).json({
+        data: null,
+        message: error.message
+      });
+    }
+  };
+  const visitorCheckout = async (req, res) => {
+    try {
+      const userId = req.params.userId;
+      const result = await visitorCheckoutSvc({ userId });
+      return res.status(200).json({ message: "Success", data: result });
+    } catch (error) {
       return Promise.reject("Internal Server Error");
     }
   };
@@ -37579,7 +37969,9 @@ function useAccessManagementController() {
     checkoutVisitor,
     removeAccessCard,
     getBlockLevelAndUnitList,
-    getTransactions: getTransactions2
+    getTransactions: getTransactions2,
+    assignMultipleCards,
+    visitorCheckout
   };
 }
 
@@ -51850,6 +52242,7 @@ export {
   allowedNatures,
   attendanceSchema,
   attendanceSettingsSchema,
+  building_units_namespace_collection,
   buildings_namespace_collection,
   bulletin_boards_namespace_collection,
   calculatePercentage,