feat(media): add MiniMax music generation - #1242

#!/bin/bash
set -eu

file="src/lib/plugins/media-generators/minimax.ts"
if [ -f "$file" ]; then
  wc -l "$file"
  ast-grep outline "$file" --view compact || true
  sed -n '1,220p' "$file"
fi

printf '\n--- related symbols ---\n'
rg -n --glob '*.{ts,tsx}' 'assertSecureAudioUrl|parseMiniMaxMusicResponse|MiniMax music generation|audioFormat|outputFormat' src tests 2>/dev/null | head -200 || true

printf '\n--- candidate test files ---\n'
git ls-files | rg '(^|/)(test|tests|__tests__)/|minimax|media-generators' | head -200

#!/bin/bash
set -eu

rg -n --hidden --glob '!node_modules' --glob '!dist' --glob '!build' \
  'assertSecureAudioUrl|parseMiniMaxMusicResponse|MiniMax' . | head -250

#!/bin/bash
set -eu
sed -n '1,220p' src/lib/plugins/media-generators/minimax.ts
rg -n --hidden --glob '!node_modules' --glob '!dist' --glob '!build' \
  'function assertSecureAudioUrl|const assertSecureAudioUrl|assertSecureAudioUrl' .

#!/bin/bash
set -eu

sed -n '1,190p' src/__tests__/lib/plugins/media-generators/minimax.test.ts

node - <<'JS'
function assertSecureAudioUrl(audio) {
  let url;
  try {
    url = new URL(audio);
  } catch {
    throw new Error("invalid");
  }
  if (url.protocol !== "https:") throw new Error("insecure");
  return audio;
}

const audio = ["https://cdn.example/audio.mp3"];
const returned = assertSecureAudioUrl(audio);
console.log(JSON.stringify({
  inputType: typeof audio,
  coercedUrl: new URL(audio).href,
  returnedIsSameArray: returned === audio,
  returnedType: typeof returned,
  returnedValue: returned,
}));
JS

#!/bin/bash
set -eu

printf '%s\n' '--- minimax implementation ---'
sed -n '1,220p' src/lib/plugins/media-generators/minimax.ts

printf '%s\n' '--- environment documentation ---'
sed -n '55,85p' .env.example

printf '%s\n' '--- related request types and call sites ---'
rg -n -S 'GenerationRequest|MINIMAX_LYRICS|lyrics_optimizer|is_instrumental|MiniMax' src .env.example

#!/bin/bash
set -eu

printf '%s\n' '--- GenerationRequest definition ---'
sed -n '1,55p' src/lib/plugins/media-generators/types.ts

printf '%s\n' '--- MiniMax tests ---'
sed -n '1,115p' src/__tests__/lib/plugins/media-generators/minimax.test.ts

printf '%s\n' '--- all MiniMax environment references ---'
rg -n -S 'MINIMAX_' --glob '!src/lib/plugins/media-generators/minimax.ts' --glob '!*minimax.test.ts' .

#!/bin/bash
set -eu

python3 - <<'PY'
import json

def read_boolean(value):
    if value is None:
        return None
    if value == "true":
        return True
    if value == "false":
        return False
    return None

def build_payload(env):
    payload = {
        "model": "music-3.0",
        "prompt": "test prompt",
        "stream": False,
        "output_format": "url",
        "audio_setting": {"format": "mp3"},
    }
    lyrics = env.get("MINIMAX_LYRICS", "").strip()
    lyrics_optimizer = read_boolean(env.get("MINIMAX_LYRICS_OPTIMIZER"))
    is_instrumental = read_boolean(env.get("MINIMAX_IS_INSTRUMENTAL"))
    if lyrics:
        payload["lyrics"] = lyrics
    if lyrics_optimizer is not None:
        payload["lyrics_optimizer"] = lyrics_optimizer
    if is_instrumental is not None:
        payload["is_instrumental"] = is_instrumental
    return payload

cases = {
    "all variables unset": {},
    "documented example": {
        "MINIMAX_LYRICS": "",
        "MINIMAX_LYRICS_OPTIMIZER": "false",
        "MINIMAX_IS_INSTRUMENTAL": "true",
    },
    "automatic lyrics": {
        "MINIMAX_LYRICS_OPTIMIZER": "true",
        "MINIMAX_IS_INSTRUMENTAL": "false",
    },
    "explicit lyrics": {
        "MINIMAX_LYRICS": "[Verse] test",
        "MINIMAX_LYRICS_OPTIMIZER": "false",
        "MINIMAX_IS_INSTRUMENTAL": "false",
    },
}

for name, env in cases.items():
    print(name + ": " + json.dumps(build_payload(env), sort_keys=True))
PY

#!/bin/bash
set -eu
file="src/lib/plugins/media-generators/minimax.ts"
printf '%s\n' "== outline =="
ast-grep outline "$file" --lang typescript || true
printf '%s\n' "== relevant source =="
cat -n "$file" | sed -n '1,230p'
printf '%s\n' "== related symbols and config =="
rg -n --glob '*.ts' --glob '*.tsx' 'parseMiniMaxMusicResponse|MINIMAX_MUSIC_CONFIG|startGeneration|lyrics_optimizer|instrumental|MiniMax' src

#!/bin/bash
set -eu
printf '%s\n' '== media generation route =='
cat -n src/app/api/media-generate/route.ts | sed -n '80,135p'
printf '%s\n' '== fetch timeout patterns =='
rg -n --glob '*.ts' --glob '*.tsx' 'AbortController|AbortSignal|setTimeout\(|signal:' src
printf '%s\n' '== MiniMax tests =='
cat -n src/__tests__/lib/plugins/media-generators/minimax.test.ts | sed -n '1,180p'

#!/bin/bash
set -eu
python3 - <<'PY'
from pathlib import Path

plugin = Path("src/lib/plugins/media-generators/minimax.ts").read_text()
route = Path("src/app/api/media-generate/route.ts").read_text()

fetch_start = plugin.index("const response = await fetch(")
fetch_end = plugin.index("\n  });", fetch_start) + len("\n  });")
fetch_call = plugin[fetch_start:fetch_end]

assert "signal:" not in fetch_call
assert "AbortController" not in fetch_call
assert "setTimeout" not in fetch_call
assert "await plugin.startGeneration" in route
assert "await db.user.update" in route

print("MiniMax fetch options have no signal, AbortController, or timeout.")
print("The API route awaits startGeneration before the credit update and response.")
PY
printf '%s\n' '== route configuration =='
sed -n '1,82p' src/app/api/media-generate/route.ts