@sansenjian/qq-music-api 2.2.1 → 2.2.7

package/dist/routers/router.js

@@ -0,0 +1,69 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const router_1 = __importDefault(require("@koa/router"));
+const context_1 = __importDefault(require("./context"));
+const router = new router_1.default();
+router.get('/user/getCookie', context_1.default.getCookie);
+router.get('/user/setCookie', context_1.default.setCookie);
+router.get('/user/getUserPlaylists', context_1.default.getUserPlaylists);
+router.get('/user/getUserAvatar', context_1.default.getUserAvatar);
+router.get('/user/getUserLikedSongs', context_1.default.getUserLikedSongs);
+router.get('/downloadQQMusic', context_1.default.getDownloadQQMusic);
+router.get('/getHotkey', context_1.default.getHotKey);
+router.get('/getSearchByKey/:key', context_1.default.getSearchByKey);
+router.get('/getSearchByKey', context_1.default.getSearchByKey);
+router.get('/getSmartbox/:key', context_1.default.getSmartbox);
+router.get('/getSmartbox', context_1.default.getSmartbox);
+router.get('/getSongListCategories', context_1.default.getSongListCategories);
+router.get('/getSongLists/:page/:limit/:categoryId/:sortId', context_1.default.getSongLists);
+router.get('/getSongLists', context_1.default.getSongLists);
+router.post('/batchGetSongLists', context_1.default.batchGetSongLists);
+router.get('/getSongInfo/:songmid', context_1.default.getSongInfo);
+router.get('/getSongInfo', context_1.default.getSongInfo);
+router.post('/batchGetSongInfo', context_1.default.batchGetSongInfo);
+router.get('/getSongListDetail/:disstid', context_1.default.getSongListDetail);
+router.get('/getSongListDetail', context_1.default.getSongListDetail);
+router.get('/getNewDisks', context_1.default.getNewDisks);
+router.get('/getMvByTag', context_1.default.getMvByTag);
+router.get('/getMv', context_1.default.getMv);
+router.get('/getSingerList', context_1.default.getSingerList);
+router.get('/getSimilarSinger', context_1.default.getSimilarSinger);
+router.get('/getSingerAlbum', context_1.default.getSingerAlbum);
+router.get('/getSingerHotsong', context_1.default.getSingerHotsong);
+router.get('/getSingerMv', context_1.default.getSingerMv);
+router.get('/getSingerDesc', context_1.default.getSingerDesc);
+router.get('/getSingerStarNum', context_1.default.getSingerStarNum);
+router.get('/getRadioLists', context_1.default.getRadioLists);
+router.get('/getDigitalAlbumLists', context_1.default.getDigitalAlbumLists);
+router.get('/getLyric/:songmid', context_1.default.getLyric);
+router.get('/getLyric', context_1.default.getLyric);
+router.get('/getMusicPlay/:songmid', context_1.default.getMusicPlay);
+router.get('/getMusicPlay', context_1.default.getMusicPlay);
+router.get('/getAlbumInfo/:albummid', context_1.default.getAlbumInfo);
+router.get('/getAlbumInfo', context_1.default.getAlbumInfo);
+router.get('/getComments', context_1.default.getComments);
+router.get('/getRecommend', context_1.default.getRecommend);
+router.get('/getMvPlay', context_1.default.getMvPlay);
+router.get('/getTopLists', context_1.default.getTopLists);
+router.get('/getRanks', context_1.default.getRanks);
+router.get('/getTicketInfo', context_1.default.getTicketInfo);
+router.get('/getImageUrl', context_1.default.getImageUrl);
+router.get('/getQQLoginQr', context_1.default.getQQLoginQr);
+router.get('/user/getQQLoginQr', context_1.default.getQQLoginQr);
+router.post('/checkQQLoginQr', context_1.default.checkQQLoginQr);
+router.post('/user/checkQQLoginQr', context_1.default.checkQQLoginQr);
+// 推荐相关
+router.get('/getDailyRecommend', context_1.default.getDailyRecommend);
+router.get('/getPrivateFM', context_1.default.getPrivateFM);
+router.get('/getNewSongs', context_1.default.getNewSongs);
+router.get('/getPersonalRecommend', context_1.default.getPersonalRecommend);
+router.get('/getSimilarSongs', context_1.default.getSimilarSongs);
+// 扩展功能
+router.get('/getPlaylistTags', context_1.default.getPlaylistTags);
+router.get('/getPlaylistsByTag', context_1.default.getPlaylistsByTag);
+router.get('/getHotComments', context_1.default.getHotComments);
+router.get('/getSingerListByArea', context_1.default.getSingerListByArea);
+exports.default = router;

