sanity-plugin-mux-input 2.16.0 → 2.17.0

package/src/util/types.ts

@@ -274,12 +274,52 @@ export function isAutogeneratedTrack(
 
 export type UploadTextTrack = AutogeneratedTextTrack | CustomTextTrack
 
+/**
+ * Watermark configuration for UI (draggable position)
+ */
+export interface WatermarkConfig {
+  enabled: boolean
+  imageUrl?: string
+  /**
+   * Aspect ratio (width / height) of the watermark image.
+   * Used to convert between our center-based UI coords and Mux overlay margins.
+   */
+  imageAspectRatio?: number
+  /**
+   * Optional explicit Mux `overlay_settings`.
+   * When set, these values should be used as-is for the upload request and preview.
+   * @see {@link https://www.mux.com/docs/guides/add-watermarks-to-your-videos}
+   */
+  overlay_settings?: MuxOverlaySettings
+  position?: {
+    x: number // percentage (0-100)
+    y: number // percentage (0-100)
+  }
+  size?: number // percentage of video width (0-100)
+  opacity?: number // 0-1 (converted to percentage string for Mux API)
+}
+
+/**
+ * Mux overlay_settings format for watermark API
+ * @see {@link https://www.mux.com/docs/guides/add-watermarks-to-your-videos}
+ */
+export interface MuxOverlaySettings {
+  vertical_align: 'top' | 'middle' | 'bottom'
+  vertical_margin: string // percentage (e.g., "10%") or pixels (e.g., "40px")
+  horizontal_align: 'left' | 'center' | 'right'
+  horizontal_margin: string // percentage (e.g., "10%") or pixels (e.g., "40px")
+  width?: string // percentage (e.g., "25%") or pixels (e.g., "80px")
+  height?: string // percentage or pixels
+  opacity?: string // percentage string (e.g., "90%")
+}
+
 export interface UploadConfig
   extends Pick<MuxInputConfig, 'max_resolution_tier' | 'normalize_audio' | 'video_quality'> {
   static_renditions: StaticRenditionResolution[]
   text_tracks: UploadTextTrack[]
   signed_policy: boolean
   public_policy: boolean
+  watermark?: WatermarkConfig
   drm_policy: boolean
 }
 
@@ -309,7 +349,7 @@ export interface MuxNewAssetSettings
     /** The time offset in seconds from the beginning of the video indicating the clip's ending marker. */
     end_time?: number
     /** This parameter is required for text type tracks. */
-    type: 'video' | 'audio' | 'text'
+    type?: 'video' | 'audio' | 'text'
     /** Type of text track. This parameter only supports subtitles value. */
     text_type?: 'subtitles'
     /** The language code value must be a valid BCP 47 specification compliant value. */
@@ -320,6 +360,8 @@ export interface MuxNewAssetSettings
     closed_captions?: boolean
     /** This optional parameter should be used tracks with type of text and text_type set to subtitles. */
     passthrough?: string
+    /** Overlay settings for watermarks. Used when adding a watermark image as a second input. */
+    overlay_settings?: MuxOverlaySettings
   }[]
 
   /** An array of playback policy names that you want applied to this asset and available through playback_ids. */