nuxt-gin-tools 0.2.11 → 0.2.13

package/commands/develop.js

@@ -0,0 +1,106 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.develop = develop;
+exports.developNuxt = developNuxt;
+exports.developGo = developGo;
+const concurrently_1 = __importDefault(require("concurrently"));
+const fs_extra_1 = require("fs-extra");
+const path_1 = require("path");
+const cleanup_1 = __importDefault(require("./cleanup"));
+const postinstall_1 = __importDefault(require("./postinstall"));
+const dev_go_1 = require("./dev-go");
+const utils_1 = require("../src/utils");
+const cwd = process.cwd();
+const serverConfig = (0, fs_extra_1.readJSONSync)((0, path_1.join)(cwd, "server.config.json"));
+function prepareDevelop() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const cleanupBeforeDevelop = serverConfig.cleanupBeforeDevelop === true;
+        if (cleanupBeforeDevelop) {
+            yield (0, cleanup_1.default)();
+            yield (0, postinstall_1.default)();
+            return;
+        }
+        if (!(0, fs_extra_1.existsSync)((0, path_1.join)(cwd, "vue/.nuxt")) || !(0, fs_extra_1.existsSync)((0, path_1.join)(cwd, "go.sum"))) {
+            yield (0, cleanup_1.default)();
+            yield (0, postinstall_1.default)();
+        }
+    });
+}
+function runNuxtDev() {
+    return __awaiter(this, void 0, void 0, function* () {
+        yield (0, concurrently_1.default)([
+            {
+                command: `npx nuxt dev --port=${serverConfig.nuxtPort} --host`,
+                name: "nuxt",
+                prefixColor: "blue",
+            },
+        ]).result;
+    });
+}
+function runGoDev() {
+    return __awaiter(this, void 0, void 0, function* () {
+        (0, fs_extra_1.ensureDirSync)((0, path_1.join)(cwd, ".build/.server"));
+        yield (0, dev_go_1.startGoDev)();
+    });
+}
+/**
+ * 启动本地开发环境。
+ *
+ * 行为包括：按配置执行预清理、释放开发端口、并行启动 Nuxt 与 Go 监听流程。
+ *
+ * @returns {Promise<void>} 仅在开发进程退出或出现异常时返回。
+ */
+function develop() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const killPortBeforeDevelop = serverConfig.killPortBeforeDevelop !== false;
+        yield prepareDevelop();
+        // 在开发前确保占用端口被释放
+        if (killPortBeforeDevelop) {
+            (0, utils_1.killPorts)([serverConfig.ginPort, serverConfig.nuxtPort]);
+        }
+        yield Promise.all([runGoDev(), runNuxtDev()]);
+    });
+}
+/**
+ * 仅启动 Nuxt 开发服务（带 nuxt 标签输出）。
+ *
+ * @returns {Promise<void>} 仅在开发进程退出或出现异常时返回。
+ */
+function developNuxt() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const killPortBeforeDevelop = serverConfig.killPortBeforeDevelop !== false;
+        yield prepareDevelop();
+        if (killPortBeforeDevelop) {
+            (0, utils_1.killPorts)([serverConfig.nuxtPort]);
+        }
+        yield runNuxtDev();
+    });
+}
+/**
+ * 仅启动 Go 开发监听流程。
+ *
+ * @returns {Promise<void>} 仅在开发进程退出或出现异常时返回。
+ */
+function developGo() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const killPortBeforeDevelop = serverConfig.killPortBeforeDevelop !== false;
+        yield prepareDevelop();
+        if (killPortBeforeDevelop) {
+            (0, utils_1.killPorts)([serverConfig.ginPort]);
+        }
+        yield runGoDev();
+    });
+}
+exports.default = develop;

package/commands/pack.d.ts

