@mux/ai 0.13.1 → 0.15.1

package/dist/primitives/index.js

@@ -592,6 +592,26 @@ async function fetchHotspots(identifierType, id, options) {
   return transformHotspotResponse(response);
 }
 
+// src/lib/mux-ai-error.ts
+var MuxAiError = class extends Error {
+  constructor(message, opts) {
+    super(message);
+    /** Structural brand for duck-type identification. */
+    this.__robots_error = true;
+    this.name = "MuxAiError";
+    this.publicType = opts?.type ?? "processing_error";
+    this.publicMessage = message;
+    this.retryable = opts?.retryable ?? false;
+  }
+};
+function wrapError(error, message) {
+  if (error instanceof MuxAiError) {
+    throw error;
+  }
+  const detail = error instanceof Error ? error.message : "Unknown error";
+  throw new Error(`${message}: ${detail}`);
+}
+
 // src/primitives/shots.ts
 var DEFAULT_POLL_INTERVAL_MS = 2e3;
 var MIN_POLL_INTERVAL_MS = 1e3;
@@ -717,14 +737,15 @@ async function waitForShotsForAsset(assetId, options = {}) {
       return result;
     }
     if (result.status === "errored") {
-      throw new Error(`Shots generation errored for asset '${assetId}'`);
+      throw new MuxAiError(`Shot generation failed for asset ${assetId}.`);
     }
     if (attempt < normalizedMaxAttempts - 1) {
       await sleep(normalizedPollIntervalMs);
     }
   }
-  throw new Error(
-    `Timed out waiting for shots for asset '${assetId}' after ${normalizedMaxAttempts} attempts. Last status: ${lastStatus ?? "unknown"}`
+  throw new MuxAiError(
+    `Timed out waiting for shots for asset ${assetId}. Last status: ${lastStatus ?? "unknown"}.`,
+    { type: "timeout_error", retryable: true }
   );
 }
 
@@ -1087,6 +1108,13 @@ async function getThumbnailUrls(playbackId, duration, options = {}) {
   return Promise.all(urlPromises);
 }
 
+// src/lib/mux-assets.ts
+function isAudioOnlyAsset(asset) {
+  const hasAudioTrack = asset.tracks?.some((track) => track.type === "audio") ?? false;
+  const hasVideoTrack = asset.tracks?.some((track) => track.type === "video") ?? false;
+  return hasAudioTrack && !hasVideoTrack;
+}
+
 // src/primitives/transcripts.ts
 function getReadyTextTracks(asset) {
   return (asset.tracks || []).filter(
@@ -1098,11 +1126,20 @@ function findCaptionTrack(asset, languageCode) {
   if (!tracks.length)
     return void 0;
   if (!languageCode) {
-    return tracks[0];
+    const englishTrack = tracks.find(
+      (track) => track.text_type === "subtitles" && track.language_code === "en"
+    );
+    return englishTrack ?? tracks[0];
   }
-  return tracks.find(
+  const languageMatch = tracks.find(
     (track) => track.text_type === "subtitles" && track.language_code === languageCode
   );
+  if (languageMatch)
+    return languageMatch;
+  if (isAudioOnlyAsset(asset) && tracks.length === 1) {
+    return tracks[0];
+  }
+  return void 0;
 }
 function normalizeLineEndings(value) {
   return value.replace(/\r\n/g, "\n");
@@ -1390,15 +1427,16 @@ async function fetchTranscriptForAsset(asset, playbackId, options = {}) {
   if (!track) {
     if (required) {
       const availableLanguages = getReadyTextTracks(asset).map((t) => t.language_code).filter(Boolean).join(", ");
-      throw new Error(
-        `No transcript track found${languageCode ? ` for language '${languageCode}'` : ""}. Available languages: ${availableLanguages || "none"}`
+      throw new MuxAiError(
+        `No caption track found${languageCode ? ` for language ${languageCode}` : ""}. Available languages: ${availableLanguages || "none"}.`,
+        { type: "validation_error" }
       );
     }
     return { transcriptText: "" };
   }
   if (!track.id) {
     if (required) {
-      throw new Error("Transcript track is missing an id");
+      throw new MuxAiError("Transcript track is missing an id.", { type: "validation_error" });
     }
     return { transcriptText: "", track };
   }
@@ -1414,14 +1452,12 @@ async function fetchTranscriptForAsset(asset, playbackId, options = {}) {
     const rawVtt = await response.text();
     const transcriptText = cleanTranscript ? extractTextFromVTT(rawVtt) : rawVtt;
     if (required && !transcriptText.trim()) {
-      throw new Error("Transcript is empty");
+      throw new MuxAiError("Transcript is empty.", { type: "validation_error" });
     }
     return { transcriptText, transcriptUrl, track };
   } catch (error) {
     if (required) {
-      throw new Error(
-        `Failed to fetch transcript: ${error instanceof Error ? error.message : "Unknown error"}`
-      );
+      wrapError(error, "Failed to fetch transcript");
     }
     console.warn("Failed to fetch transcript:", error);
     return { transcriptText: "", transcriptUrl, track };