@lark-apaas/miaoda-cli 0.1.0-alpha.36c401b → 0.1.0-alpha.8825a76

package/dist/api/db/_debug_trace.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traceRequest = traceRequest;
+exports.traceResponse = traceResponse;
+/**
+ * ⚠️ TODO(REMOVE-BEFORE-RELEASE): 调试用 HTTP trace。
+ *
+ * 仅在 `--verbose` 下把 db 域 admin-inner 请求的 URL 与后端 logid 打到 stderr，
+ * 方便联调时把 logid 贴给后端查链路。正式版本前请整文件删除，并把
+ * `src/api/db/{api,client}.ts` 里的 `traceRequest()` / `traceResponse()` 调用一并移除。
+ */
+const logger_1 = require("../../utils/logger");
+/** 请求前打 method + 完整 URL（不含敏感 header）。 */
+function traceRequest(method, url) {
+    (0, logger_1.debug)(`http → ${method} ${url}`);
+}
+/** 响应后打 status + x-tt-logid（后端追踪 ID）。 */
+function traceResponse(method, url, status, headers) {
+    const logId = headers?.get("x-tt-logid") ?? headers?.get("X-Tt-Logid") ?? "(none)";
+    (0, logger_1.debug)(`http ← ${method} ${url} status=${String(status)} x-tt-logid=${logId}`);
+}

package/dist/api/db/api.js

@@ -5,6 +5,8 @@ exports.getSchema = getSchema;
 exports.importData = importData;
 exports.exportData = exportData;
 const http_1 = require("../../utils/http");
+// TODO(REMOVE-BEFORE-RELEASE): debug-only HTTP trace（详见 _debug_trace.ts）
+const _debug_trace_1 = require("./_debug_trace");
 const error_1 = require("../../utils/error");
 const client_1 = require("./client");
 // CLI 不再为 dbBranch 设默认值：
@@ -24,7 +26,9 @@ async function execSql(opts) {
     const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/sql", {
         dbBranch: opts.dbBranch,
     });
+    (0, _debug_trace_1.traceRequest)("POST", url);
     const response = await client.post(url, { sql: opts.sql });
+    (0, _debug_trace_1.traceResponse)("POST", url, response.status, response.headers);
     if (!response.ok) {
         // 4xx / 5xx：尝试解析 body 取 status_code 映射业务错误
         let body = null;
@@ -57,7 +61,9 @@ async function getSchema(opts) {
         includeStats: opts.includeStats ? "true" : undefined,
         dbBranch: opts.dbBranch,
     });
+    (0, _debug_trace_1.traceRequest)("GET", url);
     const response = await client.get(url);
