@mux/ai 0.53.0 → 0.54.0

package/dist/{index-BbxJ0X25.d.ts → index-CmTC1w4V.d.ts}

@@ -1488,8 +1488,9 @@ type ThumbnailModerationSkipReason = "no_video_track" | "no_video_in_scope";
  *   body was empty, had no parseable cues, or no cue fell inside `scope`.
  *   Treated as valid-but-empty, not as an error.
  * - `"unsupported_provider"` — the selected provider is image-only.
+ * - `"disabled"` — the caller passed `includeTranscript: false` for a video asset.
  */
-type TranscriptModerationSkipReason = "no_ready_text_track" | "no_cues" | "unsupported_provider";
+type TranscriptModerationSkipReason = "no_ready_text_track" | "no_cues" | "unsupported_provider" | "disabled";
 type ThumbnailModerationStatus = ModerationSurfaceStatus<ThumbnailModerationSkipReason>;
 type TranscriptModerationStatus = ModerationSurfaceStatus<TranscriptModerationSkipReason>;
 /** Aggregated moderation payload returned from `getModerationScores`. */
@@ -1575,6 +1576,12 @@ interface ModerationOptions extends ScopedMuxAIOptions {
      * subtitles track is preferred and otherwise the first ready text track is used.
      */
     languageCode?: string;
+    /**
+     * Moderate the caption transcript alongside thumbnails (defaults to true). When false,
+     * video assets are moderated on thumbnails only. Ignored for audio-only assets, where
+     * the transcript is the only surface that can be moderated.
+     */
+    includeTranscript?: boolean;
     /** Override the default sexual/violence thresholds (0-1). */
     thresholds?: {
         sexual?: number;
@@ -1654,7 +1661,8 @@ declare function buildTranscriptWindows(cues: VTTCue[], duration: number): Trans
  * Moderate a Mux asset. By default both surfaces are moderated where available:
  * - Thumbnails: sampled storyboard frames (image moderation). Skipped for audio-only assets.
  * - Transcript: caption text in time windows (text moderation). Skipped when no
- *   usable caption track exists or the provider is image-only.
+ *   usable caption track exists, the provider is image-only, or `includeTranscript`
+ *   is false for a video asset.
  *
  * Each surface reports its outcome in `thumbnailModeration` / `transcriptModeration`.
  * Throws when neither surface can be moderated, since a result with nothing

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-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 ReplaceSourceTrackInput, f as ReplaceableTrackType, S as SourceTrackReplacementPolicy, g as SupportedISO639_1, h as SupportedISO639_3, T as TextTrackReplacementPlan, i as TextTrackSummary, j as TextTrackTarget, k as TrackSummary, l as TrackTarget, m as buildMuxAiTrackPassthrough, n as findNameCollisionTextTracks, o as findSameLanguageTextTracks, p as getLanguageCodePair, q as getLanguageName, r as isDuplicateTrackNameError, s as isMuxGeneratedTextTrack, t as isUndeterminedLanguageCode, u as isValidISO639_1, v as isValidISO639_3, w as normalizeTrackLanguageCode, x as normalizeTrackName, y as planSourceTrackReplacement, z as planTextTrackReplacement, A as replaceAndCreateTextTrack, B as replaceAndCreateTrack, C as replaceSourceTrack, D as summarizeTextTrack, E as toISO639_1, F as toISO639_3, G as validateTrackPassthrough, H as workflows } from './index-BbxJ0X25.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 ReplaceSourceTrackInput, f as ReplaceableTrackType, S as SourceTrackReplacementPolicy, g as SupportedISO639_1, h as SupportedISO639_3, T as TextTrackReplacementPlan, i as TextTrackSummary, j as TextTrackTarget, k as TrackSummary, l as TrackTarget, m as buildMuxAiTrackPassthrough, n as findNameCollisionTextTracks, o as findSameLanguageTextTracks, p as getLanguageCodePair, q as getLanguageName, r as isDuplicateTrackNameError, s as isMuxGeneratedTextTrack, t as isUndeterminedLanguageCode, u as isValidISO639_1, v as isValidISO639_3, w as normalizeTrackLanguageCode, x as normalizeTrackName, y as planSourceTrackReplacement, z as planTextTrackReplacement, A as replaceAndCreateTextTrack, B as replaceAndCreateTrack, C as replaceSourceTrack, D as summarizeTextTrack, E as toISO639_1, F as toISO639_3, G as validateTrackPassthrough, H as workflows } from './index-CmTC1w4V.js';
 import { M as MuxAsset, W as WorkflowCredentials, S as StoragePutObjectInput, a as StoragePresignGetObjectInput } from './transcripts-BCtzC8hZ.js';
 export { A as AssetTextTrack, C as ChunkEmbedding, b as ChunkingStrategy, E as Encrypted, c as EncryptedPayload, I as ImageSubmissionMode, d as MuxAIOptions, 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 './transcripts-BCtzC8hZ.js';
 import { WORKFLOW_SERIALIZE, WORKFLOW_DESERIALIZE } from '@workflow/serde';
@@ -11,7 +11,7 @@ import '@ai-sdk/google';
 import '@ai-sdk/openai';
 import '@mux/ts';
 
-var version = "0.53.0";
+var version = "0.54.0";
 
 type MuxAiErrorType = "validation_error" | "processing_error" | "timeout_error" | "content_policy_error";
 /**

package/dist/index.js

@@ -5,7 +5,7 @@ var __export = (target, all) => {
 };
 
 // package.json
-var version = "0.53.0";
+var version = "0.54.0";
 
 // src/lib/language-codes.ts
 var ISO639_1_TO_3 = {
@@ -8199,6 +8199,7 @@ async function getModerationScores(assetId, options = {}) {
     provider = DEFAULT_PROVIDER2,
     model = provider === "openai" ? "omni-moderation-latest" : void 0,
     languageCode,
+    includeTranscript = true,
     thresholds = DEFAULT_THRESHOLDS,
     thumbnailInterval = 10,
     thumbnailWidth = 640,
@@ -8279,8 +8280,15 @@ async function getModerationScores(assetId, options = {}) {
   let transcriptModeration = { status: "completed" };
   let transcriptCues = [];
   let shouldRunTranscript = false;
-  const captionTrack = provider === "openai" ? findCaptionTrack(asset, languageCode) : void 0;
-  if (provider !== "openai") {
+  const transcriptEnabled = includeTranscript || isAudioOnly;
+  const captionTrack = transcriptEnabled && provider === "openai" ? findCaptionTrack(asset, languageCode) : void 0;
+  if (!transcriptEnabled) {
+    transcriptModeration = {
+      status: "skipped",
+      skipReason: "disabled",
+      skipMessage: "Transcript moderation was disabled with includeTranscript: false."
+    };
+  } else if (provider !== "openai") {
     transcriptModeration = {
       status: "skipped",
       skipReason: "unsupported_provider",