package/dist/routers/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/routers/util.js

@@ -0,0 +1,188 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createController = createController;
+exports.createPostController = createPostController;
+exports.validateRequired = validateRequired;
+exports.handleControllerResponse = handleControllerResponse;
+exports.createCustomController = createCustomController;
+const INTERNAL_ERROR_MESSAGE = '服务器内部错误';
+const normalizeErrorMessage = (error) => {
+    if (error instanceof Error && error.message) {
+        return error.message;
+    }
+    return INTERNAL_ERROR_MESSAGE;
+};
+const setInternalErrorResponse = (ctx, error) => {
+    console.error('Controller error:', error);
+    ctx.status = 500;
+    ctx.body = {
+        error: INTERNAL_ERROR_MESSAGE,
+    };
+};
+const isMissingRequiredValue = (value) => {
+    if (value === undefined || value === null) {
+        return true;
+    }
+    if (typeof value === 'string') {
+        return value.trim() === '';
+    }
+    return false;
+};
+/**
+ * 创建 Controller 的工厂函数
+ * @param apiFunction API 函数
+ * @param options 配置选项
+ * @example
+ * export default createController(
+ *   require('../../module').getSingerDesc,
+ *   {
+ *     validator: (params) => {
+ *       if (!params.singermid) {
+ *         return { valid: false, error: '缺少 singermid 参数' };
+ *       }
+ *       return { valid: true };
+ *     },
+ *     errorMessage: 'no singermid'
+ *   }
+ * );
+ */
+function createController(apiFunction, options) {
+    return async (ctx, next) => {
+        try {
+            // 从 query 和 params 中提取参数
+            const params = {
+                ...ctx.query,
+                ...ctx.params,
+            };
+            // 验证参数
+            if (options?.validator) {
+                const validation = options.validator(params);
+                if (!validation.valid) {
+                    ctx.status = 400;
+                    ctx.body = {
+                        response: validation.error || options.errorMessage || 'Invalid parameters',
+                    };
+                    return;
+                }
+            }
+            // 构建 API 调用参数
+            const apiProps = {
+                method: 'get',
+                params,
+                option: {},
+            };
+            // 调用 API
+            const { status, body } = await apiFunction(apiProps);
+            // 设置响应
+            Object.assign(ctx, { status, body });
+        }
+        catch (error) {
+            if (options?.onError) {
+                options.onError(ctx, error);
+            }
+            else {
+                setInternalErrorResponse(ctx, error);
+            }
+        }
+    };
+}
+/**
+ * 创建需要 POST 数据的 Controller
+ * @param apiFunction API 函数
+ * @param options 配置选项
+ */
+function createPostController(apiFunction, options) {
+    return async (ctx, next) => {
+        try {
+            // 从 request.body 中提取参数
+            const params = ctx.request.body || {};
+            // 验证参数
+            if (options?.validator) {
+                const validation = options.validator(params);
+                if (!validation.valid) {
+                    ctx.status = 400;
+                    ctx.body = {
+                        response: validation.error || options.errorMessage || 'Invalid parameters',
+                    };
+                    return;
+                }
+            }
+            // 构建 API 调用参数
+            const apiProps = {
+                method: 'post',
+                params,
+                option: {},
+            };
+            // 调用 API
+            const { status, body } = await apiFunction(apiProps);
+            // 设置响应
+            Object.assign(ctx, { status, body });
+        }
+        catch (error) {
+            if (options?.onError) {
+                options.onError(ctx, error);
+            }
+            else {
+                setInternalErrorResponse(ctx, error);
+            }
+        }
+    };
+}
+/**
+ * 简单的参数验证器
+ * @param requiredFields 必需的字段列表
+ * @example
+ * validator: validateRequired(['singermid', 'songmid'])
+ */
+function validateRequired(fields) {
+    return (params) => {
+        const missingFields = fields.filter(field => isMissingRequiredValue(params[field]));
+        if (missingFields.length > 0) {
+            return {
+                valid: false,
+                error: `缺少必需参数：${missingFields.join(', ')}`,
+            };
+        }
+        return { valid: true };
+    };
+}
+/**
+ * 处理 Controller 响应
+ * @param ctx Koa Context
+ * @param apiCall API 调用函数
+ */
+async function handleControllerResponse(ctx, apiCall) {
+    try {
+        const { status, body } = await apiCall();
+        Object.assign(ctx, { status, body });
+    }
+    catch (error) {
+        console.error('Controller response error:', normalizeErrorMessage(error));
+        ctx.status = 500;
+        ctx.body = { error: INTERNAL_ERROR_MESSAGE };
+    }
+}
+/**
+ * 创建带自定义参数处理的 Controller
+ * @param handler 自定义处理函数
+ * @param apiFunction API 函数
+ */
+function createCustomController(handler, apiFunction) {
+    return async (ctx, next) => {
+        try {
+            const customParams = handler(ctx);
+            const apiProps = {
+                method: 'get',
+                option: {},
+                ...customParams,
+            };
+            const { status, body } = await apiFunction(apiProps);
+            Object.assign(ctx, { status, body });
+        }
+        catch (error) {
+            console.error('Custom controller error:', normalizeErrorMessage(error));
+            ctx.status = 500;
+            ctx.body = { error: INTERNAL_ERROR_MESSAGE };
+        }
+    };
+}

