@lark-apaas/miaoda-cli 0.1.2-beta.3416c6d → 0.1.3-alpha.40be425

package/dist/api/db/api.js

@@ -4,27 +4,39 @@ exports.execSql = execSql;
 exports.getSchema = getSchema;
 exports.importData = importData;
 exports.exportData = exportData;
+exports.listDDLChangelog = listDDLChangelog;
+exports.getAuditStatus = getAuditStatus;
+exports.setAuditConfig = setAuditConfig;
+exports.listAuditLog = listAuditLog;
+exports.migrationInit = migrationInit;
+exports.migrate = migrate;
+exports.getMigrationStatus = getMigrationStatus;
+exports.recover = recover;
+exports.getRecoveryPreview = getRecoveryPreview;
+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 关键字后
+    // 单独抛专用 AppError（带领域可定制的 message + hint），不再包成通用 "Failed to X"。
+    if (err instanceof Error) {
+        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 ?? "";
@@ -35,8 +47,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;
                 }
@@ -90,7 +102,17 @@ 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", attachSqlPartialResults);
+        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());
@@ -247,10 +269,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) {
@@ -258,8 +284,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") {
@@ -269,7 +296,7 @@ async function exportData(opts) {
         }
         catch (err) {
             // 已经被 extractData 抛成 AppError → 透传；否则 JSON.parse 失败说明 body
-            // 真的是 CSV 文本，继续按成功流程走
+            // 真的是 CSV / SQL 文本，继续按成功流程走
             if (err instanceof error_1.AppError)
                 throw err;
         }
@@ -286,3 +313,283 @@ 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 → InnerAdminGetAuditStatus / InnerAdminSetAuditConfig ──
+/**
+ * 后端：GET /v1/dataloom/app/{appId}/db/audit/status?table=&dbBranch=
+ * 查表审计开关状态。table 非空 → 单表过滤；空 → 返当前 workspace 全部已配置表。
+ */
+async function getAuditStatus(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/audit/status", {
+        table: opts.table,
+        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 audit status");
+        throw err; // 不可达
+    }
+    const respBody = (await response.json());
+    const data = (0, client_1.extractData)(respBody);
+    return data.items ?? [];
+}
+/**
+ * 后端：POST /v1/dataloom/app/{appId}/db/audit/config
+ * 写：enabled=true 开启 / false 关闭。retention 仅 enabled=true 生效。
+ */
+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 audit log → InnerAdminListAuditLog ──
+/**
+ * 后端：GET /v1/dataloom/app/{appId}/db/audit/log?tables=&since=&until=&limit=&cursor=&dbBranch=
+ *
+ * 走 admin-inner 接口而不是 InnerAdminExecuteSQL 直接 SELECT pg_audit：
+ *   - operator 在 details JSONB 内是 user_id，服务端解析成 username
+ *   - summary 后端按 type + before/after diff 合成（pg_audit 表无此列）
+ *   - before/after JSONB 后端 JSON.stringify 后透传字符串，CLI 按需 parse
+ *
+ * 多表用逗号拼接走 query；后端按 target_table IN (...) 一次查。skipped 字段返
+ * 多表中无记录的表名，便于 CLI 展示 hint。
+ */
+async function listAuditLog(opts) {
+    if (opts.tables.length === 0) {
+        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(","),
+        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 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,
+        hasMore: Boolean(data.hasMore),
+        skipped: data.skipped ?? [],
+    };
+}
+// ── 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);
+}
+/**
+ * 后端：GET /v1/dataloom/app/{appId}/db/migration/status?taskId=...
+ * CLI 拿到 migration apply 的 taskId 后定时调本接口，直到 status=success/failed。
+ * 网络层超时仍走 mapDbHttpError → 单次 30s；轮询节奏由 CLI handler 自行控制。
+ */
+async function getMigrationStatus(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/migration/status", {
+        taskId: opts.taskId,
+        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 migration status");
+        throw err; // 不可达
+    }
+    const body = (await response.json());
+    return (0, client_1.extractData)(body);
+}
+// ── 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);
+}
+/**
+ * 后端：GET /v1/dataloom/app/{appId}/db/recovery/preview?previewRequestId=...
+ * CLI 拿到 recovery diff 的 previewRequestId 后定时调本接口直到 previewStatus=success/failed。
+ */
+async function getRecoveryPreview(opts) {
+    const client = (0, http_1.getHttpClient)();
+    const url = (0, client_1.buildInnerUrl)(opts.appId, "/db/recovery/preview", {
+        previewRequestId: opts.previewRequestId,
+        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");
+        throw err; // 不可达
+    }
+    const body = (await response.json());
+    return (0, client_1.extractData)(body);
+}
+// ── 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

@@ -129,6 +129,42 @@ const BIZ_ERR_MAP = new Map(Object.entries({
     // 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, forever.",
+    },
+    // 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,21 @@
 "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.getRecoveryPreview = exports.recover = exports.getMigrationStatus = exports.migrate = exports.migrationInit = exports.listAuditLog = exports.setAuditConfig = exports.getAuditStatus = 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, "getAuditStatus", { enumerable: true, get: function () { return api_1.getAuditStatus; } });
+Object.defineProperty(exports, "setAuditConfig", { enumerable: true, get: function () { return api_1.setAuditConfig; } });
+Object.defineProperty(exports, "listAuditLog", { enumerable: true, get: function () { return api_1.listAuditLog; } });
+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, "getMigrationStatus", { enumerable: true, get: function () { return api_1.getMigrationStatus; } });
+Object.defineProperty(exports, "recover", { enumerable: true, get: function () { return api_1.recover; } });
+Object.defineProperty(exports, "getRecoveryPreview", { enumerable: true, get: function () { return api_1.getRecoveryPreview; } });
+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/file/api.js

@@ -8,8 +8,10 @@ exports.uploadFile = uploadFile;
 exports.signDownload = signDownload;
 exports.downloadFile = downloadFile;
 exports.deleteFiles = deleteFiles;
+exports.getStorageQuota = getStorageQuota;
 const error_1 = require("../../utils/error");
 const logger_1 = require("../../utils/logger");
+const time_1 = require("../../utils/time");
 const client_1 = require("./client");
 const detect_1 = require("./detect");
 const parsers_1 = require("./parsers");
@@ -107,31 +109,17 @@ function buildFilterExpr(opts) {
  * flagName 用于错误信息，调用方传 "--uploaded-since" 或 "--uploaded-until"。
  */
 function parseTimeFilterMs(input, flagName) {
-    // 相对时间：<positive int><unit>，单位 s/m/h/d/w
-    const RELATIVE = /^(\d+)([smhdw])$/;
-    const rel = RELATIVE.exec(input);
-    if (rel) {
-        const n = parseInt(rel[1], 10);
-        if (n <= 0) {
-            throw new error_1.AppError("ARGS_INVALID", `${flagName} "${input}" 必须是正整数 + 单位（s / m / h / d / w）`);
-        }
-        const UNIT_MS = {
-            s: 1_000,
-            m: 60_000,
-            h: 3_600_000,
-            d: 86_400_000,
-            w: 604_800_000,
-        };
-        return Date.now() - n * UNIT_MS[rel[2]];
+    try {
+        return (0, time_1.parseTimeToMs)(input);
     }
-    // 绝对时间：date / ISO 8601。Date.parse 对 "YYYY-MM-DD" 按 UTC 00:00:00 解析，
-    // 对带 Z 的 ISO 8601 也直接出 UTC ms。
-    const ms = Date.parse(input);
-    if (Number.isNaN(ms)) {
-        throw new error_1.AppError("ARGS_INVALID", `${flagName} "${input}" 格式无法识别。支持：` +
-            `相对时间（如 1h / 2d / 1w）、日期（YYYY-MM-DD）、ISO 8601（如 2026-04-01T10:00:00Z）`);
+    catch (err) {
+        if (err instanceof error_1.AppError) {
+            throw new error_1.AppError(err.code, `${flagName}: ${err.message}`, {
+                next_actions: err.next_actions,
+            });
+        }
+        throw err;
     }
-    return ms;
 }
 /**
  * 列出文件：所有过滤下推到后端 FilterExpression，纯精确匹配，无 glob。
@@ -519,3 +507,17 @@ async function deleteFiles(opts) {
     }
     return { deleted, failed };
 }
+// ── storage quota ──
+/**
+ * 后端：GET /v1/storage/app/{appId}/bucket/{bucketId}/quota
+ * 单 bucket 用量；StorageQuotaBytes 暂未对接，CLI 拿到 0 时按 "—" 渲染。
+ * bucketId 缺省时走默认 bucket（与 ls / stat / cp 等一致）。
+ */
+async function getStorageQuota(opts) {
+    const bucketId = opts.bucketId ?? (await (0, client_1.getDefaultBucketId)(opts.appId));
+    const url = `/v1/storage/app/${encodeURIComponent(opts.appId)}/bucket/${encodeURIComponent(bucketId)}/quota`;
+    const body = await (0, client_1.doGet)(url, {
+        errorContext: `fetch storage quota for app '${opts.appId}' bucket '${bucketId}'`,
+    });
+    return extractEnvelope(body);
+}

package/dist/api/file/index.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.parseTimeFilterMs = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
+exports.toAbsolutePath = exports.looksLikePath = exports.resetBucketCache = exports.getDefaultBucketId = exports.getStorageQuota = exports.parseTimeFilterMs = exports.resolveInputs = exports.deleteFiles = exports.downloadFile = exports.signDownload = exports.uploadFile = exports.statFile = exports.listFiles = void 0;
 var api_1 = require("./api");
 Object.defineProperty(exports, "listFiles", { enumerable: true, get: function () { return api_1.listFiles; } });
 Object.defineProperty(exports, "statFile", { enumerable: true, get: function () { return api_1.statFile; } });
@@ -10,6 +10,7 @@ Object.defineProperty(exports, "downloadFile", { enumerable: true, get: function
 Object.defineProperty(exports, "deleteFiles", { enumerable: true, get: function () { return api_1.deleteFiles; } });
 Object.defineProperty(exports, "resolveInputs", { enumerable: true, get: function () { return api_1.resolveInputs; } });
 Object.defineProperty(exports, "parseTimeFilterMs", { enumerable: true, get: function () { return api_1.parseTimeFilterMs; } });
+Object.defineProperty(exports, "getStorageQuota", { enumerable: true, get: function () { return api_1.getStorageQuota; } });
 var client_1 = require("./client");
 Object.defineProperty(exports, "getDefaultBucketId", { enumerable: true, get: function () { return client_1.getDefaultBucketId; } });
 Object.defineProperty(exports, "resetBucketCache", { enumerable: true, get: function () { return client_1.resetBucketCache; } });

package/dist/api/file/parsers.js

@@ -41,8 +41,9 @@ function parseAttachment(att) {
     const downloadUrl = str(att.downloadURL);
     if (downloadUrl)
         info.download_url = downloadUrl;
-    // uploaded_by 从 createdBy.name 映射（后端返 {userID, name, email, ...}，空代表匿名）
-    const uploader = str(att.createdBy?.name);
+    // uploaded_by 输出 {id, name} 对象：后端 createdBy: {userID, name, email, ...}，
+    // 任一非空都建对象；JSON 用对象、pretty 渲染只取 name。
+    const uploader = toUploaderRef(att.createdBy);
     if (uploader)
         info.uploaded_by = uploader;
     return info;
@@ -61,8 +62,18 @@ function parseHead(data, filePath) {
     const downloadUrl = str(outer.downloadURL);
     if (downloadUrl)
         info.download_url = downloadUrl;
-    const uploader = str(outer.createdBy?.name);
+    const uploader = toUploaderRef(outer.createdBy);
     if (uploader)
         info.uploaded_by = uploader;
     return info;
 }
+/** 把后端 UserRef 归一成 CLI 暴露的 {id, name}；id / name 全空时返 undefined 略过字段。 */
+function toUploaderRef(user) {
+    if (!user)
+        return undefined;
+    const id = str(user.userID);
+    const name = str(user.name);
+    if (id === "" && name === "")
+        return undefined;
+    return { id, name };
+}