@7365admin1/layer-common 4.59.2 → 4.60.0

package/CHANGELOG.md

@@ -1,5 +1,18 @@
 # @iservice365/layer-common
 
+## 4.60.0
+
+### Minor Changes
+
+- b43f89e: Dashboard: the Property Management and Security dashboards show a **Low Stock** tile (inventory items at or below their alert level) wherever their own inventory store serves the property; it can be hidden in Customize. Sites without a store are unchanged. Five tiles share one row.
+
+## 4.59.3
+
+### Patch Changes
+
+- cae7fd1: Robot live view: turn on hls.js low-latency mode so the 1.2x catch-up actually runs after a hiccup (without it hls.js never changes the playback rate).
+- 40b1293: Robot live view: sit 6 s behind the newest picture instead of hls.js's default 12 s, catch up at up to 1.2x after a hiccup, jump forward past 14 s.
+
 ## 4.59.2
 
 ### Patch Changes
@@ -1648,11 +1661,11 @@
   `utils/console-tier.ts` + `composables/useConsoleTier.ts` mirror the server's
   own rule from two endpoints the console already calls, unprojected:
 
-                                                                                                                                                                                                                                                                GET /api/members/user/:user/app/admin    the Seven365 staff membership
-                                                                                                                                                                                                                                                                GET /api/roles/id/:role                  that membership's role document
+                                                                                                                                                                                                                                                                    GET /api/members/user/:user/app/admin    the Seven365 staff membership
+                                                                                                                                                                                                                                                                    GET /api/roles/id/:role                  that membership's role document
 
-                                                                                                                                                                                                                                                                owner  = member.type === "admin" && role.type === "admin" && role.default === true
-                                                                                                                                                                                                                                                                staff  = member.type === "admin" && role.type === "admin"
+                                                                                                                                                                                                                                                                    owner  = member.type === "admin" && role.type === "admin" && role.default === true
+                                                                                                                                                                                                                                                                    staff  = member.type === "admin" && role.type === "admin"
 
   `role.default` is the marker because it is the only property of a platform
   staff role no API caller can set - `role.controller.ts` validates create and

package/components/DashboardMain.vue

