@gct-paas/cli 0.1.8 → 0.1.9

package/CHANGELOG.md

@@ -7,6 +7,12 @@
 
 ## [Unreleased]
 
+## [0.1.9] - 2026-04-02
+
+### Added
+
+- 命令 nginx-start 便捷本地启动 plugin 开发 nginx
+
 ## [0.1.8] - 2026-04-02
 
 ### Changed

package/dist/actions/index.cjs

@@ -21,6 +21,12 @@ Object.defineProperty(exports, "InitGitAction", {
     return _initGit.InitGitAction;
   }
 });
+Object.defineProperty(exports, "NginxStartAction", {
+  enumerable: true,
+  get: function () {
+    return _nginxStart.NginxStartAction;
+  }
+});
 Object.defineProperty(exports, "RestoreFilesAction", {
   enumerable: true,
   get: function () {
@@ -37,4 +43,5 @@ var _genApi = require("./gen-api/gen-api.cjs");
 var _genCdnLib = require("./gen-cdn-lib/gen-cdn-lib.cjs");
 var _initGit = require("./init-git/init-git.cjs");
 var _restoreFiles = require("./restore-files/restore-files.cjs");
-var _updateCatalogEnv = require("./update-catalog-env/update-catalog-env.cjs");
+var _updateCatalogEnv = require("./update-catalog-env/update-catalog-env.cjs");
+var _nginxStart = require("./nginx-start/nginx-start.cjs");

package/dist/actions/index.d.ts

@@ -3,3 +3,4 @@ export { GenCdnLibAction } from './gen-cdn-lib/gen-cdn-lib';
 export { InitGitAction } from './init-git/init-git';
 export { RestoreFilesAction } from './restore-files/restore-files';
 export { UpdateCatalogEnvAction } from './update-catalog-env/update-catalog-env';
+export { NginxStartAction } from './nginx-start/nginx-start';

package/dist/actions/nginx-start/nginx-start.cjs

@@ -0,0 +1,68 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NginxStartAction = void 0;
+var _nodeChild_process = require("node:child_process");
+var _nodeFs = require("node:fs");
+var _nodePath = require("node:path");
+var _consola = require("consola");
+function sleep(ms) {
+  return new Promise(resolve2 => setTimeout(resolve2, ms));
+}
+class NginxStartAction {
+  nginxDir;
+  constructor(nginxDir) {
+    this.nginxDir = nginxDir ?? (0, _nodePath.resolve)(process.cwd(), "configs/nginx");
+  }
+  /**
+   * 停止已运行的 nginx 进程
+   * Windows 使用 taskkill 强制终止，其他平台使用 nginx -s stop
+   * 若 nginx 未运行则忽略错误
+   */
+  async stopNginxIfRunning() {
+    try {
+      if (process.platform === "win32") {
+        (0, _nodeChild_process.execSync)("taskkill /F /IM nginx.exe", {
+          stdio: "pipe"
+        });
+      } else {
+        (0, _nodeChild_process.execSync)(`nginx -p "${this.nginxDir}" -s stop`, {
+          stdio: "pipe"
+        });
+      }
+      _consola.consola.info("\u5DF2\u505C\u6B62\u73B0\u6709 nginx \u8FDB\u7A0B\uFF0C\u7B49\u5F85 1 \u79D2...");
+      await sleep(1e3);
+    } catch {
+      _consola.consola.info("nginx \u672A\u8FD0\u884C\uFF0C\u8DF3\u8FC7\u505C\u6B62\u6B65\u9AA4");
+    }
+  }
+  /**
+   * 启动 nginx
+   * Windows 下 nginx 不会自动 daemonize，使用 spawn detached 模式后台启动
+   */
+  startNginx() {
+    (0, _nodeFs.mkdirSync)((0, _nodePath.resolve)(this.nginxDir, "logs"), {
+      recursive: true
+    });
+    (0, _nodeFs.mkdirSync)((0, _nodePath.resolve)(this.nginxDir, "temp"), {
+      recursive: true
+    });
+    const nginxDirNormalized = this.nginxDir.split(_nodePath.sep).join("/");
+    const child = (0, _nodeChild_process.spawn)("nginx", ["-p", nginxDirNormalized, "-c", "nginx.conf"], {
+      cwd: process.cwd(),
+      stdio: "ignore",
+      detached: true
+    });
+    child.unref();
+  }
+  async run() {
+    _consola.consola.start("\u5F00\u59CB\u542F\u52A8 nginx...");
+    await this.stopNginxIfRunning();
+    _consola.consola.start("\u6B63\u5728\u542F\u52A8 nginx...");
+    this.startNginx();
+    _consola.consola.success("nginx \u542F\u52A8\u6267\u884C\u5B8C\u6BD5");
+  }
+}
+exports.NginxStartAction = NginxStartAction;

package/dist/actions/nginx-start/nginx-start.d.ts

@@ -0,0 +1,16 @@
+export declare class NginxStartAction {
+    private readonly nginxDir;
+    constructor(nginxDir?: string);
+    /**
+     * 停止已运行的 nginx 进程
+     * Windows 使用 taskkill 强制终止，其他平台使用 nginx -s stop
+     * 若 nginx 未运行则忽略错误
+     */
+    private stopNginxIfRunning;
+    /**
+     * 启动 nginx
+     * Windows 下 nginx 不会自动 daemonize，使用 spawn detached 模式后台启动
+     */
+    private startNginx;
+    run(): Promise<void>;
+}

package/dist/actions/update-catalog-env/update-catalog-env.cjs

@@ -29,12 +29,10 @@ class UpdateCatalogEnvAction {
       _consola.consola.warn("pnpm-workspace.yaml \u4E2D\u7F3A\u5C11 catalog \u914D\u7F6E\uFF0C\u8DF3\u8FC7 catalog \u8BBE\u7F6E");
       return;
     }
-    const tasks = new _listr.Listr(_constants.lib_packages.map(pkg => ({
+    const pkgsToUpdate = _constants.lib_packages.filter(pkg => pkg in catalogCfg);
+    const tasks = new _listr.Listr(pkgsToUpdate.map(pkg => ({
       title: `\u8BBE\u7F6E ${pkg} \u7684 catalog \u6807\u7B7E\u4E3A ${tag}`,
       task: async (_, task) => {
-        if (!catalogCfg[pkg]) {
-          return;
-        }
         task.title = `${pkg}@${tag}  \u83B7\u53D6\u5305\u4FE1\u606F...`;
         try {
           const pkgInfo = await _pacote.default.manifest(`${pkg}@${tag}`);

package/dist/commands/index.cjs

@@ -10,6 +10,7 @@ var _genCdnLib = require("./gen-cdn-lib/gen-cdn-lib.cjs");
 var _initGit = require("./init-git/init-git.cjs");
 var _restoreFiles = require("./restore-files/restore-files.cjs");
 var _updateCatalogEnv = require("./update-catalog-env/update-catalog-env.cjs");
+var _nginxStart = require("./nginx-start/nginx-start.cjs");
 class CommandLoader {
   static load(program) {
     new _genApi.GenApiCommand().load(program);
@@ -17,6 +18,7 @@ class CommandLoader {
     new _initGit.InitGitCommand().load(program);
     new _restoreFiles.RestoreFilesCommand().load(program);
     new _updateCatalogEnv.UpdateCatalogEnvCommand().load(program);
+    new _nginxStart.NginxStartCommand().load(program);
     this.handleInvalidCommand(program);
   }
   static handleInvalidCommand(program) {

package/dist/commands/nginx-start/nginx-start.cjs

@@ -0,0 +1,16 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.NginxStartCommand = void 0;
+var _actions = require("../../actions/index.cjs");
+class NginxStartCommand {
+  load(program) {
+    program.command("nginx-start").description("\u542F\u52A8 nginx\uFF08\u9700\u5C06 nginx \u53EF\u6267\u884C\u6587\u4EF6\u6DFB\u52A0\u5230\u7CFB\u7EDF PATH\uFF09").option("-d, --dir <path>", "nginx \u914D\u7F6E\u76EE\u5F55\uFF08\u9ED8\u8BA4\uFF1A<cwd>/configs/nginx\uFF09").action(this.action.bind(this));
+  }
+  async action(options) {
+    await new _actions.NginxStartAction(options.dir).run();
+  }
+}
+exports.NginxStartCommand = NginxStartCommand;

package/dist/commands/nginx-start/nginx-start.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+import { ICommand } from '../../interface';
+/**
+ * 插件开发本地调试 nginx 启动命令
+ *
+ * @export
+ * @class NginxStartCommand
+ * @implements {ICommand}
+ */
+export declare class NginxStartCommand implements ICommand {
+    load(program: Command): void;
+    action(options: {
+        dir?: string;
+    }): Promise<void>;
+}

package/es/actions/index.d.ts

@@ -3,3 +3,4 @@ export { GenCdnLibAction } from './gen-cdn-lib/gen-cdn-lib';
 export { InitGitAction } from './init-git/init-git';
 export { RestoreFilesAction } from './restore-files/restore-files';
 export { UpdateCatalogEnvAction } from './update-catalog-env/update-catalog-env';
+export { NginxStartAction } from './nginx-start/nginx-start';

package/es/actions/index.mjs

@@ -3,3 +3,4 @@ export { GenCdnLibAction } from "./gen-cdn-lib/gen-cdn-lib.mjs";
 export { InitGitAction } from "./init-git/init-git.mjs";
 export { RestoreFilesAction } from "./restore-files/restore-files.mjs";
 export { UpdateCatalogEnvAction } from "./update-catalog-env/update-catalog-env.mjs";
+export { NginxStartAction } from "./nginx-start/nginx-start.mjs";

package/es/actions/nginx-start/nginx-start.d.ts

@@ -0,0 +1,16 @@
+export declare class NginxStartAction {
+    private readonly nginxDir;
+    constructor(nginxDir?: string);
+    /**
+     * 停止已运行的 nginx 进程
+     * Windows 使用 taskkill 强制终止，其他平台使用 nginx -s stop
+     * 若 nginx 未运行则忽略错误
+     */
+    private stopNginxIfRunning;
+    /**
+     * 启动 nginx
+     * Windows 下 nginx 不会自动 daemonize，使用 spawn detached 模式后台启动
+     */
+    private startNginx;
+    run(): Promise<void>;
+}

package/es/actions/nginx-start/nginx-start.mjs

@@ -0,0 +1,53 @@
+import { execSync, spawn } from "node:child_process";
+import { mkdirSync } from "node:fs";
+import { resolve, sep } from "node:path";
+import { consola } from "consola";
+function sleep(ms) {
+  return new Promise((resolve2) => setTimeout(resolve2, ms));
+}
+export class NginxStartAction {
+  nginxDir;
+  constructor(nginxDir) {
+    this.nginxDir = nginxDir ?? resolve(process.cwd(), "configs/nginx");
+  }
+  /**
+   * 停止已运行的 nginx 进程
+   * Windows 使用 taskkill 强制终止，其他平台使用 nginx -s stop
+   * 若 nginx 未运行则忽略错误
+   */
+  async stopNginxIfRunning() {
+    try {
+      if (process.platform === "win32") {
+        execSync("taskkill /F /IM nginx.exe", { stdio: "pipe" });
+      } else {
+        execSync(`nginx -p "${this.nginxDir}" -s stop`, { stdio: "pipe" });
+      }
+      consola.info("\u5DF2\u505C\u6B62\u73B0\u6709 nginx \u8FDB\u7A0B\uFF0C\u7B49\u5F85 1 \u79D2...");
+      await sleep(1e3);
+    } catch {
+      consola.info("nginx \u672A\u8FD0\u884C\uFF0C\u8DF3\u8FC7\u505C\u6B62\u6B65\u9AA4");
+    }
+  }
+  /**
+   * 启动 nginx
+   * Windows 下 nginx 不会自动 daemonize，使用 spawn detached 模式后台启动
+   */
+  startNginx() {
+    mkdirSync(resolve(this.nginxDir, "logs"), { recursive: true });
+    mkdirSync(resolve(this.nginxDir, "temp"), { recursive: true });
+    const nginxDirNormalized = this.nginxDir.split(sep).join("/");
+    const child = spawn("nginx", ["-p", nginxDirNormalized, "-c", "nginx.conf"], {
+      cwd: process.cwd(),
+      stdio: "ignore",
+      detached: true
+    });
+    child.unref();
+  }
+  async run() {
+    consola.start("\u5F00\u59CB\u542F\u52A8 nginx...");
+    await this.stopNginxIfRunning();
+    consola.start("\u6B63\u5728\u542F\u52A8 nginx...");
+    this.startNginx();
+    consola.success("nginx \u542F\u52A8\u6267\u884C\u5B8C\u6BD5");
+  }
+}

package/es/actions/update-catalog-env/update-catalog-env.mjs

@@ -22,13 +22,11 @@ export class UpdateCatalogEnvAction {
       consola.warn("pnpm-workspace.yaml \u4E2D\u7F3A\u5C11 catalog \u914D\u7F6E\uFF0C\u8DF3\u8FC7 catalog \u8BBE\u7F6E");
       return;
     }
+    const pkgsToUpdate = lib_packages.filter((pkg) => pkg in catalogCfg);
     const tasks = new Listr(
-      lib_packages.map((pkg) => ({
+      pkgsToUpdate.map((pkg) => ({
         title: `\u8BBE\u7F6E ${pkg} \u7684 catalog \u6807\u7B7E\u4E3A ${tag}`,
         task: async (_, task) => {
-          if (!catalogCfg[pkg]) {
-            return;
-          }
           task.title = `${pkg}@${tag}  \u83B7\u53D6\u5305\u4FE1\u606F...`;
           try {
             const pkgInfo = await pacote.manifest(`${pkg}@${tag}`);

package/es/commands/index.mjs

@@ -4,6 +4,7 @@ import { GenCdnLibCommand } from "./gen-cdn-lib/gen-cdn-lib.mjs";
 import { InitGitCommand } from "./init-git/init-git.mjs";
 import { RestoreFilesCommand } from "./restore-files/restore-files.mjs";
 import { UpdateCatalogEnvCommand } from "./update-catalog-env/update-catalog-env.mjs";
+import { NginxStartCommand } from "./nginx-start/nginx-start.mjs";
 export class CommandLoader {
   static load(program) {
     new GenApiCommand().load(program);
@@ -11,6 +12,7 @@ export class CommandLoader {
     new InitGitCommand().load(program);
     new RestoreFilesCommand().load(program);
     new UpdateCatalogEnvCommand().load(program);
+    new NginxStartCommand().load(program);
     this.handleInvalidCommand(program);
   }
   static handleInvalidCommand(program) {

package/es/commands/nginx-start/nginx-start.d.ts

@@ -0,0 +1,15 @@
+import { Command } from 'commander';
+import { ICommand } from '../../interface';
+/**
+ * 插件开发本地调试 nginx 启动命令
+ *
+ * @export
+ * @class NginxStartCommand
+ * @implements {ICommand}
+ */
+export declare class NginxStartCommand implements ICommand {
+    load(program: Command): void;
+    action(options: {
+        dir?: string;
+    }): Promise<void>;
+}

package/es/commands/nginx-start/nginx-start.mjs

@@ -0,0 +1,9 @@
+import { NginxStartAction } from "../../actions/index.mjs";
+export class NginxStartCommand {
+  load(program) {
+    program.command("nginx-start").description("\u542F\u52A8 nginx\uFF08\u9700\u5C06 nginx \u53EF\u6267\u884C\u6587\u4EF6\u6DFB\u52A0\u5230\u7CFB\u7EDF PATH\uFF09").option("-d, --dir <path>", "nginx \u914D\u7F6E\u76EE\u5F55\uFF08\u9ED8\u8BA4\uFF1A<cwd>/configs/nginx\uFF09").action(this.action.bind(this));
+  }
+  async action(options) {
+    await new NginxStartAction(options.dir).run();
+  }
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@gct-paas/cli",
-  "version": "0.1.8",
+  "version": "0.1.9",
   "type": "module",
   "description": "paas 平台核心包",
   "bin": {