@mux/ai 0.44.0 → 0.45.0

package/dist/{index-DigKByh7.d.ts → index-BD4acrwt.d.ts}

@@ -3,7 +3,7 @@ import { S as SafetyReport, e as PromptOverrides, h as SceneContextItemV1, D as
 import { createAnthropic } from '@ai-sdk/anthropic';
 import { createGoogleGenerativeAI } from '@ai-sdk/google';
 import { createOpenAI } from '@ai-sdk/openai';
-import { l as WorkflowCredentialsInput, d as MuxAsset, A as AssetTextTrack, f as ScopedMuxAIOptions, I as ImageSubmissionMode, i as TokenUsage, M as MuxAIOptions, b as ChunkingStrategy, k as VideoEmbeddingsResult, H as Hotspot, v as Shot, j as ToneType, g as StorageAdapter } from './shots-CUI09Ohe.js';
+import { l as WorkflowCredentialsInput, d as MuxAsset, A as AssetTextTrack, f as ScopedMuxAIOptions, I as ImageSubmissionMode, i as TokenUsage, M as MuxAIOptions, b as ChunkingStrategy, k as VideoEmbeddingsResult, H as Hotspot, v as Shot, j as ToneType, g as StorageAdapter } from './shots-B7G0IIF1.js';
 
 /**
  * Language Code Conversion Utilities

package/dist/{index-C2Pk7bbF.d.ts → index-D6VGaoPm.d.ts}

@@ -1,4 +1,4 @@
-import { l as WorkflowCredentialsInput, n as WorkflowScope, A as AssetTextTrack, d as MuxAsset, T as TextChunk, b as ChunkingStrategy, 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 { l as WorkflowCredentialsInput, n as WorkflowScope, A as AssetTextTrack, d as MuxAsset, T as TextChunk, b as ChunkingStrategy, 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-B7G0IIF1.js';
 
 interface HeatmapOptions {
     /** Time window for results, e.g., '7:days' (default: '7:days') */

package/dist/index.d.ts

@@ -1,8 +1,8 @@
-export { I as ISO639_1, a as ISO639_3, L as LanguageCodePair, M as MUX_TRACK_PASSTHROUGH_MAX_CHARS, R as ReplaceAndCreateTextTrackInput, b as ReplaceAndCreateTextTrackResult, c as ReplaceAndCreateTrackInput, d as ReplaceExistingTracksPolicy, e as ReplaceableTrackType, S as SupportedISO639_1, f as SupportedISO639_3, T as TextTrackReplacementPlan, g as TextTrackSummary, h as TextTrackTarget, i as TrackSummary, j as TrackTarget, k as buildMuxAiTrackPassthrough, l as findNameCollisionTextTracks, m as findSameLanguageTextTracks, n as getLanguageCodePair, o as getLanguageName, p as isDuplicateTrackNameError, q as isMuxGeneratedTextTrack, r as isUndeterminedLanguageCode, s as isValidISO639_1, t as isValidISO639_3, u as normalizeTrackLanguageCode, v as normalizeTrackName, w as planTextTrackReplacement, x as replaceAndCreateTextTrack, y as replaceAndCreateTrack, z as summarizeTextTrack, A as toISO639_1, B as toISO639_3, C as validateTrackPassthrough, D as workflows } from './index-DigKByh7.js';
-import { W as WorkflowCredentials, S as StoragePutObjectInput, a as StoragePresignGetObjectInput } from './shots-CUI09Ohe.js';
-export { A as AssetTextTrack, C as ChunkEmbedding, b as ChunkingStrategy, E as Encrypted, c as EncryptedPayload, I as ImageSubmissionMode, M as MuxAIOptions, d as MuxAsset, P as PlaybackAsset, e as PlaybackPolicy, f as ScopedMuxAIOptions, g as StorageAdapter, T as TextChunk, h as TokenChunkingConfig, i as TokenUsage, j as ToneType, U as UsageMetadata, V as VTTChunkingConfig, k as VideoEmbeddingsResult, l as WorkflowCredentialsInput, m as WorkflowMuxClient, n as WorkflowScope, o as decryptFromWorkflow, p as encryptForWorkflow } from './shots-CUI09Ohe.js';
+export { I as ISO639_1, a as ISO639_3, L as LanguageCodePair, M as MUX_TRACK_PASSTHROUGH_MAX_CHARS, R as ReplaceAndCreateTextTrackInput, b as ReplaceAndCreateTextTrackResult, c as ReplaceAndCreateTrackInput, d as ReplaceExistingTracksPolicy, e as ReplaceableTrackType, S as SupportedISO639_1, f as SupportedISO639_3, T as TextTrackReplacementPlan, g as TextTrackSummary, h as TextTrackTarget, i as TrackSummary, j as TrackTarget, k as buildMuxAiTrackPassthrough, l as findNameCollisionTextTracks, m as findSameLanguageTextTracks, n as getLanguageCodePair, o as getLanguageName, p as isDuplicateTrackNameError, q as isMuxGeneratedTextTrack, r as isUndeterminedLanguageCode, s as isValidISO639_1, t as isValidISO639_3, u as normalizeTrackLanguageCode, v as normalizeTrackName, w as planTextTrackReplacement, x as replaceAndCreateTextTrack, y as replaceAndCreateTrack, z as summarizeTextTrack, A as toISO639_1, B as toISO639_3, C as validateTrackPassthrough, D as workflows } from './index-BD4acrwt.js';
+import { W as WorkflowCredentials, S as StoragePutObjectInput, a as StoragePresignGetObjectInput } from './shots-B7G0IIF1.js';
+export { A as AssetTextTrack, C as ChunkEmbedding, b as ChunkingStrategy, E as Encrypted, c as EncryptedPayload, I as ImageSubmissionMode, M as MuxAIOptions, d as MuxAsset, P as PlaybackAsset, e as PlaybackPolicy, f as ScopedMuxAIOptions, g as StorageAdapter, T as TextChunk, h as TokenChunkingConfig, i as TokenUsage, j as ToneType, U as UsageMetadata, V as VTTChunkingConfig, k as VideoEmbeddingsResult, l as WorkflowCredentialsInput, m as WorkflowMuxClient, n as WorkflowScope, o as decryptFromWorkflow, p as encryptForWorkflow } from './shots-B7G0IIF1.js';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
-export { i as primitives } from './index-C2Pk7bbF.js';
+export { i as primitives } from './index-D6VGaoPm.js';
 import 'zod';
 import './summarization-BFmhXeAu.js';
 import '@ai-sdk/anthropic';
@@ -10,7 +10,7 @@ import '@ai-sdk/google';
 import '@ai-sdk/openai';
 import '@mux/mux-node';
 
-var version = "0.44.0";
+var version = "0.45.0";
 
 type MuxAiErrorType = "validation_error" | "processing_error" | "timeout_error" | "content_policy_error";
 /**
@@ -43,6 +43,13 @@ declare class MuxAiError extends Error {
 }
 declare function wrapError(error: unknown, message: string): never;
 
+type MuxPlaybackService = "image" | "stream";
+/**
+ * Builds the playback origin for a Mux domain, matching Mux Player's `customDomain`
+ * expansion (e.g. "media.example.com" becomes "https://image.media.example.com").
+ */
+declare function getMuxPlaybackOrigin(service: MuxPlaybackService, customDomain?: string): string;
+
 /**
  * A function that returns workflow credentials, either synchronously or asynchronously.
  * Used to inject credentials from external sources (e.g., a secrets manager).
@@ -77,4 +84,4 @@ declare class WorkflowStorageClient {
 }
 declare function createWorkflowStorageClient(options?: WorkflowStorageClientOptions): WorkflowStorageClient;
 
-export { MuxAiError, type MuxAiErrorType, StoragePresignGetObjectInput, StoragePutObjectInput, WorkflowCredentials, type WorkflowCredentialsProvider, WorkflowStorageClient, createWorkflowStorageClient, setWorkflowCredentialsProvider, version, wrapError };
+export { MuxAiError, type MuxAiErrorType, type MuxPlaybackService, StoragePresignGetObjectInput, StoragePutObjectInput, WorkflowCredentials, type WorkflowCredentialsProvider, WorkflowStorageClient, createWorkflowStorageClient, getMuxPlaybackOrigin, setWorkflowCredentialsProvider, version, wrapError };

package/dist/index.js

@@ -5,7 +5,7 @@ var __export = (target, all) => {
 };
 
 // package.json
-var version = "0.44.0";
+var version = "0.45.0";
 
 // src/lib/language-codes.ts
 var ISO639_1_TO_3 = {
@@ -204,12 +204,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(
@@ -328,7 +332,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
@@ -1354,6 +1369,82 @@ async function replaceAndCreateTextTrack(input) {
   return replaceAndCreateTrack({ ...input, target: { ...input.target, type: "text" } });
 }
 
+// src/lib/mux-url.ts
+var DEFAULT_MUX_DOMAIN = "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 ${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 ${envVarName}. Only a hostname/origin is allowed (no credentials, query params, hash fragments, or path).`
+    );
+  }
+  return parsed.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 parsed.origin;
+}
+function getMuxPlaybackOrigin(service, customDomain = DEFAULT_MUX_DOMAIN) {
+  return buildPlaybackOrigin(service, customDomain, "custom domain");
+}
+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 buildPlaybackOrigin(service, DEFAULT_MUX_DOMAIN, "custom domain");
+}
+async function getMuxImageOrigin(credentials) {
+  return resolveMuxPlaybackOrigin("image", credentials);
+}
+async function getMuxStreamOrigin(credentials) {
+  return resolveMuxPlaybackOrigin("stream", credentials);
+}
+async function getMuxImageBaseUrl(playbackId, assetType, credentials) {
+  const origin = await getMuxImageOrigin(credentials);
+  return `${origin}/${playbackId}/${assetType}.png`;
+}
+async function getMuxStoryboardBaseUrl(playbackId, credentials) {
+  return getMuxImageBaseUrl(playbackId, "storyboard", credentials);
+}
+async function getMuxThumbnailBaseUrl(playbackId, credentials) {
+  return getMuxImageBaseUrl(playbackId, "thumbnail", credentials);
+}
+
 // node_modules/@workflow/serde/dist/index.js
 var WORKFLOW_SERIALIZE = /* @__PURE__ */ Symbol.for("workflow-serialize");
 var WORKFLOW_DESERIALIZE = /* @__PURE__ */ Symbol.for("workflow-deserialize");
@@ -2309,53 +2400,6 @@ 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";
-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 ${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 ${envVarName}. 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 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();
-  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");
@@ -2397,7 +2441,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;
@@ -2746,7 +2790,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 };
@@ -3189,7 +3233,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);
   }
@@ -6115,7 +6159,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) {
@@ -7639,7 +7683,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}`;
@@ -8823,7 +8867,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);
     }
@@ -9848,6 +9892,7 @@ export {
   findSameLanguageTextTracks,
   getLanguageCodePair,
   getLanguageName,
+  getMuxPlaybackOrigin,
   isDuplicateTrackNameError,
   isMuxGeneratedTextTrack,
   isUndeterminedLanguageCode,