@camstack/addon-pipeline 1.2.219 → 1.2.221

package/dist/worker-protocol-iWTFnnUM.js

@@ -1,299 +0,0 @@
-const require_dist = require("./dist-wtNhtVVo.js");
-//#region src/session-decode/native-lease-config.ts
-/**
-* Resolution of the native-frame hold / tile knobs for one decode worker.
-*
-* ## Where the values come from
-*
-* The knobs are cluster-wide `pipeline-orchestrator` settings
-* (`@camstack/types` → `pipeline/native-lease.ts`). The pipeline-runner reads
-* them over the hub-routed `addon-settings` cap
-* (`pipeline-runner/native-lease-settings-source.ts`) and injects the ones the
-* operator actually SET into the child's environment at `fork` time
-* ({@link nativeLeaseSettingEnv}, consumed by `fork-decode-worker.ts`). The
-* child resolves them at module load ({@link resolveNativeLeaseKnobs}).
-*
-* Env-on-fork rather than an init message on purpose: the hold store, the tile
-* store and the demand gate are constructed with the worker, before the first
-* `start` message arrives, and a knob that can change after construction is a
-* knob that has two values during a session.
-*
-* ## Precedence — setting > env > default
-*
-* 1. **setting** — the operator set the knob in the orchestrator's global
-*    settings. Wins, because a value someone deliberately chose in the UI must
-*    not be silently overruled by a shell variable nobody can see from there.
-* 2. **env** — {@link NATIVE_LEASE_ENV_VARS}, the pre-settings mechanism, kept
-*    as an emergency / dev override. It applies only while the corresponding
-*    setting is UNSET. "Unset" includes a knob sitting AT its shipped default:
-*    `addon-settings.getGlobalSettings` hydrates an unstored field with the
-*    schema default and offers no way to tell the two apart, so treating the
-*    default as a choice would have retired every env var on the day this
-*    shipped. Move the slider off the default and the setting takes over; move
-*    it back and the env var returns. See `readNativeLeaseOverride`.
-* 3. **default** — {@link DEFAULT_NATIVE_LEASE_SETTINGS}, byte-for-byte the
-*    constants the worker shipped with.
-*
-* A value that fails its bounds at ANY level falls through to the next one
-* rather than being clamped: clamping turns a typo into a number nobody chose,
-* and this one governs how much RAM a busy camera holds.
-*
-* The GPU surface ring (`CAMSTACK_SESSION_NATIVE_CROP_RING`) is deliberately
-* NOT here — see its docblock in `decode-worker-child.ts` for why it stays
-* env-only.
-*/
-/** Every knob, in the order the spawn line names them. */
-var NATIVE_LEASE_KNOBS = [
-	"holdFrames",
-	"budgetMb",
-	"activityMs",
-	"admission",
-	"tileBudgetMb",
-	"sceneBudgetMb"
-];
-/** Emergency / dev override env vars (pre-settings; lowest precedence but the default). */
-var NATIVE_LEASE_ENV_VARS = {
-	holdFrames: "CAMSTACK_SESSION_NATIVE_LEASE_HOLD_FRAMES",
-	budgetMb: "CAMSTACK_SESSION_NATIVE_LEASE_BUDGET_MB",
-	activityMs: "CAMSTACK_SESSION_NATIVE_LEASE_ACTIVITY_MS",
-	admission: "CAMSTACK_SESSION_NATIVE_LEASE_ADMISSION",
-	tileBudgetMb: "CAMSTACK_SESSION_NATIVE_TILE_BUDGET_MB",
-	sceneBudgetMb: "CAMSTACK_SESSION_NATIVE_SCENE_BUDGET_MB"
-};
-/**
-* Env vars the PARENT writes at fork time to carry an operator setting into the
-* child. Distinct names from {@link NATIVE_LEASE_ENV_VARS} so the child can tell
-* "the operator chose this" from "a shell variable set this" and log the source
-* honestly — with one shared name that distinction is unrecoverable.
-*/
-var NATIVE_LEASE_SETTING_ENV_VARS = {
-	holdFrames: "CAMSTACK_SESSION_NATIVE_LEASE_HOLD_FRAMES_SETTING",
-	budgetMb: "CAMSTACK_SESSION_NATIVE_LEASE_BUDGET_MB_SETTING",
-	activityMs: "CAMSTACK_SESSION_NATIVE_LEASE_ACTIVITY_MS_SETTING",
-	admission: "CAMSTACK_SESSION_NATIVE_LEASE_ADMISSION_SETTING",
-	tileBudgetMb: "CAMSTACK_SESSION_NATIVE_TILE_BUDGET_MB_SETTING",
-	sceneBudgetMb: "CAMSTACK_SESSION_NATIVE_SCENE_BUDGET_MB_SETTING"
-};
-/**
-* Parse one env value through the knob's own Zod bound. Returns `null` for
-* absent, non-numeric, or out-of-bounds input — the caller then falls through
-* to the next precedence level.
-*/
-function parseKnob(knob, raw) {
-	if (raw === void 0 || raw.trim() === "") return null;
-	const parsed = require_dist.NativeLeaseSettingsSchema.shape[knob].safeParse(Number(raw));
-	return parsed.success ? parsed.data : null;
-}
-/** {@link parseKnob} for the one knob whose value is a word, not a number. */
-function parseAdmission(raw) {
-	if (raw === void 0) return null;
-	const parsed = require_dist.NativeLeaseAdmissionSchema.safeParse(raw.trim());
-	return parsed.success ? parsed.data : null;
-}
-/** Resolve one NUMERIC knob across the three precedence levels. */
-function resolveKnob(knob, env) {
-	const fromSetting = parseKnob(knob, env[NATIVE_LEASE_SETTING_ENV_VARS[knob]]);
-	if (fromSetting !== null) return {
-		value: fromSetting,
-		source: "setting"
-	};
-	const fromEnv = parseKnob(knob, env[NATIVE_LEASE_ENV_VARS[knob]]);
-	if (fromEnv !== null) return {
-		value: fromEnv,
-		source: "env"
-	};
-	return {
-		value: require_dist.DEFAULT_NATIVE_LEASE_SETTINGS[knob],
-		source: "default"
-	};
-}
-/** {@link resolveKnob} for `admission`. Same precedence, different parser. */
-function resolveAdmission(env) {
-	const fromSetting = parseAdmission(env[NATIVE_LEASE_SETTING_ENV_VARS.admission]);
-	if (fromSetting !== null) return {
-		value: fromSetting,
-		source: "setting"
-	};
-	const fromEnv = parseAdmission(env[NATIVE_LEASE_ENV_VARS.admission]);
-	if (fromEnv !== null) return {
-		value: fromEnv,
-		source: "env"
-	};
-	return {
-		value: require_dist.DEFAULT_NATIVE_LEASE_SETTINGS.admission,
-		source: "default"
-	};
-}
-/** Resolve every lease knob from an environment. Pure. */
-function resolveNativeLeaseKnobs(env) {
-	const holdFrames = resolveKnob("holdFrames", env);
-	const budgetMb = resolveKnob("budgetMb", env);
-	const activityMs = resolveKnob("activityMs", env);
-	const admission = resolveAdmission(env);
-	const tileBudgetMb = resolveKnob("tileBudgetMb", env);
-	const sceneBudgetMb = resolveKnob("sceneBudgetMb", env);
-	return {
-		values: {
-			holdFrames: holdFrames.value,
-			budgetMb: budgetMb.value,
-			activityMs: activityMs.value,
-			admission: admission.value,
-			tileBudgetMb: tileBudgetMb.value,
-			sceneBudgetMb: sceneBudgetMb.value
-		},
-		sources: {
-			holdFrames: holdFrames.source,
-			budgetMb: budgetMb.source,
-			activityMs: activityMs.source,
-			admission: admission.source,
-			tileBudgetMb: tileBudgetMb.source,
-			sceneBudgetMb: sceneBudgetMb.source
-		}
-	};
-}
-/**
-* The env fragment the parent merges into a decode worker's `fork` environment.
-* Emits ONLY the knobs the operator actually set — an empty result leaves the
-* env override fully functional, which is the whole point of the distinction.
-*/
-function nativeLeaseSettingEnv(override) {
-	const out = {};
-	for (const knob of NATIVE_LEASE_KNOBS) {
-		const value = override[knob];
-		if (value !== void 0) out[NATIVE_LEASE_SETTING_ENV_VARS[knob]] = String(value);
-	}
-	return out;
-}
-/**
-* The one-line spawn diagnostic. Names the effective value AND its source for
-* every knob: without the source, a log saying `holdFrames=8` cannot distinguish
-* "the operator's setting arrived" from "someone left a shell variable set", and
-* a setting that silently fails to arrive is exactly the failure the distinct
-* env-var names exist to make visible.
-*/
-function formatNativeLeaseKnobs(resolved) {
-	const part = (knob) => `${knob}=${resolved.values[knob]} source=${resolved.sources[knob]}`;
-	return `native lease knobs — ${NATIVE_LEASE_KNOBS.map(part).join("; ")}`;
-}
-//#endregion
-//#region src/session-decode/worker-protocol.ts
-/**
-* Classify a worker diagnostic line into a {@link WorkerLogLevel}. Failure /
-* fault lines surface at `warn` (visible at the default log level so a
-* native-crop failure is finally seen in `addons.getLogs`); routine
-* provenance / transition / lifecycle lines stay `debug`. Pure + exported so
-* the mapping is unit-testable without spawning a worker.
-*/
-function logLevelForLine(line) {
-	return /\b(fail(?:ed|ure)?|error|exception|unhandled rejection|corrupt|EIO|EINVAL)\b/i.test(line) ? "warn" : "debug";
-}
-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 isWorkerBufferFormat(value) {
-	return isWorkerFrameFormat(value) || value === "jpeg";
-}
-function isWorkerLogLevel(value) {
-	return value === "debug" || value === "info" || value === "warn" || value === "error";
-}
-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 && !isWorkerBufferFormat(value.format)) return false;
-	return true;
-}
-function isNormalizedBbox(value) {
-	return isRecord(value) && isFiniteNumber(value.x) && isFiniteNumber(value.y) && isFiniteNumber(value.w) && isFiniteNumber(value.h);
-}
-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;
-	if (value.preRollMs !== void 0 && !isFiniteNumber(value.preRollMs)) return false;
-	if (value.preRollMaxFrames !== void 0 && !isFiniteNumber(value.preRollMaxFrames)) 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 "nativeCrop": return isFiniteNumber(value.requestId) && isFiniteNumber(value.frameId) && isNormalizedBbox(value.bbox) && (value.maxWidth === void 0 || isFiniteNumber(value.maxWidth));
-		case "cutTiles": return isFiniteNumber(value.frameId) && Array.isArray(value.bboxes) && value.bboxes.every(isNormalizedBbox);
-		case "releaseNativeLease":
-		case "markInferred": return isFiniteNumber(value.frameId);
-		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) && (value.capturedAt === void 0 || isFiniteNumber(value.capturedAt)) && (value.preRoll === void 0 || typeof value.preRoll === "boolean");
-		case "buffer": return isFiniteNumber(value.frameId) && value.bytes instanceof Uint8Array;
-		case "nativeCropResult": return isFiniteNumber(value.requestId) && value.bytes instanceof Uint8Array && isFiniteNumber(value.width) && isFiniteNumber(value.height) && (value.source === void 0 || value.source === "lease" || value.source === "tile");
-		case "nativeCropMiss": return isFiniteNumber(value.requestId) && (value.reason === void 0 || typeof value.reason === "string");
-		case "ended": return true;
-		case "error": return typeof value.message === "string" && (value.frameId === void 0 || isFiniteNumber(value.frameId));
-		case "log": return isWorkerLogLevel(value.level) && typeof value.message === "string";
-		case "preRollReport": return isFiniteNumber(value.offered) && isFiniteNumber(value.inferred) && isFiniteNumber(value.dropped) && isRecord(value.droppedByReason) && isFiniteNumber(value.strideMs) && typeof value.subsampled === "boolean" && isFiniteNumber(value.spanMs);
-		case "dialTiming": return isFiniteNumber(value.hwContextMs) && isFiniteNumber(value.demuxerOpenMs) && isFiniteNumber(value.decoderCreateMs) && isFiniteNumber(value.firstDecodeMs) && typeof value.streamInfoProbed === "boolean";
-		default: return false;
-	}
-}
-//#endregion
-Object.defineProperty(exports, "formatNativeLeaseKnobs", {
-	enumerable: true,
-	get: function() {
-		return formatNativeLeaseKnobs;
-	}
-});
-Object.defineProperty(exports, "isWorkerReply", {
-	enumerable: true,
-	get: function() {
-		return isWorkerReply;
-	}
-});
-Object.defineProperty(exports, "isWorkerRequest", {
-	enumerable: true,
-	get: function() {
-		return isWorkerRequest;
-	}
-});
-Object.defineProperty(exports, "logLevelForLine", {
-	enumerable: true,
-	get: function() {
-		return logLevelForLine;
-	}
-});
-Object.defineProperty(exports, "nativeLeaseSettingEnv", {
-	enumerable: true,
-	get: function() {
-		return nativeLeaseSettingEnv;
-	}
-});
-Object.defineProperty(exports, "resolveNativeLeaseKnobs", {
-	enumerable: true,
-	get: function() {
-		return resolveNativeLeaseKnobs;
-	}
-});