@sansenjian/qq-music-api 2.2.1 → 2.2.9

package/dist/routers/context/getUserLikedSongs.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const module_1 = require("../../module");
+// 获取用户喜欢的歌曲列表
+exports.default = async (ctx, next) => {
+    const { uin, offset = 0, limit = 30 } = ctx.query;
+    if (!uin) {
+        ctx.status = 400;
+        ctx.body = {
+            error: '缺少 uin 参数'
+        };
+        return;
+    }
+    const { status, body } = await (0, module_1.getUserLikedSongs)({
+        uin: uin,
+        offset: Number(offset),
+        limit: Number(limit)
+    });
+    Object.assign(ctx, {
+        status,
+        body
+    });
+    await next();
+};

package/dist/routers/context/getUserPlaylists.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const module_1 = require("../../module");
+const cookieResolver_1 = require("../../util/cookieResolver");
+exports.default = async (ctx, next) => {
+    const { uin, offset = 0, limit = 30 } = ctx.query;
+    if (!uin) {
+        ctx.status = 400;
+        ctx.body = {
+            error: '缺少 uin 参数'
+        };
+        return;
+    }
+    const normalizedUin = Array.isArray(uin) ? uin[0] : uin;
+    const { cookie } = (0, cookieResolver_1.resolveRequestCookie)(ctx);
+    const { status, body } = await (0, module_1.getUserPlaylists)({
+        uin: String(normalizedUin),
+        offset: Number(offset),
+        limit: Number(limit),
+        cookie
+    });
+    Object.assign(ctx, {
+        status,
+        body
+    });
+    await next();
+};

package/dist/routers/context/index.js

