sanity-plugin-mux-input 2.16.0 → 2.18.0

package/src/util/formatDriveShareLink.ts

@@ -0,0 +1,64 @@
+/**
+ * Format Google Drive share links as Google Drive export links.
+ * Supported formats:
+ *  - https://drive.google.com/uc?id=<ID>...
+ *  - https://drive.google.com/open?id=<ID>...
+ *  - https://drive.google.com/file/d/<ID>...
+ *  - https://drive.google.com/folder/<ID>...
+ *
+ * @param url Google Drive share link to format.
+ * @returns Google Drive export link (URL passthrough if not share link).
+ */
+export function formatDriveShareLink(url: string): string {
+  // Export link formatter.
+  const formatExportLink = (id: string) => {
+    return `https://drive.google.com/uc?export=download&id=${id}`
+  }
+
+  // URL formatting.
+  try {
+    // Parse URL.
+    const trimmed = url.trim()
+    const parsed = new URL(trimmed)
+
+    // Enforce strict host name.
+    if (parsed.hostname !== 'drive.google.com') {
+      throw new Error('URL is not from Google Drive.')
+    }
+
+    // Look for ID in search parameters.
+    const id = parsed.searchParams.get('id') || ''
+    if (id.length) {
+      return formatExportLink(id)
+    }
+
+    // Look for ID in path name.
+    const path = parsed.pathname.split('/') || []
+
+    // Path is /file/d/<ID>...
+    if (path.includes('file') && path.includes('d')) {
+      const index =
+        path.findIndex((value: string) => {
+          return value === 'd'
+        }) + 1
+      const fileId = path.at(index) || ''
+      return formatExportLink(fileId)
+    }
+
+    // Path is /folder/<ID>...
+    if (path.includes('folders')) {
+      const index =
+        path.findIndex((value: string) => {
+          return value === 'folders'
+        }) + 1
+      const folderId = path.at(index) || ''
+      return formatExportLink(folderId)
+    }
+
+    // URL not recognized.
+    throw new Error('URL was not recognized.')
+  } catch {
+    // URL passthrough by default.
+    return url
+  }
+}

package/src/util/roundPxString.ts

@@ -0,0 +1,16 @@
+/**
+ * Rounds the numeric part of a px string to the nearest integer.
+ * Returns undefined if the value is not a valid px string or not a finite number.
+ * Avoids sending 0px (and JS -0); snaps to ±1 instead.
+ */
+export function roundPxString(value: unknown): string | undefined {
+  if (typeof value !== 'string') return undefined
+  const trimmed = value.trim()
+  if (!trimmed.endsWith('px')) return undefined
+  const n = Number(trimmed.slice(0, -2))
+  if (!Number.isFinite(n)) return undefined
+  let rounded = Math.round(n)
+  // Avoid sending 0px (and JS -0); keep sign when negative.
+  if (rounded === 0) rounded = n < 0 ? -1 : 1
+  return `${rounded}px`
+}

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. */