@lark-apaas/fullstack-cli 1.1.21 → 1.1.22-alpha.1

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

@@ -481,6 +481,7 @@ var replaceUnknownTransform = {
   transform(ctx) {
     const { sourceFile, stats } = ctx;
     const fullText = sourceFile.getFullText();
+    const replacements = [];
     sourceFile.forEachDescendant((node) => {
       if (!Node5.isCallExpression(node)) {
         return;
@@ -511,13 +512,23 @@ var replaceUnknownTransform = {
           break;
         }
       }
+      replacements.push({
+        expression,
+        factoryName,
+        foundKnownType,
+        isArrayType,
+        node
+      });
+    });
+    for (const { expression, factoryName, foundKnownType, isArrayType, node } of replacements) {
       expression.replaceWithText(factoryName);
       if (isArrayType && foundKnownType) {
         const parent = node.getParent();
         if (Node5.isPropertyAccessExpression(parent) && parent.getName() === "array") {
           const grandParent = parent.getParent();
           if (Node5.isCallExpression(grandParent)) {
-            grandParent.replaceWithText(node.getText());
+            const nodeText = node.getText();
+            grandParent.replaceWithText(nodeText);
           }
         }
       }
@@ -526,7 +537,7 @@ var replaceUnknownTransform = {
       } else {
         stats.fallbackToText++;
       }
-    });
+    }
     const todoCommentRegex = /\/\/ TODO: failed to parse database type '[^']+'\s*\n/g;
     const currentText = sourceFile.getFullText();
     const cleanedText = currentText.replace(todoCommentRegex, "");
@@ -2604,6 +2615,42 @@ function getHttpClient() {
   return clientInstance;
 }
 
+// src/utils/telemetry.ts
+async function reportEvents(events) {
+  if (events.length === 0) {
+    return true;
+  }
+  try {
+    const client = getHttpClient();
+    const response = await client.post("/resource_events", {
+      body: JSON.stringify({ events })
+    });
+    if (!response.ok) {
+      console.warn(`[telemetry] Failed to report events: ${response.status} ${response.statusText}`);
+      return false;
+    }
+    const result = await response.json();
+    if (result.status_code !== "0") {
+      console.warn(`[telemetry] API error: ${result.message}`);
+      return false;
+    }
+    return true;
+  } catch (error) {
+    console.warn(`[telemetry] Failed to report events: ${error instanceof Error ? error.message : error}`);
+    return false;
+  }
+}
+async function reportInstallEvent(pluginKey, version) {
+  await reportEvents([
+    {
+      resourceType: "plugin",
+      resourceKey: pluginKey,
+      eventType: "install",
+      details: { version }
+    }
+  ]);
+}
+
 // src/commands/action-plugin/api-client.ts
 var PLUGIN_CACHE_DIR = "node_modules/.cache/fullstack-cli/plugins";
 async function getPluginVersions(keys, latestOnly = true) {
@@ -2927,6 +2974,8 @@ async function installOne(nameWithVersion) {
     writeActionPlugins(plugins);
     const source = fromCache ? "from cache" : "downloaded";
     console.log(`[action-plugin] Successfully installed ${name}@${installedVersion} (${source})`);
+    reportInstallEvent(name, installedVersion).catch(() => {
+    });
     return { name, version: installedVersion, success: true };
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);
@@ -6491,6 +6540,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,
@@ -6499,7 +6623,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.21",
+  "version": "1.1.22-alpha.1",
   "description": "CLI tool for fullstack template management",
   "type": "module",
   "main": "dist/index.js",