+    (0, _debug_trace_1.traceResponse)("GET", url, response.status, response.headers);
     if (!response.ok) {
         let body = null;
         try {
@@ -89,12 +95,14 @@ async function importData(opts) {
     });
     const contentType = opts.format === "csv" ? "text/csv" : "application/json";
     const ab = opts.body.buffer.slice(opts.body.byteOffset, opts.body.byteOffset + opts.body.byteLength);
+    (0, _debug_trace_1.traceRequest)("POST", url);
     const response = await client.request({
         method: "POST",
         url,
         headers: { "Content-Type": contentType },
         body: ab,
     });
+    (0, _debug_trace_1.traceResponse)("POST", url, response.status, response.headers);
     if (!response.ok) {
         let body = null;
         try {
@@ -131,7 +139,9 @@ async function exportData(opts) {
         dbBranch: opts.dbBranch,
     });
     const reqBody = { limit: opts.limit ?? 5000 };
+    (0, _debug_trace_1.traceRequest)("POST", url);
     const response = await client.post(url, reqBody);
+    (0, _debug_trace_1.traceResponse)("POST", url, response.status, response.headers);
     if (!response.ok) {
         // 错误路径：body 是 JSON envelope
         let body = null;

package/dist/api/file/_debug_trace.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.traceRequest = traceRequest;
+exports.traceResponse = traceResponse;
+/**
+ * ⚠️ TODO(REMOVE-BEFORE-RELEASE): 调试用 HTTP trace。
+ *
+ * 仅在 `--verbose` 下把 file 域请求的 URL 与后端 logid 打到 stderr，
+ * 方便联调时把 logid 贴给后端查链路。正式版本前请整文件删除，并把
+ * `src/api/file/client.ts` 里的 `traceRequest()` / `traceResponse()` 调用一并移除。
+ */
+const logger_1 = require("../../utils/logger");
+/** 请求前打 method + 完整 URL（不含敏感 header）。 */
+function traceRequest(method, url) {
+    (0, logger_1.debug)(`http → ${method} ${url}`);
+}
+/** 响应后打 status + x-tt-logid（后端追踪 ID）。 */
+function traceResponse(method, url, status, headers) {
+    const logId = headers?.get("x-tt-logid") ?? headers?.get("X-Tt-Logid") ?? "(none)";
+    (0, logger_1.debug)(`http ← ${method} ${url} status=${String(status)} x-tt-logid=${logId}`);
+}

package/dist/api/file/client.js

@@ -8,6 +8,8 @@ exports.doPost = doPost;
 exports.doRequest = doRequest;
 const http_1 = require("../../utils/http");
 const error_1 = require("../../utils/error");
+// TODO(REMOVE-BEFORE-RELEASE): debug-only HTTP trace（详见 _debug_trace.ts）
+const _debug_trace_1 = require("./_debug_trace");
 const http_client_1 = require("@lark-apaas/http-client");
 /** 进程内 bucket 缓存：{appId: bucketId}。不跨进程。 */
 const bucketCache = new Map();
@@ -131,10 +133,15 @@ async function mapHttpError(err, opts) {
  */
 async function doGet(url, opts = {}, client = (0, http_1.getHttpClient)()) {
     try {
+        (0, _debug_trace_1.traceRequest)("GET", url);
         const response = await client.get(url);
+        (0, _debug_trace_1.traceResponse)("GET", url, response.status, response.headers);
         return (await response.json());
     }
     catch (err) {
+        if (err instanceof http_client_1.HttpError && err.response) {
+            (0, _debug_trace_1.traceResponse)("GET", url, err.response.status, err.response.headers);
+        }
         await mapHttpError(err, opts);
         throw err; // 不可达，mapHttpError 必定 throw
     }
@@ -142,10 +149,15 @@ async function doGet(url, opts = {}, client = (0, http_1.getHttpClient)()) {
 /** 包一层 client.post + HttpError 统一映射。默认 admin innerapi，可显式切 runtime。 */
 async function doPost(url, body, opts = {}, client = (0, http_1.getHttpClient)()) {
     try {
+        (0, _debug_trace_1.traceRequest)("POST", url);
         const response = await client.post(url, body);
+        (0, _debug_trace_1.traceResponse)("POST", url, response.status, response.headers);
         return (await response.json());
     }
     catch (err) {
+        if (err instanceof http_client_1.HttpError && err.response) {
+            (0, _debug_trace_1.traceResponse)("POST", url, err.response.status, err.response.headers);
+        }
         await mapHttpError(err, opts);
         throw err;
     }
@@ -153,10 +165,15 @@ async function doPost(url, body, opts = {}, client = (0, http_1.getHttpClient)()
 /** 包一层 client.request + HttpError 统一映射（DELETE 带 body 的场景）。 */
 async function doRequest(cfg, opts = {}, client = (0, http_1.getHttpClient)()) {
     try {
+        (0, _debug_trace_1.traceRequest)(cfg.method, cfg.url);
         const response = await client.request(cfg);
+        (0, _debug_trace_1.traceResponse)(cfg.method, cfg.url, response.status, response.headers);
         return (await response.json());
     }
     catch (err) {
+        if (err instanceof http_client_1.HttpError && err.response) {
+            (0, _debug_trace_1.traceResponse)(cfg.method, cfg.url, err.response.status, err.response.headers);
+        }
         await mapHttpError(err, opts);
         throw err;
     }

package/dist/cli/handlers/db/sql.js

@@ -114,7 +114,7 @@ function renderSingle(raw) {
             return;
         }
         const cols = collectColumns(parsed.rows);
-        const rows = parsed.rows.map((r) => cols.map((c) => formatCell(r[c])));
+        const rows = parsed.rows.map((r) => cols.map((c) => formatCell(r[c], tty)));
         (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(cols, rows) : (0, render_1.renderTsv)(cols, rows));
         return;
     }
@@ -155,9 +155,19 @@ function collectColumns(rows) {
         return [];
     return Object.keys(rows[0]);
 }
-function formatCell(v) {
-    if (v === null || v === undefined)
-        return "—";
+/**
+ * SQL 单元格 → 字符串：
+ * - null / undefined → "NULL"（TTY 下用 dim+gray ANSI 弱化，对齐 mysql/DuckDB；
+ *   non-TTY 用裸字面量，避免被 cat / 管道吞掉样式；JSON 模式不会走到这里，
+ *   走 toJson 直接用 parsed.rows，JSON.stringify 输出 `null` 字面）
+ * - string → 原样
+ * - number / boolean → toString
+ * - object / array → JSON.stringify
+ */
+function formatCell(v, tty) {
+    if (v === null || v === undefined) {
+        return tty ? "\u001b[2;90mNULL\u001b[0m" : "NULL";
+    }
     if (typeof v === "string")
         return v;
     if (typeof v === "number" || typeof v === "boolean")

package/dist/utils/render.js

@@ -14,6 +14,7 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.formatSize = formatSize;
 exports.formatTime = formatTime;
+exports.visibleWidth = visibleWidth;
 exports.renderAlignedTable = renderAlignedTable;
 exports.renderTsv = renderTsv;
 exports.renderKeyValue = renderKeyValue;
@@ -64,21 +65,35 @@ function formatTime(iso, isTty) {
     const da = String(date.getDate()).padStart(2, "0");
     return `${y}-${mo}-${da}`;
 }
-/** 渲染 TTY 对齐表格（多行，列宽按最长内容）。 */
+/**
+ * SGR (Select Graphic Rendition) ANSI 转义匹配：`ESC[<digits;...>m`。
+ * 用于在列宽计算时剥离不显示的控制字符——否则带 ANSI 颜色的 cell 会按 .length
+ * 算进列宽（比如 dim "NULL" 实际占 4 字符但 .length=11），导致表格对齐错位。
+ */
+const ANSI_SGR_RE = /\[[0-9;]*m/g;
+/** cell 可见字符宽度：剥离 ANSI 转义后再算长度。 */
+function visibleWidth(s) {
+    return s.replace(ANSI_SGR_RE, "").length;
+}
+function padVisibleEnd(s, targetWidth) {
+    const w = visibleWidth(s);
+    return w >= targetWidth ? s : s + " ".repeat(targetWidth - w);
+}
+/** 渲染 TTY 对齐表格（多行，列宽按最长内容；ANSI 转义不计入列宽）。 */
 function renderAlignedTable(headers, rows) {
     const colWidths = headers.map((h, i) => {
-        let w = h.length;
+        let w = visibleWidth(h);
         for (const row of rows) {
-            const cell = row[i] || "";
-            if (cell.length > w)
-                w = cell.length;
+            const cw = visibleWidth(row[i] || "");
+            if (cw > w)
+                w = cw;
         }
         return w;
     });
     const lines = [];
-    lines.push(headers.map((h, i) => h.padEnd(colWidths[i])).join("  ").trimEnd());
+    lines.push(headers.map((h, i) => padVisibleEnd(h, colWidths[i])).join("  ").trimEnd());
     for (const row of rows) {
-        lines.push(row.map((cell, i) => (cell || "").padEnd(colWidths[i])).join("  ").trimEnd());
+        lines.push(row.map((cell, i) => padVisibleEnd(cell || "", colWidths[i])).join("  ").trimEnd());
     }
     return lines.join("\n");
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@lark-apaas/miaoda-cli",
-  "version": "0.1.0-alpha.36c401b",
+  "version": "0.1.0-alpha.8825a76",
   "description": "Miaoda 平台命令行工具，面向 Agent 调用",
   "type": "commonjs",
   "bin": {