@lark-apaas/miaoda-cli 0.1.0-alpha.097a394

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

@@ -0,0 +1,173 @@
+"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.handleDbSql = handleDbSql;
+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 shared_2 = require("../../../cli/handlers/shared");
+const index_1 = require("../../../api/db/index");
+/**
+ * miaoda db sql <query> — 执行任意 SQL。
+ *
+ * - query 为空时读 stdin
+ * - --env 在 P0 阶段不开放（返回 MULTI_ENV_NOT_INITIALIZED）
+ * - 多条语句时只展示最后一条的结果（与 PRD 对齐）；所有为 DDL 时展示批量摘要
+ */
+async function handleDbSql(query, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    if (opts.env && opts.env.length > 0) {
+        throw new error_1.AppError("MULTI_ENV_NOT_INITIALIZED", "--env is not available (multi-env not initialized)", {
+            next_actions: [
+                "Current app uses a single database for dev and production.",
+                'Run "miaoda db migration init" to set up multi-env.',
+            ],
+        });
+    }
+    const sql = await readSql(query);
+    if (!sql.trim()) {
+        throw new error_1.AppError("ARGS_INVALID", "Empty SQL (no inline query and stdin is empty)");
+    }
+    const results = await api.db.execSql({ appId, sql });
+    if (results.length === 0) {
+        // 后端未返回任何结果，通常不会发生
+        if ((0, output_1.isJsonMode)()) {
+            (0, output_1.emit)({ data: [] });
+            return;
+        }
+        (0, output_1.emit)("✓ No results");
+        return;
+    }
+    // 全部 DDL 的批量场景：展示统计摘要（对齐 PRD `✓ 3 statements executed`）
+    const allDdl = results.every((r) => r.sqlType === "DDL");
+    if (allDdl && results.length > 1) {
+        if ((0, output_1.isJsonMode)()) {
+            (0, output_1.emit)({ data: { statements: results.length } });
+            return;
+        }
+        const tty = (0, shared_2.isStdoutTty)();
+        (0, output_1.emit)(tty
+            ? `✓ ${String(results.length)} statements executed`
+            : `OK ${String(results.length)} statements executed`);
+        return;
+    }
+    // 其他场景：展示最后一条
+    const last = results[results.length - 1];
+    renderSingle(last);
+}
+/** 读取 stdin 并返回完整 SQL 文本（stdin 不是 TTY 即认为被 pipe）。 */
+async function readSql(inline) {
+    if (inline !== undefined && inline.length > 0)
+        return inline;
+    const stdin = process.stdin;
+    if (stdin.isTTY)
+        return "";
+    return new Promise((resolve, reject) => {
+        let data = "";
+        process.stdin.setEncoding("utf8");
+        process.stdin.on("data", (chunk) => {
+            data += chunk;
+        });
+        process.stdin.on("end", () => {
+            resolve(data);
+        });
+        process.stdin.on("error", reject);
+    });
+}
+function renderSingle(raw) {
+    const parsed = (0, index_1.parseSqlResult)(raw);
+    const tty = (0, shared_2.isStdoutTty)();
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)(toJson(parsed));
+        return;
+    }
+    if (parsed.kind === "select") {
+        if (parsed.rows.length === 0) {
+            (0, output_1.emit)("(0 rows)");
+            return;
+        }
+        const cols = collectColumns(parsed.rows);
+        const rows = parsed.rows.map((r) => cols.map((c) => formatCell(r[c])));
+        (0, output_1.emit)(tty ? (0, shared_2.renderAlignedTable)(cols, rows) : (0, shared_2.renderTsv)(cols, rows));
+        return;
+    }
+    if (parsed.kind === "dml") {
+        const verb = dmlVerb(parsed.sqlType);
+        (0, output_1.emit)(tty
+            ? `✓ ${String(parsed.affectedRows)} row${parsed.affectedRows === 1 ? "" : "s"} ${verb}`
+            : `OK ${String(parsed.affectedRows)} rows ${verb}`);
+        return;
+    }
+    // DDL
+    (0, output_1.emit)(tty ? "✓ DDL executed" : "OK DDL executed");
+}
+function toJson(parsed) {
+    if (parsed.kind === "select") {
+        return { data: parsed.rows };
+    }
+    if (parsed.kind === "dml") {
+        return {
+            data: {
+                sql_type: parsed.sqlType.toLowerCase(),
+                affected_rows: parsed.affectedRows,
+            },
+        };
+    }
+    return { data: { sql_type: "ddl" } };
+}
+function dmlVerb(type) {
+    switch (type) {
+        case "INSERT": return "inserted";
+        case "UPDATE": return "updated";
+        case "DELETE": return "deleted";
+    }
+}
+/** 从第一行收集列顺序；缺失列保留空白（兼容稀疏行）。 */
+function collectColumns(rows) {
+    if (rows.length === 0)
+        return [];
+    return Object.keys(rows[0]);
+}
+function formatCell(v) {
+    if (v === null || v === undefined)
+        return "—";
+    if (typeof v === "string")
+        return v;
+    if (typeof v === "number" || typeof v === "boolean")
+        return String(v);
+    // object / array → JSON
+    return JSON.stringify(v);
+}

