@camstack/addon-pipeline 1.1.39 → 1.1.40

package/dist/stream-broker/index.mjs

@@ -1,18 +1,18 @@
 import { t as __require } from "../chunk-BdkLduGY.mjs";
-import { $ as discriminatedUnion, B as DeviceType, D as nodePin, F as webrtcSessionCapability, G as makeSourceBrokerId, H as createEvent, I as errMsg, L as BaseAddon, N as streamBrokerCapability, Q as boolean, R as CAM_PROFILE_ORDER, V as EventCategory, W as makeProfileBrokerId, X as _enum, Z as array, at as string, c as EncodeProfileSchema, d as RingBuffer, g as cameraStreamsCapability, it as record, nt as number, ot as union, p as addonWidgetsSourceCapability, q as parseProfileBrokerId, rt as object, tt as literal, w as maskUrlCredentials, z as DeviceFeature } from "../dist-DvvYzO58.mjs";
-import { n as DecoderSessionProxy, t as FrameHandlePlane } from "../frame-handle-plane-BFzoIfkd.mjs";
+import { $ as discriminatedUnion, B as DeviceType, D as nodePin, F as webrtcSessionCapability, G as makeSourceBrokerId, H as createEvent, I as errMsg, L as BaseAddon, N as streamBrokerCapability, Q as boolean, R as CAM_PROFILE_ORDER, V as EventCategory, W as makeProfileBrokerId, X as _enum, Z as array, at as string, c as EncodeProfileSchema, d as RingBuffer, g as cameraStreamsCapability, it as record, nt as number, ot as union, p as addonWidgetsSourceCapability, q as parseProfileBrokerId, rt as object, tt as literal, w as maskUrlCredentials, z as DeviceFeature } from "../dist-v6cKLmU3.mjs";
+import { n as DecoderSessionProxy, t as FrameHandlePlane } from "../frame-handle-plane-DKAXTtfn.mjs";
 import { t as createFileDataPlaneHandler } from "../model-download-service-C-IHWnXx-BPy6aoAx.mjs";
 import { createRequire } from "node:module";
 import * as crypto$1 from "node:crypto";
 import crypto, { createHash, randomBytes, randomUUID } from "node:crypto";
+import { spawn } from "node:child_process";
+import { pathToFileURL } from "node:url";
 import * as fs from "node:fs";
 import * as path$1 from "node:path";
 import path, { join } from "node:path";
 import * as os from "node:os";
 import { networkInterfaces, tmpdir } from "node:os";
-import { spawn } from "node:child_process";
 import { lookup } from "node:dns/promises";
-import { pathToFileURL } from "node:url";
 import * as net$1 from "node:net";
 import net from "node:net";
 import { Socket } from "net";
