Enhance SuperFlix video playback and caching mechanisms

- Added tests to ensure proper handling of HLS demuxer arguments based on video source type.
- Improved error handling in player menu and resume dialog functions.
- Refactored video URL extraction logic to prefer unsigned HLS playlists over secured links.
- Implemented a CDN liveness probe to validate stream URLs and evict stale cache entries.
- Updated subtitle argument handling to ensure one `--sub-file=` per track, avoiding issues with URL separators.
- Enhanced test coverage for stream caching and subtitle argument generation.

Author: alvarorichard

internal/api/enhanced.go

@@ -790,7 +790,6 @@ func GetSuperFlixStreamURL(media *models.Anime, episode *models.Episode, quality
 	if result.Referer != "" {
 		util.SetGlobalReferer(result.Referer)
 	}
-
 	// Update cover image from stream thumbnail if not already set
 	if media.ImageURL == "" && result.Thumb != "" {
 		media.ImageURL = result.Thumb

internal/api/superflix_servers.go

@@ -8,7 +8,6 @@ import (
 	"github.com/alvarorichard/Goanime/internal/scraper/providers/superflix"
 	"github.com/alvarorichard/Goanime/internal/tui"
 	"github.com/alvarorichard/Goanime/internal/util"
-	"github.com/ktr0731/go-fuzzyfinder"
 )
 
 // SuperFlix offers, per episode, a list of servers, and each server is tagged
@@ -26,8 +25,12 @@ import (
 // sfPickFn is the single selection seam for every SuperFlix prompt. A package var
 // so tests drive the whole flow without a TTY.
 var sfPickFn = func(prompt string, labels []string) (int, error) {
-	return tui.Find(labels, func(i int) string { return labels[i] },
-		fuzzyfinder.WithPromptString(prompt))
+	return tui.PickLabels(labels, tui.PickOptions{
+		Breadcrumb:   "SuperFlix > " + prompt,
+		WindowTitle:  "GoAnime - SuperFlix",
+		ItemSingular: "option",
+		ItemPlural:   "options",
+	})
 }
 
 // audioKindName is the site's own word for an audio type.

internal/playback/input.go

@@ -1,9 +1,10 @@
 package playback
 
 import (
+	"errors"
+
 	"github.com/alvarorichard/Goanime/internal/tui"
 	"github.com/alvarorichard/Goanime/internal/util"
-	"github.com/ktr0731/go-fuzzyfinder"
 )
 
 // menuItem maps a display label to the short code returned by GetUserInput.
@@ -12,10 +13,19 @@ type menuItem struct {
 	Value string
 }
 
-// findMenuFunc is a package-level indirection over tui.Find so tests can
-// drive GetUserInput without opening a TUI.
-var findMenuFunc = func(items []menuItem, itemFunc func(i int) string, opts ...fuzzyfinder.Option) (int, error) {
-	return tui.Find(items, itemFunc, opts...)
+// findMenuFunc is a package-level indirection over the fancy picker so tests
+// can drive GetUserInput without opening a TTY.
+var findMenuFunc = func(items []menuItem) (int, error) {
+	labels := make([]string, len(items))
+	for i, it := range items {
+		labels[i] = it.Label
+	}
+	return tui.PickLabels(labels, tui.PickOptions{
+		Breadcrumb:   "Playback > Next",
+		WindowTitle:  "GoAnime - Menu",
+		ItemSingular: "option",
+		ItemPlural:   "options",
+	})
 }
 
 // GetUserInput shows post-playback menu. Pass isMovie=true for movies to show
@@ -44,16 +54,19 @@ func GetUserInput(isMovie ...bool) string {
 		}
 	}
 
-	idx, err := findMenuFunc(items, func(i int) string {
-		return items[i].Label
-	}, fuzzyfinder.WithPromptString("What would you like to do next? "))
+	idx, err := findMenuFunc(items)
 	if err != nil {
-		// A broken or aborted menu must not auto-advance: returning "n" here
-		// made HandleSeries/HandleMovie auto-play forever on non-TTY
-		// terminals and turned Esc into "next episode".
+		// Esc/back from the fancy picker is an intentional exit path.
+		if errors.Is(err, tui.ErrPickBack) {
+			return "back"
+		}
+		// A broken menu must not auto-advance: returning "n" here made
+		// HandleSeries/HandleMovie auto-play forever on non-TTY terminals.
 		util.Errorf("Error showing menu: %v", err)
 		return "q"
 	}
-
+	if idx < 0 || idx >= len(items) {
+		return "q"
+	}
 	return items[idx].Value
 }

internal/playback/input_test.go

@@ -4,41 +4,56 @@ import (
 	"errors"
 	"testing"
 
-	"github.com/ktr0731/go-fuzzyfinder"
+	"github.com/alvarorichard/Goanime/internal/tui"
 	"github.com/stretchr/testify/assert"
 	"github.com/stretchr/testify/require"
 )
 
 // swapFindMenu replaces the menu finder seam for the duration of the test.
 // Tests using it mutate a package global, so they must not run in parallel.
-func swapFindMenu(t *testing.T, fn func(items []menuItem, itemFunc func(i int) string, opts ...fuzzyfinder.Option) (int, error)) {
+func swapFindMenu(t *testing.T, fn func(items []menuItem) (int, error)) {
 	t.Helper()
 	orig := findMenuFunc
 	findMenuFunc = fn
 	t.Cleanup(func() { findMenuFunc = orig })
 }
 
 func TestGetUserInput_MenuErrorDoesNotAutoAdvance(t *testing.T) {
-	// Regression: on menu failure (non-TTY, Esc, broken terminal) GetUserInput
+	// Regression: on menu failure (non-TTY, broken terminal) GetUserInput
 	// returned "n", which made HandleSeries/HandleMovie auto-play the next
 	// episode forever with zero user input. Failure must quit.
-	swapFindMenu(t, func(_ []menuItem, _ func(i int) string, _ ...fuzzyfinder.Option) (int, error) {
+	swapFindMenu(t, func(_ []menuItem) (int, error) {
 		return 0, errors.New("failed to open TTY")
 	})
 	assert.Equal(t, "q", GetUserInput(), "menu failure must map to quit, never to next-episode")
 	assert.Equal(t, "q", GetUserInput(true), "movie menu failure must map to quit, never to replay")
 }
 
+func TestGetUserInput_PickBackMapsToBack(t *testing.T) {
+	swapFindMenu(t, func(_ []menuItem) (int, error) {
+		return -1, tui.ErrPickBack
+	})
+	assert.Equal(t, "back", GetUserInput())
+	assert.Equal(t, "back", GetUserInput(true))
+}
+
+func TestGetUserInput_PickCancelMapsToQuit(t *testing.T) {
+	swapFindMenu(t, func(_ []menuItem) (int, error) {
+		return -1, tui.ErrPickCancelled
+	})
+	assert.Equal(t, "q", GetUserInput())
+}
+
 func TestGetUserInput_SeriesMenuMapping(t *testing.T) {
 	wantLabels := []string{"Next episode", "Previous episode", "Select episode", "Change anime", "← Back", "Quit"}
 	wantValues := []string{"n", "p", "e", "c", "back", "q"}
 
 	for i, wantValue := range wantValues {
 		var gotLabels []string
-		swapFindMenu(t, func(items []menuItem, itemFunc func(i int) string, _ ...fuzzyfinder.Option) (int, error) {
+		swapFindMenu(t, func(items []menuItem) (int, error) {
 			gotLabels = nil
-			for j := range items {
-				gotLabels = append(gotLabels, itemFunc(j))
+			for _, it := range items {
+				gotLabels = append(gotLabels, it.Label)
 			}
 			return i, nil
 		})
@@ -54,10 +69,10 @@ func TestGetUserInput_MovieMenuMapping(t *testing.T) {
 
 	for i, wantValue := range wantValues {
 		var gotLabels []string
-		swapFindMenu(t, func(items []menuItem, itemFunc func(i int) string, _ ...fuzzyfinder.Option) (int, error) {
+		swapFindMenu(t, func(items []menuItem) (int, error) {
 			gotLabels = nil
-			for j := range items {
-				gotLabels = append(gotLabels, itemFunc(j))
+			for _, it := range items {
+				gotLabels = append(gotLabels, it.Label)
 			}
 			return i, nil
 		})
@@ -66,3 +81,10 @@ func TestGetUserInput_MovieMenuMapping(t *testing.T) {
 		assert.Equal(t, wantValue, got, "label %q must map to %q", wantLabels[i], wantValue)
 	}
 }
+
+func TestGetUserInput_InvalidIndexQuits(t *testing.T) {
+	swapFindMenu(t, func(_ []menuItem) (int, error) {
+		return 99, nil
+	})
+	assert.Equal(t, "q", GetUserInput())
+}

internal/player/blogger_test.go

@@ -170,6 +170,12 @@ func TestFilterMPVArgs_DemuxerLavfOAllowed(t *testing.T) {
 			"otherwise the HLS audio fix never reaches mpv and video plays silent")
 }
 
+func TestFilterMPVArgs_ForcedHLSFormatAllowed(t *testing.T) {
+	filtered := filterMPVArgs([]string{hlsForceLavfFormatArg})
+	assert.Contains(t, filtered, hlsForceLavfFormatArg,
+		"the forced HLS format for SuperFlix master.txt MUST reach mpv")
+}
+
 func TestFilterMPVArgs_Whitelist(t *testing.T) {
 	tests := []struct {
 		name    string