@hyperframes/studio-server 0.8.202 → 0.8.203

package/dist/{chunk-C2RFW2FX.js → chunk-JKPLDWAB.js}

@@ -125,6 +125,30 @@ function sourceFactsOf(stream, formatBitrate) {
     bitrate: Number.isFinite(bitrate) ? bitrate : 0
   };
 }
+var STREAM_SUMMARY_MAX = 12;
+function summarizeStream(stream) {
+  const flags = Object.entries(stream.disposition ?? {}).filter(([, on]) => on === 1).map(([name]) => name);
+  return `${stream.codec_type ?? "?"}:${stream.codec_name ?? "?"}[${flags.join(",")}]`;
+}
+function metadataFromProbe(kind, parsed) {
+  const stream = parsed.streams?.find((item) => {
+    if (kind === "image") return item.codec_type === "video";
+    return item.codec_type === kind && item.disposition?.attached_pic !== 1;
+  });
+  const metadata = {
+    kind,
+    color: classifyMediaColor(stream),
+    streams: (parsed.streams ?? []).slice(0, STREAM_SUMMARY_MAX).map(summarizeStream)
+  };
+  if (kind === "video") {
+    metadata.hasAudio = (parsed.streams ?? []).some((item) => item.codec_type === "audio");
+    metadata.hasAlpha = stream !== void 0 && videoStreamHasAlpha(stream);
+    const duration = Number(parsed.format?.duration);
+    if (Number.isFinite(duration) && duration > 0) metadata.durationSeconds = duration;
+    metadata.source = sourceFactsOf(stream, parsed.format?.bit_rate);
+  }
+  return metadata;
+}
 async function probeMediaMetadata(filePath, runner = execFileRunner) {
   const kind = inferKindFromPath(filePath);
   if (kind === "audio" || kind === "unknown") {
@@ -140,7 +164,7 @@ async function probeMediaMetadata(filePath, runner = execFileRunner) {
       "-v",
       "error",
       "-show_entries",
-      "stream=codec_type,codec_name,profile,pix_fmt,color_space,color_transfer,color_primaries,bits_per_raw_sample,width,height,bit_rate:stream_disposition=attached_pic:stream_tags=alpha_mode:format=duration,bit_rate",
+      "stream=codec_type,codec_name,profile,pix_fmt,color_space,color_transfer,color_primaries,bits_per_raw_sample,width,height,bit_rate:stream_disposition:stream_tags=alpha_mode:format=duration,bit_rate",
       "-of",
       "json",
       "--",
@@ -155,20 +179,7 @@ async function probeMediaMetadata(filePath, runner = execFileRunner) {
     return { kind, color: classifyMediaColor(null), probeError: "ffprobe failed" };
   }
   try {
-    const parsed = JSON.parse(String(result.stdout || "{}"));
-    const stream = parsed.streams?.find((item) => {
-      if (kind === "image") return item.codec_type === "video";
-      return item.codec_type === kind && item.disposition?.attached_pic !== 1;
-    });
-    const metadata = { kind, color: classifyMediaColor(stream) };
-    if (kind === "video") {
-      metadata.hasAudio = (parsed.streams ?? []).some((item) => item.codec_type === "audio");
-      metadata.hasAlpha = stream !== void 0 && videoStreamHasAlpha(stream);
-      const duration = Number(parsed.format?.duration);
-      if (Number.isFinite(duration) && duration > 0) metadata.durationSeconds = duration;
-      metadata.source = sourceFactsOf(stream, parsed.format?.bit_rate);
-    }
-    return metadata;
+    return metadataFromProbe(kind, JSON.parse(String(result.stdout || "{}")));
   } catch {
     return { kind, color: classifyMediaColor(null), probeError: "ffprobe returned invalid json" };
   }
@@ -348,7 +359,7 @@ async function scanProjectMedia(projectDir, htmlSources, options = {}) {
   const scan = { codecMap: {}, sourceFacts: {} };
   for (const [pathname, facts] of await probeProjectAssets(projectDir, htmlSources, options)) {
     if (facts?.browserHostile) scan.codecMap[pathname] = facts;
-    if (facts?.source) scan.sourceFacts[pathname] = facts.source;
+    if (facts?.source) scan.sourceFacts[pathname] = { ...facts.source, codec: facts.codecName };
   }
   return scan;
 }

package/dist/{chunk-RX6VALW3.js → chunk-MNJZQCBL.js}

@@ -2,7 +2,7 @@ import {
   PROXY_VARIANT_CONFIG,
   probeFirstFrameColour,
   probeMediaMetadata
-} from "./chunk-C2RFW2FX.js";
+} from "./chunk-JKPLDWAB.js";
 import {
   mkdirWithinProject,
   realProjectRoot,
@@ -185,6 +185,18 @@ async function contentCopyKey(sourcePath, version, variant, box, signal) {
   }
   return digest(hash.digest("hex"), version, variant, boxPart(box));
 }
+function sourceSizeBytes(sourcePath) {
+  try {
+    const fd = openSync(sourcePath, "r");
+    try {
+      return fstatSync(fd).size;
+    } finally {
+      closeSync(fd);
+    }
+  } catch {
+    return void 0;
+  }
+}
 function fastIndexPath(cachePath) {
   return join2(dirname(cachePath), `.fast-${basename(cachePath, extname2(cachePath))}`);
 }
@@ -515,11 +527,53 @@ function proxyScaleFilter(box) {
   return `scale=${width}:${height}`;
 }
 var STDERR_ERROR_LINE = /error|invalid|denied|no space|not found|unknown/i;
-function stderrReason(stderrTail) {
-  const lines = stderrTail.split("\n").map((line2) => line2.trim()).filter(Boolean);
-  const errorLines = lines.filter((line2) => STDERR_ERROR_LINE.test(line2));
-  const line = errorLines.at(-1) ?? lines.at(-1);
-  return line ? `: ${line.replace(/[.!]+$/, "")}` : "";
+var OPEN_OUTPUT_LINE = /^Error opening output file /;
+var ABSOLUTE_PATH = /(?:[A-Za-z]:)?(?:[\\/][^\\/\s'"]+){2,}/g;
+var REASON_LINES = 3;
+function stderrReason(stderrTail, knownPaths) {
+  const lines = stderrTail.split("\n").map((line) => line.trim()).filter(Boolean);
+  const openedAt = lines.map((candidate) => OPEN_OUTPUT_LINE.test(candidate)).lastIndexOf(true);
+  const causes = lines.filter(
+    (line, index) => !OPEN_OUTPUT_LINE.test(line) && (STDERR_ERROR_LINE.test(line) || index === openedAt - 1)
+  );
+  const shown = (causes.length ? causes : lines.slice(-1)).slice(-REASON_LINES);
+  const byLength = knownPaths.filter(isAbsolute).sort((a, b) => b.length - a.length);
+  const reason = shown.map(
+    (line) => byLength.reduce((text, path) => text.split(path).join("<path>"), line).replace(ABSOLUTE_PATH, "<path>").replace(/[.!]+$/, "")
+  );
+  return reason.length ? `: ${reason.join("; ")}` : "";
+}
+var CLOUD_FOLDER = /\/(?:Library\/CloudStorage|Dropbox|OneDrive|Google Drive)(?:[ \-/]|$)/i;
+function sourceFolderKind(sourcePath) {
+  const path = sourcePath.replace(/\\/g, "/");
+  if (path.includes("/Library/Mobile Documents/")) return "icloud";
+  if (CLOUD_FOLDER.test(path)) return "cloud-storage";
+  return path.startsWith("/Volumes/") ? "external-volume" : "local";
+}
+function describeSource(sourcePath, metadata) {
+  const { codecName, pixelFormat, colorTransfer } = metadata.color;
+  const megabytes = sourceSizeBytes(sourcePath);
+  return [
+    metadata.kind,
+    codecName,
+    pixelFormat,
+    colorTransfer,
+    metadata.hasAudio ? "with audio" : "no audio",
+    metadata.streams?.length ? `streams ${metadata.streams.join(" ")}` : void 0,
+    metadata.durationSeconds ? `${Math.round(metadata.durationSeconds)}s` : void 0,
+    megabytes === void 0 ? "missing" : `${Math.round(megabytes / 1e6)} MB`,
+    sourceFolderKind(sourcePath)
+  ].filter(Boolean).join(", ");
+}
+function withSource(err, describe) {
+  if (err instanceof ProxyTranscodeError && err.name === "ProxyTranscodeError") {
+    return new ProxyTranscodeError(
+      `${err.message} (source: ${describe()})`,
+      err.exitCode,
+      err.stderrTail
+    );
+  }
+  return err;
 }
 function chunkRanges(durationSeconds) {
   if (!durationSeconds || durationSeconds <= PROXY_CHUNK_SECONDS * 1.5) return null;
@@ -736,24 +790,28 @@ async function runFfmpeg(sourcePath, outputPath, chunkPrefix, variant, box, sign
     onEncoded
   );
   const ranges = chunkRanges(totalSeconds);
-  if (!ranges) {
-    return encode(
+  try {
+    if (!ranges) {
+      return await encode(
+        outputPath,
+        void 0,
+        signal,
+        (encodedSeconds) => onProgress({ doneSeconds: encodedSeconds, totalSeconds })
+      );
+    }
+    await encodeInChunks(
+      ranges,
+      chunkPrefix,
       outputPath,
-      void 0,
+      encode,
+      (listPath, target) => spawnFfmpeg(ffmpegPath, concatArgs(listPath, target, variant), CONCAT_TIMEOUT_MS, signal),
       signal,
-      (encodedSeconds) => onProgress({ doneSeconds: encodedSeconds, totalSeconds })
+      gate,
+      (doneSeconds) => onProgress({ doneSeconds, totalSeconds })
     );
+  } catch (err) {
+    throw withSource(err, () => describeSource(sourcePath, metadata));
   }
-  await encodeInChunks(
-    ranges,
-    chunkPrefix,
-    outputPath,
-    encode,
-    (listPath, target) => spawnFfmpeg(ffmpegPath, concatArgs(listPath, target, variant), CONCAT_TIMEOUT_MS, signal),
-    signal,
-    gate,
-    (doneSeconds) => onProgress({ doneSeconds, totalSeconds })
-  );
 }
 function concatArgs(listPath, target, variant) {
   return [
@@ -834,7 +892,7 @@ function spawnFfmpeg(ffmpegPath, args, stallMs, signal, onProgress) {
       } else {
         reject(
           new ProxyTranscodeError(
-            `ffmpeg exited with code ${code}${stderrReason(stderrTail)}`,
+            `ffmpeg exited with code ${code}${stderrReason(stderrTail, args)}`,
             code,
             stderrTail
           )
@@ -893,6 +951,15 @@ async function transcodeToCache(job, projectDir, absoluteSourcePath, cachePath,
     releaseSlot();
   }
 }
+function proxyCopyProgress(projectDir, absoluteSourcePath, variant, box) {
+  const source = canonicalizeProxySource(projectDir, absoluteSourcePath);
+  const progress = inFlight.get(getCanonicalProxyCachePath(source, variant, box))?.job.lastProgress;
+  return progress?.totalSeconds ? Math.min(1, progress.doneSeconds / progress.totalSeconds) : void 0;
+}
+function retryProxyCopy(projectDir, absoluteSourcePath, variant, box) {
+  const source = canonicalizeProxySource(projectDir, absoluteSourcePath);
+  failedTranscodes.delete(getCanonicalProxyCachePath(source, variant, box));
+}
 var proxyActivity = 0;
 function proxyActivityMark(projectDir) {
   if (!existsSync4(projectDir)) return String(proxyActivity);
@@ -1019,6 +1086,9 @@ export {
   waitForProxy,
   getProxyCachePath,
   clearFailedTranscodesForTest,
+  sourceFolderKind,
+  proxyCopyProgress,
+  retryProxyCopy,
   proxyActivityMark,
   resolveProxy,
   resolveProxies

package/dist/{chunk-2MJKVMZU.js → chunk-OAHY2RQP.js}

@@ -1,14 +1,14 @@
 import {
   PROXY_PARAMS_VERSION,
   resolveProxy
-} from "./chunk-RX6VALW3.js";
+} from "./chunk-MNJZQCBL.js";
 import {
   createMediaCodecProbeCache,
   proxyVariantFor,
   recordProxyPrewarm,
   scanProjectMedia,
   shouldPrewarmProxy
-} from "./chunk-C2RFW2FX.js";
+} from "./chunk-JKPLDWAB.js";
 
 // src/helpers/mediaProxyPreview.ts
 import { resolve } from "path";

package/dist/helpers/mediaCodecMap.js

@@ -14,7 +14,7 @@ import {
   scanProjectMedia,
   scanProjectMediaCodecMap,
   shouldPrewarmProxy
-} from "../chunk-C2RFW2FX.js";
+} from "../chunk-JKPLDWAB.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/helpers/mediaProxyPreview.js

@@ -4,9 +4,9 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-2MJKVMZU.js";
-import "../chunk-RX6VALW3.js";
-import "../chunk-C2RFW2FX.js";
+} from "../chunk-OAHY2RQP.js";
+import "../chunk-MNJZQCBL.js";
+import "../chunk-JKPLDWAB.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/helpers/proxyTranscoder.d.ts

@@ -59,6 +59,11 @@ interface ProxyProgress {
 /** Test hook: forget remembered transcode failures (module state persists
  * across tests that don't reload the module). */
 declare function clearFailedTranscodesForTest(): void;
+type SourceFolderKind = "icloud" | "cloud-storage" | "external-volume" | "local";
+/** Where a source lives, in the terms that decide whether its file can be read and written normally. */
+declare function sourceFolderKind(sourcePath: string): SourceFolderKind;
+declare function proxyCopyProgress(projectDir: string, absoluteSourcePath: string, variant: ProxyVariant, box?: PreviewProxyBox): number | undefined;
+declare function retryProxyCopy(projectDir: string, absoluteSourcePath: string, variant: ProxyVariant, box?: PreviewProxyBox): void;
 /** Null while this project has a copy in progress; otherwise a mark that moves when any copy finishes or is refused. */
 declare function proxyActivityMark(projectDir: string): string | null;
 /**
@@ -89,4 +94,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, TRANSCODE_STALL_MS, clearFailedTranscodesForTest, getProxyCachePath, proxyActivityMark, resolveProxies, resolveProxy, 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, retryProxyCopy, sourceFolderKind, waitForProxy };

package/dist/helpers/proxyTranscoder.js

@@ -14,11 +14,14 @@ import {
   clearFailedTranscodesForTest,
   getProxyCachePath,
   proxyActivityMark,
+  proxyCopyProgress,
   resolveProxies,
   resolveProxy,
+  retryProxyCopy,
+  sourceFolderKind,
   waitForProxy
-} from "../chunk-RX6VALW3.js";
-import "../chunk-C2RFW2FX.js";
+} from "../chunk-MNJZQCBL.js";
+import "../chunk-JKPLDWAB.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
@@ -38,7 +41,10 @@ export {
   clearFailedTranscodesForTest,
   getProxyCachePath,
   proxyActivityMark,
+  proxyCopyProgress,
   resolveProxies,
   resolveProxy,
+  retryProxyCopy,
+  sourceFolderKind,
   waitForProxy
 };

package/dist/index.js

@@ -82,7 +82,7 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "./chunk-2MJKVMZU.js";
+} from "./chunk-OAHY2RQP.js";
 import {
   CACHE_DIR_NAME,
   PROXY_PENDING_RETRY_AFTER_SECONDS,
@@ -91,9 +91,11 @@ import {
   ProxyWaitTimeoutError,
   cleanupProxyCache,
   proxyActivityMark,
+  proxyCopyProgress,
   resolveProxy,
+  retryProxyCopy,
   waitForProxy
-} from "./chunk-RX6VALW3.js";
+} from "./chunk-MNJZQCBL.js";
 import {
   PROXY_VARIANT_CONFIG,
   decideMediaProxyEligibility,
@@ -102,7 +104,7 @@ import {
   probeMediaMetadata,
   recordProxyRequest,
   resolveProxyVariantRequest
-} from "./chunk-C2RFW2FX.js";
+} from "./chunk-JKPLDWAB.js";
 import {
   folderGone,
   isInHiddenOrVendorDir,
@@ -3888,6 +3890,8 @@ import {
 import {
   PREVIEW_PROXY_BOX_PARAM,
   PREVIEW_PROXY_LIGHT_PARAM,
+  PREVIEW_PROXY_PROGRESS_HEADER,
+  PREVIEW_PROXY_RETRY_PARAM,
   parsePreviewProxyBox
 } from "@hyperframes/core";
 import {
@@ -4539,12 +4543,17 @@ ${etag}`;
     let servedContentType = contentType;
     if (proxyVariant !== void 0) {
       try {
+        if (c.req.query(PREVIEW_PROXY_RETRY_PARAM) !== void 0) {
+          retryProxyCopy(project.dir, file, proxyVariant, proxyBox);
+        }
         servedPath = await waitForProxy(resolveProxy(project.dir, file, proxyVariant, proxyBox), 0);
       } catch (err) {
         if (err instanceof ProxyWaitTimeoutError) {
+          const progress = proxyCopyProgress(project.dir, file, proxyVariant, proxyBox);
           return c.text("media proxy is being made", 202, {
-            "Retry-After": String(PROXY_PENDING_RETRY_AFTER_SECONDS),
-            "Cache-Control": "no-store"
+            "Retry-After": progress === void 0 ? String(PROXY_PENDING_RETRY_AFTER_SECONDS) : "1",
+            "Cache-Control": "no-store",
+            ...progress !== void 0 && { [PREVIEW_PROXY_PROGRESS_HEADER]: progress.toFixed(3) }
           });
         }
         if (err instanceof ProxyCapacityError) {

package/package.json

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