@@ -0,0 +1,82 @@
+export interface PackConfig {
+    /**
+     * 额外需要打包的文件映射
+     * key: 源文件路径（相对于项目根目录或绝对路径）
+     * value: 打包后对应位置（相对于服务器构建目录或绝对路径）
+     */
+    extraFiles?: Record<string, string>;
+    /**
+     * 额外需要打包的文件 Glob（相对于项目根目录）
+     */
+    extraFilesGlobs?: string[];
+    /**
+     * 排除文件/目录 Glob（相对于项目根目录）
+     */
+    exclude?: string[];
+    /**
+     * 打包输出 zip 名称（相对于默认 zip 目录）
+     */
+    zipName?: string;
+    /**
+     * 打包输出 zip 路径（相对于项目根目录或绝对路径）
+     */
+    zipPath?: string;
+    /**
+     * 服务器构建输出目录（相对于项目根目录或绝对路径）
+     */
+    serverPath?: string;
+    /**
+     * 打包前钩子
+     */
+    beforePack?: () => Promise<void> | void;
+    /**
+     * 打包后钩子
+     */
+    afterPack?: (zipPath: string) => Promise<void> | void;
+    /**
+     * 是否清理 dist
+     */
+    cleanDist?: boolean;
+    /**
+     * 是否写入启动脚本和 package.json
+     */
+    writeScripts?: boolean;
+    /**
+     * 写入/覆盖 package.json 内容
+     */
+    packageJson?: Record<string, unknown>;
+    /**
+     * 复制时是否覆盖同名文件
+     */
+    overwrite?: boolean;
+}
+/**
+ * 生成相对于服务器构建目录的绝对路径
+ * @param relativePath - 相对路径
+ * @returns 解析后的绝对路径
+ */
+export declare function builtPath(relativePath: string): string;
+export declare const ZIP_PATH: string;
+export declare const SERVER_PATH: string;
+export declare const ORIGINAL_DIST_PATH: string;
+export declare const PACK_CONFIG_PATH: string;
+export declare const SERVER_EXECUTABLE: string;
+export declare const PACKAGE_JSON_CONTENT: {
+    private: boolean;
+    scripts: {
+        start: string;
+    };
+};
+export declare const FILES_TO_COPY: {
+    [k: string]: string;
+};
+/**
+ * 构建并打包项目的主函数
+ * 1. 执行项目构建
+ * 2. 复制生成的文件
+ * 3. 写入启动脚本
+ * 4. 打包文件为 7z 格式
+ * 5. 清理原始 dist 目录
+ */
+export declare function buildAndPack(config?: PackConfig): Promise<void>;
+export default buildAndPack;

package/commands/pack.js

