@hyperframes/studio-server 0.9.13 → 0.9.14

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

@@ -404,8 +404,13 @@ function canonicalizeProxySource(projectDir, absoluteSourcePath) {
   }
   return { projectDir: realProjectRoot(projectDir), sourcePath: realpath(absoluteSourcePath) };
 }
-function getCanonicalProxyCachePath(source, variant, box) {
-  const key = fastCopyKey(source.sourcePath, PROXY_PARAMS_VERSION, variant, box);
+function getCanonicalProxyCachePath(source, variant, box, limitSeconds) {
+  const key = fastCopyKey(
+    source.sourcePath,
+    PROXY_PARAMS_VERSION,
+    keyVariant(variant, limitSeconds),
+    box
+  );
   const made = join4(
     source.projectDir,
     CACHE_DIR_NAME,
@@ -413,13 +418,28 @@ function getCanonicalProxyCachePath(source, variant, box) {
   );
   return existsSync4(made) ? made : readCopyIndex(fastIndexPath(made)) ?? made;
 }
-function getProxyCachePath(projectDir, absoluteSourcePath, variant = "h264", box) {
+function getProxyCachePath(projectDir, absoluteSourcePath, variant = "h264", box, limitSeconds) {
   return getCanonicalProxyCachePath(
     canonicalizeProxySource(projectDir, absoluteSourcePath),
     variant,
-    box
+    box,
+    limitSeconds
   );
 }
+function copiedSeconds(duration, limitSeconds) {
+  return limitSeconds === void 0 ? duration : Math.min(limitSeconds, duration ?? limitSeconds);
+}
+function lengthArgs(seconds) {
+  return seconds === void 0 ? [] : ["-t", String(seconds)];
+}
+function keyVariant(variant, limitSeconds) {
+  return limitSeconds === void 0 ? variant : `${variant}@${limitSeconds}s`;
+}
+async function proxyWindowSeconds(absoluteSourcePath, neededSeconds) {
+  const { durationSeconds } = await probeMediaMetadata(absoluteSourcePath);
+  const window = Math.ceil((neededSeconds + 1) / PROXY_CHUNK_SECONDS) * PROXY_CHUNK_SECONDS;
+  return durationSeconds && window + PROXY_CHUNK_SECONDS <= durationSeconds ? window : void 0;
+}
 function reportProgress(job, progress) {
   job.lastProgress = progress;
   for (const listener of job.progress) listener(progress);
@@ -757,7 +777,7 @@ async function buildVideoFilter(ffmpegPath, sourcePath, metadata, keepsAlpha, bo
     `format=${pixelFormat}`
   ].join(",") : [evenScale, `format=${pixelFormat}`].join(",");
 }
-async function runFfmpeg(sourcePath, outputPath, chunkPrefix, variant, box, signal, onProgress, isBackground = () => false) {
+async function runFfmpeg(sourcePath, outputPath, chunkPrefix, variant, box, limitSeconds, signal, onProgress, isBackground = () => false) {
   const metadata = await probeMediaMetadata(sourcePath);
   const ffmpegPath = findFfBinary("ffmpeg", { configuredMustExist: true });
   if (!ffmpegPath) {
@@ -771,7 +791,7 @@ async function runFfmpeg(sourcePath, outputPath, chunkPrefix, variant, box, sign
     ...["-map", "0:V:0"],
     ...metadata.audioStream === void 0 ? [] : ["-map", `0:a:${metadata.audioStream}`]
   ];
-  const totalSeconds = metadata.durationSeconds;
+  const totalSeconds = copiedSeconds(metadata.durationSeconds, limitSeconds);
   const gate = keepsAlpha ? ALPHA_PIECE_GATE : UNGATED;
   const vp8Threads = (pieces) => [
     "-threads",
@@ -789,7 +809,7 @@ async function runFfmpeg(sourcePath, outputPath, chunkPrefix, variant, box, sign
       "-i",
       sourcePath,
       ...streamArgs,
-      ...range ? ["-t", String(range.lengthSeconds)] : [],
+      ...lengthArgs(range?.lengthSeconds ?? limitSeconds),
       "-vf",
       videoFilter,
       ...KEYFRAME_EVERY_SECOND_ARGS,
@@ -921,7 +941,7 @@ function spawnFfmpeg(ffmpegPath, args, stallMs, signal, onProgress, background =
     });
   });
 }
-async function transcodeToCache(job, projectDir, absoluteSourcePath, cachePath, variant, box) {
+async function transcodeToCache(job, projectDir, absoluteSourcePath, cachePath, variant, box, limitSeconds) {
   await acquireSlot(job);
   try {
     if (existsSync4(cachePath)) return cachePath;
@@ -932,7 +952,7 @@ async function transcodeToCache(job, projectDir, absoluteSourcePath, cachePath,
       await contentCopyKey(
         absoluteSourcePath,
         PROXY_PARAMS_VERSION,
-        variant,
+        keyVariant(variant, limitSeconds),
         box,
         job.abandoned.signal
       )
@@ -962,6 +982,7 @@ async function transcodeToCache(job, projectDir, absoluteSourcePath, cachePath,
         chunkPrefix,
         variant,
         box,
+        limitSeconds,
         job.abandoned.signal,
         (progress) => reportProgress(job, progress),
         () => job.background && !job.priority
@@ -997,7 +1018,7 @@ function proxyActivityMark(projectDir) {
 async function resolveProxy(projectDir, absoluteSourcePath, variant = "h264", box, options = {}) {
   options.signal?.throwIfAborted();
   const source = canonicalizeProxySource(projectDir, absoluteSourcePath);
-  const cachePath = getCanonicalProxyCachePath(source, variant, box);
+  const cachePath = getCanonicalProxyCachePath(source, variant, box, options.limitSeconds);
   if (existsSync4(cachePath)) {
     markCacheEntryUsed(cachePath);
     maintainProxyCache(dirname3(cachePath));
@@ -1028,7 +1049,8 @@ async function resolveProxy(projectDir, absoluteSourcePath, variant = "h264", bo
       source.sourcePath,
       cachePath,
       variant,
-      box
+      box,
+      options.limitSeconds
     ).catch((err) => {
       if (!(err instanceof ProxyDroppedError) && !job.abandoned.signal.aborted) {
         rememberFailure(cachePath, err);
@@ -1069,8 +1091,9 @@ async function resolveProxies(projectDir, sources, onSettled = () => {
   let next = 0;
   const worker = async () => {
     for (let index = next++; index < sources.length; index = next++) {
-      const { sourcePath, variant, box } = sources[index];
+      const { sourcePath, variant, box, limitSeconds } = sources[index];
       results[index] = await resolveProxy(projectDir, sourcePath, variant, box, {
+        limitSeconds,
         onProgress: (progress) => onProgress(index, progress),
         signal
       }).then(
@@ -1150,6 +1173,7 @@ export {
   ProxyWaitTimeoutError,
   waitForProxy,
   getProxyCachePath,
+  proxyWindowSeconds,
   clearFailedTranscodesForTest,
   sourceFolderKind,
   proxyCopyProgress,

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

@@ -1,7 +1,7 @@
 import {
   PROXY_PARAMS_VERSION,
   resolveProxy
-} from "./chunk-BAJ6HKBU.js";
+} from "./chunk-B356RYG5.js";
 import {
   createMediaCodecProbeCache,
   proxyVariantFor,

package/dist/helpers/mediaProxyPreview.js

@@ -4,8 +4,8 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-J4SRRKQU.js";
-import "../chunk-BAJ6HKBU.js";
+} from "../chunk-GTQ6S4O5.js";
+import "../chunk-B356RYG5.js";
 import "../chunk-NOIHVBIQ.js";
 import "../chunk-X73QTST2.js";
 import "../chunk-QF7MFJJU.js";

package/dist/helpers/proxyTranscoder.d.ts

@@ -50,7 +50,8 @@ declare function waitForProxy<T>(promise: Promise<T>, timeoutMs?: number): Promi
  * transcoding anything, so a host can check cache state. Pass the request's
  * preview box (`hf-proxy-box`) to name a boxed copy.
  */
-declare function getProxyCachePath(projectDir: string, absoluteSourcePath: string, variant?: ProxyVariant, box?: PreviewProxyBox): string;
+declare function getProxyCachePath(projectDir: string, absoluteSourcePath: string, variant?: ProxyVariant, box?: PreviewProxyBox, limitSeconds?: number): string;
+declare function proxyWindowSeconds(absoluteSourcePath: string, neededSeconds: number): Promise<number | undefined>;
 /** How far a copy has got: seconds of the source done, out of its length when that is known. */
 interface ProxyProgress {
     doneSeconds: number;
@@ -86,10 +87,12 @@ declare function resolveProxies(projectDir: string, sources: ReadonlyArray<{
     sourcePath: string;
     variant: ProxyVariant;
     box?: PreviewProxyBox;
+    limitSeconds?: number;
 }>, 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 {
+    limitSeconds?: number;
     priority?: boolean;
     background?: boolean;
     signal?: AbortSignal;
@@ -97,4 +100,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, resolveStill, 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, proxyWindowSeconds, resolveProxies, resolveProxy, resolveStill, retryProxyCopy, sourceFolderKind, waitForProxy };

package/dist/helpers/proxyTranscoder.js

@@ -15,13 +15,14 @@ import {
   getProxyCachePath,
   proxyActivityMark,
   proxyCopyProgress,
+  proxyWindowSeconds,
   resolveProxies,
   resolveProxy,
   resolveStill,
   retryProxyCopy,
   sourceFolderKind,
   waitForProxy
-} from "../chunk-BAJ6HKBU.js";
+} from "../chunk-B356RYG5.js";
 import "../chunk-NOIHVBIQ.js";
 import "../chunk-X73QTST2.js";
 import "../chunk-QF7MFJJU.js";
@@ -44,6 +45,7 @@ export {
   getProxyCachePath,
   proxyActivityMark,
   proxyCopyProgress,
+  proxyWindowSeconds,
   resolveProxies,
   resolveProxy,
   resolveStill,

package/dist/index.js

@@ -91,7 +91,7 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "./chunk-J4SRRKQU.js";
+} from "./chunk-GTQ6S4O5.js";
 import {
   CACHE_DIR_NAME,
   PROXY_PENDING_RETRY_AFTER_SECONDS,
@@ -105,7 +105,7 @@ import {
   resolveStill,
   retryProxyCopy,
   waitForProxy
-} from "./chunk-BAJ6HKBU.js";
+} from "./chunk-B356RYG5.js";
 import {
   PROXY_VARIANT_CONFIG,
   decideMediaProxyEligibility,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.9.13",
+  "version": "0.9.14",
   "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/core": "0.9.13",
-    "@hyperframes/parsers": "0.9.13"
+    "@hyperframes/core": "0.9.14",
+    "@hyperframes/parsers": "0.9.14"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",