@lark-apaas/miaoda-cli 0.1.1 → 0.1.2-alpha.b2b5ae5

package/dist/utils/colors.js

@@ -0,0 +1,98 @@
+"use strict";
+/**
+ * 终端彩色高亮的语义层封装。
+ *
+ * 三层结构（自上而下：稳定→灵活）：
+ *
+ *   1. **ColorAdapter**（公共契约）：6 个语义方法 string → string，业务代码
+ *      只接触这层，对底层库 0 感知。
+ *   2. **ColorFactory**（适配器签名）：`(useColor: boolean) => ColorAdapter`，
+ *      把"是否染色"参数化，便于按需构造。一个三方库对应一个 factory 实现。
+ *   3. **当前底层库实现**：picocolors（[picocolors npm](https://www.npmjs.com/package/picocolors)，~3KB）。
+ *      切换到 chalk / kleur 等只需新增一个 ColorFactory 实现，并改最下方的
+ *      `factory =` 一行赋值，业务代码与 ColorAdapter contract 0 改动。
+ *
+ * # 色谱（对齐 spec）
+ *
+ *   - header     表头 / 命令名 / key 标签：bold + cyan
+ *   - highlight  强调值（表名等）：cyan
+ *   - success    ✓ Uploaded / ✓ Deleted：green
+ *   - fail       ✗ / Error:：red
+ *   - warn       ⚠ Approaching quota：yellow
+ *   - muted      NULL / 辅助 hint / 次要信息：dim + gray
+ *
+ * # 染色判定（NO_COLOR / FORCE_COLOR / TTY，[no-color.org](https://no-color.org/) 业界标准）
+ *
+ *   - `NO_COLOR=1`            强制关颜色（任何非空值生效）
+ *   - `FORCE_COLOR=1`         强制开颜色（管道 / CI 场景）
+ *   - 否则按 `process.stdout.isTTY` 判定
+ *
+ * 每次调用 `c.xxx(s)` 时按当前状态实时构造 adapter——避免模块加载时缓存的
+ * `process.stdout.isTTY` 与测试 / pipe 切换脱节。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.c = void 0;
+exports.shouldColorize = shouldColorize;
+const picocolors_1 = require("picocolors");
+// ──────────────────────────────────────────────────────────────────────
+// 2. 库无关的染色判定：哪个 factory 都能复用
+// ──────────────────────────────────────────────────────────────────────
+/**
+ * 当前是否应当染色。读取的是**调用时**的状态，而非模块加载时缓存——
+ * 测试经常 `Object.defineProperty(process.stdout, "isTTY", ...)` 实时切换，
+ * 这里直接每次问 process。
+ *
+ * 优先级：FORCE_COLOR > NO_COLOR > TTY。
+ */
+function shouldColorize() {
+    const env = process.env;
+    const noColor = env.NO_COLOR != null && env.NO_COLOR !== "";
+    const forceColor = env.FORCE_COLOR != null && env.FORCE_COLOR !== "";
+    const isTTY = process.stdout.isTTY === true;
+    return forceColor || (!noColor && isTTY);
+}
+/** picocolors 实现：当前生产用 factory。~3KB，业界 CLI 标准之一。 */
+const picocolorsFactory = (useColor) => {
+    const x = (0, picocolors_1.createColors)(useColor);
+    return {
+        header: (s) => x.bold(x.cyan(s)),
+        highlight: (s) => x.cyan(s),
+        success: (s) => x.green(s),
+        fail: (s) => x.red(s),
+        warn: (s) => x.yellow(s),
+        muted: (s) => x.dim(x.gray(s)),
+    };
+};
+// ──────────────────────────────────────────────────────────────────────
+// 4. 唯一切换点：换库改这一行（其它都不用动）
+// ──────────────────────────────────────────────────────────────────────
+//
+// 切换示例：
+//
+//   import chalk, { Chalk } from "chalk";
+//   const chalkFactory: ColorFactory = (useColor) => {
+//     const k = new Chalk({ level: useColor ? 1 : 0 });
+//     return {
+//       header:    (s) => k.bold.cyan(s),
+//       highlight: (s) => k.cyan(s),
+//       success:   (s) => k.green(s),
+//       fail:      (s) => k.red(s),
+//       warn:      (s) => k.yellow(s),
+//       muted:     (s) => k.dim.gray(s),
+//     };
+//   };
+//   const factory: ColorFactory = chalkFactory;   // ← 改这里
+//
+const factory = picocolorsFactory;
+// ──────────────────────────────────────────────────────────────────────
+// 5. 公共出口：业务代码 import { c } from "../utils/colors"
+// ──────────────────────────────────────────────────────────────────────
+/** 语义染色器：业务代码唯一接触的对象。底层库切换 0 感知。 */
+exports.c = {
+    header: (s) => factory(shouldColorize()).header(s),
+    highlight: (s) => factory(shouldColorize()).highlight(s),
+    success: (s) => factory(shouldColorize()).success(s),
+    fail: (s) => factory(shouldColorize()).fail(s),
+    warn: (s) => factory(shouldColorize()).warn(s),
+    muted: (s) => factory(shouldColorize()).muted(s),
+};