@@ -0,0 +1,230 @@
+"use strict";
+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;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FILES_TO_COPY = exports.PACKAGE_JSON_CONTENT = exports.SERVER_EXECUTABLE = exports.PACK_CONFIG_PATH = exports.ORIGINAL_DIST_PATH = exports.SERVER_PATH = exports.ZIP_PATH = void 0;
+exports.builtPath = builtPath;
+exports.buildAndPack = buildAndPack;
+// 导入项目构建工具，用于执行 Nuxt 项目的构建流程
+const builder_1 = __importDefault(require("./builder"));
+// 导入 7zip 压缩工具库，用于将构建后的文件打包为 7z 格式
+const Zip = __importStar(require("7zip-min"));
+// 导入增强版的文件系统模块，提供更丰富的文件操作 API
+const FS = __importStar(require("fs-extra"));
+// 导入路径处理模块，用于规范化和解析文件路径
+const Path = __importStar(require("path"));
+const os = __importStar(require("os"));
+const fast_glob_1 = __importDefault(require("fast-glob"));
+/**
+ * 生成相对于服务器构建目录的绝对路径
+ * @param relativePath - 相对路径
+ * @returns 解析后的绝对路径
+ */
+function builtPath(relativePath) {
+    return Path.resolve(exports.SERVER_PATH, relativePath);
+}
+// 定义打包后的 7z 文件输出路径
+exports.ZIP_PATH = Path.resolve(process.cwd(), ".build/production/server.7z");
+// 定义服务器构建文件的输出目录
+exports.SERVER_PATH = Path.resolve(process.cwd(), ".build/production/server");
+// 定义原始 dist 目录路径，用于清理操作
+exports.ORIGINAL_DIST_PATH = Path.resolve(process.cwd(), "dist");
+exports.PACK_CONFIG_PATH = Path.resolve(process.cwd(), "pack.config.json");
+exports.SERVER_EXECUTABLE = os.platform() === "win32" ? "server-production.exe" : "server-production"; // 根据操作系统选择可执行文件名
+// 定义打包后项目的 package.json 内容
+exports.PACKAGE_JSON_CONTENT = {
+    private: true,
+    scripts: {
+        start: "./server-production.exe", // 定义启动命令
+    },
+};
+// 定义需要复制到构建目录的文件映射关系（目标为构建目录下的相对路径）
+const DEFAULT_FILES_TO_COPY = {
+    "vue/.output": "vue/.output", // Vue 应用构建输出
+    [`.build/.server/production.exe`]: "server-production.exe", // 生产环境可执行文件
+    "server.config.json": "server.config.json", // 服务器配置文件
+};
+// 兼容旧导出：默认构建目录下的绝对目标路径
+exports.FILES_TO_COPY = Object.fromEntries(Object.entries(DEFAULT_FILES_TO_COPY).map(([src, dest]) => [src, builtPath(dest)]));
+/**
+ * 写入启动脚本和 package.json 文件到构建目录
+ */
+function writeScriptFiles(serverPath, config) {
+    // 写入 Windows 批处理启动脚本
+    FS.outputFileSync(Path.resolve(serverPath, "start.bat"), `powershell -ExecutionPolicy ByPass -File ./start.ps1`);
+    // 写入 PowerShell 启动脚本
+    FS.outputFileSync(Path.resolve(serverPath, "start.ps1"), `./server-production.exe`);
+    // 写入 Linux/macOS 启动脚本
+    FS.outputFileSync(Path.resolve(serverPath, "start.sh"), `./server-production.exe`);
+    // 写入 package.json 文件，使用 2 个空格缩进
+    const mergedPackageJson = mergePackageJson(exports.PACKAGE_JSON_CONTENT, config === null || config === void 0 ? void 0 : config.packageJson);
+    FS.outputJSONSync(Path.resolve(serverPath, "package.json"), mergedPackageJson, { spaces: 2 });
+}
+/**
+ * 将配置的源文件复制到构建目录
+ */
+function copyGeneratedFiles(serverPath, config) {
+    var _a;
+    const copyOptions = {
+        overwrite: (config === null || config === void 0 ? void 0 : config.overwrite) !== false,
+        errorOnExist: (config === null || config === void 0 ? void 0 : config.overwrite) === false,
+    };
+    // 遍历文件映射，将每个源文件复制到目标位置
+    for (const [src, dest] of Object.entries(DEFAULT_FILES_TO_COPY)) {
+        const resolvedDest = Path.resolve(serverPath, dest);
+        FS.copySync(Path.resolve(process.cwd(), src), resolvedDest, copyOptions);
+    }
+    if (config === null || config === void 0 ? void 0 : config.extraFiles) {
+        for (const [src, dest] of Object.entries(config.extraFiles)) {
+            const resolvedSrc = Path.resolve(process.cwd(), src);
+            const resolvedDest = Path.isAbsolute(dest) ? dest : Path.resolve(serverPath, dest);
+            FS.copySync(resolvedSrc, resolvedDest, copyOptions);
+        }
+    }
+    if ((_a = config === null || config === void 0 ? void 0 : config.extraFilesGlobs) === null || _a === void 0 ? void 0 : _a.length) {
+        const matchedFiles = fast_glob_1.default.sync(config.extraFilesGlobs, {
+            cwd: process.cwd(),
+            onlyFiles: true,
+            dot: true,
+            ignore: config.exclude,
+        });
+        for (const file of matchedFiles) {
+            const resolvedSrc = Path.resolve(process.cwd(), file);
+            const resolvedDest = Path.resolve(serverPath, file);
+            FS.copySync(resolvedSrc, resolvedDest, copyOptions);
+        }
+    }
+}
+function mergePackageJson(base, override) {
+    if (!override) {
+        return base;
+    }
+    const baseScripts = typeof base.scripts === "object" && base.scripts ? base.scripts : {};
+    const overrideScripts = typeof override.scripts === "object" && override.scripts ? override.scripts : {};
+    return Object.assign(Object.assign(Object.assign({}, base), override), { scripts: Object.assign(Object.assign({}, baseScripts), overrideScripts) });
+}
+function readPackConfigFromCwd() {
+    if (!FS.existsSync(exports.PACK_CONFIG_PATH)) {
+        return undefined;
+    }
+    return FS.readJSONSync(exports.PACK_CONFIG_PATH);
+}
+function resolveServerPath(config) {
+    if (!(config === null || config === void 0 ? void 0 : config.serverPath)) {
+        return exports.SERVER_PATH;
+    }
+    return Path.isAbsolute(config.serverPath)
+        ? config.serverPath
+        : Path.resolve(process.cwd(), config.serverPath);
+}
+function resolveZipPath(config) {
+    if (config === null || config === void 0 ? void 0 : config.zipPath) {
+        return Path.isAbsolute(config.zipPath)
+            ? config.zipPath
+            : Path.resolve(process.cwd(), config.zipPath);
+    }
+    if (config === null || config === void 0 ? void 0 : config.zipName) {
+        return Path.resolve(Path.dirname(exports.ZIP_PATH), config.zipName);
+    }
+    return exports.ZIP_PATH;
+}
+/**
+ * 打包文件为7z格式
+ */
+function makeZip(serverPath, zipPath) {
+    return new Promise((resolve, reject) => {
+        // 使用 7zip 将服务器构建目录打包为 7z 文件
+        Zip.pack(serverPath, zipPath, (error) => {
+            if (error) {
+                console.error("打包失败:", error);
+                reject(error);
+            }
+            console.log("打包成功:", zipPath);
+            resolve(zipPath);
+        });
+    });
+}
+/**
+ * 清理原始 dist 目录
+ */
+function cleanUp(config) {
+    if ((config === null || config === void 0 ? void 0 : config.cleanDist) === false) {
+        return;
+    }
+    // 检查原始 dist 目录是否存在，存在则删除
+    if (FS.existsSync(exports.ORIGINAL_DIST_PATH)) {
+        FS.removeSync(exports.ORIGINAL_DIST_PATH);
+    }
+}
+/**
+ * 构建并打包项目的主函数
+ * 1. 执行项目构建
+ * 2. 复制生成的文件
+ * 3. 写入启动脚本
+ * 4. 打包文件为 7z 格式
+ * 5. 清理原始 dist 目录
+ */
+function buildAndPack(config) {
+    return __awaiter(this, void 0, void 0, function* () {
+        const resolvedConfig = config !== null && config !== void 0 ? config : readPackConfigFromCwd();
+        const serverPath = resolveServerPath(resolvedConfig);
+        const zipPath = resolveZipPath(resolvedConfig);
+        yield (0, builder_1.default)(); // 执行项目构建
+        if (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.beforePack) {
+            yield resolvedConfig.beforePack();
+        }
+        copyGeneratedFiles(serverPath, resolvedConfig); // 复制相关文件
+        if ((resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.writeScripts) !== false) {
+            writeScriptFiles(serverPath, resolvedConfig); // 写入脚本文件
+        }
+        yield makeZip(serverPath, zipPath); // 打包文件
+        if (resolvedConfig === null || resolvedConfig === void 0 ? void 0 : resolvedConfig.afterPack) {
+            yield resolvedConfig.afterPack(zipPath);
+        }
+        cleanUp(resolvedConfig); // 清理临时文件
+    });
+}
+exports.default = buildAndPack;

