@mux/ai 0.7.5 → 0.7.6

package/dist/index.d.ts

@@ -9,7 +9,7 @@ import '@ai-sdk/anthropic';
 import '@ai-sdk/google';
 import '@ai-sdk/openai';
 
-var version = "0.7.5";
+var version = "0.7.6";
 
 /**
  * A function that returns workflow credentials, either synchronously or asynchronously.

package/dist/index.js

@@ -5,7 +5,7 @@ var __export = (target, all) => {
 };
 
 // package.json
-var version = "0.7.5";
+var version = "0.7.6";
 
 // src/env.ts
 import { z } from "zod";
@@ -30,6 +30,10 @@ 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_IMAGE_URL_OVERRIDE: optionalString(
+    "Override for Mux image base URL (defaults to https://image.mux.com).",
+    "Mux image 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"),
@@ -1032,6 +1036,44 @@ async function fetchHotspots(identifierType, id, options) {
   return transformHotspotResponse(response);
 }
 
+// src/lib/mux-image-url.ts
+var DEFAULT_MUX_IMAGE_ORIGIN = "https://image.mux.com";
+function normalizeMuxImageOrigin(value) {
+  const trimmed = value.trim();
+  const candidate = trimmed.includes("://") ? trimmed : `https://${trimmed}`;
+  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").`
+    );
+  }
+  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)."
+    );
+  }
+  return parsed.origin;
+}
+function getMuxImageOrigin() {
+  const override = env_default.MUX_IMAGE_URL_OVERRIDE;
+  if (!override) {
+    return DEFAULT_MUX_IMAGE_ORIGIN;
+  }
+  return normalizeMuxImageOrigin(override);
+}
+function getMuxImageBaseUrl(playbackId, assetType) {
+  const origin = getMuxImageOrigin();
+  return `${origin}/${playbackId}/${assetType}.png`;
+}
+function getMuxStoryboardBaseUrl(playbackId) {
+  return getMuxImageBaseUrl(playbackId, "storyboard");
+}
+function getMuxThumbnailBaseUrl(playbackId) {
+  return getMuxImageBaseUrl(playbackId, "thumbnail");
+}
+
 // src/lib/url-signing.ts
 async function createSigningClient(context) {
   const { default: MuxClient } = await import("@mux/mux-node");
@@ -1073,7 +1115,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) {
   "use step";
-  const baseUrl = `https://image.mux.com/${playbackId}/storyboard.png`;
+  const baseUrl = getMuxStoryboardBaseUrl(playbackId);
   if (shouldSign) {
     return signUrl(baseUrl, playbackId, "storyboard", { width }, credentials);
   }
@@ -1192,7 +1234,7 @@ async function getThumbnailUrls(playbackId, duration, options = {}) {
     }
     timestamps = newTimestamps;
   }
-  const baseUrl = `https://image.mux.com/${playbackId}/thumbnail.png`;
+  const baseUrl = getMuxThumbnailBaseUrl(playbackId);
   const urlPromises = timestamps.map(async (time) => {
     if (shouldSign) {
       return signUrl(baseUrl, playbackId, "thumbnail", { time, width }, credentials);
@@ -2866,7 +2908,7 @@ async function requestHiveModeration(imageUrls, maxConcurrent = 5, submissionMod
 async function getThumbnailUrlsFromTimestamps(playbackId, timestampsMs, options) {
   "use step";
   const { width, shouldSign, credentials } = options;
-  const baseUrl = `https://image.mux.com/${playbackId}/thumbnail.png`;
+  const baseUrl = getMuxThumbnailBaseUrl(playbackId);
   const urlPromises = timestampsMs.map(async (tsMs) => {
     const time = Number((tsMs / 1e3).toFixed(2));
     if (shouldSign) {