@hyperframes/studio-server 0.9.1 → 0.9.3

package/dist/chunk-6HAB346W.js

@@ -0,0 +1,11 @@
+// src/helpers/mediaRange.ts
+var MAX_OPEN_MEDIA_RANGE_BYTES = 4 * 1024 * 1024;
+var isMedia = (contentType) => /^(audio|video)\//i.test(contentType);
+function openRangeEnd(start, last, contentType) {
+  return isMedia(contentType) ? Math.min(last, start + MAX_OPEN_MEDIA_RANGE_BYTES - 1) : last;
+}
+
+export {
+  MAX_OPEN_MEDIA_RANGE_BYTES,
+  openRangeEnd
+};

package/dist/{chunk-FJBJJURY.js → chunk-7ROCGO5U.js}

@@ -14,36 +14,51 @@ var isCompositionSource = (html) => /data-composition-id\s*=/.test(html);
 var STAMP_RECORD = join(".hyperframes", "hf-ids-stamped.json");
 var contentHash = (text) => createHash("sha1").update(text).digest("base64url");
 function stampProjectHfIds(projectDir) {
+  const pass = stampPass(projectDir);
+  while (!pass.next().done) ;
+}
+async function stampProjectHfIdsAsync(projectDir) {
+  const pass = stampPass(projectDir);
+  while (!pass.next().done) await new Promise((resolve) => setImmediate(resolve));
+}
+function* stampPass(projectDir) {
   const recordPath = join(projectDir, STAMP_RECORD);
-  let last = {};
-  try {
-    last = JSON.parse(readFileSync(recordPath, "utf-8"));
-  } catch {
-  }
+  const last = readStampRecord(recordPath);
   const next = {};
   for (const file of walkDir(projectDir)) {
     if (!file.endsWith(".html") || isInHiddenOrVendorDir(file)) continue;
-    const absPath = join(projectDir, file);
-    let html;
-    try {
-      html = readFileSync(absPath, "utf-8");
-    } catch {
-      continue;
-    }
-    let hash = contentHash(html);
-    if (last[file] !== hash && isCompositionSource(html)) {
-      const stamped = stampFileHfIds(absPath);
-      if (stamped === null) continue;
-      hash = contentHash(stamped);
-    }
-    next[file] = hash;
+    const hash = hashAfterStamp(join(projectDir, file), last[file]);
+    if (hash !== null) next[file] = hash;
+    yield;
   }
+  writeStampRecord(projectDir, recordPath, next);
+}
+function readStampRecord(recordPath) {
+  try {
+    return JSON.parse(readFileSync(recordPath, "utf-8"));
+  } catch {
+    return {};
+  }
+}
+function writeStampRecord(projectDir, recordPath, next) {
   try {
     mkdirWithinProject(projectDir, dirname(recordPath));
     writeFileSync(recordPath, JSON.stringify(next));
   } catch {
   }
 }