package/dist/cli/handlers/file/cp.js

@@ -0,0 +1,220 @@
+"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.handleFileCp = handleFileCp;
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+const node_os_1 = __importDefault(require("node:os"));
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const error_1 = require("../../../utils/error");
+const shared_1 = require("../../../cli/commands/shared");
+const helpers_1 = require("./helpers");
+const MAX_UPLOAD_BYTES = 100 * 1024 * 1024;
+/**
+ * 判断 src 是本地文件还是远程引用：
+ * - src 本地 fs 可访问 → upload（dst 当 remote）
+ * - 其他 → download（src 是 /path 或 file_name，由 resolveRemotePath 解析）
+ *
+ * `cp` 语义要求 src 必须存在；本地不存在就认为用户指向远程。不需要给 dst 猜方向。
+ */
+function isLocalSrc(src) {
+    const expanded = expandHome(src);
+    try {
+        return node_fs_1.default.existsSync(expanded);
+    }
+    catch {
+        return false;
+    }
+}
+function expandHome(p) {
+    if (p.startsWith("~/"))
+        return node_path_1.default.join(node_os_1.default.homedir(), p.slice(2));
+    return p;
+}
+function detectMime(filePath) {
+    const ext = node_path_1.default.extname(filePath).toLowerCase();
+    const map = {
+        ".png": "image/png",
+        ".jpg": "image/jpeg",
+        ".jpeg": "image/jpeg",
+        ".gif": "image/gif",
+        ".webp": "image/webp",
+        ".svg": "image/svg+xml",
+        ".pdf": "application/pdf",
+        ".json": "application/json",
+        ".csv": "text/csv",
+        ".txt": "text/plain",
+        ".html": "text/html",
+        ".zip": "application/zip",
+        ".tar": "application/x-tar",
+        ".gz": "application/gzip",
+        ".mp4": "video/mp4",
+        ".mp3": "audio/mpeg",
+    };
+    return map[ext] ?? "application/octet-stream";
+}
+/** 把 src 的远程形式（`/path` / `file_name`）解析成后端 sign 可用的 remote path。 */
+async function resolveRemotePath(appId, input) {
+    if (input.startsWith("/"))
+        return input;
+    const [resolved] = await api.file.resolveInputs({ appId, inputs: [input] });
+    if (resolved.status === "error") {
+        throw new error_1.AppError(resolved.error.code, resolved.error.message, {
+            next_actions: resolved.error.hint ? [resolved.error.hint] : undefined,
+        });
+    }
+    return resolved.file.path;
+}
+async function handleUpload(appId, localRaw, remoteRaw, rename) {
+    const localPath = expandHome(localRaw);
+    if (!node_fs_1.default.existsSync(localPath) || !node_fs_1.default.statSync(localPath).isFile()) {
+        throw new error_1.AppError("FILE_SRC_NOT_FOUND", `Local file '${localRaw}' does not exist`);
+    }
+    const stat = node_fs_1.default.statSync(localPath);
+    if (stat.size > MAX_UPLOAD_BYTES) {
+        throw new error_1.AppError("FILE_SIZE_EXCEEDED", `File size ${(0, helpers_1.formatSize)(stat.size)} exceeds the 100 MB upload limit`, {
+            next_actions: [
+                "Split the file, or use the web console for large uploads.",
+            ],
+        });
+    }
+    const fileName = rename ?? node_path_1.default.basename(localPath);
+    let remotePath = remoteRaw;
+    if (remoteRaw.endsWith("/")) {
+        remotePath = remoteRaw + fileName;
+    }
+    else if (remoteRaw === "/") {
+        remotePath = "/" + fileName;
+    }
+    const contentType = detectMime(localPath);
+    const result = await api.file.uploadFile({
+        appId,
+        localPath,
+        remotePath,
+        fileName,
+        fileSize: stat.size,
+        contentType,
+        readFile: async () => node_fs_1.default.promises.readFile(localPath),
+    });
+    if ((0, output_1.isJsonMode)()) {
+        const payload = {
+            file_name: result.file_name,
+            path: result.path,
+            size_bytes: result.size,
+            type: result.type,
+        };
+        if (result.download_url)
+            payload.download_url = result.download_url;
+        (0, helpers_1.emitOk)(payload);
+        return;
+    }
+    const tty = (0, helpers_1.isStdoutTty)();
+    const lines = [];
+    if (tty) {
+        lines.push(`✓ Uploaded ${node_path_1.default.basename(localPath)} → ${result.path}`);
+        lines.push(`   file_name:     ${result.file_name}`);
+        lines.push(`   path:          ${result.path}`);
+        lines.push(`   size:          ${(0, helpers_1.formatSize)(result.size)} (${String(result.size)} bytes)`);
+        lines.push(`   type:          ${result.type}`);
+        if (result.download_url) {
+            lines.push(`   download_url:  ${result.download_url}`);
+        }
+    }
+    else {
+        lines.push(`OK Uploaded ${node_path_1.default.basename(localPath)} -> ${result.path}`);
+        lines.push(`file_name\t${result.file_name}`);
+        lines.push(`path\t${result.path}`);
+        lines.push(`size\t${String(result.size)}`);
+        lines.push(`type\t${result.type}`);
+        if (result.download_url) {
+            lines.push(`download_url\t${result.download_url}`);
+        }
+    }
+    (0, output_1.emit)(lines.join("\n"));
+}
+async function handleDownload(appId, remoteRaw, localRaw) {
+    const filePath = await resolveRemotePath(appId, remoteRaw);
+    const sign = await api.file.signDownload({
+        appId,
+        filePath,
+        expiresIn: 300,
+    });
+    const baseName = node_path_1.default.basename(filePath);
+    let localTarget = expandHome(localRaw);
+    if (localTarget === "./" || localTarget === "." || localTarget.endsWith("/")) {
+        localTarget = node_path_1.default.join(localTarget, baseName);
+    }
+    else if (node_fs_1.default.existsSync(localTarget) && node_fs_1.default.statSync(localTarget).isDirectory()) {
+        localTarget = node_path_1.default.join(localTarget, baseName);
+    }
+    let writtenBytes = 0;
+    await api.file.downloadFile({
+        signedURL: sign.signed_url,
+        writeFile: async (buf) => {
+            await node_fs_1.default.promises.mkdir(node_path_1.default.dirname(node_path_1.default.resolve(localTarget)), {
+                recursive: true,
+            });
+            await node_fs_1.default.promises.writeFile(localTarget, buf);
+            writtenBytes = buf.length;
+        },
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, helpers_1.emitOk)({
+            path: filePath,
+            local_path: localTarget,
+            size: writtenBytes,
+        });
+        return;
+    }
+    const tty = (0, helpers_1.isStdoutTty)();
+    if (tty) {
+        (0, output_1.emit)(`✓ Downloaded ${baseName} → ${localTarget} (${(0, helpers_1.formatSize)(writtenBytes)})`);
+    }
+    else {
+        (0, output_1.emit)(`OK Downloaded ${baseName} -> ${localTarget} (${String(writtenBytes)} bytes)`);
+    }
+}
+async function handleFileCp(src, dst, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    // src 本地存在 → upload；其他情况（file_ref / `/path` / 裸文件名）→ download
+    if (isLocalSrc(src)) {
+        return handleUpload(appId, src, dst, opts.rename);
+    }
+    return handleDownload(appId, src, dst);
+}

