@lark-apaas/miaoda-cli 0.1.3-alpha.4bf312e → 0.1.3-alpha.4ec3549

package/dist/api/db/api.js

@@ -13,47 +13,34 @@ exports.migrate = migrate;
 exports.getMigrationStatus = getMigrationStatus;
 exports.recover = recover;
 exports.getRecoveryPreview = getRecoveryPreview;
+exports.getRecoveryStatus = getRecoveryStatus;
 exports.getDbQuota = getDbQuota;
 const http_1 = require("../../utils/http");
 const error_1 = require("../../utils/error");
 const http_client_1 = require("@lark-apaas/http-client");
 const client_1 = require("./client");
-/**
- * 把 SDK 抛出的 HttpError 统一映射成 CLI 层错误：
- *   1. 先尝试从 response body 解 envelope，命中 dataloom 业务 code → AppError
- *   2. 兜底返 HttpError，保留真实 status 码与上下文
- *
- * 配合调用点的 try/catch + traceHttp，让 --verbose 在错误路径上也能拿到
- * x-tt-logid 与 status，方便定位线上问题。
- */
-async function mapDbHttpError(err, url, ctx, 
-/**
- * 可选 hook：解析到响应 body 后，如果 envelope 命中业务错误并抛出 AppError，
- * 调用方可以借此把 body 里的额外字段（如 multi-statement 的 partial results）
- * 挂到 AppError 上。
- */
-onErrorBody) {
+const DEFAULT_TIMEOUT_HINT = 'The server may still be processing your request. Retry the command if needed.';
+async function mapDbHttpError(err, url, ctx, opts) {
     if (err instanceof error_1.AppError)
         throw err;
     // 客户端超时 / abort：SdkHttpError 时 response 通常缺失（status=0），落到 throw 时
-    // message 形如 'Failed to recover: 0' 让用户看不懂。识别 abort / timeout 关键字
-    // 转成专用错误码 + 友好 hint。
+    // message 形如 'Failed to recover: 0' 让用户看不懂。识别 abort / timeout 关键字后
+    // 单独抛专用 AppError（带领域可定制的 message + hint），不再包成通用 "Failed to X"。
     if (err instanceof Error) {
-        const msg = err.message.toLowerCase();
-        if (msg.includes("aborted") ||
-            msg.includes("timeout") ||
-            err.name === "AbortError" ||
-            err.name === "TimeoutError") {
-            throw new error_1.AppError("REQUEST_TIMEOUT", `${ctx}: request timed out`, {
-                next_actions: [
-                    "Server-side async tasks may take up to 60s. Retry the command if the underlying task likely succeeded.",
-                ],
-            });
+        const lower = err.message.toLowerCase();
+        if (lower.includes('aborted') ||
+            lower.includes('timeout') ||
+            err.name === 'AbortError' ||
+            err.name === 'TimeoutError') {
+            const code = opts?.timeout?.code ?? 'REQUEST_TIMEOUT';
+            const message = opts?.timeout?.message ?? 'Request timed out after 30s';
+            const hint = opts?.timeout?.hint ?? DEFAULT_TIMEOUT_HINT;
+            throw new error_1.AppError(code, message, { next_actions: [hint] });
         }
     }
     if (err instanceof http_client_1.HttpError) {
         const status = err.response?.status ?? 0;
-        const statusText = err.response?.statusText ?? "";
+        const statusText = err.response?.statusText ?? '';
         try {
             const body = (await err.response?.json());
             if (body) {
@@ -61,8 +48,8 @@ onErrorBody) {
                     (0, client_1.extractData)(body); // 业务 code 命中 → 抛 AppError；不命中走兜底
                 }
                 catch (appErr) {
-                    if (appErr instanceof error_1.AppError && onErrorBody) {
-                        onErrorBody(body, appErr);
+                    if (appErr instanceof error_1.AppError && opts?.onErrorBody) {
+                        opts.onErrorBody(body, appErr);
                     }
                     throw appErr;
                 }
@@ -105,18 +92,28 @@ function attachSqlPartialResults(body, appErr) {
  */
 async function execSql(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/sql", {
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/sql', {
         dbBranch: opts.dbBranch,
     });
     const start = Date.now();
     let response;
     try {
         response = await client.post(url, { sql: opts.sql });
-        (0, client_1.traceHttp)("POST", url, start, response);
+        (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 execute SQL", attachSqlPartialResults);
+        (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', {
+            onErrorBody: attachSqlPartialResults,
+            // SQL 路径单独的超时文案：PG 的 statement_timeout 会回滚整条事务，所以这里
+            // 明示「事务已回滚、没有改动落地」，并把 hint 引导到「简化 SQL / 加 LIMIT / 拆条」。
+            timeout: {
+                code: 'SQL_EXECUTION_TIMEOUT',
+                message: 'SQL execution timed out after 30s',
+                hint: 'The transaction was rolled back; no changes were applied. ' +
+                    'Simplify the SQL, add filters or LIMIT for queries, or split it into smaller statements.',
+            },
+        });
         throw err; // 不可达
     }
     const body = (await response.json());
@@ -127,11 +124,11 @@ async function execSql(opts) {
         // results 末尾追加一条 SqlType="ERROR" 的哨兵，data 字段是 {code,message} JSON。
         // 这样网关在错误路径不会吞业务字段，CLI 拿到完整 partial_results + statement_index。
         const last = results.at(-1);
-        if (last?.sqlType === "ERROR") {
+        if (last?.sqlType === 'ERROR') {
             const appErr = parseSqlErrorSentinel(last.data);
             appErr.partial_results = results.slice(0, -1);
             const stmtIdx = data.errorStatementIndex;
-            if (typeof stmtIdx === "number")
+            if (typeof stmtIdx === 'number')
                 appErr.statement_index = stmtIdx;
             throw appErr;
         }
@@ -163,12 +160,12 @@ async function execSql(opts) {
 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;
+        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);
+        return new error_1.AppError('INTERNAL_DB_ERROR', payload);
     }
 }
 // ── db schema → InnerGetSchema ──
@@ -180,21 +177,21 @@ function parseSqlErrorSentinel(payload) {
  */
 async function getSchema(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/schema", {
-        format: opts.format ?? "schema",
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/schema', {
+        format: opts.format ?? 'schema',
         tableNames: opts.tableNames,
-        includeStats: opts.includeStats ? "true" : undefined,
+        includeStats: opts.includeStats ? 'true' : undefined,
         dbBranch: opts.dbBranch,
     });
     const start = Date.now();
     let response;
     try {
         response = await client.get(url);
-        (0, client_1.traceHttp)("GET", url, start, response);
+        (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 schema");
+        (0, client_1.traceHttp)('GET', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, 'Failed to get schema');
         throw err; // 不可达
     }
     const body = (await response.json());
@@ -214,24 +211,24 @@ async function getSchema(opts) {
  */
 async function importData(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/data/import");
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/data/import');
     const reqBody = {
         tableName: opts.tableName,
         format: opts.format,
-        records: opts.body.toString("utf8"),
+        records: opts.body.toString('utf8'),
     };
-    if (opts.dbBranch !== undefined && opts.dbBranch !== "") {
+    if (opts.dbBranch !== undefined && opts.dbBranch !== '') {
         reqBody.dbBranch = opts.dbBranch;
     }
     const start = Date.now();
     let response;
     try {
         response = await client.post(url, reqBody);
-        (0, client_1.traceHttp)("POST", url, start, response);
+        (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 import data");
+        (0, client_1.traceHttp)('POST', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, 'Failed to import data');
         throw err; // 不可达
     }
     // 后端 InnerAdminImportData 响应里 data 直接返 {tableName, recordCount, durationMs}
@@ -255,7 +252,7 @@ async function importData(opts) {
  */
 async function exportData(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/data/export", {
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/data/export', {
         tableName: opts.tableName,
         format: opts.format,
         limit: String(opts.limit ?? 5000),
@@ -265,35 +262,35 @@ async function exportData(opts) {
     const start = Date.now();
     let response;
     try {
-        response = await client.request({ method: "POST", url });
-        (0, client_1.traceHttp)("POST", url, start, response);
+        response = await client.request({ method: 'POST', url });
+        (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 export data");
+        (0, client_1.traceHttp)('POST', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, 'Failed to export data');
         throw err; // 不可达
     }
     // 成功路径：响应 body 通常是原始 CSV/SQL/JSON 字节，但部分错误场景下网关会返
     // HTTP 200 + JSON envelope（status_code != "0"），需要在这里嗅探兜底。
     const defaultContentType = {
-        csv: "text/csv",
-        sql: "text/plain",
-        json: "application/json",
+        csv: 'text/csv',
+        sql: 'text/plain',
+        json: 'application/json',
     };
-    const contentType = response.headers.get("Content-Type") ?? defaultContentType[opts.format];
+    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) {
-        throw new error_1.AppError("INTERNAL_DB_ERROR", "Empty export response body");
+        throw new error_1.AppError('INTERNAL_DB_ERROR', 'Empty export response body');
     }
     // Envelope sniff：HTTP 200 + Content-Type 为 application/json + body 解析得到
     // InnerEnvelope 且 status_code 非 "0" 时，按业务错误抛出。
     // CSV / SQL 都是非 JSON 输出，application/json 响应必是错误信封；JSON 格式
     // 成功响应自身就是 application/json，跳过 sniff 避免误判。
-    if (opts.format !== "json" && /application\/json/i.test(contentType)) {
+    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") {
+            const parsed = JSON.parse(buf.toString('utf8'));
+            if (parsed.status_code != null && parsed.status_code !== '0') {
                 // 复用 extractData 的错误映射逻辑（throw AppError）
                 (0, client_1.extractData)(parsed);
             }
@@ -306,7 +303,7 @@ async function exportData(opts) {
         }
     }
     // 后端通过响应头回传记录数（避免污染 body）；header 缺失或解析失败 → undefined
-    const recordCountHeader = response.headers.get("X-Miaoda-Record-Count");
+    const recordCountHeader = response.headers.get('X-Miaoda-Record-Count');
     const parsedCount = recordCountHeader != null ? Number(recordCountHeader) : NaN;
     const recordCount = Number.isFinite(parsedCount) && parsedCount >= 0 ? parsedCount : undefined;
     return {
@@ -325,7 +322,7 @@ async function exportData(opts) {
  */
 async function listDDLChangelog(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/changelog", {
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/changelog', {
         table: opts.table,
         since: opts.since,
         until: opts.until,
@@ -337,18 +334,18 @@ async function listDDLChangelog(opts) {
     let response;
     try {
         response = await client.get(url);
-        (0, client_1.traceHttp)("GET", url, start, response);
+        (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");
+        (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,
+        nextCursor: data.nextCursor && data.nextCursor !== '' ? data.nextCursor : null,
         hasMore: Boolean(data.hasMore),
     };
 }
@@ -359,7 +356,7 @@ async function listDDLChangelog(opts) {
  */
 async function getAuditStatus(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/audit/status", {
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/audit/status', {
         table: opts.table,
         dbBranch: opts.dbBranch,
     });
@@ -367,11 +364,11 @@ async function getAuditStatus(opts) {
     let response;
     try {
         response = await client.get(url);
-        (0, client_1.traceHttp)("GET", url, start, response);
+        (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 audit status");
+        (0, client_1.traceHttp)('GET', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, 'Failed to get audit status');
         throw err; // 不可达
     }
     const respBody = (await response.json());
@@ -384,30 +381,30 @@ async function getAuditStatus(opts) {
  */
 async function setAuditConfig(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/audit/config");
+    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 !== "")
+    if (opts.retention !== undefined && opts.retention !== '')
         body.retention = opts.retention;
-    if (opts.dbBranch !== undefined && opts.dbBranch !== "")
+    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);
+        (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");
+        (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");
+        throw new error_1.AppError('INTERNAL_DB_ERROR', 'audit config response missing status field');
     }
     return data.status;
 }
@@ -425,11 +422,11 @@ async function setAuditConfig(opts) {
  */
 async function listAuditLog(opts) {
     if (opts.tables.length === 0) {
-        throw new error_1.AppError("ARGS_INVALID", "at least one table is required");
+        throw new error_1.AppError('ARGS_INVALID', 'at least one table is required');
     }
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/audit/log", {
-        tables: opts.tables.join(","),
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/audit/log', {
+        tables: opts.tables.join(','),
         since: opts.since,
         until: opts.until,
         limit: opts.limit !== undefined ? String(opts.limit) : undefined,
@@ -440,18 +437,18 @@ async function listAuditLog(opts) {
     let response;
     try {
         response = await client.get(url);
-        (0, client_1.traceHttp)("GET", url, start, response);
+        (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 audit log");
+        (0, client_1.traceHttp)('GET', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, 'Failed to list audit log');
         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,
+        nextCursor: data.nextCursor && data.nextCursor !== '' ? data.nextCursor : null,
         hasMore: Boolean(data.hasMore),
         skipped: data.skipped ?? [],
     };
@@ -463,7 +460,7 @@ async function listAuditLog(opts) {
  */
 async function migrationInit(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/enableMultiEnv");
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/enableMultiEnv');
     const body = {};
     if (opts.syncData !== undefined)
         body.syncData = opts.syncData;
@@ -471,11 +468,11 @@ async function migrationInit(opts) {
     let response;
     try {
         response = await client.post(url, body);
-        (0, client_1.traceHttp)("POST", url, start, response);
+        (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");
+        (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());
@@ -487,16 +484,16 @@ async function migrationInit(opts) {
  */
 async function migrate(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/migration");
+    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);
+        (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");
+        (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());
@@ -509,7 +506,7 @@ async function migrate(opts) {
  */
 async function getMigrationStatus(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/migration/status", {
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/migration/status', {
         taskId: opts.taskId,
         dbBranch: opts.dbBranch,
     });
@@ -517,11 +514,11 @@ async function getMigrationStatus(opts) {
     let response;
     try {
         response = await client.get(url);
-        (0, client_1.traceHttp)("GET", url, start, response);
+        (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 migration status");
+        (0, client_1.traceHttp)('GET', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, 'Failed to get migration status');
         throw err; // 不可达
     }
     const body = (await response.json());
@@ -534,7 +531,7 @@ async function getMigrationStatus(opts) {
  */
 async function recover(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/recovery");
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/recovery');
     const start = Date.now();
     let response;
     try {
@@ -542,11 +539,11 @@ async function recover(opts) {
             target: opts.target,
             dryRun: opts.dryRun,
         });
-        (0, client_1.traceHttp)("POST", url, start, response);
+        (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");
+        (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());
@@ -558,7 +555,7 @@ async function recover(opts) {
  */
 async function getRecoveryPreview(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/recovery/preview", {
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/recovery/preview', {
         previewRequestId: opts.previewRequestId,
         dbBranch: opts.dbBranch,
     });
@@ -566,11 +563,34 @@ async function getRecoveryPreview(opts) {
     let response;
     try {
         response = await client.get(url);
-        (0, client_1.traceHttp)("GET", url, start, response);
+        (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 recovery preview');
+        throw err; // 不可达
+    }
+    const body = (await response.json());
+    return (0, client_1.extractData)(body);
+}
+/**
+ * 后端：GET /v1/dataloom/app/{appId}/db/recovery/status
+ * CLI apply 触发后定时调本接口直到 status=success/failed。dataloom 内部 Redis
+ * 维护 workspace 级 restore 状态，无需传 task id；workspace+dbBranch 维度同时
+ * 只允许一个 restore 进行中。
+ */
+async function getRecoveryStatus(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, '/db/recovery/status', { 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 recovery preview");
+        (0, client_1.traceHttp)('GET', url, start, err instanceof http_client_1.HttpError ? err.response : undefined, err);
+        await mapDbHttpError(err, url, 'Failed to get recovery status');
         throw err; // 不可达
     }
     const body = (await response.json());
@@ -582,16 +602,16 @@ async function getRecoveryPreview(opts) {
  */
 async function getDbQuota(opts) {
     const client = (0, http_1.getHttpClient)();
-    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/quota", { dbBranch: opts.dbBranch });
+    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);
+        (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");
+        (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());