@eeplatform/core 1.2.1 → 1.4.0

package/dist/index.mjs

@@ -27066,6 +27066,7 @@ var schemaBuildingUnit = Joi33.object({
 var schemaUpdateOptions = Joi33.object({
   name: Joi33.string().optional().allow("", null),
   building: Joi33.string().hex().optional().allow("", null),
+  buildingName: Joi33.string().optional().allow("", null),
   level: Joi33.number().integer().min(1).optional().allow("", null),
   category: Joi33.string().optional().allow("", null),
   type: Joi33.string().optional().allow("", null),
@@ -27492,6 +27493,36 @@ function useBuildingUnitRepo() {
       }
     }
   }
+  async function updateByBuildingId(building, value, session) {
+    const { error } = schemaUpdateOptions.validate(value);
+    if (error) {
+      throw new BadRequestError61(error.message);
+    }
+    try {
+      building = new ObjectId41(building);
+    } catch (error2) {
+      throw new BadRequestError61("Invalid building ID.");
+    }
+    try {
+      const res = await collection.updateMany(
+        { building },
+        { $set: value },
+        { session }
+      );
+      delCachedData();
+      return res;
+    } catch (error2) {
+      logger31.log({
+        level: "error",
+        message: error2.message
+      });
+      if (error2 instanceof AppError15) {
+        throw error2;
+      } else {
+        throw new Error("Failed to update building unit.");
+      }
+    }
+  }
   async function getAll({
     search = "",
     page = 1,
@@ -27739,7 +27770,8 @@ function useBuildingUnitRepo() {
     getByBuildingLevel,
     updateById,
     getByBuilding,
-    deleteById
+    deleteById,
+    updateByBuildingId
   };
 }
 
@@ -27748,20 +27780,25 @@ import { BadRequestError as BadRequestError63, logger as logger32 } from "@eepla
 import Joi34 from "joi";
 
 // src/services/building.service.ts
-import { BadRequestError as BadRequestError62, NotFoundError as NotFoundError11 } from "@eeplatform/nodejs-utils";
+import {
+  BadRequestError as BadRequestError62,
+  NotFoundError as NotFoundError10,
+  useAtlas as useAtlas33
+} from "@eeplatform/nodejs-utils";
 function useBuildingService() {
   const {
     updateById: _updateById,
     getById: _getById,
     deleteById: _deleteById
   } = useBuildingRepo();
-  const { getByBuildingLevel, getByBuilding } = useBuildingUnitRepo();
+  const { getByBuildingLevel, getByBuilding, updateByBuildingId } = useBuildingUnitRepo();
   async function updateById(id, data) {
     data.levels = Number(data.levels);
+    const session = useAtlas33.getClient()?.startSession();
     try {
       const building = await _getById(id);
       if (!building) {
-        throw new NotFoundError11("Building not found.");
+        throw new NotFoundError10("Building not found.");
       }
       if (data.levels < building.levels) {
         const unit = await getByBuildingLevel(id, building.levels);
@@ -27771,10 +27808,18 @@ function useBuildingService() {
           );
         }
       }
-      const result = await _updateById(id, data);
+      session?.startTransaction();
+      if (building.name !== data.name) {
+        await updateByBuildingId(id, { buildingName: data.name }, session);
+      }
+      const result = await _updateById(id, data, session);
+      await session?.commitTransaction();
       return result;
     } catch (error) {
+      await session?.abortTransaction();
       throw error;
+    } finally {
+      session?.endSession();
     }
   }
   async function deleteById(id) {
@@ -27945,11 +27990,11 @@ import { BadRequestError as BadRequestError64 } from "@eeplatform/nodejs-utils";
 import Joi35 from "joi";
 
 // src/services/building-unit.service.ts
-import { useAtlas as useAtlas33 } from "@eeplatform/nodejs-utils";
+import { useAtlas as useAtlas34 } from "@eeplatform/nodejs-utils";
 function useBuildingUnitService() {
   const { add: _add } = useBuildingUnitRepo();
   async function add(value) {
-    const session = useAtlas33.getClient()?.startSession();
+    const session = useAtlas34.getClient()?.startSession();
     if (!session) {
       throw new Error("Unable to start session for building unit service.");
     }
@@ -28131,6 +28176,1086 @@ function useBuildingUnitController() {
     deleteById
   };
 }
+
+// src/models/asset.model.ts
+import { BadRequestError as BadRequestError65 } from "@eeplatform/nodejs-utils";
+import Joi36 from "joi";
+import { ObjectId as ObjectId42 } from "mongodb";
+var schemaAsset = Joi36.object({
+  _id: Joi36.string().hex().optional(),
+  school: Joi36.string().hex().required(),
+  asset_type: Joi36.string().required().allow("supply", "furniture-equipment", "fixed-asset"),
+  name: Joi36.string().required(),
+  category: Joi36.string().optional().allow("", null),
+  type: Joi36.string().optional().allow("", null),
+  brand: Joi36.string().optional().allow("", null),
+  unit: Joi36.string().required(),
+  status: Joi36.string().optional().allow("", null),
+  createdAt: Joi36.date().optional().allow("", null),
+  updatedAt: Joi36.date().optional().allow("", null),
+  deletedAt: Joi36.date().optional().allow("", null),
+  metadata: Joi36.object({
+    title: Joi36.string().optional().allow("", null),
+    isbn: Joi36.string().optional().allow("", null),
+    author: Joi36.string().optional().allow("", null),
+    edition: Joi36.string().optional().allow("", null),
+    subject: Joi36.string().optional().allow("", null),
+    grade_level: Joi36.number().integer().min(0).optional().allow("", null),
+    publisher: Joi36.string().optional().allow("", null),
+    language: Joi36.string().optional().allow("", null)
+  }).optional().allow(null)
+});
+var schemaAssetUpdateOption = Joi36.object({
+  name: Joi36.string().optional().allow("", null),
+  category: Joi36.string().optional().allow("", null),
+  type: Joi36.string().optional().allow("", null),
+  brand: Joi36.string().optional().allow("", null),
+  qty: Joi36.number().integer().min(0).optional().allow("", null),
+  unit: Joi36.string().optional().allow("", null),
+  metadata: Joi36.object({
+    title: Joi36.string().optional().allow("", null),
+    isbn: Joi36.string().optional().allow("", null),
+    author: Joi36.string().optional().allow("", null),
+    edition: Joi36.string().optional().allow("", null),
+    subject: Joi36.string().optional().allow("", null),
+    grade_level: Joi36.number().integer().min(0).optional().allow("", null),
+    publisher: Joi36.string().optional().allow("", null),
+    language: Joi36.string().optional().allow("", null)
+  }).optional().allow(null)
+});
+function MAsset(value) {
+  const { error } = schemaAsset.validate(value);
+  if (error) {
+    throw new BadRequestError65(error.message);
+  }
+  if (value._id && typeof value._id === "string") {
+    try {
+      value._id = new ObjectId42();
+    } catch (error2) {
+      throw new BadRequestError65("Invalid ID.");
+    }
+  }
+  try {
+    value.school = new ObjectId42(value.school);
+  } catch (error2) {
+    throw new BadRequestError65("Invalid school ID.");
+  }
+  value.createdAt = value.createdAt ? new Date(value.createdAt) : /* @__PURE__ */ new Date();
+  value.updatedAt = value.updatedAt ? new Date(value.updatedAt) : "";
+  value.deletedAt = value.deletedAt ? new Date(value.deletedAt) : "";
+  return {
+    _id: value._id ?? new ObjectId42(),
+    school: value.school,
+    asset_type: value.asset_type ?? "supply",
+    name: value.name,
+    category: value.category ?? "",
+    type: value.type ?? "",
+    brand: value.brand ?? "",
+    qty: value.qty ?? 0,
+    condition: value.condition ?? {
+      good: 0,
+      disposal: 0,
+      lost: 0,
+      damaged: 0
+    },
+    unit: value.unit ?? "",
+    status: value.status ?? "active",
+    createdAt: value.createdAt,
+    updatedAt: value.updatedAt,
+    deletedAt: value.deletedAt,
+    metadata: value.metadata ?? {}
+  };
+}
+
+// src/repositories/asset.repository.ts
+import {
+  BadRequestError as BadRequestError66,
+  logger as logger33,
+  makeCacheKey as makeCacheKey21,
+  paginate as paginate17,
+  useAtlas as useAtlas35,
+  useCache as useCache22
+} from "@eeplatform/nodejs-utils";
+import { ObjectId as ObjectId43 } from "mongodb";
+function useAssetRepo() {
+  const db = useAtlas35.getDb();
+  if (!db) {
+    throw new BadRequestError66("Unable to connect to server.");
+  }
+  const namespace_collection = "school.assets";
+  const collection = db.collection(namespace_collection);
+  const { getCache, setCache, delNamespace } = useCache22(namespace_collection);
+  function delCachedData() {
+    delNamespace().then(() => {
+      logger33.log({
+        level: "info",
+        message: `Cache namespace cleared for ${namespace_collection}`
+      });
+    }).catch((err) => {
+      logger33.log({
+        level: "error",
+        message: `Failed to clear cache namespace for ${namespace_collection}: ${err.message}`
+      });
+    });
+  }
+  async function createIndex() {
+    try {
+      await collection.createIndexes([
+        { key: { school: 1 } },
+        { key: { name: 1 } },
+        { key: { name: "text" } }
+      ]);
+    } catch (error) {
+      throw new BadRequestError66("Failed to create index on asset.");
+    }
+  }
+  async function add(value) {
+    try {
+      value = MAsset(value);
+      const res = await collection.insertOne(value);
+      delCachedData();
+      return res.insertedId;
+    } catch (error) {
+      throw new BadRequestError66("Failed to create asset item.");
+    }
+  }
+  async function updateById(_id, value, session) {
+    const { error } = schemaAssetUpdateOption.validate(value);
+    if (error) {
+      throw new BadRequestError66(error.message);
+    }
+    try {
+      _id = new ObjectId43(_id);
+    } catch (error2) {
+      throw new BadRequestError66("Invalid ID.");
+    }
+    try {
+      const res = await collection.updateOne(
+        { _id },
+        { $set: value },
+        { session }
+      );
+      if (res.modifiedCount) {
+        delCachedData();
+      }
+      return "Successfully updated asset item.";
+    } catch (error2) {
+      throw new BadRequestError66("Failed to update asset item.");
+    }
+  }
+  async function deleteById(_id) {
+    try {
+      _id = new ObjectId43(_id);
+    } catch (error) {
+      throw new BadRequestError66("Invalid ID.");
+    }
+    try {
+      const res = await collection.deleteOne({ _id });
+      if (res.deletedCount) {
+        delCachedData();
+        return "Successfully deleted asset item.";
+      }
+      return "Successfully deleted asset item.";
+    } catch (error) {
+      throw new BadRequestError66("Failed to delete asset item.");
+    }
+  }
+  async function getById(_id) {
+    try {
+      _id = new ObjectId43(_id);
+    } catch (error) {
+      throw new BadRequestError66("Invalid ID.");
+    }
+    const cacheKey = makeCacheKey21(namespace_collection, { _id: String(_id) });
+    const cachedData = await getCache(cacheKey);
+    if (cachedData) {
+      return cachedData;
+    }
+    try {
+      const res = await collection.findOne({ _id });
+      if (!res) {
+        throw new BadRequestError66("Asset item not found.");
+      }
+      setCache(cacheKey, res).then(() => {
+        logger33.log({
+          level: "info",
+          message: `Cache set for asset item by ID: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger33.log({
+          level: "error",
+          message: `Failed to set cache for asset item by ID: ${cacheKey} - ${err.message}`
+        });
+      });
+      return res;
+    } catch (error) {
+      if (error instanceof BadRequestError66) {
+        throw error;
+      }
+      throw new BadRequestError66("Failed to retrieve asset item.");
+    }
+  }
+  async function getAll({
+    page = 1,
+    search = "",
+    limit = 20,
+    status = "active",
+    school = "",
+    sort = { _id: -1 },
+    asset_type = "supply"
+  } = {}) {
+    page = page ? page - 1 : 0;
+    try {
+      school = new ObjectId43(school);
+    } catch (error) {
+      throw new BadRequestError66("Invalid school ID.");
+    }
+    const query = {
+      school,
+      status,
+      asset_type
+    };
+    const cacheKeyOptions = {
+      page,
+      limit,
+      status,
+      school: String(school),
+      sort: JSON.stringify(sort),
+      asset_type
+    };
+    if (search) {
+      query.$text = { $search: search };
+      cacheKeyOptions.search = search;
+    }
+    try {
+      const cacheKey = makeCacheKey21(namespace_collection, cacheKeyOptions);
+      const cached = await getCache(cacheKey);
+      if (cached) {
+        logger33.log({
+          level: "info",
+          message: `Cache hit for getAll asset items: ${cacheKey}`
+        });
+        return cached;
+      }
+      const items = await collection.aggregate([
+        { $match: query },
+        {
+          $sort: sort
+        },
+        {
+          $skip: page * limit
+        },
+        {
+          $limit: limit
+        }
+      ]).toArray();
+      const length = await collection.countDocuments(query);
+      const data = paginate17(items, page, limit, length);
+      setCache(cacheKey, data, 500).then(() => {
+        logger33.log({
+          level: "info",
+          message: `Cache set for getAll asset items: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger33.log({
+          level: "error",
+          message: `Failed to set cache for getAll asset items: ${err.message}`
+        });
+      });
+      return data;
+    } catch (error) {
+      console.log("Error in getAll:", error);
+      throw new BadRequestError66("Failed to retrieve asset items.");
+    }
+  }
+  async function getCategories(school, asset_type) {
+    try {
+      school = new ObjectId43(school);
+    } catch (error) {
+      throw new BadRequestError66("Invalid school ID.");
+    }
+    const cacheKey = makeCacheKey21(namespace_collection, {
+      school,
+      asset_type,
+      type: "category-as-options"
+    });
+    const cachedData = await getCache(cacheKey);
+    if (cachedData) {
+      return cachedData;
+    }
+    try {
+      const categories = await collection.aggregate([
+        {
+          $match: { school, asset_type }
+        },
+        {
+          $group: {
+            _id: "$category",
+            value: { $first: "$category" },
+            title: {
+              $first: "$category"
+            }
+          }
+        },
+        {
+          $project: {
+            _id: 0,
+            title: 1,
+            value: 1
+          }
+        },
+        { $sort: { title: 1 } }
+      ]).toArray();
+      setCache(cacheKey, categories).then(() => {
+        logger33.log({
+          level: "info",
+          message: `Cache set for getCategoriesBySchool: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger33.log({
+          level: "error",
+          message: `Failed to set cache for getCategoriesBySchool: ${err.message}`
+        });
+      });
+      return categories;
+    } catch (error) {
+      if (error instanceof BadRequestError66) {
+        throw error;
+      }
+      throw new BadRequestError66("Failed to retrieve asset categories.");
+    }
+  }
+  async function getTypes(school, asset_type) {
+    try {
+      school = new ObjectId43(school);
+    } catch (error) {
+      throw new BadRequestError66("Invalid school ID.");
+    }
+    const cacheKey = makeCacheKey21(namespace_collection, {
+      school,
+      asset_type,
+      type: "types-as-options"
+    });
+    const cachedData = await getCache(cacheKey);
+    if (cachedData) {
+      return cachedData;
+    }
+    try {
+      const categories = await collection.aggregate([
+        {
+          $match: { school, asset_type }
+        },
+        {
+          $group: {
+            _id: "$type",
+            value: { $first: "$type" },
+            category: { $first: "$category" },
+            title: { $first: "$name" },
+            subtitle: { $first: "" }
+            // keep empty for now, can be filled later
+          }
+        },
+        {
+          $project: {
+            _id: 0,
+            title: 1,
+            value: 1,
+            category: 1,
+            subtitle: 1
+          }
+        },
+        { $sort: { title: 1 } }
+      ]).toArray();
+      setCache(cacheKey, categories).then(() => {
+        logger33.log({
+          level: "info",
+          message: `Cache set for getCategoriesBySchool: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger33.log({
+          level: "error",
+          message: `Failed to set cache for getCategoriesBySchool: ${err.message}`
+        });
+      });
+      return categories;
+    } catch (error) {
+      if (error instanceof BadRequestError66) {
+        throw error;
+      }
+      throw new BadRequestError66("Failed to retrieve asset categories.");
+    }
+  }
+  async function getUnitsBySchool(school) {
+    try {
+      school = new ObjectId43(school);
+    } catch (error) {
+      throw new BadRequestError66("Invalid school ID.");
+    }
+    const cacheKey = makeCacheKey21(namespace_collection, {
+      school,
+      type: "unit-as-options"
+    });
+    const cachedData = await getCache(cacheKey);
+    if (cachedData) {
+      return cachedData;
+    }
+    try {
+      const categories = await collection.aggregate([
+        {
+          $match: { school }
+        },
+        {
+          $group: {
+            _id: "$unit",
+            value: { $first: "$unit" },
+            title: {
+              $first: "$unit"
+            }
+          }
+        },
+        {
+          $project: {
+            _id: 0,
+            title: 1,
+            value: 1
+          }
+        },
+        { $sort: { title: 1 } }
+      ]).toArray();
+      setCache(cacheKey, categories).then(() => {
+        logger33.log({
+          level: "info",
+          message: `Cache set for getUnitBy: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger33.log({
+          level: "error",
+          message: `Failed to set cache for getUnitBy: ${err.message}`
+        });
+      });
+      return categories;
+    } catch (error) {
+      console.log(error);
+      if (error instanceof BadRequestError66) {
+        throw error;
+      }
+      throw new BadRequestError66(
+        "Failed to retrieve asset unit of measurements."
+      );
+    }
+  }
+  return {
+    createIndex,
+    add,
+    updateById,
+    deleteById,
+    getById,
+    getAll,
+    getCategories,
+    getTypes,
+    getUnitsBySchool
+  };
+}
+
+// src/controllers/asset.controller.ts
+import { BadRequestError as BadRequestError67 } from "@eeplatform/nodejs-utils";
+import Joi37 from "joi";
+function useAssetController() {
+  const {
+    add: _add,
+    getAll: _getAll,
+    deleteById: _deleteById,
+    updateById: _updateById,
+    getById: _getById,
+    getCategories: _getCategories,
+    getTypes: _getTypes,
+    getUnitsBySchool: _getUnitsBySchool
+  } = useAssetRepo();
+  async function add(req, res, next) {
+    const value = req.body;
+    const { error } = schemaAsset.validate(value);
+    if (error) {
+      next(new BadRequestError67(error.message));
+      return;
+    }
+    try {
+      const id = await _add(value);
+      res.json({ message: "Successfully added asset item.", id });
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function getAll(req, res, next) {
+    const query = req.query;
+    const validation = Joi37.object({
+      page: Joi37.number().min(1).optional().allow("", null),
+      limit: Joi37.number().min(1).optional().allow("", null),
+      search: Joi37.string().optional().allow("", null),
+      status: Joi37.string().optional().allow("", null),
+      school: Joi37.string().hex().optional().allow("", null),
+      asset_type: Joi37.string().required().allow("supply", "furniture-equipment", "fixed-asset")
+    });
+    const { error } = validation.validate(query);
+    const page = typeof req.query.page === "string" ? Number(req.query.page) : 1;
+    const limit = typeof req.query.limit === "string" ? Number(req.query.limit) : 10;
+    const search = req.query.search ?? "";
+    const status = req.query.status ?? "active";
+    const school = req.query.school ?? "";
+    const asset_type = req.query.asset_type ?? "supply";
+    const isPageNumber = isFinite(page);
+    if (!isPageNumber) {
+      next(new BadRequestError67("Invalid page number."));
+      return;
+    }
+    const isLimitNumber = isFinite(limit);
+    if (!isLimitNumber) {
+      next(new BadRequestError67("Invalid limit number."));
+      return;
+    }
+    if (error) {
+      next(new BadRequestError67(error.message));
+      return;
+    }
+    try {
+      const regions = await _getAll({
+        page,
+        limit,
+        search,
+        status,
+        school,
+        asset_type
+      });
+      res.json(regions);
+      return;
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function deleteById(req, res, next) {
+    const id = req.params.id;
+    const validation = Joi37.string().hex().required();
+    const { error } = validation.validate(id);
+    if (error) {
+      next(new BadRequestError67(error.message));
+      return;
+    }
+    try {
+      await _deleteById(id);
+      res.json({ message: "Successfully deleted asset item.", id });
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function getById(req, res, next) {
+    const id = req.params.id;
+    const validation = Joi37.string().hex().required();
+    const { error } = validation.validate(id);
+    if (error) {
+      next(new BadRequestError67(error.message));
+      return;
+    }
+    try {
+      const data = await _getById(id);
+      res.json(data);
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function updateById(req, res, next) {
+    const id = req.params.id;
+    const value = req.body;
+    const { error } = schemaAssetUpdateOption.validate(value);
+    if (error) {
+      next(new BadRequestError67(error.message));
+      return;
+    }
+    try {
+      await _updateById(id, value);
+      res.json({ message: "Successfully updated asset item.", id });
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function getCategories(req, res, next) {
+    const school = req.params.school;
+    const asset_type = req.params.asset_type;
+    const validation = Joi37.string().hex().required();
+    const { error } = validation.validate(school);
+    if (error) {
+      next(new BadRequestError67(error.message));
+      return;
+    }
+    try {
+      const data = await _getCategories(school, asset_type);
+      res.json(data);
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function getTypes(req, res, next) {
+    const school = req.params.school;
+    const asset_type = req.params.asset_type;
+    const validation = Joi37.string().hex().required();
+    const { error } = validation.validate(school);
+    if (error) {
+      next(new BadRequestError67(error.message));
+      return;
+    }
+    try {
+      const data = await _getTypes(school, asset_type);
+      res.json(data);
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function getUnitsBySchool(req, res, next) {
+    const school = req.params.school;
+    const validation = Joi37.string().hex().required();
+    const { error } = validation.validate(school);
+    if (error) {
+      next(new BadRequestError67(error.message));
+      return;
+    }
+    try {
+      const data = await _getUnitsBySchool(school);
+      res.json(data);
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  return {
+    add,
+    getAll,
+    deleteById,
+    updateById,
+    getById,
+    getCategories,
+    getTypes,
+    getUnitsBySchool
+  };
+}
+
+// src/models/stock-card.model.ts
+import { BadRequestError as BadRequestError68 } from "@eeplatform/nodejs-utils";
+import Joi38 from "joi";
+import { ObjectId as ObjectId44 } from "mongodb";
+var schemaStockCard = Joi38.object({
+  _id: Joi38.string().hex().optional().allow("", null),
+  school: Joi38.string().hex().required(),
+  item: Joi38.string().hex().required(),
+  balance: Joi38.number().optional().allow(null, 0),
+  qty: Joi38.number().required(),
+  unitCost: Joi38.number().optional().allow(null, 0),
+  totalCost: Joi38.number().optional().allow(null, 0),
+  status: Joi38.string().required(),
+  condition: Joi38.string().required(),
+  supplier: Joi38.string().optional().allow("", null),
+  location: Joi38.string().optional().allow("", null),
+  locationName: Joi38.string().optional().allow("", null),
+  reason: Joi38.string().optional().allow("", null),
+  remarks: Joi38.string().optional().allow("", null),
+  createdAt: Joi38.date().optional().allow("", null),
+  updatedAt: Joi38.date().optional().allow("", null),
+  deletedAt: Joi38.date().optional().allow("", null)
+});
+function MStockCard(value) {
+  const { error } = schemaStockCard.validate(value);
+  if (error) {
+    throw new BadRequestError68(`Invalid stock card data: ${error.message}`);
+  }
+  if (value._id && typeof value._id === "string") {
+    try {
+      value._id = new ObjectId44(value._id);
+    } catch (err) {
+      throw new BadRequestError68("Invalid stock card ID.");
+    }
+  }
+  try {
+    value.item = new ObjectId44(value.item);
+  } catch (err) {
+    throw new BadRequestError68("Invalid item ID.");
+  }
+  try {
+    value.school = new ObjectId44(value.school);
+  } catch (err) {
+    throw new BadRequestError68("Invalid school ID.");
+  }
+  return {
+    _id: value._id ?? void 0,
+    school: value.school,
+    item: value.item,
+    balance: value.balance,
+    qty: value.qty,
+    unitCost: value.unitCost,
+    totalCost: value.totalCost,
+    status: value.status,
+    condition: value.condition,
+    supplier: value.supplier ?? "",
+    location: value.location ?? void 0,
+    locationName: value.locationName ?? "",
+    reason: value.reason ?? "",
+    remarks: value.remarks ?? "",
+    createdAt: value.createdAt ?? /* @__PURE__ */ new Date(),
+    updatedAt: value.updatedAt ?? "",
+    deletedAt: value.deletedAt ?? ""
+  };
+}
+
+// src/repositories/stock-card.repository.ts
+import {
+  BadRequestError as BadRequestError69,
+  logger as logger34,
+  makeCacheKey as makeCacheKey22,
+  paginate as paginate18,
+  useAtlas as useAtlas36,
+  useCache as useCache23
+} from "@eeplatform/nodejs-utils";
+import { ObjectId as ObjectId45 } from "mongodb";
+function useStockCardRepository() {
+  const db = useAtlas36.getDb();
+  if (!db) {
+    throw new BadRequestError69("Unable to connect to server.");
+  }
+  const namespace_collection = "school.assets.stock-cards";
+  const collection = db.collection(namespace_collection);
+  const { getCache, setCache, delNamespace } = useCache23(namespace_collection);
+  function delCachedData() {
+    delNamespace().then(() => {
+      logger34.log({
+        level: "info",
+        message: `Cache namespace cleared for ${namespace_collection}`
+      });
+    }).catch((err) => {
+      logger34.log({
+        level: "error",
+        message: `Failed to clear cache namespace for ${namespace_collection}: ${err.message}`
+      });
+    });
+  }
+  async function createIndex() {
+    try {
+      await collection.createIndexes([
+        { key: { school: 1 } },
+        { key: { item: 1 } }
+      ]);
+    } catch (error) {
+      throw new BadRequestError69("Failed to create index on stock card.");
+    }
+  }
+  async function add(value, session) {
+    try {
+      value = MStockCard(value);
+      const res = await collection.insertOne(value, { session });
+      delCachedData();
+      return res.insertedId;
+    } catch (error) {
+      throw new BadRequestError69("Failed to create stock card.");
+    }
+  }
+  async function getById(_id) {
+    try {
+      _id = new ObjectId45(_id);
+    } catch (error) {
+      throw new BadRequestError69("Invalid ID.");
+    }
+    const cacheKey = makeCacheKey22(namespace_collection, { _id: String(_id) });
+    const cachedData = await getCache(cacheKey);
+    if (cachedData) {
+      return cachedData;
+    }
+    try {
+      const res = await collection.findOne({ _id });
+      if (!res) {
+        throw new BadRequestError69("Asset item not found.");
+      }
+      setCache(cacheKey, res).then(() => {
+        logger34.log({
+          level: "info",
+          message: `Cache set for stock card by ID: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger34.log({
+          level: "error",
+          message: `Failed to set cache for stock card by ID: ${cacheKey} - ${err.message}`
+        });
+      });
+      return res;
+    } catch (error) {
+      if (error instanceof BadRequestError69) {
+        throw error;
+      }
+      throw new BadRequestError69("Failed to retrieve stock card.");
+    }
+  }
+  async function getAll({ page = 1, limit = 20, school = "", sort = { _id: 1 }, id = "" } = {}) {
+    page = page ? page - 1 : 0;
+    try {
+      school = new ObjectId45(school);
+    } catch (error) {
+      throw new BadRequestError69("Invalid school ID.");
+    }
+    try {
+      id = new ObjectId45(id);
+    } catch (error) {
+      throw new BadRequestError69("Invalid ID.");
+    }
+    const query = {
+      school,
+      item: id
+    };
+    const cacheKeyOptions = {
+      page,
+      limit,
+      school: String(school),
+      sort: JSON.stringify(sort),
+      item: id
+    };
+    try {
+      const cacheKey = makeCacheKey22(namespace_collection, cacheKeyOptions);
+      const cached = await getCache(cacheKey);
+      if (cached) {
+        logger34.log({
+          level: "info",
+          message: `Cache hit for getAll stock cards: ${cacheKey}`
+        });
+        return cached;
+      }
+      const items = await collection.aggregate([
+        { $match: query },
+        {
+          $sort: sort
+        },
+        {
+          $skip: page * limit
+        },
+        {
+          $limit: limit
+        }
+      ]).toArray();
+      const length = await collection.countDocuments(query);
+      const data = paginate18(items, page, limit, length);
+      setCache(cacheKey, data, 500).then(() => {
+        logger34.log({
+          level: "info",
+          message: `Cache set for getAll stock cards: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger34.log({
+          level: "error",
+          message: `Failed to set cache for getAll stock cards: ${err.message}`
+        });
+      });
+      return data;
+    } catch (error) {
+      console.log("Error in getAll:", error);
+      throw new BadRequestError69("Failed to retrieve stock cards.");
+    }
+  }
+  async function getSuppliers(school) {
+    try {
+      school = new ObjectId45(school);
+    } catch (error) {
+      throw new BadRequestError69("Invalid school ID.");
+    }
+    const cacheKey = makeCacheKey22(namespace_collection, {
+      school,
+      type: "supplier-as-options"
+    });
+    const cachedData = await getCache(cacheKey);
+    if (cachedData) {
+      return cachedData;
+    }
+    try {
+      const suppliers = await collection.aggregate([
+        {
+          $match: { school }
+        },
+        {
+          $group: {
+            _id: "$supplier",
+            value: { $first: "$supplier" },
+            title: {
+              $first: "$supplier"
+            }
+          }
+        },
+        {
+          $project: {
+            _id: 0,
+            title: 1,
+            value: 1
+          }
+        },
+        { $sort: { title: 1 } }
+      ]).toArray();
+      setCache(cacheKey, suppliers).then(() => {
+        logger34.log({
+          level: "info",
+          message: `Cache set for getSuppliersBySchool: ${cacheKey}`
+        });
+      }).catch((err) => {
+        logger34.log({
+          level: "error",
+          message: `Failed to set cache for getSuppliersBySchool: ${err.message}`
+        });
+      });
+      return suppliers;
+    } catch (error) {
+      if (error instanceof BadRequestError69) {
+        throw error;
+      }
+      throw new BadRequestError69("Failed to retrieve asset suppliers.");
+    }
+  }
+  return {
+    createIndex,
+    add,
+    getById,
+    getAll,
+    getSuppliers
+  };
+}
+
+// src/controllers/stock-card.controller.ts
+import { BadRequestError as BadRequestError71 } from "@eeplatform/nodejs-utils";
+import Joi39 from "joi";
+
+// src/services/stock-card.service.ts
+import {
+  BadRequestError as BadRequestError70,
+  NotFoundError as NotFoundError11,
+  useAtlas as useAtlas37
+} from "@eeplatform/nodejs-utils";
+function useStockCardService() {
+  const { add: _add, getById: _getById } = useStockCardRepository();
+  const { getById: _getAssetById, updateById: updateAssetById } = useAssetRepo();
+  async function add(data) {
+    const session = useAtlas37.getClient()?.startSession();
+    if (!session) {
+      throw new BadRequestError70("Unable to start database session.");
+    }
+    session.startTransaction();
+    try {
+      const asset = await _getAssetById(data.item);
+      if (!asset) {
+        throw new NotFoundError11("Asset not found.");
+      }
+      data.balance = (asset.qty ?? 0) + data.qty;
+      await _add(data, session);
+      await updateAssetById(data.item, { qty: data.balance }, session);
+      await session.commitTransaction();
+      return "Successfully added stock card.";
+    } catch (error) {
+      await session.abortTransaction();
+      throw new BadRequestError70("Failed to add stock card.");
+    } finally {
+      session.endSession();
+    }
+  }
+  return {
+    add
+  };
+}
+
+// src/controllers/stock-card.controller.ts
+function useStockCardController() {
+  const {
+    getAll: _getAll,
+    getById: _getById,
+    getSuppliers: _getSuppliers
+  } = useStockCardRepository();
+  const { add: _add } = useStockCardService();
+  async function add(req, res, next) {
+    const value = req.body;
+    const { error } = schemaStockCard.validate(value);
+    if (error) {
+      next(new BadRequestError71(error.message));
+      return;
+    }
+    try {
+      const id = await _add(value);
+      res.json({ message: "Successfully added asset item.", id });
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function getAll(req, res, next) {
+    const query = req.query;
+    const validation = Joi39.object({
+      page: Joi39.number().min(1).optional().allow("", null),
+      limit: Joi39.number().min(1).optional().allow("", null),
+      school: Joi39.string().hex().optional().allow("", null),
+      id: Joi39.string().hex().required()
+    });
+    const { error } = validation.validate(query);
+    const page = typeof req.query.page === "string" ? Number(req.query.page) : 1;
+    const limit = typeof req.query.limit === "string" ? Number(req.query.limit) : 10;
+    const school = req.query.school ?? "";
+    const id = req.query.id ?? "supply";
+    const isPageNumber = isFinite(page);
+    if (!isPageNumber) {
+      next(new BadRequestError71("Invalid page number."));
+      return;
+    }
+    const isLimitNumber = isFinite(limit);
+    if (!isLimitNumber) {
+      next(new BadRequestError71("Invalid limit number."));
+      return;
+    }
+    if (error) {
+      next(new BadRequestError71(error.message));
+      return;
+    }
+    try {
+      const regions = await _getAll({
+        page,
+        limit,
+        id,
+        school
+      });
+      res.json(regions);
+      return;
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function getById(req, res, next) {
+    const id = req.params.id;
+    const validation = Joi39.string().hex().required();
+    const { error } = validation.validate(id);
+    if (error) {
+      next(new BadRequestError71(error.message));
+      return;
+    }
+    try {
+      const data = await _getById(id);
+      res.json(data);
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  async function getSuppliers(req, res, next) {
+    const school = req.params.school;
+    const validation = Joi39.string().hex().required();
+    const { error } = validation.validate(school);
+    if (error) {
+      next(new BadRequestError71(error.message));
+      return;
+    }
+    try {
+      const data = await _getSuppliers(school);
+      res.json(data);
+    } catch (error2) {
+      next(error2);
+    }
+  }
+  return {
+    add,
+    getAll,
+    getById,
+    getSuppliers
+  };
+}
 export {
   ACCESS_TOKEN_EXPIRY,
   ACCESS_TOKEN_SECRET,
@@ -28149,6 +29274,7 @@ export {
   MAILER_TRANSPORT_PORT,
   MAILER_TRANSPORT_SECURE,
   MAddress,
+  MAsset,
   MBuilding,
   MBuildingUnit,
   MDivision,
@@ -28164,6 +29290,7 @@ export {
   MRegion,
   MRole,
   MSchool,
+  MStockCard,
   MSubscription,
   MToken,
   MUser,
@@ -28191,14 +29318,19 @@ export {
   addressSchema,
   isDev,
   schema,
+  schemaAsset,
+  schemaAssetUpdateOption,
   schemaBuilding,
   schemaBuildingUnit,
   schemaDivision,
   schemaRegion,
   schemaSchool,
+  schemaStockCard,
   schemaUpdateOptions,
   useAddressController,
   useAddressRepo,
+  useAssetController,
+  useAssetRepo,
   useAuthController,
   useAuthService,
   useBuildingController,
@@ -28246,6 +29378,8 @@ export {
   useSchoolController,
   useSchoolRepo,
   useSchoolService,
+  useStockCardController,
+  useStockCardRepository,
   useSubscriptionController,
   useSubscriptionRepo,
   useSubscriptionService,