@camstack/addon-pipeline 1.1.22 → 1.1.23

package/dist/stream-broker/{_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-CLVitFM4.mjs → _virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-BVFAEkIB.mjs}

@@ -18,7 +18,7 @@ var e = {
 	},
 	"@camstack/types": {
 		name: "@camstack/types",
-		version: "1.1.17",
+		version: "1.1.18",
 		scope: ["default"],
 		loaded: !1,
 		from: "addon_stream_broker_widgets",

package/dist/stream-broker/{hostInit-B15D9Mjv.mjs → hostInit-DHej3Ep9.mjs}

@@ -36,7 +36,7 @@ async function r() {
 				}
 			},
 			"@camstack/types": {
-				version: "1.1.17",
+				version: "1.1.18",
 				scope: "default",
 				shareConfig: {
 					singleton: !0,

package/dist/stream-broker/index.js

@@ -8904,6 +8904,17 @@ var DEFAULT_HINT_FPS = 5;
 *  broker's 2s `inputFps` window so the two stats are comparable. */
 var DECODE_FPS_WINDOW_MS = 2e3;
 /**
+* Keep-warm grace before a decoder session with no subscribers is torn down.
+*
+* Subscribers flap on ~30s cadences (occupancy recheck bursts, detection
+* motion-gating watch↔active, onboard gray gating). Destroying the
+* ffmpeg/VAAPI decode session the instant the last subscriber leaves spawns +
+* destroys a full session every cycle — wasted setup/teardown. Chosen >30s so
+* consecutive bursts and watch↔active flips reuse the warm session, yet a
+* genuinely idle session still frees its ffmpeg within ~a minute.
+*/
+var SESSION_LINGER_MS = 45e3;
+/**
 * Owns the broker's shared-memory frame-handle subscriptions and the
 * per-format `frameSink: 'shm'` decoder sessions that feed them.
 */
@@ -9022,17 +9033,18 @@ var FrameHandlePlane = class {
 	* underlying decoder session is destroyed (and its shm segment unlinked
 	* by the decoder). Returns `true` when a known subscription was released.
 	*/
-	async unsubscribe(subscriptionId) {
+	async unsubscribe(subscriptionId, immediate = false) {
 		const subscription = this.subscriptions.get(subscriptionId);
 		if (!subscription) return false;
 		this.subscriptions.delete(subscriptionId);
 		const session = this.sessions.get(subscription.format);
 		if (session) {
 			session.subscriberIds.delete(subscriptionId);
-			if (session.subscriberIds.size === 0) {
+			if (session.subscriberIds.size === 0) if (immediate) {
+				this.clearLinger(session);
 				this.sessions.delete(subscription.format);
 				await this.destroySession(session);
-			}
+			} else this.scheduleLinger(session);
 		}
 		this.logger?.info("frame-handle subscription removed", { meta: {
 			subscriptionId,
@@ -9041,6 +9053,32 @@ var FrameHandlePlane = class {
 		return true;
 	}
 	/**
+	* Arm the keep-warm teardown timer for a session whose last subscriber just
+	* left. Clears any existing timer first (idempotent). On fire it re-checks
+	* `subscriberIds.size === 0` — a subscriber may have returned in the interim,
+	* in which case the timer is a no-op — and only then removes the session and
+	* destroys the decoder. The timer is `unref`'d so a lingering warm session
+	* never keeps the process alive.
+	*/
+	scheduleLinger(session) {
+		this.clearLinger(session);
+		const timer = setTimeout(() => {
+			session.lingerTimer = null;
+			if (session.subscriberIds.size > 0) return;
+			this.sessions.delete(session.format);
+			this.destroySession(session).catch(() => {});
+		}, SESSION_LINGER_MS);
+		timer.unref?.();
+		session.lingerTimer = timer;
+	}
+	/** Cancel a session's pending keep-warm teardown timer, if any. */
+	clearLinger(session) {
+		if (session.lingerTimer) {
+			clearTimeout(session.lingerTimer);
+			session.lingerTimer = null;
+		}
+	}
+	/**
 	* Forward a video `EncodedPacket` to every active shm decoder session.
 	* Push-mode decoders consume this; a pull-mode decoder ignores it (it
 	* reads its own pipe via `openStream`). Audio packets are not forwarded.
@@ -9162,7 +9200,7 @@ var FrameHandlePlane = class {
 	*/
 	async killByTag(tag) {
 		const victims = [...this.subscriptions.values()].filter((s) => s.tag === tag).map((s) => s.id);
-		for (const id of victims) await this.unsubscribe(id);
+		for (const id of victims) await this.unsubscribe(id, true);
 		return victims.length;
 	}
 	/** Tear down every subscription + decoder session. Idempotent. */
@@ -9190,6 +9228,7 @@ var FrameHandlePlane = class {
 	async ensureSession(format, subscriptionId) {
 		const existing = this.sessions.get(format);
 		if (existing) {
+			this.clearLinger(existing);
 			existing.subscriberIds.add(subscriptionId);
 			return;
 		}
@@ -9206,7 +9245,8 @@ var FrameHandlePlane = class {
 				format,
 				proxy: null,
 				nodeId: null,
-				subscriberIds
+				subscriberIds,
+				lingerTimer: null
 			};
 			if (await this.startSessionDecoder(session)) this.sessions.set(format, session);
 		})();
@@ -9299,6 +9339,7 @@ var FrameHandlePlane = class {
 	}
 	/** Destroy a decoder session, swallowing teardown errors. */
 	async destroySession(session) {
+		this.clearLinger(session);
 		const proxy = session.proxy;
 		session.proxy = null;
 		session.nodeId = null;
@@ -10579,12 +10620,12 @@ var StreamBroker = class StreamBroker {
 	async subscribeFrameHandles(input) {
 		const plane = this.ensureFrameHandlePlane();
 		if (!plane) throw new Error("stream-broker: no decoder available for frame-handle subscription");
-		this.checkDemand();
 		const { subscriptionId, maxFps } = await plane.subscribe({
 			format: input.format,
 			maxFps: input.maxFps,
 			tag: input.tag
 		});
+		this.checkDemand();
 		return {
 			subscriptionId,
 			maxFps

package/dist/stream-broker/index.mjs

@@ -8900,6 +8900,17 @@ var DEFAULT_HINT_FPS = 5;
 *  broker's 2s `inputFps` window so the two stats are comparable. */
 var DECODE_FPS_WINDOW_MS = 2e3;
 /**
+* Keep-warm grace before a decoder session with no subscribers is torn down.
+*
+* Subscribers flap on ~30s cadences (occupancy recheck bursts, detection
+* motion-gating watch↔active, onboard gray gating). Destroying the
+* ffmpeg/VAAPI decode session the instant the last subscriber leaves spawns +
+* destroys a full session every cycle — wasted setup/teardown. Chosen >30s so
+* consecutive bursts and watch↔active flips reuse the warm session, yet a
+* genuinely idle session still frees its ffmpeg within ~a minute.
+*/
+var SESSION_LINGER_MS = 45e3;
+/**
 * Owns the broker's shared-memory frame-handle subscriptions and the
 * per-format `frameSink: 'shm'` decoder sessions that feed them.
 */
@@ -9018,17 +9029,18 @@ var FrameHandlePlane = class {
 	* underlying decoder session is destroyed (and its shm segment unlinked
 	* by the decoder). Returns `true` when a known subscription was released.
 	*/
-	async unsubscribe(subscriptionId) {
+	async unsubscribe(subscriptionId, immediate = false) {
 		const subscription = this.subscriptions.get(subscriptionId);
 		if (!subscription) return false;
 		this.subscriptions.delete(subscriptionId);
 		const session = this.sessions.get(subscription.format);
 		if (session) {
 			session.subscriberIds.delete(subscriptionId);
-			if (session.subscriberIds.size === 0) {
+			if (session.subscriberIds.size === 0) if (immediate) {
+				this.clearLinger(session);
 				this.sessions.delete(subscription.format);
 				await this.destroySession(session);
-			}
+			} else this.scheduleLinger(session);
 		}
 		this.logger?.info("frame-handle subscription removed", { meta: {
 			subscriptionId,
@@ -9037,6 +9049,32 @@ var FrameHandlePlane = class {
 		return true;
 	}
 	/**
+	* Arm the keep-warm teardown timer for a session whose last subscriber just
+	* left. Clears any existing timer first (idempotent). On fire it re-checks
+	* `subscriberIds.size === 0` — a subscriber may have returned in the interim,
+	* in which case the timer is a no-op — and only then removes the session and
+	* destroys the decoder. The timer is `unref`'d so a lingering warm session
+	* never keeps the process alive.
+	*/
+	scheduleLinger(session) {
+		this.clearLinger(session);
+		const timer = setTimeout(() => {
+			session.lingerTimer = null;
+			if (session.subscriberIds.size > 0) return;
+			this.sessions.delete(session.format);
+			this.destroySession(session).catch(() => {});
+		}, SESSION_LINGER_MS);
+		timer.unref?.();
+		session.lingerTimer = timer;
+	}
+	/** Cancel a session's pending keep-warm teardown timer, if any. */
+	clearLinger(session) {
+		if (session.lingerTimer) {
+			clearTimeout(session.lingerTimer);
+			session.lingerTimer = null;
+		}
+	}
+	/**
 	* Forward a video `EncodedPacket` to every active shm decoder session.
 	* Push-mode decoders consume this; a pull-mode decoder ignores it (it
 	* reads its own pipe via `openStream`). Audio packets are not forwarded.
@@ -9158,7 +9196,7 @@ var FrameHandlePlane = class {
 	*/
 	async killByTag(tag) {
 		const victims = [...this.subscriptions.values()].filter((s) => s.tag === tag).map((s) => s.id);
-		for (const id of victims) await this.unsubscribe(id);
+		for (const id of victims) await this.unsubscribe(id, true);
 		return victims.length;
 	}
 	/** Tear down every subscription + decoder session. Idempotent. */
@@ -9186,6 +9224,7 @@ var FrameHandlePlane = class {
 	async ensureSession(format, subscriptionId) {
 		const existing = this.sessions.get(format);
 		if (existing) {
+			this.clearLinger(existing);
 			existing.subscriberIds.add(subscriptionId);
 			return;
 		}
@@ -9202,7 +9241,8 @@ var FrameHandlePlane = class {
 				format,
 				proxy: null,
 				nodeId: null,
-				subscriberIds
+				subscriberIds,
+				lingerTimer: null
 			};
 			if (await this.startSessionDecoder(session)) this.sessions.set(format, session);
 		})();
@@ -9295,6 +9335,7 @@ var FrameHandlePlane = class {
 	}
 	/** Destroy a decoder session, swallowing teardown errors. */
 	async destroySession(session) {
+		this.clearLinger(session);
 		const proxy = session.proxy;
 		session.proxy = null;
 		session.nodeId = null;
@@ -10575,12 +10616,12 @@ var StreamBroker = class StreamBroker {
 	async subscribeFrameHandles(input) {
 		const plane = this.ensureFrameHandlePlane();
 		if (!plane) throw new Error("stream-broker: no decoder available for frame-handle subscription");
-		this.checkDemand();
 		const { subscriptionId, maxFps } = await plane.subscribe({
 			format: input.format,
 			maxFps: input.maxFps,
 			tag: input.tag
 		});
+		this.checkDemand();
 		return {
 			subscriptionId,
 			maxFps

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-CLVitFM4.mjs")).catch((e) => {
+	return l ||= d(() => import("./_virtual_mf-localSharedImportMap___mfe_internal__addon_stream_broker_widgets-BVFAEkIB.mjs")).catch((e) => {
 		throw l = void 0, e;
 	}), l;
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@camstack/addon-pipeline",
-  "version": "1.1.22",
+  "version": "1.1.23",
   "description": "CamStack Pipeline bundle — runner, detection, motion, decoders, audio + stream broker. Multi-entry npm package shipping 7 addons under a single bundle.",
   "keywords": [
     "camstack",