@hyperframes/studio-server 0.9.6 → 0.9.8

package/dist/{chunk-CEQWOCYI.js → chunk-BAJ6HKBU.js}

@@ -1,7 +1,8 @@
 import {
+  PROXY_STILL_EXTENSION,
   PROXY_VARIANT_CONFIG,
   ffmpegHasHdrFilters
-} from "./chunk-FUTDRYQK.js";
+} from "./chunk-NOIHVBIQ.js";
 import {
   probeFirstFrameColour,
   probeMediaMetadata
@@ -36,9 +37,10 @@ import { extname, join } from "path";
 var DEFAULT_MAX_BYTES = 10 * 1024 * 1024 * 1024;
 var DEFAULT_STALE_TEMP_MS = 60 * 60 * 1e3;
 var DEFAULT_MIN_SWEEP_INTERVAL_MS = 5 * 60 * 1e3;
-var PROXY_EXTENSIONS = new Set(
-  Object.values(PROXY_VARIANT_CONFIG).map(({ extension }) => extension)
-);
+var PROXY_EXTENSIONS = /* @__PURE__ */ new Set([
+  ...Object.values(PROXY_VARIANT_CONFIG).map(({ extension }) => extension),
+  PROXY_STILL_EXTENSION
+]);
 var TRANSCODER_PROXY_NAME = /^[0-9a-f]{64}\.\w+$/;
 var TRANSCODER_TEMP_NAME = /^\.tmp-[0-9a-f-]{36}-(?:\.part-[0-9a-f]{64}-\d+|[0-9a-f]{64})\.\w+$/;
 var TRANSCODER_PIECE_NAME = /^\.part-([0-9a-f]{64})-\d+(\.\w+)$/;
@@ -1082,6 +1084,43 @@ async function resolveProxies(projectDir, sources, onSettled = () => {
   await Promise.all(Array.from({ length: workers }, worker));
   return results;
 }
+var stillsInFlight = /* @__PURE__ */ new Map();
+function resolveStill(projectDir, absoluteSourcePath, atSeconds, box) {
+  const source = canonicalizeProxySource(projectDir, absoluteSourcePath);
+  const at = Math.max(0, Math.round(atSeconds * 10) / 10);
+  const key = fastCopyKey(source.sourcePath, PROXY_PARAMS_VERSION, `still@${at}`, box);
+  const cachePath = join4(source.projectDir, CACHE_DIR_NAME, `${key}${PROXY_STILL_EXTENSION}`);
+  if (existsSync4(cachePath)) return Promise.resolve(cachePath);
+  const shared = stillsInFlight.get(cachePath);
+  if (shared) return shared;
+  const made = makeStill(source, at, box, cachePath).finally(
+    () => stillsInFlight.delete(cachePath)
+  );
+  stillsInFlight.set(cachePath, made);
+  return made;
+}
+async function makeStill(source, at, box, cachePath) {
+  const ffmpegPath = findFfBinary("ffmpeg", { configuredMustExist: true });
+  if (!ffmpegPath) throw new FfmpegUnavailableError();
+  const filter = await buildVideoFilter(
+    ffmpegPath,
+    source.sourcePath,
+    await probeMediaMetadata(source.sourcePath),
+    false,
+    box
+  );
+  mkdirWithinProject(source.projectDir, dirname3(cachePath));
+  const tempPath = join4(dirname3(cachePath), `.tmp-${randomUUID()}-${basename3(cachePath)}`);
+  try {
+    const args = ["-y", "-ss", String(at), "-i", source.sourcePath, "-map", "0:V:0"];
+    args.push("-frames:v", "1", "-vf", filter, "-pix_fmt", "yuvj420p", "-q:v", "3", tempPath);
+    await spawnFfmpeg(ffmpegPath, args, TRANSCODE_STALL_MS, new AbortController().signal);
+    renameSync(tempPath, cachePath);
+  } finally {
+    rmSync2(tempPath, { force: true });
+  }
+  return cachePath;
+}
 function joinJob(promise, job, signal) {
   job.callers++;
   if (!signal) return promise;
@@ -1117,5 +1156,6 @@ export {
   retryProxyCopy,
   proxyActivityMark,
   resolveProxy,
-  resolveProxies
+  resolveProxies,
+  resolveStill
 };

package/dist/{chunk-PN2VGFAA.js → chunk-J4SRRKQU.js}

@@ -1,14 +1,14 @@
 import {
   PROXY_PARAMS_VERSION,
   resolveProxy
-} from "./chunk-CEQWOCYI.js";
+} from "./chunk-BAJ6HKBU.js";
 import {
   createMediaCodecProbeCache,
   proxyVariantFor,
   recordProxyPrewarm,
   scanProjectMedia,
   shouldPrewarmProxy
-} from "./chunk-FUTDRYQK.js";
+} from "./chunk-NOIHVBIQ.js";
 
 // src/helpers/mediaProxyPreview.ts
 import { resolve } from "path";

package/dist/{chunk-FUTDRYQK.js → chunk-NOIHVBIQ.js}

@@ -98,6 +98,7 @@ var PROXY_VARIANT_CONFIG = {
   h264: { extension: ".mp4", contentType: "video/mp4" },
   vp8: { extension: ".webm", contentType: "video/webm" }
 };
+var PROXY_STILL_EXTENSION = ".jpg";
 function isProxyVariant(value) {
   return Object.hasOwn(PROXY_VARIANT_CONFIG, value);
 }
@@ -252,6 +253,7 @@ export {
   recordProxyPrewarm,
   recordProxyRequest,
   PROXY_VARIANT_CONFIG,
+  PROXY_STILL_EXTENSION,
   isProxyVariant,
   isProxyVariantRequest,
   proxyVariantFor,

package/dist/helpers/mediaCodecMap.d.ts

@@ -89,6 +89,7 @@ declare const PROXY_VARIANT_CONFIG: Record<ProxyVariant, {
     extension: ".mp4" | ".webm";
     contentType: "video/mp4" | "video/webm";
 }>;
+declare const PROXY_STILL_EXTENSION = ".jpg";
 declare function isProxyVariant(value: string): value is ProxyVariant;
 declare function isProxyVariantRequest(value: string): value is ProxyVariantRequest;
 declare function proxyVariantFor(facts: AssetCodecFacts): ProxyVariant;
@@ -144,4 +145,4 @@ declare function scanProjectMedia(projectDir: string, htmlSources: HtmlSourceLik
 /** The injection map alone: root-relative URL pathname -> codec facts of the hostile videos. */
 declare function scanProjectMediaCodecMap(projectDir: string, htmlSources: HtmlSourceLike[], options?: ScanProjectMediaCodecMapOptions): Promise<MediaCodecMap>;
 
-export { type AssetCodecFacts, BROWSER_HOSTILE_CODECS, type BrowserHostileCodec, type HtmlSourceLike, type MediaCodecMap, type MediaCodecProbeCache, type MediaProxyEligibility, type MediaProxyIneligibilityReason, PROXY_VARIANT_CONFIG, type ProjectMediaScan, type ProxyVariant, type ProxyVariantRequest, type ScanProjectMediaCodecMapOptions, createMediaCodecProbeCache, decideMediaProxyEligibility, isProxyVariant, isProxyVariantRequest, mediaProxyDemand, probeAssetCodec, proxyVariantFor, recordProxyPrewarm, recordProxyRequest, resolveProxyVariantRequest, scanProjectMedia, scanProjectMediaCodecMap, shouldPrewarmProxy };
+export { type AssetCodecFacts, BROWSER_HOSTILE_CODECS, type BrowserHostileCodec, type HtmlSourceLike, type MediaCodecMap, type MediaCodecProbeCache, type MediaProxyEligibility, type MediaProxyIneligibilityReason, PROXY_STILL_EXTENSION, PROXY_VARIANT_CONFIG, type ProjectMediaScan, type ProxyVariant, type ProxyVariantRequest, type ScanProjectMediaCodecMapOptions, createMediaCodecProbeCache, decideMediaProxyEligibility, isProxyVariant, isProxyVariantRequest, mediaProxyDemand, probeAssetCodec, proxyVariantFor, recordProxyPrewarm, recordProxyRequest, resolveProxyVariantRequest, scanProjectMedia, scanProjectMediaCodecMap, shouldPrewarmProxy };

package/dist/helpers/mediaCodecMap.js

@@ -1,5 +1,6 @@
 import {
   BROWSER_HOSTILE_CODECS,
+  PROXY_STILL_EXTENSION,
   PROXY_VARIANT_CONFIG,
   createMediaCodecProbeCache,
   decideMediaProxyEligibility,
@@ -14,13 +15,14 @@ import {
   scanProjectMedia,
   scanProjectMediaCodecMap,
   shouldPrewarmProxy
-} from "../chunk-FUTDRYQK.js";
+} from "../chunk-NOIHVBIQ.js";
 import "../chunk-X73QTST2.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
 export {
   BROWSER_HOSTILE_CODECS,
+  PROXY_STILL_EXTENSION,
   PROXY_VARIANT_CONFIG,
   createMediaCodecProbeCache,
   decideMediaProxyEligibility,

package/dist/helpers/mediaProxyPreview.js

@@ -4,9 +4,9 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-PN2VGFAA.js";
-import "../chunk-CEQWOCYI.js";
-import "../chunk-FUTDRYQK.js";
+} from "../chunk-J4SRRKQU.js";
+import "../chunk-BAJ6HKBU.js";
+import "../chunk-NOIHVBIQ.js";
 import "../chunk-X73QTST2.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";

package/dist/helpers/proxyTranscoder.d.ts

@@ -87,6 +87,8 @@ declare function resolveProxies(projectDir: string, sources: ReadonlyArray<{
     variant: ProxyVariant;
     box?: PreviewProxyBox;
 }>, onSettled?: (index: number) => void, onProgress?: (index: number, progress: ProxyProgress) => void, signal?: AbortSignal): Promise<PromiseSettledResult<string>[]>;
+/** One JPEG of the source at a time (to a tenth of a second), sized like the copy's box. */
+declare function resolveStill(projectDir: string, absoluteSourcePath: string, atSeconds: number, box?: PreviewProxyBox): Promise<string>;
 interface ResolveProxyOptions {
     priority?: boolean;
     background?: boolean;
@@ -95,4 +97,4 @@ interface ResolveProxyOptions {
     onProgress?: (progress: ProxyProgress) => void;
 }
 
-export { CACHE_DIR_NAME, DEFAULT_PROXY_WAIT_TIMEOUT_MS, FfmpegMissingFilterError, FfmpegUnavailableError, PROXY_CHUNK_SECONDS, PROXY_PARAMS_VERSION, PROXY_PENDING_RETRY_AFTER_SECONDS, ProxyCapacityError, type ProxyProgress, ProxySourceOutsideProjectError, ProxyTranscodeError, ProxyWaitTimeoutError, type ResolveProxyOptions, type SourceFolderKind, TRANSCODE_STALL_MS, clearFailedTranscodesForTest, getProxyCachePath, proxyActivityMark, proxyCopyProgress, resolveProxies, resolveProxy, retryProxyCopy, sourceFolderKind, waitForProxy };
+export { CACHE_DIR_NAME, DEFAULT_PROXY_WAIT_TIMEOUT_MS, FfmpegMissingFilterError, FfmpegUnavailableError, PROXY_CHUNK_SECONDS, PROXY_PARAMS_VERSION, PROXY_PENDING_RETRY_AFTER_SECONDS, ProxyCapacityError, type ProxyProgress, ProxySourceOutsideProjectError, ProxyTranscodeError, ProxyWaitTimeoutError, type ResolveProxyOptions, type SourceFolderKind, TRANSCODE_STALL_MS, clearFailedTranscodesForTest, getProxyCachePath, proxyActivityMark, proxyCopyProgress, resolveProxies, resolveProxy, resolveStill, retryProxyCopy, sourceFolderKind, waitForProxy };

package/dist/helpers/proxyTranscoder.js

@@ -17,11 +17,12 @@ import {
   proxyCopyProgress,
   resolveProxies,
   resolveProxy,
+  resolveStill,
   retryProxyCopy,
   sourceFolderKind,
   waitForProxy
-} from "../chunk-CEQWOCYI.js";
-import "../chunk-FUTDRYQK.js";
+} from "../chunk-BAJ6HKBU.js";
+import "../chunk-NOIHVBIQ.js";
 import "../chunk-X73QTST2.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
@@ -45,6 +46,7 @@ export {
   proxyCopyProgress,
   resolveProxies,
   resolveProxy,
+  resolveStill,
   retryProxyCopy,
   sourceFolderKind,
   waitForProxy

package/dist/index.js

@@ -91,7 +91,7 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "./chunk-PN2VGFAA.js";
+} from "./chunk-J4SRRKQU.js";
 import {
   CACHE_DIR_NAME,
   PROXY_PENDING_RETRY_AFTER_SECONDS,
@@ -102,9 +102,10 @@ import {
   proxyActivityMark,
   proxyCopyProgress,
   resolveProxy,
+  resolveStill,
   retryProxyCopy,
   waitForProxy
-} from "./chunk-CEQWOCYI.js";
+} from "./chunk-BAJ6HKBU.js";
 import {
   PROXY_VARIANT_CONFIG,
   decideMediaProxyEligibility,
@@ -112,7 +113,7 @@ import {
   probeAssetCodec,
   recordProxyRequest,
   resolveProxyVariantRequest
-} from "./chunk-FUTDRYQK.js";
+} from "./chunk-NOIHVBIQ.js";
 import {
   probeAudioTrack,
   probeMediaMetadata
@@ -3932,6 +3933,7 @@ import {
 import {
   STUDIO_PREVIEW_CAPTURE_MODE,
   STUDIO_PREVIEW_MARK_META,
+  STUDIO_PREVIEW_ERROR_KINDS,
   STUDIO_PREVIEW_ERRORS
 } from "@hyperframes/core/studio-preview-mark";
 import {
@@ -3940,6 +3942,7 @@ import {
   PREVIEW_PROXY_PRIORITY_HEADER,
   PREVIEW_PROXY_PROGRESS_HEADER,
   PREVIEW_PROXY_RETRY_PARAM,
+  PREVIEW_PROXY_STILL_PARAM,
   parsePreviewProxyBox
 } from "@hyperframes/core";
 import {
@@ -4278,7 +4281,7 @@ var GSAP_FALLBACK_ATTR = "data-hf-gsap-fallback";
 function gsapCdnFallbackScript(baseUrl) {
   return `<script ${GSAP_FALLBACK_ATTR}>
 (function(){
-  var cdnBase=${JSON.stringify(gsapCdnDist2(void 0, baseUrl)).replace(/</g, "\\u003c")};
+  var cdnBase=${scriptJson(gsapCdnDist2(void 0, baseUrl))};
   var loaded={};
   function loadFallback(file){
     if(loaded[file])return loaded[file];
@@ -4328,15 +4331,21 @@ function previewVariablesFromRequest(rawVariables) {
   return { raw: rawVariables, values: parse2.values };
 }
 var PREVIEW_CAPTURE_PARAM = "hf-capture";
-var EARLY_ERRORS_SCRIPT = `<script>(function(){var seen=window.${STUDIO_PREVIEW_ERRORS}=[];
-addEventListener("error",function(e){seen.push(e.message||String(e))});})();</script>`;
+function scriptJson(value) {
+  return JSON.stringify(value).replace(/</g, "\\u003c").replace(/\u2028/g, "\\u2028").replace(/\u2029/g, "\\u2029");
+}
+var earlyErrorsScript = (runtimeUrl) => `<script>(function(){var seen=window.${STUDIO_PREVIEW_ERRORS}=[],kinds=window.${STUDIO_PREVIEW_ERROR_KINDS}=[],known={SyntaxError:1,TypeError:1,ReferenceError:1,RangeError:1},runtime=${scriptJson(new URL(runtimeUrl, "http://x").pathname)};
+addEventListener("error",function(e){seen.push(e.message||String(e));
+var name=e.error&&e.error.constructor&&e.error.constructor.name,path="";
+try{var url=e.filename&&new URL(e.filename,window.location.href);if(url&&url.origin===window.location.origin)path=url.pathname}catch(_){}
+kinds.push({name:known[name]===1?name:"other",origin:!path?"unknown":path===runtime?"runtime":path.indexOf("/api/projects/")===0?"project":"studio"})});})();</script>`;
 function injectStudioPreviewAugmentations(html, adapter, projectDir, activeCompositionPath, options) {
   const marked = options.capture ? injectTagsAtHeadStart2(
     html,
     `<meta name="${STUDIO_PREVIEW_MARK_META}" content="${STUDIO_PREVIEW_CAPTURE_MODE}">`
   ) : injectTagsAtHeadStart2(
     lazyPreviewImages(html),
-    `<meta name="${STUDIO_PREVIEW_MARK_META}">${EARLY_ERRORS_SCRIPT}`
+    `<meta name="${STUDIO_PREVIEW_MARK_META}">${earlyErrorsScript(adapter.runtimeUrl)}`
   );
   const withFallback = injectGsapCdnFallback(
     injectProjectSignature(
@@ -4624,6 +4633,22 @@ ${etag}`;
         return c.text("media proxy variant does not match asset", 422);
       }
     }
+    const stillParam = c.req.query(PREVIEW_PROXY_STILL_PARAM);
+    if (stillParam !== void 0) {
+      const at = Number(stillParam);
+      if (stillParam === "" || !Number.isFinite(at) || at < 0 || !proxyVariant) {
+        return c.text("not found", 404);
+      }
+      try {
+        const still = await resolveStill(project.dir, file, at, proxyBox);
+        return new Response(readFileSync6(still), {
+          headers: { "Content-Type": "image/jpeg", "Cache-Control": "private, max-age=3600" }
+        });
+      } catch (err) {
+        if (isProjectRootMissing(err)) throw err;
+        return c.text("media still failed", 502);
+      }
+    }
     const tag = settledFileTag(stat2);
     const etag = tag && `"${tag}${proxyEtagSalt(proxyVariant, proxyBox)}"`;
     const cacheHeaders = isText ? { "Cache-Control": "no-store" } : { "Cache-Control": "private, no-cache", ...etag && { ETag: etag } };
@@ -4806,6 +4831,13 @@ function contentDispositionHeader(disposition, filename) {
 }
 function registerRenderRoutes(api, adapter) {
   const renderJobs = /* @__PURE__ */ new Map();
+  const nextFreeRenderJobId = (baseId, ext, rendersDir) => {
+    let jobId = baseId;
+    for (let n = 2; renderJobs.has(jobId) || existsSync6(join10(rendersDir, `${jobId}${ext}`)); n++) {
+      jobId = `${baseId}-${n}`;
+    }
+    return jobId;
+  };
   const TTL_MS = 3e5;
   const CLEANUP_INTERVAL_MS = 6e4;
   let cleanupTimer = null;
@@ -4869,11 +4901,14 @@ function registerRenderRoutes(api, adapter) {
       return c.json({ error: "pageMotionBlur must be off when supplied" }, 400);
     }
     const pageMotionBlur = requestedPageMotionBlur === void 0 && body.previewMotionBlur === false ? "off" : requestedPageMotionBlur;
-    const now = /* @__PURE__ */ new Date();
-    const jobId = `${project.id}_${formatRenderOutputTimestamp(now)}`;
     const rendersDir = adapter.rendersDir(project);
     mkdirWithinProject(project.dir, rendersDir);
     const ext = FORMAT_EXT[format] ?? ".mp4";
+    const jobId = nextFreeRenderJobId(
+      `${project.id}_${formatRenderOutputTimestamp(/* @__PURE__ */ new Date())}`,
+      ext,
+      rendersDir
+    );
     const outputPath = join10(rendersDir, `${jobId}${ext}`);
     const jobState = adapter.startRender({
       project,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.9.6",
+  "version": "0.9.8",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -88,8 +88,8 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.2",
-    "@hyperframes/parsers": "0.9.6",
-    "@hyperframes/core": "0.9.6"
+    "@hyperframes/core": "0.9.8",
+    "@hyperframes/parsers": "0.9.8"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",