@hyperframes/engine 0.8.152 → 0.8.154

package/dist/index.d.ts

@@ -35,7 +35,7 @@ export { SDR_RGB_TO_BT709_FILTER, SDR_RGB_TO_TAGGED_BT709_FILTER, } from "./util
 export { DEFAULT_VP9_CPU_USED, MAX_VP9_CPU_USED, MIN_VP9_CPU_USED, normalizeVp9CpuUsed, } from "./services/vp9Options.js";
 export { getCgroupMemoryLimitMb, getSystemTotalMb, isLowMemorySystem, LOW_MEMORY_TOTAL_MB_THRESHOLD, } from "./services/systemMemory.js";
 export { chromeMajorCeiling } from "./services/chromeHostCeiling.js";
-export { acquireBrowser, setHostHandlesSigint, releaseBrowser, drainBrowserPool, closeBrowserPool, resolveHeadlessShellPath, resolveBrowserGpuMode, buildChromeArgs, compositionRequiresWebGpu, assertWebGpuAdapterAvailable, usesSoftwareWebGpu, WebGpuUnavailableError, ENABLE_BROWSER_POOL, BrowserLeasePool, type BuildChromeArgsOptions, type BrowserLaunchFingerprint, type BrowserLease, type BrowserPoolState, type CaptureMode, type AcquiredBrowser, } from "./services/browserManager.js";
+export { acquireBrowser, setHostHandlesSigint, releaseBrowser, drainBrowserPool, closeBrowserPool, resolveHeadlessShellPath, resolveBrowserGpuMode, buildChromeArgs, compositionRequiresWebGpu, assertWebGpuAdapterAvailable, usesSoftwareWebGpu, WebGpuUnavailableError, ENABLE_BROWSER_POOL, BrowserLeasePool, type GpuProbeLifecycle, type BuildChromeArgsOptions, type BrowserLaunchFingerprint, type BrowserLease, type BrowserPoolState, type CaptureMode, type AcquiredBrowser, } from "./services/browserManager.js";
 export { augmentProtocolTimeoutError, isProtocolTimeoutError, } from "./services/protocolTimeoutErrorHint.js";
 export { augmentPageNavigationTimeoutError, isPageNavigationTimeoutError, type NavigationTimeoutHintContext, } from "./services/pageNavigationTimeoutErrorHint.js";
 export { createCaptureSession, initializeSession, closeCaptureSession, captureFrame, captureFrameToBuffer, captureFrameToBufferPipelined, captureFramesBatchPipelined, DrawElementVerificationError, isDrawElementVerificationError, getDrawElementVerificationDetails, type DrawElementVerificationDetails, recaptureDrawElementFrameForVerify, completeDeferredDrawElementInit, writeCapturedFrame, discardWarmupCapture, getCompositionDuration, getCapturePerfSummary, percentileOf, prepareCaptureSessionForReuse, deriveBeginFrameProbeTimeTicks, type CaptureSession, isTransientBrowserError, isMemoryExhaustionError, type BeforeCaptureHook, type DiscardWarmupInnerCapture, type StaticVerificationOutcome, VfxFailureError, } from "./services/frameCapture.js";

package/dist/services/browserManager.d.ts

@@ -4,7 +4,7 @@
  * Manages Puppeteer browser lifecycle: Chrome executable resolution,
  * launch args, pooled browser acquisition/release.
  */
-import type { Browser, Page, PuppeteerNode } from "puppeteer-core";
+import type { Browser, LaunchOptions, Page, PuppeteerNode } from "puppeteer-core";
 import { type EngineConfig } from "../config.js";
 import { type BrowserLaunchFingerprint, type BrowserLease, type CaptureMode } from "./browserLeasePool.js";
 export { BrowserLeasePool } from "./browserLeasePool.js";
@@ -14,6 +14,16 @@ export declare function setHostHandlesSigint(owned: boolean): void;
 export declare const sigintLaunchOptions: () => {
     handleSIGINT: boolean;
 };
