lyrics-search 0.4.0

use reqwest::Method;

use super::eapi;
use super::response::{
    EapiSearchResponse, LyricContent, LyricsResponse, SearchResponse, SyllableLyricsResponse,
};
use crate::error::SearchError;
use crate::providers::web::base_api;

const REFERER: &str = "https://music.163.com/";

/// 单曲搜索接口地址（web），对应 C# `Api.Search`。
const SEARCH_URL: &str = "http://music.163.com/api/search/get/web";

/// 单曲搜索接口地址（eapi），对应 C# `Api.SearchNew`。
const SEARCH_NEW_URL: &str = "https://interface.music.163.com/eapi/cloudsearch/pc";

/// 搜索单曲时使用的类型参数，对应 C# `Api.SearchTypeEnum.SONG_ID`。
const SEARCH_TYPE_SONG: &str = "1";

/// 逐字歌词接口地址，对应 C# `Api.GetLyricNew`。
const SYLLABLE_LYRICS_URL: &str = "https://interface3.music.163.com/eapi/song/lyric/v1";

fn standard_headers() -> Vec<(&'static str, &'static str)> {
    vec![
        ("Referer", REFERER),
        ("Cookie", base_api::COOKIE),
        ("User-Agent", base_api::USER_AGENT),
    ]
}

/// 使用 web 接口搜索单曲，对应 C# `Api.Search`。
///
/// 海外 IP 下该接口返回加密结果（`{"result":"<hex>","abroad":true}`），无法按正常结构解析，
/// 此时会得到 [`SearchError::Json`]；风控环境则返回 `-460`（见 [`crate::searchers::netease`]）。
pub(crate) async fn search(keyword: &str) -> Result<SearchResponse, SearchError> {
    let url = format!(
        "{SEARCH_URL}?csrf_token=hlpretag=&hlposttag=&s={}&type={SEARCH_TYPE_SONG}&offset=0&total=true&limit=20",
        urlencoding::encode(keyword)
    );
    let response = base_api::send(Method::GET, &url, &standard_headers()).await?;
    base_api::json(response).await
}

/// 使用 eapi 接口搜索单曲，对应 C# `Api.SearchNew`，供 web 接口不可用时兜底。
///
/// 返回体为 eapi 的搜索结果结构（字段名与 web 接口不同），此处转换为
/// [`SearchResponse`] 后交给调用方，调用方无需区分两个接口。
pub(crate) async fn search_new(keyword: &str) -> Result<SearchResponse, SearchError> {
    let response = eapi::post(
        SEARCH_NEW_URL,
        serde_json::json!({
            "s": keyword,
            "type": SEARCH_TYPE_SONG,
            "limit": "30",
            "offset": "0",
            "total": "true",
        }),
    )
    .await?;

    let response: EapiSearchResponse = serde_json::from_str(&response)?;
    Ok(response.into())
}

/// 获取网易云音乐歌词，返回 `(原文歌词, 翻译歌词)` 元组。
///
/// 该接口只返回逐行歌词；逐字歌词请使用 [`get_syllable_lyrics`]。
/// 请求成功但缺少某类歌词时对应元素为 `Ok(None)`；网络、状态码或响应格式失败返回 [`SearchError`]。
pub async fn get_lyrics(song_id: i64) -> Result<(Option<String>, Option<String>), SearchError> {
    let url = format!(
        "https://music.163.com/api/song/lyric?id={}&lv=1&kv=1&tv=-1",
        song_id
    );
    let response = base_api::send(Method::GET, &url, &standard_headers()).await?;
    let resp: LyricsResponse = base_api::json(response).await?;
    Ok((
        resp.lrc.and_then(|l| l.lyric),
        resp.tlyric.and_then(|t| t.lyric),
    ))
}

/// 网易云音乐逐字歌词，字段对应 eapi 接口返回体中各 `*.lyric` 字符串。
#[derive(Debug, Clone, Default)]
pub struct SyllableLyrics {
    /// 逐字歌词（YRC，含 JSON 信息行）
    pub yrc: Option<String>,
    /// 逐字翻译歌词（YRC）
    pub ytlrc: Option<String>,
    /// 逐字罗马音歌词（YRC）
    pub yromalrc: Option<String>,
}

/// 获取网易云音乐逐字歌词，对应 C# `Api.GetLyricNew`。
///
/// 逐字歌词为带 JSON 信息行的 YRC 格式，可直接交给
/// [`LyricsRawTypes::Yrc`](lyrics_core::models::LyricsRawTypes::Yrc) 解析。
/// 请求成功但该曲目没有逐字歌词时返回 `Ok(None)`，此时可回退到 [`get_lyrics`] 获取逐行歌词；
/// eapi 请求失败或响应无法按逐字歌词结构解析时返回 [`SearchError`]。
pub async fn get_syllable_lyrics(song_id: i64) -> Result<Option<SyllableLyrics>, SearchError> {
    let response = eapi::post(
        SYLLABLE_LYRICS_URL,
        serde_json::json!({
            "id": song_id.to_string(),
            "cp": "false",
            "lv": "0",
            "kv": "0",
            "tv": "0",
            "rv": "0",
            "yv": "0",
            "ytv": "0",
            "yrv": "0",
            "csrf_token": "",
        }),
    )
    .await?;

    let response: SyllableLyricsResponse = serde_json::from_str(&response)?;
    let lyrics = SyllableLyrics {
        yrc: lyric_text(response.yrc),
        ytlrc: lyric_text(response.ytlrc),
        yromalrc: lyric_text(response.yromalrc),
    };

    let has_syllable = lyrics.yrc.is_some() || lyrics.ytlrc.is_some() || lyrics.yromalrc.is_some();
    Ok(has_syllable.then_some(lyrics))
}

/// 取出歌词文本，接口会以空字符串表示没有该类歌词。
fn lyric_text(content: Option<LyricContent>) -> Option<String> {
    content
        .and_then(|content| content.lyric)
        .filter(|lyric| !lyric.is_empty())
}