package/dist/utils/devops-error.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapDevopsError = mapDevopsError;
+const error_1 = require("./error");
+/**
+ * 把 BAM lark.apaas.devops 的业务码（数字字符串）映射成 CLI 错误码。
+ * 来源：服务端技术方案 wiki L7P8wlNQ5iyShLkxzlOcCo8LnTg「业务错误码映射表」。
+ *
+ * 放在 utils 下而不是某个具体 api 域里：app / deploy 都跑在 lark.apaas.devops
+ * 这同一 PSM，业务码命名空间也共享；boundaries 规则又禁止 api 域间互引。
+ */
+function mapDevopsError(bizCode, message) {
+    switch (bizCode) {
+        case "400002577":
+        case "400002569":
+            return new error_1.AppError("APP_NOT_FOUND", message, {
+                next_actions: ["Run `miaoda app list` to see available apps"],
+            });
+        case "400002579":
+            return new error_1.AppError("APP_PERMISSION_DENIED", message);
+        case "400002575":
+            return new error_1.AppError("INVALID_ARG_VALUE", message, {
+                next_actions: ["缩短 --name / --description 后重试（后端有长度限制）"],
+            });
+        default:
+            return undefined;
+    }
+}

package/dist/utils/error.js

@@ -6,6 +6,14 @@ class AppError extends Error {
     retryable;
     next_actions;
     statement_index;
+    total_statements;
+    /**
+     * 多语句失败时由 api.db.execSql 透传服务端 results（已成功的 statement 原始结构）。
+     * 由 db sql handler 转成 PRD 友好的 `completed` 数组 + 推断 `rolled_back` 后挂回到本对象。
+     */
+    partial_results;
+    completed;
+    rolled_back;
     constructor(code, message, opts) {
         super(message);
         this.name = "AppError";
@@ -21,6 +29,9 @@ class AppError extends Error {
             retryable: this.retryable,
             next_actions: this.next_actions,
             statement_index: this.statement_index,
+            total_statements: this.total_statements,
+            completed: this.completed,
+            rolled_back: this.rolled_back,
         };
     }
 }

package/dist/utils/fuzzy-match.js

