schema

type Artwork []byte

type AudioChannelLayout struct {
	*ff.AVChannelLayout
}

type Codec struct {
	*ff.AVCodec
}

type DecodeRequest struct {
	Request // Embed base request (Input, Reader)
}

type Device struct {
	Index       int      `json:"index"`
	Name        string   `json:"name"`
	Description string   `json:"description,omitempty"`
	IsDefault   bool     `json:"is_default,omitempty"`
	MediaTypes  []string `json:"media_types,omitempty"` // "video", "audio", etc.
}

type Filter struct {
	*ff.AVFilter
}

type Format struct {
	Name        string   `json:"name"`
	Description string   `json:"description,omitempty"`
	MimeTypes   []string `json:"mime_types,omitempty"`  // MIME types
	Extensions  []string `json:"extensions,omitempty"`  // File extensions
	IsInput     bool     `json:"is_input"`              // Is demuxer (input format)
	IsOutput    bool     `json:"is_output"`             // Is muxer (output format)
	IsDevice    bool     `json:"is_device,omitempty"`   // Is device format
	Flags       []string `json:"flags,omitempty"`       // Format flags
	MediaTypes  []string `json:"media_types,omitempty"` // Supported media types: "video", "audio", "subtitle"

	// Output format specific fields
	DefaultVideoCodec    string `json:"default_video_codec,omitempty"`
	DefaultAudioCodec    string `json:"default_audio_codec,omitempty"`
	DefaultSubtitleCodec string `json:"default_subtitle_codec,omitempty"`

	// Device specific fields
	Devices []Device `json:"devices,omitempty"` // Available devices (for device formats)
}

type FrameWriter interface {
	io.Writer
	WriteFrame(streamIndex int, frame interface{}) error
}

type ListAudioChannelLayoutRequest struct {
	Name        string `json:"name"`
	NumChannels int    `json:"num_channels"`
}

type ListAudioChannelLayoutResponse []AudioChannelLayout

type ListCodecRequest struct {
	Name      string `json:"name,omitempty"`       // Filter by codec name
	Type      string `json:"type,omitempty"`       // Filter by media type: "video", "audio", "subtitle", "data"
	IsEncoder *bool  `json:"is_encoder,omitempty"` // Filter by encoder (true) or decoder (false), nil = no filter
}

type ListCodecResponse []Codec

type ListFilterRequest struct {
	Name string `json:"name"`
}

type ListFilterResponse []Filter

type ListFormatRequest struct {
	Name     string `json:"name,omitempty"`      // Filter by format name (partial match)
	IsInput  *bool  `json:"is_input,omitempty"`  // Filter by input format (demuxer)
	IsOutput *bool  `json:"is_output,omitempty"` // Filter by output format (muxer)
	IsDevice *bool  `json:"is_device,omitempty"` // Filter by device format
}

type ListFormatResponse []Format

type ListPixelFormatRequest struct {
	Name      string `json:"name"`
	NumPlanes int    `json:"num_planes"`
}

type ListPixelFormatResponse []PixelFormat

type ListSampleFormatRequest struct {
	Name     string `json:"name"`
	IsPlanar *bool  `json:"is_planar,omitempty"` // Filter by planar/packed (nil = no filter)
}

type ListSampleFormatResponse []SampleFormat

type MediaType ff.AVMediaType

type Output struct {
	Output     string   `json:"output"  arg:""` // Output media file path
	OutputOpts []string `json:"opts,omitempty"` // Format-specific options (e.g., "movflags=+faststart")
}

type Packet struct {
	*ff.AVPacket
}

type PixelFormat struct {
	ff.AVPixelFormat
}

type ProbeRequest struct {
	Request
	Metadata bool `json:"metadata,omitempty" help:"Include metadata in response"`
	Artwork  bool `json:"artwork,omitempty" help:"Include artwork in response"`
}

type ProbeResponse struct {
	Format      string            `json:"format"`                // Format name (e.g., "mov,mp4,m4a,3gp,3g2,mj2")
	Description string            `json:"description,omitempty"` // Format description (e.g., "QuickTime / MOV")
	MimeTypes   []string          `json:"mime_types,omitempty"`  // MIME types
	Duration    float64           `json:"duration"`              // Duration in seconds
	Streams     []*Stream         `json:"streams,omitempty"`     // Stream information
	Metadata    map[string]string `json:"metadata,omitempty"`    // Metadata key-value pairs
	Artwork     []Artwork         `json:"artwork,omitempty"`     // Artwork images as raw bytes (JSON encodes as base64)
}

type RemuxRequest struct {
	Request
	Output
	Streams      []int             `json:"streams,omitempty"`       // Stream indices to include (empty = all streams)
	CopyMetadata bool              `json:"copy_metadata,omitempty"` // Copy existing metadata from source
	CopyArtwork  bool              `json:"copy_artwork,omitempty"`  // Copy existing artwork from source
	Metadata     map[string]string `json:"metadata,omitempty"`      // Metadata to set (empty string value clears existing)
	Artwork      []Artwork         `json:"artwork,omitempty"`       // Artwork to add/replace
}

type RemuxResponse struct {
	Format   string            `json:"format"`             // Output format name
	Duration float64           `json:"duration"`           // Duration in seconds
	Size     int64             `json:"size"`               // Total bytes written
	Streams  []Stream          `json:"streams,omitempty"`  // Stream information
	Metadata map[string]string `json:"metadata,omitempty"` // Final metadata
	Artwork  []Artwork         `json:"artwork,omitempty"`  // Final artwork
}

type Request struct {
	Input       string    `json:"input" arg:""` // Input media file path
	Reader      io.Reader `json:"-" kong:"-"`   // Reader for media data
	InputFormat string    `json:"input_format,omitempty" name:"input-format" help:"Input format name (e.g. mpegts)"`
	InputOpts   []string  `json:"input_opts,omitempty" name:"input-opt" help:"Input format option key=value (repeatable)"`
}

type SampleFormat struct {
	ff.AVSampleFormat
}

type Stream struct {
	*ff.AVStream
	// contains filtered or unexported fields
}

type Writer interface {
	io.Writer
	Progress(current, total int64) // Report progress (units depends on task)
	Log(message string)            // Receive log messages
}