package/dist/types/api.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSuccessResponse = createSuccessResponse;
+exports.createErrorResponse = createErrorResponse;
+exports.handleApi = handleApi;
+/**
+ * 成功响应创建器
+ */
+function createSuccessResponse(data, status = 200) {
+    return {
+        status,
+        body: {
+            response: data,
+        },
+    };
+}
+/**
+ * 错误响应创建器
+ */
+function createErrorResponse(error, status = 500) {
+    return {
+        status,
+        body: {
+            error,
+        },
+    };
+}
+/**
+ * API Promise 处理器 - 自动处理成功和错误情况
+ */
+async function handleApi(promise, options) {
+    try {
+        const result = await promise;
+        const responseData = options?.transformData
+            ? options.transformData(result.data || result)
+            : result.data || result;
+        return {
+            status: options?.customStatus || 200,
+            body: {
+                response: responseData,
+            },
+        };
+    }
+    catch (error) {
+        if (options?.logError !== false) {
+            console.log('API error:', error);
+        }
+        return {
+            status: options?.customStatus || 500,
+            body: {
+                error,
+            },
+        };
+    }
+}

package/dist/util/apiResponse.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.successResponse = successResponse;
+exports.errorResponse = errorResponse;
+exports.handleApi = handleApi;
+exports.customResponse = customResponse;
+exports.badRequest = badRequest;
+/**
+ * 创建成功的 API 响应
+ * @param data 响应数据
+ * @param status HTTP 状态码，默认 200
+ */
+function successResponse(data, status = 200) {
+    return {
+        status,
+        body: {
+            response: data,
+        },
+    };
+}
+/**
+ * 创建错误的 API 响应
+ * @param error 错误信息
+ * @param status HTTP 状态码，默认 500
+ */
+function errorResponse(error, status = 500) {
+    return {
+        status,
+        body: {
+            error,
+        },
+    };
+}
+/**
+ * 处理 API Promise，自动包装成功和错误响应
+ * @param promise API 请求 Promise
+ * @param options 可选配置
+ */
+async function handleApi(promise, options) {
+    try {
+        const result = await promise;
+        const resultAny = result;
+        const responseData = options?.transformData
+            ? options.transformData(resultAny.data || result)
+            : resultAny.data || result;
+        return {
+            status: options?.customStatus || 200,
+            body: {
+                response: responseData,
+            },
+        };
+    }
+    catch (error) {
+        // 只在非测试环境下记录错误日志
+        if (options?.logError !== false && process.env.NODE_ENV !== 'test') {
+            console.log('API error:', error);
+        }
+        return {
+            status: options?.customStatus || 500,
+            body: {
+                error,
+            },
+        };
+    }
+}
+/**
+ * 创建自定义结构的响应
+ * @param body 响应体
+ * @param status HTTP 状态码
+ */
+function customResponse(body, status = 200) {
+    return {
+        status,
+        body,
+    };
+}
+/**
+ * 处理 400 错误响应（参数错误）
+ * @param message 错误消息
+ */
+function badRequest(message) {
+    return {
+        status: 400,
+        body: {
+            response: message,
+        },
+    };
+}

package/dist/util/colors.js