package/commands/postinstall.d.ts

@@ -0,0 +1,2 @@
+export declare function postInstall(): Promise<import("concurrently").CloseEvent[]>;
+export default postInstall;

package/commands/postinstall.js

@@ -0,0 +1,32 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.postInstall = postInstall;
+const concurrently_1 = __importDefault(require("concurrently"));
+const node_child_process_1 = require("node:child_process");
+function postInstall() {
+    const hasGo = (0, node_child_process_1.spawnSync)("go", ["version"], { stdio: "ignore", shell: true }).status ===
+        0;
+    const commands = [
+        {
+            command: "npx nuxt prepare",
+            name: "nuxt",
+            prefixColor: "blue",
+        },
+    ];
+    if (hasGo) {
+        commands.unshift({
+            command: "go mod download && go mod tidy",
+            name: "go",
+            prefixColor: "green",
+        });
+    }
+    else {
+        console.warn("[nuxt-gin-tools] 未检测到 Go，已跳过 Go 相关安装。请先安装 Go 后再重新运行相关命令。");
+    }
+    // 执行并发命令
+    return (0, concurrently_1.default)(commands).result;
+}
+exports.default = postInstall;

package/commands/update.d.ts

@@ -0,0 +1,2 @@
+export declare function update(): void;
+export default update;

