@camstack/addon-pipeline 0.1.10 → 0.1.12

package/dist/stream-broker/index.js

@@ -22,13 +22,13 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
   mod
 ));
 Object.defineProperties(exports, { __esModule: { value: true }, [Symbol.toStringTag]: { value: "Module" } });
-const types = require("@camstack/types");
+const index = require("../index-BhOycEVH.js");
 const net = require("node:net");
 const crypto = require("node:crypto");
 const net$1 = require("net");
 const events = require("events");
-const promises = require("node:dns/promises");
 const node_child_process = require("node:child_process");
+const promises = require("node:dns/promises");
 const fs = require("node:fs");
 const path = require("node:path");
 const os = require("node:os");
@@ -201,7 +201,7 @@ const TARGET_CHUNK_MS = 500;
 const F32_BYTES = 4;
 const SESSION_NOT_FOUND_RE = /decode session\b.*\bnot found\b/;
 function isSessionGone(err) {
-  return SESSION_NOT_FOUND_RE.test(types.errMsg(err));
+  return SESSION_NOT_FOUND_RE.test(index.errMsg(err));
 }
 class AudioCodecSession {
   constructor(api, cfg, emit, logger) {
@@ -303,7 +303,7 @@ class AudioCodecSession {
         await this.api.closeSession({ sessionId: sid, ...nodeId ? { nodeId } : {} });
       } catch (err) {
         this.logger?.warn("audio-codec: closeSession failed", {
-          meta: { error: types.errMsg(err) }
+          meta: { error: index.errMsg(err) }
         });
       }
       this.sessionId = null;
@@ -339,7 +339,7 @@ class AudioCodecSession {
         return res.sessionId;
       } catch (err) {
         this.logger?.error("audio-codec: createDecodeSession failed", {
-          meta: { codec: this.cfg.codec, error: types.errMsg(err) }
+          meta: { codec: this.cfg.codec, error: index.errMsg(err) }
         });
         return null;
       } finally {
@@ -373,7 +373,7 @@ class AudioCodecSession {
         this.handleSessionGone(sid);
         return;
       }
-      this.warnThrottled("audio-codec: pullPcm failed", types.errMsg(err));
+      this.warnThrottled("audio-codec: pullPcm failed", index.errMsg(err));
     }
   }
   // ── Sample accumulator ──────────────────────────────────────────────────
@@ -450,7 +450,7 @@ class AudioCodecSession {
       this.handleSessionGone(sid);
       return;
     }
-    this.warnThrottled(label, types.errMsg(err));
+    this.warnThrottled(label, index.errMsg(err));
   }
   /**
    * Logs at most once per WARN_THROTTLE_MS per (label,detail) pair and
@@ -2212,8 +2212,8 @@ const AAC_SAMPLE_RATES = [
   8e3,
   7350
 ];
-function aacSamplingIndexToHz(index) {
-  return AAC_SAMPLE_RATES[index] ?? null;
+function aacSamplingIndexToHz(index2) {
+  return AAC_SAMPLE_RATES[index2] ?? null;
 }
 class StreamEndError extends Error {
   constructor(where) {
@@ -3430,7 +3430,7 @@ class StreamBroker {
    */
   sourceMetaForLog() {
     const src = this.source;
-    const url = src && src.type !== "placeholder" && src.type !== "push" && src.type !== "push-rtp" ? types.maskUrlCredentials(src.url ?? "") : "";
+    const url = src && src.type !== "placeholder" && src.type !== "push" && src.type !== "push-rtp" ? index.maskUrlCredentials(src.url ?? "") : "";
     return {
       brokerId: this.deviceId,
       sourceType: src?.type ?? "unknown",
@@ -3524,7 +3524,7 @@ class StreamBroker {
     this.logger?.info("Broker starting", {
       meta: {
         sourceType: source.type,
-        ...source.type !== "placeholder" ? { url: types.maskUrlCredentials(source.url) } : {},
+        ...source.type !== "placeholder" ? { url: index.maskUrlCredentials(source.url) } : {},
         ...this.detectedCodec ? { codec: this.detectedCodec } : {}
       }
     });
@@ -3671,7 +3671,7 @@ class StreamBroker {
     });
     this.decoderOutputFormat = needed;
     this.decoderProxy.updateConfig({ outputFormat: needed }).catch((err) => {
-      this.logger?.warn("decoder format upgrade failed", { meta: { error: types.errMsg(err) } });
+      this.logger?.warn("decoder format upgrade failed", { meta: { error: index.errMsg(err) } });
     });
   }
   /**
@@ -3723,7 +3723,7 @@ class StreamBroker {
       }).catch((err) => {
         subscriber.framesDropped++;
         this.logger?.warn("frame conversion failed", {
-          meta: { tag: subscriber.tag, target: subscriber.format, error: types.errMsg(err) }
+          meta: { tag: subscriber.tag, target: subscriber.format, error: index.errMsg(err) }
         });
       });
       return;
@@ -3737,7 +3737,7 @@ class StreamBroker {
     }).catch((err) => {
       subscriber.framesDropped++;
       this.logger?.warn("frame conversion failed", {
-        meta: { tag: subscriber.tag, target: subscriber.format, error: types.errMsg(err) }
+        meta: { tag: subscriber.tag, target: subscriber.format, error: index.errMsg(err) }
       });
     });
   }
@@ -3793,7 +3793,7 @@ class StreamBroker {
           this._suspended = false;
           this.logger?.info("demand detected — resuming stream");
           this.start(fresh).catch((err) => {
-            this.logger?.error("resume failed", { meta: { error: types.errMsg(err) } });
+            this.logger?.error("resume failed", { meta: { error: index.errMsg(err) } });
             this._suspended = true;
             this._status = "idle";
           });
@@ -3854,7 +3854,7 @@ class StreamBroker {
         this.audioCodecSession = null;
         void session.close().catch((err) => {
           this.logger?.warn("audio-codec: push session close failed", {
-            meta: { error: types.errMsg(err) }
+            meta: { error: index.errMsg(err) }
           });
         });
       }
@@ -3893,7 +3893,7 @@ class StreamBroker {
       this.audioCodecSession = null;
       void prior.close().catch((err) => {
         this.logger?.debug("audio-codec: prior session close failed", {
-          meta: { error: types.errMsg(err) }
+          meta: { error: index.errMsg(err) }
         });
       });
     }
@@ -3989,7 +3989,7 @@ class StreamBroker {
           });
         }
         this.decoderProxy.pushPacket(packet).catch((err) => {
-          this.logger?.warn("decoder push error", { meta: { error: types.errMsg(err) } });
+          this.logger?.warn("decoder push error", { meta: { error: index.errMsg(err) } });
         });
       }
     }
@@ -4073,7 +4073,7 @@ class StreamBroker {
         callback(this.sdpParameterSets);
       } catch (err) {
         this.logger?.warn("sdp param-set subscriber threw on initial delivery", {
-          meta: { error: types.errMsg(err) }
+          meta: { error: index.errMsg(err) }
         });
       }
     }
@@ -4090,7 +4090,7 @@ class StreamBroker {
         cb(ps);
       } catch (err) {
         this.logger?.warn("sdp param-set subscriber threw", {
-          meta: { error: types.errMsg(err) }
+          meta: { error: index.errMsg(err) }
         });
       }
     }
@@ -4154,7 +4154,7 @@ class StreamBroker {
         cb(rtpData);
       } catch (err) {
         this.logger?.warn("rtp video subscriber threw", {
-          meta: { error: types.errMsg(err) }
+          meta: { error: index.errMsg(err) }
         });
       }
     }
@@ -4362,7 +4362,7 @@ class StreamBroker {
    * backoff used by the RTSP path.
    */
   startRtmpReader(source) {
-    this.logger?.info("starting RTMP reader", { meta: { url: types.maskUrlCredentials(source.url) } });
+    this.logger?.info("starting RTMP reader", { meta: { url: index.maskUrlCredentials(source.url) } });
     this.destroyRtmpReader();
     const reader = new RtmpReader(source.url, this.logger?.child("rtmp"), {
       onVideoCodec: (codec) => {
@@ -4398,7 +4398,7 @@ class StreamBroker {
     reader.connect().catch((err) => {
       if (this.manualStop || this._suspended) return;
       this.logger?.warn("rtmp connect failed", {
-        meta: { error: types.errMsg(err), ...this.sourceMetaForLog() }
+        meta: { error: index.errMsg(err), ...this.sourceMetaForLog() }
       });
       this.destroyRtmpReader();
       this._status = "error";
@@ -4489,7 +4489,7 @@ class StreamBroker {
               cb(rtpData);
             } catch (err) {
               this.logger?.warn("rtp video subscriber threw", {
-                meta: { error: types.errMsg(err) }
+                meta: { error: index.errMsg(err) }
               });
             }
           }
@@ -4535,7 +4535,7 @@ class StreamBroker {
               this.audioCodecSession = null;
               void prior.close().catch((err) => {
                 this.logger?.debug("audio-codec: prior RTSP session close failed", {
-                  meta: { error: types.errMsg(err) }
+                  meta: { error: index.errMsg(err) }
                 });
               });
             }
@@ -4643,7 +4643,7 @@ class StreamBroker {
     client.connect().catch((err) => {
       if (this.manualStop || this._suspended) return;
       this.logger?.warn("native RTSP connect failed", {
-        meta: { error: types.errMsg(err), ...this.sourceMetaForLog() }
+        meta: { error: index.errMsg(err), ...this.sourceMetaForLog() }
       });
       this.destroyNativeClient();
       this._status = "error";
@@ -4967,7 +4967,7 @@ class StreamBroker {
       const codec = this.detectedCodec ?? this.source.videoCodec;
       if (codec) {
         this.createSharedDecoderSession(this.pendingDecodeOptions).catch((err) => {
-          this.logger?.warn("decoder session rebuild after rotation failed", { meta: { error: types.errMsg(err) } });
+          this.logger?.warn("decoder session rebuild after rotation failed", { meta: { error: index.errMsg(err) } });
         });
       }
     }
@@ -5066,7 +5066,7 @@ class StreamBroker {
     reader.connect().catch((err) => {
       if (this.manualStop || this._suspended) return;
       this.logger?.warn("rfc4571 connect failed", {
-        meta: { error: types.errMsg(err), ...this.sourceMetaForLog() }
+        meta: { error: index.errMsg(err), ...this.sourceMetaForLog() }
       });
       this.destroyRfc4571Reader();
       this._status = "error";
@@ -5097,7 +5097,7 @@ class StreamBroker {
       this.audioCodecSession = null;
       void session.close().catch((err) => {
         this.logger?.warn("audio-codec: session close failed", {
-          meta: { error: types.errMsg(err) }
+          meta: { error: index.errMsg(err) }
         });
       });
     }
@@ -5151,7 +5151,7 @@ class StreamBroker {
       this.fanoutDecodedFrame(frame);
     };
     proxy.startPolling(onFrame).catch((err) => {
-      this.logger?.warn("decoder polling error", { meta: { error: types.errMsg(err) } });
+      this.logger?.warn("decoder polling error", { meta: { error: index.errMsg(err) } });
     });
     const info = await this.decoderApi.getInfo();
     if (info.isPullMode) {
@@ -5163,7 +5163,7 @@ class StreamBroker {
           meta: { localUrl, codec }
         });
         proxy.openStream(inputUrl).catch((err) => {
-          this.logger?.error("Pull mode decoder failed", { meta: { error: types.errMsg(err) } });
+          this.logger?.error("Pull mode decoder failed", { meta: { error: index.errMsg(err) } });
         });
       };
       if (this.firstKeyframeReceived) {
@@ -5280,7 +5280,7 @@ class StreamBroker {
           extraData = hexToBytes(configHex);
         } catch (err) {
           this.logger?.warn("audio-codec: AudioSpecificConfig parse failed", {
-            meta: { configHex, error: types.errMsg(err) }
+            meta: { configHex, error: index.errMsg(err) }
           });
         }
       }
@@ -5816,9 +5816,308 @@ class RtspRestreamProviderImpl {
     }
   }
 }
+function normaliseCodec(codec) {
+  if (!codec) return null;
+  const c = codec.toLowerCase();
+  if (c === "h264" || c === "avc" || c === "avc1") return "H264";
+  if (c === "h265" || c === "hevc" || c === "hvc1" || c === "hev1") return "H265";
+  return null;
+}
+function pipelineKeyFor(deviceId, videoCodec, audioCodec, width, height) {
+  return `${deviceId}|v=${videoCodec}|a=${audioCodec}|${width}x${height}`;
+}
+function pickVideoEncoder(target, encoders) {
+  if (!encoders) return target === "H264" ? "libx264" : "libx265";
+  return target === "H264" ? encoders.defaultH264 : encoders.defaultH265;
+}
+function pickAudioEncoderArgs(audio) {
+  switch (audio) {
+    case "AAC":
+      return ["-c:a", "aac", "-b:a", "128k", "-ar", "48000", "-ac", "2"];
+    case "Opus":
+      return ["-c:a", "libopus", "-b:a", "64k", "-ar", "48000", "-ac", "2"];
+    case "PCMU":
+      return ["-c:a", "pcm_mulaw", "-ar", "8000", "-ac", "1"];
+    case "none":
+      return ["-an"];
+    default:
+      return ["-c:a", "aac", "-b:a", "128k"];
+  }
+}
+class TranscodePipelineManager {
+  entries = /* @__PURE__ */ new Map();
+  logger;
+  api;
+  cameraStreamLookup;
+  rtspEntryLookup;
+  localRtspPort;
+  releaseGraceMs;
+  ffmpegPath;
+  constructor(opts) {
+    this.logger = opts.logger;
+    this.api = opts.api;
+    this.cameraStreamLookup = opts.cameraStreamLookup;
+    this.rtspEntryLookup = opts.rtspEntryLookup;
+    this.localRtspPort = opts.localRtspPort;
+    this.releaseGraceMs = opts.releaseGraceMs ?? 5e3;
+    this.ffmpegPath = opts.ffmpegPath ?? "ffmpeg";
+  }
+  async acquire(input) {
+    const wantedVideo = input.videoCodec;
+    const wantedAudio = input.audioCodec ?? "AAC";
+    const direct = this.findDirectMatch(input.deviceId, wantedVideo, input.maxResolution);
+    if (direct) {
+      const key2 = pipelineKeyFor(
+        input.deviceId,
+        direct.videoCodec,
+        wantedAudio,
+        direct.resolution.width,
+        direct.resolution.height
+      );
+      return this.shareOrCreate(key2, () => ({
+        url: direct.url,
+        videoCodec: direct.videoCodec,
+        audioCodec: "passthrough",
+        resolution: direct.resolution,
+        transcoded: false,
+        encoder: "copy",
+        pipelineKey: key2
+      }), null);
+    }
+    const sourceStream = this.pickTranscodeSource(input.deviceId, input.maxResolution);
+    if (!sourceStream || !sourceStream.url) {
+      throw new Error(
+        `getStreamWithCodec: no source stream available for device ${input.deviceId}`
+      );
+    }
+    const targetCodec = wantedVideo === "auto" ? normaliseCodec(sourceStream.codec) ?? "H264" : wantedVideo;
+    const targetResolution = input.maxResolution ?? sourceStream.resolution ?? { width: 1280, height: 720 };
+    const key = pipelineKeyFor(
+      input.deviceId,
+      targetCodec,
+      wantedAudio,
+      targetResolution.width,
+      targetResolution.height
+    );
+    const existing = this.entries.get(key);
+    if (existing) {
+      return this.shareEntry(existing).source;
+    }
+    const encoders = await this.loadHardwareEncoders();
+    const encoder = pickVideoEncoder(targetCodec, encoders);
+    const dialableUrl = this.allocateLoopbackUrl(input.deviceId, key);
+    const child = this.spawnFfmpeg({
+      sourceUrl: sourceStream.url,
+      outputUrl: dialableUrl,
+      encoder,
+      targetCodec,
+      width: targetResolution.width,
+      height: targetResolution.height,
+      audio: wantedAudio,
+      tag: input.tag ?? `stream-with-codec:${input.deviceId}`
+    });
+    const source = {
+      url: dialableUrl,
+      videoCodec: targetCodec,
+      audioCodec: wantedAudio,
+      resolution: targetResolution,
+      transcoded: true,
+      encoder,
+      pipelineKey: key
+    };
+    const entry = { key, source, child, refcount: 1, releaseTimer: null };
+    this.entries.set(key, entry);
+    this.logger.info("Transcode pipeline started", {
+      meta: { key, encoder, sourceUrl: sourceStream.url, outputUrl: dialableUrl }
+    });
+    if (child) {
+      child.once("exit", (code, signal) => {
+        this.logger.info("Transcode pipeline exited", {
+          meta: { key, code, signal }
+        });
+        const cur = this.entries.get(key);
+        if (cur && cur.child === child) {
+          this.entries.delete(key);
+        }
+      });
+    }
+    return source;
+  }
+  release(pipelineKey) {
+    const entry = this.entries.get(pipelineKey);
+    if (!entry) return { released: false, refcount: 0 };
+    entry.refcount = Math.max(0, entry.refcount - 1);
+    if (entry.refcount > 0) {
+      return { released: true, refcount: entry.refcount };
+    }
+    if (entry.releaseTimer) {
+      clearTimeout(entry.releaseTimer);
+    }
+    entry.releaseTimer = setTimeout(() => {
+      const cur = this.entries.get(pipelineKey);
+      if (!cur || cur.refcount > 0) return;
+      this.shutdownEntry(cur);
+    }, this.releaseGraceMs);
+    return { released: true, refcount: 0 };
+  }
+  shutdownAll() {
+    for (const entry of this.entries.values()) {
+      this.shutdownEntry(entry);
+    }
+    this.entries.clear();
+  }
+  findDirectMatch(deviceId, wanted, maxRes) {
+    if (wanted === "auto") return null;
+    const streams = this.cameraStreamLookup(deviceId);
+    for (const s of streams) {
+      if (!s.url) continue;
+      const codec = normaliseCodec(s.codec);
+      if (codec !== wanted) continue;
+      if (maxRes && s.resolution) {
+        if (s.resolution.width > maxRes.width || s.resolution.height > maxRes.height) continue;
+      }
+      const resolution = s.resolution ?? { width: 1280, height: 720 };
+      return { url: s.url, videoCodec: codec, resolution };
+    }
+    return null;
+  }
+  pickTranscodeSource(deviceId, maxRes) {
+    const streams = this.cameraStreamLookup(deviceId);
+    if (streams.length === 0) return null;
+    if (!maxRes) return streams[0] ?? null;
+    let best = null;
+    let bestArea = -1;
+    for (const s of streams) {
+      if (!s.url) continue;
+      const w = s.resolution?.width ?? 1280;
+      const h = s.resolution?.height ?? 720;
+      if (w > maxRes.width || h > maxRes.height) continue;
+      const area = w * h;
+      if (area > bestArea) {
+        bestArea = area;
+        best = s;
+      }
+    }
+    if (best) return best;
+    let smallest = null;
+    let smallestArea = Number.MAX_SAFE_INTEGER;
+    for (const s of streams) {
+      if (!s.url) continue;
+      const w = s.resolution?.width ?? 1280;
+      const h = s.resolution?.height ?? 720;
+      const area = w * h;
+      if (area < smallestArea) {
+        smallestArea = area;
+        smallest = s;
+      }
+    }
+    return smallest;
+  }
+  allocateLoopbackUrl(deviceId, pipelineKey) {
+    const port = this.localRtspPort();
+    const token = `t-${deviceId}-${crypto.randomUUID().slice(0, 8)}`;
+    if (!port) {
+      return `rtsp://0.0.0.0:0/${token}`;
+    }
+    return `rtsp://127.0.0.1:${port}/${token}`;
+  }
+  async loadHardwareEncoders() {
+    if (!this.api) return null;
+    try {
+      const api = this.api;
+      const probe = api["platformProbe"];
+      if (!probe || typeof probe !== "object") return null;
+      const fn = probe["getHardwareEncoders"];
+      if (!fn || typeof fn !== "object") return null;
+      const query = fn["query"];
+      if (typeof query !== "function") return null;
+      const callable = query;
+      return await callable();
+    } catch (err) {
+      this.logger.warn("platformProbe.getHardwareEncoders failed — using software fallback", {
+        meta: { error: index.errMsg(err) }
+      });
+      return null;
+    }
+  }
+  spawnFfmpeg(opts) {
+    const args = [
+      "-hide_banner",
+      "-loglevel",
+      "warning",
+      "-rtsp_transport",
+      "tcp",
+      "-i",
+      opts.sourceUrl,
+      "-vf",
+      `scale=${opts.width}:${opts.height}`,
+      "-c:v",
+      opts.encoder,
+      ...pickAudioEncoderArgs(opts.audio),
+      "-f",
+      "rtsp",
+      "-rtsp_transport",
+      "tcp",
+      opts.outputUrl
+    ];
+    try {
+      const child = node_child_process.spawn(this.ffmpegPath, args, { stdio: ["ignore", "ignore", "pipe"] });
+      child.stderr?.setEncoding("utf8");
+      child.stderr?.on("data", (chunk) => {
+        this.logger.debug("ffmpeg", { meta: { tag: opts.tag, line: chunk.trim() } });
+      });
+      child.once("error", (err) => {
+        this.logger.error("ffmpeg spawn error", {
+          meta: { tag: opts.tag, error: index.errMsg(err) }
+        });
+      });
+      return child;
+    } catch (err) {
+      this.logger.error("Failed to spawn ffmpeg", {
+        meta: { tag: opts.tag, error: index.errMsg(err) }
+      });
+      return null;
+    }
+  }
+  shareEntry(entry) {
+    entry.refcount += 1;
+    if (entry.releaseTimer) {
+      clearTimeout(entry.releaseTimer);
+      entry.releaseTimer = null;
+    }
+    return entry;
+  }
+  shareOrCreate(key, factory, child) {
+    const existing = this.entries.get(key);
+    if (existing) {
+      this.shareEntry(existing);
+      return existing.source;
+    }
+    const source = factory();
+    const entry = { key, source, child, refcount: 1, releaseTimer: null };
+    this.entries.set(key, entry);
+    return source;
+  }
+  shutdownEntry(entry) {
+    if (entry.releaseTimer) {
+      clearTimeout(entry.releaseTimer);
+      entry.releaseTimer = null;
+    }
+    if (entry.child && !entry.child.killed) {
+      try {
+        entry.child.kill("SIGTERM");
+      } catch (err) {
+        this.logger.warn("ffmpeg kill error", {
+          meta: { key: entry.key, error: index.errMsg(err) }
+        });
+      }
+    }
+    this.entries.delete(entry.key);
+  }
+}
 const PUSH_KINDS = /* @__PURE__ */ new Set(["push-annexb"]);
 function findProfileForStream(map, camStreamId) {
-  for (const profile of types.CAM_PROFILE_ORDER) {
+  for (const profile of index.CAM_PROFILE_ORDER) {
     if (map[profile] === camStreamId) return profile;
   }
   return null;
@@ -5882,11 +6181,42 @@ class StreamBrokerManager {
   api = null;
   defaultPreBufferSec = 10;
   webrtcServer = null;
+  /**
+   * Transcode-pipeline manager — backs `getStreamWithCodec`. Lazily
+   * created on first acquire, lives until `destroyAll`.
+   */
+  transcodeManager = null;
   constructor(staticDecoders, logger) {
     this.staticDecoders = staticDecoders ?? [];
     this.logger = logger;
     this.rtspProvider = new RtspRestreamProviderImpl(this.rtspServer, logger.child("rtsp-restream"));
   }
+  /**
+   * Lazily create the transcode manager wired with closures rather than
+   * direct refs so it only sees the surface it needs.
+   */
+  getTranscodeManager() {
+    if (!this.transcodeManager) {
+      this.transcodeManager = new TranscodePipelineManager({
+        logger: this.logger.child("transcode"),
+        api: this.api,
+        cameraStreamLookup: (deviceId) => this.getCameraStreamsForDevice(deviceId),
+        rtspEntryLookup: (brokerId) => {
+          const entry = this.rtspProvider.getEntry(brokerId);
+          return entry ? { url: entry.url } : null;
+        },
+        localRtspPort: () => this.rtspProvider.getRtspPort()
+      });
+    }
+    return this.transcodeManager;
+  }
+  // ── Cap methods: getStreamWithCodec / releaseStreamWithCodec ─────────
+  async getStreamWithCodec(input) {
+    return this.getTranscodeManager().acquire(input);
+  }
+  async releaseStreamWithCodec(input) {
+    return this.getTranscodeManager().release(input.pipelineKey);
+  }
   // ── Decoder resolution ───────────────────────────────────────────────
   //
   // Routes every decoder call through `ctx.api.decoder.*` (tRPC). The
@@ -5988,7 +6318,7 @@ class StreamBrokerManager {
         const session = await provider.createSession(config);
         const sessionId = `dec-${++nextId}`;
         sessions.set(sessionId, session);
-        const buffer = new types.RingBuffer(FRAME_BUFFER_CAPACITY);
+        const buffer = new index.RingBuffer(FRAME_BUFFER_CAPACITY);
         frameBuffers.set(sessionId, buffer);
         const unsub = session.onFrame((frame) => {
           buffer.push(frame);
@@ -6069,7 +6399,7 @@ class StreamBrokerManager {
    * client-side and we get a typed payload.
    */
   subscribePlaceholderStateSources(bus) {
-    bus.subscribe({ category: types.EventCategory.BatteryOnStatusChanged }, (event) => {
+    bus.subscribe({ category: index.EventCategory.BatteryOnStatusChanged }, (event) => {
       const data = event.data;
       const deviceId = typeof data.deviceId === "number" ? data.deviceId : null;
       if (deviceId === null) return;
@@ -6082,8 +6412,8 @@ class StreamBrokerManager {
       if (deviceId === null) return;
       this.applyPlaceholderReasonToDevice(deviceId, reason);
     };
-    bus.subscribe({ category: types.EventCategory.DeviceOffline }, handlerForReason("offline"));
-    bus.subscribe({ category: types.EventCategory.DeviceDisabled }, handlerForReason("disabled"));
+    bus.subscribe({ category: index.EventCategory.DeviceOffline }, handlerForReason("offline"));
+    bus.subscribe({ category: index.EventCategory.DeviceDisabled }, handlerForReason("disabled"));
   }
   setWebrtcServer(server) {
     this.webrtcServer = server;
@@ -6180,7 +6510,7 @@ class StreamBrokerManager {
     if (!streamMap?.has(camStreamId)) return { success: true };
     const current = this.assignments.get(deviceId) ?? { map: {}, auto: true };
     let newMap = { ...current.map };
-    for (const profile of types.CAM_PROFILE_ORDER) {
+    for (const profile of index.CAM_PROFILE_ORDER) {
       if (newMap[profile] === camStreamId) delete newMap[profile];
     }
     if (current.auto) {
@@ -6321,7 +6651,7 @@ class StreamBrokerManager {
         rotated++;
       } catch (err) {
         this.logger.warn("decoder rotation failed", {
-          meta: { brokerId: broker.deviceId, agentNodeId, reason, error: types.errMsg(err) }
+          meta: { brokerId: broker.deviceId, agentNodeId, reason, error: index.errMsg(err) }
         });
       }
     }
@@ -6336,6 +6666,10 @@ class StreamBrokerManager {
       clearInterval(this.streamHealthTimer);
       this.streamHealthTimer = void 0;
     }
+    if (this.transcodeManager) {
+      this.transcodeManager.shutdownAll();
+      this.transcodeManager = null;
+    }
     const stopPromises = [...this.brokers.values()].map((broker) => broker.stop());
     await Promise.all(stopPromises);
     this.brokers.clear();
@@ -6513,7 +6847,7 @@ class StreamBrokerManager {
       return enabled ? perStream.seconds : 0;
     }
     if (override?.preBufferSecOverride !== void 0) return override.preBufferSecOverride;
-    if (this.deviceHasFeature(deviceId, types.DeviceFeature.BatteryOperated)) return 0;
+    if (this.deviceHasFeature(deviceId, index.DeviceFeature.BatteryOperated)) return 0;
     return addonDefault;
   }
   /**
@@ -6688,7 +7022,7 @@ class StreamBrokerManager {
     for (const [fieldKey, value] of Object.entries(input.patch)) {
       if (fieldKey.startsWith("streamProfile:")) {
         const profile = fieldKey.slice("streamProfile:".length);
-        if (!types.CAM_PROFILE_ORDER.includes(profile)) continue;
+        if (!index.CAM_PROFILE_ORDER.includes(profile)) continue;
         const newCamId = typeof value === "string" && value !== "" ? value : null;
         if (newCamId === null) {
           await this.unassignProfile({ deviceId, profile });
@@ -6829,7 +7163,7 @@ class StreamBrokerManager {
   }
   wouldChangeAutoMap(current, streams) {
     const computed = this.computeInitialAssignment(streams);
-    for (const p of types.CAM_PROFILE_ORDER) {
+    for (const p of index.CAM_PROFILE_ORDER) {
       if (current[p] !== computed[p]) return true;
     }
     return false;
@@ -6848,7 +7182,7 @@ class StreamBrokerManager {
     const oldPushConsumers = this.countPushConsumers(current.map, deviceId);
     const newPushConsumers = this.countPushConsumers(newMap, deviceId);
     let anyChange = false;
-    for (const profile of types.CAM_PROFILE_ORDER) {
+    for (const profile of index.CAM_PROFILE_ORDER) {
       if (current.map[profile] !== newMap[profile]) {
         anyChange = true;
         break;
@@ -6863,7 +7197,7 @@ class StreamBrokerManager {
     for (const [camId, nextCount] of newPushConsumers) {
       if ((oldPushConsumers.get(camId) ?? 0) === 0 && nextCount > 0) {
         let triggerProfile = "mid";
-        for (const p of types.CAM_PROFILE_ORDER) {
+        for (const p of index.CAM_PROFILE_ORDER) {
           if (newMap[p] === camId) {
             triggerProfile = p;
             break;
@@ -6882,7 +7216,7 @@ class StreamBrokerManager {
   countPushConsumers(map, deviceId) {
     const out = /* @__PURE__ */ new Map();
     const streamMap = this.cameraStreams.get(deviceId);
-    for (const profile of types.CAM_PROFILE_ORDER) {
+    for (const profile of index.CAM_PROFILE_ORDER) {
       const camId = map[profile];
       if (!camId) continue;
       const cam = streamMap?.get(camId);
@@ -6897,7 +7231,7 @@ class StreamBrokerManager {
   buildSourceFromCamStream(cam) {
     const label = cam.label ?? cam.camStreamId;
     const codec = cam.codec !== void 0 ? { videoCodec: cam.codec } : {};
-    const stall = cam.deviceFeatures.includes(types.DeviceFeature.BatteryOperated) ? { allowStall: true } : {};
+    const stall = cam.deviceFeatures.includes(index.DeviceFeature.BatteryOperated) ? { allowStall: true } : {};
     const passthroughMeta = cam.metadata ?? {};
     switch (cam.kind) {
       case "push-annexb":
@@ -7021,7 +7355,7 @@ class StreamBrokerManager {
         ]);
       } catch (err) {
         log.error("Failed to register with restreamer", {
-          meta: { restreamerId: restreamer.id, error: types.errMsg(err) }
+          meta: { restreamerId: restreamer.id, error: index.errMsg(err) }
         });
       }
     }
@@ -7036,7 +7370,7 @@ class StreamBrokerManager {
         await restreamer.unregisterDevice(deviceId);
       } catch (err) {
         log.error("Failed to unregister from restreamer", {
-          meta: { restreamerId: restreamer.id, error: types.errMsg(err) }
+          meta: { restreamerId: restreamer.id, error: index.errMsg(err) }
         });
       }
     }
@@ -7052,7 +7386,7 @@ class StreamBrokerManager {
     const assignment = this.assignments.get(deviceId) ?? { map: {} };
     const streamMap = this.cameraStreams.get(deviceId);
     const slots = [];
-    for (const profile of types.CAM_PROFILE_ORDER) {
+    for (const profile of index.CAM_PROFILE_ORDER) {
       const camId = assignment.map[profile] ?? null;
       const brokerId = camId ? brokerIdFor(deviceId, camId) : `${deviceId}/${profile}`;
       const broker = camId ? this.brokers.get(brokerId) : void 0;
@@ -7087,13 +7421,13 @@ class StreamBrokerManager {
     });
   }
   emitCamStreamDemand(deviceId, camStreamId, profile) {
-    this.emitCapEvent(types.EventCategory.StreamBrokerOnCamStreamDemand, deviceId, { deviceId, camStreamId, profile });
+    this.emitCapEvent(index.EventCategory.StreamBrokerOnCamStreamDemand, deviceId, { deviceId, camStreamId, profile });
   }
   emitCamStreamIdle(deviceId, camStreamId) {
-    this.emitCapEvent(types.EventCategory.StreamBrokerOnCamStreamIdle, deviceId, { deviceId, camStreamId });
+    this.emitCapEvent(index.EventCategory.StreamBrokerOnCamStreamIdle, deviceId, { deviceId, camStreamId });
   }
   emitRequestStreamSourceRefresh(deviceId, camStreamId, brokerId) {
-    this.emitCapEvent(types.EventCategory.StreamBrokerOnRequestStreamSourceRefresh, deviceId, {
+    this.emitCapEvent(index.EventCategory.StreamBrokerOnRequestStreamSourceRefresh, deviceId, {
       deviceId,
       camStreamId,
       brokerId
@@ -7480,7 +7814,7 @@ async function resolveMdnsCandidatesInSdp(sdp, logger, sessionTag) {
         logger.info("mDNS resolve succeeded", { meta: { sessionTag, host, address } });
         return [host, address];
       } catch (err) {
-        logger.warn("mDNS resolve failed", { meta: { sessionTag, host, error: types.errMsg(err) } });
+        logger.warn("mDNS resolve failed", { meta: { sessionTag, host, error: index.errMsg(err) } });
         return [host, null];
       }
     })
@@ -7525,18 +7859,18 @@ class JitterBuffer {
       return ret;
     const start = nextSequenceNumber(afterSequenceNumber);
     for (let i = 0; i < this.jitterSize; i++) {
-      const index = (start + i) % this.jitterSize;
-      const packet = this.pending[index];
+      const index2 = (start + i) % this.jitterSize;
+      const packet = this.pending[index2];
       if (!packet)
         continue;
       const { sequenceNumber } = packet.header;
       const sd = sequenceNumberDistance(this.lastSequenceNumber ?? sequenceNumber, sequenceNumber);
       if (sd <= 0) {
         this.console.log("jitter buffer purged packet:", sequenceNumber);
-        this.pending[index] = void 0;
+        this.pending[index2] = void 0;
         ret.push(packet);
       } else if (sd === 1) {
-        this.pending[index] = void 0;
+        this.pending[index2] = void 0;
         this.lastSequenceNumber = sequenceNumber;
         ret.push(packet);
       } else ;
@@ -7854,10 +8188,10 @@ class H265Repacketizer {
     this.pendingFU = void 0;
   }
   createRtpPackets(packet, nalus, ret, hadMarker = packet.header.marker) {
-    nalus.forEach((packetized, index) => {
-      if (index !== 0)
+    nalus.forEach((packetized, index2) => {
+      if (index2 !== 0)
         this.extraPackets++;
-      const marker = hadMarker && index === nalus.length - 1;
+      const marker = hadMarker && index2 === nalus.length - 1;
       ret.push(this.createPacket(packet, packetized, marker));
     });
   }
@@ -8249,7 +8583,7 @@ class AdaptiveSession {
             const payload = pkt.payload;
             if (payload?.length > 0) void cb(payload, "Opus");
           } catch (err) {
-            this.logger.error("Intercom error", { meta: { phase: "session", sessionId: this.sessionId, error: types.errMsg(err) } });
+            this.logger.error("Intercom error", { meta: { phase: "session", sessionId: this.sessionId, error: index.errMsg(err) } });
           }
         });
       });
@@ -8510,7 +8844,7 @@ class AdaptiveSession {
       srcPkt = werift.RtpPacket.deSerialize(rtpData);
     } catch (err) {
       this.logger.warn("H265 RTP deserialize failed", {
-        meta: { phase: "session", sessionId: this.sessionId, error: types.errMsg(err), len: rtpData.length }
+        meta: { phase: "session", sessionId: this.sessionId, error: index.errMsg(err), len: rtpData.length }
       });
       return;
     }
@@ -8524,7 +8858,7 @@ class AdaptiveSession {
       outPkts = rep.repacketize(srcPkt);
     } catch (err) {
       this.logger.warn("H265 repacketize failed", {
-        meta: { phase: "session", sessionId: this.sessionId, error: types.errMsg(err) }
+        meta: { phase: "session", sessionId: this.sessionId, error: index.errMsg(err) }
       });
       return;
     }
@@ -8539,7 +8873,7 @@ class AdaptiveSession {
           );
         } catch (e) {
           this.logger.warn("replaceRTP failed (non-fatal)", {
-            meta: { phase: "session", sessionId: this.sessionId, error: types.errMsg(e) }
+            meta: { phase: "session", sessionId: this.sessionId, error: index.errMsg(e) }
           });
         }
       }
@@ -8554,7 +8888,7 @@ class AdaptiveSession {
       } catch (err) {
         if (this.rtpPacketsSent <= 10) {
           this.logger.error("sendRtp (h265 forward) error", {
-            meta: { phase: "session", sessionId: this.sessionId, error: types.errMsg(err) }
+            meta: { phase: "session", sessionId: this.sessionId, error: index.errMsg(err) }
           });
         }
       }
@@ -8781,7 +9115,7 @@ class AdaptiveSession {
         }
       } catch (err) {
         if (!signal.aborted && !this.closed) {
-          this.logger.error("Feed error", { meta: { phase: "session", sessionId: this.sessionId, error: types.errMsg(err) } });
+          this.logger.error("Feed error", { meta: { phase: "session", sessionId: this.sessionId, error: index.errMsg(err) } });
         }
       } finally {
         if (!this.closed) {
@@ -8865,7 +9199,7 @@ class AdaptiveSession {
         }
       } catch (err) {
         if (!signal.aborted && !this.closed) {
-          this.logger.error("Transcode feed error", { meta: { sessionId: this.sessionId, error: types.errMsg(err) } });
+          this.logger.error("Transcode feed error", { meta: { sessionId: this.sessionId, error: index.errMsg(err) } });
         }
       } finally {
         if (!ff.stdin.destroyed) ff.stdin.end();
@@ -8908,7 +9242,7 @@ class AdaptiveSession {
             this.videoSender.replaceRTP(header, true);
           } catch (e) {
             this.logger.warn("replaceRTP failed (non-fatal)", {
-              meta: { phase: "session", sessionId: this.sessionId, error: types.errMsg(e) }
+              meta: { phase: "session", sessionId: this.sessionId, error: index.errMsg(e) }
             });
           }
         }
@@ -8939,7 +9273,7 @@ class AdaptiveSession {
       } catch (err) {
         if (this.rtpPacketsSent <= 10) {
           this.logger.error("sendRtp error", {
-            meta: { phase: "session", sessionId: this.sessionId, packetIndex: this.rtpPacketsSent, error: types.errMsg(err) }
+            meta: { phase: "session", sessionId: this.sessionId, packetIndex: this.rtpPacketsSent, error: index.errMsg(err) }
           });
         }
       }
@@ -9013,7 +9347,7 @@ class AdaptiveSession {
       const pkt = new werift.RtpPacket(header, data);
       this.audioSender.sendRtp(pkt);
     } catch (err) {
-      this.logger.debug("Audio write error", { meta: { phase: "session", sessionId: this.sessionId, error: types.errMsg(err) } });
+      this.logger.debug("Audio write error", { meta: { phase: "session", sessionId: this.sessionId, error: index.errMsg(err) } });
     }
   }
   // -----------------------------------------------------------------------
@@ -9157,6 +9491,73 @@ class BrokerWebrtcServer {
   }
   // ── Session lifecycle ───────────────────────────────────────────────
   async createSession(streamId, hints = {}, opts = {}) {
+    const setup = await this.setupSessionForBroker(streamId, hints, opts);
+    try {
+      const offer = await setup.session.createOffer();
+      setup.sessionLogger.info("WebRTC session created", {
+        meta: {
+          sessionId: setup.sessionId,
+          brokerId: setup.brokerId,
+          iceServers: setup.iceServerCount,
+          codec: setup.sessionCodec,
+          useH265Repacketizer: setup.useH265Repacketizer
+        }
+      });
+      return { sessionId: setup.sessionId, sdpOffer: offer.sdp };
+    } catch (err) {
+      this.cleanupSession(setup.sessionId);
+      await setup.session.close().catch(() => {
+      });
+      throw err;
+    }
+  }
+  /**
+   * WHEP-style client-offer signaling: caller has already constructed
+   * an SDP offer (Alexa / WHEP / mobile clients that do
+   * `createOffer()` locally) and posts it here. We build the same
+   * broker subscription + AdaptiveSession plumbing as `createSession`,
+   * then call `session.handleOffer(clientOffer)` to produce the
+   * server's SDP answer.
+   *
+   * The session lifecycle is identical to `createSession` — broker
+   * unsubscribe and `closeSession(sessionId)` still apply — so the
+   * RTC controller / Alexa handler closes the session the same way.
+   */
+  async handleOffer(streamId, clientOfferSdp, hints = {}, opts = {}) {
+    const setup = await this.setupSessionForBroker(streamId, hints, opts);
+    try {
+      const answer = await setup.session.handleOffer({ sdp: clientOfferSdp, type: "offer" });
+      setup.sessionLogger.info("WebRTC session created (client-offer)", {
+        meta: {
+          sessionId: setup.sessionId,
+          brokerId: setup.brokerId,
+          iceServers: setup.iceServerCount,
+          codec: setup.sessionCodec,
+          useH265Repacketizer: setup.useH265Repacketizer
+        }
+      });
+      return { sessionId: setup.sessionId, sdpAnswer: answer.sdp };
+    } catch (err) {
+      this.cleanupSession(setup.sessionId);
+      await setup.session.close().catch(() => {
+      });
+      throw err;
+    }
+  }
+  /**
+   * Shared session bring-up: resolve broker → subscribe to encoded
+   * data + RTP → flush pre-buffer → seed H.265 codec info → register
+   * the SessionEntry. Returns the `AdaptiveSession` ready for SDP
+   * negotiation (either `createOffer()` for the server-offer flow or
+   * `handleOffer(clientOffer)` for the WHEP / Alexa flow).
+   *
+   * The returned session has its `onClosed` hook already wired to
+   * cleanup, and the SessionEntry is already in `this.sessions` keyed
+   * by `sessionId` — callers MUST cleanup + close on negotiation
+   * failure (both `createSession` and `handleOffer` do this in their
+   * catch blocks).
+   */
+  async setupSessionForBroker(streamId, hints, opts) {
     if (this.stopped) throw new Error("Server stopped");
     const brokerId = this.resolveBrokerId(streamId, hints);
     const broker = this.brokers.get(brokerId);
@@ -9268,7 +9669,11 @@ class BrokerWebrtcServer {
         });
       }
     }
-    const sessionId = crypto.randomUUID();
+    const requestedSessionId = opts.sessionId;
+    if (requestedSessionId !== void 0 && this.sessions.has(requestedSessionId)) {
+      throw new Error(`Session id already in use: ${requestedSessionId}`);
+    }
+    const sessionId = requestedSessionId ?? crypto.randomUUID();
     const iceServers = await this.resolveIceServers();
     const session = new AdaptiveSession({
       sessionId,
@@ -9303,7 +9708,7 @@ class BrokerWebrtcServer {
             });
           } catch (err) {
             sessionLogger.warn("seedH265CodecInfoFromSdp threw", {
-              meta: { sessionId, error: types.errMsg(err) }
+              meta: { sessionId, error: index.errMsg(err) }
             });
           }
         });
@@ -9320,7 +9725,7 @@ class BrokerWebrtcServer {
           session.forwardSourceRtpVideo(rtpData);
         } catch (err) {
           sessionLogger.warn("forwardSourceRtpVideo threw", {
-            meta: { sessionId, error: types.errMsg(err) }
+            meta: { sessionId, error: index.errMsg(err) }
           });
         }
       });
@@ -9328,18 +9733,15 @@ class BrokerWebrtcServer {
     const entry = { session, brokerId, unsubBroker, unsubRtp, unsubSdpParams, closeSource };
     this.sessions.set(sessionId, entry);
     session.onClosed = () => this.cleanupSession(sessionId);
-    try {
-      const offer = await session.createOffer();
-      sessionLogger.info("WebRTC session created", {
-        meta: { sessionId, brokerId, iceServers: iceServers.length, codec: sessionCodec, useH265Repacketizer }
-      });
-      return { sessionId, sdpOffer: offer.sdp };
-    } catch (err) {
-      this.cleanupSession(sessionId);
-      await session.close().catch(() => {
-      });
-      throw err;
-    }
+    return {
+      sessionId,
+      session,
+      sessionLogger,
+      brokerId,
+      sessionCodec,
+      useH265Repacketizer,
+      iceServerCount: iceServers.length
+    };
   }
   async handleAnswer(sessionId, sdpAnswer) {
     const entry = this.sessions.get(sessionId);
@@ -9442,7 +9844,7 @@ class BrokerWebrtcServer {
       try {
         return await this.getIceServersFn();
       } catch (err) {
-        this.logger.warn("getIceServers failed", { meta: { error: types.errMsg(err) } });
+        this.logger.warn("getIceServers failed", { meta: { error: index.errMsg(err) } });
       }
     }
     return this.staticIceServers ?? [];
@@ -9620,6 +10022,15 @@ class WebrtcSessionProvider {
     const streamingDebug = typeof this.manager.isStreamingDebug === "function" ? this.manager.isStreamingDebug(input.deviceId) : false;
     return this.webrtcServer.createSession(streamId, input.hints, { streamingDebug });
   }
+  async handleOffer(input) {
+    const target = input.target ?? { kind: "adaptive" };
+    const streamId = this.resolveTargetToStreamId(input.deviceId, target);
+    const streamingDebug = typeof this.manager.isStreamingDebug === "function" ? this.manager.isStreamingDebug(input.deviceId) : false;
+    return this.webrtcServer.handleOffer(streamId, input.sdpOffer, void 0, {
+      streamingDebug,
+      sessionId: input.sessionId
+    });
+  }
   async handleAnswer(input) {
     await this.webrtcServer.handleAnswer(input.sessionId, input.sdpAnswer);
   }
@@ -9649,7 +10060,7 @@ function stableSnapshotKey(payload, dropKeys) {
   return JSON.stringify(strip(payload));
 }
 const BROKER_METRICS_HEARTBEAT_MS = 3e4;
-class StreamBrokerAddon extends types.BaseAddon {
+class StreamBrokerAddon extends index.BaseAddon {
   brokerManager = null;
   metricsSnapshotTimer = null;
   /**
@@ -9686,7 +10097,7 @@ class StreamBrokerAddon extends types.BaseAddon {
     const rtspProvider = this.brokerManager.getRtspRestreamProvider();
     try {
       const addonStore = await this.ctx.settings?.readAddonStore() ?? {};
-      const tokenData = types.asJsonObject(addonStore["rtspTokens"]);
+      const tokenData = index.asJsonObject(addonStore["rtspTokens"]);
       if (tokenData) {
         const tokens = /* @__PURE__ */ new Map();
         for (const [k, v] of Object.entries(tokenData)) {
@@ -9695,7 +10106,7 @@ class StreamBrokerAddon extends types.BaseAddon {
         this.brokerManager.loadPersistedTokens(tokens);
         this.ctx.logger.info("Loaded persisted RTSP tokens", { meta: { tokenCount: tokens.size } });
       }
-      const enabledData = types.asJsonObject(addonStore["rtspEnabled"]);
+      const enabledData = index.asJsonObject(addonStore["rtspEnabled"]);
       if (enabledData) {
         const states = /* @__PURE__ */ new Map();
         for (const [k, v] of Object.entries(enabledData)) {
@@ -9712,7 +10123,7 @@ class StreamBrokerAddon extends types.BaseAddon {
         obj[k] = v;
       }
       this.ctx.settings?.writeAddonStore({ rtspTokens: obj }).catch((err) => {
-        this.ctx.logger.warn("Failed to persist RTSP tokens", { meta: { error: types.errMsg(err) } });
+        this.ctx.logger.warn("Failed to persist RTSP tokens", { meta: { error: index.errMsg(err) } });
       });
     });
     rtspProvider.setEnabledPersister((states) => {
@@ -9721,18 +10132,18 @@ class StreamBrokerAddon extends types.BaseAddon {
         obj[k] = v;
       }
       this.ctx.settings?.writeAddonStore({ rtspEnabled: obj }).catch((err) => {
-        this.ctx.logger.warn("Failed to persist RTSP enabled states", { meta: { error: types.errMsg(err) } });
+        this.ctx.logger.warn("Failed to persist RTSP enabled states", { meta: { error: index.errMsg(err) } });
       });
     });
     try {
       const addonStore = await this.ctx.settings?.readAddonStore() ?? {};
-      const overrideData = types.asJsonObject(addonStore["deviceOverrides"]);
+      const overrideData = index.asJsonObject(addonStore["deviceOverrides"]);
       if (overrideData) {
         const overrides = /* @__PURE__ */ new Map();
         for (const [rawKey, raw] of Object.entries(overrideData)) {
           const numericKey = Number(rawKey);
           if (!Number.isFinite(numericKey) || !Number.isInteger(numericKey)) continue;
-          const o = types.asJsonObject(raw);
+          const o = index.asJsonObject(raw);
           if (!o) continue;
           const entry = {};
           if (typeof o["preBufferSecOverride"] === "number") {
@@ -9741,11 +10152,11 @@ class StreamBrokerAddon extends types.BaseAddon {
           if (typeof o["streamingDebug"] === "boolean") {
             entry["streamingDebug"] = o["streamingDebug"];
           }
-          const pbRaw = types.asJsonObject(o["preBuffer"]);
+          const pbRaw = index.asJsonObject(o["preBuffer"]);
           if (pbRaw) {
             const preBuffer = {};
             for (const [profile, v] of Object.entries(pbRaw)) {
-              const sv = types.asJsonObject(v);
+              const sv = index.asJsonObject(v);
               if (sv && typeof sv["seconds"] === "number") {
                 preBuffer[profile] = { enabled: sv["enabled"] !== false, seconds: sv["seconds"] };
               }
@@ -9769,20 +10180,20 @@ class StreamBrokerAddon extends types.BaseAddon {
         obj[`${deviceId}`] = entry;
       }
       this.ctx.settings?.writeAddonStore({ deviceOverrides: obj }).catch((err) => {
-        this.ctx.logger.warn("Failed to persist device overrides", { meta: { error: types.errMsg(err) } });
+        this.ctx.logger.warn("Failed to persist device overrides", { meta: { error: index.errMsg(err) } });
       });
     });
     try {
       const addonStore = await this.ctx.settings?.readAddonStore() ?? {};
-      const raw = types.asJsonObject(addonStore["profileMap"]);
+      const raw = index.asJsonObject(addonStore["profileMap"]);
       if (raw) {
         const loaded = /* @__PURE__ */ new Map();
         for (const [rawKey, rawVal] of Object.entries(raw)) {
           const deviceId = Number(rawKey);
           if (!Number.isFinite(deviceId) || !Number.isInteger(deviceId)) continue;
-          const val = types.asJsonObject(rawVal);
+          const val = index.asJsonObject(rawVal);
           if (!val) continue;
-          const mapObj = types.asJsonObject(val["map"]) ?? {};
+          const mapObj = index.asJsonObject(val["map"]) ?? {};
           const map = {};
           for (const profile of PROFILE_KEYS) {
             const v = mapObj[profile];
@@ -9802,13 +10213,13 @@ class StreamBrokerAddon extends types.BaseAddon {
         obj[`${deviceId}`] = { map: { ...assignment.map }, auto: assignment.auto };
       }
       this.ctx.settings?.writeAddonStore({ profileMap: obj }).catch((err) => {
-        this.ctx.logger.warn("Failed to persist profile map", { meta: { error: types.errMsg(err) } });
+        this.ctx.logger.warn("Failed to persist profile map", { meta: { error: index.errMsg(err) } });
       });
     };
     this.brokerManager.setProfileMapPersister(profileMapPersister);
     await this.brokerManager.startRtspServer(this.config.rtspPort);
     this.subscribe(
-      { category: types.EventCategory.PipelineAgentHwaccelChanged },
+      { category: index.EventCategory.PipelineAgentHwaccelChanged },
       (event) => {
         const { agentNodeId, reason } = event.data;
         if (typeof agentNodeId !== "string" || agentNodeId.length === 0) return;
@@ -9825,7 +10236,7 @@ class StreamBrokerAddon extends types.BaseAddon {
         }).catch((err) => {
           this.ctx.logger.warn("hwaccel-driven decoder rotation failed", {
             tags: { nodeId: agentNodeId },
-            meta: { error: types.errMsg(err) }
+            meta: { error: index.errMsg(err) }
           });
         });
       }
@@ -9846,7 +10257,7 @@ class StreamBrokerAddon extends types.BaseAddon {
         }).catch((err) => {
           this.ctx.logger.warn("decoder-down rotation failed", {
             tags: { nodeId },
-            meta: { error: types.errMsg(err) }
+            meta: { error: index.errMsg(err) }
           });
         });
       }
@@ -9903,20 +10314,20 @@ class StreamBrokerAddon extends types.BaseAddon {
     };
     this.ctx.logger.info("Stream broker manager initialized");
     const registrations = [
-      { capability: types.streamBrokerCapability, provider: this.brokerManager },
+      { capability: index.streamBrokerCapability, provider: this.brokerManager },
       {
-        capability: types.cameraStreamsCapability,
+        capability: index.cameraStreamsCapability,
         provider: cameraStreamsProvider,
         kind: "wrapper",
         defaultActive: true
       },
       {
-        capability: types.webrtcSessionCapability,
+        capability: index.webrtcSessionCapability,
         provider: webrtcSessionProvider,
         kind: "wrapper",
         defaultActive: true
       },
-      { capability: types.addonWidgetsSourceCapability, provider: widgetsProvider }
+      { capability: index.addonWidgetsSourceCapability, provider: widgetsProvider }
     ];
     return registrations;
   }
@@ -9957,8 +10368,8 @@ class StreamBrokerAddon extends types.BaseAddon {
       const heartbeatDue = !prev || timestamp - prev.emittedAt >= BROKER_METRICS_HEARTBEAT_MS;
       if (prev && prev.json === json && !heartbeatDue) continue;
       this.lastEmittedBrokerSnapshot.set(brokerId, { json, emittedAt: timestamp });
-      eventBus.emit(types.createEvent(
-        types.EventCategory.StreamBrokerMetricsSnapshot,
+      eventBus.emit(index.createEvent(
+        index.EventCategory.StreamBrokerMetricsSnapshot,
         { type: "device", id: deviceId, nodeId },
         { brokerId, deviceId, profile, nodeId, stats, timestamp }
       ));
@@ -10934,7 +11345,7 @@ class FrameServerImpl {
         for (const h of this.connectHandlers) h(connectionId);
       },
       (err) => {
-        const msg = types.errMsg(err);
+        const msg = index.errMsg(err);
         this.rejectPending(connectionId, `auth-failed:${msg}`);
       }
     );