@@ -0,0 +1,19 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const chalk_1 = __importDefault(require("chalk"));
+const colors = {
+    silly: (text) => chalk_1.default.hex('#ff69b4')(text),
+    input: (text) => chalk_1.default.grey(text),
+    verbose: (text) => chalk_1.default.cyan(text),
+    prompt: (text) => chalk_1.default.white(text),
+    info: (text) => chalk_1.default.green(text),
+    data: (text) => chalk_1.default.grey(text),
+    help: (text) => chalk_1.default.cyan(text),
+    warn: (text) => chalk_1.default.yellow(text),
+    debug: (text) => chalk_1.default.blue(text),
+    error: (text) => chalk_1.default.red(text)
+};
+exports.default = colors;

package/dist/util/cookie.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const SAFE_COOKIE_NAMES = new Set(['qqmusic_key', 'qqmusic_uin']);
+const cookieMiddleware = () => async (ctx, next) => {
+    if (global.userInfo?.cookie) {
+        // Extend Request interface if needed, or just cast
+        ctx.request.cookie = global.userInfo.cookie;
+    }
+    if (Array.isArray(global.userInfo?.cookieList)) {
+        global.userInfo.cookieList.forEach((cookie) => {
+            const [key, ...valueParts] = cookie.split('=');
+            const normalizedKey = key?.trim();
+            const value = valueParts.join('=').trim();
+            if (normalizedKey && value && SAFE_COOKIE_NAMES.has(normalizedKey)) {
+                ctx.cookies.set(normalizedKey, value, {
+                    // 仅同步前端业务必需且可公开的 Cookie，避免敏感登录态透传
+                    overwrite: true,
+                    httpOnly: false,
+                    sameSite: 'lax'
+                });
+            }
+        });
+    }
+    await next();
+};
+exports.default = cookieMiddleware;

package/dist/util/loginUtils.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getGuid = exports.getGtk = exports.hash33 = void 0;
+const hash33 = (t) => {
+    let e = 0;
+    for (let n = 0, o = t.length; n < o; ++n) {
+        e += (e << 5) + t.charCodeAt(n);
+    }
+    return 2147483647 & e;
+};
+exports.hash33 = hash33;
+const getGtk = (p_skey) => {
+    const str = p_skey;
+    let hash = 5381;
+    for (let i = 0, len = str.length; i < len; ++i) {
+        hash += (hash << 5) + str.charCodeAt(i);
+    }
+    return hash & 0x7fffffff;
+};
+exports.getGtk = getGtk;
+const getGuid = () => {
+    return 'xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx'
+        .replace(/[xy]/g, function (c) {
+        const r = (Math.random() * 16) | 0;
+        const v = c === 'x' ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    })
+        .toUpperCase();
+};
+exports.getGuid = getGuid;

package/dist/util/lyricParse.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Lyric = void 0;
+exports.lyricParse = lyricParse;
+// [01:27.96]
+const timeExp = /\[(\d{2,}):(\d{2})(?:\.(\d{2,3}))?]/g;
+const TAGREGMAP = {
+    title: 'ti',
+    artist: 'ar',
+    album: 'al',
+    offset: 'offset',
+    by: 'by'
+};
+class Lyric {
+    constructor(lyric) {
+        this.lyric = lyric;
+        this.tags = {};
+        this.lines = [];
+        this._init();
+    }
+    _init() {
+        this._initTag();
+        this._initLines();
+    }
+    _initTag() {
+        for (const tag in TAGREGMAP) {
+            const matches = this.lyric.match(new RegExp(`\\[${TAGREGMAP[tag]}:([^\\]]*)]`, 'i'));
+            this.tags[tag] = (matches && matches[1]) || '';
+        }
+    }
+    _initLines() {
+        const lines = this.lyric.split('\n');
+        for (let i = 0; i < lines.length; i++) {
+            const line = lines[i].trim();
+            timeExp.lastIndex = 0;
+            const matches = [...line.matchAll(timeExp)];
+            if (matches.length > 0) {
+                const txt = line.replace(timeExp, '').trim();
+                if (txt) {
+                    for (const result of matches) {
+                        // RegExpMatchArray elements are strings, so we need to parse them
+                        const minutes = parseInt(result[1], 10);
+                        const seconds = parseInt(result[2], 10);
+                        const milliseconds = result[3] ? parseInt(result[3], 10) : 0;
+                        // If milliseconds is 2 digits (e.g. .96), it usually means 960ms or 96cs?
+                        // Standard LRC is usually centiseconds (cs), so .96 is 960ms.
+                        // If 3 digits, it's ms.
+                        // The original code was `(result[3] || 0) * 10`. 
+                        // If result[3] is '96', parseInt is 96. 96 * 10 = 960. Correct.
+                        // If result[3] is '123', parseInt is 123. 123 * 10 = 1230. Incorrect if it was already ms.
+                        // But regex `\d{2,3}` captures 2 or 3 digits.
+                        // If 3 digits, usually it is milliseconds. If 2 digits, it is centiseconds.
+                        // The logic `* 10` implies it assumes 2 digits (centiseconds) mostly.
+                        // Let's keep the original logic for compatibility.
+                        const time = minutes * 60 * 1000 + seconds * 1000 + milliseconds * 10;
+                        this.lines.push({
+                            time,
+                            txt
+                        });
+                    }
+                }
+            }
+        }
+        this.lines.sort((a, b) => {
+            return a.time - b.time;
+        });
+    }
+}
+exports.Lyric = Lyric;
+function lyricParse(lyricString) {
+    return new Lyric(lyricString);
+}