package/commands/update.js

@@ -0,0 +1,22 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.update = update;
+const concurrently_1 = __importDefault(require("concurrently"));
+function update() {
+    (0, concurrently_1.default)([
+        {
+            command: "pnpm update --latest",
+            name: "pnpm",
+            prefixColor: "magenta",
+        },
+        {
+            command: "go get -u && go mod tidy",
+            name: "go",
+            prefixColor: "green",
+        },
+    ]);
+}
+exports.default = update;

package/index.js

@@ -39,17 +39,17 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
 Object.defineProperty(exports, "__esModule", { value: true });
 // index.ts - 入口文件，用于处理命令行参数并调用相应的功能模块
 // 导入构建和打包功能
-const pack_1 = __importDefault(require("./src/pack"));
+const pack_1 = __importDefault(require("./commands/pack"));
 // 导入开发模式功能
-const develop_1 = __importStar(require("./src/develop"));
+const develop_1 = __importStar(require("./commands/develop"));
 // 导入API生成功能
-const api_generate_1 = __importDefault(require("./src/api-generate"));
+const api_generate_1 = __importDefault(require("./commands/api-generate"));
 // 导入安装后处理功能
-const postinstall_1 = __importDefault(require("./src/postinstall"));
+const postinstall_1 = __importDefault(require("./commands/postinstall"));
 // 导入清理功能
-const cleanup_1 = __importDefault(require("./src/cleanup"));
+const cleanup_1 = __importDefault(require("./commands/cleanup"));
 // 导入更新功能
