@mux/ai 0.44.0 → 0.45.0

package/dist/workflows/index.js

@@ -33,12 +33,16 @@ var EnvSchema = z.object({
   ),
   MUX_SIGNING_KEY: optionalString("Mux signing key ID for signed playback URLs.", "Used to sign playback URLs"),
   MUX_PRIVATE_KEY: optionalString("Mux signing private key for signed playback URLs.", "Used to sign playback URLs"),
+  MUX_CUSTOM_DOMAIN: optionalString(
+    "Mux domain for image.* and stream.* playback URLs, e.g. staging.mux.com or a custom domain (defaults to mux.com).",
+    "Mux custom domain"
+  ),
   MUX_IMAGE_URL_OVERRIDE: optionalString(
-    "Override for Mux image base URL (defaults to https://image.mux.com).",
+    "Deprecated: use MUX_CUSTOM_DOMAIN. 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).",
+    "Deprecated: use MUX_CUSTOM_DOMAIN. Override for Mux stream base URL (defaults to https://stream.mux.com).",
     "Mux stream URL override"
   ),
   MUX_BASE_URL: optionalString(
@@ -157,7 +161,18 @@ function parseEnv() {
   }
   return parsedEnv.data;
 }
+var hasWarnedAboutDeprecatedUrlOverrides = false;
+function warnOnDeprecatedUrlOverrides(parsed) {
+  if (hasWarnedAboutDeprecatedUrlOverrides || !parsed.MUX_IMAGE_URL_OVERRIDE && !parsed.MUX_STREAM_URL_OVERRIDE) {
+    return;
+  }
+  hasWarnedAboutDeprecatedUrlOverrides = true;
+  console.warn(
+    "MUX_IMAGE_URL_OVERRIDE and MUX_STREAM_URL_OVERRIDE are deprecated and will be removed in a future release. Set MUX_CUSTOM_DOMAIN instead (e.g. MUX_CUSTOM_DOMAIN=staging.mux.com for image.staging.mux.com and stream.staging.mux.com)."
+  );
+}
 var env = parseEnv();
+warnOnDeprecatedUrlOverrides(env);
 var env_default = env;
 
 // src/lib/prompt-fragments.ts
@@ -1824,8 +1839,7 @@ function timeRangesOverlap(firstStart, firstEnd, second) {
 }
 
 // src/lib/mux-url.ts
-var DEFAULT_MUX_IMAGE_ORIGIN = "https://image.mux.com";
-var DEFAULT_MUX_STREAM_ORIGIN = "https://stream.mux.com";
+var DEFAULT_MUX_DOMAIN = "mux.com";
 function normalizeOrigin(value, envVarName) {
   const trimmed = value.trim();
   const candidate = trimmed.includes("://") ? trimmed : `https://${trimmed}`;
@@ -1845,29 +1859,56 @@ function normalizeOrigin(value, envVarName) {
   }
   return parsed.origin;
 }
-function getMuxImageOrigin() {
-  const override = env_default.MUX_IMAGE_URL_OVERRIDE;
-  if (!override) {
-    return DEFAULT_MUX_IMAGE_ORIGIN;
+function buildPlaybackOrigin(service, customDomain, source) {
+  const invalidDomainError = new Error(
+    `Invalid ${source}. Provide a bare hostname (e.g. "media.example.com") with no scheme, port, credentials, query params, hash fragments, or path.`
+  );
+  const trimmed = customDomain.trim();
+  if (!trimmed) {
+    throw invalidDomainError;
+  }
+  let parsed;
+  try {
+    parsed = new URL(`https://${service}.${trimmed}`);
+  } catch {
+    throw invalidDomainError;
+  }
+  if (parsed.port || parsed.username || parsed.password || parsed.search || parsed.hash || parsed.pathname !== "/") {
+    throw invalidDomainError;
   }
-  return normalizeOrigin(override, "MUX_IMAGE_URL_OVERRIDE");
+  return parsed.origin;
 }
-function getMuxStreamOrigin() {
-  const override = env_default.MUX_STREAM_URL_OVERRIDE;
-  if (!override) {
-    return DEFAULT_MUX_STREAM_ORIGIN;
+async function resolveMuxPlaybackOrigin(service, credentials) {
+  "use step";
+  const { muxCustomDomain } = await resolveWorkflowCredentials(credentials);
+  if (muxCustomDomain) {
+    return buildPlaybackOrigin(service, muxCustomDomain, "muxCustomDomain");
   }
-  return normalizeOrigin(override, "MUX_STREAM_URL_OVERRIDE");
+  const legacyOverrideEnvVarName = service === "image" ? "MUX_IMAGE_URL_OVERRIDE" : "MUX_STREAM_URL_OVERRIDE";
+  const legacyOverride = env_default[legacyOverrideEnvVarName];
+  if (legacyOverride) {
+    return normalizeOrigin(legacyOverride, legacyOverrideEnvVarName);
+  }
+  if (env_default.MUX_CUSTOM_DOMAIN) {
+    return buildPlaybackOrigin(service, env_default.MUX_CUSTOM_DOMAIN, "MUX_CUSTOM_DOMAIN");
+  }
+  return buildPlaybackOrigin(service, DEFAULT_MUX_DOMAIN, "custom domain");
+}
+async function getMuxImageOrigin(credentials) {
+  return resolveMuxPlaybackOrigin("image", credentials);
+}
+async function getMuxStreamOrigin(credentials) {
+  return resolveMuxPlaybackOrigin("stream", credentials);
 }
-function getMuxImageBaseUrl(playbackId, assetType) {
-  const origin = getMuxImageOrigin();
+async function getMuxImageBaseUrl(playbackId, assetType, credentials) {
+  const origin = await getMuxImageOrigin(credentials);
   return `${origin}/${playbackId}/${assetType}.png`;
 }
-function getMuxStoryboardBaseUrl(playbackId) {
-  return getMuxImageBaseUrl(playbackId, "storyboard");
+async function getMuxStoryboardBaseUrl(playbackId, credentials) {
+  return getMuxImageBaseUrl(playbackId, "storyboard", credentials);
 }
-function getMuxThumbnailBaseUrl(playbackId) {
-  return getMuxImageBaseUrl(playbackId, "thumbnail");
+async function getMuxThumbnailBaseUrl(playbackId, credentials) {
+  return getMuxImageBaseUrl(playbackId, "thumbnail", credentials);
 }
 
 // src/lib/url-signing.ts
@@ -1911,7 +1952,7 @@ async function signUrl(url, playbackId, type = "video", params, credentials) {
 var DEFAULT_STORYBOARD_WIDTH = 640;
 async function getStoryboardUrl(playbackId, width = DEFAULT_STORYBOARD_WIDTH, shouldSign = false, credentials, scope) {
   "use step";
-  const baseUrl = getMuxStoryboardBaseUrl(playbackId);
+  const baseUrl = await getMuxStoryboardBaseUrl(playbackId, credentials);
   const params = { width };
   if (scope?.startTime !== void 0) {
     params.asset_start_time = scope.startTime;
@@ -2473,7 +2514,7 @@ function concatenateVttSegments(segments, preamble = "WEBVTT") {
 }
 async function buildTranscriptUrl(playbackId, trackId, shouldSign = false, credentials) {
   "use step";
-  const baseUrl = `${getMuxStreamOrigin()}/${playbackId}/text/${trackId}.vtt`;
+  const baseUrl = `${await getMuxStreamOrigin(credentials)}/${playbackId}/text/${trackId}.vtt`;
   if (shouldSign) {
     return signUrl(baseUrl, playbackId, "video", void 0, credentials);
   }
@@ -5722,7 +5763,7 @@ function mapShotsToHotspots(shots, hotspots) {
 }
 async function getThumbnailUrlsForHotspots(playbackId, hotspots, options = {}) {
   const { width = 640, shouldSign = false, credentials } = options;
-  const baseUrl = getMuxThumbnailBaseUrl(playbackId);
+  const baseUrl = await getMuxThumbnailBaseUrl(playbackId, credentials);
   const urlPromises = hotspots.map(async (h) => {
     const time = Math.floor(h.startMs / 1e3);
     if (shouldSign) {
@@ -6823,7 +6864,7 @@ async function getThumbnailUrls(playbackId, duration, options = {}) {
     }
     timestamps = newTimestamps;
   }
-  const baseUrl = getMuxThumbnailBaseUrl(playbackId);
+  const baseUrl = await getMuxThumbnailBaseUrl(playbackId, credentials);
   const urlPromises = timestamps.map(async (time) => {
     const url = shouldSign ? await signUrl(baseUrl, playbackId, "thumbnail", { time, width }, credentials) : `${baseUrl}?time=${time}&width=${width}`;
     return { url, time };
@@ -7287,7 +7328,7 @@ function filterTimestampsWithinExclusiveScope(timestampsMs, scope) {
 async function getThumbnailUrlsFromTimestamps(playbackId, timestampsMs, options) {
   "use step";
   const { width, shouldSign, credentials } = options;
-  const baseUrl = getMuxThumbnailBaseUrl(playbackId);
+  const baseUrl = await getMuxThumbnailBaseUrl(playbackId, credentials);
   const times = [...new Set(timestampsMs.map(toThumbnailTimeSeconds))];
   const urlPromises = times.map(async (time) => {
     const url = shouldSign ? await signUrl(baseUrl, playbackId, "thumbnail", { time, width }, credentials) : `${baseUrl}?time=${time}&width=${width}`;
@@ -8471,7 +8512,7 @@ async function translateAudio(assetId, toLanguageCode, options = {}) {
         { type: "validation_error" }
       );
     }
-    let audioUrl = `${getMuxStreamOrigin()}/${playbackId}/audio.m4a`;
+    let audioUrl = `${await getMuxStreamOrigin(credentials)}/${playbackId}/audio.m4a`;
     if (policy === "signed") {
       audioUrl = await signUrl(audioUrl, playbackId, "video", void 0, credentials);
     }