@appthen/cli 1.1.18 → 1.1.20

package/bin/main.js

@@ -3,13 +3,37 @@
 /* eslint-disable prefer-arrow-callback */
 /* eslint-disable @typescript-eslint/no-require-imports */
 
+/**
+ * 导入包信息，用于获取版本号
+ */
 var pkg = require('../package.json');
 
+/**
+ * 导入commander用于构建CLI命令行工具
+ */
 var program = require('commander');
 
+// 设置版本信息命令
 program
   .version(pkg.version, '-v, --version', 'display version information');
 
+/**
+ * generate命令 - 默认命令
+ * 用于从appthen生成代码
+ * 必需参数:
+ * -p, --id: 项目ID
+ * -a, --auth: 认证token
+ * 可选参数:
+ * -cc, --clear: 清除缓存
+ * -o, --output: 指定输出目录，默认为generated
+ * -fn, --filter: 过滤文档
+ * -fd, --folder: 按文件夹过滤文档
+ * -fr, --frame: 代码框架类型(web/app)
+ * -env, --env: 低代码环境
+ * -c, --cwd: 指定工作目录
+ * -q, --quiet: 安静模式，仅输出错误信息
+ * -vb, --verbose: 详细模式，输出更多信息
+ */
 program
   .command('generate', { isDefault: true })
   .description('Generate code from appthen')
@@ -43,13 +67,19 @@ program
       });
   });
 
+/**
+ * watch命令
+ * 用于启动监听服务
+ * 参数与generate命令基本相同，额外增加:
+ * -m, --mode: 监听模式
+ * -a, --account: 用户ID
+ */
 program
   .command('watch')
   .description('start watch service')
   .requiredOption('-p, --id <id>', 'project id')
   .requiredOption('-a, --auth <auth>', 'auth token')
   .option('-cc, --clear <clear>', 'clear cache')
-  // .option('-i, --input <input>', 'specify the input schema file')
   .option('-o, --output <output>', 'specify the output directory', 'generated')
   .option('-fn, --filter <filter>', 'filter docments')
   .option('-fd, --folder <folder>', 'filter docments by folder')
@@ -78,6 +108,10 @@ program
       });
   });
 
+/**
+ * version命令
+ * 显示CLI版本信息
+ */
 program
   .command('version', { isDefault: false })
   .description('show cli version')
@@ -86,6 +120,12 @@ program
     process.exit();
   });
 
+/**
+ * release命令
+ * 发布网站并上传到CDN/FTP/OSS/云存储
+ * 必需参数:
+ * -c, --cloud: 云存储类型
+ */
 program
   .command('release', { isDefault: false })
   .description('release website and upload to cdn / ftp / oss / cloud')
@@ -103,6 +143,12 @@ program
       });
   });
 
+/**
+ * release-material命令
+ * 发布物料并上传到CDN
+ * 必需参数:
+ * -a, --auth: 认证token
+ */
 program
   .command('release-material', { isDefault: false })
   .description('release material and upload to cdn')
@@ -120,6 +166,13 @@ program
       });
   });
 
+/**
+ * create命令
+ * 从模板创建新项目
+ * 必需参数:
+ * -t, --template: 模板名称
+ * -f, --folder: 文件夹名称
+ */
 program
   .command('create', { isDefault: false })
   .description('Create a new project from template')
@@ -137,4 +190,100 @@ program
       });
   });
 
+/**
+ * sync-backend命令
+ * 从远程同步后端代码
+ * 必需参数:
+ * -a, --auth: 认证token
+ * 可选参数:
+ * -o, --output: 指定输出目录，默认为src/types
+ * -m, --mapping: 路径映射配置
+ * -cc, --clear: 清除缓存
+ * -c, --cwd: 指定工作目录
+ * -q, --quiet: 安静模式
+ * -vb, --verbose: 详细模式
+ */
+program
+  .command('sync-backend')
+  .description('Sync backend code from remote')
+  .requiredOption('-p, --id <id>', 'project id')
+  .requiredOption('-a, --auth <auth>', 'auth token')
+  .option('-f, --framework <framework>', 'backend language framework', 'fastify')
+  .option('-o, --output <output>', 'specify the output directory', 'src/types')
+  .option('-m, --mapping <mapping>', 'path mapping configuration')
+  .option('-cc, --clear <clear>', 'clear cache')
+  .option('-c, --cwd <cwd>', 'specify the working directory', '.')
+  .option('-q, --quiet', 'be quiet, do not output anything unless get error', false)
+  .option('-vb, --verbose', 'be verbose, output more information', false)
+  .action(function doSync(command) {
+    var options = command?.opts?.() || {};
+    if (options.cwd) {
+      process.chdir(options.cwd);
+    }
+
+    require('../dist/index.js')
+      .syncBackend(options)
+      .then((retCode) => {
+        process.exit(retCode);
+      });
+  });
+
+/**
+ * deploy-vercel命令
+ * 部署Fastify项目到Vercel
+ * 必需参数:
+ * -p, --project-id: Vercel项目ID
+ * -t, --token: Vercel API Token
+ * 可选参数:
+ * -pn, --project-name: 项目名称
+ * -e, --env: 环境变量，格式为 KEY=VALUE
+ * -o, --output: 构建输出目录
+ * -c, --cwd: 指定工作目录
+ * --prod: 部署到生产环境
+ */
+program
+  .command('deploy-vercel')
+  .description('Deploy Fastify project to Vercel')
+  .requiredOption('-p, --project-id <projectId>', 'Vercel project ID')
+  .requiredOption('-t, --token <token>', 'Vercel API token')
+  .option('-pn, --project-name <projectName>', 'project name')
+  .option('-e, --env <env...>', 'environment variables (KEY=VALUE)')
+  .option('-o, --output <output>', 'build output directory', 'dist')
+  .option('-c, --cwd <cwd>', 'specify the working directory', '.')
+  .option('--prod', 'deploy to production', false)
+  .action(function doDeploy(command) {
+    var options = command?.opts?.() || {};
+    if (options.cwd) {
+      process.chdir(options.cwd);
+    }
+
+    // 处理环境变量
+    const env = {};
+    if (options.env) {
+      options.env.forEach(item => {
+        const [key, value] = item.split('=');
+        if (key && value) {
+          env[key] = value;
+        }
+      });
+    }
+
+    // 转换配置格式
+    const deployConfig = {
+      projectId: options.projectId,
+      token: options.token,
+      name: options.projectName,
+      target: options.prod ? 'production' : 'preview',
+      outputDir: options.output,
+      env
+    };
+
+    require('../dist/index.js')
+      .deployToVercel(deployConfig)
+      .then((retCode) => {
+        process.exit(retCode);
+      });
+  });
+
+// 解析命令行参数
 program.parse(process.argv);