@@ -3,7 +3,7 @@ import { afterEach, describe, expect, it, vi } from "vitest";
33import { mkdirSync , mkdtempSync , readFileSync , rmSync , writeFileSync } from "node:fs" ;
44import { tmpdir } from "node:os" ;
55import { basename , join } from "node:path" ;
6- import { fileContentVersion } from "@hyperframes/studio-server" ;
6+ import { createProjectSignature , fileContentVersion } from "@hyperframes/studio-server" ;
77import { loadHyperframeRuntimeSource } from "@hyperframes/core" ;
88import { loadRuntimeSource } from "./runtimeSource.js" ;
99import { findFFmpeg , findFFprobe } from "../browser/ffmpeg.js" ;
@@ -43,6 +43,10 @@ vi.mock("@hyperframes/engine", () => ({
4343 killTrackedProcesses : ( ) => { } ,
4444 closeBrowserPool : ( ) => engineState . closeBrowserPool ( ) ,
4545} ) ) ;
46+ vi . mock ( "@hyperframes/studio-server" , async ( importOriginal ) => {
47+ const actual = await importOriginal < typeof import ( "@hyperframes/studio-server" ) > ( ) ;
48+ return { ...actual , createProjectSignature : vi . fn ( actual . createProjectSignature ) } ;
49+ } ) ;
4650vi . mock ( "../browser/gpuPolicy.js" , ( ) => ( {
4751 resolveCaptureBrowserGpuMode : async ( ) => "software" ,
4852 resolveLocalBrowserGpuMode : ( ) => "software" ,
@@ -386,6 +390,66 @@ describe("createStudioServer shutdown", () => {
386390 } ) ;
387391} ) ;
388392
393+ describe ( "Studio thumbnail capture" , ( ) => {
394+ function fakePageBrowser ( onEvaluate = ( ) => { } ) {
395+ const screenshot = vi . fn ( async ( ) => Buffer . from ( "jpeg" ) ) ;
396+ const evaluate = vi . fn ( async ( ) => onEvaluate ( ) ) ;
397+ const page = new Proxy (
398+ { screenshot, evaluate } ,
399+ {
400+ get : ( target , key ) =>
401+ key === "then"
402+ ? undefined
403+ : key in target
404+ ? target [ key as keyof typeof target ]
405+ : async ( ) => { } ,
406+ } ,
407+ ) ;
408+ engineState . acquireBrowser = async ( ) => ( {
409+ browser : { connected : true , newPage : async ( ) => page , on : ( ) => { } } ,
410+ release : async ( ) => { } ,
411+ } ) ;
412+ return { screenshot } ;
413+ }
414+ const opts = ( dir : string , signal = new AbortController ( ) . signal ) => ( {
415+ project : { id : "demo" , dir, title : "demo" } ,
416+ compPath : "index.html" ,
417+ seekTime : 0.5 ,
418+ width : 640 ,
419+ height : 360 ,
420+ outputWidth : 640 ,
421+ outputHeight : 360 ,
422+ previewUrl : "http://localhost/preview" ,
423+ signal,
424+ } ) ;
425+
426+ it ( "stops a thumbnail whose request is aborted before its screenshot" , async ( ) => {
427+ let abortOnEvaluate : AbortController | undefined ;
428+ const { screenshot } = fakePageBrowser ( ( ) => abortOnEvaluate ?. abort ( ) ) ;
429+ const dir = tmpProject ( ) ;
430+ server = createStudioServer ( { projectDir : dir } ) ;
431+ await expect ( server . adapter . generateThumbnail ?.( opts ( dir ) ) ) . resolves . toBeInstanceOf ( Buffer ) ;
432+ expect ( screenshot ) . toHaveBeenCalledTimes ( 1 ) ;
433+
434+ const aborting = new AbortController ( ) ;
435+ abortOnEvaluate = aborting ;
436+ await expect (
437+ server . adapter . generateThumbnail ?.( opts ( dir , aborting . signal ) ) ,
438+ ) . resolves . toBeNull ( ) ;
439+ expect ( screenshot ) . toHaveBeenCalledTimes ( 1 ) ;
440+ } ) ;
441+
442+ it ( "reuses the cached project signature instead of walking the project per thumbnail" , async ( ) => {
443+ fakePageBrowser ( ) ;
444+ const dir = tmpProject ( ) ;
445+ server = createStudioServer ( { projectDir : dir } ) ;
446+ await server . adapter . generateThumbnail ?.( opts ( dir ) ) ;
447+ const walks = vi . mocked ( createProjectSignature ) . mock . calls . length ;
448+ for ( let i = 0 ; i < 3 ; i ++ ) await server . adapter . generateThumbnail ?.( opts ( dir ) ) ;
449+ expect ( vi . mocked ( createProjectSignature ) . mock . calls . length ) . toBe ( walks ) ;
450+ } ) ;
451+ } ) ;
452+
389453describe ( "Studio project lint endpoint" , ( ) => {
390454 it ( "surfaces findings that require the complete project graph" , async ( ) => {
391455 const projectDir = tmpProject ( ) ;
0 commit comments