+function hashAfterStamp(absPath, recorded) {
+  let html;
+  try {
+    html = readFileSync(absPath, "utf-8");
+  } catch {
+    return null;
+  }
+  const hash = contentHash(html);
+  if (recorded === hash || !isCompositionSource(html)) return hash;
+  const stamped = stampFileHfIds(absPath);
+  return stamped === null ? null : contentHash(stamped);
+}
 function openNoFollow(filePath, flags) {
   const noFollow = constants.O_NOFOLLOW ?? 0;
   try {
@@ -93,5 +108,6 @@ function stampFileHfIds(filePath) {
 export {
   isCompositionSource,
   stampProjectHfIds,
+  stampProjectHfIdsAsync,
   stampFileHfIds
 };

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

@@ -24,7 +24,7 @@ import {
   utimesSync,
   writeFileSync as writeFileSync2
 } from "fs";
-import { availableParallelism, tmpdir, totalmem } from "os";
+import os, { availableParallelism, tmpdir, totalmem } from "os";
 import { basename as basename3, dirname as dirname3, extname as extname4, isAbsolute, join as join4, relative, resolve, sep } from "path";
 import { hdrToSdrToneMapFilter } from "@hyperframes/core";
 import { findFfBinary } from "@hyperframes/parsers/ff-binaries";
@@ -317,6 +317,7 @@ function boundedEnvInteger(name, fallback, min, max) {
   return Number.isSafeInteger(parsed) && parsed >= min && parsed <= max ? parsed : fallback;
 }
 var MAX_CONCURRENT_TRANSCODES = boundedEnvInteger("HYPERFRAMES_PROXY_MAX_CONCURRENCY", 2, 1, 16);
+var BACKGROUND_NICENESS = 19;
 var MAX_QUEUED_TRANSCODES = boundedEnvInteger("HYPERFRAMES_PROXY_MAX_QUEUE", 8, 0, 256);
 var STDERR_TAIL_MAX_CHARS = 4e3;
 var TRANSCODE_STALL_MS = boundedEnvInteger(
@@ -754,7 +755,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) {
+async function runFfmpeg(sourcePath, outputPath, chunkPrefix, variant, box, signal, onProgress, isBackground = () => false) {
   const metadata = await probeMediaMetadata(sourcePath);
   const ffmpegPath = findFfBinary("ffmpeg", { configuredMustExist: true });
   if (!ffmpegPath) {
@@ -795,7 +796,8 @@ async function runFfmpeg(sourcePath, outputPath, chunkPrefix, variant, box, sign
     ],
     TRANSCODE_STALL_MS,
     pieceSignal,
-    onEncoded
+    onEncoded,
+    isBackground()
   );
   const ranges = chunkRanges(totalSeconds);
   try {
@@ -837,7 +839,14 @@ function concatArgs(listPath, target, variant) {
   ];
 }
 var OUT_TIME = /^out_time_(?:us|ms)=(\d+)$/;
-function spawnFfmpeg(ffmpegPath, args, stallMs, signal, onProgress) {
+function lowerPriorityUnlessExited(pid) {
+  try {
+    os.setPriority(pid, BACKGROUND_NICENESS);
+  } catch {
+    return;
+  }
+}
+function spawnFfmpeg(ffmpegPath, args, stallMs, signal, onProgress, background = false) {
   return new Promise((resolvePromise, reject) => {
     signal.throwIfAborted();
     const proc = spawn(ffmpegPath, args, {
@@ -846,6 +855,7 @@ function spawnFfmpeg(ffmpegPath, args, stallMs, signal, onProgress) {
       signal,
       windowsHide: true
     });
+    if (background && proc.pid !== void 0) lowerPriorityUnlessExited(proc.pid);
     let stalled = false;
     let timer;
     const armStall = () => {
@@ -951,7 +961,8 @@ async function transcodeToCache(job, projectDir, absoluteSourcePath, cachePath,
         variant,
         box,
         job.abandoned.signal,
-        (progress) => reportProgress(job, progress)
+        (progress) => reportProgress(job, progress),
+        () => job.background && !job.priority
       );
       renameSync(tempPath, cachePath);
       writeCopyIndex(contentIndex, cachePath);
@@ -1004,6 +1015,7 @@ async function resolveProxy(projectDir, absoluteSourcePath, variant = "h264", bo
     const job = {
       cachePath,
       priority: options.priority === true,
+      background: options.background === true,
       callers: 0,
       abandoned: new AbortController(),
       progress: /* @__PURE__ */ new Set()

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

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

package/dist/helpers/hfIdPersist.d.ts

@@ -3,6 +3,8 @@ declare const isCompositionSource: (html: string) => boolean;
  * watches the project: an id write during a session reaches Studio as an outside edit and reloads it.
  * A file whose content hash matches the last run's (kept in `.hyperframes`) is not parsed again. */
 declare function stampProjectHfIds(projectDir: string): void;
+/** stampProjectHfIds for a host whose event loop must keep answering: it yields to the loop after each file. */
+declare function stampProjectHfIdsAsync(projectDir: string): Promise<void>;
 /**
  * Read `filePath`, mint any missing `data-hf-id`s, write the stamped content
  * back if new ids were added, and return the stamped content. Every open of the path is
@@ -20,4 +22,4 @@ declare function stampProjectHfIds(projectDir: string): void;
  */
 declare function stampFileHfIds(filePath: string): string | null;
 
-export { isCompositionSource, stampFileHfIds, stampProjectHfIds };
+export { isCompositionSource, stampFileHfIds, stampProjectHfIds, stampProjectHfIdsAsync };

package/dist/helpers/hfIdPersist.js

@@ -1,13 +1,15 @@
 import {
   isCompositionSource,
   stampFileHfIds,
-  stampProjectHfIds
-} from "../chunk-FJBJJURY.js";
+  stampProjectHfIds,
+  stampProjectHfIdsAsync
+} from "../chunk-7ROCGO5U.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";
 export {
   isCompositionSource,
   stampFileHfIds,
-  stampProjectHfIds
+  stampProjectHfIds,
+  stampProjectHfIdsAsync
 };

package/dist/helpers/mediaProxyPreview.js

@@ -4,8 +4,8 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-JVMMZB22.js";
-import "../chunk-G4VPDLXC.js";
+} from "../chunk-PN2VGFAA.js";
+import "../chunk-CEQWOCYI.js";
 import "../chunk-FUTDRYQK.js";
 import "../chunk-X73QTST2.js";
 import "../chunk-QF7MFJJU.js";

package/dist/helpers/mediaRange.d.ts

@@ -0,0 +1,4 @@
+declare const MAX_OPEN_MEDIA_RANGE_BYTES: number;
+declare function openRangeEnd(start: number, last: number, contentType: string): number;
+
+export { MAX_OPEN_MEDIA_RANGE_BYTES, openRangeEnd };

package/dist/helpers/mediaRange.js

@@ -0,0 +1,8 @@
+import {
+  MAX_OPEN_MEDIA_RANGE_BYTES,
+  openRangeEnd
+} from "../chunk-6HAB346W.js";
+export {
+  MAX_OPEN_MEDIA_RANGE_BYTES,
+  openRangeEnd
+};

package/dist/helpers/proxyTranscoder.d.ts

@@ -89,6 +89,7 @@ declare function resolveProxies(projectDir: string, sources: ReadonlyArray<{
 }>, onSettled?: (index: number) => void, onProgress?: (index: number, progress: ProxyProgress) => void, signal?: AbortSignal): Promise<PromiseSettledResult<string>[]>;
 interface ResolveProxyOptions {
     priority?: boolean;
+    background?: boolean;
     signal?: AbortSignal;
     /** Hears how far the shared copy has got, from the first caller's start to the copy's end. */
     onProgress?: (progress: ProxyProgress) => void;

package/dist/helpers/proxyTranscoder.js

@@ -20,7 +20,7 @@ import {
   retryProxyCopy,
   sourceFolderKind,
   waitForProxy
-} from "../chunk-G4VPDLXC.js";
+} from "../chunk-CEQWOCYI.js";
 import "../chunk-FUTDRYQK.js";
 import "../chunk-X73QTST2.js";
 import "../chunk-QF7MFJJU.js";

package/dist/index.d.ts

@@ -5,9 +5,10 @@ export { C as ClosedWindow, D as DEFAULT_HISTORY_ROOT, S as HISTORY_START, H as
 export { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, InPlaceOutcome, ProjectHistoryRecord, PrunedHistory, ReclaimedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, isUncopiedMedia, listProjectHistories, onRestoredInPlace, pruneGoneProjectHistories, reclaimUncopiedBlobs, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput, retainSnapshotOutput } from './history/index.js';
 export { CACHE_DIR_NAME as PROXY_CACHE_DIR_NAME } from './helpers/proxyTranscoder.js';
 export { walkDir } from './helpers/safePath.js';
-export { stampProjectHfIds } from './helpers/hfIdPersist.js';
+export { stampProjectHfIds, stampProjectHfIdsAsync } from './helpers/hfIdPersist.js';
 import { SourceMutationTarget } from './helpers/sourceMutation.js';
 export { PatchOperation, dedupeClonedCompositionId, findTargetElement, parseSourceDocument, patchElementInHtml, removeElementFromHtml, splitElementInHtml } from './helpers/sourceMutation.js';
+export { MAX_OPEN_MEDIA_RANGE_BYTES, openRangeEnd } from './helpers/mediaRange.js';
 export { ScreenshotClip, clearElementScreenshotIsolation, getElementScreenshotClip } from './helpers/screenshotClip.js';
 export { STUDIO_MANUAL_EDITS_PATH, StudioManualEditsRenderScriptOptions, createStudioManualEditsRenderBodyScript, createStudioPositionSeekReapplyScript } from './helpers/manualEditsRenderScript.js';
 export { STUDIO_MOTION_PATH, StudioMotionRenderScriptOptions, createStudioMotionRenderBodyScript } from './helpers/studioMotionRenderScript.js';

package/dist/index.js

@@ -20,11 +20,16 @@ import {
 } from "./chunk-LRTNNDXS.js";
 import {
   isCompositionSource,
-  stampProjectHfIds
-} from "./chunk-FJBJJURY.js";
+  stampProjectHfIds,
+  stampProjectHfIdsAsync
+} from "./chunk-7ROCGO5U.js";
 import {
   parseEncoderOptions
 } from "./chunk-H5AB5322.js";
+import {
+  MAX_OPEN_MEDIA_RANGE_BYTES,
+  openRangeEnd
+} from "./chunk-6HAB346W.js";
 import {
   DEFAULT_HISTORY_ROOT,
   DELETED_VERSION,
@@ -86,7 +91,7 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "./chunk-JVMMZB22.js";
+} from "./chunk-PN2VGFAA.js";
 import {
   CACHE_DIR_NAME,
   PROXY_PENDING_RETRY_AFTER_SECONDS,
@@ -99,7 +104,7 @@ import {
   resolveProxy,
   retryProxyCopy,
   waitForProxy
-} from "./chunk-G4VPDLXC.js";
+} from "./chunk-CEQWOCYI.js";
 import {
   PROXY_VARIANT_CONFIG,
   decideMediaProxyEligibility,
@@ -4635,9 +4640,10 @@ ${etag}`;
         if (c.req.query(PREVIEW_PROXY_RETRY_PARAM) !== void 0) {
           retryProxyCopy(project.dir, file, proxyVariant, proxyBox);
         }
-        const priority = c.req.header(PREVIEW_PROXY_PRIORITY_HEADER) === "1";
+        const asked = c.req.header(PREVIEW_PROXY_PRIORITY_HEADER);
+        const urgency = asked === "0" ? { background: true } : { priority: asked === "1" };
         servedPath = await waitForProxy(
-          resolveProxy(project.dir, file, proxyVariant, proxyBox, { priority }),
+          resolveProxy(project.dir, file, proxyVariant, proxyBox, urgency),
           0
         );
       } catch (err) {
@@ -4673,7 +4679,7 @@ ${etag}`;
     const match = rangeHeader ? /bytes=(\d+)-(\d*)/.exec(rangeHeader) : null;
     if (match) {
       const start = parseInt(match[1], 10);
-      const end = match[2] ? parseInt(match[2], 10) : totalSize - 1;
+      const end = match[2] ? parseInt(match[2], 10) : openRangeEnd(start, totalSize - 1, servedContentType);
       const safeEnd = Math.min(end, totalSize - 1);
       if (start > safeEnd) {
         return new Response(null, {
@@ -6970,6 +6976,7 @@ export {
   HistoryClosedError,
   HistoryIdError,
   HistoryRefusedError,
+  MAX_OPEN_MEDIA_RANGE_BYTES,
   MAX_UPLOAD_BYTES,
   MAX_WINDOW_IDLE_MS,
   MIME_TYPES,
@@ -7013,6 +7020,7 @@ export {
   listProjectHistories,
   onRestoredInPlace,
   openProjectHistory,
+  openRangeEnd,
   parseSourceDocument,
   patchElementInHtml,
   pruneGoneProjectHistories,
@@ -7028,6 +7036,7 @@ export {
   settledFileTag,
   splitElementInHtml,
   stampProjectHfIds,
+  stampProjectHfIdsAsync,
   thumbnailDeviceScaleFactor,
   walkDir
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.9.1",
+  "version": "0.9.3",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -74,6 +74,10 @@
     "./encoder-options": {
       "import": "./dist/helpers/encoderOptions.js",
       "types": "./dist/helpers/encoderOptions.d.ts"
+    },
+    "./media-range": {
+      "import": "./dist/helpers/mediaRange.js",
+      "types": "./dist/helpers/mediaRange.d.ts"
     }
   },
   "publishConfig": {
@@ -84,8 +88,8 @@
     "linkedom": "^0.18.12",
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.2",
-    "@hyperframes/core": "0.9.1",
-    "@hyperframes/parsers": "0.9.1"
+    "@hyperframes/core": "0.9.3",
+    "@hyperframes/parsers": "0.9.3"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",