@@ -1417,6 +1417,13 @@ const propertyWidgetPermissions: Record<string, string[]> = {
   workOrderStatus: WORK_ORDER_SEE_ALL,
   feedbacks: ["feedbacks:see-all-feedback"],
   activePatrol: ["virtual-patrol:see-all-virtual-patrol-logs"],
+  // Low Stock: shown only where the property's own inventory store serves the site.
+  supplyAlert: [
+    "inventory:view-inventory",
+    "inventory:request-stock",
+    "inventory:approve-requests",
+    "inventory:manage-inventory",
+  ],
 };
 
 const moduleWidgetPermissions: Record<string, string[]> = {
@@ -2039,6 +2046,7 @@ const propertyDefaultWidgetKeys = [
   "incidents",
   "visitors",
   "facilityBookings",
+  "supplyAlert",
   "activity",
   "upcomingEvents",
   "todayReminders",
@@ -2052,6 +2060,7 @@ const securityDefaultWidgetKeys = [
   "incidents",
   "visitors",
   "patrolCompliance",
+  "supplyAlert",
   "activity",
   "activePatrol",
   "staffStatus",
@@ -2136,6 +2145,11 @@ const customizeWidgets = computed(() => {
         title: "Facility Bookings",
         description: "View booking volume and approvals waiting for action.",
       },
+      {
+        key: "supplyAlert",
+        title: "Low Stock",
+        description: "Inventory items at or below their alert level (where your store serves this property).",
+      },
       {
         key: "activity",
         title: "This Week Activity (Line Chart)",
@@ -2193,6 +2207,11 @@ const customizeWidgets = computed(() => {
         title: "Patrol Compliance",
         description: "View missed checkpoints and ongoing patrols.",
       },
+      {
+        key: "supplyAlert",
+        title: "Low Stock",
+        description: "Inventory items at or below their alert level (where your store serves this property).",
+      },
       {
         key: "activity",
         title: "This Week Activity (Line Chart)",
@@ -2405,6 +2424,31 @@ function getPropertyKpiCards() {
       raw: facilityMetric,
       filter: undefined,
     },
+    ...inventoryLowStockCards(),
+  ];
+}
+
+/**
+ * The Low Stock tile on the Property and Security dashboards. The server sends
+ * `supplyAlert` (basis `below-alert-level`) only where this organisation's own
+ * inventory store serves the site, so a site without a store shows no tile.
+ */
+function inventoryLowStockCards() {
+  const metric = getMetric(["supplyAlert"]);
+  if ((metric as { basis?: string })?.basis !== "below-alert-level") return [];
+  return [
+    {
+      key: "supplyAlert",
+      title: "Low Stock",
+      icon: "mdi-package-variant",
+      color: KPI_TONES.info.color,
+      tint: KPI_TONES.info.tint,
+      value: "",
+      percentage: NaN,
+      meta: "",
+      raw: metric,
+      filter: undefined,
+    },
   ];
 }
 
@@ -2485,6 +2529,7 @@ function getSecurityKpiCards() {
       raw: patrolMetric,
       filter: undefined,
     },
+    ...inventoryLowStockCards(),
   ];
 }
 
@@ -2539,6 +2584,8 @@ const visibleKpiCards = computed(() =>
 // had been. Fewer tiles share the row instead.
 const kpiColLg = computed(() => {
   const shown = visibleKpiCards.value.length;
+  // Five tiles (Property / Security with Low Stock): equal widths on one row.
+  if (shown === 5) return true;
   return shown >= 4 || shown === 0 ? 3 : 12 / shown;
 });
 

package/package.json

@@ -2,7 +2,7 @@
   "name": "@7365admin1/layer-common",
   "license": "MIT",
   "type": "module",
-  "version": "4.59.2",
+  "version": "4.60.0",
   "author": "7365admin1",
   "main": "./nuxt.config.ts",
   "//files": "What a consumer extending this layer actually loads. Without this npm ships the whole working tree - the changesets, the CI workflows, the render harness in tools/ and any scratch directory that happened to exist at publish time. Nuxt resolves a layer by directory, so every runtime directory below has to stay listed; adding a new top-level runtime directory means adding it here too.",

package/utils/robot-control.ts

@@ -180,6 +180,27 @@ export function writeLivePref(storage: Pick<Storage, "setItem"> | undefined, on:
 /** hls.js errors that mean "this browser cannot decode the codec", not "the camera is down". */
 const CODEC_ERRORS = new Set(["manifestIncompatibleCodecsError", "bufferAddCodecError", "bufferIncompatibleCodecsError"]);
 
+/**
+ * hls.js live settings. The robot camera (EZVIZ via PadBot) serves plain HLS
+ * v3: 4 s segments, a 3-segment window, no LL-HLS parts. hls.js's default
+ * sits 3 segments (12 s) behind the newest picture and never catches up after
+ * a hiccup - the owner's "10-15 s delay". Now: 6 s behind (1.5 segments, so
+ * one late segment does not stall), play up to 1.2x to win back time lost to
+ * a hiccup, and jump forward if it ever falls 14 s behind.
+ * `lowLatencyMode` must be on for the catch-up: hls.js only adjusts the
+ * playback rate in low-latency mode (it is harmless on a plain playlist - no
+ * parts, nothing else changes).
+ * ponytail: a lower-latency protocol (FLV / WebRTC) is not offered by PadBot's
+ * §6.5 video API; ask PadBot if 6 s is still too slow.
+ */
+export const LIVE_HLS_CONFIG = {
+  enableWorker: true,
+  lowLatencyMode: true,
+  liveSyncDuration: 6,
+  liveMaxLatencyDuration: 14,
+  maxLiveSyncPlaybackRate: 1.2,
+} as const;
+
 /**
  * Plays one live-view URL into `video`. Returns a stop function that frees the
  * player and the connection.
@@ -286,7 +307,7 @@ export function startLivePlayer(
         video.addEventListener("error", noteDecode);
         let recoveries = 0;
         const Base = Hls.DefaultConfig?.loader;
-        const h = (hls = new Hls({ enableWorker: true, lowLatencyMode: false, ...(Base ? { fLoader: strayAudLoader(Base) } : {}) }));
+        const h = (hls = new Hls({ ...LIVE_HLS_CONFIG, ...(Base ? { fLoader: strayAudLoader(Base) } : {}) }));
         h.on("hlsError", (_e, data) => {
           noteDecode();
           if (!data.fatal) return;