@lark-apaas/fullstack-cli 1.1.23 → 1.1.24

package/README.md

@@ -1,6 +1,6 @@
 # @lark-apaas/fullstack-cli
 
-> Fullstack 开发工具集 - 文件派生、数据库 Schema 生成、OpenAPI 生成、能力管理
+> Fullstack 开发工具集 - 文件派生、数据库 Schema 生成、OpenAPI 生成、能力管理、构建工具
 
 ## 功能
 
@@ -9,6 +9,7 @@
 3. **OpenAPI 生成** - 自动生成 API 文档和客户端 SDK
 4. **Action 插件管理** - 安装、更新、删除 action 插件
 5. **能力配置管理** - 查看、充血、迁移能力配置
+6. **构建工具** - 获取 STI 制品上传凭证等构建相关操作
 
 ## 安装
 
@@ -201,7 +202,40 @@ fullstack-cli capability migration --skip-code
 }
 ```
 
-### 7. CLI 命令
+### 7. 构建工具
+
+获取构建流程所需的 STI 制品上传凭证：
+
+```bash
+# Pipeline 发布场景 - 需要 commit-id
+fullstack-cli build get-token --app-id app_xxx --scene pipeline --commit-id abc123
+
+# 静态资源部署场景
+fullstack-cli build get-token --app-id app_xxx --scene static
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `--app-id <id>` | 是 | 应用 ID |
+| `--scene <scene>` | 是 | 构建场景（`pipeline`、`static`） |
+| `--commit-id <id>` | scene=pipeline 时必填 | Git Commit ID |
+
+**输出：** stdout 输出 API 返回的完整 JSON，日志/错误输出到 stderr，便于脚本解析：
+
+```bash
+token_response=$(fullstack-cli build get-token --app-id "$APP_ID" --scene pipeline --commit-id "$COMMIT_ID")
+credential=$(echo "$token_response" | jq -r '.data.accessKeyID')
+```
+
+**环境变量：**
+- `FORCE_AUTHN_INNERAPI_DOMAIN` — API 域名
+- `FORCE_AUTHN_ACCESS_KEY` — Access Key
+- `FORCE_AUTHN_ACCESS_SECRET` — Secret Key
+- `FORCE_FRAMEWORK_CLI_CANARY_ENV` — Canary 环境（可选）
+
+### 8. CLI 命令
 
 ```bash
 # 查看帮助
@@ -223,11 +257,15 @@ fullstack-cli capability --help
 fullstack-cli capability list
 fullstack-cli capability migration --dry-run
 
+# 构建工具
+fullstack-cli build --help
+fullstack-cli build get-token --app-id <id> --scene <scene> [--commit-id <id>]
+
 # 查看版本
 fullstack-cli --version
 ```
 
-### 8. 全局选项
+### 9. 全局选项
 
 #### Canary 环境
 

package/dist/index.js

@@ -6502,6 +6502,81 @@ var readLogsCommand = {
   }
 };
 
+// src/commands/build/types.ts
+var SCENE_CONFIGS = {
+  pipeline: {
+    name: "pipeline",
+    requiredOptions: ["commitId"],
+    buildRequestBody: (opts) => ({ commitID: opts.commitId })
+  },
+  static: {
+    name: "static",
+    requiredOptions: [],
+    buildRequestBody: () => ({ commitID: "" })
+  }
+};
+
+// src/commands/build/api-client.ts
+async function genArtifactUploadCredential(appId, body) {
+  const client = getHttpClient();
+  const url = `/v1/app/${appId}/pipeline/gen_artifact_upload_credential`;
+  const response = await client.post(url, body);
+  if (!response.ok || response.status !== 200) {
+    throw new Error(
+      `API request failed: ${response.status} ${response.statusText}`
+    );
+  }
+  return response.json();
+}
+
+// src/commands/build/get-token.handler.ts
+async function getToken(options) {
+  try {
+    const sceneConfig = SCENE_CONFIGS[options.scene];
+    if (!sceneConfig) {
+      const available = Object.keys(SCENE_CONFIGS).join(", ");
+      console.error(
+        `[build] Error: invalid scene "${options.scene}". Available scenes: ${available}`
+      );
+      process.exit(1);
+    }
+    for (const key of sceneConfig.requiredOptions) {
+      if (!options[key]) {
+        console.error(
+          `[build] Error: --${camelToKebab(key)} is required for scene "${options.scene}"`
+        );
+        process.exit(1);
+      }
+    }
+    const body = sceneConfig.buildRequestBody(options);
+    const response = await genArtifactUploadCredential(options.appId, body);
+    console.log(JSON.stringify(response));
+  } catch (error) {
+    const message = error instanceof Error ? error.message : String(error);
+    console.error(`[build] Error: ${message}`);
+    process.exit(1);
+  }
+}
+function camelToKebab(str) {
+  return str.replace(/([a-z])([A-Z])/g, "$1-$2").toLowerCase();
+}
+
+// src/commands/build/index.ts
+var getTokenCommand = {
+  name: "get-token",
+  description: "Get artifact upload credential (STI token)",
+  register(program) {
+    program.command(this.name).description(this.description).requiredOption("--app-id <id>", "Application ID").requiredOption("--scene <scene>", "Build scene (pipeline, static)").option("--commit-id <id>", "Git commit ID (required for pipeline scene)").action(async (options) => {
+      await getToken(options);
+    });
+  }
+};
+var buildCommandGroup = {
+  name: "build",
+  description: "Build related commands",
+  commands: [getTokenCommand]
+};
+
 // src/commands/index.ts
 var commands = [
   genDbSchemaCommand,
@@ -6510,7 +6585,8 @@ var commands = [
   capabilityCommandGroup,
   componentCommandGroup,
   migrationCommand,
-  readLogsCommand
+  readLogsCommand,
+  buildCommandGroup
 ];
 
 // src/index.ts

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/fullstack-cli",
-  "version": "1.1.23",
+  "version": "1.1.24",
   "description": "CLI tool for fullstack template management",
   "type": "module",
   "main": "dist/index.js",