@hyperframes/studio-server 0.8.205 → 0.8.207

package/dist/{chunk-2GPN2OSU.js → chunk-ZR3T4TKU.js}

@@ -29,10 +29,46 @@ function parseRateControl(body, format) {
   if (isSet(body.videoBitrate)) return parseVideoBitrate(body.videoBitrate);
   return { ok: true, options: {} };
 }
+function parseKeyframeInterval(value) {
+  if (typeof value !== "number" || !(value > 0)) {
+    return { ok: false, error: "keyframeIntervalSeconds must be a positive number of seconds" };
+  }
+  return { ok: true, options: { keyframeIntervalSeconds: value } };
+}
+function parseBitrateField(name, value) {
+  if (typeof value !== "string" || !VIDEO_BITRATE.test(value)) {
+    return { ok: false, error: `${name} must look like "8M", "5000k" or "8000000"` };
+  }
+  return { ok: true, options: { [name]: value } };
+}
+var DELIVERY_FIELDS = [
+  ["keyframeIntervalSeconds", parseKeyframeInterval],
+  ["maxBitrate", (value) => parseBitrateField("maxBitrate", value)],
+  ["bufferSize", (value) => parseBitrateField("bufferSize", value)]
+];
+function parseDelivery(body, format) {
+  const present = DELIVERY_FIELDS.filter(([name]) => isSet(body[name]));
+  if (present.length === 0) return { ok: true, options: {} };
+  if (format !== "mp4") {
+    return { ok: false, error: "keyframeIntervalSeconds and maxBitrate apply to mp4 renders" };
+  }
+  if (isSet(body.bufferSize) && !isSet(body.maxBitrate)) {
+    return { ok: false, error: "bufferSize requires maxBitrate" };
+  }
+  const options = {};
+  for (const [name, parse] of present) {
+    const parsed = parse(body[name]);
+    if (!parsed.ok) return parsed;
+    Object.assign(options, parsed.options);
+  }
+  return { ok: true, options };
+}
 function parseEncoderOptions(body, format) {
   const rate = parseRateControl(body, format);
   if (!rate.ok) return rate;
-  const options = { ...rate.options };
+  const delivery = parseDelivery(body, format);
+  if (!delivery.ok) return delivery;
+  const options = { ...rate.options, ...delivery.options };
   if (isSet(body.gifLoop)) {
     if (typeof body.gifLoop !== "number" || !Number.isInteger(body.gifLoop) || body.gifLoop < 0 || body.gifLoop > 65535) {
       return { ok: false, error: "gifLoop must be an integer from 0 to 65535" };
@@ -56,7 +92,20 @@ function parseEncoderOptions(body, format) {
   }
   return { ok: true, options };
 }
+function encoderJobOptions(opts) {
+  const { crf, videoBitrate, keyframeIntervalSeconds, maxBitrate, bufferSize } = opts;
+  return {
+    ...crf !== void 0 ? { crf } : {},
+    ...videoBitrate ? { videoBitrate } : {},
+    ...keyframeIntervalSeconds !== void 0 ? { keyframeIntervalSeconds } : {},
+    ...maxBitrate ? { maxBitrate } : {},
+    ...bufferSize ? { bufferSize } : {},
+    ...opts.videoFrameFormat ? { videoFrameFormat: opts.videoFrameFormat } : {},
+    ...opts.hdrMode ? { hdrMode: opts.hdrMode } : {}
+  };
+}
 
 export {
-  parseEncoderOptions
+  parseEncoderOptions,
+  encoderJobOptions
 };

package/dist/helpers/encoderOptions.d.ts

@@ -6,6 +6,9 @@ interface EncoderOptions {
     videoBitrate?: string;
     videoFrameFormat?: (typeof VIDEO_FRAME_FORMATS)[number];
     hdrMode?: (typeof HDR_MODES)[number];
+    keyframeIntervalSeconds?: number;
+    maxBitrate?: string;
+    bufferSize?: string;
 }
 interface EncoderOptionsBody {
     gifLoop?: unknown;
@@ -13,6 +16,9 @@ interface EncoderOptionsBody {
     videoBitrate?: unknown;
     videoFrameFormat?: unknown;
     hdrMode?: unknown;
+    keyframeIntervalSeconds?: unknown;
+    maxBitrate?: unknown;
+    bufferSize?: unknown;
 }
 type Parsed = {
     ok: true;
@@ -23,5 +29,6 @@ type Parsed = {
 };
 /** Explicit encoder overrides from a render request. MOV (ProRes) takes no rate control. */
 declare function parseEncoderOptions(body: EncoderOptionsBody, format: string): Parsed;
+declare function encoderJobOptions(opts: EncoderOptions): Omit<EncoderOptions, "gifLoop">;
 
-export { type EncoderOptionsBody, parseEncoderOptions };
+export { type EncoderOptionsBody, encoderJobOptions, parseEncoderOptions };

package/dist/helpers/encoderOptions.js

@@ -1,6 +1,8 @@
 import {
+  encoderJobOptions,
   parseEncoderOptions
-} from "../chunk-2GPN2OSU.js";
+} from "../chunk-ZR3T4TKU.js";
 export {
+  encoderJobOptions,
   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-DeICCYb5.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-DIEtpLJo.js';
 import './mediaCodecMap.js';
 import 'sharp';
 import '@hyperframes/parsers';

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-DeICCYb5.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-DeICCYb5.js';
+import { S as StudioApiAdapter, P as PreviewDocumentStore, M as MediaProcessingJobState } from './mediaProxyPreview-DIEtpLJo.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-DIEtpLJo.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 HistoryRefusedError, f as HistoryResult, g as HistoryTarget, h as HistoryWho, i as HistoryWindow, M as MAX_WINDOW_IDLE_MS, P as ProjectHistory, j as ProjectHistoryOptions, k as ProjectHistoryView, U as UNDO_MODES, l as UndoMode, o as openProjectHistory, r as readProjectHistory } from './projectHistory-C18HDvac.js';
 export { ArtifactCapture, ArtifactInput, ArtifactRecord, HistoryBusyError, HistoryIdError, ProjectHistoryRecord, PrunedHistory, ReclaimedHistory, RenderRecord, VideoState, artifactDirectory, beginArtifactCapture, finishSnapshotRun, forgetRecordedArtifacts, historyCache, listProjectHistories, pruneGoneProjectHistories, reclaimUncopiedBlobs, recordArtifact, recordArtifacts, recordRenderSuccess, registerRenderOutput, retainSnapshotOutput } from './history/index.js';
 export { CACHE_DIR_NAME as PROXY_CACHE_DIR_NAME } from './helpers/proxyTranscoder.js';

package/dist/index.js

@@ -24,7 +24,7 @@ import {
 } from "./chunk-FJBJJURY.js";
 import {
   parseEncoderOptions
-} from "./chunk-2GPN2OSU.js";
+} from "./chunk-ZR3T4TKU.js";
 import {
   DEFAULT_HISTORY_ROOT,
   DELETED_VERSION,
@@ -3871,6 +3871,7 @@ function registerFileRoutes(api, adapter) {
 // src/routes/preview.ts
 import { parseHTML as parseHTML7 } from "linkedom";
 import { createReadStream, existsSync as existsSync5, readFileSync as readFileSync6, statSync as statSync4 } from "fs";
+import { stripSdrPngColourTags } from "@hyperframes/core/compiler/png-colour-tags";
 import { Readable } from "stream";
 import { join as join8, resolve as resolve4 } from "path";
 import { createHash as createHash2 } from "crypto";
@@ -4567,8 +4568,9 @@ ${etag}`;
       servedContentType = PROXY_VARIANT_CONFIG[proxyVariant].contentType;
     }
     const textBuffer = isText ? Buffer.from(readFileSync6(file, "utf-8"), "utf-8") : null;
-    const totalSize = textBuffer ? textBuffer.length : statSync4(servedPath).size;
-    const bodyFor = (start, end) => textBuffer ? new Uint8Array(textBuffer.subarray(start, end + 1)) : (
+    const heldBuffer = textBuffer ?? (contentType === "image/png" ? stripSdrPngColourTags(readFileSync6(file)) : null);
+    const totalSize = heldBuffer ? heldBuffer.length : statSync4(servedPath).size;
+    const bodyFor = (start, end) => heldBuffer ? new Uint8Array(heldBuffer.subarray(start, end + 1)) : (
       // Node's web stream type and the DOM one do not overlap for tsc on
       // every platform's lib set; the double cast is the documented bridge.
       Readable.toWeb(
@@ -6670,9 +6672,12 @@ function registerHistoryRoutes(api, adapter) {
 }
 
 // src/helpers/previewErrorPage.ts
-import { STUDIO_PREVIEW_ERRORS as STUDIO_PREVIEW_ERRORS2 } from "@hyperframes/core/studio-preview-mark";
+import {
+  refusedPreviewMessage,
+  STUDIO_PREVIEW_ERRORS as STUDIO_PREVIEW_ERRORS2
+} from "@hyperframes/core/studio-preview-mark";
 function previewErrorPage(status) {
-  const message = `The preview page could not be loaded (HTTP ${status}).`;
+  const message = refusedPreviewMessage(status);
   return `<!doctype html><meta charset="utf-8"><script>window.${STUDIO_PREVIEW_ERRORS2}=[${JSON.stringify(message)}]</script><p>${message}</p>`;
 }
 

package/dist/{mediaProxyPreview-DeICCYb5.d.ts → mediaProxyPreview-DIEtpLJo.d.ts}

@@ -167,6 +167,9 @@ interface StudioApiAdapter {
         gifLoop?: number;
         crf?: number;
         videoBitrate?: string;
+        keyframeIntervalSeconds?: number;
+        maxBitrate?: string;
+        bufferSize?: string;
         videoFrameFormat?: "auto" | "jpg" | "png";
         hdrMode?: "auto" | "force-hdr" | "force-sdr";
         jobId: string;

package/package.json

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