@mux/ai 0.16.1 → 0.17.1

package/dist/primitives/index.d.ts

@@ -1,3 +1,3 @@
-export { D as DEFAULT_STORYBOARD_WIDTH, H as HeatmapOptions, a as HeatmapResponse, 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 findCaptionTrack, v as getHeatmapForAsset, w as getHeatmapForPlaybackId, x as getHeatmapForVideo, y as getReadyTextTracks, z as getStoryboardUrl, A as getThumbnailUrls, B as parseVTTCues, C as replaceCueText, E as secondsToTimestamp, F as splitVttPreambleAndCueBlocks, G as vttTimestampToSeconds } from '../index-CuBu_u5-.js';
+export { D as DEFAULT_STORYBOARD_WIDTH, H as HeatmapOptions, a as HeatmapResponse, L as LOW_CONFIDENCE_THRESHOLD, 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 findCaptionTrack, v as getHeatmapForAsset, w as getHeatmapForPlaybackId, x as getHeatmapForVideo, y as getReadyTextTracks, z as getReliableLanguageCode, A as getStoryboardUrl, B as getThumbnailUrls, C as parseVTTCues, E as replaceCueText, F as secondsToTimestamp, G as splitVttPreambleAndCueBlocks, I as vttTimestampToSeconds } from '../index-3G00N5QH.js';
 export { o as CompletedShotsResult, p as ErroredShotsResult, H as Hotspot, q as HotspotOptions, r as HotspotResponse, s as PendingShotsResult, t as Shot, u as ShotRequestOptions, v as ShotsResult, w as WaitForShotsOptions, x as getHotspotsForAsset, y as getHotspotsForPlaybackId, z as getHotspotsForVideo, B as getShotsForAsset, D as requestShotsForAsset, F as waitForShotsForAsset } from '../shots-BFYOfBgN.js';
 import '@mux/mux-node';

package/dist/primitives/index.js

@@ -30,6 +30,10 @@ var EnvSchema = z.object({
     "Override for Mux image base URL (defaults to https://image.mux.com).",
     "Mux image URL override"
   ),
+  MUX_STREAM_URL_OVERRIDE: optionalString(
+    "Override for Mux stream base URL (defaults to https://stream.mux.com).",
+    "Mux stream URL override"
+  ),
   // Test-only helpers (used by this repo's integration tests)
   MUX_TEST_ASSET_ID: optionalString("Mux asset ID used by integration tests.", "Mux test asset id"),
   MUX_TEST_ASSET_ID_CHAPTERS: optionalString("Mux asset ID used by integration tests for chapters.", "Mux test asset id for chapters"),
@@ -749,22 +753,24 @@ async function waitForShotsForAsset(assetId, options = {}) {
   );
 }
 
-// src/lib/mux-image-url.ts
+// src/lib/mux-url.ts
 var DEFAULT_MUX_IMAGE_ORIGIN = "https://image.mux.com";
