@hyperframes/studio-server 0.8.153 → 0.8.155

package/dist/{chunk-CW5G6XXR.js → chunk-66HD2HFT.js}

@@ -238,6 +238,7 @@ import { createHash as createHash2 } from "crypto";
 import { lstatSync, readFileSync as readFileSync3, readdirSync } from "fs";
 import { extname, isAbsolute as isAbsolute2, relative as relative2, resolve as resolve2, sep as sep2 } from "path";
 import { isAtomicTempPath } from "@hyperframes/core/atomic-file";
+import { PREVIEW_IGNORED_DIRS } from "@hyperframes/core/project-folders";
 var SIGNATURE_TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
   ".cjs",
   ".css",
@@ -250,22 +251,6 @@ var SIGNATURE_TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
   ".ts",
   ".tsx"
 ]);
-var SIGNATURE_EXCLUDED_DIRS = /* @__PURE__ */ new Set([
-  ".cache",
-  ".git",
-  ".hyperframes",
-  ".next",
-  ".thumbnails",
-  ".transcode-cache",
-  ".vite",
-  ".waveform-cache",
-  "build",
-  "coverage",
-  "dist",
-  "node_modules",
-  "outputs",
-  "renders"
-]);
 var MAX_SIGNATURE_TEXT_BYTES = 2e6;
 var STUDIO_SIGNATURE_MANIFEST_PATHS = [
   ".hyperframes/studio-manual-edits.json",
@@ -279,7 +264,7 @@ function affectsProjectSignature(projectDir, changedPath) {
   if (isRenderOutput(projectDir, changedPath, readRenderOutputsOrNone(projectDir))) return false;
   const segments = relativePath.split(sep2);
   if (STUDIO_SIGNATURE_MANIFEST_PATHS.includes(segments.join("/"))) return true;
-  return !segments.some((segment) => SIGNATURE_EXCLUDED_DIRS.has(segment));
+  return !segments.some((segment) => PREVIEW_IGNORED_DIRS.has(segment));
 }
 var projectSignatureCache = /* @__PURE__ */ new Map();
 var COARSEST_FILE_TIME_TICK_MS = 2e3;
@@ -290,7 +275,7 @@ function isPathWithin(parentDir, childPath) {
 function isTextContentEligible(file, size) {
   return SIGNATURE_TEXT_EXTENSIONS.has(extname(file).toLowerCase()) && size <= MAX_SIGNATURE_TEXT_BYTES;
 }
-var isSkippedEntry = (entry) => SIGNATURE_EXCLUDED_DIRS.has(entry) || isAtomicTempPath(entry);
+var isSkippedEntry = (entry) => PREVIEW_IGNORED_DIRS.has(entry) || isAtomicTempPath(entry);
 function signatureEntryStat(projectDir, entry, file, outputs) {
   if (isSkippedEntry(entry) || !isPathWithin(projectDir, file)) return null;
   if (isRenderOutput(projectDir, file, outputs)) return null;

package/dist/chunk-GR4TX52A.js

@@ -0,0 +1,56 @@
+// src/helpers/encoderOptions.ts
+var CRF_MAX_BY_FORMAT = { mp4: 51, webm: 63 };
+var VIDEO_BITRATE = /^\d+(\.\d+)?[kKmMgG]?$/;
+var VIDEO_FRAME_FORMATS = ["auto", "jpg", "png"];
+var HDR_MODES = ["auto", "force-hdr", "force-sdr"];
+var isSet = (value) => value !== void 0 && value !== null;
+function oneOf(value, allowed) {
+  return typeof value === "string" && allowed.includes(value);
+}
+function parseCrf(crf, format, max) {
+  if (typeof crf !== "number" || !Number.isInteger(crf) || crf < 0 || crf > max) {
+    return { ok: false, error: `crf must be an integer from 0 to ${max} for ${format}` };
+  }
+  return { ok: true, options: { crf } };
+}
+function parseVideoBitrate(videoBitrate) {
+  if (typeof videoBitrate !== "string" || !VIDEO_BITRATE.test(videoBitrate)) {
+    return { ok: false, error: 'videoBitrate must look like "10M", "2500k" or "8000000"' };
+  }
+  return { ok: true, options: { videoBitrate } };
+}
+function parseRateControl(body, format) {
+  const max = CRF_MAX_BY_FORMAT[format];
+  if (max === void 0) return { ok: true, options: {} };
+  if (isSet(body.crf) && isSet(body.videoBitrate)) {
+    return { ok: false, error: "use either crf or videoBitrate, not both" };
+  }
+  if (isSet(body.crf)) return parseCrf(body.crf, format, max);
+  if (isSet(body.videoBitrate)) return parseVideoBitrate(body.videoBitrate);
+  return { ok: true, options: {} };
+}
+function parseEncoderOptions(body, format) {
+  const rate = parseRateControl(body, format);
+  if (!rate.ok) return rate;
+  const options = { ...rate.options };
+  if (isSet(body.videoFrameFormat)) {
+    if (!oneOf(body.videoFrameFormat, VIDEO_FRAME_FORMATS)) {
+      return {
+        ok: false,
+        error: `videoFrameFormat must be one of ${VIDEO_FRAME_FORMATS.join(", ")}`
+      };
+    }
+    options.videoFrameFormat = body.videoFrameFormat;
+  }
+  if (isSet(body.hdrMode)) {
+    if (!oneOf(body.hdrMode, HDR_MODES)) {
+      return { ok: false, error: `hdrMode must be one of ${HDR_MODES.join(", ")}` };
+    }
+    options.hdrMode = body.hdrMode;
+  }
+  return { ok: true, options };
+}
+
+export {
+  parseEncoderOptions
+};

package/dist/helpers/encoderOptions.d.ts

@@ -0,0 +1,25 @@
+declare const VIDEO_FRAME_FORMATS: readonly ["auto", "jpg", "png"];
+declare const HDR_MODES: readonly ["auto", "force-hdr", "force-sdr"];
+interface EncoderOptions {
+    crf?: number;
+    videoBitrate?: string;
+    videoFrameFormat?: (typeof VIDEO_FRAME_FORMATS)[number];
+    hdrMode?: (typeof HDR_MODES)[number];
+}
+interface EncoderOptionsBody {
+    crf?: unknown;
+    videoBitrate?: unknown;
+    videoFrameFormat?: unknown;
+    hdrMode?: unknown;
+}
+type Parsed = {
+    ok: true;
+    options: EncoderOptions;
+} | {
+    ok: false;
+    error: string;
+};
+/** Explicit encoder overrides from a render request. MOV (ProRes) takes no rate control. */
+declare function parseEncoderOptions(body: EncoderOptionsBody, format: string): Parsed;
+
+export { type EncoderOptionsBody, parseEncoderOptions };

package/dist/helpers/encoderOptions.js

@@ -0,0 +1,6 @@
+import {
+  parseEncoderOptions
+} from "../chunk-GR4TX52A.js";
+export {
+  parseEncoderOptions
+};

package/dist/helpers/mediaProxyPreview.d.ts

@@ -1,5 +1,5 @@
 import '@hyperframes/core';
-export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-DB1EEdxc.js';
+export { a as PreviewApiAdapter, P as PreviewDocumentStore, i as injectMediaCodecMap, f as injectMediaCodecMapIntoHtml, g as isAutoProxyEnabled, p as proxyEtagSalt, r as resolvePreviewMediaCodecProbeCache } from '../mediaProxyPreview-J8vlAvrx.js';
 import './mediaCodecMap.js';
 import '@hyperframes/parsers';
 import '@hyperframes/core/compiler';

package/dist/history/index.js

@@ -18,7 +18,7 @@ import {
   recordArtifacts,
   recordRenderSuccess,
   registerRenderOutput
-} from "../chunk-CW5G6XXR.js";
+} from "../chunk-66HD2HFT.js";
 import "../chunk-K56J3CL7.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { Hono } from 'hono';
-import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-DB1EEdxc.js';
-export { L as LintResult, a as PreviewApiAdapter, R as RenderJobState, b as ResolvedProject, c as StudioSelectionResponse, d as StudioSelectionSnapshot, e as StudioSelectionTextField } from './mediaProxyPreview-DB1EEdxc.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-J8vlAvrx.js';
+export { L as LintResult, a as PreviewApiAdapter, R as RenderJobState, b as ResolvedProject, c as StudioSelectionResponse, d as StudioSelectionSnapshot, e as StudioSelectionTextField } from './mediaProxyPreview-J8vlAvrx.js';
 export { C as ClosedWindow, D as DEFAULT_HISTORY_ROOT, S as HISTORY_START, H as HistoryClosedError, a as HistoryEntry, b as HistoryEntrySide, c as HistoryFileChange, d as HistoryListItem, e as HistoryResult, f as HistoryTarget, g as HistoryWho, h as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, i as ProjectHistoryOptions, j as ProjectHistoryView, U as UNDO_MODES, k as UndoMode, o as openProjectHistory, r as readProjectHistory } from './projectHistory-C5dpCjPU.js';
 export { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, ProjectHistoryRecord, PrunedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, forgetRecordedArtifacts, historyCache, listProjectHistories, pruneGoneProjectHistories, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput } from './history/index.js';
 export { CACHE_DIR_NAME as PROXY_CACHE_DIR_NAME } from './helpers/proxyTranscoder.js';

package/dist/index.js

@@ -22,6 +22,9 @@ import {
   isCompositionSource,
   stampProjectHfIds
 } from "./chunk-6RICWA3B.js";
+import {
+  parseEncoderOptions
+} from "./chunk-GR4TX52A.js";
 import {
   DEFAULT_HISTORY_ROOT,
   DELETED_VERSION,
@@ -55,7 +58,7 @@ import {
   resolveProjectAndSignature,
   resolveProjectSignature,
   settledFileTag
-} from "./chunk-CW5G6XXR.js";
+} from "./chunk-66HD2HFT.js";
 import {
   clearElementScreenshotIsolation,
   getElementScreenshotClip
@@ -4634,6 +4637,8 @@ function registerRenderRoutes(api, adapter) {
       }
       variables = body.variables;
     }
+    const encoder = parseEncoderOptions(body, format);
+    if (!encoder.ok) return c.json({ error: encoder.error }, 400);
     const now = /* @__PURE__ */ new Date();
     const jobId = `${project.id}_${formatRenderOutputTimestamp(now)}`;
     const rendersDir = adapter.rendersDir(project);
@@ -4650,6 +4655,7 @@ function registerRenderRoutes(api, adapter) {
       outputResolution,
       composition,
       variables,
+      ...encoder.options,
       useGpu: body.gpu === true && format === "mp4",
       distinctId: typeof body.telemetryDistinctId === "string" ? body.telemetryDistinctId : void 0,
       telemetryOptOut: body.telemetryOptOut === true

package/dist/{mediaProxyPreview-DB1EEdxc.d.ts → mediaProxyPreview-J8vlAvrx.d.ts}

@@ -161,6 +161,10 @@ interface StudioApiAdapter {
          */
         fps: _hyperframes_core.Fps;
         quality: string;
+        crf?: number;
+        videoBitrate?: string;
+        videoFrameFormat?: "auto" | "jpg" | "png";
+        hdrMode?: "auto" | "force-hdr" | "force-sdr";
         jobId: string;
         /**
          * The triggering browser profile has telemetry disabled (localStorage

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hyperframes/studio-server",
-  "version": "0.8.153",
+  "version": "0.8.155",
   "repository": {
     "type": "git",
     "url": "https://github.com/heygen-com/hyperframes",
@@ -70,6 +70,10 @@
     "./media-proxy-preview": {
       "import": "./dist/helpers/mediaProxyPreview.js",
       "types": "./dist/helpers/mediaProxyPreview.d.ts"
+    },
+    "./encoder-options": {
+      "import": "./dist/helpers/encoderOptions.js",
+      "types": "./dist/helpers/encoderOptions.d.ts"
     }
   },
   "publishConfig": {
@@ -81,8 +85,8 @@
     "postcss": "^8.5.8",
     "postcss-selector-parser": "^7.1.2",
     "sharp": "^0.35.0",
-    "@hyperframes/parsers": "0.8.153",
-    "@hyperframes/core": "0.8.153"
+    "@hyperframes/core": "0.8.155",
+    "@hyperframes/parsers": "0.8.155"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",