@7365admin1/layer-common 4.59.2 → 4.59.3

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @iservice365/layer-common
 
+## 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 +1655,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/package.json

@@ -2,7 +2,7 @@
   "name": "@7365admin1/layer-common",
   "license": "MIT",
   "type": "module",
-  "version": "4.59.2",
+  "version": "4.59.3",
   "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;