ms-vite-plugin 1.0.2 → 1.0.4

package/dist/cli.js

@@ -35,13 +35,22 @@ var __importStar = (this && this.__importStar) || (function () {
 })();
 Object.defineProperty(exports, "__esModule", { value: true });
 const commander_1 = require("commander");
+const os = __importStar(require("os"));
 const path = __importStar(require("path"));
 const build_1 = require("./build");
 const fsExtra = __importStar(require("fs-extra"));
+const project_1 = require("./project");
+const ws_manager_1 = require("./ws-manager");
+/**
+ * WS 状态持久化文件路径（用于跨进程查询 ws-status）
+ */
+const WS_PID_FILE = path.join(os.tmpdir(), "ms-cli-ws-server.json");
 /**
  * 检查工作目录是否为有效的 KuaiJS 项目
  * @param workspacePath 工作目录路径
  * @returns 是否为有效项目
+ * @example
+ * await isValidKuaiJSProject(process.cwd())
  */
 async function isValidKuaiJSProject(workspacePath) {
     try {
@@ -57,24 +66,36 @@ async function isValidKuaiJSProject(workspacePath) {
         return false;
     }
 }
+/**
+ * 统一校验项目目录合法性
+ * @param workspacePath 待校验的项目目录
+ * @returns 校验通过返回 Promise<void>
+ * @example
+ * await ensureValidKuaiJSProject("/Users/demo/project")
+ */
+async function ensureValidKuaiJSProject(workspacePath) {
+    if (await isValidKuaiJSProject(workspacePath)) {
+        return;
+    }
+    console.error("❌ 错误: 当前目录不是有效的 快点JS 项目");
+    console.error("请确保目录包含以下文件:");
+    console.error("  - package.json");
+    console.error("  - scripts/ 目录");
+    process.exit(1);
+}
 /**
  * 构建命令处理函数
  * @param options 命令选项
+ * @returns 请求完成后退出
+ * @example
+ * ms build -d
  */
 async function buildCommand(options) {
     try {
-        const workspacePath = options.path
-            ? path.resolve(options.path)
-            : process.cwd();
+        const workspacePath = process.cwd();
         const isDev = options.dev || false;
         console.log(`🔍 检查项目目录: ${workspacePath}`);
-        if (!(await isValidKuaiJSProject(workspacePath))) {
-            console.error("❌ 错误: 当前目录不是有效的 快点JS 项目");
-            console.error("请确保目录包含以下文件:");
-            console.error("  - package.json");
-            console.error("  - scripts/ 目录");
-            process.exit(1);
-        }
+        await ensureValidKuaiJSProject(workspacePath);
         console.log(`🚀 开始构建项目 (${isDev ? "开发模式" : "生产模式"})...`);
         await (0, build_1.buildAll)(isDev, workspacePath);
         console.log("✅ 构建完成!");
@@ -87,14 +108,278 @@ async function buildCommand(options) {
         process.exit(1);
     }
 }
+/**
+ * run 命令处理函数
+ * @param options 命令选项
+ * @returns 请求完成后退出
+ * @example
+ * ms run --ip 192.168.1.100 --port 9800
+ */
+async function runCommand(options) {
+    try {
+        const workspacePath = process.cwd();
+        await ensureValidKuaiJSProject(workspacePath);
+        await (0, project_1.runOnDevice)(options);
+        console.log("✅ 运行请求已发送");
+    }
+    catch (error) {
+        console.error("❌ 运行失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * runUI 命令处理函数
+ * @param options 命令选项
+ * @returns 请求完成后退出
+ * @example
+ * ms run-ui --ip 192.168.1.100 --port 9800
+ */
+async function runUICommand(options) {
+    try {
+        const workspacePath = process.cwd();
+        await ensureValidKuaiJSProject(workspacePath);
+        await (0, project_1.runUIOnDevice)(options);
+        console.log("✅ UI 预览请求已发送");
+    }
+    catch (error) {
+        console.error("❌ UI 预览失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * stop 命令处理函数
+ * @param options 命令选项
+ * @returns 请求完成后退出
+ * @example
+ * ms stop --ip 192.168.1.100 --port 9800
+ */
+async function stopCommand(options) {
+    try {
+        const workspacePath = process.cwd();
+        await ensureValidKuaiJSProject(workspacePath);
+        await (0, project_1.stopOnDevice)(options);
+        console.log("✅ 停止请求已发送");
+    }
+    catch (error) {
+        console.error("❌ 停止失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * ws-start 命令处理函数
+ * @param options 命令选项
+ * @returns 常驻直到收到退出信号
+ * @example
+ * ms ws-start --ws-port 31111
+ */
+async function wsStartCommand(options) {
+    try {
+        await ensureValidKuaiJSProject(process.cwd());
+        const wsPortText = (options.wsPort ?? "31111").trim();
+        const wsPort = Number.parseInt(wsPortText, 10);
+        if (!Number.isInteger(wsPort) || wsPort < 1 || wsPort > 65535) {
+            throw new Error(`无效 ws 端口: ${wsPortText}`);
+        }
+        const ws = ws_manager_1.WSManager.get();
+        await ws.start(wsPort);
+        /**
+         * 写入 WS 运行状态到临时文件，供 ws-status 命令跨进程读取
+         */
+        const writeStatus = async () => {
+            const payload = {
+                pid: process.pid,
+                port: wsPort,
+                address: ws.getAddress(),
+                startedAt: Date.now(),
+                connected: ws.isClientConnected(),
+                clientIp: ws.getConnectedClientIp(),
+            };
+            await fsExtra.writeJSON(WS_PID_FILE, payload);
+        };
+        await writeStatus();
+        const statusTimer = setInterval(() => {
+            writeStatus().catch(() => {
+                // ignore periodic write errors
+            });
+        }, 1000);
+        await fsExtra.writeJSON(WS_PID_FILE, {
+            pid: process.pid,
+            port: wsPort,
+            address: ws.getAddress(),
+            startedAt: Date.now(),
+            connected: ws.isClientConnected(),
+            clientIp: ws.getConnectedClientIp(),
+        });
+        console.log("按 Ctrl+C 停止 WS 服务");
+        await new Promise((resolve) => {
+            const shutdown = async () => {
+                process.off("SIGINT", shutdown);
+                process.off("SIGTERM", shutdown);
+                clearInterval(statusTimer);
+                await ws.stop();
+                await fsExtra.remove(WS_PID_FILE);
+                resolve();
+            };
+            process.on("SIGINT", shutdown);
+            process.on("SIGTERM", shutdown);
+        });
+    }
+    catch (error) {
+        console.error("❌ WS 服务启动失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * ws-stop 命令处理函数
+ * @returns 请求完成后退出
+ * @example
+ * ms ws-stop
+ */
+async function wsStopCommand() {
+    try {
+        await ensureValidKuaiJSProject(process.cwd());
+        if (!(await fsExtra.pathExists(WS_PID_FILE))) {
+            console.log("WS 服务未运行");
+            return;
+        }
+        const info = await fsExtra.readJSON(WS_PID_FILE);
+        const pid = Number(info.pid);
+        if (!Number.isInteger(pid) || pid <= 0) {
+            await fsExtra.remove(WS_PID_FILE);
+            throw new Error("WS PID 文件损坏");
+        }
+        try {
+            process.kill(pid, "SIGTERM");
+            console.log(`✅ 已发送停止信号到 WS 进程: ${pid}`);
+        }
+        catch {
+            console.log("WS 进程不存在，清理 PID 文件");
+        }
+        await fsExtra.remove(WS_PID_FILE);
+    }
+    catch (error) {
+        console.error("❌ WS 服务停止失败:", error instanceof Error ? error.message : error);
+        process.exit(1);
+    }
+}
+/**
+ * ws-status 命令处理函数
+ * @returns 请求完成后退出
+ * @example
+ * ms ws-status
+ */
+async function wsStatusCommand() {
+    await ensureValidKuaiJSProject(process.cwd());
+    if (!(await fsExtra.pathExists(WS_PID_FILE))) {
+        console.log("服务状态: stopped");
+        return;
+    }
+    const info = await fsExtra.readJSON(WS_PID_FILE);
+    const pid = Number(info.pid);
+    const address = String(info.address || "unknown");
+    const connected = Boolean(info.connected);
+    const clientIp = info.clientIp === null || info.clientIp === undefined
+        ? null
+        : String(info.clientIp);
+    let running = false;
+    try {
+        process.kill(pid, 0);
+        running = true;
+    }
+    catch {
+        running = false;
+    }
+    if (!running) {
+        await fsExtra.remove(WS_PID_FILE);
+        console.log("服务状态: stopped");
+        return;
+    }
+    console.log(`服务状态: running (pid=${pid})`);
+    console.log(`WS 地址: ${address}`);
+    console.log(`连接状态: ${connected ? "connected" : "disconnected"}`);
+    if (connected) {
+        console.log(`设备IP: ${clientIp || "unknown"}`);
+    }
+}
+/**
+ * 生成顶层 help 的详细命令参数说明
+ * @returns 返回格式化后的帮助文本
+ * @example
+ * renderDetailedCommandHelp()
+ */
+function renderDetailedCommandHelp() {
+    const lines = [];
+    lines.push("");
+    lines.push("详细命令参数:");
+    const commands = commander_1.program.commands.filter((cmd) => cmd.name() !== "help");
+    for (const cmd of commands) {
+        lines.push(`  ${cmd.name()}:`);
+        if (cmd.options.length === 0) {
+            lines.push("    (无额外参数)");
+            continue;
+        }
+        for (const opt of cmd.options) {
+            const desc = opt.description ? `  ${opt.description}` : "";
+            lines.push(`    ${opt.flags}${desc}`);
+        }
+    }
+    lines.push("");
+    return lines.join("\n");
+}
 // 配置 CLI 程序
-commander_1.program.name("ms-cli").description("快点JS 构建工具").version("0.0.7");
+commander_1.program.name("ms-cli").description("快点JS 构建工具").version("1.0.4");
+commander_1.program.addHelpText("after", renderDetailedCommandHelp);
 // 构建命令
 commander_1.program
     .command("build")
     .description("构建 快点JS 项目")
     .option("-d, --dev", "开发模式构建 (包含 source map)")
-    .option("-p, --path <path>", "指定项目路径")
     .action(buildCommand);
+// 运行命令
+commander_1.program
+    .command("run")
+    .description("在设备上运行项目")
+    .option("-i, --ip <ip>", "设备 IP 地址（transport=http 时必填）")
+    .option("--port <port>", "设备端口 (默认: 9800)", "9800")
+    .option("-t, --transport <transport>", "传输方式: http|ws", "http")
+    .option("--ws-port <wsPort>", "WS 服务端口 (默认: 31111)", "31111")
+    .option("--ws-wait-ms <wsWaitMs>", "WS 等待设备连接时间(毫秒)", "30000")
+    .action(runCommand);
+// UI 预览命令
+commander_1.program
+    .command("run-ui")
+    .description("在设备上预览 UI")
+    .option("-i, --ip <ip>", "设备 IP 地址（transport=http 时必填）")
+    .option("--port <port>", "设备端口 (默认: 9800)", "9800")
+    .option("-t, --transport <transport>", "传输方式: http|ws", "http")
+    .option("--ws-port <wsPort>", "WS 服务端口 (默认: 31111)", "31111")
+    .option("--ws-wait-ms <wsWaitMs>", "WS 等待设备连接时间(毫秒)", "30000")
+    .action(runUICommand);
+// 停止命令
+commander_1.program
+    .command("stop")
+    .description("停止设备上的项目")
+    .option("-i, --ip <ip>", "设备 IP 地址（transport=http 时必填）")
+    .option("--port <port>", "设备端口 (默认: 9800)", "9800")
+    .option("-t, --transport <transport>", "传输方式: http|ws", "http")
+    .option("--ws-port <wsPort>", "WS 服务端口 (默认: 31111)", "31111")
+    .option("--ws-wait-ms <wsWaitMs>", "WS 等待设备连接时间(毫秒)", "30000")
+    .action(stopCommand);
+// WS 服务启动命令
+commander_1.program
+    .command("ws-start")
+    .description("启动 CLI 内置 WS 服务")
+    .option("--ws-port <wsPort>", "WS 服务端口 (默认: 31111)", "31111")
+    .action(wsStartCommand);
+// WS 服务停止命令
+commander_1.program
+    .command("ws-stop")
+    .description("停止 CLI 内置 WS 服务")
+    .action(wsStopCommand);
+// WS 服务状态命令
+commander_1.program
+    .command("ws-status")
+    .description("查看 CLI 内置 WS 服务状态")
+    .action(wsStatusCommand);
 // 解析命令行参数
 commander_1.program.parse();

package/dist/device.d.ts

@@ -0,0 +1,32 @@
+/**
+ * 设备命令选项
+ */
+export interface DeviceCliOptions {
+    ip: string;
+    port?: string;
+    path?: string;
+}
+/**
+ * 在设备上运行项目（先同步后运行）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+export declare function runOnDevice(options: DeviceCliOptions): Promise<void>;
+/**
+ * 在设备上预览 UI（先同步后调用 runUI）
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await runUIOnDevice({ ip: "192.168.1.10", port: "9800", path: "./demo" })
+ */
+export declare function runUIOnDevice(options: DeviceCliOptions): Promise<void>;
+/**
+ * 停止设备上的项目
+ * @param options 命令选项
+ * @returns 执行完成后返回 Promise<void>
+ * @example
+ * await stopOnDevice({ ip: "192.168.1.10", port: "9800" })
+ */
+export declare function stopOnDevice(options: DeviceCliOptions): Promise<void>;