package/dist/cli/handlers/file/helpers.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSize = exports.parseDuration = exports.isStdoutTty = exports.emitPaged = exports.emitOk = exports.renderKeyValue = exports.renderTsv = exports.renderAlignedTable = exports.formatTime = exports.formatSize = void 0;
+// file 域渲染 helpers 已统一迁移至 @/cli/handlers/shared
+// 这里仅做 re-export 保持历史 import 路径稳定（`from "./helpers"` 仍可用）
+var shared_1 = require("../../../cli/handlers/shared");
+Object.defineProperty(exports, "formatSize", { enumerable: true, get: function () { return shared_1.formatSize; } });
+Object.defineProperty(exports, "formatTime", { enumerable: true, get: function () { return shared_1.formatTime; } });
+Object.defineProperty(exports, "renderAlignedTable", { enumerable: true, get: function () { return shared_1.renderAlignedTable; } });
+Object.defineProperty(exports, "renderTsv", { enumerable: true, get: function () { return shared_1.renderTsv; } });
+Object.defineProperty(exports, "renderKeyValue", { enumerable: true, get: function () { return shared_1.renderKeyValue; } });
+Object.defineProperty(exports, "emitOk", { enumerable: true, get: function () { return shared_1.emitOk; } });
+Object.defineProperty(exports, "emitPaged", { enumerable: true, get: function () { return shared_1.emitPaged; } });
+Object.defineProperty(exports, "isStdoutTty", { enumerable: true, get: function () { return shared_1.isStdoutTty; } });
+Object.defineProperty(exports, "parseDuration", { enumerable: true, get: function () { return shared_1.parseDuration; } });
+Object.defineProperty(exports, "parseSize", { enumerable: true, get: function () { return shared_1.parseSize; } });

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

