sanity-plugin-mux-input 2.12.1 → 2.13.0

package/LICENSE

@@ -1,6 +1,6 @@
 MIT License
 
-Copyright (c) 2025 Sanity.io
+Copyright (c) 2026 Sanity.io
 
 Permission is hereby granted, free of charge, to any person obtaining a copy
 of this software and associated documentation files (the "Software"), to deal

package/README.md

@@ -219,6 +219,7 @@ export default defineConfig({
 ```
 
 **Standard mode options:**
+
 - `'highest'`: Produces an MP4 file with video resolution up to 4K (2160p)
 - `'audio-only'`: Produces an M4A (audio-only MP4) file
 
@@ -239,10 +240,12 @@ export default defineConfig({
 ```
 
 **Advanced mode options:**
+
 - Specific resolutions: `'270p'`, `'360p'`, `'480p'`, `'540p'`, `'720p'`, `'1080p'`, `'1440p'`, `'2160p'`
 - `'audio-only'`: M4A file
 
 **Important notes:**
+
 - You cannot mix `'highest'` with specific resolutions (e.g., `['highest', '1080p']` is invalid)
 - Mux will not upscale videos - renditions requiring upscaling are automatically skipped
 - When uploading new assets, editors can choose different rendition settings on a per-video basis
@@ -309,6 +312,136 @@ export default defineConfig({
 
 If your videos are always spoken in a specific language and you want to include captions by default, you can use `disableTextTrackConfig: true` together with `defaultAutogeneratedSubtitleLang` to transcribe captions for every uploaded asset without needing user interaction.
 
+### Accepted File Types
+
+By default, the plugin accepts both video and audio files (`['video/*', 'audio/*']`). You can configure which file types are accepted either globally at the plugin level or per-field at the schema level.
+
+#### Plugin-level configuration
+
+Configure accepted file types for all `mux.video` fields globally:
+
+```js
+import {muxInput} from 'sanity-plugin-mux-input'
+
+export default defineConfig({
+  plugins: [
+    muxInput({
+      acceptedMimeTypes: ['video/*'], // Only accept video files
+      // or
+      acceptedMimeTypes: ['audio/*'], // Only accept audio files
+      // or
+      acceptedMimeTypes: ['video/*', 'audio/*'], // Accept both (default)
+    }),
+  ],
+})
+```
+
+#### Schema-level configuration
+
+You can also configure `acceptedMimeTypes` for individual fields in your schema, which will override the plugin-level configuration:
+
+```js
+import { defineField, defineType } from "sanity";
+
+export default defineType({
+  name: "muxTest",
+  title: "Mux Files",
+  type: "document",
+  fields: [
+    defineField({
+      name: "audioFile",
+      title: "Audio File",
+      type: "mux.video",
+      options: {
+        acceptedMimeTypes: ["audio/*"],
+      },
+    }),
+    defineField({
+      name: "videoFile",
+      title: "Video File",
+      type: "mux.video",
+      options: {
+        acceptedMimeTypes: ["video/*"],
+      },
+    }),
+    defineField({
+      name: "either",
+      title: "Either File",
+      type: "mux.video",
+    }),
+  ],
+});
+```
+
+The `acceptedMimeTypes` option controls the `accept` attribute on the file input, which filters which file types users can select when uploading. This affects both the file picker dialog and drag-and-drop file validation.
+
+📌 **Note**: This option accepts an array of MIME type patterns. The valid values are:
+- `'video/*'` - Accepts all video file types
+- `'audio/*'` - Accepts all audio file types
+
+For more information on the `accept` attribute, refer to the [MDN documentation](https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes/accept).
+
+### File size and duration validation
+
+You can configure maximum file size and video duration limits to prevent users from uploading videos that exceed your requirements. These validations run before the upload starts, providing immediate feedback to users.
+
+#### Plugin-level configuration
+
+Set validation limits for all `mux.video` fields globally:
+
+```js
+import {muxInput} from 'sanity-plugin-mux-input'
+
+export default defineConfig({
+  plugins: [
+    muxInput({
+      maxAssetFileSize: 1024 * 1024 * 1024, // 1 GB in bytes
+      maxAssetDuration: 2 * 60 * 60, // 2 hours in seconds
+    }),
+  ],
+})
+```
+
+#### Schema-level configuration
+
+You can override the global limits for specific fields, allowing different validation rules for different use cases:
+
+```js
+import { defineType, defineField } from "sanity";
+
+export default defineType({
+  name: "muxTest",
+  title: "Mux Files",
+  type: "document",
+  fields: [
+    defineField({
+      name: "shortVideo",
+      title: "Short Video (max 1 minute)",
+      type: "mux.video",
+      options: {
+        maxAssetFileSize: 100 * 1024 * 1024, // 100 MB
+        maxAssetDuration: 60, // 1 minute
+      },
+    }),
+    defineField({
+      name: 'longVideo',
+      title: 'Long Video (max 2 hours)',
+      type: 'mux.video',
+      options: {
+        maxAssetFileSize: 1024 * 1024 * 1024, // 1 GB
+        maxAssetDuration: 2 * 60 * 60, // 2 hours
+      },
+    }),
+    defineField({
+      name: 'unlimitedVideo',
+      title: 'Unlimited Video',
+      type: 'mux.video',
+      // Uses plugin defaults or no validation if not configured
+    }),
+  ]
+})
+```
+
 ## Contributing
 
 Issues are actively monitored and PRs are welcome. When developing this plugin the easiest setup is:

package/dist/index.d.mts

@@ -1,3 +1,4 @@
+import type MuxPlayerElement from '@mux/mux-player'
 import type {PartialDeep} from 'type-fest'
 import {Plugin as Plugin_2} from 'sanity'
 
@@ -172,6 +173,46 @@ declare interface MuxInputConfig {
    * @defaultValue false
    */
   disableTextTrackConfig?: boolean
+  /**
+     * The mime types that are accepted by the input.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/accept}
+     * @defaultValue ['video/*','audio/*']
+
+     */
+  acceptedMimeTypes?: ('audio/*' | 'video/*')[]
+  /**
+   * Maximum file size allowed for video uploads in bytes.
+   * If not specified, no file size validation will be performed.
+   *
+   * @example 1024 * 1024 * 1024 // 1 GB
+   * @defaultValue undefined
+   */
+  maxAssetFileSize?: number
+  /**
+   * Maximum video duration allowed in seconds.
+   * If not specified, no duration validation will be performed.
+   *
+   * @example 2 * 60 * 60 // 2 hours
+   * @defaultValue undefined
+   */
+  maxAssetDuration?: number
+  /**
+   * HLS.js configuration options to be passed to the Mux Player.
+   * These options allow you to customize the underlying HLS.js playback engine behavior.
+   *
+   * @see {@link https://github.com/video-dev/hls.js/blob/master/docs/API.md#fine-tuning}
+   * @defaultValue undefined
+   * @example
+   * ```ts
+   * {
+   *   maxBufferLength: 30,
+   *   lowLatencyMode: true,
+   *   capLevelToPlayerSize: true
+   * }
+   * ```
+   */
+  hlsConfig?: MuxPlayerElement['_hlsConfig']
 }
 
 declare interface MuxPlaybackId {

package/dist/index.d.ts

@@ -1,3 +1,4 @@
+import type MuxPlayerElement from '@mux/mux-player'
 import type {PartialDeep} from 'type-fest'
 import {Plugin as Plugin_2} from 'sanity'
 
@@ -172,6 +173,46 @@ declare interface MuxInputConfig {
    * @defaultValue false
    */
   disableTextTrackConfig?: boolean
+  /**
+     * The mime types that are accepted by the input.
+     *
+     * @see {@link https://developer.mozilla.org/en-US/docs/Web/HTML/Reference/Attributes/accept}
+     * @defaultValue ['video/*','audio/*']
+
+     */
+  acceptedMimeTypes?: ('audio/*' | 'video/*')[]
+  /**
+   * Maximum file size allowed for video uploads in bytes.
+   * If not specified, no file size validation will be performed.
+   *
+   * @example 1024 * 1024 * 1024 // 1 GB
+   * @defaultValue undefined
+   */
+  maxAssetFileSize?: number
+  /**
+   * Maximum video duration allowed in seconds.
+   * If not specified, no duration validation will be performed.
+   *
+   * @example 2 * 60 * 60 // 2 hours
+   * @defaultValue undefined
+   */
+  maxAssetDuration?: number
+  /**
+   * HLS.js configuration options to be passed to the Mux Player.
+   * These options allow you to customize the underlying HLS.js playback engine behavior.
+   *
+   * @see {@link https://github.com/video-dev/hls.js/blob/master/docs/API.md#fine-tuning}
+   * @defaultValue undefined
+   * @example
+   * ```ts
+   * {
+   *   maxBufferLength: 30,
+   *   lowLatencyMode: true,
+   *   capLevelToPlayerSize: true
+   * }
+   * ```
+   */
+  hlsConfig?: MuxPlayerElement['_hlsConfig']
 }
 
 declare interface MuxPlaybackId {