@hyperframes/studio-server 0.9.16 → 0.9.17

package/dist/{chunk-NOIHVBIQ.js → chunk-66YZA32N.js}

@@ -1,6 +1,6 @@
 import {
   probeMediaMetadata
-} from "./chunk-X73QTST2.js";
+} from "./chunk-Y6EZUBYR.js";
 import {
   realpath
 } from "./chunk-QF7MFJJU.js";

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

@@ -2,11 +2,11 @@ import {
   PROXY_STILL_EXTENSION,
   PROXY_VARIANT_CONFIG,
   ffmpegHasHdrFilters
-} from "./chunk-NOIHVBIQ.js";
+} from "./chunk-66YZA32N.js";
 import {
   probeFirstFrameColour,
   probeMediaMetadata
-} from "./chunk-X73QTST2.js";
+} from "./chunk-Y6EZUBYR.js";
 import {
   mkdirWithinProject,
   realProjectRoot,
@@ -768,7 +768,7 @@ async function buildVideoFilter(ffmpegPath, sourcePath, metadata, keepsAlpha, bo
   const { hdrTransfer } = metadata.color;
   const toneMap = (hdrTransfer === "pq" || hdrTransfer === "hlg") && !keepsAlpha;
   if (toneMap) await ensureHdrFilters(ffmpegPath);
-  const firstFrame = toneMap ? await probeFirstFrameColour(sourcePath) : {};
+  const firstFrame = toneMap ? await probeFirstFrameColour(sourcePath, metadata.color.codecName) : {};
   const evenScale = proxyScaleFilter(box);
   const pixelFormat = keepsAlpha ? "yuva420p" : "yuv420p";
   return toneMap ? [

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

@@ -1,14 +1,14 @@
 import {
   PROXY_PARAMS_VERSION,
   resolveProxy
-} from "./chunk-B356RYG5.js";
+} from "./chunk-F4AQECCT.js";
 import {
   createMediaCodecProbeCache,
   proxyVariantFor,
   recordProxyPrewarm,
   scanProjectMedia,
   shouldPrewarmProxy
-} from "./chunk-NOIHVBIQ.js";
+} from "./chunk-66YZA32N.js";
 
 // src/helpers/mediaProxyPreview.ts
 import { resolve } from "path";

package/dist/{chunk-H4NVSSDJ.js → chunk-NEGQQZNI.js}

@@ -1,6 +1,6 @@
 import {
   probeAudioTrack
-} from "./chunk-X73QTST2.js";
+} from "./chunk-Y6EZUBYR.js";
 import {
   resolveWithinProject
 } from "./chunk-QF7MFJJU.js";
@@ -277,30 +277,24 @@ function audioNormalizationPlan(referenceTrack, targetTrack) {
   }
   const referenceLufs = referenceTrack.integratedLufs + gainDb(referenceTrack.volume);
   const targetLufs = targetTrack.integratedLufs + gainDb(targetTrack.volume);
