@hyperframes/producer 0.8.214 → 0.8.217

package/dist/index.d.ts

@@ -6,6 +6,7 @@
  * or any web content via configurable page contracts and hooks.
  */
 export { createRenderJob, executeRenderJob, resolveRenderDebugDir, RenderCancelledError, RenderQualityError, applyRenderWarningPolicy, type RenderConfig, type RenderConfigInput, type RenderJob, type RenderStatus, type RenderOutcome, type RenderStrictness, type RenderWarning, type RenderPerfSummary, type ProgressCallback, } from "./services/renderOrchestrator.js";
+export { extractSafeRenderErrorCode } from "./services/safeRenderErrorCode.js";
 export { RENDER_JOB_DIR, createOwnedRenderDir, listAbandonedRenderDirs, } from "./services/render/renderDirOwner.js";
 export { RENDER_REQUEST_VERSION, createRenderRequest, distributedConfigFromRequest, parseRenderRequest, renderConfigFromRequest, renderRequestFromDistributedConfig, serializeRenderRequest, type CreateRenderRequestInput, type DistributedRenderOptions, type RenderRequest, type RenderRequestOptions, } from "./renderRequest.js";
 export { type BrowserDiagnosticSummary, type RenderCaptureObservability, type RenderObservabilitySummary, type RenderObservationData, type RenderObservationEvent, type RenderObservationStatus, } from "./services/render/observability.js";

package/dist/index.js

@@ -3690,6 +3690,10 @@ function resolveCaptureStallTimeoutMs() {
   const parsed = raw ? Number(raw) : Number.NaN;
   return Number.isFinite(parsed) && parsed > 0 ? parsed : DEFAULT_CAPTURE_STALL_MS;
 }
