@hyperframes/producer 0.8.146 → 0.8.147

package/dist/index.js

@@ -3360,12 +3360,13 @@ function buildRenderPerfSummary(input) {
 // src/services/render/stages/captureStreamingStage.ts
 var DEFAULT_CAPTURE_STALL_MS = 6e4;
 var DE_STALL_POLL_MS = 5e3;
+var STALL_ADVICE = "Chrome stopped answering. If another app is keeping the GPU or CPU busy (a 3D render, a game, another export), let it finish or render one job at a time, then retry.";
 var ParallelCaptureStallError = class extends Error {
   variant;
   constructor(args) {
     const phases = args.phaseSummary ? ` Last worker phases: ${args.phaseSummary}.` : "";
     super(
-      args.variant === "drain" ? `[Render] Parallel ${args.captureLabel} capture stalled: no frame progress for ${args.stallTimeoutMs}ms (stuck at ${args.lastCapturedFrames}/${args.totalFrames}).${phases}` : `[Render] Parallel ${args.captureLabel} capture stalled after ${args.stallTimeoutMs}ms with no frame progress (last frame ${args.lastCapturedFrames}/${args.totalFrames}); retrying on a fresh screenshot session.${phases}`
+      (args.variant === "drain" ? `[Render] Parallel ${args.captureLabel} capture stalled: no frame progress for ${args.stallTimeoutMs}ms (stuck at ${args.lastCapturedFrames}/${args.totalFrames}).${phases}` : `[Render] Parallel ${args.captureLabel} capture stalled after ${args.stallTimeoutMs}ms with no frame progress (last frame ${args.lastCapturedFrames}/${args.totalFrames}); retrying on a fresh screenshot session.${phases}`) + ` ${STALL_ADVICE}`
     );
     this.name = "ParallelCaptureStallError";
     this.variant = args.variant;
@@ -3383,12 +3384,13 @@ function captureModeLabel(mode) {
 }
 var SequentialCaptureStallError = class extends Error {
   captureMode;
-  constructor(captureMode, stallTimeoutMs, frameIndex, totalFrames) {
+  constructor(session, stallTimeoutMs, frameIndex, totalFrames) {
+    const step = session.captureStep ? ` while ${session.captureStep}` : "";
     super(
-      `[Render] Sequential ${captureModeLabel(captureMode)} capture stalled: no frame progress for ${stallTimeoutMs}ms (stuck at frame ${frameIndex}/${totalFrames}).`
+      `[Render] Sequential ${captureModeLabel(session.captureMode)} capture stalled: no frame progress for ${stallTimeoutMs}ms (stuck at frame ${frameIndex}/${totalFrames}${step}). ` + STALL_ADVICE
     );
     this.name = "SequentialCaptureStallError";
-    this.captureMode = captureMode;
+    this.captureMode = session.captureMode;
   }
 };
 function raceAgainstStall(promise, deadlineMs, input, signal) {
@@ -3397,9 +3399,9 @@ function raceAgainstStall(promise, deadlineMs, input, signal) {
       () => {
         reject(
           signal?.aborted ? new Error(
-            `[Render] Sequential ${captureModeLabel(input.captureMode)} capture aborted while a capture call was in flight (frame ${input.frameIndex}/${input.totalFrames}).`
+            `[Render] Sequential ${captureModeLabel(input.session.captureMode)} capture aborted while a capture call was in flight (frame ${input.frameIndex}/${input.totalFrames}).`
           ) : new SequentialCaptureStallError(
-            input.captureMode,
+            input.session,
             input.stallTimeoutMs,
             input.frameIndex,
             input.totalFrames
@@ -3527,7 +3529,7 @@ async function runWorkerEncodePipelineLoop(session, totalFrames, job, currentEnc
   const captureWithStallGuard = (idx, promise) => raceAgainstStall(
     promise,
     stallTimeoutMs - (Date.now() - lastProgressAt),
-    { captureMode: session.captureMode, frameIndex: idx, totalFrames, stallTimeoutMs },
+    { session, frameIndex: idx, totalFrames, stallTimeoutMs },
     abortSignal
   );
   const drainPrev = async () => {
@@ -3881,7 +3883,7 @@ async function runCaptureStreamingStage(input) {
             const { buffer } = await raceAgainstStall(
               captureFrameToBuffer(session, i, time),
               stallTimeoutMs - (Date.now() - lastProgressAt),
-              { captureMode: session.captureMode, frameIndex: i, totalFrames, stallTimeoutMs },
+              { session, frameIndex: i, totalFrames, stallTimeoutMs },
               abortSignal
             );
             await reorderBuffer.waitForFrame(i);
@@ -3970,7 +3972,7 @@ async function captureSegmentFrames(ctx, segment, encoder) {
       ctx.captureFrame(ctx.session, i, time),
       ctx.stallTimeoutMs - (Date.now() - lastProgressAt),
       {
-        captureMode: ctx.session.captureMode,
+        session: ctx.session,
         frameIndex: i,
         totalFrames: ctx.totalFrames,
         stallTimeoutMs: ctx.stallTimeoutMs

package/dist/public-server.js

@@ -3379,12 +3379,13 @@ function buildRenderPerfSummary(input) {
 // src/services/render/stages/captureStreamingStage.ts
 var DEFAULT_CAPTURE_STALL_MS = 6e4;
 var DE_STALL_POLL_MS = 5e3;
+var STALL_ADVICE = "Chrome stopped answering. If another app is keeping the GPU or CPU busy (a 3D render, a game, another export), let it finish or render one job at a time, then retry.";
 var ParallelCaptureStallError = class extends Error {
   variant;
   constructor(args) {
     const phases = args.phaseSummary ? ` Last worker phases: ${args.phaseSummary}.` : "";
     super(
-      args.variant === "drain" ? `[Render] Parallel ${args.captureLabel} capture stalled: no frame progress for ${args.stallTimeoutMs}ms (stuck at ${args.lastCapturedFrames}/${args.totalFrames}).${phases}` : `[Render] Parallel ${args.captureLabel} capture stalled after ${args.stallTimeoutMs}ms with no frame progress (last frame ${args.lastCapturedFrames}/${args.totalFrames}); retrying on a fresh screenshot session.${phases}`
+      (args.variant === "drain" ? `[Render] Parallel ${args.captureLabel} capture stalled: no frame progress for ${args.stallTimeoutMs}ms (stuck at ${args.lastCapturedFrames}/${args.totalFrames}).${phases}` : `[Render] Parallel ${args.captureLabel} capture stalled after ${args.stallTimeoutMs}ms with no frame progress (last frame ${args.lastCapturedFrames}/${args.totalFrames}); retrying on a fresh screenshot session.${phases}`) + ` ${STALL_ADVICE}`
     );
     this.name = "ParallelCaptureStallError";
     this.variant = args.variant;
@@ -3402,12 +3403,13 @@ function captureModeLabel(mode) {
 }
 var SequentialCaptureStallError = class extends Error {
   captureMode;
-  constructor(captureMode, stallTimeoutMs, frameIndex, totalFrames) {
+  constructor(session, stallTimeoutMs, frameIndex, totalFrames) {
+    const step = session.captureStep ? ` while ${session.captureStep}` : "";
     super(
-      `[Render] Sequential ${captureModeLabel(captureMode)} capture stalled: no frame progress for ${stallTimeoutMs}ms (stuck at frame ${frameIndex}/${totalFrames}).`
+      `[Render] Sequential ${captureModeLabel(session.captureMode)} capture stalled: no frame progress for ${stallTimeoutMs}ms (stuck at frame ${frameIndex}/${totalFrames}${step}). ` + STALL_ADVICE
     );
     this.name = "SequentialCaptureStallError";
-    this.captureMode = captureMode;
+    this.captureMode = session.captureMode;
   }
 };
 function raceAgainstStall(promise, deadlineMs, input, signal) {
@@ -3416,9 +3418,9 @@ function raceAgainstStall(promise, deadlineMs, input, signal) {
       () => {
         reject(
           signal?.aborted ? new Error(
-            `[Render] Sequential ${captureModeLabel(input.captureMode)} capture aborted while a capture call was in flight (frame ${input.frameIndex}/${input.totalFrames}).`
+            `[Render] Sequential ${captureModeLabel(input.session.captureMode)} capture aborted while a capture call was in flight (frame ${input.frameIndex}/${input.totalFrames}).`
           ) : new SequentialCaptureStallError(
-            input.captureMode,
+            input.session,
             input.stallTimeoutMs,
             input.frameIndex,
             input.totalFrames
@@ -3546,7 +3548,7 @@ async function runWorkerEncodePipelineLoop(session, totalFrames, job, currentEnc
   const captureWithStallGuard = (idx, promise) => raceAgainstStall(
     promise,
     stallTimeoutMs - (Date.now() - lastProgressAt),
-    { captureMode: session.captureMode, frameIndex: idx, totalFrames, stallTimeoutMs },
+    { session, frameIndex: idx, totalFrames, stallTimeoutMs },
     abortSignal
   );
   const drainPrev = async () => {
@@ -3900,7 +3902,7 @@ async function runCaptureStreamingStage(input) {
             const { buffer } = await raceAgainstStall(
               captureFrameToBuffer(session, i, time),
               stallTimeoutMs - (Date.now() - lastProgressAt),
-              { captureMode: session.captureMode, frameIndex: i, totalFrames, stallTimeoutMs },
+              { session, frameIndex: i, totalFrames, stallTimeoutMs },
               abortSignal
             );
             await reorderBuffer.waitForFrame(i);
@@ -3989,7 +3991,7 @@ async function captureSegmentFrames(ctx, segment, encoder) {
       ctx.captureFrame(ctx.session, i, time),
       ctx.stallTimeoutMs - (Date.now() - lastProgressAt),
       {
-        captureMode: ctx.session.captureMode,
+        session: ctx.session,
         frameIndex: i,
         totalFrames: ctx.totalFrames,
         stallTimeoutMs: ctx.stallTimeoutMs

package/dist/services/render/stages/captureStreamingStage.d.ts

@@ -44,8 +44,9 @@ import type { ProducerLogger } from "../../../logger.js";
 import type { ProgressCallback, RenderJob } from "../../renderOrchestrator.js";
 import type { SdrStreamingCapturePlan } from "../capturePlan.js";
 export declare function resolveCaptureStallTimeoutMs(): number;
+type StalledSession = Pick<CaptureSession, "captureMode" | "captureStep">;
 export declare function raceAgainstStall<T>(promise: Promise<T>, deadlineMs: number, input: {
-    captureMode: CaptureSession["captureMode"];
+    session: StalledSession;
     frameIndex: number;
     totalFrames: number;
     stallTimeoutMs: number;
@@ -123,3 +124,4 @@ export type CaptureStreamingStageResult = {
     success: false;
 };
 export declare function runCaptureStreamingStage(input: CaptureStreamingStageInput): Promise<CaptureStreamingStageResult>;
+export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/producer",
-  "version": "0.8.146",
+  "version": "0.8.147",
   "description": "HTML-to-video rendering engine using Chrome's BeginFrame API",
   "repository": {
     "type": "git",
@@ -35,11 +35,11 @@
     "postcss": "^8.4.0",
     "puppeteer": "^25.2.1",
     "puppeteer-core": "^25.2.1",
-    "@hyperframes/lint": "0.8.146",
-    "@hyperframes/studio-server": "0.8.146",
-    "@hyperframes/core": "0.8.146",
-    "@hyperframes/parsers": "0.8.146",
-    "@hyperframes/engine": "0.8.146"
+    "@hyperframes/engine": "0.8.147",
+    "@hyperframes/core": "0.8.147",
+    "@hyperframes/lint": "0.8.147",
+    "@hyperframes/parsers": "0.8.147",
+    "@hyperframes/studio-server": "0.8.147"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
@@ -48,7 +48,7 @@
     "tsx": "^4.21.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.11",
-    "@hyperframes/aws-lambda": "0.8.146"
+    "@hyperframes/aws-lambda": "0.8.147"
   },
   "engines": {
     "node": ">=22"