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

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

@@ -0,0 +1,316 @@
+"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.handleDbAuditStatus = handleDbAuditStatus;
+exports.handleDbAuditEnable = handleDbAuditEnable;
+exports.handleDbAuditDisable = handleDbAuditDisable;
+exports.handleDbAuditList = handleDbAuditList;
+const api = __importStar(require("../../../api/index"));
+const index_1 = require("../../../api/file/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");
+const index_2 = require("../../../api/db/index");
+const VALID_RETENTION = new Set(["7d", "30d", "180d", "360d", "forever"]);
+async function handleDbAuditStatus(table, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const sql = table !== undefined && table !== ""
+        ? `SELECT "table", enabled, enabled_at, retention FROM _dl_audit_config WHERE "table" = '${escapeSqlLiteral(table)}'`
+        : `SELECT "table", enabled, enabled_at, retention FROM _dl_audit_config ORDER BY "table"`;
+    const results = await api.db.execSql({ appId, sql, dbBranch: opts.env });
+    const rows = collectSelectRows(results);
+    // 单表查询且 _dl_audit_config 没记录 → enabled=false 占位
+    if (table !== undefined && table !== "" && rows.length === 0) {
+        rows.push({ table, enabled: false });
+    }
+    const items = rows.map(toAuditStatus);
+    // PRD JSON：单表返 object，多表返 array
+    if ((0, output_1.isJsonMode)()) {
+        if (table !== undefined && items.length === 1) {
+            (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(items[0]));
+        }
+        else {
+            (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(items));
+        }
+        return;
+    }
+    if (items.length === 0) {
+        (0, output_1.emit)("No audit configuration found.");
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // 单表 → key:value 形态（PRD 示例）
+    if (table !== undefined && items.length === 1) {
+        const it = items[0];
+        (0, output_1.emit)((0, render_1.renderKeyValue)([
+            ["Table", it.table],
+            ["Enabled", boolToYesNo(it.enabled)],
+            ["Enabled at", it.enabled_at ? (0, render_1.formatTime)(it.enabled_at, tty) : "—"],
+            ["Retention", it.retention ?? "—"],
+        ], tty));
+        return;
+    }
+    // 列表 → table 形态
+    const headers = ["table", "enabled", "enabled_at", "retention"];
+    const out = items.map((it) => [
+        it.table,
+        boolToYesNo(it.enabled),
+        it.enabled_at ? (0, render_1.formatTime)(it.enabled_at, tty) : "—",
+        it.retention ?? "—",
+    ]);
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, out) : (0, render_1.renderTsv)(headers, out));
+}
+function toAuditStatus(row) {
+    // retention 列存的是后端 ValidDay (int64 天数)，按 sentinel 反向映射成 PRD 字符串
+    const rawRetention = row.retention;
+    let retention = null;
+    if (rawRetention != null) {
+        if (typeof rawRetention === "number") {
+            retention = retentionDaysToString(rawRetention);
+        }
+        else if (typeof rawRetention === "string") {
+            // 兼容存的就是字符串形态（"7d" / "forever"）
+            retention = rawRetention;
+        }
+    }
+    return {
+        table: asString(row.table),
+        enabled: Boolean(row.enabled),
+        enabled_at: row.enabled_at == null ? null : asString(row.enabled_at),
+        retention,
+    };
+}
+async function handleDbAuditEnable(table, opts) {
+    if (!table) {
+        throw new error_1.AppError("ARGS_INVALID", "table name is required", {
+            next_actions: [
+                "Usage: miaoda db audit enable <table> [--retention 7d|30d|180d|360d|forever]",
+            ],
+        });
+    }
+    const retention = opts.retention ?? "7d";
+    if (!VALID_RETENTION.has(retention)) {
+        throw new error_1.AppError("INVALID_RETENTION", `Invalid retention '${retention}'`, {
+            next_actions: ["Allowed values: 7d, 30d, 180d, 360d, forever."],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const status = await api.db.setAuditConfig({
+        appId,
+        table,
+        enabled: true,
+        retention,
+        dbBranch: opts.env,
+    });
+    // PRD JSON：{"data": {"table": "...", "enabled": true, "retention": "..."}}
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            table: status.table,
+            enabled: status.enabled,
+            retention: status.retention ?? retention,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const prefix = tty ? "✓" : "OK";
+    (0, output_1.emit)(`${prefix} Audit enabled for table '${status.table}' (retention: ${status.retention ?? retention})`);
+}
+async function handleDbAuditDisable(table, opts) {
+    if (!table) {
+        throw new error_1.AppError("ARGS_INVALID", "table name is required", {
+            next_actions: ["Usage: miaoda db audit disable <table>"],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const status = await api.db.setAuditConfig({
+        appId,
+        table,
+        enabled: false,
+        dbBranch: opts.env,
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            table: status.table,
+            enabled: status.enabled,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const prefix = tty ? "✓" : "OK";
+    (0, output_1.emit)(`${prefix} Audit disabled for table '${status.table}'`);
+}
+async function handleDbAuditList(tables, opts) {
+    if (tables.length === 0) {
+        throw new error_1.AppError("ARGS_INVALID", "at least one table is required", {
+            next_actions: [
+                "Usage: miaoda db audit list <table> [<table>...] [--since ...] [--until ...]",
+            ],
+        });
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const limit = opts.limit ?? 20;
+    // since 优先级：opts.cursor（前一页末条 event_time）> opts.since
+    const sinceRaw = opts.cursor ?? opts.since;
+    const since = normalizeTime(sinceRaw, "--since/--cursor");
+    const until = normalizeTime(opts.until, "--until");
+    const inList = tables.map((t) => `'${escapeSqlLiteral(t)}'`).join(",");
+    const whereParts = [`target_table IN (${inList})`];
+    if (since !== undefined)
+        whereParts.push(`event_time >= '${since}'`);
+    if (until !== undefined)
+        whereParts.push(`event_time <= '${until}'`);
+    const sql = `SELECT event_id, event_time, target_table, type, operator, summary, details ` +
+        `FROM _dl_audit_log WHERE ${whereParts.join(" AND ")} ORDER BY event_time DESC LIMIT ${String(limit + 1)}`;
+    const results = await api.db.execSql({ appId, sql, dbBranch: opts.env });
+    const allRows = collectSelectRows(results);
+    const hasMore = allRows.length > limit;
+    const visible = hasMore ? allRows.slice(0, limit) : allRows;
+    const nextCursor = hasMore && visible.length > 0 ? asString(visible[visible.length - 1].event_time) : null;
+    // 多表混合时统计哪些表无记录
+    const seen = new Set();
+    for (const r of visible)
+        seen.add(asString(r.target_table));
+    const skipped = tables.filter((t) => !seen.has(t));
+    // PRD JSON：data 是数组，元素是事件对象（snake_case），分页信封 next_cursor / has_more
+    if ((0, output_1.isJsonMode)()) {
+        const items = visible.map((r) => ({
+            event_id: asString(r.event_id),
+            event_time: asString(r.event_time),
+            target_table: asString(r.target_table),
+            type: asString(r.type),
+            operator: asString(r.operator),
+            summary: asString(r.summary),
+            details: r.details, // 已经是结构化 JSON，透传
+        }));
+        (0, output_1.emitPaged)(items, nextCursor, hasMore);
+        if (skipped.length > 0) {
+            process.stderr.write(`(${String(skipped.length)} table(s) skipped: ${skipped.join(", ")})\n`);
+        }
+        if (visible.length === 0)
+            process.exitCode = 1;
+        return;
+    }
+    if (visible.length === 0) {
+        (0, output_1.emit)("No audit log entries found.");
+        if (skipped.length > 0) {
+            process.stderr.write(`(${String(skipped.length)} table(s) skipped: ${skipped.join(", ")})\n`);
+        }
+        process.exitCode = 1;
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // PRD：多表渲染时第一列是 target_table，单表时去掉这一列
+    const isMultiTable = tables.length > 1;
+    const headers = isMultiTable
+        ? ["target_table", "event_time", "type", "event_id", "operator", "summary"]
+        : ["event_time", "type", "event_id", "operator", "summary"];
+    const rows = visible.map((it) => {
+        const eventTime = (0, render_1.formatTime)(asString(it.event_time), tty);
+        const eventId = truncateId(asString(it.event_id));
+        const cells = [
+            eventTime,
+            asString(it.type),
+            eventId,
+            asString(it.operator, "—"),
+            asString(it.summary),
+        ];
+        return isMultiTable ? [asString(it.target_table), ...cells] : cells;
+    });
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
+    if (skipped.length > 0) {
+        process.stderr.write(`(${String(skipped.length)} table(s) skipped: ${skipped.join(", ")})\n`);
+    }
+    if (hasMore && nextCursor) {
+        process.stderr.write(`(more results; use --cursor '${nextCursor}')\n`);
+    }
+}
+// ── helpers ──
+function normalizeTime(input, flagName) {
+    if (input === undefined || input === "")
+        return undefined;
+    // ISO 8601 直接透传，避免 parseTimeFilterMs 在严格 ISO 上重做一次损精度
+    if (/^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(?:\.\d+)?(?:Z|[+-]\d{2}:?\d{2})$/.test(input)) {
+        return new Date(input).toISOString();
+    }
+    const ms = (0, index_1.parseTimeFilterMs)(input, flagName);
+    return new Date(ms).toISOString();
+}
+function collectSelectRows(results) {
+    const out = [];
+    for (const r of results) {
+        const parsed = (0, index_2.parseSqlResult)(r);
+        if (parsed.kind === "select")
+            out.push(...parsed.rows);
+    }
+    return out;
+}
+// SQL 字面量转义。表名 / 时间戳由调用方控制范围（白名单或严格 ISO 8601 正则）。
+function escapeSqlLiteral(s) {
+    return s.replace(/'/g, "''");
+}
+// PRD 输出 enabled 列用 yes/no 而非 true/false
+function boolToYesNo(b) {
+    return b ? "yes" : "no";
+}
+// 后端 ValidDay (int64 天数) → PRD retention 字符串。-1 = 永久（前端 / 后端约定）
+function retentionDaysToString(days) {
+    if (days === -1)
+        return "forever";
+    if (days === 7)
+        return "7d";
+    if (days === 30)
+        return "30d";
+    if (days === 180)
+        return "180d";
+    if (days === 360)
+        return "360d";
+    return `${String(days)}d`;
+}
+function asString(v, fallback = "") {
+    if (v == null)
+        return fallback;
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean" || typeof v === "bigint")
+        return String(v);
+    return JSON.stringify(v);
+}
+// audit list 的 event_id 在 TTY 视图里截断展示（PRD 示例 "01525416B44F..."）
+function truncateId(id) {
+    if (id.length <= 12)
+        return id;
+    return id.slice(0, 12) + "...";
+}

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

@@ -0,0 +1,117 @@
+"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.handleDbChangelog = handleDbChangelog;
+const api = __importStar(require("../../../api/index"));
+const index_1 = require("../../../api/file/index");
+const shared_1 = require("../../../cli/commands/shared");
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+function toRow(it) {
+    return {
+        change_id: it.changeId,
+        changed_at: it.changedAt,
+        operator: it.operator,
+        target_table: it.targetTable,
+        change_type: it.changeType,
+        summary: it.summary,
+        statement: it.statement,
+    };
+}
+/** 把用户传入的 since/until 归一成 ISO 8601 UTC 字符串；空串返 undefined。 */
+function normalizeTime(input, flagName) {
+    if (input === undefined || input === "")
+        return undefined;
+    const ms = (0, index_1.parseTimeFilterMs)(input, flagName);
+    return new Date(ms).toISOString();
+}
+async function handleDbChangelog(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const since = normalizeTime(opts.since, "--since");
+    const until = normalizeTime(opts.until, "--until");
+    const allItems = [];
+    let cursor = opts.cursor;
+    let lastCursor = null;
+    let lastHasMore = false;
+    // --all：循环到 hasMore=false；否则只拉一页
+    // 没传 --all 时翻页由调用方自己用 --cursor 串
+    for (;;) {
+        const page = await api.db.listDDLChangelog({
+            appId,
+            table: opts.table,
+            since,
+            until,
+            limit: opts.limit,
+            cursor,
+            dbBranch: opts.env,
+        });
+        allItems.push(...page.items);
+        lastCursor = page.nextCursor;
+        lastHasMore = page.hasMore;
+        if (!opts.all || !page.hasMore || !page.nextCursor)
+            break;
+        cursor = page.nextCursor;
+    }
+    if ((0, output_1.isJsonMode)()) {
+        const rows = allItems.map(toRow);
+        // --all 时已经把所有页合一起返，has_more=false / next_cursor=null
+        if (opts.all) {
+            (0, output_1.emitPaged)((0, output_1.snakeCaseKeys)(rows), null, false);
+        }
+        else {
+            (0, output_1.emitPaged)((0, output_1.snakeCaseKeys)(rows), lastCursor, lastHasMore);
+        }
+        return;
+    }
+    if (allItems.length === 0) {
+        (0, output_1.emit)("No DDL changes found.");
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // PRD: change_id / changed_at / operator / target_table / change_type / summary
+    const headers = ["change_id", "changed_at", "operator", "target_table", "change_type", "summary"];
+    const rows = allItems.map((it) => [
+        it.changeId,
+        (0, render_1.formatTime)(it.changedAt, tty),
+        it.operator || "—",
+        it.targetTable || "—",
+        it.changeType,
+        it.summary || "—",
+    ]);
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
+    if (!opts.all && lastHasMore && lastCursor) {
+        process.stderr.write(`(more results; use --cursor ${lastCursor} or --all)\n`);
+    }
+}

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

@@ -42,7 +42,7 @@ const error_1 = require("../../../utils/error");
 const output_1 = require("../../../utils/output");
 const shared_1 = require("../../../cli/commands/shared");
 const render_1 = require("../../../utils/render");
-// P0 规格（对齐技术方案关键决策 2）
+// import / export 体积上限
 const MAX_SIZE_BYTES = 1 * 1024 * 1024; // 1 MB
 const MAX_ROWS = 5000;
 async function handleDbDataImport(file, opts) {
@@ -56,7 +56,9 @@ async function handleDbDataImport(file, opts) {
     catch (err) {
         const code = err.code;
         if (code === "ENOENT") {
-            throw new error_1.AppError("IMPORT_FILE_NOT_FOUND", `Local file '${file}' does not exist`, { next_actions: ["Check the file path."] });
+            throw new error_1.AppError("IMPORT_FILE_NOT_FOUND", `Local file '${file}' does not exist`, {
+                next_actions: ["Check the file path."],
+            });
         }
         throw err;
     }
@@ -100,6 +102,20 @@ async function handleDbDataExport(table, opts) {
     if (!Number.isInteger(limit) || limit <= 0 || limit > MAX_ROWS) {
         throw new error_1.AppError("ARGS_INVALID", `--limit must be a positive integer ≤ ${String(MAX_ROWS)}`);
     }
+    if (!opts.force) {
+        try {
+            await fs.access(outputPath);
+            throw new error_1.AppError("FILE_ALREADY_EXISTS", `Output file '${outputPath}' already exists`, {
+                next_actions: ["Use -f to specify a different path, or --force to overwrite."],
+            });
+        }
+        catch (err) {
+            if (err instanceof error_1.AppError)
+                throw err;
+            if (err.code !== "ENOENT")
+                throw err;
+        }
+    }
     const result = await api.db.exportData({
         appId,
         tableName: table,
@@ -107,7 +123,11 @@ async function handleDbDataExport(table, opts) {
         limit,
     });
     if (result.body.length > MAX_SIZE_BYTES) {
-        throw new error_1.AppError("EXPORT_SIZE_EXCEEDED", `Export exceeds 1 MB limit (body is ${String(result.body.length)} bytes)`, { next_actions: [`Filter the table with "miaoda db sql" (e.g. WHERE/LIMIT) and export smaller subsets.`] });
+        throw new error_1.AppError("EXPORT_SIZE_EXCEEDED", `Export exceeds 1 MB limit (body is ${String(result.body.length)} bytes)`, {
+            next_actions: [
+                `Filter the table with "miaoda db sql" (e.g. WHERE/LIMIT) and export smaller subsets.`,
+            ],
+        });
     }
     await fs.writeFile(outputPath, result.body);
     // 优先信任后端 X-Miaoda-Record-Count header；header 缺失时再用 body 行数兜底

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

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.handleDbDataExport = exports.handleDbDataImport = exports.handleDbSchemaGet = exports.handleDbSchemaList = exports.handleDbSql = void 0;
+exports.handleDbQuota = exports.handleDbRecoveryApply = exports.handleDbRecoveryDiff = exports.handleDbMigrationApply = exports.handleDbMigrationDiff = exports.handleDbMigrationInit = exports.handleDbAuditList = exports.handleDbAuditDisable = exports.handleDbAuditEnable = exports.handleDbAuditStatus = exports.handleDbChangelog = exports.handleDbDataExport = exports.handleDbDataImport = exports.handleDbSchemaGet = exports.handleDbSchemaList = exports.handleDbSql = void 0;
 var sql_1 = require("./sql");
 Object.defineProperty(exports, "handleDbSql", { enumerable: true, get: function () { return sql_1.handleDbSql; } });
 var schema_1 = require("./schema");
@@ -9,3 +9,19 @@ Object.defineProperty(exports, "handleDbSchemaGet", { enumerable: true, get: fun
 var data_1 = require("./data");
 Object.defineProperty(exports, "handleDbDataImport", { enumerable: true, get: function () { return data_1.handleDbDataImport; } });
 Object.defineProperty(exports, "handleDbDataExport", { enumerable: true, get: function () { return data_1.handleDbDataExport; } });
+var changelog_1 = require("./changelog");
+Object.defineProperty(exports, "handleDbChangelog", { enumerable: true, get: function () { return changelog_1.handleDbChangelog; } });
+var audit_1 = require("./audit");
+Object.defineProperty(exports, "handleDbAuditStatus", { enumerable: true, get: function () { return audit_1.handleDbAuditStatus; } });
+Object.defineProperty(exports, "handleDbAuditEnable", { enumerable: true, get: function () { return audit_1.handleDbAuditEnable; } });
+Object.defineProperty(exports, "handleDbAuditDisable", { enumerable: true, get: function () { return audit_1.handleDbAuditDisable; } });
+Object.defineProperty(exports, "handleDbAuditList", { enumerable: true, get: function () { return audit_1.handleDbAuditList; } });
+var migration_1 = require("./migration");
+Object.defineProperty(exports, "handleDbMigrationInit", { enumerable: true, get: function () { return migration_1.handleDbMigrationInit; } });
+Object.defineProperty(exports, "handleDbMigrationDiff", { enumerable: true, get: function () { return migration_1.handleDbMigrationDiff; } });
+Object.defineProperty(exports, "handleDbMigrationApply", { enumerable: true, get: function () { return migration_1.handleDbMigrationApply; } });
+var recovery_1 = require("./recovery");
+Object.defineProperty(exports, "handleDbRecoveryDiff", { enumerable: true, get: function () { return recovery_1.handleDbRecoveryDiff; } });
+Object.defineProperty(exports, "handleDbRecoveryApply", { enumerable: true, get: function () { return recovery_1.handleDbRecoveryApply; } });
+var quota_1 = require("./quota");
+Object.defineProperty(exports, "handleDbQuota", { enumerable: true, get: function () { return quota_1.handleDbQuota; } });

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

@@ -0,0 +1,145 @@
+"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.handleDbMigrationInit = handleDbMigrationInit;
+exports.handleDbMigrationDiff = handleDbMigrationDiff;
+exports.handleDbMigrationApply = handleDbMigrationApply;
+const node_readline_1 = __importDefault(require("node:readline"));
+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 handleDbMigrationInit(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    // 不可逆操作，TTY 默认要求 y/N；--yes 跳过
+    if (!opts.yes && !(0, output_1.isJsonMode)()) {
+        const ok = await confirm(`? Initialize multi-env (single → dev/online), this is IRREVERSIBLE${opts.syncData ? " and will copy existing data to dev" : ""}? (y/N) `);
+        if (!ok) {
+            (0, output_1.emit)("Aborted.");
+            return;
+        }
+    }
+    const result = await api.db.migrationInit({ appId, syncData: opts.syncData });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)(result));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    (0, output_1.emit)((0, render_1.renderKeyValue)([
+        ["Status", result.status],
+        ["Environments", result.environments.join(", ")],
+        ["Data synced", String(result.dataSynced)],
+    ], tty));
+}
+async function handleDbMigrationDiff(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const result = await api.db.migrate({ appId, dryRun: true });
+    renderDiff(result);
+}
+async function handleDbMigrationApply(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    // TTY 下先 diff 给用户审；--yes 直接打到 online
+    if (!opts.yes && !(0, output_1.isJsonMode)()) {
+        const preview = await api.db.migrate({ appId, dryRun: true });
+        if (preview.changes.length === 0) {
+            (0, output_1.emit)(`Error: No pending changes between ${preview.from} and ${preview.to}`);
+            (0, output_1.emit)(`  hint: Make schema changes in dev first.`);
+            process.exitCode = 1;
+            return;
+        }
+        renderDiff(preview);
+        const ok = await confirm(`? Apply ${String(preview.changes.length)} change(s) to ${preview.to}? (y/N) `);
+        if (!ok) {
+            (0, output_1.emit)("Aborted.");
+            return;
+        }
+    }
+    const result = await api.db.migrate({ appId, dryRun: false });
+    if ((0, output_1.isJsonMode)()) {
+        // PRD：{"status": "applied", "from": "dev", "to": "online", "changes_applied": 2}
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            status: result.status ?? "applied",
+            from: result.from,
+            to: result.to,
+            changesApplied: result.changesApplied ?? result.changes.length,
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const prefix = tty ? "✓" : "OK";
+    const arrow = tty ? "→" : "->";
+    const applied = result.changesApplied ?? result.changes.length;
+    (0, output_1.emit)(`${prefix} Applied ${result.from} ${arrow} ${result.to} (${String(applied)} changes)`);
+}
+// ── helpers ──
+// PRD diff 输出：
+//   dev → online (2 changes):
+//
+//     ALTER TABLE users ADD COLUMN avatar_url text;
+//     CREATE INDEX idx_users_avatar ON users(avatar_url);
+function renderDiff(result) {
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)((0, output_1.snakeCaseKeys)({
+            from: result.from,
+            to: result.to,
+            changes: result.changes.map((c) => ({
+                type: c.type,
+                table: c.table,
+                statement: c.statement,
+            })),
+        }));
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    if (result.changes.length === 0) {
+        (0, output_1.emit)(`No pending changes from ${result.from} to ${result.to}.`);
+        return;
+    }
+    const arrow = tty ? "→" : "->";
+    (0, output_1.emit)(`${result.from} ${arrow} ${result.to} (${String(result.changes.length)} changes):\n\n` +
+        result.changes.map((c) => `  ${c.statement}`).join("\n"));
+}
+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");
+        });
+    });
+}