@hyperframes/engine 0.8.86 → 0.8.88

package/dist/services/frameCapture.js

@@ -366,9 +366,19 @@ export function prepareBeginFrameTimeline(session, state, warmupIntervalMs) {
         },
     };
 }
+/** Runs BeginFrame session setup; a failure stops the warm-up loop, which would otherwise tick forever. */
+export async function cancelWarmupOnError(state, setup) {
+    try {
+        return await setup();
+    }
+    catch (error) {
+        state.cancelled = true;
+        throw error;
+    }
+}
 export async function driveWarmupTicks(options, state) {
     const sleep = options.sleep ?? realSleep;
-    while (true) {
+    while (!state.cancelled) {
         if (options.lockWarmupTicks) {
             // Locked mode exits on the iteration count, ignoring `state.running` —
             // the caller flips `running=false` after page-readiness but we keep
@@ -1771,76 +1781,72 @@ export async function initializeSession(session) {
     })();
     warmupLoopPromise.catch(() => { });
     logInitPhase("warmup loop started");
-    await gotoEntryPage();
-    logInitPhase("page.goto complete");
-    // Flush the GSAP proxy queue synchronously. In BeginFrame mode the rAF-based
-    // batch drain runs on the warmup loop's 33ms ticks — for tween-heavy
-    // compositions this is the dominant init cost. Flushing synchronously
-    // eliminates the wait entirely.
-    await page.evaluate(`window.__hfFlushSync?.()`);
-    logInitPhase("GSAP proxy flush complete");
-    // Poll for window.__hf readiness using manual evaluate loop (waitForFunction
-    // uses rAF polling internally, which won't fire in beginFrame mode).
-    const pageReadyTimeout = session.config?.playerReadyTimeout ?? DEFAULT_CONFIG.playerReadyTimeout;
-    try {
+    await cancelWarmupOnError(warmupState, async () => {
+        await gotoEntryPage();
+        logInitPhase("page.goto complete");
+        // Flush the GSAP proxy queue synchronously. In BeginFrame mode the rAF-based
+        // batch drain runs on the warmup loop's 33ms ticks — for tween-heavy
+        // compositions this is the dominant init cost. Flushing synchronously
+        // eliminates the wait entirely.
+        await page.evaluate(`window.__hfFlushSync?.()`);
+        logInitPhase("GSAP proxy flush complete");
+        // Poll for window.__hf readiness using manual evaluate loop (waitForFunction
+        // uses rAF polling internally, which won't fire in beginFrame mode).
+        const pageReadyTimeout = session.config?.playerReadyTimeout ?? DEFAULT_CONFIG.playerReadyTimeout;
         await pollHfReady(page, pageReadyTimeout);
         logInitPhase("pollHfReady complete");
-    }
-    catch (err) {
-        warmupState.running = false;
-        throw err;
-    }
-    session.subTimelineWaitOutcome = await pollSubCompositionTimelines(page, pageReadyTimeout, undefined, () => session.scriptLoadFailures, undefined, (ids) => {
-        session.pendingTimelineIds = [...ids];
+        session.subTimelineWaitOutcome = await pollSubCompositionTimelines(page, pageReadyTimeout, undefined, () => session.scriptLoadFailures, undefined, (ids) => {
+            session.pendingTimelineIds = [...ids];
+        });
+        logInitPhase(`pollSubCompositionTimelines complete (${session.subTimelineWaitOutcome})`);
+        recordSubTimelineWarning(session, pageReadyTimeout);
+        await applyVideoMetadataHints(page, session.options.videoMetadataHints);
+        logInitPhase("applyVideoMetadataHints complete");
+        // Run independent readiness checks in parallel — videos, images, fonts,
+        // and Tailwind don't depend on each other's completion.
+        const bfSkipVideoIds = session.options.skipReadinessVideoIds ?? [];
+        const [bfVideosReady] = await Promise.all([
+            pollVideosReady(page, bfSkipVideoIds, pageReadyTimeout),
+            pollImagesReady(page, pageReadyTimeout).then(async (ready) => {
+                if (!ready) {
+                    const failedImages = await page.evaluate(() => {
+                        return Array.from(document.querySelectorAll("img"))
+                            .filter((img) => {
+                            const ie = img;
+                            const src = ie.getAttribute("src") || "";
+                            if (!src || src.startsWith("data:"))
+                                return false;
+                            return !(ie.complete && ie.naturalWidth > 0);
+                        })
+                            .map((img) => img.src || img.getAttribute("src") || "(no src)")
+                            .join(", ");
+                    });
+                    console.warn(`[FrameCapture] Some image elements did not load within ${pageReadyTimeout}ms: ${failedImages}. ` +
+                        `Continuing render — affected images may appear blank/missing in early frames.`);
+                }
+                await decodeAllImages(page);
+                return ready;
+            }),
+            page.evaluate(`document.fonts?.ready`),
+            waitForOptionalTailwindReady(page, pageReadyTimeout),
+        ]);
+        logInitPhase("media + fonts + tailwind ready");
+        if (!bfVideosReady) {
+            const failedVideos = await page.evaluate((skipIdList) => {
+                const skip = new Set(skipIdList);
+                return Array.from(document.querySelectorAll("video"))
+                    .filter((v) => !skip.has(v.id))
+                    .filter((v) => v.readyState < 2 && !v.error)
+                    .map((v) => v.src || v.getAttribute("src") || "(no src)")
+                    .join(", ");
+            }, bfSkipVideoIds);
+            console.warn(`[FrameCapture] Some video elements did not decode within ${pageReadyTimeout}ms: ${failedVideos}. ` +
+                `Continuing render — affected videos will appear as blank/black frames.`);
+        }
+        recordCaptureWarnings(session, await collectMediaReadinessWarnings(page, bfSkipVideoIds, pageReadyTimeout));
+        await recordLiveMapWarning(session, page);
+        await recordSessionInitTelemetry(session, initStart);
     });
-    logInitPhase(`pollSubCompositionTimelines complete (${session.subTimelineWaitOutcome})`);
-    recordSubTimelineWarning(session, pageReadyTimeout);
-    await applyVideoMetadataHints(page, session.options.videoMetadataHints);
-    logInitPhase("applyVideoMetadataHints complete");
-    // Run independent readiness checks in parallel — videos, images, fonts,
-    // and Tailwind don't depend on each other's completion.
-    const bfSkipVideoIds = session.options.skipReadinessVideoIds ?? [];
-    const [bfVideosReady] = await Promise.all([
-        pollVideosReady(page, bfSkipVideoIds, pageReadyTimeout),
-        pollImagesReady(page, pageReadyTimeout).then(async (ready) => {
-            if (!ready) {
-                const failedImages = await page.evaluate(() => {
-                    return Array.from(document.querySelectorAll("img"))
-                        .filter((img) => {
-                        const ie = img;
-                        const src = ie.getAttribute("src") || "";
-                        if (!src || src.startsWith("data:"))
-                            return false;
-                        return !(ie.complete && ie.naturalWidth > 0);
-                    })
-                        .map((img) => img.src || img.getAttribute("src") || "(no src)")
-                        .join(", ");
-                });
-                console.warn(`[FrameCapture] Some image elements did not load within ${pageReadyTimeout}ms: ${failedImages}. ` +
-                    `Continuing render — affected images may appear blank/missing in early frames.`);
-            }
-            await decodeAllImages(page);
-            return ready;
-        }),
-        page.evaluate(`document.fonts?.ready`),
-        waitForOptionalTailwindReady(page, pageReadyTimeout),
-    ]);
-    logInitPhase("media + fonts + tailwind ready");
-    if (!bfVideosReady) {
-        const failedVideos = await page.evaluate((skipIdList) => {
-            const skip = new Set(skipIdList);
-            return Array.from(document.querySelectorAll("video"))
-                .filter((v) => !skip.has(v.id))
-                .filter((v) => v.readyState < 2 && !v.error)
-                .map((v) => v.src || v.getAttribute("src") || "(no src)")
-                .join(", ");
-        }, bfSkipVideoIds);
-        console.warn(`[FrameCapture] Some video elements did not decode within ${pageReadyTimeout}ms: ${failedVideos}. ` +
-            `Continuing render — affected videos will appear as blank/black frames.`);
-    }
-    recordCaptureWarnings(session, await collectMediaReadinessWarnings(page, bfSkipVideoIds, pageReadyTimeout));
-    await recordLiveMapWarning(session, page);
-    await recordSessionInitTelemetry(session, initStart);
     // Stop warmup, then drain the loop in BOTH modes before any further
     // BeginFrame on this session (drawElement init, the render-frame commit tick
     // at the end of init, and frame 0). Clearing the flag only stops new