@camstack/addon-pipeline 1.1.23 → 1.1.24

package/dist/stream-broker/index.js

@@ -8915,6 +8915,13 @@ var DECODE_FPS_WINDOW_MS = 2e3;
 */
 var SESSION_LINGER_MS = 45e3;
 /**
+* Default retry cooldown after a decoder session lands on a NON-LOCAL node
+* (see `FrameHandlePlaneOptions.sessionRetryCooldownMs`). Long enough to
+* turn a per-packet storm into a slow probe; short enough that the plane
+* recovers within seconds once the local decoder respawns.
+*/
+var SESSION_RETRY_COOLDOWN_MS = 1e4;
+/**
 * Owns the broker's shared-memory frame-handle subscriptions and the
 * per-format `frameSink: 'shm'` decoder sessions that feed them.
 */
@@ -8923,8 +8930,12 @@ var FrameHandlePlane = class {
 	logger;
 	resolveStreamInfo;
 	localNodeId;
+	sessionRetryCooldownMs;
 	subscriptions = /* @__PURE__ */ new Map();
 	sessions = /* @__PURE__ */ new Map();
+	/** Per-format retry gate set when a session lands on a non-local node:
+	*  `ensureSession` skips creation until the epoch-ms deadline passes. */
+	sessionRetryCooldownUntil = /* @__PURE__ */ new Map();
 	/** In-flight `ensureSession` creation per format. Coalesces concurrent
 	*  same-format callers onto ONE decoder session — without it two callers
 	*  both pass the `sessions.get` check, both `createSession` (two ffmpeg),
@@ -8944,6 +8955,7 @@ var FrameHandlePlane = class {
 		this.logger = options.logger;
 		this.resolveStreamInfo = options.resolveStreamInfo;
 		this.localNodeId = options.localNodeId;
+		this.sessionRetryCooldownMs = options.sessionRetryCooldownMs ?? SESSION_RETRY_COOLDOWN_MS;
 	}
 	/** Number of active handle subscriptions — surfaced for diagnostics. */
 	get subscriberCount() {
@@ -8977,8 +8989,13 @@ var FrameHandlePlane = class {
 				nodeId: session.nodeId
 			} });
 			await this.destroySession(session);
-			await this.startSessionDecoder(session);
-			rotated += 1;
+			let restarted = false;
+			try {
+				restarted = await this.startSessionDecoder(session);
+			} finally {
+				if (!restarted) this.sessions.delete(session.format);
+			}
+			if (restarted) rotated += 1;
 		}
 		return rotated;
 	}
@@ -9238,6 +9255,7 @@ var FrameHandlePlane = class {
 			this.sessions.get(format)?.subscriberIds.add(subscriptionId);
 			return;
 		}