@@ -0,0 +1,98 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+// Import refactored controllers
+const getDownloadQQMusic_1 = __importDefault(require("./getDownloadQQMusic"));
+const getHotkey_1 = __importDefault(require("./getHotkey"));
+const getSearchByKey_1 = __importDefault(require("./getSearchByKey"));
+const getSmartbox_1 = __importDefault(require("./getSmartbox"));
+const getSongListCategories_1 = __importDefault(require("./getSongListCategories"));
+const getSongLists_1 = __importDefault(require("./getSongLists"));
+const batchGetSongLists_1 = __importDefault(require("./batchGetSongLists"));
+const getSongInfo_1 = __importDefault(require("./getSongInfo"));
+const batchGetSongInfo_1 = __importDefault(require("./batchGetSongInfo"));
+const getSongListDetail_1 = __importDefault(require("./getSongListDetail"));
+const getNewDisks_1 = __importDefault(require("./getNewDisks"));
+const getMvByTag_1 = __importDefault(require("./getMvByTag"));
+const getMv_1 = __importDefault(require("./getMv"));
+const getSingerList_1 = __importDefault(require("./getSingerList"));
+const getSimilarSinger_1 = __importDefault(require("./getSimilarSinger"));
+const getSingerAlbum_1 = __importDefault(require("./getSingerAlbum"));
+const getSingerHotsong_1 = __importDefault(require("./getSingerHotsong"));
+const getSingerMv_1 = __importDefault(require("./getSingerMv"));
+const getSingerDesc_1 = __importDefault(require("./getSingerDesc"));
+const getSingerStarNum_1 = __importDefault(require("./getSingerStarNum"));
+const getRadioLists_1 = __importDefault(require("./getRadioLists"));
+const getDigitalAlbumLists_1 = __importDefault(require("./getDigitalAlbumLists"));
+const getLyric_1 = __importDefault(require("./getLyric"));
+const getMusicPlay_1 = __importDefault(require("./getMusicPlay"));
+const getAlbumInfo_1 = __importDefault(require("./getAlbumInfo"));
+const getComments_1 = __importDefault(require("./getComments"));
+const getRecommend_1 = __importDefault(require("./getRecommend"));
+const getMvPlay_1 = __importDefault(require("./getMvPlay"));
+const getTopLists_1 = __importDefault(require("./getTopLists"));
+const getRanks_1 = __importDefault(require("./getRanks"));
+const getTicketInfo_1 = __importDefault(require("./getTicketInfo"));
+const getImageUrl_1 = __importDefault(require("./getImageUrl"));
+const getQQLoginQr_1 = __importDefault(require("./getQQLoginQr"));
+const checkQQLoginQr_1 = __importDefault(require("./checkQQLoginQr"));
+const cookies_1 = __importDefault(require("./cookies"));
+const getUserPlaylists_1 = __importDefault(require("./getUserPlaylists"));
+const getUserAvatar_1 = __importDefault(require("./getUserAvatar"));
+const getUserLikedSongs_1 = __importDefault(require("./getUserLikedSongs"));
+const getDailyRecommend_1 = require("./getDailyRecommend");
+const getPersonalRecommend_1 = require("./getPersonalRecommend");
+const getPlaylistTags_1 = require("./getPlaylistTags");
+// Export all controllers with consistent naming
+exports.default = {
+    getCookie: cookies_1.default.get,
+    setCookie: cookies_1.default.set,
+    getDownloadQQMusic: getDownloadQQMusic_1.default,
+    getHotKey: getHotkey_1.default,
+    getSearchByKey: getSearchByKey_1.default,
+    getSmartbox: getSmartbox_1.default,
+    getSongListCategories: getSongListCategories_1.default,
+    getSongLists: getSongLists_1.default,
+    batchGetSongLists: batchGetSongLists_1.default,
+    getSongInfo: getSongInfo_1.default,
+    batchGetSongInfo: batchGetSongInfo_1.default,
+    getSongListDetail: getSongListDetail_1.default,
+    getNewDisks: getNewDisks_1.default,
+    getMvByTag: getMvByTag_1.default,
+    getMv: getMv_1.default,
+    getSingerList: getSingerList_1.default,
+    getSimilarSinger: getSimilarSinger_1.default,
+    getSingerAlbum: getSingerAlbum_1.default,
+    getSingerHotsong: getSingerHotsong_1.default,
+    getSingerMv: getSingerMv_1.default,
+    getSingerDesc: getSingerDesc_1.default,
+    getSingerStarNum: getSingerStarNum_1.default,
+    getRadioLists: getRadioLists_1.default,
+    getDigitalAlbumLists: getDigitalAlbumLists_1.default,
+    getLyric: getLyric_1.default,
+    getMusicPlay: getMusicPlay_1.default,
+    getAlbumInfo: getAlbumInfo_1.default,
+    getComments: getComments_1.default,
+    getRecommend: getRecommend_1.default,
+    getMvPlay: getMvPlay_1.default,
+    getTopLists: getTopLists_1.default,
+    getRanks: getRanks_1.default,
+    getTicketInfo: getTicketInfo_1.default,
+    getImageUrl: getImageUrl_1.default,
+    getQQLoginQr: getQQLoginQr_1.default,
+    checkQQLoginQr: checkQQLoginQr_1.default,
+    getUserPlaylists: getUserPlaylists_1.default,
+    getUserAvatar: getUserAvatar_1.default,
+    getUserLikedSongs: getUserLikedSongs_1.default,
+    getDailyRecommend: getDailyRecommend_1.getDailyRecommendController,
+    getPrivateFM: getDailyRecommend_1.getPrivateFMController,
+    getNewSongs: getDailyRecommend_1.getNewSongsController,
+    getPersonalRecommend: getPersonalRecommend_1.getPersonalRecommendController,
+    getSimilarSongs: getPersonalRecommend_1.getSimilarSongsController,
+    getPlaylistTags: getPlaylistTags_1.getPlaylistTagsController,
+    getPlaylistsByTag: getPlaylistTags_1.getPlaylistsByTagController,
+    getHotComments: getPlaylistTags_1.getHotCommentsController,
+    getSingerListByArea: getPlaylistTags_1.getSingerListByAreaController
+};

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,219 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createController = createController;
+exports.createPostController = createPostController;
+exports.validateRequired = validateRequired;
+exports.handleControllerResponse = handleControllerResponse;
+exports.createCustomController = createCustomController;
+exports.setApiResponse = setApiResponse;
+exports.withErrorHandler = withErrorHandler;
+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 };
+        }
+    };
+}
+/**
+ * 统一处理 API 响应并设置到 Koa 上下文
+ * @param ctx - Koa 上下文
+ * @param apiResponse - API 响应对象
+ */
+function setApiResponse(ctx, apiResponse) {
+    ctx.status = apiResponse.status || 500;
+    ctx.body = apiResponse.body;
+}
+/**
+ * 包装异步控制器，自动处理错误
+ * @param handler - 控制器处理函数
+ * @returns 包装后的控制器
+ */
+function withErrorHandler(handler) {
+    return async (ctx, next) => {
+        try {
+            await handler(ctx);
+            await next();
+        }
+        catch (error) {
+            console.error('Controller error:', error);
+            ctx.status = 502;
+            ctx.body = {
+                error: error.message || '服务器内部错误',
+            };
+        }
+    };
+}

