@mux/ai 0.52.0 → 0.54.0

package/dist/primitives/index.d.ts

@@ -1,3 +1,3 @@
-export { D as DEFAULT_STORYBOARD_WIDTH, H as HeatmapOptions, a as HeatmapResponse, L as LOW_CONFIDENCE_THRESHOLD, M as MAX_CUE_TEXT_CHARS, T as ThumbnailOptions, b as TranscriptFetchOptions, c as TranscriptResult, V as VTTCue, d as VTTCueBudgetChunkingOptions, e as VTTDurationChunk, f as VTTDurationChunkingOptions, g as buildTranscriptUrl, h as buildVttFromCueBlocks, j as buildVttFromTranslatedCueBlocks, k as chunkByTokens, l as chunkText, m as chunkVTTCues, n as chunkVTTCuesByBudget, o as chunkVTTCuesByDuration, p as concatenateVttSegments, q as estimateTokenCount, r as extractTextFromVTT, s as extractTimestampedTranscript, t as fetchTranscriptForAsset, u as filterVttByScope, v as findCaptionTrack, w as getHeatmapForAsset, x as getHeatmapForPlaybackId, y as getHeatmapForVideo, z as getReadyTextTracks, A as getReliableLanguageCode, B as getStoryboardUrl, C as getThumbnailUrls, E as parseVTTCues, F as replaceCueText, G as sanitizeUntrustedText, I as secondsToTimestamp, J as splitVttPreambleAndCueBlocks, K as stripVttMetadataBlocks, N as vttTimestampToSeconds } from '../index-nu1UOAMW.js';
-export { q as CompletedShotsResult, D as DeletedShotsResult, r as ErroredShotsResult, H as Hotspot, s as HotspotOptions, t as HotspotResponse, u as PendingShotsResult, v as Shot, w as ShotRequestOptions, x as ShotsResult, y as SkippedShotsResult, z as WaitForShotsOptions, B as getHotspotsForAsset, F as getHotspotsForPlaybackId, G as getHotspotsForVideo, J as getShotsForAsset, K as requestShotsForAsset, L as waitForShotsForAsset } from '../shots-3wmvZnUV.js';
+export { D as DEFAULT_STORYBOARD_WIDTH, H as HeatmapOptions, a as HeatmapResponse, T as ThumbnailOptions, V as VTTCueBudgetChunkingOptions, b as VTTDurationChunk, c as VTTDurationChunkingOptions, d as chunkByTokens, e as chunkText, f as chunkVTTCues, g as chunkVTTCuesByBudget, h as chunkVTTCuesByDuration, j as estimateTokenCount, k as getHeatmapForAsset, l as getHeatmapForPlaybackId, m as getHeatmapForVideo, n as getStoryboardUrl, o as getThumbnailUrls } from '../index-cbaPe-aE.js';
+export { r as CompletedShotsResult, D as DeletedShotsResult, s as ErroredShotsResult, H as Hotspot, t as HotspotOptions, u as HotspotResponse, L as LOW_CONFIDENCE_THRESHOLD, v as MAX_CUE_TEXT_CHARS, w as ParseVTTCuesOptions, x as PendingShotsResult, y as Shot, z as ShotRequestOptions, B as ShotsResult, F as SkippedShotsResult, G as TranscriptEmptyReason, J as TranscriptFetchOptions, K as TranscriptFetchStepResult, N as TranscriptResult, q as VTTCue, O as WaitForShotsOptions, Q as buildTranscriptUrl, R as buildVttFromCueBlocks, X as buildVttFromTranslatedCueBlocks, Y as concatenateVttSegments, Z as extractTextFromVTT, _ as extractTimestampedTranscript, $ as fetchTranscriptDataForUrl, a0 as fetchTranscriptForAsset, a1 as filterVttByScope, a2 as findCaptionTrack, a3 as getHotspotsForAsset, a4 as getHotspotsForPlaybackId, a5 as getHotspotsForVideo, a6 as getReadyTextTracks, a7 as getReliableLanguageCode, a8 as getShotsForAsset, a9 as parseVTTCues, aa as replaceCueText, ab as requestShotsForAsset, ac as sanitizeUntrustedText, ad as secondsToTimestamp, ae as splitVttPreambleAndCueBlocks, af as stripVttMetadataBlocks, ag as vttTimestampToSeconds, ah as waitForShotsForAsset } from '../transcripts-BCtzC8hZ.js';
 import '@mux/ts';

package/dist/primitives/index.js

@@ -921,6 +921,9 @@ var MuxAiError = class extends Error {
     super(message);
     /** Structural brand for duck-type identification. */
     this.__robots_error = true;
+    if (opts?.cause !== void 0) {
+      Object.defineProperty(this, "cause", { value: opts.cause, writable: true, configurable: true });
+    }
     this.name = "FatalError";
     this.publicType = opts?.type ?? "processing_error";
     this.publicMessage = message;
@@ -1916,9 +1919,10 @@ function extractTimestampedTranscript(vttContent) {
     segments.map((segment) => `[${Math.floor(segment.time)}s] ${segment.text}`).join("\n")
   );
 }