+		if (Date.now() < (this.sessionRetryCooldownUntil.get(format) ?? 0)) return;
 		const creation = (async () => {
 			const subscriberIds = new Set([subscriptionId]);
 			for (const subscription of this.subscriptions.values()) if (subscription.format === format) subscriberIds.add(subscription.id);
@@ -9248,7 +9266,14 @@ var FrameHandlePlane = class {
 				subscriberIds,
 				lingerTimer: null
 			};
-			if (await this.startSessionDecoder(session)) this.sessions.set(format, session);
+			let started = false;
+			try {
+				started = await this.startSessionDecoder(session);
+			} catch (err) {
+				this.sessionRetryCooldownUntil.set(format, Date.now() + this.sessionRetryCooldownMs);
+				throw err;
+			}
+			if (started) this.sessions.set(format, session);
 		})();
 		this.sessionCreating.set(format, creation);
 		try {
@@ -9288,11 +9313,13 @@ var FrameHandlePlane = class {
 			tag: `${info.tag}:shm:${format}`
 		});
 		if (!isDecoderNodeColocated(this.localNodeId, nodeId)) {
+			this.sessionRetryCooldownUntil.set(format, Date.now() + this.sessionRetryCooldownMs);
 			this.logger?.warn("frame-handle plane: decoder session landed on a non-local node — destroying (shm ring is node-local)", { meta: {
 				format,
 				requestedNode: this.localNodeId,
 				gotNode: nodeId,
-				sessionId
+				sessionId,
+				retryInMs: this.sessionRetryCooldownMs
 			} });
 			await this.decoderApi.destroySession({ sessionId }).catch((err) => {
 				this.logger?.warn("frame-handle plane: failed to destroy mis-placed decoder session", { meta: {
@@ -9303,6 +9330,7 @@ var FrameHandlePlane = class {
 			});
 			return false;
 		}
+		this.sessionRetryCooldownUntil.delete(format);
 		const proxy = new DecoderSessionProxy(this.decoderApi, sessionId);
 		session.proxy = proxy;
 		session.nodeId = nodeId;

package/dist/stream-broker/index.mjs

@@ -8911,6 +8911,13 @@ var DECODE_FPS_WINDOW_MS = 2e3;
 */
 var SESSION_LINGER_MS = 45e3;
 /**
+* Default retry cooldown after a decoder session lands on a NON-LOCAL node
+* (see `FrameHandlePlaneOptions.sessionRetryCooldownMs`). Long enough to
+* turn a per-packet storm into a slow probe; short enough that the plane
+* recovers within seconds once the local decoder respawns.
+*/
+var SESSION_RETRY_COOLDOWN_MS = 1e4;
+/**
 * Owns the broker's shared-memory frame-handle subscriptions and the
 * per-format `frameSink: 'shm'` decoder sessions that feed them.
 */
@@ -8919,8 +8926,12 @@ var FrameHandlePlane = class {
 	logger;
 	resolveStreamInfo;
 	localNodeId;
+	sessionRetryCooldownMs;
 	subscriptions = /* @__PURE__ */ new Map();
 	sessions = /* @__PURE__ */ new Map();
+	/** Per-format retry gate set when a session lands on a non-local node:
+	*  `ensureSession` skips creation until the epoch-ms deadline passes. */
+	sessionRetryCooldownUntil = /* @__PURE__ */ new Map();
 	/** In-flight `ensureSession` creation per format. Coalesces concurrent
 	*  same-format callers onto ONE decoder session — without it two callers
 	*  both pass the `sessions.get` check, both `createSession` (two ffmpeg),
@@ -8940,6 +8951,7 @@ var FrameHandlePlane = class {
 		this.logger = options.logger;
 		this.resolveStreamInfo = options.resolveStreamInfo;
 		this.localNodeId = options.localNodeId;
+		this.sessionRetryCooldownMs = options.sessionRetryCooldownMs ?? SESSION_RETRY_COOLDOWN_MS;
 	}
 	/** Number of active handle subscriptions — surfaced for diagnostics. */
 	get subscriberCount() {
@@ -8973,8 +8985,13 @@ var FrameHandlePlane = class {
 				nodeId: session.nodeId
 			} });
 			await this.destroySession(session);
-			await this.startSessionDecoder(session);
-			rotated += 1;
+			let restarted = false;
+			try {
+				restarted = await this.startSessionDecoder(session);
+			} finally {
+				if (!restarted) this.sessions.delete(session.format);
+			}
+			if (restarted) rotated += 1;
 		}
 		return rotated;
 	}
@@ -9234,6 +9251,7 @@ var FrameHandlePlane = class {
 			this.sessions.get(format)?.subscriberIds.add(subscriptionId);
 			return;
 		}
+		if (Date.now() < (this.sessionRetryCooldownUntil.get(format) ?? 0)) return;
 		const creation = (async () => {
 			const subscriberIds = new Set([subscriptionId]);
 			for (const subscription of this.subscriptions.values()) if (subscription.format === format) subscriberIds.add(subscription.id);
@@ -9244,7 +9262,14 @@ var FrameHandlePlane = class {
 				subscriberIds,
 				lingerTimer: null
 			};
-			if (await this.startSessionDecoder(session)) this.sessions.set(format, session);
+			let started = false;
+			try {
+				started = await this.startSessionDecoder(session);
+			} catch (err) {
+				this.sessionRetryCooldownUntil.set(format, Date.now() + this.sessionRetryCooldownMs);
+				throw err;
+			}
+			if (started) this.sessions.set(format, session);
 		})();
 		this.sessionCreating.set(format, creation);
 		try {
@@ -9284,11 +9309,13 @@ var FrameHandlePlane = class {
 			tag: `${info.tag}:shm:${format}`
 		});
 		if (!isDecoderNodeColocated(this.localNodeId, nodeId)) {
+			this.sessionRetryCooldownUntil.set(format, Date.now() + this.sessionRetryCooldownMs);
 			this.logger?.warn("frame-handle plane: decoder session landed on a non-local node — destroying (shm ring is node-local)", { meta: {
 				format,
 				requestedNode: this.localNodeId,
 				gotNode: nodeId,
-				sessionId
+				sessionId,
+				retryInMs: this.sessionRetryCooldownMs
 			} });
 			await this.decoderApi.destroySession({ sessionId }).catch((err) => {
 				this.logger?.warn("frame-handle plane: failed to destroy mis-placed decoder session", { meta: {
@@ -9299,6 +9326,7 @@ var FrameHandlePlane = class {
 			});
 			return false;
 		}
+		this.sessionRetryCooldownUntil.delete(format);
 		const proxy = new DecoderSessionProxy(this.decoderApi, sessionId);
 		session.proxy = proxy;
 		session.nodeId = nodeId;

package/package.json

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