@mux/ai 0.14.0 → 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 }
   );
 }
 
@@ -1406,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 };
   }
@@ -1430,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 };