@@ -0,0 +1,91 @@
+"use strict";
+/**
+ * 模糊匹配：基于 Levenshtein 编辑距离的"did-you-mean"建议器。
+ *
+ * 用于 CLI 错误路径的拼写纠错提示——当用户输入的 token（关键字 / 表名 / 列名）
+ * 与某个有效候选词"接近"时，给出 "Did you mean X?" 类的 hint。
+ *
+ * # 设计取舍
+ *
+ *   - **算法**：Damerau-Levenshtein DP（在标准 Levenshtein 基础上把"相邻字符
+ *     交换"算 1 步编辑——SQL 用户最常见的拼写错误就是 FORM/FROM、SELCT/SELECT
+ *     这类 transposition；纯 Levenshtein 把它们算 2 步会过严，触发不到 hint）。
+ *     约 30 行二维 DP 实现，不引第三方库；业界 CLI 拼写纠错事实标准。
+ *   - **大小写不敏感**：CLI 用户混用 SELECT / select 是常态，统一 lowercase 比较
+ *   - **阈值按候选词长度自适应**：避免短词过度匹配（"id" 不应该建议成 "in"）
+ *       len ≤ 4：max 1 编辑（短词严）
+ *       len 5-8：max 2 编辑
+ *       len ≥ 9：max 3 编辑（长词宽）
+ *   - **同分多候选**：返第一个；调用方负责候选词列表的稳定排序
+ *   - **找不到不强凑**：阈值外返 null，不"硬贴"无关建议
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.levenshtein = levenshtein;
+exports.suggest = suggest;
+/**
+ * 计算两个字符串的 Damerau-Levenshtein 编辑距离（不区分大小写）。
+ *
+ * 在标准 Levenshtein（增 / 删 / 替换）基础上加"相邻字符交换"作为单步编辑。
+ * 二维 DP 实现（transposition 需要回看 dp[i-2][j-2]，所以不再用单行优化）。
+ * 候选词通常 < 30 字符，二维 DP 的常数空间开销可忽略。
+ */
+function levenshtein(a, b) {
+    const aa = a.toLowerCase();
+    const bb = b.toLowerCase();
+    const m = aa.length;
+    const n = bb.length;
+    if (m === 0)
+        return n;
+    if (n === 0)
+        return m;
+    const dp = Array.from({ length: m + 1 }, () => new Array(n + 1).fill(0));
+    for (let i = 0; i <= m; i++)
+        dp[i][0] = i;
+    for (let j = 0; j <= n; j++)
+        dp[0][j] = j;
+    for (let i = 1; i <= m; i++) {
+        for (let j = 1; j <= n; j++) {
+            const cost = aa[i - 1] === bb[j - 1] ? 0 : 1;
+            dp[i][j] = Math.min(dp[i - 1][j] + 1, // 删除
+            dp[i][j - 1] + 1, // 插入
+            dp[i - 1][j - 1] + cost);
+            // transposition: 当前字符 = 对方前一字符 && 我方前一字符 = 对方当前字符
+            // 例：aa="form", bb="from"，i=2,j=2 时 aa[1]=o=bb[0]=f? 不命中；i=3,j=3
+            // 时 aa[2]=r=bb[1]=r? bb[2]=o, aa[1]=o → 命中 → dp[3][3] = dp[1][1] + 1 = 1
+            if (i > 1 && j > 1 && aa[i - 1] === bb[j - 2] && aa[i - 2] === bb[j - 1]) {
+                dp[i][j] = Math.min(dp[i][j], dp[i - 2][j - 2] + 1);
+            }
+        }
+    }
+    return dp[m][n];
+}
+/** 默认阈值：候选词越短匹配越严，越长越宽。避免 "id" 错配 "in" 这种 false positive。 */
+function defaultThreshold(len) {
+    if (len <= 4)
+        return 1;
+    if (len <= 8)
+        return 2;
+    return 3;
+}
+/**
+ * 在候选词列表里找与 input 最相近的一个。
+ *
+ * 距离 ≤ 阈值时按"距离最小"返回；多个候选词相同距离时返"列表中最先出现"的；
+ * 阈值外没有命中返 null（调用方按 null 静默不加 hint，不要强凑）。
+ */
+function suggest(input, candidates, opts) {
+    if (!input || candidates.length === 0)
+        return null;
+    const threshold = opts?.maxDistance ?? defaultThreshold;
+    let best = null;
+    let bestDist = Number.POSITIVE_INFINITY;
+    for (const cand of candidates) {
+        const d = levenshtein(input, cand);
+        const limit = threshold(cand.length);
+        if (d <= limit && d < bestDist) {
+            best = cand;
+            bestDist = d;
+        }
+    }
+    return best;
+}

package/dist/utils/git.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCurrentGitBranch = getCurrentGitBranch;
+const node_child_process_1 = require("node:child_process");
+/**
+ * 读取 cwd 所在仓库的当前分支名。
+ *
+ * 不在 git 仓库、git 不可用、或处于 detached HEAD 时返回 undefined，
+ * 让调用方决定回退策略（如交给后端使用应用默认分支）。
+ */
+function getCurrentGitBranch(cwd = process.cwd()) {
+    let result;
+    try {
+        result = (0, node_child_process_1.spawnSync)("git", ["rev-parse", "--abbrev-ref", "HEAD"], {
+            cwd,
+            encoding: "utf8",
+            stdio: ["ignore", "pipe", "ignore"],
+        });
+    }
+    catch {
+        return undefined;
+    }
+    if (result.status !== 0)
+        return undefined;
+    const branch = result.stdout.trim();
+    if (!branch || branch === "HEAD")
+        return undefined;
+    return branch;
+}

package/dist/utils/http.js

@@ -6,7 +6,10 @@ exports.resetHttpClient = resetHttpClient;
 exports.setHttpClient = setHttpClient;
 exports.setRuntimeHttpClient = setRuntimeHttpClient;
 exports.applyCanaryHeader = applyCanaryHeader;
+exports.postInnerApi = postInnerApi;
+exports.getInnerApi = getInnerApi;
 const http_client_1 = require("@lark-apaas/http-client");
+const error_1 = require("./error");
 let adminClient;
 let runtimeClient;
 /**
@@ -65,3 +68,32 @@ function applyCanaryHeader(reqConfig) {
     reqConfig.headers = headers;
     return reqConfig;
 }
+/** 走管理端 innerapi 的 POST + 信封解析 */
+async function postInnerApi(url, body, opts) {
+    return handleInnerEnvelope(await getHttpClient().post(url, body), url, opts);
+}
+/** 走管理端 innerapi 的 GET + 信封解析 */
+async function getInnerApi(url, opts) {
+    return handleInnerEnvelope(await getHttpClient().get(url), url, opts);
+}
+async function handleInnerEnvelope(response, url, opts) {
+    if (!response.ok) {
+        throw new error_1.HttpError(response.status, url, `${opts.errPrefix}: ${String(response.status)} ${response.statusText}`);
+    }
+    const result = await response.json();
+    if (typeof result === "object" && result !== null && "status_code" in result) {
+        const env = result;
+        if (env.status_code !== undefined && env.status_code !== "0") {
+            const msg = env.message ?? env.error_msg ?? "unknown error";
+            const mapped = opts.mapErr?.(env.status_code, msg);
+            if (mapped)
+                throw mapped;
+            throw new error_1.AppError(opts.defaultErrCode ?? "INTERNAL_API_ERROR", `${opts.errPrefix}: ${msg}`);
+        }
+        // status_code = "0"：data 存在则解封；否则 envelope 自身就是业务体
+        if (env.data)
+            return env.data;
+        return result;
+    }
+    return result;
+}

