@7365admin1/core 3.76.0 → 3.77.0

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @iservice365/core
 
+## 3.77.0
+
+### Minor Changes
+
+- 09c259b: Add the `inventory` notification category (in-app and push), offered to roles holding any `inventory:*` permission, for API-core's inventory alerts: a request waiting for approval, a decided request, and low stock.
+
 ## 3.76.0
 
 ### Minor Changes

package/dist/index.d.ts

@@ -10452,12 +10452,12 @@ declare function useNewDashboardRepo(): {
             percentage: number | null;
         };
         supplyAlert: {
+            thresholdUnavailableReason?: string | undefined;
             items: {
                 name: any;
                 qty: any;
             }[];
-            basis: "lowest-quantity";
-            thresholdUnavailableReason: string;
+            basis: "lowest-quantity" | "below-alert-level";
         };
         taskCompleted: {
             completed: any;

package/dist/index.js

@@ -9644,6 +9644,20 @@ var NOTIFICATION_CATEGORIES = [
     vendorDefault: true,
     rendered: true
   },
+  // Inventory (2026-09-17). Sent from `iservice365-API-core`'s inventory
+  // module: a stock request waiting for approval and stock falling to its alert
+  // level go to that store's staff; a decided request goes to the person who
+  // asked. The caller checks `rendered` before it sends, so the sender and this
+  // switch cannot land out of order.
+  {
+    key: "inventory",
+    label: "Inventory",
+    description: "When a stock request needs your approval or has been decided, or stock you look after runs low.",
+    channels: { inApp: true, push: true, email: false },
+    channelNote: { email: NO_EMAIL_RECIPIENT },
+    permissionResources: ["inventory"],
+    rendered: true
+  },
   {
     key: "serviceProviderInvite",
     label: "Service Provider Invitations",
@@ -76531,6 +76545,7 @@ function highSeverityIncidentCount(severities) {
   ).length;
 }
 var SUPPLY_BASIS_LOWEST_QUANTITY = "lowest-quantity";
+var SUPPLY_BASIS_BELOW_ALERT_LEVEL = "below-alert-level";
 var SUPPLY_THRESHOLD_NOT_IN_MODEL = "Supplies do not record a stock threshold, so these are the lowest-quantity items rather than items below a level.";
 
 // src/repositories/new-dashboard.repo.ts
@@ -77389,6 +77404,32 @@ function useNewDashboardRepo() {
       { $unwind: { path: "$scheduleDoc", preserveNullAndEmptyArrays: false } }
     ];
   }
+  async function lowStockItems(site, serviceType) {
+    const stores = await db2.collection("inventory.stores").find({ sites: site, status: "active" }, { projection: { _id: 1 } }).toArray();
+    if (stores.length) {
+      const items2 = await db2.collection("inventory.items").aggregate([
+        {
+          $match: {
+            store: { $in: stores.map((store) => store._id) },
+            status: "active",
+            reorderLevel: { $gt: 0 },
+            $expr: { $lte: ["$onHand", "$reorderLevel"] }
+          }
+        },
+        { $sort: { onHand: 1 } },
+        { $limit: 5 },
+        { $project: { _id: 1, name: 1, qty: "$onHand" } }
+      ]).toArray();
+      return { items: items2, basis: SUPPLY_BASIS_BELOW_ALERT_LEVEL };
+    }
+    const items = await supplyCollection.aggregate([
+      { $match: { site, serviceType, status: "active" } },
+      { $sort: { qty: 1 } },
+      { $limit: 3 },
+      { $project: { _id: 1, name: 1, qty: 1 } }
+    ]).toArray();
+    return { items, basis: SUPPLY_BASIS_LOWEST_QUANTITY };
+  }
   async function getServiceDashboard({
     site,
     serviceType,
@@ -77446,12 +77487,7 @@ function useNewDashboardRepo() {
             }
           }
         ]).toArray(),
-        supplyCollection.aggregate([
-          { $match: { site, serviceType, status: "active" } },
-          { $sort: { qty: 1 } },
-          { $limit: 3 },
-          { $project: { _id: 1, name: 1, qty: 1 } }
-        ]).toArray(),
+        lowStockItems(site, serviceType),
         areaChecklistCollection.aggregate([
           ...areaChecklistScheduleLookup(site, serviceType, periodRange),
           {
@@ -77513,7 +77549,7 @@ function useNewDashboardRepo() {
           )
         },
         supplyAlert: {
-          items: supplyAlertReport.map((item) => ({
+          items: supplyAlertReport.items.map((item) => ({
             name: item.name,
             qty: item.qty
           })),
@@ -77521,8 +77557,8 @@ function useNewDashboardRepo() {
           // with no threshold, because `site.supplies` records no stock level to
           // compare against. Naming the ordering stops 900 gloves being drawn as
           // a warning. No threshold is invented here.
-          basis: SUPPLY_BASIS_LOWEST_QUANTITY,
-          thresholdUnavailableReason: SUPPLY_THRESHOLD_NOT_IN_MODEL
+          basis: supplyAlertReport.basis,
+          ...supplyAlertReport.basis === SUPPLY_BASIS_LOWEST_QUANTITY ? { thresholdUnavailableReason: SUPPLY_THRESHOLD_NOT_IN_MODEL } : {}
         },
         taskCompleted: {
           completed: tFacet.completed[0]?.count ?? 0,