package/dist/scripts/run-tests-with-flags.js

@@ -0,0 +1,139 @@
+"use strict";
+/**
+ * 运行测试并生成带 flags 的覆盖率报告
+ *
+ * 用法:
+ * - 运行所有测试：npm run test:flags
+ * - 只运行单元测试：npm run test:flags:unit
+ *
+ * 注意：此脚本通过 tsx 运行，不使用 ts-node
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+const child_process_1 = require("child_process");
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const ROOT_DIR = path.resolve(__dirname, '..');
+const COVERAGE_DIR = path.join(ROOT_DIR, 'coverage');
+// 确保覆盖率目录存在
+if (!fs.existsSync(COVERAGE_DIR)) {
+    fs.mkdirSync(COVERAGE_DIR, { recursive: true });
+}
+/**
+ * 运行命令
+ * 注意：command 参数必须是硬编码的命令字符串，不能包含用户输入
+ * @param command - 要执行的命令（必须是硬编码字符串）
+ * @param env - 环境变量
+ */
+function runCommand(command, env = {}) {
+    try {
+        // 使用 execSync 执行命令，命令必须是固定的字符串
+        // 安全说明：此函数只能用于执行硬编码的命令，不接受外部输入
+        // 所有调用此函数的地方都必须使用字符串字面量
+        (0, child_process_1.execSync)(command, {
+            stdio: 'inherit',
+            env: { ...process.env, ...env },
+            cwd: ROOT_DIR
+        });
+    }
+    catch (error) {
+        console.error(`命令执行失败：${command}`);
+        throw error;
+    }
+}
+/**
+ * 运行 Jest 测试（安全版本）
+ * 使用参数化方式执行 Jest，避免命令注入风险
+ * @param args - Jest 命令行参数数组
+ * @param env - 环境变量
+ */
+function runJest(args, env = {}) {
+    const command = `npx jest ${args.join(' ')}`;
+    return runCommand(command, env);
+}
+function runUnitTests() {
+    console.log('\n🧪 运行单元测试...\n');
+    // 运行单元测试 - 使用参数化方式
+    runJest(['--coverage', '--testPathPattern=tests/unit'], {
+        JEST_JUNIT_OUTPUT_NAME: 'unit-test-results.xml',
+        COVERAGE_FILE: 'coverage/unit-coverage.json'
+    });
+    // 移动覆盖率文件
+    const coverageFile = path.join(COVERAGE_DIR, 'coverage-final.json');
+    if (fs.existsSync(coverageFile)) {
+        const unitCoverageFile = path.join(COVERAGE_DIR, 'unit-coverage-final.json');
+        fs.copyFileSync(coverageFile, unitCoverageFile);
+        console.log(`✅ 单元测试覆盖率已保存到：${unitCoverageFile}`);
+    }
+}
+function runAllTests() {
+    console.log('\n🧪 运行所有测试...\n');
+    // 运行所有测试 - 使用参数化方式
+    runJest(['--coverage'], {
+        JEST_JUNIT_OUTPUT_NAME: 'test-results.xml',
+        COVERAGE_FILE: 'coverage/all-coverage.json'
+    });
+    // 移动覆盖率文件
+    const coverageFile = path.join(COVERAGE_DIR, 'coverage-final.json');
+    if (fs.existsSync(coverageFile)) {
+        const allCoverageFile = path.join(COVERAGE_DIR, 'all-coverage-final.json');
+        fs.copyFileSync(coverageFile, allCoverageFile);
+        console.log(`✅ 所有测试覆盖率已保存到：${allCoverageFile}`);
+    }
+}
+function main() {
+    const args = process.argv.slice(2);
+    const testType = args[0] || 'all';
+    console.log('🚀 开始运行测试...\n');
+    try {
+        if (testType === 'unit') {
+            runUnitTests();
+        }
+        else if (testType === 'all') {
+            runAllTests();
+        }
+        else {
+            console.error(`❌ 未知的测试类型：${testType}`);
+            console.error('可用选项：unit, all');
+            process.exit(1);
+        }
+        console.log('\n✅ 测试完成！\n');
+    }
+    catch (error) {
+        console.error('\n❌ 测试失败！\n');
+        process.exit(1);
+    }
+}
+main();

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,
+            },
+        };
+    }
+}