@7365admin1/layer-common 4.57.2 → 4.57.3

package/CHANGELOG.md

@@ -1,5 +1,11 @@
 # @iservice365/layer-common
 
+## 4.57.3
+
+### Patch Changes
+
+- c23d427: Robot live view: the PadBot S2's EZVIZ camera puts an H.264 access-unit delimiter in front of every H.265 frame, which made Chrome refuse every frame (decode error, black picture). The player now neutralises those units in each segment before playback, so the picture shows. The "couldn't be decoded" message no longer blames EZVIZ encryption (disproved).
+
 ## 4.57.2
 
 ### Patch Changes
@@ -1605,11 +1611,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.57.2",
+  "version": "4.57.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

@@ -38,11 +38,12 @@ export const LIVE_NO_PICTURE =
 export const LIVE_DOWN = "The robot's camera isn't available right now.";
 /**
  * The decoder says it supports the codec but the frames still won't decode
- * (MEDIA_ERR_DECODE). Seen on the PadBot S2 (EZVIZ H3): EZVIZ device video
- * encryption scrambles the frames, so plain HLS can't show them. It's not the browser.
+ * (MEDIA_ERR_DECODE). On the PadBot S2 (EZVIZ H3) that was the stray H.264
+ * delimiters `neutraliseStrayAud` now removes (NOT encryption - disproved
+ * 2026-09-26 by a software decode of the real stream); kept for anything else.
  */
 export const LIVE_UNDECODABLE =
-  "The robot's camera video couldn't be decoded. This usually means video encryption is switched on in the camera's EZVIZ app. Ask the administrator to turn it off, or contact PadBot.";
+  "The robot's camera video couldn't be decoded. Press Retry. If it keeps happening, contact Seven365 support.";
 const MEDIA_ERR_DECODE = 3;
 
 /** Wait before automatic reconnect attempt n (0-based): 2 s, 4 s, 8 s, 16 s, then 30 s. */
@@ -58,7 +59,62 @@ type THls = {
   swapAudioCodec(): void;
   destroy(): void;
 };
-export type THlsCtor = { isSupported(): boolean; new (config?: Record<string, unknown>): THls };
+export type THlsCtor = { isSupported(): boolean; new (config?: Record<string, unknown>): THls; DefaultConfig?: { loader?: any } };
+
+/**
+ * The EZVIZ camera on the PadBot S2 puts an H.264 access-unit delimiter
+ * (00 00 01 09 xx) in front of every H.265 frame. Read as H.265 that is a
+ * "TSA_N" slice with temporal id 0 - invalid. ffmpeg skips it; hls.js packs it
+ * into the frame and Chrome's decoder then refuses every frame
+ * (PIPELINE_ERROR_DECODE, 0 frames). Proven on the real stream 2026-09-26:
+ * with these units removed Chrome's own decoder decodes 40/40 frames.
+ *
+ * Rewrites each such header in place, inside the TS packets of video PIDs
+ * only, to an "unspecified" H.265 unit (type 48) that hls.js and decoders
+ * ignore. Same length, so the TS stays intact. A valid single-layer H.265
+ * header never matches (its temporal id is never 0). Returns the count.
+ */
+export function neutraliseStrayAud(data: ArrayBuffer | Uint8Array): number {
+  const b = data instanceof Uint8Array ? data : new Uint8Array(data);
+  const video = new Set<number>();
+  let n = 0;
+  for (let i = 0; i + 188 <= b.length; i += 188) {
+    if (b[i] !== 0x47) continue;
+    const afc = (b[i + 3]! >> 4) & 3;
+    if (!(afc & 1)) continue;
+    const pid = ((b[i + 1]! & 0x1f) << 8) | b[i + 2]!;
+    let p = i + 4;
+    if (afc & 2) p += 1 + b[p]!;
+    // A PES start names its stream: 0xE0-0xEF = video.
+    if (b[i + 1]! & 0x40 && b[p] === 0 && b[p + 1] === 0 && b[p + 2] === 1 && (b[p + 3]! & 0xf0) === 0xe0) video.add(pid);
+    if (!video.has(pid)) continue;
+    for (let k = p; k + 4 < i + 188; k++) {
+      if (b[k] === 0 && b[k + 1] === 0 && b[k + 2] === 1 && b[k + 3] === 0x09 && (b[k + 4]! & 7) === 0) {
+        b[k + 3] = 0x60;
+        b[k + 4] = 0x01;
+        n++;
+        k += 4;
+      }
+    }
+  }
+  return n;
+}
+
+/** hls.js fragment loader that runs `neutraliseStrayAud` on every loaded segment. */
+function strayAudLoader(Base: any) {
+  return class extends Base {
+    load(context: any, config: any, callbacks: any) {
+      const ok = callbacks.onSuccess;
+      super.load(context, config, {
+        ...callbacks,
+        onSuccess: (response: any, ...rest: any[]) => {
+          if (response?.data instanceof ArrayBuffer) neutraliseStrayAud(response.data);
+          ok(response, ...rest);
+        },
+      });
+    }
+  };
+}
 
 /** The inline panel streams only while it is switched on, the robot is online, the tab is visible and the panel is near the screen. */
 export const liveViewActive = (s: { on: boolean; offline?: boolean; visible: boolean; inView: boolean }) =>
@@ -186,7 +242,8 @@ export function startLivePlayer(
         if (!Hls.isSupported()) return native();
         video.addEventListener("error", noteDecode);
         let recoveries = 0;
-        const h = (hls = new Hls({ enableWorker: true, lowLatencyMode: false }));
+        const Base = Hls.DefaultConfig?.loader;
+        const h = (hls = new Hls({ enableWorker: true, lowLatencyMode: false, ...(Base ? { fLoader: strayAudLoader(Base) } : {}) }));
         h.on("hlsError", (_e, data) => {
           noteDecode();
           if (!data.fatal) return;