package/dist/util/request.js

@@ -0,0 +1,109 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+const axios_1 = __importDefault(require("axios"));
+const http_1 = __importDefault(require("http"));
+const https_1 = __importDefault(require("https"));
+const colors_1 = __importDefault(require("./colors"));
+// Create dedicated instance
+const service = axios_1.default.create({
+    withCredentials: true,
+    timeout: 15000,
+    responseType: 'json',
+    // Enable keep-alive for better performance
+    httpAgent: new http_1.default.Agent({ keepAlive: true }),
+    httpsAgent: new https_1.default.Agent({ keepAlive: true })
+});
+const ensureContentType = (config) => {
+    const method = (config.method || 'get').toLowerCase();
+    const hasBody = config.data !== undefined && config.data !== null;
+    const headers = config.headers || {};
+    const hasContentType = Boolean(headers['Content-Type'] || headers['content-type']);
+    if (hasBody && !hasContentType && ['post', 'put', 'patch', 'delete'].includes(method)) {
+        headers['Content-Type'] = 'application/x-www-form-urlencoded; charset=UTF-8';
+    }
+    config.headers = headers;
+};
+// Request interceptor to ensure headers
+service.interceptors.request.use(config => {
+    // Ensure User-Agent
+    if (config.headers && !config.headers['User-Agent']) {
+        config.headers['User-Agent'] =
+            'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/120.0.0.0 Safari/537.36';
+    }
+    ensureContentType(config);
+    return config;
+}, error => {
+    return Promise.reject(error);
+});
+// Response interceptor
+service.interceptors.response.use(response => {
+    if (!response) {
+        throw Error('response is null');
+    }
+    if (process.env.DEBUG === 'true') {
+        console.log(colors_1.default.info(`${response.config.url} request success`));
+    }
+    return response;
+}, error => {
+    const url = error.config ? error.config.url : 'Unknown URL';
+    console.log(colors_1.default.error(`${url} request error: ${error.message}`));
+    return Promise.reject(error);
+});
+const yURL = 'https://y.qq.com';
+const cURL = 'https://c.y.qq.com';
+function request(configOrUrl, method, options, isUUrl = 'c') {
+    let url;
+    let reqMethod;
+    let reqOptions;
+    let reqIsUUrl;
+    if (typeof configOrUrl === 'object') {
+        url = configOrUrl.url || '';
+        reqMethod = configOrUrl.method || 'GET';
+        reqOptions = configOrUrl.options;
+        reqIsUUrl = configOrUrl.isUUrl || 'c';
+    }
+    else {
+        url = configOrUrl;
+        reqMethod = method || 'GET';
+        reqOptions = options;
+        reqIsUUrl = isUUrl;
+    }
+    let baseURL = '';
+    switch (reqIsUUrl) {
+        case 'y':
+            baseURL = yURL + url;
+            break;
+        case 'u':
+            baseURL = url;
+            break;
+        case 'c':
+            baseURL = cURL + url;
+            break;
+        default:
+            baseURL = cURL + url;
+            break;
+    }
+    const config = {
+        ...(reqOptions || {}),
+        url: baseURL,
+        method: reqMethod.toLowerCase()
+    };
+    const headers = config.headers || {};
+    if (headers.cookies) {
+        if (!headers.Cookie) {
+            headers.Cookie = headers.cookies;
+        }
+        delete headers.cookies;
+    }
+    if (!headers.Cookie && !headers.cookie) {
+        if (global.userInfo && global.userInfo.cookie) {
+            headers.Cookie = global.userInfo.cookie;
+        }
+    }
+    config.headers = headers;
+    return service(config);
+}
+exports.default = request;