@lark-apaas/miaoda-cli 0.1.0 → 0.1.1

package/dist/cli/commands/shared.js

@@ -1,29 +1,28 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.appIdOption = appIdOption;
 exports.softRequiredOption = softRequiredOption;
 exports.resolveAppId = resolveAppId;
 exports.withHelp = withHelp;
 exports.failArgs = failArgs;
 const commander_1 = require("commander");
 const error_1 = require("../../utils/error");
-/** --app-id option，需要应用上下文的命令自行 .addOption(appIdOption()) */
-function appIdOption() {
-    return new commander_1.Option("--app-id <id>", "指定目标应用").env("MIAODA_APP_ID");
-}
 /**
  * soft-required: Commander 类型上 optional，runtime 校验必填。
  */
 function softRequiredOption(name, desc) {
     return new commander_1.Option(name, desc);
 }
-/** 解析 appId，CLI flag > env > 抛错 */
+/**
+ * 解析 appId，从环境变量 MIAODA_APP_ID 或 app_id（小写下划线，部分外部沙箱注入）读取。
+ * 缺失时抛 APP_ID_MISSING，由全局 catch 处理。
+ *
+ * opts 里仍保留 appId（可选），用于测试 / 高级场景显式注入；正常 CLI 不暴露此 flag。
+ */
 function resolveAppId(opts) {
-    const id = opts.appId ?? process.env.MIAODA_APP_ID;
+    const id = opts.appId ?? process.env.MIAODA_APP_ID ?? process.env.app_id;
     if (!id) {
         throw new error_1.AppError("APP_ID_MISSING", "未指定应用", {
             next_actions: [
-                "传入 --app-id <id>",
                 "设置 export MIAODA_APP_ID=<id>",
             ],
         });

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

@@ -0,0 +1,171 @@
+"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.handleDbDataImport = handleDbDataImport;
+exports.handleDbDataExport = handleDbDataExport;
+const fs = __importStar(require("node:fs/promises"));
+const path = __importStar(require("node:path"));
+const api = __importStar(require("../../../api/index"));
+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）
+const MAX_SIZE_BYTES = 1 * 1024 * 1024; // 1 MB
+const MAX_ROWS = 5000;
+async function handleDbDataImport(file, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const ext = path.extname(file).toLowerCase();
+    const format = resolveFormat(opts.format, ext, "import");
+    let body;
+    try {
+        body = await fs.readFile(file);
+    }
+    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 err;
+    }
+    if (body.length > MAX_SIZE_BYTES) {
+        throw new error_1.AppError("IMPORT_SIZE_EXCEEDED", `Import exceeds 1 MB limit (file is ${String(body.length)} bytes)`, { next_actions: ["Split the file into chunks of ≤ 5000 rows / 1 MB and import separately."] });
+    }
+    const rowCount = countRows(body, format);
+    if (rowCount > MAX_ROWS) {
+        throw new error_1.AppError("IMPORT_ROWS_EXCEEDED", `Import exceeds 5000 rows limit (file has ${String(rowCount)} rows)`, { next_actions: ["Split the file into chunks of ≤ 5000 rows / 1 MB and import separately."] });
+    }
+    const tableName = opts.table ?? path.basename(file, ext);
+    if (!tableName) {
+        throw new error_1.AppError("ARGS_INVALID", "Cannot infer target table from file name; specify --table");
+    }
+    const result = await api.db.importData({
+        appId,
+        tableName,
+        format,
+        body,
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({
+            data: {
+                file,
+                table: result.tableName,
+                rows: result.recordCount,
+            },
+        });
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    (0, output_1.emit)(tty
+        ? `✓ Imported ${file} → table '${result.tableName}' (${String(result.recordCount)} rows)`
+        : `OK Imported ${file} -> table '${result.tableName}' (${String(result.recordCount)} rows)`);
+}
+async function handleDbDataExport(table, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const format = resolveFormat(opts.format, undefined, "export", "csv");
+    const outputPath = opts.file ?? `${table}.${format}`;
+    const limit = opts.limit ? Number(opts.limit) : MAX_ROWS;
+    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)}`);
+    }
+    const result = await api.db.exportData({
+        appId,
+        tableName: table,
+        format,
+        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.`] });
+    }
+    await fs.writeFile(outputPath, result.body);
+    // 优先信任后端 X-Miaoda-Record-Count header；header 缺失时再用 body 行数兜底
+    const rows = result.recordCount ?? countRows(result.body, format);
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({
+            data: {
+                table,
+                file: outputPath,
+                format,
+                rows,
+            },
+        });
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    (0, output_1.emit)(tty
+        ? `✓ Exported ${table} → ${outputPath} (${String(rows)} rows)`
+        : `OK Exported ${table} -> ${outputPath} (${String(rows)} rows)`);
+}
+// ── 共用辅助 ──
+function resolveFormat(explicit, ext, scope, fallback) {
+    const raw = (explicit ?? ext ?? fallback ?? "").replace(/^\./, "").toLowerCase();
+    if (raw === "csv")
+        return "csv";
+    if (raw === "json")
+        return "json";
+    // sql 仅 export 路径接受 —— import 端后端仍只支持 csv/json。
+    if (raw === "sql" && scope === "export")
+        return "sql";
+    const code = scope === "import" ? "IMPORT_FORMAT_UNSUPPORTED" : "EXPORT_FORMAT_UNSUPPORTED";
+    throw new error_1.AppError(code, `Unrecognized format '${raw || "(unspecified)"}'`, {
+        next_actions: [
+            scope === "import"
+                ? "Supported formats: .csv, .json. Convert the file first, or rename with the correct extension."
+                : "Supported formats: csv, json, sql. Pass --format csv|json|sql.",
+        ],
+    });
+}
+function countRows(body, format) {
+    if (format === "csv") {
+        // 粗估：非空行数 - 表头 1 行
+        let lines = 0;
+        const text = body.toString("utf8");
+        for (const line of text.split(/\r?\n/)) {
+            if (line.length > 0)
+                lines += 1;
+        }
+        return Math.max(0, lines - 1);
+    }
+    // JSON：期望是顶层数组
+    try {
+        const parsed = JSON.parse(body.toString("utf8"));
+        if (Array.isArray(parsed))
+            return parsed.length;
+        return 1;
+    }
+    catch {
+        return 0;
+    }
+}

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

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+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");
+Object.defineProperty(exports, "handleDbSchemaList", { enumerable: true, get: function () { return schema_1.handleDbSchemaList; } });
+Object.defineProperty(exports, "handleDbSchemaGet", { enumerable: true, get: function () { return schema_1.handleDbSchemaGet; } });
+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; } });

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

