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

package/dist/api/db/api.js

@@ -4,6 +4,12 @@ exports.execSql = execSql;
 exports.getSchema = getSchema;
 exports.importData = importData;
 exports.exportData = exportData;
+exports.listDDLChangelog = listDDLChangelog;
+exports.setAuditConfig = setAuditConfig;
+exports.migrationInit = migrationInit;
+exports.migrate = migrate;
+exports.recover = recover;
+exports.getDbQuota = getDbQuota;
 const http_1 = require("../../utils/http");
 const error_1 = require("../../utils/error");
 const http_client_1 = require("@lark-apaas/http-client");
@@ -16,7 +22,13 @@ const client_1 = require("./client");
  * 配合调用点的 try/catch + traceHttp，让 --verbose 在错误路径上也能拿到
  * x-tt-logid 与 status，方便定位线上问题。
  */
-async function mapDbHttpError(err, url, ctx) {
+async function mapDbHttpError(err, url, ctx, 
+/**
+ * 可选 hook：解析到响应 body 后，如果 envelope 命中业务错误并抛出 AppError，
+ * 调用方可以借此把 body 里的额外字段（如 multi-statement 的 partial results）
+ * 挂到 AppError 上。
+ */
+onErrorBody) {
     if (err instanceof error_1.AppError)
         throw err;
     if (err instanceof http_client_1.HttpError) {
@@ -24,8 +36,17 @@ async function mapDbHttpError(err, url, ctx) {
         const statusText = err.response?.statusText ?? "";
         try {
             const body = (await err.response?.json());
-            if (body)
-                (0, client_1.extractData)(body); // 业务 code 命中 → 抛 AppError；不命中走兜底
+            if (body) {
+                try {
+                    (0, client_1.extractData)(body); // 业务 code 命中 → 抛 AppError；不命中走兜底
+                }
+                catch (appErr) {
+                    if (appErr instanceof error_1.AppError && onErrorBody) {
+                        onErrorBody(body, appErr);
+                    }
+                    throw appErr;
+                }
+            }
         }
         catch (innerErr) {
             if (innerErr instanceof error_1.AppError)
@@ -36,6 +57,20 @@ async function mapDbHttpError(err, url, ctx) {
     }
     throw err;
 }
+/**
+ * 多语句 SQL 失败时把已成功 statement 的 results 挂到 AppError.partial_results 上，
+ * 供上层 handler 构造 PRD 要求的 `completed` 数组。
+ *
+ * 注意参数顺序：(body, appErr) — 与 mapDbHttpError 的 onErrorBody hook 签名对齐。
+ */
+function attachSqlPartialResults(body, appErr) {
+    const data = body.data;
+    if (!data)
+        return;
+    if (!Array.isArray(data.results) || data.results.length === 0)
+        return;
+    appErr.partial_results = data.results;
+}
 // CLI 不再为 dbBranch 设默认值：
 // 用户没传 --env 就完全不携带 dbBranch query 参数，由后端 admin-inner 中间件
 // 按 workspace 多环境状态决定（多环境 → dev / 单环境 → main）。
@@ -61,12 +96,60 @@ async function execSql(opts) {
     }
     catch (err) {
         (0, client_1.traceHttp)("POST", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
-        await mapDbHttpError(err, url, "Failed to execute SQL");
+        await mapDbHttpError(err, url, "Failed to execute SQL", attachSqlPartialResults);
         throw err; // 不可达
     }
     const body = (await response.json());
-    const data = (0, client_1.extractData)(body);
-    return data.results ?? [];
+    try {
+        const data = (0, client_1.extractData)(body);
+        const results = data.results ?? [];
+        // 新协议（dataloom 端 InnerAdminExecuteSQL 错误统一走 success envelope）：
+        // results 末尾追加一条 SqlType="ERROR" 的哨兵，data 字段是 {code,message} JSON。
+        // 这样网关在错误路径不会吞业务字段，CLI 拿到完整 partial_results + statement_index。
+        const last = results.at(-1);
+        if (last?.sqlType === "ERROR") {
+            const appErr = parseSqlErrorSentinel(last.data);
+            appErr.partial_results = results.slice(0, -1);
+            const stmtIdx = data.errorStatementIndex;
+            if (typeof stmtIdx === "number")
+                appErr.statement_index = stmtIdx;
+            throw appErr;
+        }
+        return results;
+    }
+    catch (appErr) {
+        // 旧协议兼容（dataloom 服务端未部署新协议时）：HTTP 2xx 但 envelope status_code != 0
+        // 走 mapDbHttpError → AppError，partial_results 已被网关吞，仅保留 code+message。
+        //
+        // 新协议下上面的 try 块里已经手动 slice 设置了 partial_results（剥离了 ERROR 哨兵），
+        // 这里必须跳过 attach，否则会被 body.data.results 完整数组（含哨兵）覆盖回去。
+        if (appErr instanceof error_1.AppError && appErr.partial_results === undefined) {
+            attachSqlPartialResults(body, appErr);
+        }
+        throw appErr;
+    }
+}
+/**
+ * 解析 InnerAdminExecuteSQL 错误哨兵（results 末尾那条 SqlType="ERROR" 项）的 data 字段。
+ * 服务端约定：data 是 `{"code":"k_dl_xxx","message":"..."}` 形态的 JSON 字符串。
+ *
+ * 拿到 code+message 后复用 mapDataloomBizError 走与旧协议（ensureInnerSuccess）
+ * 完全一致的映射规则——k_dl_1300015 → RESULT_SET_TOO_LARGE、SQLSTATE 透传等
+ * hint / 语义 code 重写不能丢。否则新协议下 SERVER_ERROR_HINTS 会因为 code key
+ * 不匹配而 miss，CLI 用户看不到 LIMIT 引导这种关键 hint。
+ *
+ * 解析失败则降级为 INTERNAL_DB_ERROR + 原始字符串，避免哨兵格式异常时整条调用炸掉。
+ */
+function parseSqlErrorSentinel(payload) {
+    try {
+        const parsed = JSON.parse(payload);
+        const code = typeof parsed.code === "string" && parsed.code !== "" ? parsed.code : "INTERNAL_DB_ERROR";
+        const message = typeof parsed.message === "string" ? parsed.message : payload;
+        return (0, client_1.mapDataloomBizError)(code, message);
+    }
+    catch {
+        return new error_1.AppError("INTERNAL_DB_ERROR", payload);
+    }
 }
 // ── db schema → InnerGetSchema ──
 /**
@@ -170,10 +253,14 @@ async function exportData(opts) {
         await mapDbHttpError(err, url, "Failed to export data");
         throw err; // 不可达
     }
-    // 成功路径：响应 body 通常是原始 CSV/JSON 字节，但部分错误场景下网关会返
+    // 成功路径：响应 body 通常是原始 CSV/SQL/JSON 字节，但部分错误场景下网关会返
     // HTTP 200 + JSON envelope（status_code != "0"），需要在这里嗅探兜底。
-    const contentType = response.headers.get("Content-Type") ??
-        (opts.format === "csv" ? "text/csv" : "application/json");
+    const defaultContentType = {
+        csv: "text/csv",
+        sql: "text/plain",
+        json: "application/json",
+    };
+    const contentType = response.headers.get("Content-Type") ?? defaultContentType[opts.format];
     const ab = await response.arrayBuffer();
     const buf = Buffer.from(new Uint8Array(ab));
     if (buf.length === 0) {
@@ -181,8 +268,9 @@ async function exportData(opts) {
     }
     // Envelope sniff：HTTP 200 + Content-Type 为 application/json + body 解析得到
     // InnerEnvelope 且 status_code 非 "0" 时，按业务错误抛出。
-    // 仅 CSV 格式做 sniff —— JSON 格式正常成功响应也是 application/json，会误判。
-    if (opts.format === "csv" && /application\/json/i.test(contentType)) {
+    // CSV / SQL 都是非 JSON 输出，application/json 响应必是错误信封；JSON 格式
+    // 成功响应自身就是 application/json，跳过 sniff 避免误判。
+    if (opts.format !== "json" && /application\/json/i.test(contentType)) {
         try {
             const parsed = JSON.parse(buf.toString("utf8"));
             if (parsed.status_code != null && parsed.status_code !== "0") {
@@ -192,7 +280,7 @@ async function exportData(opts) {
         }
         catch (err) {
             // 已经被 extractData 抛成 AppError → 透传；否则 JSON.parse 失败说明 body
-            // 真的是 CSV 文本，继续按成功流程走
+            // 真的是 CSV / SQL 文本，继续按成功流程走
             if (err instanceof error_1.AppError)
                 throw err;
         }
@@ -209,3 +297,167 @@ async function exportData(opts) {
         recordCount,
     };
 }
+// ── db changelog → InnerAdminListDDLChangelog ──
+/**
+ * 后端：GET /v1/dataloom/app/{appId}/db/changelog?table=&since=&until=&limit=&cursor=&dbBranch=
+ *
+ * 时间字段 since/until 由 CLI 端归一化为 ISO 8601 UTC 后透传；后端按 created_at 比较。
+ */
+async function listDDLChangelog(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/changelog", {
+        table: opts.table,
+        since: opts.since,
+        until: opts.until,
+        limit: opts.limit !== undefined ? String(opts.limit) : undefined,
+        cursor: opts.cursor,
+        dbBranch: opts.dbBranch,
+    });
+    const start = Date.now();
+    let response;
+    try {
+        response = await client.get(url);
+        (0, client_1.traceHttp)("GET", url, start, response);
+    }
+    catch (err) {
+        (0, client_1.traceHttp)("GET", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, "Failed to list DDL changelog");
+        throw err; // 不可达
+    }
+    const body = (await response.json());
+    const data = (0, client_1.extractData)(body);
+    return {
+        items: data.items ?? [],
+        nextCursor: data.nextCursor && data.nextCursor !== "" ? data.nextCursor : null,
+        hasMore: Boolean(data.hasMore),
+    };
+}
+// ── db audit → InnerAdminSetAuditConfig ──
+/**
+ * 后端：POST /v1/dataloom/app/{appId}/db/audit/config
+ * 写：enabled=true 开启 / false 关闭。retention 仅 enabled=true 生效。
+ *
+ * 读路径（status / log）不在此模块——CLI handler 走 execSql 直接 SELECT
+ * `_dl_audit_config` / `_dl_audit_log` 元数据表。
+ */
+async function setAuditConfig(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/audit/config");
+    const body = {
+        table: opts.table,
+        enabled: opts.enabled,
+    };
+    if (opts.retention !== undefined && opts.retention !== "")
+        body.retention = opts.retention;
+    if (opts.dbBranch !== undefined && opts.dbBranch !== "")
+        body.dbBranch = opts.dbBranch;
+    const start = Date.now();
+    let response;
+    try {
+        response = await client.post(url, body);
+        (0, client_1.traceHttp)("POST", url, start, response);
+    }
+    catch (err) {
+        (0, client_1.traceHttp)("POST", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, "Failed to set audit config");
+        throw err; // 不可达
+    }
+    const respBody = (await response.json());
+    const data = (0, client_1.extractData)(respBody);
+    if (!data.status) {
+        throw new error_1.AppError("INTERNAL_DB_ERROR", "audit config response missing status field");
+    }
+    return data.status;
+}
+// ── db migration → InnerAdminMigrationInit / InnerAdminMigrate ──
+/**
+ * 后端：POST /v1/dataloom/app/{appId}/db/enableMultiEnv
+ * 单库 → dev/online 双库初始化，不可逆。对应公开 API EnableMultiEnvDB 的 admin-inner 通道。
+ */
+async function migrationInit(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/enableMultiEnv");
+    const body = {};
+    if (opts.syncData !== undefined)
+        body.syncData = opts.syncData;
+    const start = Date.now();
+    let response;
+    try {
+        response = await client.post(url, body);
+        (0, client_1.traceHttp)("POST", url, start, response);
+    }
+    catch (err) {
+        (0, client_1.traceHttp)("POST", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, "Failed to init migration");
+        throw err; // 不可达
+    }
+    const respBody = (await response.json());
+    return (0, client_1.extractData)(respBody);
+}
+/**
+ * 后端：POST /v1/dataloom/app/{appId}/db/migration
+ * 合并 diff + apply：dryRun=true 只返 changes 不下发；dryRun=false 才执行。
+ */
+async function migrate(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/migration");
+    const start = Date.now();
+    let response;
+    try {
+        response = await client.post(url, { dryRun: opts.dryRun });
+        (0, client_1.traceHttp)("POST", url, start, response);
+    }
+    catch (err) {
+        (0, client_1.traceHttp)("POST", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, "Failed to migrate");
+        throw err; // 不可达
+    }
+    const respBody = (await response.json());
+    return (0, client_1.extractData)(respBody);
+}
+// ── db recovery → InnerAdminRecover ──
+/**
+ * 后端：POST /v1/dataloom/app/{appId}/db/recovery
+ * 合并 PITR diff + apply：dryRun=true 预览影响；dryRun=false 触发恢复。
+ */
+async function recover(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/recovery");
+    const start = Date.now();
+    let response;
+    try {
+        response = await client.post(url, {
+            target: opts.target,
+            dryRun: opts.dryRun,
+        });
+        (0, client_1.traceHttp)("POST", url, start, response);
+    }
+    catch (err) {
+        (0, client_1.traceHttp)("POST", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, "Failed to recover");
+        throw err; // 不可达
+    }
+    const respBody = (await response.json());
+    return (0, client_1.extractData)(respBody);
+}
+// ── db quota → InnerAdminGetDbQuota ──
+/**
+ * 后端：GET /v1/dataloom/app/{appId}/db/quota?dbBranch=
+ */
+async function getDbQuota(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/quota", { dbBranch: opts.dbBranch });
+    const start = Date.now();
+    let response;
+    try {
+        response = await client.get(url);
+        (0, client_1.traceHttp)("GET", url, start, response);
+    }
+    catch (err) {
+        (0, client_1.traceHttp)("GET", url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, "Failed to get db quota");
+        throw err; // 不可达
+    }
+    const respBody = (await response.json());
+    return (0, client_1.extractData)(respBody);
+}

package/dist/api/db/client.js

@@ -3,6 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.SQLSTATE_MAP = void 0;
 exports.traceHttp = traceHttp;
 exports.ensureInnerSuccess = ensureInnerSuccess;
+exports.mapDataloomBizError = mapDataloomBizError;
 exports.extractData = extractData;
 exports.buildInnerUrl = buildInnerUrl;
 const error_1 = require("../../utils/error");
@@ -26,11 +27,7 @@ function traceHttp(method, url, start, response, err) {
         const status = response?.status ?? 0;
         const logid = response?.headers?.get?.("x-tt-logid") ?? "-";
         if (err !== undefined) {
-            const errMsg = err instanceof Error
-                ? err.message
-                : typeof err === "string"
-                    ? err
-                    : JSON.stringify(err);
+            const errMsg = err instanceof Error ? err.message : typeof err === "string" ? err : JSON.stringify(err);
             (0, logger_1.debug)(`http ${method} ${url} ${String(status)} cost=${String(cost)}ms x-tt-logid=${logid} err=${errMsg}`);
             return;
         }
@@ -54,40 +51,48 @@ function ensureInnerSuccess(body) {
     const code = body.status_code ?? body.ErrorCode ?? "0";
     if (code === "0" || code === "")
         return;
-    const message = stripPgPrefix(body.error_msg ?? body.ErrorMessage ?? `dataloom API error [${code}]`);
+    const appErr = mapDataloomBizError(code, body.error_msg ?? body.ErrorMessage ?? `dataloom API error [${code}]`);
     // PRD 多语句失败：后端在 envelope 顶层透出 errorStatementIndex（从 0 起计），
-    // 单语句 / 单元执行不会带这个字段。下面的 AppError 都把它带上，让最终
-    // CLI JSON envelope 写到 error.statement_index。
-    const stmtIdx = typeof body.errorStatementIndex === "number" ? body.errorStatementIndex : undefined;
-    // k_dl_1300002 是 PG 执行透传错误；error_msg 里常带 SQLSTATE，优先按 SQLSTATE 映射
+    // 单语句 / 单元执行不会带这个字段。挂到 AppError 上让 emitError 落到错误信封
+    // statement_index 字段。
+    if (typeof body.errorStatementIndex === "number") {
+        appErr.statement_index = body.errorStatementIndex;
+    }
+    throw appErr;
+}
+/**
+ * 把 dataloom 业务错误码 + 原始 message 映射为语义化 AppError。
+ *
+ * 同时被两条错误路径共用：
+ *   - ensureInnerSuccess（旧协议：BaseResp.status_code != "0"）
+ *   - api.ts 的 parseSqlErrorSentinel（新协议：success envelope + ERROR 哨兵）
+ *
+ * 优先级：
+ *   1. k_dl_1300002 + SQLSTATE 透传     → SQLSTATE_MAP
+ *   2. k_dl_1600000 + "Invalid DB Branch" → MULTI_ENV_NOT_INITIALIZED
+ *   3. BIZ_ERR_MAP 命中 → 语义 code（可能带 hint）
+ *   4. 兜底 DB_API_<code>
+ *
+ * stripPgPrefix 在这里做一次，调用方传 raw message 即可。
+ */
+function mapDataloomBizError(code, rawMessage) {
+    const message = stripPgPrefix(rawMessage);
     if (code === "k_dl_1300002") {
         const sqlstate = extractSqlstate(message);
         if (sqlstate && exports.SQLSTATE_MAP[sqlstate]) {
-            throw new error_1.AppError(exports.SQLSTATE_MAP[sqlstate], message, { statement_index: stmtIdx });
+            return new error_1.AppError(exports.SQLSTATE_MAP[sqlstate], message);
         }
     }
-    // k_dl_1600000 是 dataloom 通用参数错误，不能整体映射；
-    // message 以 "Invalid DB Branch" 开头的两种触发场景：
-    //   1) 单环境应用使用 --env（多环境未初始化）
-    //   2) 多环境应用传入了不存在的 env 名（如 --env staging）
-    // 两者外部表象一致：dbBranch 在 db_branch 表里查不到，固定映射为 MULTI_ENV_NOT_INITIALIZED。
     if (code === "k_dl_1600000" && message.startsWith("Invalid DB Branch")) {
-        throw new error_1.AppError("MULTI_ENV_NOT_INITIALIZED", "--env is not available (multi-env not initialized)", {
-            next_actions: [
-                "Verify the --env value matches an existing dbBranch.",
-            ],
-        });
+        return new error_1.AppError("MULTI_ENV_NOT_INITIALIZED", "--env is not available (multi-env not initialized)", { next_actions: ["Verify the --env value matches an existing dbBranch."] });
     }
-    // 业务 code 优先映射到语义 CLI code；未知 code 透传为 DB_API_<code> 样式
     const mapped = BIZ_ERR_MAP.get(code);
     if (mapped) {
-        throw new error_1.AppError(mapped.code, mapped.message ?? message, {
+        return new error_1.AppError(mapped.code, mapped.message ?? message, {
             next_actions: mapped.hint ? [mapped.hint] : undefined,
-            statement_index: stmtIdx,
         });
     }
-    // 兜底：dataloom 未映射的 code 原样透传
-    throw new error_1.AppError(`DB_API_${code}`, message, { statement_index: stmtIdx });
+    return new error_1.AppError(`DB_API_${code}`, message);
 }
 /**
  * 剥掉 PG 透传错误的 "ERROR:" 前缀：CLI 输出本身就会前缀 "Error:"，
@@ -111,13 +116,55 @@ function extractSqlstate(msg) {
 const BIZ_ERR_MAP = new Map(Object.entries({
     // 来源：真实环境探测（dataloom InnerExecuteSQL / InnerGetSchema）
     // k_dl_000001：DB 连接 / QPS 限流 等基础设施层错误
-    "k_dl_000001": { code: "INTERNAL_DB_ERROR", hint: "检查 dbBranch 与应用 PG 实例状态，或稍后重试" },
+    k_dl_000001: {
+        code: "INTERNAL_DB_ERROR",
+        hint: "检查 dbBranch 与应用 PG 实例状态，或稍后重试",
+    },
     // k_dl_000002：SQL 解析 / 不支持的 SQL 类型（VACUUM、COPY、SET、SHOW 等）
-    "k_dl_000002": { code: "SQL_SYNTAX_ERROR" },
+    k_dl_000002: { code: "SQL_SYNTAX_ERROR" },
     // k_dl_000003：查询命中系统表（pg_tables / pg_user 等）被拒
-    "k_dl_000003": { code: "SQL_OPERATION_FORBIDDEN" },
+    k_dl_000003: { code: "SQL_OPERATION_FORBIDDEN" },
     // k_dl_1300002：PG 执行错误；实际 SQLSTATE 由 extractSqlstate 单独映射
     // 未匹配到 SQLSTATE 时走下面兜底 DB_API_<code>
+    // k_dl_1300015：SELECT 结果超过 1000 行硬拦；多行 hint 由 output.ts 的
+    // SERVER_ERROR_HINTS 按语义 code 兜底，这里只做 code 改名
+    k_dl_1300015: { code: "RESULT_SET_TOO_LARGE" },
+    // audit
+    k_dl_1310001: {
+        code: "AUDIT_ALREADY_ENABLED",
+        hint: "Use `miaoda db audit status <table>` to confirm current state.",
+    },
+    k_dl_1310002: {
+        code: "AUDIT_NOT_ENABLED",
+        hint: "Run `miaoda db audit enable <table>` first.",
+    },
+    k_dl_1310003: {
+        code: "INVALID_RETENTION",
+        hint: "Allowed values: 7d / 30d / 180d / 360d.",
+    },
+    // migration
+    k_dl_1320001: {
+        code: "MIGRATION_NOT_AVAILABLE",
+        hint: "Migration commands require an expert-mode application.",
+    },
+    k_dl_1320002: { code: "MULTI_ENV_ALREADY_INITIALIZED" },
+    k_dl_1320003: {
+        code: "NO_PENDING_CHANGES",
+        hint: "dev and online schemas are already in sync.",
+    },
+    // recovery
+    k_dl_1330001: {
+        code: "RECOVERY_WINDOW_EXCEEDED",
+        hint: "Pick a timestamp inside the supported recovery window.",
+    },
+    k_dl_1330002: {
+        code: "RECOVERY_IN_PROGRESS",
+        hint: "Wait for the running recovery to finish, or check its status.",
+    },
+    k_dl_1330003: {
+        code: "INVALID_TIMESTAMP",
+        hint: "Use ISO 8601 / yyyy-mm-dd / yyyy-mm-dd HH:MM:SS.",
+    },
 }));
 /** PG SQLSTATE → CLI code（当前 dataloom 不一定透传，预留未来使用） */
 exports.SQLSTATE_MAP = {

package/dist/api/db/index.js

@@ -1,11 +1,17 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.pickTableDetail = exports.flattenSchemaList = exports.parseSqlResult = exports.SQLSTATE_MAP = exports.ensureInnerSuccess = exports.buildInnerUrl = exports.exportData = exports.importData = exports.getSchema = exports.execSql = void 0;
+exports.pickTableDetail = exports.flattenSchemaList = exports.parseSqlResult = exports.SQLSTATE_MAP = exports.ensureInnerSuccess = exports.buildInnerUrl = exports.getDbQuota = exports.recover = exports.migrate = exports.migrationInit = exports.setAuditConfig = exports.listDDLChangelog = exports.exportData = exports.importData = exports.getSchema = exports.execSql = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "execSql", { enumerable: true, get: function () { return api_1.execSql; } });
 Object.defineProperty(exports, "getSchema", { enumerable: true, get: function () { return api_1.getSchema; } });
 Object.defineProperty(exports, "importData", { enumerable: true, get: function () { return api_1.importData; } });
 Object.defineProperty(exports, "exportData", { enumerable: true, get: function () { return api_1.exportData; } });
+Object.defineProperty(exports, "listDDLChangelog", { enumerable: true, get: function () { return api_1.listDDLChangelog; } });
+Object.defineProperty(exports, "setAuditConfig", { enumerable: true, get: function () { return api_1.setAuditConfig; } });
+Object.defineProperty(exports, "migrationInit", { enumerable: true, get: function () { return api_1.migrationInit; } });
+Object.defineProperty(exports, "migrate", { enumerable: true, get: function () { return api_1.migrate; } });
+Object.defineProperty(exports, "recover", { enumerable: true, get: function () { return api_1.recover; } });
+Object.defineProperty(exports, "getDbQuota", { enumerable: true, get: function () { return api_1.getDbQuota; } });
 var client_1 = require("./client");
 Object.defineProperty(exports, "buildInnerUrl", { enumerable: true, get: function () { return client_1.buildInnerUrl; } });
 Object.defineProperty(exports, "ensureInnerSuccess", { enumerable: true, get: function () { return client_1.ensureInnerSuccess; } });

package/dist/api/db/parsers.js

@@ -117,11 +117,35 @@ function toDetail(t, stats) {
     // 优先用 tableStats.indexes（PRIMARY + UNIQUE + INDEX 统一视图）；
     // 回退到 TableVO.indexes（仅二级索引，老后端没返回 tableStats 时使用）
     const rawIndexes = stats?.indexes ?? t.indexes ?? [];
+    const constraints = [];
+    const indexes = [];
+    for (const i of rawIndexes) {
+        const cols = i.indexColumns ?? [];
+        // 过滤掉空列条目（后端偶发返 indexColumns=[] 的占位项），渲染成 "UNIQUE ()" 看起来像 bug
+        if (cols.length === 0)
+            continue;
+        const kind = i.indexType.toLowerCase();
+        if (kind === "primary") {
+            constraints.push({ type: "PRIMARY KEY", columns: cols });
+        }
+        else if (kind === "unique") {
+            constraints.push({ type: "UNIQUE", columns: cols });
+        }
+        else {
+            // foreign / normal / 其它统一进 indexes 段；method 从 indexDef 的 USING 段解析
+            indexes.push({
+                name: i.indexName,
+                columns: cols,
+                method: parseIndexMethod(i.indexDef) ?? "btree",
+            });
+        }
+    }
     return {
         name: t.tableName,
         description: t.comment && t.comment.length > 0 ? t.comment : null,
         columns: (t.fields ?? []).map(toColumn),
-        indexes: rawIndexes.map(toIndex),
+        constraints,
+        indexes,
         estimated_row_count: typeof stats?.estimatedRowCount === "number" ? stats.estimatedRowCount : null,
         size_bytes: typeof stats?.sizeBytes === "number" ? stats.sizeBytes : null,
     };
@@ -137,25 +161,14 @@ function toColumn(f) {
         comment: f.comment && f.comment.length > 0 ? f.comment : null,
     };
 }
-function toIndex(i) {
-    return {
-        name: i.indexName,
-        type: translateIndexType(i.indexType),
-        columns: i.indexColumns ?? [],
-    };
-}
 /**
- * 把后端原始 IndexType（小写：primary / unique / normal / foreign）翻译为 PRD 约定的展示值。
- * 规则：
- *   primary  → "PRIMARY KEY"
- *   unique   → "UNIQUE"
- *   其它    → "INDEX"（foreign 外键通过 relationships 表达，不进 indexes；真的遇到也归 INDEX）
+ * 从 PG 的 CREATE INDEX 语句里提取访问方法（btree / gin / gist / hash 等）。
+ * indexDef 示例: "CREATE INDEX idx_users_name ON public.users USING btree (name)"
+ * 解析失败返 null，由调用方兜底成 PG 默认的 "btree"。
  */
-function translateIndexType(raw) {
-    const s = raw.toLowerCase();
-    if (s === "primary")
-        return "PRIMARY KEY";
-    if (s === "unique")
-        return "UNIQUE";
-    return "INDEX";
+function parseIndexMethod(indexDef) {
+    if (!indexDef)
+        return null;
+    const m = /USING\s+(\w+)/i.exec(indexDef);
+    return m ? m[1].toLowerCase() : null;
 }