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

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

@@ -0,0 +1,58 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDbQuota = handleDbQuota;
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+async function handleDbQuota(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const data = await api.db.getDbQuota({ appId, dbBranch: opts.env });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(data));
+        return;
+    }
+    // PRD：单行 "Storage: 14.9 MB / 1 GB (1.5%)"；配额未对接时只显示 used
+    const tty = (0, render_1.isStdoutTty)();
+    const storageLine = data.storageQuotaBytes > 0
+        ? `${(0, render_1.formatSize)(data.storageUsedBytes)} / ${(0, render_1.formatSize)(data.storageQuotaBytes)} (${data.usagePercent.toFixed(1)}%)`
+        : (0, render_1.formatSize)(data.storageUsedBytes);
+    (0, output_1.emit)((0, render_1.renderKeyValue)([
+        ["Storage", storageLine],
+        ["Tables", String(data.tables)],
+        ["Views", String(data.views)],
+    ], tty));
+}

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

@@ -0,0 +1,188 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleDbRecoveryDiff = handleDbRecoveryDiff;
+exports.handleDbRecoveryApply = handleDbRecoveryApply;
+const node_readline_1 = __importDefault(require("node:readline"));
+const api = __importStar(require("../../../api/index"));
+const shared_1 = require("../../../cli/commands/shared");
+const error_1 = require("../../../utils/error");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+// ── recovery diff ──
+async function handleDbRecoveryDiff(target, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const ts = normalizeTimestamp(target);
+    const result = await api.db.recover({ appId, target: ts, dryRun: true });
+    renderDiff(result);
+}
+async function handleDbRecoveryApply(target, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const ts = normalizeTimestamp(target);
+    // PITR 高危：TTY 下先 diff 给用户审；--yes 直接执行
+    if (!opts.yes && !(0, output_1.isJsonMode)()) {
+        const preview = await api.db.recover({ appId, target: ts, dryRun: true });
+        renderDiff(preview);
+        const ok = await confirm(`? Restore database to ${preview.target}? This will overwrite current data. (y/N) `);
+        if (!ok) {
+            (0, output_1.emit)("Aborted.");
+            return;
+        }
+    }
+    const result = await api.db.recover({ appId, target: ts, dryRun: false });
+    if ((0, output_1.isJsonMode)()) {
+        // PRD：{"status": "restored", "target": "...", "tables_affected": 2, "elapsed_seconds": 30}
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            status: result.status ?? "restored",
+            target: result.target,
+            tablesAffected: result.tablesAffected,
+            elapsedSeconds: result.elapsedSeconds ?? 0,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const prefix = tty ? "✓" : "OK";
+    (0, output_1.emit)(`${prefix} Database restored to ${result.target} ` +
+        `(${String(result.tablesAffected)} tables affected, ${String(result.elapsedSeconds ?? 0)}s elapsed)`);
+}
+// ── helpers ──
+/**
+ * 把用户传入的时间统一成 ISO 8601 UTC。
+ * 接受：`YYYY-MM-DD` / `YYYY-MM-DD HH:MM:SS` / 完整 ISO 8601。
+ */
+function normalizeTimestamp(input) {
+    const FORMAT_HINT = "Use ISO 8601 / yyyy-mm-dd / yyyy-mm-dd HH:MM:SS.";
+    if (input === "") {
+        throw new error_1.AppError("ARGS_INVALID", "target timestamp is required", {
+            next_actions: ["Usage: miaoda db recovery diff|apply <timestamp>"],
+        });
+    }
+    if (/^\d{4}-\d{2}-\d{2}$/.test(input)) {
+        return new Date(`${input}T00:00:00Z`).toISOString();
+    }
+    if (/^\d{4}-\d{2}-\d{2} \d{2}:\d{2}(:\d{2})?$/.test(input)) {
+        const d = new Date(input.replace(" ", "T"));
+        if (Number.isNaN(d.getTime())) {
+            throw new error_1.AppError("INVALID_TIMESTAMP", `Invalid timestamp format '${input}'`, {
+                next_actions: [FORMAT_HINT],
+            });
+        }
+        return d.toISOString();
+    }
+    const d = new Date(input);
+    if (Number.isNaN(d.getTime())) {
+        throw new error_1.AppError("INVALID_TIMESTAMP", `Invalid timestamp format '${input}'`, {
+            next_actions: [FORMAT_HINT],
+        });
+    }
+    return d.toISOString();
+}
+// PRD diff 输出（结构化 prose）：
+//   Recovery preview (→ 2026-04-15T10:00:00Z):
+//
+//     tables affected: 2
+//     users:   +3 rows, -1 row, ~5 rows modified
+//     orders:  table will be restored (was dropped at 10:25:00)
+//
+//     estimated time: ~30s
+function renderDiff(result) {
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            target: result.target,
+            tablesAffected: result.tablesAffected,
+            changes: result.changes.map((c) => ({
+                table: c.table,
+                inserted: c.inserted,
+                deleted: c.deleted,
+                modified: c.modified,
+                action: c.action,
+                droppedAt: c.droppedAt,
+            })),
+            estimatedSeconds: result.estimatedSeconds ?? 0,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const arrow = tty ? "→" : "->";
+    if (result.changes.length === 0) {
+        (0, output_1.emit)(`Recovery preview (${arrow} ${result.target}):\n\n` +
+            `  No changes — database is already at this state.`);
+        return;
+    }
+    const lines = [
+        `Recovery preview (${arrow} ${result.target}):`,
+        "",
+        `  tables affected: ${String(result.tablesAffected)}`,
+    ];
+    for (const c of result.changes) {
+        lines.push(`  ${c.table}:  ${describeChange(c)}`);
+    }
+    if (result.estimatedSeconds !== undefined) {
+        lines.push("");
+        lines.push(`  estimated time: ~${String(result.estimatedSeconds)}s`);
+    }
+    (0, output_1.emit)(lines.join("\n"));
+}
+function describeChange(c) {
+    if (c.action === "restore_table" || c.action === "drop" || c.action === "create") {
+        const ts = c.droppedAt ? ` (was dropped at ${c.droppedAt})` : "";
+        if (c.action === "restore_table")
+            return `table will be restored${ts}`;
+        if (c.action === "drop")
+            return `table will be dropped${ts}`;
+        return `table will be created${ts}`;
+    }
+    const parts = [];
+    if (c.inserted !== undefined && c.inserted !== 0)
+        parts.push(`+${String(c.inserted)} rows`);
+    if (c.deleted !== undefined && c.deleted !== 0) {
+        parts.push(`-${String(c.deleted)} ${c.deleted === 1 ? "row" : "rows"}`);
+    }
+    if (c.modified !== undefined && c.modified !== 0)
+        parts.push(`~${String(c.modified)} rows modified`);
+    return parts.length === 0 ? "no changes" : parts.join(", ");
+}
+async function confirm(prompt) {
+    const rl = node_readline_1.default.createInterface({ input: process.stdin, output: process.stderr });
+    return new Promise((resolve) => {
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === "y");
+        });
+    });
+}

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