-function parseVTTCues(vttContent) {
+function parseVTTCues(vttContent, options = {}) {
   if (!vttContent.trim())
     return [];
+  const { capCueText = true } = options;
   const lines = vttContent.split("\n");
   const cues = [];
   let previousCueIdentifier = null;
@@ -1950,15 +1954,16 @@ function parseVTTCues(vttContent) {
       }
       const textLines = rawTextLines.map((textLine) => textLine.replace(/<[^>]*>/g, "")).filter(Boolean);
       if (textLines.length > 0) {
+        const sanitized = sanitizeUntrustedText(textLines.join(" "));
         cues.push({
           startTime,
           endTime,
           // Sanitize at the cue boundary so every downstream consumer
           // (engagement-insights, translate-captions chunked path, etc.)
           // receives text free of invisible / bidi obfuscation. Length-
-          // cap the result so an adversarially oversized cue cannot
-          // smuggle a large injection payload into the prompt.
-          text: capCueTextLength(sanitizeUntrustedText(textLines.join(" ")))
+          // cap the result by default so an adversarially oversized cue
+          // cannot smuggle a large injection payload into a prompt.
+          text: capCueText ? capCueTextLength(sanitized) : sanitized
         });
       }
       previousCueIdentifier = currentCueIdentifier;
@@ -2082,16 +2087,32 @@ async function buildTranscriptUrl(playbackId, trackId, shouldSign = false, crede
   }
   return baseUrl;
 }
-async function fetchTranscriptForAsset(asset, playbackId, options = {}) {
+async function fetchTranscriptDataForUrl(transcriptUrl, options = {}) {
   "use step";
-  const {
-    languageCode,
-    cleanTranscript = true,
-    scope,
-    shouldSign,
-    credentials,
-    required = false
-  } = options;
+  const { cleanTranscript = true, scope } = options;
+  try {
+    const response = await fetch(transcriptUrl);
+    if (!response.ok) {
+      throw new Error(`Failed to fetch transcript (HTTP ${response.status})`);
+    }
+    const rawVtt = await response.text();
+    const effectiveScope = hasWorkflowScopeBoundaries(scope) ? scope : void 0;
+    const scopedVtt = filterVttByScope(rawVtt, effectiveScope);
+    const transcriptText = cleanTranscript ? extractTextFromVTT(scopedVtt) : scopedVtt;
+    const hasScopedCues = !effectiveScope || parseVTTCues(scopedVtt).length > 0;
+    if (!transcriptText.trim() || !hasScopedCues) {
+      return {
+        transcriptText,
+        emptyReason: hasScopedCues ? "empty_body" : "no_scoped_cues"
+      };
+    }
+    return { transcriptText };
+  } catch (error) {
+    wrapError(error, "Failed to fetch transcript");
+  }
+}
+async function fetchTranscriptForAsset(asset, playbackId, options = {}) {
+  const { required = false, languageCode, cleanTranscript, scope, shouldSign, credentials } = options;
   const track = findCaptionTrack(asset, languageCode);
   if (!track) {
     if (required) {
@@ -2110,33 +2131,25 @@ async function fetchTranscriptForAsset(asset, playbackId, options = {}) {
     return { transcriptText: "", track };
   }
   const transcriptUrl = await buildTranscriptUrl(playbackId, track.id, shouldSign, credentials);
+  let result;
   try {
-    const response = await fetch(transcriptUrl);
-    if (!response.ok) {
-      if (required) {
-        throw new Error(`Failed to fetch transcript (HTTP ${response.status})`);
-      }
-      return { transcriptText: "", transcriptUrl, track };
-    }
-    const rawVtt = await response.text();
-    const effectiveScope = hasWorkflowScopeBoundaries(scope) ? scope : void 0;
-    const scopedVtt = filterVttByScope(rawVtt, effectiveScope);
-    const transcriptText = cleanTranscript ? extractTextFromVTT(scopedVtt) : scopedVtt;
-    const hasScopedCues = !effectiveScope || parseVTTCues(scopedVtt).length > 0;
-    if (required && (!transcriptText.trim() || !hasScopedCues)) {
-      throw new MuxAiError(
-        effectiveScope ? "Transcript has no cues in the requested scope." : "Transcript is empty.",
-        { type: "validation_error" }
-      );
-    }
-    return { transcriptText, transcriptUrl, track };
+    result = await fetchTranscriptDataForUrl(transcriptUrl, { cleanTranscript, scope });
   } catch (error) {
     if (required) {
-      wrapError(error, "Failed to fetch transcript");
+      throw error;
     }
     console.warn("Failed to fetch transcript:", error);
     return { transcriptText: "", transcriptUrl, track };
   }
+  if (!required || !result.emptyReason) {
+    return { transcriptText: result.transcriptText, transcriptUrl, track };
+  }
+  switch (result.emptyReason) {
+    case "no_scoped_cues":
+      throw new MuxAiError("Transcript has no cues in the requested scope.", { type: "validation_error" });
+    case "empty_body":
+      throw new MuxAiError("Transcript is empty.", { type: "validation_error" });
+  }
 }
 export {
   DEFAULT_STORYBOARD_WIDTH,
@@ -2154,6 +2167,7 @@ export {
   estimateTokenCount,
   extractTextFromVTT,
   extractTimestampedTranscript,
+  fetchTranscriptDataForUrl,
   fetchTranscriptForAsset,
   filterVttByScope,
   findCaptionTrack,