@@ -0,0 +1,163 @@
+"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.handleDbSchemaList = handleDbSchemaList;
+exports.handleDbSchemaGet = handleDbSchemaGet;
+const api = __importStar(require("../../../api/index"));
+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 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 tables = (0, index_1.flattenSchemaList)(resp.schema);
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({ data: tables });
+        return;
+    }
+    if (tables.length === 0) {
+        (0, output_1.emit)("No tables found.");
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    // PRD 对齐：TTY 表头用 `size`（友好格式），non-TTY 用 `size_bytes`（原始整数）。
+    // updated_at 暂时不展示——PG pg_catalog 不存真实表时间，详见 renderDetail 注释。
+    const headers = [
+        "name",
+        "description",
+        "estimated_row_count",
+        tty ? "size" : "size_bytes",
+        "columns",
+    ];
+    const rows = tables.map((t) => [
+        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)),
+        String(t.columns),
+    ]);
+    (0, output_1.emit)(tty ? (0, render_1.renderAlignedTable)(headers, rows) : (0, render_1.renderTsv)(headers, rows));
+}
+async function handleDbSchemaGet(table, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const tty = (0, render_1.isStdoutTty)();
+    const forceDdl = Boolean(opts.ddl);
+    const wantsStructured = (0, output_1.isJsonMode)() || (tty && !forceDdl);
+    if (!wantsStructured) {
+        // non-TTY 或 --ddl：直接取完整 DDL 输出
+        const ddlResp = await api.db.getSchema({
+            appId,
+            format: "ddl",
+            tableNames: table,
+            dbBranch: opts.env,
+        });
+        const sql = ddlResp.ddl?.[table];
+        if (!sql) {
+            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.`,
+                ],
+            });
+        }
+        (0, output_1.emit)(sql.trimEnd());
+        return;
+    }
+    // TTY / JSON：取结构化
+    const resp = await api.db.getSchema({
+        appId,
+        format: "schema",
+        tableNames: table,
+        includeStats: true,
+        dbBranch: opts.env,
+    });
+    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.`,
+            ],
+        });
+    }
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)(detail);
+        return;
+    }
+    (0, output_1.emit)(renderDetail(detail, tty));
+}
+function renderDetail(d, tty) {
+    const systemFields = d.columns.filter((c) => c.name.startsWith("_"));
+    const userFields = d.columns.filter((c) => !c.name.startsWith("_"));
+    // header 布局：Name / Description / Columns(含"+ N system") / Estimated Rows / Size。
+    // 不展示 Created / Updated：PG pg_catalog 不存表创建时间，dataloom 用 OID
+    // 构造的伪时间戳（baseTime=2020-01-01 + OID 秒偏移），仅保排序意义、绝对值
+    // 误导性强，先去掉。后续如果接 ddl_change_log 取真实时间再加回。
+    const header = [
+        ["Name", d.name],
+        ["Description", d.description ?? "—"],
+        [
+            "Columns",
+            systemFields.length > 0
+                ? `${String(userFields.length)} (+ ${String(systemFields.length)} system)`
+                : String(userFields.length),
+        ],
+        ["Estimated Rows", d.estimated_row_count === null ? "—" : String(d.estimated_row_count)],
+        ["Size", d.size_bytes === null ? "—" : (0, render_1.formatSize)(d.size_bytes)],
+    ];
+    const colHeaders = ["column", "type", "nullable", "default", "comment"];
+    const colRows = userFields.map((c) => [
+        c.name,
+        c.type,
+        c.nullable ? "yes" : "no",
+        c.default ?? "—",
+        c.comment ?? "—",
+    ]);
+    const parts = [];
+    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));
+    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(", ")})`;
+            parts.push(tty ? `    ${line}` : line);
+        }
+    }
+    return parts.join("\n");
+}