-  const wantedGainDb = referenceLufs - targetTrack.integratedLufs;
-  if (wantedGainDb > MAX_AUDIO_GAIN_DB + 1e-9) {
-    throw new Error(
-      `Matching #${targetTrack.id} needs ${wantedGainDb.toFixed(1)} dB, beyond the +${MAX_AUDIO_GAIN_DB} dB authoring ceiling. A gap this large belongs in the source file, not the mixer: mixer gain raises the noise floor with the signal. Normalize ${targetTrack.id}'s asset offline (e.g. ffmpeg loudnorm), or lower #${referenceTrack.id} instead.`
-    );
-  }
-  const volume = 10 ** (wantedGainDb / 20);
-  const projectedTruePeakDbfs = targetTrack.truePeakDbfs + wantedGainDb;
-  if (projectedTruePeakDbfs > 0) {
-    throw new Error(
-      `Matching #${targetTrack.id} would clip at +${projectedTruePeakDbfs.toFixed(1)} dBFS; limit or preprocess the source first`
-    );
-  }
+  const previousGainDb = gainDb(targetTrack.volume);
+  const { appliedGainDb, limitedBy } = fittedGain(
+    referenceLufs - targetTrack.integratedLufs,
+    targetTrack.truePeakDbfs,
+    previousGainDb
+  );
   return {
     referenceId: referenceTrack.id,
     targetId: targetTrack.id,
     referenceLufs,
     targetLufs,
     previousVolume: targetTrack.volume,
-    volume,
-    gainDb: wantedGainDb,
-    changeDb: wantedGainDb - gainDb(targetTrack.volume),
-    projectedLufs: targetTrack.integratedLufs + wantedGainDb,
-    projectedTruePeakDbfs
+    volume: 10 ** (appliedGainDb / 20),
+    gainDb: appliedGainDb,
+    changeDb: appliedGainDb - previousGainDb,
+    projectedLufs: targetTrack.integratedLufs + appliedGainDb,
+    projectedTruePeakDbfs: targetTrack.truePeakDbfs + appliedGainDb,
+    limitedBy
   };
 }
 function updateAudioVolume(html, id, volume) {
@@ -363,19 +357,12 @@ function absoluteLoudnessPlan(track, targetLufs = DEFAULT_TARGET_LUFS) {
   if (track.integratedLufs <= SILENCE_LUFS) {
     throw new Error(`#${track.id} is silent in the played window; there is nothing to normalize`);
   }
-  const wantedGainDb = targetLufs - track.integratedLufs;
-  const peakRoomDb = NORMALIZE_TRUE_PEAK_CEILING_DBFS - track.truePeakDbfs;
-  const limits = [
-    [null, wantedGainDb],
-    ["gain-ceiling", MAX_AUDIO_GAIN_DB],
-    ["true-peak", peakRoomDb]
-  ];
-  const [limitedBy, limitedGainDb] = limits.reduce(
-    (lowest, candidate) => candidate[1] < lowest[1] - 1e-9 ? candidate : lowest
-  );
   const previousGainDb = track.volume > 0 ? gainDb(track.volume) : 0;
-  const limitCannotCutAWantedBoost = wantedGainDb > previousGainDb;
-  const appliedGainDb = limitCannotCutAWantedBoost ? Math.max(limitedGainDb, previousGainDb) : limitedGainDb;
+  const { appliedGainDb, limitedBy } = fittedGain(
+    targetLufs - track.integratedLufs,
+    track.truePeakDbfs,
+    previousGainDb
+  );
   return {
     targetId: track.id,
     targetLufs,
@@ -389,6 +376,18 @@ function absoluteLoudnessPlan(track, targetLufs = DEFAULT_TARGET_LUFS) {
     limitedBy
   };
 }
+function fittedGain(wantedGainDb, truePeakDbfs, previousGainDb) {
+  const limits = [
+    [null, wantedGainDb],
+    ["gain-ceiling", MAX_AUDIO_GAIN_DB],
+    ["true-peak", NORMALIZE_TRUE_PEAK_CEILING_DBFS - truePeakDbfs]
+  ];
+  const [limitedBy, limitedGainDb] = limits.reduce(
+    (lowest, candidate) => candidate[1] < lowest[1] - 1e-9 ? candidate : lowest
+  );
+  const appliedGainDb = wantedGainDb > previousGainDb ? Math.max(limitedGainDb, previousGainDb) : limitedGainDb;
+  return { appliedGainDb, limitedBy };
+}
 function absoluteOutcome(plan, tolerance) {
   if (Math.abs(plan.changeDb) > tolerance) return "change";
   return Math.abs(plan.projectedLufs - plan.targetLufs) <= tolerance ? "matched" : "held";

package/dist/{chunk-X73QTST2.js → chunk-Y6EZUBYR.js}

@@ -3,7 +3,10 @@ import { execFile } from "child_process";
 import { extname } from "path";
 import {
   firstFrameColourArgs,
-  parseFirstFrameColour
+  keyframeTransferArgs,
+  parseFirstFrameColour,
+  readsKeyframeTransfers,
+  parseKeyframeTransfers
 } from "@hyperframes/core";
 import { findFfBinary } from "@hyperframes/parsers/ff-binaries";
 import { videoStreamHasAlpha } from "@hyperframes/parsers/media-alpha";
@@ -82,14 +85,21 @@ function classifyMediaColor(stream) {
     bitsPerRawSample: stream?.bits_per_raw_sample
   };
 }
-async function probeFirstFrameColour(filePath, runner = execFileRunner) {
+async function probeFirstFrameColour(filePath, codec, runner = execFileRunner) {
   const ffmpegPath = findFfBinary("ffmpeg", { configuredMustExist: true }) ?? (runner === execFileRunner ? void 0 : "ffmpeg");
   if (!ffmpegPath) return {};
   const result = await runner(ffmpegPath, firstFrameColourArgs(filePath), {
     timeout: 15e3,
     maxBuffer: 1024 * 1024
   });
-  return result.status === 0 ? parseFirstFrameColour(String(result.stderr)) : {};
+  const first = result.status === 0 ? parseFirstFrameColour(String(result.stderr)) : {};
+  if (result.status !== 0 || !readsKeyframeTransfers(first)) return first;
+  const keyframes = await runner(ffmpegPath, keyframeTransferArgs(filePath, codec), {
+    timeout: 3e4,
+    maxBuffer: 8 * 1024 * 1024
+  });
+  const keyframeTransfers = keyframes.status === 0 ? parseKeyframeTransfers(String(keyframes.stderr)) : [];
+  return { ...first, keyframeTransfers };
 }
 function bitDepthOf(stream) {
   const raw = Number(stream.bits_per_raw_sample);

package/dist/helpers/loudness.d.ts

@@ -35,6 +35,7 @@ interface AudioNormalizationPlan {
     changeDb: number;
     projectedLufs: number;
     projectedTruePeakDbfs: number;
+    limitedBy: LoudnessLimit | null;
 }
 /** Read the authored clips with sound — `<audio>` and audible `<video>` — without reserializing. */
 declare function audioTags(html: string): AudioTag[];
@@ -43,7 +44,7 @@ declare function resolveLocalAudioPath(projectDir: string, src: string): string;
 /** Parse FFmpeg's final EBU R128 summary, not its per-window log lines. */
 declare function parseEbur128Summary(stderr: string): LoudnessMeasurement;
 declare function gainDb(volume: number): number;
-/** Calculate the target's absolute authored gain while keeping the reference unchanged. */
+/** The target's gain that matches the reference's played loudness; past a ceiling it stops as fittedGain does. */
 declare function audioNormalizationPlan(referenceTrack: NormalizationTrack, targetTrack: NormalizationTrack): AudioNormalizationPlan;
 /** Patch one authored attribute in place so scripts/styles/comments remain byte-stable. */
 declare function updateAudioVolume(html: string, id: string, volume: number): string;
@@ -78,9 +79,8 @@ interface AbsoluteLoudnessPlan {
 }
 /**
  * The authored gain that brings one clip's played window to an absolute
- * loudness. Unlike reference matching it never refuses: past the +12 dB
- * authoring ceiling or the true-peak ceiling it applies the most that fits and
- * names which limit stopped it.
+ * loudness; past the +12 dB authoring ceiling or the true-peak ceiling it
+ * applies the most that fits and names which limit stopped it (fittedGain).
  */
 declare function absoluteLoudnessPlan(track: NormalizationTrack, targetLufs?: number): AbsoluteLoudnessPlan;
 type AbsoluteOutcome = "matched" | "held" | "change";

package/dist/helpers/loudness.js

@@ -12,8 +12,8 @@ import {
   requiredFfmpeg,
   resolveLocalAudioPath,
   updateAudioVolume
-} from "../chunk-H4NVSSDJ.js";
-import "../chunk-X73QTST2.js";
+} from "../chunk-NEGQQZNI.js";
+import "../chunk-Y6EZUBYR.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/helpers/mediaCodecMap.js

@@ -15,8 +15,8 @@ import {
   scanProjectMedia,
   scanProjectMediaCodecMap,
   shouldPrewarmProxy
-} from "../chunk-NOIHVBIQ.js";
-import "../chunk-X73QTST2.js";
+} from "../chunk-66YZA32N.js";
+import "../chunk-Y6EZUBYR.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/helpers/mediaProxyPreview.js

@@ -4,10 +4,10 @@ import {
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "../chunk-GTQ6S4O5.js";
-import "../chunk-B356RYG5.js";
-import "../chunk-NOIHVBIQ.js";
-import "../chunk-X73QTST2.js";
+} from "../chunk-IJMPYPJG.js";
+import "../chunk-F4AQECCT.js";
+import "../chunk-66YZA32N.js";
+import "../chunk-Y6EZUBYR.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/helpers/proxyTranscoder.js

@@ -22,9 +22,9 @@ import {
   retryProxyCopy,
   sourceFolderKind,
   waitForProxy
-} from "../chunk-B356RYG5.js";
-import "../chunk-NOIHVBIQ.js";
-import "../chunk-X73QTST2.js";
+} from "../chunk-F4AQECCT.js";
+import "../chunk-66YZA32N.js";
+import "../chunk-Y6EZUBYR.js";
 import "../chunk-QF7MFJJU.js";
 import "../chunk-SVQFE44C.js";
 import "../chunk-L3HJVTQE.js";

package/dist/index.js

@@ -85,13 +85,13 @@ import {
   requestedProjectPath,
   requiredFfmpeg,
   resolveLocalAudioPath
-} from "./chunk-H4NVSSDJ.js";
+} from "./chunk-NEGQQZNI.js";
 import {
   injectMediaCodecMap,
   isAutoProxyEnabled,
   proxyEtagSalt,
   resolvePreviewMediaCodecProbeCache
-} from "./chunk-GTQ6S4O5.js";
+} from "./chunk-IJMPYPJG.js";
 import {
   CACHE_DIR_NAME,
   PROXY_PENDING_RETRY_AFTER_SECONDS,
@@ -105,7 +105,7 @@ import {
   resolveStill,
   retryProxyCopy,
   waitForProxy
-} from "./chunk-B356RYG5.js";
+} from "./chunk-F4AQECCT.js";
 import {
   PROXY_VARIANT_CONFIG,
   decideMediaProxyEligibility,
@@ -113,11 +113,11 @@ import {
   probeAssetCodec,
   recordProxyRequest,
   resolveProxyVariantRequest
-} from "./chunk-NOIHVBIQ.js";
+} from "./chunk-66YZA32N.js";
 import {
   probeAudioTrack,
   probeMediaMetadata
-} from "./chunk-X73QTST2.js";
+} from "./chunk-Y6EZUBYR.js";
 import {
   folderGone,
   isInHiddenOrVendorDir,

package/package.json

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