+function stallBudgetMs(stallTimeoutMs, framesDone, beginFrame, cfg) {
+  const deadline = cfg.beginFrameFirstFrameDeadlineMs;
+  return beginFrame && framesDone === 0 && deadline ? Math.min(stallTimeoutMs, deadline) : stallTimeoutMs;
+}
 function captureModeLabel(mode) {
   if (mode === "drawelement") return "drawElement";
   if (mode === "beginframe") return "BeginFrame";
@@ -4062,14 +4066,20 @@ async function runCaptureStreamingStage(input) {
         const phaseDetail = (phase) => `phase=${phase.phase} frame=${phase.frameIndex ?? "n/a"} step=${phase.readStep?.() ?? "n/a"} browser=${phase.browserExecutable} version=${phase.browserVersion} CanvasDrawElement=${phase.canvasDrawElement} gpu=${phase.gpuBackend}`;
         const phaseSummary = () => [...workerPhases.entries()].sort(([left], [right]) => left - right).map(([workerId, detail]) => `worker=${workerId} ${detail}`).join("; ");
         let stalled = false;
+        const budget = () => stallBudgetMs(
+          stallTimeoutMs,
+          resumeFrom + lastCapturedFrames,
+          captureLabel === "BeginFrame",
+          cfg
+        );
         const stallTimer = setInterval(
           () => {
-            if (!watchdogArmed || Date.now() - lastProgressAt <= stallTimeoutMs) return;
+            if (!watchdogArmed || Date.now() - lastProgressAt <= budget()) return;
             stalled = true;
             const stallErr = new ParallelCaptureStallError({
               variant: "drain",
               captureLabel,
-              stallTimeoutMs,
+              stallTimeoutMs: budget(),
               lastCapturedFrames: resumeFrom + lastCapturedFrames,
               totalFrames,
               phaseSummary: phaseSummary()
@@ -4077,7 +4087,7 @@ async function runCaptureStreamingStage(input) {
             parallelReorder.abort(stallErr);
             stallController.abort();
           },
-          Math.min(stallTimeoutMs, DE_STALL_POLL_MS)
+          Math.min(budget(), DE_STALL_POLL_MS)
         );
         try {
           workerResults = await executeParallelCapture(
@@ -4158,7 +4168,7 @@ async function runCaptureStreamingStage(input) {
             throw new ParallelCaptureStallError({
               variant: "pool",
               captureLabel,
-              stallTimeoutMs,
+              stallTimeoutMs: budget(),
               lastCapturedFrames: resumeFrom + lastCapturedFrames,
               totalFrames,
               phaseSummary: phaseSummary()
@@ -4259,10 +4269,16 @@ async function runCaptureStreamingStage(input) {
           for (let i = 0; i < totalFrames; i++) {
             assertNotAborted();
             const time = i * job.config.fps.den / job.config.fps.num;
+            const budget = stallBudgetMs(
+              stallTimeoutMs,
+              i,
+              session.captureMode === "beginframe",
+              cfg
+            );
             const { buffer } = await raceAgainstStall(
               captureFrameToBuffer(session, i, time),
-              stallTimeoutMs - (Date.now() - lastProgressAt),
-              { session, frameIndex: i, totalFrames, stallTimeoutMs },
+              budget - (Date.now() - lastProgressAt),
+              { session, frameIndex: i, totalFrames, stallTimeoutMs: budget },
               abortSignal
             );
             await reorderBuffer.waitForFrame(i);
@@ -5480,6 +5496,7 @@ function watchStall(phase, rule) {
   let lastChangeAt = Date.now();
   let attempt;
   let timer;
+  let inTail = false;
   const restartWindow = (ms) => {
     last = rule.progress();
     budgetMs = ms;
@@ -5489,6 +5506,10 @@ function watchStall(phase, rule) {
     timer = setInterval(
       () => {
         const current = rule.progress();
+        if (rule.complete?.() && !inTail) {
+          inTail = true;
+          return restartWindow(rule.tailMs ?? rule.noProgressMs);
+        }
         if (current !== last) return restartWindow(rule.noProgressMs);
         if (Date.now() - lastChangeAt < budgetMs) return;
         const error = new RenderStageStalledError(phase, budgetMs, current);
@@ -5504,6 +5525,7 @@ function watchStall(phase, rule) {
   });
   const openAttempt = (parent) => {
     attempt = new AbortController();
+    inTail = false;
     restartWindow(rule.firstProgressMs);
     return parent ? AbortSignal.any([parent, attempt.signal]) : attempt.signal;
   };
@@ -8495,7 +8517,8 @@ async function runCompileStage(input) {
 }
 
 // src/services/render/stages/probeStage.ts
-import { join as join17 } from "node:path";
+import { createHash as createHash7 } from "node:crypto";
+import { basename as basename5, join as join17 } from "node:path";
 import { parseHTML as parseHTML6 } from "linkedom";
 import {
   closeCaptureSession as closeCaptureSession4,
@@ -8503,6 +8526,7 @@ import {
   createCaptureSession as createCaptureSession4,
   deriveBeginFrameProbeTimeTicks,
   getCompositionDuration,
+  getCompositionLengthSource,
   initializeSession as initializeSession4,
   isTransientBrowserError,
   probeBeginFrameLiveness,
@@ -8641,6 +8665,13 @@ function hasRuntimeMediaChanges(html) {
 function probeRequiresBrowser(args) {
   return args.durationSeconds <= 0 || args.unresolvedCompositionCount > 0 || args.hasAutoStart || args.hasScriptedAudio || args.hasVariableMedia || args.hasInsertedMedia;
 }
+function reportedLengthSource(source) {
+  if (!source) return null;
+  if (source.from !== "media") return { from: source.from };
+  const name = basename5(source.src.split(/[?#]/, 1)[0] ?? "");
+  const srcHash = createHash7("sha256").update(name).digest("hex").slice(0, 12);
+  return { from: "media", tag: source.tag, trimmed: source.trimmed, srcHash };
+}
 async function runProbeStage(input) {
   const {
     projectDir,
@@ -8662,6 +8693,7 @@ async function runProbeStage(input) {
   const probeCfg = cfg.forceScreenshot === forceScreenshot ? cfg : { ...cfg, forceScreenshot };
   let fileServer = null;
   let probeSession = null;
+  let lengthSource = input.composition.duration > 0 ? { from: "declared" } : null;
   let beginFrameStalled = false;
   let lastBrowserConsole = [];
   const probeStart = Date.now();
@@ -8823,10 +8855,12 @@ async function runProbeStage(input) {
       if (composition.duration <= 0) {
         log.info("Discovering composition duration...");
         const discoveredDuration = await getCompositionDuration(session);
+        lengthSource = reportedLengthSource(await getCompositionLengthSource(session));
         assertNotAborted();
         log.info("Probed composition duration from browser", {
           discoveredDuration,
-          staticDuration: compiled.staticDuration
+          staticDuration: compiled.staticDuration,
+          lengthSource
         });
         composition.duration = discoveredDuration;
       } else {
@@ -9115,6 +9149,7 @@ async function runProbeStage(input) {
     probeSession,
     lastBrowserConsole,
     duration,
+    lengthSource,
     totalFrames,
     browserProbeMs,
     beginFrameStalled
@@ -9639,7 +9674,7 @@ function checkedDbfs(value) {
   }
   return value;
 }
-async function scanTruePeak(audioPath, trim, timeoutMs, signal) {
+async function scanTruePeak(audioPath, trim, timeoutMs, signal, seekSeconds = 0) {
   let firstBlock;
   let laterBlocks = Number.NEGATIVE_INFINITY;
   let partialLine = "";
@@ -9655,7 +9690,21 @@ async function scanTruePeak(audioPath, trim, timeoutMs, signal) {
     }
   };
   const result = await runFfmpeg4(
-    ["-i", audioPath, "-map", "0:a:0", "-vn", "-af", `${trim}ebur128=peak=true`, "-f", "null", "-"],
+    [
+      ...seekSeconds > 0 ? ["-ss", String(seekSeconds)] : [],
+      ...[
+        "-i",
+        audioPath,
+        "-map",
+        "0:a:0",
+        "-vn",
+        "-af",
+        `${trim}ebur128=peak=true`,
+        "-f",
+        "null",
+        "-"
+      ]
+    ],
     { signal, timeout: timeoutMs, onStderr: readLines }
   );
   if (!result.success) {
@@ -9681,12 +9730,15 @@ async function measureTruePeakDbfs(audioPath, options) {
   const scans = await Promise.all(
     Array.from({ length: count }, (_, k) => {
       const start = k === 0 ? 0 : cut(k) - block;
-      const end = k === count - 1 ? "" : `:end_sample=${cut(k + 1)}`;
+      const seekSeconds = Math.max(0, Math.floor(start / sampleRate) - 1);
+      const skipped = seekSeconds * sampleRate;
+      const end = k === count - 1 ? "" : `:end_sample=${cut(k + 1) - skipped}`;
       return scanTruePeak(
         audioPath,
-        `atrim=start_sample=${start}${end},`,
+        `atrim=start_sample=${start - skipped}${end},`,
         timeoutMs,
-        segmentSignal
+        segmentSignal,
+        seekSeconds
       );
     })
   ).catch((error) => {
@@ -12315,12 +12367,15 @@ function resetCaptureAttemptProgress(job) {
   job.framesRendered = 0;
 }
 var FIRST_FRAME_STALL_MS = 3e5;
-function frameStallRule(job) {
+var TAIL_STALL_MS = FIRST_FRAME_STALL_MS;
+function frameStallRule(job, totalFrames) {
   const noProgressMs = resolveCaptureStallTimeoutMs();
   return {
     progress: () => job.framesRendered ?? 0,
     noProgressMs,
-    firstProgressMs: Math.max(FIRST_FRAME_STALL_MS, noProgressMs)
+    firstProgressMs: Math.max(FIRST_FRAME_STALL_MS, noProgressMs),
+    complete: () => (job.framesRendered ?? 0) >= totalFrames,
+    tailMs: Math.max(TAIL_STALL_MS, noProgressMs)
   };
 }
 function isRecoverableParallelCaptureError(error) {
@@ -13337,6 +13392,12 @@ async function executeRenderPipeline(input) {
     }
     observability.checkpoint("browser_probe", "duration resolved", {
       durationSeconds: probeResult.duration,
+      lengthFrom: probeResult.lengthSource?.from ?? null,
+      ...probeResult.lengthSource?.from === "media" ? {
+        lengthTag: probeResult.lengthSource.tag,
+        lengthTrimmed: probeResult.lengthSource.trimmed,
+        lengthSrcHash: probeResult.lengthSource.srcHash
+      } : {},
       totalFrames,
       compositionHash,
       beginFrameStalled: probeResult.beginFrameStalled
@@ -13522,6 +13583,14 @@ async function executeRenderPipeline(input) {
       // sample frame indices from this so they land inside the drained range.
       compositionDurationSeconds: job.duration,
       deFrameFallback: true,
+      // A line per scanned chunk, so a long effect scan reads as preparing, not as a stall.
+      onEffectScanProgress: (scanned, total) => updateJobStatus(
+        job,
+        "rendering",
+        `Checking effects, ${scanned} of ${total} frames`,
+        25,
+        onProgress
+      ),
       requiresWebGpu: compositionRequiresWebGpu2(compiled.html),
       // Live route for Chrome memory (spec §5 Phase −1). The aggregate route
       // through CapturePerfSummary only exists on success; a mid-capture
@@ -14206,7 +14275,7 @@ async function executeRenderPipeline(input) {
             onProgress
           });
         },
-        { stall: frameStallRule(job) }
+        { stall: frameStallRule(job, totalFrames) }
       );
       lastBrowserConsole = hdrRes.lastBrowserConsole;
       layeredCaptureWarnings.push(...hdrRes.warnings);
@@ -14651,7 +14720,7 @@ async function executeRenderPipeline(input) {
             interleaveFrames: overlap !== null,
             openAttempt
           }),
-          { stall: frameStallRule(job) }
+          { stall: frameStallRule(job, totalFrames) }
         );
         let captureRes;
         try {
@@ -14966,6 +15035,25 @@ async function executeRenderPipeline(input) {
   }
 }
 
+// src/services/safeRenderErrorCode.ts
+var SAFE_RENDER_ERROR_CODES = /* @__PURE__ */ new Set([
+  "ASSET_MEDIA_TYPE_MISMATCH",
+  "HEIF_IMAGE_CONVERSION_FAILED",
+  "HEIF_TOOL_UNAVAILABLE",
+  "NOT_MEDIA_PAYLOAD",
+  "INVALID_VIDEO_METADATA",
+  "VIDEO_SOURCE_UNRENDERABLE",
+  "VIDEO_EXTRACTION_FAILED",
+  "ENCODER_INTERRUPTED",
+  "RENDER_TOO_SLOW",
+  "RENDER_STAGE_STALLED"
+]);
+function extractSafeRenderErrorCode(error) {
+  if (typeof error !== "object" || error === null || !("code" in error)) return void 0;
+  const code = error.code;
+  return typeof code === "string" && SAFE_RENDER_ERROR_CODES.has(code) ? code : void 0;
+}
+
 // src/renderRequest.ts
 import {
   PRORES_PROFILE_NAMES as PRORES_PROFILE_NAMES2,
@@ -15742,12 +15830,12 @@ function readPlanProtocolV1(planJson, capabilities = DISTRIBUTED_RENDER_CAPABILI
 }
 
 // src/services/render/stages/planHash.ts
-import { createHash as createHash7 } from "node:crypto";
+import { createHash as createHash8 } from "node:crypto";
 import { closeSync as closeSync5, createReadStream as createReadStream3, openSync as openSync5, readSync as readSync4 } from "node:fs";
 var PLAN_HASH_SCHEMA_PREFIX = "hyperframes-plan-hash-v1\0";
 var FIELD_DELIMITER = Buffer.from([0]);
 function computePlanHash(input) {
-  const hash = createHash7("sha256");
+  const hash = createHash8("sha256");
   hash.update(PLAN_HASH_SCHEMA_PREFIX, "utf8");
   hash.update(input.compositionHtml);
   hash.update(FIELD_DELIMITER);
@@ -15794,12 +15882,12 @@ function canonicalJsonStringify(value) {
   throw new TypeError(`canonicalJsonStringify: unsupported value type ${typeof value}`);
 }
 function sha256Hex(bytes) {
-  const h = createHash7("sha256");
+  const h = createHash8("sha256");
   h.update(bytes);
   return h.digest("hex");
 }
 function sha256File(path) {
-  const hash = createHash7("sha256");
+  const hash = createHash8("sha256");
   const buffer = Buffer.allocUnsafe(1024 * 1024);
   const fd = openSync5(path, "r");
   try {
@@ -15814,7 +15902,7 @@ function sha256File(path) {
   return hash.digest("hex");
 }
 async function sha256FileAsync(path) {
-  const hash = createHash7("sha256");
+  const hash = createHash8("sha256");
   for await (const chunk of createReadStream3(path, { highWaterMark: 1024 * 1024 })) {
     hash.update(chunk);
   }
@@ -16585,7 +16673,7 @@ async function muxChunkWithAudio(input) {
 }
 
 // src/services/distributed/planSize.ts
-import { createHash as createHash8 } from "node:crypto";
+import { createHash as createHash9 } from "node:crypto";
 import { lstatSync as lstatSync2, readdirSync as readdirSync8 } from "node:fs";
 import { extname as extname5, join as join34, relative as relative4 } from "node:path";
 var MAX_TOP_COMPONENTS = 10;
@@ -16615,7 +16703,7 @@ var PLAN_ROOT_CATEGORY = {
   "plan.json": "metadata"
 };
 function hashComponent(value) {
-  return createHash8("sha256").update(value).digest("hex").slice(0, 12);
+  return createHash9("sha256").update(value).digest("hex").slice(0, 12);
 }
 function classifyFile(segments, rootKind) {
   const rootName = segments[0] ?? "";
@@ -18366,23 +18454,6 @@ import {
 import { parseEncoderOptions } from "@hyperframes/studio-server/encoder-options";
 var DEFAULT_SERVER_FPS = { num: 30, den: 1 };
 var SSE_KEEPALIVE_MS = 3e4;
-var SAFE_RENDER_ERROR_CODES = /* @__PURE__ */ new Set([
-  "ASSET_MEDIA_TYPE_MISMATCH",
-  "HEIF_IMAGE_CONVERSION_FAILED",
-  "HEIF_TOOL_UNAVAILABLE",
-  "NOT_MEDIA_PAYLOAD",
-  "INVALID_VIDEO_METADATA",
-  "VIDEO_SOURCE_UNRENDERABLE",
-  "VIDEO_EXTRACTION_FAILED",
-  "ENCODER_INTERRUPTED",
-  "RENDER_TOO_SLOW",
-  "RENDER_STAGE_STALLED"
-]);
-function extractSafeRenderErrorCode(error) {
-  if (typeof error !== "object" || error === null || !("code" in error)) return void 0;
-  const code = error.code;
-  return typeof code === "string" && SAFE_RENDER_ERROR_CODES.has(code) ? code : void 0;
-}
 function extractSafeRenderErrorMetadata(error) {
   const errorCode = extractSafeRenderErrorCode(error);
   if (!errorCode || typeof error !== "object" || error === null) return void 0;
@@ -20834,7 +20905,7 @@ async function renderChunk(planDir, chunkIndex, outputChunkPath, options) {
               openAttempt,
               verifyFirstSession: forceScreenshot || !verifyInWorker ? void 0 : verifyFirstWorker
             }),
-            { stall: frameStallRule(job) }
+            { stall: frameStallRule(job, framesInChunk) }
           ).catch(async (captureError) => {
             await overlap.current?.abort();
             overlap.current = null;
@@ -21055,6 +21126,7 @@ export {
   defaultLogger,
   distributedConfigFromRequest,
   executeRenderJob,
+  extractSafeRenderErrorCode,
   getCapturePerfSummary4 as getCapturePerfSummary,
   getCompositionDuration2 as getCompositionDuration,
   getDistributedRenderCapabilities,