+export interface GpuProbeLifecycle {
+    launch(puppeteer: PuppeteerNode, options: LaunchOptions): Promise<Browser>;
+    close(browser: Browser): Promise<void>;
+}
+interface GpuProbeOptions {
+    chromePath?: string;
+    browserTimeout?: number;
+    platform?: NodeJS.Platform;
+    probeLifecycle?: GpuProbeLifecycle;
+}
 export type AcquiredBrowser = BrowserLease;
 /**
  * Resolve chrome-headless-shell binary for deterministic BeginFrame rendering.
@@ -69,11 +79,7 @@ export declare function _resetAutoBrowserGpuModeCacheForTests(): void;
  * safe failure mode; misclassifying toward hardware would error on the real
  * render.
  */
-export declare function resolveBrowserGpuMode(mode: EngineConfig["browserGpuMode"], options?: {
-    chromePath?: string;
-    browserTimeout?: number;
-    platform?: NodeJS.Platform;
-}): Promise<"software" | "hardware">;
+export declare function resolveBrowserGpuMode(mode: EngineConfig["browserGpuMode"], options?: GpuProbeOptions): Promise<"software" | "hardware">;
 declare function createBrowserLaunchFingerprint(chromeArgs: string[], config?: Partial<Pick<EngineConfig, "browserTimeout" | "protocolTimeout" | "chromePath" | "forceScreenshot">>): BrowserLaunchFingerprint;
 /** Test-only export for launch-argument/capture-mode agreement. */
 export declare const _createBrowserLaunchFingerprintForTests: typeof createBrowserLaunchFingerprint;

package/dist/services/browserManager.js

@@ -51,7 +51,7 @@ const GPU_PROBE_TIMEOUT_MS = 15_000;
 async function probeHardwareWebGlInfo(ppt, options) {
     let probeBrowser;
     try {
-        probeBrowser = await ppt.launch({
+        const launchOptions = {
             ...sigintLaunchOptions(),
             headless: true,
             args: options.args,
@@ -59,12 +59,19 @@ async function probeHardwareWebGlInfo(ppt, options) {
             executablePath: options.executablePath,
             timeout: options.browserTimeout,
             waitForInitialPage: false,
-        });
+        };
+        probeBrowser = options.probeLifecycle
+            ? await options.probeLifecycle.launch(ppt, launchOptions)
+            : await ppt.launch(launchOptions);
         return await rejectAfter(readWebGlInfo(probeBrowser), GPU_PROBE_TIMEOUT_MS, `GPU probe page did not answer within ${GPU_PROBE_TIMEOUT_MS}ms`);
     }
     finally {
-        if (probeBrowser)
-            await closeBrowserAfterFailedProbe(probeBrowser);
+        if (probeBrowser) {
+            if (options.probeLifecycle)
+                await options.probeLifecycle.close(probeBrowser);
+            else
+                await closeBrowserAfterFailedProbe(probeBrowser);
+        }
     }
 }
 async function readWebGlInfo(browser) {
@@ -407,6 +414,7 @@ async function probeAutoBrowserGpuMode(options) {
             args: getHardwareGpuProbeArgs(platform),
             browserTimeout,
             executablePath,
+            probeLifecycle: options.probeLifecycle,
         });
         const resolved = resolveWebGlProbeMode(info);
         logResolvedBrowserGpuMode(resolved, describeWebGlProbe(info));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/engine",
-  "version": "0.8.152",
+  "version": "0.8.154",
   "description": "Seekable web page to video rendering engine (Puppeteer + FFmpeg)",
   "repository": {
     "type": "git",
@@ -46,8 +46,8 @@
     "linkedom": "^0.18.12",
     "puppeteer": "^25.8.0",
     "puppeteer-core": "^25.8.0",
-    "@hyperframes/core": "^0.8.152",
-    "@hyperframes/parsers": "^0.8.152"
+    "@hyperframes/core": "^0.8.154",
+    "@hyperframes/parsers": "^0.8.154"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",