@@ -40,11 +40,17 @@ const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const render_1 = require("../../../utils/render");
 const shared_1 = require("../../../cli/commands/shared");
+const colors_1 = require("../../../utils/colors");
 const index_1 = require("../../../api/db/index");
 // ── schema list ──
 async function handleDbSchemaList(opts) {
     const appId = (0, shared_1.resolveAppId)(opts);
-    const resp = await api.db.getSchema({ appId, format: "schema", includeStats: true, dbBranch: opts.env });
+    const resp = await api.db.getSchema({
+        appId,
+        format: "schema",
+        includeStats: true,
+        dbBranch: opts.env,
+    });
     const tables = (0, index_1.flattenSchemaList)(resp.schema);
     if ((0, output_1.isJsonMode)()) {
         (0, output_1.emit)({ data: tables });
@@ -68,7 +74,7 @@ async function handleDbSchemaList(opts) {
         t.name,
         t.description ?? "—",
         t.estimated_row_count === null ? "—" : String(t.estimated_row_count),
-        t.size_bytes === null ? "—" : (tty ? (0, render_1.formatSize)(t.size_bytes) : String(t.size_bytes)),
+        t.size_bytes === null ? "—" : tty ? (0, render_1.formatSize)(t.size_bytes) : String(t.size_bytes),
         String(t.columns),
     ]);
     (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
@@ -108,9 +114,7 @@ async function handleDbSchemaGet(table, opts) {
     const detail = (0, index_1.pickTableDetail)(resp.schema, table);
     if (!detail) {
         throw new error_1.AppError("TABLE_NOT_FOUND", `Table '${table}' does not exist`, {
-            next_actions: [
-                `Did you mean another table? Run "miaoda db schema list" to see all tables.`,
-            ],
+            next_actions: [`Did you mean another table? Run "miaoda db schema list" to see all tables.`],
         });
     }
     if ((0, output_1.isJsonMode)()) {
@@ -127,7 +131,8 @@ function renderDetail(d, tty) {
     // 构造的伪时间戳（baseTime=2020-01-01 + OID 秒偏移），仅保排序意义、绝对值
     // 误导性强，先去掉。后续如果接 ddl_change_log 取真实时间再加回。
     const header = [
-        ["Name", d.name],
+        // 表名做 cyan 强调（spec：spec 里的"命令名/表名"类强调值都走 highlight）
+        ["Name", tty ? colors_1.c.highlight(d.name) : d.name],
         ["Description", d.description ?? "—"],
         [
             "Columns",
@@ -150,12 +155,21 @@ function renderDetail(d, tty) {
     parts.push((0, render_1.renderKeyValue)(header, tty));
     parts.push("");
     parts.push(tty ? (0, render_1.renderAlignedTable)(colHeaders, colRows) : (0, render_1.renderTsv)(colHeaders, colRows));
+    // Constraints 段（PRIMARY KEY / UNIQUE）：表级约束独立成段，与普通索引分离展示
+    if (d.constraints.length > 0) {
+        parts.push("");
+        parts.push(tty ? "  Constraints:" : "Constraints:");
+        for (const c of d.constraints) {
+            const line = `${c.type} (${c.columns.join(", ")})`;
+            parts.push(tty ? `    ${line}` : line);
+        }
+    }
+    // Indexes 段：普通索引，格式 "<name> ON <col1, col2> USING <method>"
     if (d.indexes.length > 0) {
         parts.push("");
         parts.push(tty ? "  Indexes:" : "Indexes:");
-        // PRD 格式: "TYPE (col1, col2)"，不展示索引名
         for (const idx of d.indexes) {
-            const line = `${idx.type} (${idx.columns.join(", ")})`;
+            const line = `${idx.name} ON ${idx.columns.join(", ")} USING ${idx.method}`;
             parts.push(tty ? `    ${line}` : line);
         }
     }