package/dist/utils/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.setRuntimeHttpClient = exports.setHttpClient = exports.resetHttpClient = exports.getRuntimeHttpClient = exports.getHttpClient = exports.log = exports.debug = exports.isJsonMode = exports.emitError = exports.emit = exports.getLogId = exports.generateLogId = exports.initConfigFromOpts = exports.resetConfig = exports.setConfig = exports.getConfig = exports.HttpError = exports.AppError = void 0;
+exports.msToSec = exports.msToNs = exports.parseToSec = exports.parseToNs = exports.parseToMs = exports.parseTimeToMs = exports.getInnerApi = exports.postInnerApi = exports.setRuntimeHttpClient = exports.setHttpClient = exports.resetHttpClient = exports.getRuntimeHttpClient = exports.getHttpClient = exports.log = exports.debug = exports.fmt = exports.isJsonMode = exports.emitPaged = exports.emitOk = exports.emitError = exports.emit = exports.getLogId = exports.generateLogId = exports.initConfigFromOpts = exports.resetConfig = exports.setConfig = exports.getConfig = exports.HttpError = exports.AppError = void 0;
 var error_1 = require("./error");
 Object.defineProperty(exports, "AppError", { enumerable: true, get: function () { return error_1.AppError; } });
 Object.defineProperty(exports, "HttpError", { enumerable: true, get: function () { return error_1.HttpError; } });
@@ -15,7 +15,10 @@ Object.defineProperty(exports, "getLogId", { enumerable: true, get: function ()
 var output_1 = require("./output");
 Object.defineProperty(exports, "emit", { enumerable: true, get: function () { return output_1.emit; } });
 Object.defineProperty(exports, "emitError", { enumerable: true, get: function () { return output_1.emitError; } });
+Object.defineProperty(exports, "emitOk", { enumerable: true, get: function () { return output_1.emitOk; } });
+Object.defineProperty(exports, "emitPaged", { enumerable: true, get: function () { return output_1.emitPaged; } });
 Object.defineProperty(exports, "isJsonMode", { enumerable: true, get: function () { return output_1.isJsonMode; } });
+Object.defineProperty(exports, "fmt", { enumerable: true, get: function () { return output_1.fmt; } });
 var logger_1 = require("./logger");
 Object.defineProperty(exports, "debug", { enumerable: true, get: function () { return logger_1.debug; } });
 Object.defineProperty(exports, "log", { enumerable: true, get: function () { return logger_1.log; } });
@@ -25,3 +28,12 @@ Object.defineProperty(exports, "getRuntimeHttpClient", { enumerable: true, get:
 Object.defineProperty(exports, "resetHttpClient", { enumerable: true, get: function () { return http_1.resetHttpClient; } });
 Object.defineProperty(exports, "setHttpClient", { enumerable: true, get: function () { return http_1.setHttpClient; } });
 Object.defineProperty(exports, "setRuntimeHttpClient", { enumerable: true, get: function () { return http_1.setRuntimeHttpClient; } });
+Object.defineProperty(exports, "postInnerApi", { enumerable: true, get: function () { return http_1.postInnerApi; } });
+Object.defineProperty(exports, "getInnerApi", { enumerable: true, get: function () { return http_1.getInnerApi; } });
+var time_1 = require("./time");
+Object.defineProperty(exports, "parseTimeToMs", { enumerable: true, get: function () { return time_1.parseTimeToMs; } });
+Object.defineProperty(exports, "parseToMs", { enumerable: true, get: function () { return time_1.parseToMs; } });
+Object.defineProperty(exports, "parseToNs", { enumerable: true, get: function () { return time_1.parseToNs; } });
+Object.defineProperty(exports, "parseToSec", { enumerable: true, get: function () { return time_1.parseToSec; } });
+Object.defineProperty(exports, "msToNs", { enumerable: true, get: function () { return time_1.msToNs; } });
+Object.defineProperty(exports, "msToSec", { enumerable: true, get: function () { return time_1.msToSec; } });