@@ -0,0 +1,13 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.handleFileSign = exports.handleFileRm = exports.handleFileCp = exports.handleFileStat = exports.handleFileLs = void 0;
+var ls_1 = require("./ls");
+Object.defineProperty(exports, "handleFileLs", { enumerable: true, get: function () { return ls_1.handleFileLs; } });
+var stat_1 = require("./stat");
+Object.defineProperty(exports, "handleFileStat", { enumerable: true, get: function () { return stat_1.handleFileStat; } });
+var cp_1 = require("./cp");
+Object.defineProperty(exports, "handleFileCp", { enumerable: true, get: function () { return cp_1.handleFileCp; } });
+var rm_1 = require("./rm");
+Object.defineProperty(exports, "handleFileRm", { enumerable: true, get: function () { return rm_1.handleFileRm; } });
+var sign_1 = require("./sign");
+Object.defineProperty(exports, "handleFileSign", { enumerable: true, get: function () { return sign_1.handleFileSign; } });

package/dist/cli/handlers/file/ls.js

@@ -0,0 +1,109 @@
+"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.handleFileLs = handleFileLs;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const error_1 = require("../../../utils/error");
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../api/file/index");
+const helpers_1 = require("./helpers");
+/**
+ * 把位置参数 `query` 路由到 `--path` 或 `--name`：
+ * - `looksLikePath(query)` → path 精确匹配
+ * - 否则 → file_name 精确匹配
+ *
+ * 显式 `--path` / `--name` 传入时跳过 query 自动识别。
+ * 同时传 query 又传 --path/--name 视为歧义，直接报错。
+ */
+function resolveQueryRouting(opts) {
+    const explicit = {
+        path: opts.path,
+        name: opts.name,
+    };
+    if (!opts.query)
+        return explicit;
+    if (explicit.path || explicit.name) {
+        throw new error_1.AppError("ARGS_INVALID", "Do not mix positional <query> with --path / --name; pick one.");
+    }
+    if ((0, index_1.looksLikePath)(opts.query)) {
+        // 补齐前导 `/`，对齐 ls sidecar 比较逻辑（info.path 永远带前导 `/`）
+        return { path: (0, index_1.toAbsolutePath)(opts.query) };
+    }
+    return { name: opts.query };
+}
+async function handleFileLs(opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const limit = opts.limit ? Number(opts.limit) : undefined;
+    const sizeGt = opts.sizeGt ? (0, helpers_1.parseSize)(opts.sizeGt) : undefined;
+    const sizeLt = opts.sizeLt ? (0, helpers_1.parseSize)(opts.sizeLt) : undefined;
+    const { path, name } = resolveQueryRouting(opts);
+    const result = await api.file.listFiles({
+        appId,
+        limit,
+        cursor: opts.cursor,
+        all: opts.all,
+        path,
+        name,
+        type: opts.type,
+        sizeGt,
+        sizeLt,
+        uploadedSince: opts.uploadedSince,
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, helpers_1.emitPaged)(result.items, result.next_cursor, result.has_more);
+        return;
+    }
+    if (result.items.length === 0) {
+        (0, output_1.emit)("No files found.");
+        return;
+    }
+    const tty = (0, helpers_1.isStdoutTty)();
+    const headers = ["file_name", "path", "size", "type", "uploaded_at"];
+    const rows = result.items.map((info) => [
+        info.file_name || "—",
+        info.path,
+        tty ? (0, helpers_1.formatSize)(info.size_bytes) : String(info.size_bytes),
+        info.type,
+        (0, helpers_1.formatTime)(info.uploaded_at, tty),
+    ]);
+    const table = tty
+        ? (0, helpers_1.renderAlignedTable)(headers, rows)
+        : (0, helpers_1.renderTsv)(headers, rows);
+    const hint = result.has_more && result.next_cursor
+        ? `\n— ${String(result.items.length)} results. Next: --cursor ${result.next_cursor}`
+        : "";
+    (0, output_1.emit)(table + hint);
+}