@@ -4748,6 +4748,14 @@ var RtspSession = class {
 	userAgent = null;
 	/** When true, this session receives video-only (no audio RTP). */
 	muted;
+	/**
+	* Latch for a `muted` (local-decoder loopback) session that has started
+	* dropping video packets on socket backlog. While set, every non-keyframe
+	* packet is dropped — even after the backlog clears — until the next keyframe
+	* access unit, so the decoder always resumes on a clean GOP boundary instead
+	* of mid-GOP with reference-broken (missing P-frame) packets.
+	*/
+	droppingUntilKeyframe = false;
 	constructor(socket, sdp, onClose, muted) {
 		this.socket = socket;
 		this.sdp = sdp;
@@ -4797,13 +4805,35 @@ var RtspSession = class {
 			bytesSent: this.bytesSent
 		};
 	}
-	/** Send a video RTP packet via TCP interleaved framing. */
-	sendRtp(packet) {
+	/**
+	* Send a video RTP packet via TCP interleaved framing.
+	*
+	* `prime` marks a packet from the current-GOP catch-up burst replayed on
+	* join — written unconditionally (bounded one-shot the local decoder drains
+	* fast; dropping mid-burst would break frame references). A prime burst
+	* starts at a keyframe by construction, so it also clears the
+	* `droppingUntilKeyframe` latch.
+	*
+	* `isKeyframe` marks a packet that begins a keyframe access unit — the clean
+	* GOP boundary at which a latched `muted` session resumes sending.
+	*/
+	sendRtp(packet, prime = false, isKeyframe = false) {
 		if (!this.playing || this.closed) return;
 		if (this.tracks.length === 0) return;
-		if (this.socket.writableLength > 2097152) {
-			this.close();
-			return;
+		if (prime) this.droppingUntilKeyframe = false;
+		else {
+			if (this.droppingUntilKeyframe) {
+				if (!isKeyframe) return;
+				this.droppingUntilKeyframe = false;
+			}
+			if (this.socket.writableLength > 2097152) {
+				if (this.muted) {
+					this.droppingUntilKeyframe = true;
+					return;
+				}
+				this.close();
+				return;
+			}
 		}
 		const channel = this.tracks[0].rtpChannel;
 		const frame = Buffer.allocUnsafe(4 + packet.data.length);
@@ -5528,6 +5558,16 @@ function appendAudioMediaBlock(videoSdp, audioBlock) {
 //#endregion
 //#region src/stream-broker/rtsp/rtsp-restreamer.ts
 /**
+* Max age (ms) of a prime burst a MUTED (local-decoder loopback) session will
+* accept. A muted decoder must anchor at the LIVE edge — a full-GOP catch-up
+* burst (2-3s old) makes libav base its pts 2-3s in the past and, with ~zero
+* decode headroom, it never drains that backlog. So a muted session only joins
+* off a burst already near live (span ≤ this); otherwise it is left pending to
+* begin at the next live keyframe. Non-muted sessions (viewer / recorder) still
+* get the full-GOP burst for an instant picture.
+*/
+var LIVE_EDGE_MAX_SPAN_MS = 500;
+/**
 * Per-broker RTSP restreamer.
 *
 * Operates in two modes:
@@ -5573,9 +5613,22 @@ var RtspRestreamer = class {
 	collectingKeyframeRtp = false;
 	logger = null;
 	_onSessionCountChanged = null;
+	/**
+	* Supplies the broker's current-GOP source-RTP snapshot (keyframe..now) so a
+	* joining decoder is primed with the WHOLE recent GOP as a burst and
+	* fast-forwards to the live edge — instead of a lone keyframe up to a GOP old
+	* followed by reference-broken live packets. Mirrors Scrypted's
+	* prebuffer/findSyncFrame. Returns [] until a keyframe is seen (falls back to
+	* the single cached keyframe AU).
+	*/
+	rtpPreBufferSupplier = null;
 	constructor(streamName) {
 		this.streamName = streamName;
 	}
+	/** Wire the broker's current-GOP RTP snapshot supplier (see field doc). */
+	setRtpPreBufferSupplier(supplier) {
+		this.rtpPreBufferSupplier = supplier;
+	}
 	/** True when using RTP passthrough (native client) instead of Annex-B re-packetization. */
 	get rtpPassthroughMode() {
 		return this._rtpPassthroughMode;
@@ -5661,9 +5714,8 @@ var RtspRestreamer = class {
 			total: this.sessions.size
 		} });
 		this._onSessionCountChanged?.();
-		if (this._rtpPassthroughMode) {
-			if (this.lastKeyframeRtpPackets.length > 0) setTimeout(() => this.servePendingSessionsRtp(), 0);
-		} else if (this.lastKeyframeNals.length > 0 && this.packetizer) setTimeout(() => this.servePendingSessions(), 0);
+		if (this._rtpPassthroughMode) setTimeout(() => this.servePendingSessionsRtp(), 0);
+		else if (this.lastKeyframeNals.length > 0 && this.packetizer) setTimeout(() => this.servePendingSessions(), 0);
 	}
 	/**
 	* Set the camera's SDP directly (from DESCRIBE response).
@@ -5695,6 +5747,7 @@ var RtspRestreamer = class {
 			data: rtpData,
 			marker: (rtpData[1] & 128) !== 0
 		};
+		const keyframeAuStart = (isKeyframe || isParameterSet) && !this.collectingKeyframeRtp;
 		if (isKeyframe || isParameterSet) {
 			if (!this.collectingKeyframeRtp) {
 				this.collectingKeyframeRtp = true;
@@ -5710,23 +5763,49 @@ var RtspRestreamer = class {
 		}
 		if (this.sessions.size === 0) return;
 		this.servePendingSessionsRtp();
+		if (keyframeAuStart) for (const session of this.sessions.values()) {
+			if (!session.isMuted() || !session.isPlaying()) continue;
+			this.pendingKeyframe.delete(session.getSessionId());
+		}
 		for (const session of this.sessions.values()) {
 			if (this.pendingKeyframe.has(session.getSessionId())) continue;
-			if (session.isPlaying()) session.sendRtp(rtpPacket);
+			if (session.isPlaying()) session.sendRtp(rtpPacket, false, isKeyframe || isParameterSet);
 		}
 	}
 	/** Send cached keyframe RTP packets to sessions that transitioned to PLAY. */
 	servePendingSessionsRtp() {
 		if (this.pendingKeyframe.size === 0) return;
-		if (this.lastKeyframeRtpPackets.length === 0) return;
+		const ringPackets = this.rtpPreBufferSupplier?.() ?? [];
+		const fromRing = ringPackets.length > 0;
+		const primePackets = fromRing ? ringPackets.map((data) => ({
+			data,
+			marker: (data[1] & 128) !== 0
+		})) : this.lastKeyframeRtpPackets;
+		if (primePackets.length === 0) return;
+		const firstTs = primePackets[0].data.readUInt32BE(4);
+		const spanMs = (primePackets[primePackets.length - 1].data.readUInt32BE(4) - firstTs | 0) / 90;
 		const ready = [];
 		for (const sessionId of this.pendingKeyframe) if (this.sessions.get(sessionId)?.isPlaying()) ready.push(sessionId);
 		if (ready.length === 0) return;
-		for (const rtpPacket of this.lastKeyframeRtpPackets) for (const sessionId of ready) {
+		const served = [];
+		for (const sessionId of ready) {
+			const session = this.sessions.get(sessionId);
+			if (!session) continue;
+			if (session.isMuted() && (!fromRing || spanMs > LIVE_EDGE_MAX_SPAN_MS)) continue;
+			served.push(sessionId);
+		}
+		if (served.length === 0) return;
+		this.logger?.info("restream prime (lat-probe)", { meta: {
+			source: fromRing ? "gop-burst" : "keyframe-only",
+			packets: primePackets.length,
+			spanMs: Math.round(spanMs),
+			clients: served.length
+		} });
+		for (const rtpPacket of primePackets) for (const sessionId of served) {
 			const session = this.sessions.get(sessionId);
-			if (session?.isPlaying()) session.sendRtp(rtpPacket);
+			if (session?.isPlaying()) session.sendRtp(rtpPacket, true);
 		}
-		for (const id of ready) this.pendingKeyframe.delete(id);
+		for (const id of served) this.pendingKeyframe.delete(id);
 	}
 	/**
 	* Push a raw audio RTP packet from the native RTSP client.
@@ -8636,6 +8715,38 @@ var AudioCodecSession = class {
 			sessionId: this.sessionId
 		};
 	}
+	/**
+	* Tear down the upstream decode session + 40ms poll loop WITHOUT
+	* permanently closing this handle. The broker calls this from its
+	* audio-consumer demand-gate: when audio consumers drop to zero the
+	* upstream decoder session and its poll loop are pure waste, so we
+	* release them. Unlike {@link close} this leaves the handle reusable —
+	* the next pushed packet re-creates the session lazily via
+	* `ensureSession()`. Safe to call repeatedly.
+	*/
+	async idle() {
+		if (this.closed) return;
+		if (this.creating) await this.creating;
+		if (this.closed) return;
+		if (this.pollTimer) {
+			clearInterval(this.pollTimer);
+			this.pollTimer = null;
+		}
+		if (!this.sessionId) return;
+		const sid = this.sessionId;
+		const nodeId = this.sessionNodeId ?? void 0;
+		this.sessionId = null;
+		this.sessionNodeId = null;
+		try {
+			await this.api.closeSession({
+				sessionId: sid,
+				...nodeId ? { nodeId } : {}
+			});
+		} catch (err) {
+			this.logger?.warn("audio-codec: idle closeSession failed", { meta: { error: errMsg(err) } });
+		}
+		this.logger?.info("audio-codec: decode session idled (no audio consumer)", { meta: { sessionId: sid } });
+	}
 	async close() {
 		if (this.closed) return;
 		this.closed = true;
@@ -8863,12 +8974,25 @@ var EncodedRingBuffer = class {
 	clear() {
 		this.packets.length = 0;
 	}
-	/** Remove packets older than maxDurationMs based on PTS. */
+	/**
+	* Remove packets older than maxDurationMs based on PTS.
+	*
+	* PTS here is the source RTP timestamp (90kHz → ms), which is NOT
+	* monotonic across the buffer's lifetime: an RTSP/rfc4571 redial re-bases
+	* it to a fresh random value (RFC 3550) and the 32-bit field wraps every
+	* ~13.25h. A purely `pts < cutoff` head-trim stalls forever whenever the
+	* newest packet's pts drops below the stale head's — the buffer then
+	* retains the entire pre-discontinuity history (an unbounded native-memory
+	* leak of full-bitrate AnnexB copies). So we also evict any head packet
+	* whose pts is GREATER than the newest packet's: it can only belong to a
+	* prior, higher-based epoch that the source has since jumped away from.
+	*/
 	evict() {
 		if (this.packets.length === 0) return;
-		const cutoff = this.packets[this.packets.length - 1].pts - this.maxDurationMs;
+		const newest = this.packets[this.packets.length - 1].pts;
+		const cutoff = newest - this.maxDurationMs;
 		let removeCount = 0;
-		while (removeCount < this.packets.length && this.packets[removeCount].pts < cutoff) removeCount++;
+		while (removeCount < this.packets.length && (this.packets[removeCount].pts < cutoff || this.packets[removeCount].pts > newest)) removeCount++;
 		if (removeCount > 0) this.packets.splice(0, removeCount);
 	}
 };
@@ -9148,6 +9272,14 @@ var INITIAL_RECONNECT_DELAY_MS = 1e3;
 var MAX_RECONNECT_DELAY_MS = 3e4;
 /** Grace period before suspending after last consumer leaves. */
 var SUSPEND_GRACE_MS = 5e3;
+/**
+* Grace window before an idle audio-codec decode session is torn down
+* after the last audio consumer detaches. Mirrors the frame-handle /
+* suspend occupancy-linger pattern: a brief gap between consumers (e.g.
+* a WebRTC renegotiation or an analyzer re-subscribe) must not thrash
+* the upstream decode session create/destroy.
+*/
+var AUDIO_CONSUMER_LINGER_MS = 5e3;
 /** Timeout for push-mode sources: if no packet arrives within this window, emit error placeholder. */
 var PUSH_STALL_TIMEOUT_MS = 15e3;
 var StreamBroker = class StreamBroker {
@@ -9223,6 +9355,12 @@ var StreamBroker = class StreamBroker {
 	pushRtpFlagDepacketizer = null;
 	audioRtpDecoder = null;
 	audioCodecSession = null;
+	/**
+	* Pending occupancy-linger teardown of {@link audioCodecSession} after
+	* the last audio consumer detached. Cancelled when a consumer returns
+	* within {@link AUDIO_CONSUMER_LINGER_MS}. See {@link reconcileAudioConsumer}.
+	*/
+	audioConsumerLingerTimer;
 	audioRtpSeen = 0;
 	/** Detected audio codec from RTSP DESCRIBE (e.g. 'PCMU', 'PCMA'). */
 	audioCodec = null;
@@ -9436,6 +9574,7 @@ var StreamBroker = class StreamBroker {
 		this.pipeServer = new StreamPipeServer(logger?.child("pipe-server"));
 		this.rtspRestreamer = new RtspRestreamer(deviceId);
 		if (logger) this.rtspRestreamer.setLogger(logger.child("rtsp"));
+		this.rtspRestreamer.setRtpPreBufferSupplier(() => this.getRtpPreBuffer());
 		this.preBuffer = new EncodedRingBuffer(StreamBroker.DEFAULT_PRE_BUFFER_SEC);
 		this.decoderSeedBuffer = new EncodedRingBuffer(StreamBroker.DECODER_SEED_BUFFER_SEC);
 		this.audioChunkPlane = new AudioChunkPlane(logger?.child("audio-chunk-plane"));
@@ -9684,11 +9823,54 @@ var StreamBroker = class StreamBroker {
 		return false;
 	}
 	/**
+	* True when at least one consumer needs DECODED audio. The audio-specific
+	* subset of {@link hasDemand} — deliberately excludes the video
+	* frame-handle plane so a video-only viewer never spins up the
+	* AAC/Opus decode chain. `encodedCallbacks` covers WebRTC (its G.711
+	* egress needs decoded PCM); `audioChunkPlane` covers the analyzer.
+	*/
+	hasAudioConsumer() {
+		return this.encodedCallbacks.size > 0 || this.audioChunkPlane.subscriberCount > 0;
+	}
+	/**
+	* Demand-gate the audio-codec decode session lifecycle. Called from
+	* every consumer add/remove edge (via {@link checkDemand}). While an
+	* audio consumer exists, cancel any pending linger-close. When
+	* consumers drop to zero, arm a short linger timer that tears the
+	* upstream decode session + 40ms poll loop down (via
+	* `AudioCodecSession.idle`) so a momentary gap between consumers
+	* doesn't thrash create/destroy. The next gated packet re-arms the
+	* session lazily through `ensureSession()`. No-op when no session is
+	* armed (native PCMU/PCMA cameras never build one).
+	*/
+	reconcileAudioConsumer() {
+		if (!this.audioCodecSession) return;
+		if (this.hasAudioConsumer()) {
+			if (this.audioConsumerLingerTimer) {
+				clearTimeout(this.audioConsumerLingerTimer);
+				this.audioConsumerLingerTimer = void 0;
+			}
+			return;
+		}
+		if (this.audioConsumerLingerTimer) return;
+		this.audioConsumerLingerTimer = setTimeout(() => {
+			this.audioConsumerLingerTimer = void 0;
+			if (this.hasAudioConsumer()) return;
+			const session = this.audioCodecSession;
+			if (!session) return;
+			session.idle().catch((err) => {
+				this.logger?.warn("audio-codec: idle teardown failed", { meta: { error: errMsg(err) } });
+			});
+		}, AUDIO_CONSUMER_LINGER_MS);
+		if (typeof this.audioConsumerLingerTimer.unref === "function") this.audioConsumerLingerTimer.unref();
+	}
+	/**
 	* Check demand and schedule suspend/resume. Called after every subscriber
 	* add/remove and after pre-buffer enable/disable.
 	*/
 	checkDemand() {
 		if (this.manualStop || this.stopping) return;
+		this.reconcileAudioConsumer();
 		if (this.hasDemand()) {
 			if (!this.demandActive) {
 				this.demandActive = true;
@@ -9834,7 +10016,7 @@ var StreamBroker = class StreamBroker {
 		if (packet.type === "audio" && this.source?.type === "push" && this.audioCodecSession) {
 			const codec = packet.codec.toLowerCase();
 			if (codec !== "pcmu" && codec !== "pcma") {
-				this.audioCodecSession.pushRawFrame(packet.data);
+				if (this.hasAudioConsumer()) this.audioCodecSession.pushRawFrame(packet.data);
 				return;
 			}
 		}
@@ -10275,7 +10457,8 @@ var StreamBroker = class StreamBroker {
 			logger: this.logger?.child("frame-handle-plane"),
 			resolveStreamInfo: () => this.resolveFrameHandleStreamInfo(),
 			localNodeId: this.localNodeId,
-			getSeedPackets: () => this.decoderSeedBuffer.getPackets()
+			getSeedPackets: () => this.decoderSeedBuffer.getPackets(),
+			isDebugEnabled: () => this.streamingDebug
 		});
 		return this.frameHandlePlane;
 	}
@@ -10357,6 +10540,17 @@ var StreamBroker = class StreamBroker {
 			subscribedAt: entry.subscribedAt,
 			packetsDelivered: entry.packetsDelivered
 		});
+		if (this._preBufferEnabled && encoded.length === 0) encoded.push({
+			id: "prebuffer-hold",
+			channel: "annexb",
+			attribution: {
+				kind: "warmup",
+				userAgent: "prebuffer",
+				media: "video"
+			},
+			subscribedAt: this.startedAt,
+			packetsDelivered: 0
+		});
 		return {
 			rtsp: this.rtspRestreamer.listSessionInfos(),
 			decoded: (this.frameHandlePlane?.listSubscribers() ?? []).map((s) => ({
@@ -10722,7 +10916,7 @@ var StreamBroker = class StreamBroker {
 					hasCodecSession: this.audioCodecSession !== null
 				} });
 				this.audioRtpDecoder?.processPacket(rtpData);
-				this.audioCodecSession?.processPacket(rtpData);
+				if (this.hasAudioConsumer()) this.audioCodecSession?.processPacket(rtpData);
 				if ((this.audioCodec === "PCMU" || this.audioCodec === "PCMA") && this.encodedCallbacks.size > 0 && rtpData.length > 12) {
 					const payload = rtpData.subarray(12);
 					if (payload.length > 0) {
@@ -11203,6 +11397,10 @@ var StreamBroker = class StreamBroker {
 			this.audioRtpDecoder.flush();
 			this.audioRtpDecoder = null;
 		}
+		if (this.audioConsumerLingerTimer) {
+			clearTimeout(this.audioConsumerLingerTimer);
+			this.audioConsumerLingerTimer = void 0;
+		}
 		if (this.audioCodecSession) {
 			const session = this.audioCodecSession;
 			this.audioCodecSession = null;
@@ -14253,6 +14451,11 @@ var StreamBrokerManager = class {
 			break;
 		}
 		this.assignments.set(deviceId, nextAssignment);
+		if (current.map.high !== newMap.high) for (const camStreamId of [current.map.high, newMap.high]) {
+			if (!camStreamId) continue;
+			const broker = this.brokers.get(brokerIdFor(deviceId, camStreamId));
+			if (broker) this.applyPreBufferConfig(broker, deviceId, camStreamId);
+		}
 		for (const [camId, prevCount] of oldPushConsumers) if ((newPushConsumers.get(camId) ?? 0) === 0 && prevCount > 0) this.emitCamStreamIdle(deviceId, camId);
 		for (const [camId, nextCount] of newPushConsumers) if ((oldPushConsumers.get(camId) ?? 0) === 0 && nextCount > 0) {
 			let triggerProfile = "mid";
@@ -14458,7 +14661,7 @@ var StreamBrokerManager = class {
 		broker.setRestreamers(this.restreamers);
 		broker.setRestreamUrlResolver(() => this.rtspProvider.getEntry(brokerId)?.mutedUrl ?? null);
 		broker.setFfmpegBinaryPath(this.ffmpegConfig.binaryPath);
-		this.applyPreBufferConfig(broker, deviceId, camStreamId, cam);
+		this.applyPreBufferConfig(broker, deviceId, camStreamId);
 		if (this.deviceOverrides.get(deviceId)?.streamingDebug) broker.setStreamingDebug(true);
 		broker.setSourceProvider(() => {
 			const latest = this.cameraStreams.get(deviceId)?.get(camStreamId);
@@ -14594,34 +14797,48 @@ var StreamBrokerManager = class {
 		};
 	}
 	/**
+	* Whether a stream is warmed BY DEFAULT (no explicit override): the device's
+	* `high` profile, on a non-battery camera. Single source of truth used by both
+	* the broker-config default (`applyPreBufferConfig`) and the settings-patch
+	* override synthesis (`defaultStreamPreBuffer`) so a seconds-only patch never
+	* silently disables the high-profile warm default.
+	*/
+	isDefaultWarm(deviceId, camStreamId) {
+		return findProfileForStream(this.assignments.get(deviceId)?.map ?? {}, camStreamId) === "high" && !this.deviceHasFeature(deviceId, DeviceFeature.BatteryOperated);
+	}
+	/**
 	* Default `StreamPreBuffer` for a brand-new override entry — mirrors
-	* the UI-side default in `getDeviceSettingsContribution`. Pre-buffer
-	* is OFF by default for every stream. Operators opt in per-stream
-	* via the device-settings sub-tabs; detection / recording paths
-	* pass `forceForDetection` to `getEffectivePreBufferSec` when they
-	* need a buffered window irrespective of the operator toggle.
+	* the effective broker default: `enabled` reflects the high-profile warm
+	* default (`isDefaultWarm`), so a seconds-only patch on a warm high stream
+	* inherits `enabled: true` instead of silently forcing it OFF. Operators
+	* still override explicitly per-stream via the device-settings sub-tabs;
+	* detection / recording paths pass `forceForDetection` to
+	* `getEffectivePreBufferSec` when they need a buffered window irrespective
+	* of the operator toggle.
 	*/
-	defaultStreamPreBuffer(_deviceId, _camStreamId) {
+	defaultStreamPreBuffer(deviceId, camStreamId) {
 		return {
-			enabled: false,
+			enabled: this.isDefaultWarm(deviceId, camStreamId),
 			seconds: this.defaultPreBufferSec
 		};
 	}
 	/**
 	* Apply the effective pre-buffer config to a fresh broker instance.
-	* Default behaviour is OFF for every cam stream — keeps RAM and the
-	* upstream reader idle until the operator opts in or a detection /
-	* recording subscriber attaches.
+	* Default behaviour: the HIGH profile stream is warm (see below);
+	* every other stream stays OFF — idle until the operator opts in or
+	* a detection / recording subscriber attaches. An explicit per-stream
+	* operator override always wins over both defaults.
 	*/
-	applyPreBufferConfig(broker, deviceId, camStreamId, _cam) {
+	applyPreBufferConfig(broker, deviceId, camStreamId) {
 		const perStream = this.deviceOverrides.get(deviceId)?.preBuffer?.[camStreamId];
 		if (perStream) {
 			broker.setPreBufferEnabled(perStream.enabled);
 			broker.setPreBufferDuration(perStream.enabled ? perStream.seconds : 0);
 			return;
 		}
-		broker.setPreBufferEnabled(false);
-		broker.setPreBufferDuration(0);
+		const defaultWarm = this.isDefaultWarm(deviceId, camStreamId);
+		broker.setPreBufferEnabled(defaultWarm);
+		broker.setPreBufferDuration(defaultWarm ? this.defaultPreBufferSec : 0);
 	}
 	async fanOutRegistration(deviceId, brokerId, cam, broker) {
 		const log = this.logger.withTags({
@@ -17406,6 +17623,15 @@ var BROKER_METRICS_HEARTBEAT_MS = 3e4;
 /** Throttle for persisting the per-stream probe map — bounds writes regardless
 *  of streaming churn while keeping the durable copy recent enough for restart. */
 var PROBE_SNAPSHOTS_PERSIST_INTERVAL_MS = 6e4;
+/**
+* Defensive timeout for the per-session `networkQuality.getDeviceStats` poll.
+* The stat is an OPTIONAL input to the adaptive downgrade ladder — never worth
+* blocking the loop for. When the hub-resident provider is transiently
+* undiscoverable the child's unowned-cap routing falls to the Moleculer
+* broker-fallback, whose discovery wait is ~30s; without this bound a single
+* poll would stall the adaptive loop for that long. On timeout we simply treat
+* the sample as absent (the RTCP Receiver-Report path drives the ladder anyway). */
+var NETWORK_QUALITY_STATS_TIMEOUT_MS = 2e3;
 var StreamBrokerAddon = class extends BaseAddon {
 	brokerManager = null;
 	/** ffmpeg binary path from the `ffmpeg` config section, mirrored here so the
@@ -17734,10 +17960,14 @@ var StreamBrokerAddon = class extends BaseAddon {
 				}
 			},
 			clientLossPct: async (deviceId) => {
+				const ctrl = new AbortController();
+				const timer = setTimeout(() => ctrl.abort(), NETWORK_QUALITY_STATS_TIMEOUT_MS);
 				try {
-					return (await this.ctx.api.networkQuality.getDeviceStats.query({ deviceId }))?.client?.packetLossPercent ?? null;
+					return (await this.ctx.api.networkQuality.getDeviceStats.query({ deviceId }, { signal: ctrl.signal }))?.client?.packetLossPercent ?? null;
 				} catch {
 					return null;
+				} finally {
+					clearTimeout(timer);
 				}
 			},
 			resolveTranscodeDecodeHwAccel: () => this.resolveTranscodeDecodeHwAccel(),

package/dist/stream-broker/remoteEntry.js

@@ -30,7 +30,7 @@ async function d(e) {
 	}
 }
 async function f() {
-	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-DezFy4Fu.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-6I7-nufj.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/dist/worker-protocol-BCfO8gUF.js

@@ -0,0 +1,67 @@
+//#region src/session-decode/worker-protocol.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function isFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+function isWorkerFrameFormat(value) {
+	return value === "rgb" || value === "gray";
+}
+function isWorkerCropRegion(value) {
+	return isRecord(value) && isFiniteNumber(value.left) && isFiniteNumber(value.top) && isFiniteNumber(value.width) && isFiniteNumber(value.height);
+}
+function isWorkerResizeTarget(value) {
+	return isRecord(value) && isFiniteNumber(value.width) && isFiniteNumber(value.height);
+}
+function isFrameImageOptions(value) {
+	if (!isRecord(value)) return false;
+	if (value.crop !== void 0 && !isWorkerCropRegion(value.crop)) return false;
+	if (value.resize !== void 0 && !isWorkerResizeTarget(value.resize)) return false;
+	if (value.format !== void 0 && !isWorkerFrameFormat(value.format)) return false;
+	return true;
+}
+function isVideoFrameSource(value) {
+	return isRecord(value) && typeof value.restreamUrl === "string" && isFiniteNumber(value.deviceId) && typeof value.codec === "string";
+}
+function isVideoFrameGenOptions(value) {
+	if (!isRecord(value)) return false;
+	if (value.fps !== void 0 && !isFiniteNumber(value.fps)) return false;
+	if (value.format !== void 0 && !isWorkerFrameFormat(value.format)) return false;
+	return true;
+}
+/** Discriminated-union guard for {@link WorkerRequest} — no `as` casts. */
+function isWorkerRequest(value) {
+	if (!isRecord(value)) return false;
+	switch (value.kind) {
+		case "start": return isVideoFrameSource(value.source) && isVideoFrameGenOptions(value.opts);
+		case "pull": return true;
+		case "toBuffer": return isFiniteNumber(value.frameId) && (value.opts === void 0 || isFrameImageOptions(value.opts));
+		case "stop": return true;
+		default: return false;
+	}
+}
+/** Discriminated-union guard for {@link WorkerReply} — no `as` casts. */
+function isWorkerReply(value) {
+	if (!isRecord(value)) return false;
+	switch (value.kind) {
+		case "frame": return isFiniteNumber(value.frameId) && isFiniteNumber(value.timestamp) && isFiniteNumber(value.width) && isFiniteNumber(value.height) && isWorkerFrameFormat(value.format);
+		case "buffer": return isFiniteNumber(value.frameId) && value.bytes instanceof Uint8Array;
+		case "ended": return true;
+		case "error": return typeof value.message === "string" && (value.frameId === void 0 || isFiniteNumber(value.frameId));
+		default: return false;
+	}
+}
+//#endregion
+Object.defineProperty(exports, "isWorkerReply", {
+	enumerable: true,
+	get: function() {
+		return isWorkerReply;
+	}
+});
+Object.defineProperty(exports, "isWorkerRequest", {
+	enumerable: true,
+	get: function() {
+		return isWorkerRequest;
+	}
+});

package/dist/worker-protocol-pk7qdYXt.mjs

@@ -0,0 +1,56 @@
+//#region src/session-decode/worker-protocol.ts
+function isRecord(value) {
+	return typeof value === "object" && value !== null;
+}
+function isFiniteNumber(value) {
+	return typeof value === "number" && Number.isFinite(value);
+}
+function isWorkerFrameFormat(value) {
+	return value === "rgb" || value === "gray";
+}
+function isWorkerCropRegion(value) {
+	return isRecord(value) && isFiniteNumber(value.left) && isFiniteNumber(value.top) && isFiniteNumber(value.width) && isFiniteNumber(value.height);
+}
+function isWorkerResizeTarget(value) {
+	return isRecord(value) && isFiniteNumber(value.width) && isFiniteNumber(value.height);
+}
+function isFrameImageOptions(value) {
+	if (!isRecord(value)) return false;
+	if (value.crop !== void 0 && !isWorkerCropRegion(value.crop)) return false;
+	if (value.resize !== void 0 && !isWorkerResizeTarget(value.resize)) return false;
+	if (value.format !== void 0 && !isWorkerFrameFormat(value.format)) return false;
+	return true;
+}
+function isVideoFrameSource(value) {
+	return isRecord(value) && typeof value.restreamUrl === "string" && isFiniteNumber(value.deviceId) && typeof value.codec === "string";
+}
+function isVideoFrameGenOptions(value) {
+	if (!isRecord(value)) return false;
+	if (value.fps !== void 0 && !isFiniteNumber(value.fps)) return false;
+	if (value.format !== void 0 && !isWorkerFrameFormat(value.format)) return false;
+	return true;
+}
+/** Discriminated-union guard for {@link WorkerRequest} — no `as` casts. */
+function isWorkerRequest(value) {
+	if (!isRecord(value)) return false;
+	switch (value.kind) {
+		case "start": return isVideoFrameSource(value.source) && isVideoFrameGenOptions(value.opts);
+		case "pull": return true;
+		case "toBuffer": return isFiniteNumber(value.frameId) && (value.opts === void 0 || isFrameImageOptions(value.opts));
+		case "stop": return true;
+		default: return false;
+	}
+}
+/** Discriminated-union guard for {@link WorkerReply} — no `as` casts. */
+function isWorkerReply(value) {
+	if (!isRecord(value)) return false;
+	switch (value.kind) {
+		case "frame": return isFiniteNumber(value.frameId) && isFiniteNumber(value.timestamp) && isFiniteNumber(value.width) && isFiniteNumber(value.height) && isWorkerFrameFormat(value.format);
+		case "buffer": return isFiniteNumber(value.frameId) && value.bytes instanceof Uint8Array;
+		case "ended": return true;
+		case "error": return typeof value.message === "string" && (value.frameId === void 0 || isFiniteNumber(value.frameId));
+		default: return false;
+	}
+}
+//#endregion
+export { isWorkerRequest as n, isWorkerReply as t };

package/embed-dist/assets/{MaskShapeCanvas-DI4BY7W2-Br2fqwe7.js → MaskShapeCanvas-DI4BY7W2-Cr_fCzY5.js}

@@ -1,4 +1,4 @@
-import{d as e,f as t,g as n,h as r,m as i,p as a}from"./index-CR367rYR.js";var o=n(t()),s=n(e(),1),c=Math.PI/180;function l(){return typeof window<`u`&&({}.toString.call(window)===`[object Window]`||{}.toString.call(window)===`[object global]`)}var u=typeof global<`u`?global:typeof window<`u`?window:typeof WorkerGlobalScope<`u`?self:{},d={_global:u,version:`10.3.0`,isBrowser:l(),isUnminified:/param/.test(function(e){}.toString()),dblClickWindow:400,getAngle(e){return d.angleDeg?e*c:e},enableTrace:!1,pointerEventsEnabled:!0,autoDrawEnabled:!0,hitOnDragEnabled:!1,capturePointerEventsEnabled:!1,_mouseListenClick:!1,_touchListenClick:!1,_pointerListenClick:!1,_mouseInDblClickWindow:!1,_touchInDblClickWindow:!1,_pointerInDblClickWindow:!1,_mouseDblClickPointerId:null,_touchDblClickPointerId:null,_pointerDblClickPointerId:null,_renderBackend:`web`,legacyTextRendering:!1,pixelRatio:typeof window<`u`&&window.devicePixelRatio||1,dragDistance:3,angleDeg:!0,showWarnings:!0,dragButtons:[0,1],isDragging(){return d.DD.isDragging},isTransforming(){return d.Transformer?.isTransforming()??!1},isDragReady(){return!!d.DD.node},releaseCanvasOnDestroy:!0,document:u.document,_injectGlobal(e){u.Konva!==void 0&&console.error(`Several Konva instances detected. It is not recommended to use multiple Konva instances in the same environment.`),u.Konva=e}},f=e=>{d[e.prototype.getClassName()]=e};d._injectGlobal(d);var p=`Konva.js unsupported environment.
+import{d as e,f as t,g as n,h as r,m as i,p as a}from"./index-jMj5PyJk.js";var o=n(t()),s=n(e(),1),c=Math.PI/180;function l(){return typeof window<`u`&&({}.toString.call(window)===`[object Window]`||{}.toString.call(window)===`[object global]`)}var u=typeof global<`u`?global:typeof window<`u`?window:typeof WorkerGlobalScope<`u`?self:{},d={_global:u,version:`10.3.0`,isBrowser:l(),isUnminified:/param/.test(function(e){}.toString()),dblClickWindow:400,getAngle(e){return d.angleDeg?e*c:e},enableTrace:!1,pointerEventsEnabled:!0,autoDrawEnabled:!0,hitOnDragEnabled:!1,capturePointerEventsEnabled:!1,_mouseListenClick:!1,_touchListenClick:!1,_pointerListenClick:!1,_mouseInDblClickWindow:!1,_touchInDblClickWindow:!1,_pointerInDblClickWindow:!1,_mouseDblClickPointerId:null,_touchDblClickPointerId:null,_pointerDblClickPointerId:null,_renderBackend:`web`,legacyTextRendering:!1,pixelRatio:typeof window<`u`&&window.devicePixelRatio||1,dragDistance:3,angleDeg:!0,showWarnings:!0,dragButtons:[0,1],isDragging(){return d.DD.isDragging},isTransforming(){return d.Transformer?.isTransforming()??!1},isDragReady(){return!!d.DD.node},releaseCanvasOnDestroy:!0,document:u.document,_injectGlobal(e){u.Konva!==void 0&&console.error(`Several Konva instances detected. It is not recommended to use multiple Konva instances in the same environment.`),u.Konva=e}},f=e=>{d[e.prototype.getClassName()]=e};d._injectGlobal(d);var p=`Konva.js unsupported environment.
 
 Looks like you are trying to use Konva.js in Node.js environment. because "document" object is undefined.