transcode

type Capabilities struct {
	ProbedAt    time.Time `json:"probedAt"`
	OS          string    `json:"os"`
	FFmpegPath  string    `json:"ffmpegPath"`
	FFmpegVer   string    `json:"ffmpegVersion"`
	HasNVIDIA   bool      `json:"hasNvidia"`
	HasVAAPI    bool      `json:"hasVaapi"`
	HasQSV      bool      `json:"hasQsv"`
	Encoders    []Encoder `json:"encoders"`
	Decoders    []Decoder `json:"decoders"`
	Preferred   string    `json:"preferred"`     // chosen encoder ID for H.264 transcoding
	PreferredHE string    `json:"preferredHevc"` // chosen for HEVC transcoding (if any)
}

type Decoder struct {
	ID         string `json:"id"`
	Codec      string `json:"codec"`
	Backend    string `json:"backend"`
	Available  bool   `json:"available"`
	Functional bool   `json:"functional"`
	Error      string `json:"error,omitempty"`
}

type Encoder struct {
	ID          string  `json:"id"`                 // stable identifier (e.g. "h264_nvenc")
	Codec       string  `json:"codec"`              // "h264" | "hevc"
	Backend     string  `json:"backend"`            // "nvidia" | "amd-vaapi" | "intel-qsv" | "cpu"
	Available   bool    `json:"available"`          // listed by ffmpeg as compiled in
	Functional  bool    `json:"functional"`         // smoke-test encode succeeded
	BenchFPS    float64 `json:"benchFps,omitempty"` // frames/sec on 480p test clip
	Description string  `json:"description"`
	Error       string  `json:"error,omitempty"`
}

type HLSSession struct {
	Key        string
	Dir        string
	Cmd        *exec.Cmd
	Cancel     context.CancelFunc
	StartedAt  time.Time
	LastAccess time.Time
	// DurationSec is the total media duration, probed (seekably) once at
	// startup. 0 means "unknown" — the source's moov/Cues weren't reachable
	// in time, so callers must fall back to the live/EVENT playlist instead
	// of generating a finite VOD playlist.
	DurationSec float64
	// contains filtered or unexported fields
}

type HLSSessionManager struct {
	// contains filtered or unexported fields
}

type HLSSessionSnapshot struct {
	Key           string    `json:"key"`
	Codec         string    `json:"codec"`
	SegmentsReady int       `json:"segmentsReady"`
	StartedAt     time.Time `json:"startedAt"`
	LastActivity  time.Time `json:"lastActivity"`
	Pid           int       `json:"pid"`
}

type HLSStartOpts struct {
	Key                 string        // raw content key, e.g. `${hash}-${fileIdx}`; EffectiveKey may add a mode suffix
	Source              io.ReadSeeker // seekable input — wrapped by an internal HTTP server
	SourceSize          int64         // total size hint; required when the underlying reader lies about EOF
	VideoCodec          string        // "h264_nvenc" | "libx264" | etc.
	PreserveSourceAudio bool          // when true and source audio is AAC, -c:a copy; else transcode to AAC
	// NativeHLS marks a Safari/iOS client (native HLS). Combined with the VOD
	// policy it decides whether this session uses the finite-VOD path.
	NativeHLS bool
	// KnownDurationSec lets the caller supply a duration it already probed (the
	// local-file path runs ffprobe at play time). >0 skips the in-session 30s
	// seekable probe — the rclone/Drive latency win.
	KnownDurationSec float64
	// ForceVOD opts this session into the finite-VOD (seekbar) path whenever the
	// duration is known, BYPASSING the per-client vodMode gate. Used by the
	// local-file path: a fully-downloaded file on disk/rclone is complete and
	// seekable, so EVENT/live (the last-resort path for unknown-duration
	// streams) is wrong for it — VOD is the correct default per the playback
	// premise. Torrents leave this false so the global vodMode still guards the
	// #61 Safari seek instability on (incomplete) torrent sources.
	ForceVOD bool
	// AudioOnly transcodes a pure-audio source (FLAC/OGG/Opus/ALAC/WMA/…) to an
	// AAC HLS stream with NO video map (`-vn`). The local-file path sets it for
	// codecs the target browser can't direct-play (Safari refuses FLAC/OGG/Opus),
	// since the video pipeline's unconditional `-map 0:v:0` would fail on a file
	// with no video stream.
	AudioOnly bool
	// AudioTrack é o índice ABSOLUTO da faixa de áudio a mapear no vídeo (>0 =
	// escolhida; <=0 = primeira/default). A sessão é keyed pela faixa (ver
	// hlsSessionKey) pra que trocar o áudio gere um transcode novo, não reuse o cache.
	AudioTrack int
}

type Options struct {
	AudioTrack   int    // absolute stream index for `-map 0:<n>` (-1 = first audio)
	SubBurnTrack int    // -1 = none; otherwise absolute stream index for hardsub burn-in
	VideoCodec   string // "" = copy; "h264" / "hevc" = transcode video
	AudioCodec   string // "" = copy; "aac" = transcode audio
	Container    string // "mp4" | "matroska" | "webm" — default "mp4"
	SourceVCodec string // optional hint about source video codec (for hwaccel selection)
}

type VODMode int