@7365admin1/module-hygiene 4.28.1 → 4.28.2-staging.11

package/.changeset/hygiene-checkout-approval.md

@@ -0,0 +1,5 @@
+---
+"@7365admin1/module-hygiene": minor
+---
+
+Add approve / disapprove to hygiene check out items (repository, controller and decision util).

package/.changeset/hygiene-checkout-stock-return.md

@@ -0,0 +1,5 @@
+---
+"@7365admin1/module-hygiene": minor
+---
+
+Disapproving a hygiene check out item returns the drawn-down quantity to stock, in the same transaction as the decision.

package/dist/index.d.ts

@@ -512,6 +512,51 @@ declare function useStockController(): {
     getStocksBySupplyId: (req: Request, res: Response, next: NextFunction) => Promise<void>;
 };
 
+/**
+ * The approval decision on a hygiene check out item, as data.
+ *
+ * Kept out of the repository so it can be tested without a database, the same
+ * way `hygiene-dashboard-metrics.util.ts` is. The repository wraps the ids in
+ * `ObjectId` and hands the rest of this straight to `$set`.
+ *
+ * Shape follows `hygiene-area-checklist`: an approve/reject pair plus a
+ * terminal `status: "completed"`, so the `allowedCheckOutItemStatus`
+ * vocabulary (`pending` | `completed`) gains no new value. Rows written before
+ * this feature carry no `approve`/`reject` at all, which reads as "not
+ * decided" — nothing is backfilled.
+ */
+declare const CHECKOUT_DECISIONS: readonly ["approve", "disapprove"];
+type TCheckOutDecision = (typeof CHECKOUT_DECISIONS)[number];
+declare function isCheckOutDecision(value: string): value is TCheckOutDecision;
+/**
+ * Only a `pending` row may be decided. Returning the status the update must
+ * match — rather than matching on `_id` alone — is what makes a second
+ * approval a refusal instead of a silent overwrite of the first one.
+ */
+declare const CHECKOUT_DECIDABLE_STATUS = "pending";
+declare function buildCheckOutDecision(decision: TCheckOutDecision, remarks?: string | null, now?: string): {
+    approve: boolean;
+    reject: boolean;
+    status: string;
+    remarks: string;
+    updatedAt: string;
+};
+/**
+ * Sequence a decision: the guarded update first, the stock return only if that
+ * update actually decided the row.
+ *
+ * Idempotency comes from the update's `{ _id, status: "pending" }` match, not
+ * from anything here. `decide` reports how many rows it changed (and the
+ * repository throws on a match of none), so a row someone already decided
+ * moves no stock. That is what stops a second disapprove crediting stock
+ * twice, and stops an approve after a disapprove deducting it again — the
+ * approve is refused outright, so it never reaches a stock call at all.
+ *
+ * Kept here rather than in the service so the ordering can be tested with
+ * fakes, the same way the rest of this file is tested without a database.
+ */
+declare function applyCheckOutDecision(decision: TCheckOutDecision, decide: () => Promise<number>, returnStock: () => Promise<unknown>): Promise<number>;
+
 declare const allowedCheckOutItemStatus: string[];
 type TCheckOutItem = {
     _id?: ObjectId;
@@ -525,6 +570,10 @@ type TCheckOutItem = {
     createdBy: string | ObjectId;
     createdByName: string;
     status?: (typeof allowedCheckOutItemStatus)[number];
+    approve?: boolean;
+    reject?: boolean;
+    remarks?: string;
+    completedBy?: string | ObjectId;
     createdAt?: string;
     updatedAt?: string;
     deletedAt?: string;
@@ -534,12 +583,13 @@ type TCheckOutItemCreateService = Pick<TCheckOutItem, "site" | "serviceType" | "
 type TCheckOutItemCreateByBatchService = Pick<TCheckOutItem, "site" | "serviceType" | "createdBy"> & {
     items: Pick<TCheckOutItem, "supply" | "qty" | "attachment">[];
 };
+type TCheckOutItemDecision = Pick<TCheckOutItem, "approve" | "reject" | "remarks" | "completedBy">;
 type TCheckOutItemGetQuery = {
     page?: number;
     limit?: number;
     search?: string;
 } & Pick<TCheckOutItem, "site" | "serviceType">;
-type TCheckOutItemGetById = Pick<TCheckOutItem, "_id" | "site" | "serviceType" | "supply" | "supplyName" | "supplyQty" | "qty" | "status"> & {
+type TCheckOutItemGetById = Pick<TCheckOutItem, "_id" | "site" | "serviceType" | "supply" | "supplyName" | "supplyQty" | "qty" | "status" | "approve" | "reject" | "remarks"> & {
     unitOfMeasurement?: string;
 };
 declare const checkOutItemSchema: Joi.ObjectSchema<any>;
@@ -554,6 +604,10 @@ declare function MCheckOutItem(value: TCheckOutItemCreate): {
     createdBy: string | ObjectId;
     createdByName: string;
     status: string;
+    approve: boolean;
+    reject: boolean;
+    remarks: string;
+    completedBy: string;
     createdAt: string;
     updatedAt: string;
     deletedAt: string;
@@ -566,11 +620,13 @@ declare function useCheckOutItemRepository(): {
     getCheckOutItems: ({ page, limit, search, site, serviceType, }: TCheckOutItemGetQuery) => Promise<{}>;
     getCheckOutItemById: (_id: string | ObjectId, session?: ClientSession) => Promise<TCheckOutItemGetById>;
     completeCheckOutItem: (_id: string | ObjectId, session?: ClientSession) => Promise<number>;
+    decideCheckOutItem: (_id: string | ObjectId, value: TCheckOutItemDecision, session?: ClientSession) => Promise<number>;
 };
 
 declare function useCheckOutItemService(): {
     createCheckOutItem: (value: TCheckOutItemCreateService) => Promise<bson.ObjectId>;
     createCheckOutItemByBatch: (value: TCheckOutItemCreateByBatchService) => Promise<bson.ObjectId[]>;
+    decideCheckOutItem: (_id: string, value: TCheckOutItemDecision) => Promise<number>;
 };
 
 declare function useCheckOutItemController(): {
@@ -578,6 +634,7 @@ declare function useCheckOutItemController(): {
     createCheckOutItemByBatch: (req: Request, res: Response, next: NextFunction) => Promise<void>;
     getCheckOutItems: (req: Request, res: Response, next: NextFunction) => Promise<void>;
     getCheckOutItemById: (req: Request, res: Response, next: NextFunction) => Promise<void>;
+    decideCheckOutItem: (req: Request, res: Response, next: NextFunction) => Promise<void>;
 };
 
 type TScheduleTask = {
@@ -664,4 +721,4 @@ declare function useQRController(): {
     generateQR: (req: Request, res: Response, next: NextFunction) => Promise<void>;
 };
 
-export { MArea, MAreaChecklist, MCheckOutItem, MParentChecklist, MScheduleTask, MStock, MSupply, MUnit, TArea, TAreaChecklist, TAreaChecklistBatchCreate, TAreaChecklistCreate, TAreaChecklistUnits, TAreaChecklistUnitsUpdate, TAreaChecklistUpdate, TAreaCreate, TAreaGetQuery, TAreaUnits, TAreaUpdate, TAreaUpdateChecklist, TCheckOutItem, TCheckOutItemCreate, TCheckOutItemCreateByBatchService, TCheckOutItemCreateService, TCheckOutItemGetById, TCheckOutItemGetQuery, TCleaningScheduleArea, TCleaningScheduleAreaGetQuery, TGetStocksQuery, TParentChecklist, TParentChecklistCreate, TParentChecklistGetQuery, TScheduleTask, TScheduleTaskCreate, TScheduleTaskGetById, TScheduleTaskGetQuery, TScheduleTaskUpdate, TStock, TStockCreate, TStockCreateService, TSupply, TSupplyCreate, TSupplyGetById, TSupplyGetQuery, TSupplyUpdate, TUnit, TUnitCreate, TUnitGetQuery, TUnitUpdate, allowedCheckOutItemStatus, allowedChecklistStatus, allowedPeriods, allowedStatus, allowedTypes, areaChecklistSchema, areaSchema, checkOutItemSchema, parentChecklistSchema, scheduleTaskSchema, stockSchema, supplySchema, unitSchema, useAreaChecklistController, useAreaChecklistRepo, useAreaChecklistService, useAreaController, useAreaExportService, useAreaRepo, useAreaService, useCheckOutItemController, useCheckOutItemRepository, useCheckOutItemService, useHygieneDashboardController, useHygieneDashboardRepository, useParentChecklistController, useParentChecklistRepo, useQRController, useQRService, useScheduleTaskController, useScheduleTaskRepository, useScheduleTaskService, useStockController, useStockRepository, useStockService, useSupplyController, useSupplyRepository, useUnitController, useUnitExportService, useUnitRepository, useUnitService };
+export { CHECKOUT_DECIDABLE_STATUS, CHECKOUT_DECISIONS, MArea, MAreaChecklist, MCheckOutItem, MParentChecklist, MScheduleTask, MStock, MSupply, MUnit, TArea, TAreaChecklist, TAreaChecklistBatchCreate, TAreaChecklistCreate, TAreaChecklistUnits, TAreaChecklistUnitsUpdate, TAreaChecklistUpdate, TAreaCreate, TAreaGetQuery, TAreaUnits, TAreaUpdate, TAreaUpdateChecklist, TCheckOutDecision, TCheckOutItem, TCheckOutItemCreate, TCheckOutItemCreateByBatchService, TCheckOutItemCreateService, TCheckOutItemDecision, TCheckOutItemGetById, TCheckOutItemGetQuery, TCleaningScheduleArea, TCleaningScheduleAreaGetQuery, TGetStocksQuery, TParentChecklist, TParentChecklistCreate, TParentChecklistGetQuery, TScheduleTask, TScheduleTaskCreate, TScheduleTaskGetById, TScheduleTaskGetQuery, TScheduleTaskUpdate, TStock, TStockCreate, TStockCreateService, TSupply, TSupplyCreate, TSupplyGetById, TSupplyGetQuery, TSupplyUpdate, TUnit, TUnitCreate, TUnitGetQuery, TUnitUpdate, allowedCheckOutItemStatus, allowedChecklistStatus, allowedPeriods, allowedStatus, allowedTypes, applyCheckOutDecision, areaChecklistSchema, areaSchema, buildCheckOutDecision, checkOutItemSchema, isCheckOutDecision, parentChecklistSchema, scheduleTaskSchema, stockSchema, supplySchema, unitSchema, useAreaChecklistController, useAreaChecklistRepo, useAreaChecklistService, useAreaController, useAreaExportService, useAreaRepo, useAreaService, useCheckOutItemController, useCheckOutItemRepository, useCheckOutItemService, useHygieneDashboardController, useHygieneDashboardRepository, useParentChecklistController, useParentChecklistRepo, useQRController, useQRService, useScheduleTaskController, useScheduleTaskRepository, useScheduleTaskService, useStockController, useStockRepository, useStockService, useSupplyController, useSupplyRepository, useUnitController, useUnitExportService, useUnitRepository, useUnitService };

package/dist/index.js

@@ -30,6 +30,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  CHECKOUT_DECIDABLE_STATUS: () => CHECKOUT_DECIDABLE_STATUS,
+  CHECKOUT_DECISIONS: () => CHECKOUT_DECISIONS,
   MArea: () => MArea,
   MAreaChecklist: () => MAreaChecklist,
   MCheckOutItem: () => MCheckOutItem,
@@ -43,9 +45,12 @@ __export(src_exports, {
   allowedPeriods: () => allowedPeriods,
   allowedStatus: () => allowedStatus,
   allowedTypes: () => allowedTypes,
+  applyCheckOutDecision: () => applyCheckOutDecision,
   areaChecklistSchema: () => areaChecklistSchema,
   areaSchema: () => areaSchema,
+  buildCheckOutDecision: () => buildCheckOutDecision,
   checkOutItemSchema: () => checkOutItemSchema,
+  isCheckOutDecision: () => isCheckOutDecision,
   parentChecklistSchema: () => parentChecklistSchema,
   scheduleTaskSchema: () => scheduleTaskSchema,
   stockSchema: () => stockSchema,
@@ -5876,6 +5881,30 @@ function useStockController() {
   };
 }
 
+// src/utils/hygiene-checkout-decision.util.ts
+var CHECKOUT_DECISIONS = ["approve", "disapprove"];
+function isCheckOutDecision(value) {
+  return CHECKOUT_DECISIONS.includes(value);
+}
+var CHECKOUT_DECIDABLE_STATUS = "pending";
+function buildCheckOutDecision(decision, remarks, now = (/* @__PURE__ */ new Date()).toISOString()) {
+  const approve = decision === "approve";
+  return {
+    approve,
+    reject: !approve,
+    status: "completed",
+    remarks: remarks ?? "",
+    updatedAt: now
+  };
+}
+async function applyCheckOutDecision(decision, decide, returnStock) {
+  const decided = await decide();
+  if (decided > 0 && decision === "disapprove") {
+    await returnStock();
+  }
+  return decided;
+}
+
 // src/models/hygiene-checkout-item.model.ts
 var import_joi14 = __toESM(require("joi"));
 var import_mongodb16 = require("mongodb");
@@ -5924,6 +5953,10 @@ function MCheckOutItem(value) {
     createdBy: value.createdBy,
     createdByName: value.createdByName,
     status: "pending",
+    approve: false,
+    reject: false,
+    remarks: "",
+    completedBy: "",
     createdAt: (/* @__PURE__ */ new Date()).toISOString(),
     updatedAt: "",
     deletedAt: ""
@@ -6054,7 +6087,10 @@ function useCheckOutItemRepository() {
             profile: "$createdByDoc.profile",
             checkOutQty: "$qty",
             createdAt: 1,
-            status: 1
+            status: 1,
+            approve: 1,
+            reject: 1,
+            remarks: 1
           }
         },
         { $sort: { _id: -1 } },
@@ -6120,7 +6156,10 @@ function useCheckOutItemRepository() {
               status: 1,
               unitOfMeasurement: "$supplyDetails.unitOfMeasurement",
               stockQty: "$supplyQty",
-              attachment: 1
+              attachment: 1,
+              approve: 1,
+              reject: 1,
+              remarks: 1
             }
           }
         ],
@@ -6171,13 +6210,55 @@ function useCheckOutItemRepository() {
       throw error;
     }
   }
+  async function decideCheckOutItem(_id, value, session) {
+    try {
+      _id = new import_mongodb17.ObjectId(_id);
+    } catch (error) {
+      throw new import_node_server_utils29.BadRequestError("Invalid check out item ID format.");
+    }
+    const updateValue = buildCheckOutDecision(
+      value.approve === true ? "approve" : "disapprove",
+      value.remarks
+    );
+    if (value.completedBy) {
+      try {
+        updateValue.completedBy = new import_mongodb17.ObjectId(value.completedBy);
+      } catch (error) {
+        throw new import_node_server_utils29.BadRequestError("Invalid user ID format.");
+      }
+    }
+    try {
+      const res = await collection.updateOne(
+        { _id, status: CHECKOUT_DECIDABLE_STATUS },
+        { $set: updateValue },
+        { session }
+      );
+      if (res.matchedCount === 0) {
+        throw new import_node_server_utils29.NotFoundError(
+          "Check out item not found or is no longer pending approval."
+        );
+      }
+      delNamespace().then(() => {
+        import_node_server_utils29.logger.info(`Cache cleared for namespace: ${namespace_collection}`);
+      }).catch((err) => {
+        import_node_server_utils29.logger.error(
+          `Failed to clear cache for namespace: ${namespace_collection}`,
+          err
+        );
+      });
+      return res.modifiedCount;
+    } catch (error) {
+      throw error;
+    }
+  }
   return {
     createIndex,
     createTextIndex,
     createCheckOutItem,
     getCheckOutItems,
     getCheckOutItemById,
-    completeCheckOutItem
+    completeCheckOutItem,
+    decideCheckOutItem
   };
 }
 
@@ -6188,7 +6269,8 @@ function useCheckOutItemService() {
   const {
     createCheckOutItem: _createCheckOutItem,
     getCheckOutItemById: _getCheckOutItemById,
-    completeCheckOutItem
+    completeCheckOutItem,
+    decideCheckOutItem: _decideCheckOutItem
   } = useCheckOutItemRepository();
   const { getSupplyById } = useSupplyRepository();
   const { getUserById } = (0, import_core17.useUserRepo)();
@@ -6279,9 +6361,41 @@ function useCheckOutItemService() {
       await session?.endSession();
     }
   }
+  async function decideCheckOutItem(_id, value) {
+    const session = import_node_server_utils30.useAtlas.getClient()?.startSession();
+    try {
+      session?.startTransaction();
+      const checkOutItem = await _getCheckOutItemById(_id, session);
+      if (!checkOutItem) {
+        throw new import_node_server_utils30.BadRequestError("Check out item not found.");
+      }
+      const decided = await applyCheckOutDecision(
+        value.approve === true ? "approve" : "disapprove",
+        () => _decideCheckOutItem(_id, value, session),
+        () => createStock(
+          {
+            site: checkOutItem.site.toString(),
+            serviceType: checkOutItem.serviceType,
+            supply: checkOutItem.supply.toString(),
+            qty: checkOutItem.qty
+          },
+          false,
+          session
+        )
+      );
+      await session?.commitTransaction();
+      return decided;
+    } catch (error) {
+      await session?.abortTransaction();
+      throw error;
+    } finally {
+      await session?.endSession();
+    }
+  }
   return {
     createCheckOutItem,
-    createCheckOutItemByBatch
+    createCheckOutItemByBatch,
+    decideCheckOutItem
   };
 }
 
@@ -6296,7 +6410,8 @@ function useCheckOutItemController() {
   } = useCheckOutItemRepository();
   const {
     createCheckOutItem: _createCheckOutItem,
-    createCheckOutItemByBatch: _createCheckOutItemByBatch
+    createCheckOutItemByBatch: _createCheckOutItemByBatch,
+    decideCheckOutItem: _decideCheckOutItem
   } = useCheckOutItemService();
   async function createCheckOutItem(req, res, next) {
     const cookies = req.headers.cookie ? req.headers.cookie.split(";").map((cookie) => cookie.trim().split("=")).reduce(
@@ -6427,11 +6542,60 @@ function useCheckOutItemController() {
       return;
     }
   }
+  async function decideCheckOutItem(req, res, next) {
+    const cookies = req.headers.cookie ? req.headers.cookie.split(";").map((cookie) => cookie.trim().split("=")).reduce(
+      (acc, [key, value]) => ({ ...acc, [key]: value }),
+      {}
+    ) : {};
+    const completedBy = cookies["user"] || "";
+    const decisionMap = {
+      approve: { approve: true, reject: false },
+      disapprove: { approve: false, reject: true }
+    };
+    const decision = req.params.decision;
+    const decisionValues = decisionMap[decision] || {
+      approve: void 0,
+      reject: void 0
+    };
+    const payload = {
+      ...req.params,
+      ...req.body,
+      ...decisionValues,
+      completedBy
+    };
+    const validation = import_joi15.default.object({
+      id: import_joi15.default.string().hex().required(),
+      decision: import_joi15.default.string().valid("approve", "disapprove").required(),
+      approve: import_joi15.default.boolean().required(),
+      reject: import_joi15.default.boolean().required(),
+      remarks: import_joi15.default.string().optional().allow("", null),
+      completedBy: import_joi15.default.string().hex().required()
+    });
+    const { error } = validation.validate(payload);
+    if (error) {
+      import_node_server_utils31.logger.log({ level: "error", message: error.message });
+      next(new import_node_server_utils31.BadRequestError(error.message));
+      return;
+    }
+    try {
+      const { id, decision: _d, ...value } = payload;
+      await _decideCheckOutItem(id, value);
+      res.json({
+        message: `Check out item ${decision === "approve" ? "approved" : "disapproved"} successfully.`
+      });
+      return;
+    } catch (error2) {
+      import_node_server_utils31.logger.log({ level: "error", message: error2.message });
+      next(error2);
+      return;
+    }
+  }
   return {
     createCheckOutItem,
     createCheckOutItemByBatch,
     getCheckOutItems,
-    getCheckOutItemById
+    getCheckOutItemById,
+    decideCheckOutItem
   };
 }
 
@@ -7472,6 +7636,8 @@ function useQRController() {
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  CHECKOUT_DECIDABLE_STATUS,
+  CHECKOUT_DECISIONS,
   MArea,
   MAreaChecklist,
   MCheckOutItem,
@@ -7485,9 +7651,12 @@ function useQRController() {
   allowedPeriods,
   allowedStatus,
   allowedTypes,
+  applyCheckOutDecision,
   areaChecklistSchema,
   areaSchema,
+  buildCheckOutDecision,
   checkOutItemSchema,
+  isCheckOutDecision,
   parentChecklistSchema,
   scheduleTaskSchema,
   stockSchema,