-const update_1 = __importDefault(require("./src/update"));
+const update_1 = __importDefault(require("./commands/update"));
 // 获取命令行参数（去除前两个默认参数）
 const args = process.argv.slice(2);
 // 检查是否提供了命令

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nuxt-gin-tools",
-  "version": "0.2.11",
+  "version": "0.2.13",
   "description": "This project is used as a dependency for [nuxt-gin-starter](https://github.com/RapboyGao/nuxt-gin-starter.git)",
   "bin": {
     "nuxt-gin": "index.js"

package/src/commands/api-generate.d.ts

@@ -0,0 +1,11 @@
+/**
+ * 警告：本文件是API生成框架的一部分，请勿手动修改！
+ * 任何修改可能会被自动化流程覆盖。
+ * 如需调整生成逻辑，请修改相关配置文件或脚本。
+ */
+/**
+ * 主函数
+ * 协调执行所有任务：生成代码、删除路径、配置Vue API
+ */
+export declare function apiGenerate(): Promise<void>;
+export default apiGenerate;

package/src/commands/api-generate.js

@@ -0,0 +1,133 @@
+"use strict";
+/**
+ * 警告：本文件是API生成框架的一部分，请勿手动修改！
+ * 任何修改可能会被自动化流程覆盖。
+ * 如需调整生成逻辑，请修改相关配置文件或脚本。
+ */
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.apiGenerate = apiGenerate;
+const chalk_1 = __importDefault(require("chalk"));
+const concurrently_1 = __importDefault(require("concurrently")); // 用于并发执行命令的工具
+const fs_extra_1 = __importDefault(require("fs-extra")); // 文件系统操作工具，提供更便捷的API
+const path_1 = __importDefault(require("path")); // 处理和转换文件路径的工具
+const cwd = process.cwd(); // 获取当前工作目录
+/**
+ * 要执行的命令列表
+ * 包含OpenAPI代码生成命令：
+ * 1. 生成Go Gin服务器代码
+ * 2. 生成TypeScript Axios客户端代码
+ */
+let commands = [
+    {
+        command: "openapi-generator-cli generate -i openapi.yaml -g go-gin-server -c node_modules/nuxt-gin-tools/src/go-gin-server.json -o .",
+        name: "go",
+        prefixColor: "green",
+    },
+    {
+        command: "openapi-generator-cli generate -i openapi.yaml -g typescript-axios -o vue/composables/api ",
+        name: "vue",
+        prefixColor: "blue",
+    },
+];
+/**
+ * 执行完成后需要删除的路径列表
+ */
+const pathsToDelete = ["api"];
+/**
+ * 设置Vue API客户端的基础URL
+ * 修改TypeScript axios生成的base.ts文件，将BASE_PATH设置为相对路径
+ * @returns {Promise<string>} 返回原始文件内容的Promise
+ */
+function setVueBaseUrl() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            // 构建Vue API运行时配置文件的完整路径
+            const VUE_API_RUNTIME_PATH = path_1.default.join(cwd, "vue/composables/api/base.ts");
+            // 读取原始文件内容
+            const originalContent = yield fs_extra_1.default.readFile(VUE_API_RUNTIME_PATH, "utf-8");
+            // 使用正则表达式替换BASE_PATH常量，移除协议和域名部分，使其成为相对路径
+            // 匹配类似 "export const BASE_PATH = "https://example.com"" 这样的行
+            const updatedContent = originalContent.replace(/export\s+const\s+BASE_PATH = "https?:\/\/[^/]+/, `export const BASE_PATH = "`);
+            // 将修改后的内容写回文件
+            yield fs_extra_1.default.outputFile(VUE_API_RUNTIME_PATH, updatedContent, "utf-8");
+            console.log("成功更新Vue API基础URL为相对路径");
+            return;
+        }
+        catch (error) {
+            console.error("更新Vue API基础URL失败:", error);
+            throw error; // 将错误继续抛出，以便上层处理
+        }
+    });
+}
+function setGoRoutes() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const GO_API_RUNTIME_PATH = path_1.default.join(cwd, "server/api/routers.go");
+        const originalContent = yield fs_extra_1.default.readFile(GO_API_RUNTIME_PATH, "utf-8");
+        const updatedContent = originalContent.replace(/getRoutes/g, "GetRoutes");
+        // overwrite
+        yield fs_extra_1.default.outputFile(GO_API_RUNTIME_PATH, updatedContent, "utf-8");
+    });
+}
+/**
+ * 删除指定的路径
+ * 用于清理生成过程中产生的临时或不需要的文件和目录
+ */
+function removePaths() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            // 遍历要删除的路径列表
+            for (const path of pathsToDelete) {
+                // 构建完整路径
+                const fullPath = path_1.default.join(cwd, path);
+                // 删除路径（文件或目录）
+                yield fs_extra_1.default.remove(fullPath);
+                console.log(`成功删除路径: ${fullPath}`);
+            }
+        }
+        catch (error) {
+            console.error("删除路径失败:", error);
+            throw error; // 将错误继续抛出
+        }
+    });
+}
+/**
+ * 主函数
+ * 协调执行所有任务：生成代码、删除路径、配置Vue API
+ */
+function apiGenerate() {
+    return __awaiter(this, void 0, void 0, function* () {
+        try {
+            // 输出开始信息
+            console.log(chalk_1.default.bgGreen("开始生成API代码..."));
+            // 并发执行命令列表中的所有命令，等待所有命令完成
+            yield (0, concurrently_1.default)(commands).result;
+            // 按顺序执行清理和配置任务
+            let tasks = [];
+            tasks.push(removePaths());
+            tasks.push(setVueBaseUrl());
+            tasks.push(setGoRoutes());
+            yield Promise.all(tasks);
+            console.log(chalk_1.default.bgGreen("API代码生成和配置完成!"));
+        }
+        catch (error) {
+            // 捕获并处理任何阶段发生的错误
+            console.error(chalk_1.default.red("执行过程中发生错误:"), error);
+            // 以错误码1退出进程，表示执行失败
+            process.exit(1);
+        }
+    });
+}
+// 执行主函数
+exports.default = apiGenerate;

package/src/commands/builder.d.ts

@@ -0,0 +1,2 @@
+export declare function build(): Promise<import("concurrently").CloseEvent[]>;
+export default build;