@camstack/addon-pipeline 1.2.310 → 1.2.311

package/dist/pipeline-runner/index.js

@@ -3885,6 +3885,24 @@ function isParkedDetailFresh(parked, nowMs) {
 function buildDetailNotAttachedError(deviceId) {
 	return /* @__PURE__ */ new Error(`${DETAIL_NOT_ATTACHED_MARKER} — camera ${deviceId} is not attached and no detail state is parked within the grace window`);
 }
+/**
+* The wire marker for the typed handle-expired refusal (D688): the frame handle
+* a detail dispatch named is past the native lease age bound, so every later
+* ask for it is refused too. Twin constant in
+* `addon-post-analysis/src/pipeline-analytics/detail-refusal.ts` — keep in sync.
+* An error rather than a result field for the same reason as
+* {@link DETAIL_NOT_ATTACHED_MARKER}: the cap output schema strips unknown keys.
+*/
+var DETAIL_HANDLE_EXPIRED_MARKER = "runDetailSubtree-refused:handle-expired";
+/**
+* The error the cap method throws when the dispatch's only pixel source was a
+* frame handle the lease registry refused as expired. The dispatcher recognises
+* the marker, retires the handle for that track and falls back to its parked
+* frame — it never names the same handle again.
+*/
+function buildDetailHandleExpiredError(deviceId, handleAgeMs) {
+	return /* @__PURE__ */ new Error(`${DETAIL_HANDLE_EXPIRED_MARKER} — camera ${deviceId}: the frame handle is past the native lease age bound (age ${handleAgeMs ?? "unknown"} ms)`);
+}
 //#endregion
 //#region src/pipeline-runner/face-parent-geometry.ts
 /** Is the centre of `face` inside `parent` (edges inclusive)? */
@@ -3970,7 +3988,11 @@ var FaceOutsideParentLog = class {
 //#region src/pipeline-runner/detail-subtree.ts
 /** Did the subtree run refuse because the camera is not attached (park lapsed)? */
 function isDetailNotAttachedRefusal(outcome) {
-	return "refusal" in outcome;
+	return "refusal" in outcome && outcome.refusal === "not-attached";
+}
+/** Did the subtree run refuse because the named frame handle is past its lease age bound? */
+function isDetailHandleExpiredRefusal(outcome) {
+	return "refusal" in outcome && outcome.refusal === "handle-expired";
 }
 /** Did the native-lease fetch report a miss (rather than return pixels)? */
 function isNativeCropMiss(fetch) {
@@ -4272,6 +4294,10 @@ async function runDetailSubtree(deps, input) {
 				nativeWorkerReason: nativeMiss?.workerReason ?? null
 			}
 		});
+		if (nativeMiss?.miss === "handle-expired") return {
+			refusal: "handle-expired",
+			handleAgeMs: nativeMiss.handleAgeMs
+		};
 		return null;
 	}
 	const nativeCropRef = input.frameHandle !== void 0 && crop.source === "native" ? {
@@ -10071,6 +10097,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends require_dist.BaseAdd
 			recordFaceOutsideParent: (drop) => this.faceOutsideParentLog.record(drop)
 		}, input);
 		if (outcome !== null && isDetailNotAttachedRefusal(outcome)) throw buildDetailNotAttachedError(input.deviceId);
+		if (outcome !== null && isDetailHandleExpiredRefusal(outcome)) throw buildDetailHandleExpiredError(input.deviceId, outcome.handleAgeMs);
 		return outcome;
 	}
 	/**

package/dist/pipeline-runner/index.mjs

@@ -3877,6 +3877,24 @@ function isParkedDetailFresh(parked, nowMs) {
 function buildDetailNotAttachedError(deviceId) {
 	return /* @__PURE__ */ new Error(`${DETAIL_NOT_ATTACHED_MARKER} — camera ${deviceId} is not attached and no detail state is parked within the grace window`);
 }
+/**
+* The wire marker for the typed handle-expired refusal (D688): the frame handle
+* a detail dispatch named is past the native lease age bound, so every later
+* ask for it is refused too. Twin constant in
+* `addon-post-analysis/src/pipeline-analytics/detail-refusal.ts` — keep in sync.
+* An error rather than a result field for the same reason as
+* {@link DETAIL_NOT_ATTACHED_MARKER}: the cap output schema strips unknown keys.
+*/
+var DETAIL_HANDLE_EXPIRED_MARKER = "runDetailSubtree-refused:handle-expired";
+/**
+* The error the cap method throws when the dispatch's only pixel source was a
+* frame handle the lease registry refused as expired. The dispatcher recognises
+* the marker, retires the handle for that track and falls back to its parked
+* frame — it never names the same handle again.
+*/
+function buildDetailHandleExpiredError(deviceId, handleAgeMs) {
+	return /* @__PURE__ */ new Error(`${DETAIL_HANDLE_EXPIRED_MARKER} — camera ${deviceId}: the frame handle is past the native lease age bound (age ${handleAgeMs ?? "unknown"} ms)`);
+}
 //#endregion
 //#region src/pipeline-runner/face-parent-geometry.ts
 /** Is the centre of `face` inside `parent` (edges inclusive)? */
@@ -3962,7 +3980,11 @@ var FaceOutsideParentLog = class {
 //#region src/pipeline-runner/detail-subtree.ts
 /** Did the subtree run refuse because the camera is not attached (park lapsed)? */
 function isDetailNotAttachedRefusal(outcome) {
-	return "refusal" in outcome;
+	return "refusal" in outcome && outcome.refusal === "not-attached";
+}
+/** Did the subtree run refuse because the named frame handle is past its lease age bound? */
+function isDetailHandleExpiredRefusal(outcome) {
+	return "refusal" in outcome && outcome.refusal === "handle-expired";
 }
 /** Did the native-lease fetch report a miss (rather than return pixels)? */
 function isNativeCropMiss(fetch) {
@@ -4264,6 +4286,10 @@ async function runDetailSubtree(deps, input) {
 				nativeWorkerReason: nativeMiss?.workerReason ?? null
 			}
 		});
+		if (nativeMiss?.miss === "handle-expired") return {
+			refusal: "handle-expired",
+			handleAgeMs: nativeMiss.handleAgeMs
+		};
 		return null;
 	}
 	const nativeCropRef = input.frameHandle !== void 0 && crop.source === "native" ? {
@@ -10063,6 +10089,7 @@ var PipelineRunnerAddon = class PipelineRunnerAddon extends BaseAddon {
 			recordFaceOutsideParent: (drop) => this.faceOutsideParentLog.record(drop)
 		}, input);
 		if (outcome !== null && isDetailNotAttachedRefusal(outcome)) throw buildDetailNotAttachedError(input.deviceId);
+		if (outcome !== null && isDetailHandleExpiredRefusal(outcome)) throw buildDetailHandleExpiredError(input.deviceId, outcome.handleAgeMs);
 		return outcome;
 	}
 	/**

package/package.json

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