-function normalizeMuxImageOrigin(value) {
+var DEFAULT_MUX_STREAM_ORIGIN = "https://stream.mux.com";
+function normalizeOrigin(value, envVarName) {
   const trimmed = value.trim();
   const candidate = trimmed.includes("://") ? trimmed : `https://${trimmed}`;
+  const exampleHostname = envVarName === "MUX_IMAGE_URL_OVERRIDE" ? "image.example.mux.com" : "stream.example.mux.com";
   let parsed;
   try {
     parsed = new URL(candidate);
   } catch {
     throw new Error(
-      `Invalid MUX_IMAGE_URL_OVERRIDE. Provide a hostname like "image.example.mux.com" (or a URL origin such as "https://image.example.mux.com").`
+      `Invalid ${envVarName}. Provide a hostname (e.g. "${exampleHostname}") or a URL origin (e.g. "https://${exampleHostname}").`
     );
   }
   if (parsed.username || parsed.password || parsed.search || parsed.hash || parsed.pathname && parsed.pathname !== "/") {
     throw new Error(
-      "Invalid MUX_IMAGE_URL_OVERRIDE. Only a hostname/origin is allowed (no credentials, query params, hash fragments, or path)."
+      `Invalid ${envVarName}. Only a hostname/origin is allowed (no credentials, query params, hash fragments, or path).`
     );
   }
   return parsed.origin;
@@ -774,7 +780,14 @@ function getMuxImageOrigin() {
   if (!override) {
     return DEFAULT_MUX_IMAGE_ORIGIN;
   }
-  return normalizeMuxImageOrigin(override);
+  return normalizeOrigin(override, "MUX_IMAGE_URL_OVERRIDE");
+}
+function getMuxStreamOrigin() {
+  const override = env_default.MUX_STREAM_URL_OVERRIDE;
+  if (!override) {
+    return DEFAULT_MUX_STREAM_ORIGIN;
+  }
+  return normalizeOrigin(override, "MUX_STREAM_URL_OVERRIDE");
 }
 function getMuxImageBaseUrl(playbackId, assetType) {
   const origin = getMuxImageOrigin();
@@ -1108,6 +1121,127 @@ async function getThumbnailUrls(playbackId, duration, options = {}) {
   return Promise.all(urlPromises);
 }
 
+// src/lib/language-codes.ts
+var ISO639_1_TO_3 = {
+  // Major world languages
+  en: "eng",
+  // English
+  es: "spa",
+  // Spanish
+  fr: "fra",
+  // French
+  de: "deu",
+  // German
+  it: "ita",
+  // Italian
+  pt: "por",
+  // Portuguese
+  ru: "rus",
+  // Russian
+  zh: "zho",
+  // Chinese
+  ja: "jpn",
+  // Japanese
+  ko: "kor",
+  // Korean
+  ar: "ara",
+  // Arabic
+  hi: "hin",
+  // Hindi
+  // European languages
+  nl: "nld",
+  // Dutch
+  pl: "pol",
+  // Polish
+  sv: "swe",
+  // Swedish
+  da: "dan",
+  // Danish
+  no: "nor",
+  // Norwegian
+  fi: "fin",
+  // Finnish
+  el: "ell",
+  // Greek
+  cs: "ces",
+  // Czech
+  hu: "hun",
+  // Hungarian
+  ro: "ron",
+  // Romanian
+  bg: "bul",
+  // Bulgarian
+  hr: "hrv",
+  // Croatian
+  sk: "slk",
+  // Slovak
+  sl: "slv",
+  // Slovenian
+  uk: "ukr",
+  // Ukrainian
+  tr: "tur",
+  // Turkish
+  // Asian languages
+  th: "tha",
+  // Thai
+  vi: "vie",
+  // Vietnamese
+  id: "ind",
+  // Indonesian
+  ms: "msa",
+  // Malay
+  tl: "tgl",
+  // Tagalog/Filipino
+  // Other languages
+  he: "heb",
+  // Hebrew
+  fa: "fas",
+  // Persian/Farsi
+  bn: "ben",
+  // Bengali
+  ta: "tam",
+  // Tamil
+  te: "tel",
+  // Telugu
+  mr: "mar",
+  // Marathi
+  gu: "guj",
+  // Gujarati
+  kn: "kan",
+  // Kannada
+  ml: "mal",
+  // Malayalam
+  pa: "pan",
+  // Punjabi
+  ur: "urd",
+  // Urdu
+  sw: "swa",
+  // Swahili
+  af: "afr",
+  // Afrikaans
+  ca: "cat",
+  // Catalan
+  eu: "eus",
+  // Basque
+  gl: "glg",
+  // Galician
+  is: "isl",
+  // Icelandic
+  et: "est",
+  // Estonian
+  lv: "lav",
+  // Latvian
+  lt: "lit"
+  // Lithuanian
+};
+var ISO639_3_TO_1 = Object.fromEntries(
+  Object.entries(ISO639_1_TO_3).map(([iso1, iso3]) => [iso3, iso1])
+);
+var UNDETERMINED_LANGUAGE_CODES = /* @__PURE__ */ new Set(["und", "mul", "mis", "zxx"]);
+function isUndeterminedLanguageCode(code) {
+  return UNDETERMINED_LANGUAGE_CODES.has(code.toLowerCase().trim());
+}
+
 // src/lib/mux-assets.ts
 function isAudioOnlyAsset(asset) {
   const hasAudioTrack = asset.tracks?.some((track) => track.type === "audio") ?? false;
@@ -1141,6 +1275,17 @@ function findCaptionTrack(asset, languageCode) {
   }
   return void 0;
 }
+var LOW_CONFIDENCE_THRESHOLD = 0.5;
+function getReliableLanguageCode(track, confidenceThreshold = LOW_CONFIDENCE_THRESHOLD) {
+  if (!track?.language_code)
+    return void 0;
+  if (isUndeterminedLanguageCode(track.language_code))
+    return void 0;
+  if (track.auto_language_confidence !== void 0 && track.auto_language_confidence < confidenceThreshold) {
+    return void 0;
+  }
+  return track.language_code;
+}
 function normalizeLineEndings(value) {
   return value.replace(/\r\n/g, "\n");
 }
@@ -1408,7 +1553,7 @@ function concatenateVttSegments(segments, preamble = "WEBVTT") {
 }
 async function buildTranscriptUrl(playbackId, trackId, shouldSign = false, credentials) {
   "use step";
-  const baseUrl = `https://stream.mux.com/${playbackId}/text/${trackId}.vtt`;
+  const baseUrl = `${getMuxStreamOrigin()}/${playbackId}/text/${trackId}.vtt`;
   if (shouldSign) {
     return signUrl(baseUrl, playbackId, "video", void 0, credentials);
   }
@@ -1465,6 +1610,7 @@ async function fetchTranscriptForAsset(asset, playbackId, options = {}) {
 }
 export {
   DEFAULT_STORYBOARD_WIDTH,
+  LOW_CONFIDENCE_THRESHOLD,
   buildTranscriptUrl,
   buildVttFromCueBlocks,
   buildVttFromTranslatedCueBlocks,
@@ -1486,6 +1632,7 @@ export {
   getHotspotsForPlaybackId,
   getHotspotsForVideo,
   getReadyTextTracks,
+  getReliableLanguageCode,
   getShotsForAsset,
   getStoryboardUrl,
   getThumbnailUrls,