@mux/ai 0.44.0 → 0.46.0

package/dist/primitives/index.d.ts

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

package/dist/primitives/index.js

@@ -27,12 +27,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(
@@ -151,7 +155,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/workflow-crypto.ts
@@ -400,7 +415,7 @@ function resolveDirectMuxCredentials(record) {
 function createWorkflowMuxClient(options) {
   return {
     async createClient() {
-      const { default: MuxClient } = await import("@mux/mux-node");
+      const { default: MuxClient } = await import("@mux/ts");
       return new MuxClient({
         tokenId: options.tokenId,
         tokenSecret: options.tokenSecret,
@@ -606,25 +621,22 @@ async function getHeatmapForPlaybackId(playbackId, options = {}) {
   "use step";
   return fetchHeatmap("playback-ids", playbackId, options);
 }
-function transformHeatmapResponse(response) {
-  return {
-    assetId: response.data.asset_id,
-    videoId: response.data.video_id,
-    playbackId: response.data.playback_id,
-    heatmap: response.data.heatmap,
-    timeframe: response.timeframe
-  };
-}
 async function fetchHeatmap(identifierType, id, options) {
   "use step";
   const { timeframe = "7:days", credentials } = options;
   const muxClient = await getMuxClientFromEnv(credentials);
   const mux = await muxClient.createClient();
-  const queryParams = new URLSearchParams();
-  queryParams.append("timeframe[]", timeframe);
-  const path = `/data/v1/engagement/${identifierType}/${id}/heatmap?${queryParams.toString()}`;
-  const response = await mux.get(path);
-  return transformHeatmapResponse(response);
+  const query = { timeframe: [timeframe] };
+  const resource = identifierType === "playback-ids" ? mux.data.engagement.playbackIds : mux.data.engagement[identifierType];
+  const response = await resource.heatmap(id, query);
+  const { data } = response;
+  return {
+    assetId: data.asset_id ?? (identifierType === "assets" ? id : void 0),
+    videoId: data.video_id ?? (identifierType === "videos" ? id : void 0),
+    playbackId: data.playback_id ?? (identifierType === "playback-ids" ? id : void 0),
+    heatmap: data.heatmap,
+    timeframe: response.timeframe
+  };
 }
 
 // src/primitives/hotspots.ts
@@ -643,37 +655,34 @@ async function getHotspotsForPlaybackId(playbackId, options = {}) {
   const response = await fetchHotspots("playback-ids", playbackId, options);
   return response.hotspots;
 }
-function transformHotspotResponse(response) {
-  return {
-    assetId: response.data.asset_id,
-    videoId: response.data.video_id,
-    playbackId: response.data.playback_id,
-    hotspots: response.data.hotspots.map((h) => ({
-      startMs: h.start_ms,
-      endMs: h.end_ms,
-      score: h.score
-    }))
-  };
-}
 async function fetchHotspots(identifierType, id, options) {
   "use step";
   const {
     limit = 5,
     orderDirection = "desc",
-    orderBy = "score",
     timeframe = "7:days",
     credentials
   } = options;
   const muxClient = await getMuxClientFromEnv(credentials);
   const mux = await muxClient.createClient();
-  const queryParams = new URLSearchParams();
-  queryParams.append("limit", String(limit));
-  queryParams.append("order_direction", orderDirection);
-  queryParams.append("order_by", orderBy);
-  queryParams.append("timeframe[]", timeframe);
-  const path = `/data/v1/engagement/${identifierType}/${id}/hotspots?${queryParams.toString()}`;
-  const response = await mux.get(path);
-  return transformHotspotResponse(response);
+  const query = {
+    limit,
+    order_direction: orderDirection,
+    timeframe: [timeframe]
+  };
+  const resource = identifierType === "playback-ids" ? mux.data.engagement.playbackIds : mux.data.engagement[identifierType];
+  const response = await resource.hotspots(id, query);
+  const { data } = response;
+  return {
+    assetId: data.asset_id ?? (identifierType === "assets" ? id : void 0),
+    videoId: data.video_id ?? (identifierType === "videos" ? id : void 0),
+    playbackId: data.playback_id ?? (identifierType === "playback-ids" ? id : void 0),
+    hotspots: data.hotspots.map((h) => ({
+      startMs: h.start_ms,
+      endMs: h.end_ms,
+      score: h.score
+    }))
+  };
 }
 
 // src/lib/prompt-fragments.ts
@@ -960,9 +969,6 @@ var DEFAULT_POLL_INTERVAL_MS = 2e3;
 var MIN_POLL_INTERVAL_MS = 1e3;
 var DEFAULT_MAX_ATTEMPTS = 60;
 var SHOTS_ALREADY_REQUESTED_MESSAGE = "shots generation has already been requested";
-function getShotsPath(assetId) {
-  return `/video/v1/assets/${assetId}/shots`;
-}
 function mapManifestShots(shots) {
   let usedDeprecatedField = false;
   const mapped = shots.map((shot, index) => {
@@ -1002,29 +1008,35 @@ async function fetchShotsFromManifest(shotsManifestUrl) {
   }
   return mapManifestShots(manifest.shots);
 }
-async function transformShotsResponse(response) {
-  switch (response.data.status) {
+async function transformShotsResponse(data) {
+  switch (data.status) {
     case "pending":
       return {
         status: "pending",
-        createdAt: response.data.created_at
+        createdAt: data.created_at
       };
-    case "errored":
+    case "errored": {
+      const details = data.errors ?? data.error;
       return {
         status: "errored",
-        createdAt: response.data.created_at,
-        error: response.data.error
+        createdAt: data.created_at,
+        error: {
+          type: details?.type ?? "unknown",
+          messages: details?.messages ?? []
+        }
       };
+    }
     case "completed":
+      if (!data.shots_manifest_url) {
+        throw new Error("Completed shots response is missing shots_manifest_url");
+      }
       return {
         status: "completed",
-        createdAt: response.data.created_at,
-        shots: await fetchShotsFromManifest(response.data.shots_manifest_url)
+        createdAt: data.created_at,
+        shots: await fetchShotsFromManifest(data.shots_manifest_url)
       };
-    default: {
-      const exhaustiveCheck = response.data;
-      throw new Error(`Unsupported shots response: ${JSON.stringify(exhaustiveCheck)}`);
-    }
+    default:
+      throw new Error(`Unsupported shots status '${data.status}'`);
   }
 }
 function sleep(ms) {
@@ -1032,7 +1044,8 @@ function sleep(ms) {
 }
 function isShotsAlreadyRequestedError(error) {
   const statusCode = error?.status ?? error?.statusCode;
-  const messages = error?.error?.messages;
+  const body = error?.error;
+  const messages = body?.error?.messages ?? body?.messages;
   const lowerCaseMessages = messages?.map((message) => message.toLowerCase()) ?? [];
   const errorMessage = error instanceof Error ? error.message.toLowerCase() : "";
   return statusCode === 400 && (lowerCaseMessages.some((message) => message.includes(SHOTS_ALREADY_REQUESTED_MESSAGE)) || errorMessage.includes(SHOTS_ALREADY_REQUESTED_MESSAGE));
@@ -1042,11 +1055,8 @@ async function requestShotsForAsset(assetId, options = {}) {
   const { credentials } = options;
   const muxClient = await getMuxClientFromEnv(credentials);
   const mux = await muxClient.createClient();
-  const response = await mux.post(
-    getShotsPath(assetId),
-    { body: {} }
-  );
-  const result = await transformShotsResponse(response);
+  const data = await mux.video.assets.generateShots(assetId, {});
+  const result = await transformShotsResponse(data);
   if (result.status !== "pending") {
     throw new Error(
       `Expected pending status after requesting shots for asset '${assetId}', received '${result.status}'`
@@ -1059,10 +1069,8 @@ async function getShotsForAsset(assetId, options = {}) {
   const { credentials } = options;
   const muxClient = await getMuxClientFromEnv(credentials);
   const mux = await muxClient.createClient();
-  const response = await mux.get(
-    getShotsPath(assetId)
-  );
-  return await transformShotsResponse(response);
+  const data = await mux.video.assets.retrieveShots(assetId);
+  return await transformShotsResponse(data);
 }
 async function waitForShotsForAsset(assetId, options = {}) {
   "use step";
@@ -1104,8 +1112,7 @@ async function waitForShotsForAsset(assetId, options = {}) {
 }
 
 // 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}`;
@@ -1125,39 +1132,62 @@ 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;
   }
-  return normalizeOrigin(override, "MUX_IMAGE_URL_OVERRIDE");
+  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 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");
+  }
+  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 normalizeOrigin(override, "MUX_STREAM_URL_OVERRIDE");
+  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
 async function createSigningClient(context) {
-  const { default: MuxClient } = await import("@mux/mux-node");
+  const { default: MuxClient } = await import("@mux/ts");
   return new MuxClient({
-    // These are not needed for signing, but the SDK requires them
-    // Using empty strings as we only need the jwt functionality
-    tokenId: env_default.MUX_TOKEN_ID || "",
-    tokenSecret: env_default.MUX_TOKEN_SECRET || "",
     jwtSigningKey: context.keyId,
     jwtPrivateKey: context.keySecret
   });
@@ -1191,7 +1221,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;
@@ -1520,7 +1550,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 };
@@ -2037,7 +2067,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);
   }