@lark-apaas/miaoda-cli 0.1.0 → 0.1.1

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

@@ -0,0 +1,111 @@
+"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 render_1 = require("../../../utils/render");
+const error_1 = require("../../../utils/error");
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../api/file/index");
+/**
+ * 把位置参数 `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);
+    // commander 已经把 --limit 解析为 number；保留 ?? undefined 兼容老调用
+    const limit = opts.limit;
+    const sizeGt = opts.sizeGt ? (0, render_1.parseSize)(opts.sizeGt) : undefined;
+    const sizeLt = opts.sizeLt ? (0, render_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,
+        uploadedUntil: opts.uploadedUntil,
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_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, render_1.isStdoutTty)();
+    const headers = ["file_name", "path", "size", "type", "uploaded_at"];
+    const rows = result.items.map((info) => [
+        info.file_name || "—",
+        info.path,
+        tty ? (0, render_1.formatSize)(info.size_bytes) : String(info.size_bytes),
+        info.type,
+        (0, render_1.formatTime)(info.uploaded_at, tty),
+    ]);
+    const table = tty
+        ? (0, render_1.renderAlignedTable)(headers, rows)
+        : (0, render_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);
+}

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

@@ -0,0 +1,263 @@
+"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.handleFileRm = handleFileRm;
+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 render_1 = require("../../../utils/render");
+const node_readline_1 = __importDefault(require("node:readline"));
+const MAX_BATCH = 100;
+/**
+ * 解析位置参数（自动识别 path / file_name）与 `--name`（强制 file_name）两类输入。
+ *
+ * 位置参数：
+ * - `looksLikePath(p)` 为真（`/` 开头 / 含 `/` / 16+ 位 fileKey 模式）→ 视为 path，直接删
+ * - 否则视为 file_name → 走 FilterExpression 精确查找，命中唯一后再删
+ *
+ * `--name` 选项：
+ * - 强制按 file_name 处理，跳过 looksLikePath 判断
+ * - 走 FilterExpression `name eq X` 查找；0 命中 → FILE_NOT_FOUND；多匹配 → AMBIGUOUS_FILE_NAME
+ */
+async function resolveDeleteInputs(appId, paths, names) {
+    const resolved = [];
+    const errors = [];
+    // 1. 位置参数：按 looksLikePath 分流
+    const positionalAsPath = [];
+    const positionalAsName = [];
+    for (const p of paths) {
+        if ((0, index_1.looksLikePath)(p)) {
+            positionalAsPath.push(p);
+        }
+        else {
+            positionalAsName.push(p);
+        }
+    }
+    // 1a. path 分支：直接进删除队列，file_name 取 basename 先占位
+    for (const p of positionalAsPath) {
+        const abs = (0, index_1.toAbsolutePath)(p);
+        const basename = abs.split("/").pop() ?? abs;
+        resolved.push({ input: p, path: abs, file_name: basename });
+    }
+    // 1b. name 分支（来自位置参数的非 path）：和 --name 合并走 resolveInputs
+    const allNames = [...positionalAsName, ...names];
+    if (allNames.length > 0) {
+        const results = await api.file.resolveInputs({
+            appId,
+            inputs: allNames,
+            forceAs: "name",
+        });
+        for (const r of results) {
+            if (r.status === "ok") {
+                resolved.push({
+                    input: r.input,
+                    path: r.file.path,
+                    file_name: r.file.file_name,
+                });
+            }
+            else {
+                errors.push({
+                    status: "error",
+                    input: r.input,
+                    error: r.error,
+                });
+            }
+        }
+    }
+    return { resolved, errors };
+}
+/**
+ * 删除前 TTY 二次确认。
+ * PRD 单文件场景下提示带具体路径：`? Delete '/path'? (y/N)`，
+ * 多文件场景汇总条数：`? Delete N files? (y/N)`。
+ * `firstInput` 是用户传入的第一个值（可能是 path 或 file_name），
+ * 单文件时直接展示给用户，方便核对目标。
+ */
+async function confirm(count, firstInput) {
+    const rl = node_readline_1.default.createInterface({
+        input: process.stdin,
+        output: process.stderr,
+    });
+    return new Promise((resolve) => {
+        const prompt = count === 1 ? `? Delete '${firstInput}'? (y/N) ` : `? Delete ${String(count)} files? (y/N) `;
+        rl.question(prompt, (answer) => {
+            rl.close();
+            resolve(answer.trim().toLowerCase() === "y");
+        });
+    });
+}
+async function handleFileRm(paths, opts) {
+    const names = opts.name ?? [];
+    const totalCount = paths.length + names.length;
+    if (totalCount === 0) {
+        throw new error_1.AppError("ARGS_INVALID", "No file specified (give a /path or --name <name>)");
+    }
+    if (totalCount > MAX_BATCH) {
+        throw new error_1.AppError("FILE_BATCH_TOO_MANY", `Batch size ${String(totalCount)} exceeds the 100 limit`);
+    }
+    const appId = (0, shared_1.resolveAppId)(opts);
+    // destructive guardrail
+    const tty = (0, render_1.isStdoutTty)();
+    if (tty && !opts.yes) {
+        // 单文件提示带具体目标方便用户核对；多文件传第一个 input 占位（实际只显示 N files）
+        // 上面已校验 totalCount > 0，paths/names 至少有一个非空
+        const firstInput = paths.length > 0 ? paths[0] : names[0];
+        const ok = await confirm(totalCount, firstInput);
+        if (!ok) {
+            throw new error_1.AppError("DESTRUCTIVE_CANCELLED", "Cancelled by user");
+        }
+    }
+    else if (!tty && !opts.yes) {
+        throw new error_1.AppError("DESTRUCTIVE_REQUIRES_CONFIRM", "This operation is destructive. Rerun with --yes to confirm.");
+    }
+    const { resolved, errors } = await resolveDeleteInputs(appId, paths, names);
+    // path → entry 映射（用于 delete 响应归档回原始 input 和 file_name）
+    const pathToEntry = new Map();
+    for (const e of resolved) {
+        pathToEntry.set(e.path, e);
+    }
+    const uniquePaths = Array.from(new Set(resolved.map((e) => e.path)));
+    let results = [...errors];
+    if (uniquePaths.length > 0) {
+        // 后端 delete 幂等语义，只返成功删除的 attachments。对比请求 vs 响应推断失败项；
+        // 失败项再发一次 head 探测具体原因（文件不存在 / 服务端错误）。
+        // TODO(storage): 推动后端 InnerBatchDeleteAttachmentsResponse 增加 failed 字段，
+        //   避免靠 HEAD 二次探测（多 N 次请求，仅失败场景才触发）。
+        const { deleted, failed } = await api.file.deleteFiles({
+            appId,
+            filePaths: uniquePaths,
+        });
+        for (const p of deleted) {
+            const entry = pathToEntry.get(p);
+            results.push({
+                status: "ok",
+                input: entry?.input ?? p,
+                file_name: entry?.file_name ?? (p.split("/").pop() ?? p),
+                path: p,
+            });
+        }
+        // 失败项：并发 HEAD 探测分类
+        const classified = await Promise.all(failed.map(async (f) => {
+            const entry = pathToEntry.get(f.path);
+            const input = entry?.input ?? f.path;
+            try {
+                await api.file.statFile({ appId, filePath: f.path });
+                return {
+                    input,
+                    code: "INTERNAL_ERROR",
+                    message: "Delete request returned success but file still exists (server-side issue)",
+                    hint: undefined,
+                };
+            }
+            catch (err) {
+                if (err instanceof error_1.AppError && err.code === "FILE_NOT_FOUND") {
+                    return {
+                        input,
+                        code: "FILE_NOT_FOUND",
+                        message: `File '${input}' does not exist at delete time`,
+                        hint: "Run `miaoda file ls` to see available files.",
+                    };
+                }
+                return {
+                    input,
+                    code: "INTERNAL_ERROR",
+                    message: err instanceof Error ? err.message : "verification failed",
+                    hint: undefined,
+                };
+            }
+        }));
+        for (const c of classified) {
+            results.push({
+                status: "error",
+                input: c.input,
+                error: c.hint
+                    ? { code: c.code, message: c.message, hint: c.hint }
+                    : { code: c.code, message: c.message },
+            });
+        }
+    }
+    // 按输入顺序重排（paths 优先，然后 names）
+    const orderIndex = new Map();
+    paths.forEach((p, i) => orderIndex.set(p, i));
+    names.forEach((n, i) => orderIndex.set(n, paths.length + i));
+    results = results.sort((a, b) => (orderIndex.get(a.input) ?? Number.MAX_SAFE_INTEGER) -
+        (orderIndex.get(b.input) ?? Number.MAX_SAFE_INTEGER));
+    const okCount = results.filter((r) => r.status === "ok").length;
+    const failCount = results.length - okCount;
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emit)({ data: results });
+    }
+    else if (tty) {
+        const lines = [];
+        for (const r of results) {
+            if (r.status === "ok")
+                lines.push(`✓ Deleted ${r.input}`);
+            else
+                lines.push(`✗ ${r.input}: ${r.error.message}`);
+        }
+        if (failCount === 0) {
+            lines.push(`Deleted ${String(okCount)} of ${String(totalCount)} files`);
+        }
+        else {
+            lines.push(`Deleted ${String(okCount)} of ${String(totalCount)} files (${String(failCount)} failed)`);
+        }
+        (0, output_1.emit)(lines.join("\n"));
+    }
+    else {
+        const lines = [];
+        for (const r of results) {
+            if (r.status === "ok")
+                lines.push(`OK\t${r.input}`);
+            else
+                lines.push(`FAIL\t${r.input}\t${r.error.message}`);
+        }
+        if (failCount === 0) {
+            lines.push(`Deleted ${String(okCount)} of ${String(totalCount)} files`);
+        }
+        else {
+            lines.push(`Deleted ${String(okCount)} of ${String(totalCount)} files (${String(failCount)} failed)`);
+        }
+        (0, output_1.emit)(lines.join("\n"));
+    }
+    // 退出码：任一失败 → 1；全成功 → 0
+    if (failCount > 0) {
+        process.exitCode = 1;
+    }
+}

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

@@ -0,0 +1,96 @@
+"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.handleFileSign = handleFileSign;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+const error_1 = require("../../../utils/error");
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../api/file/index");
+const MAX_EXPIRES_SECONDS = 30 * 86400;
+const DEFAULT_EXPIRES_SECONDS = 86400; // 1d（PRD 规定）
+/**
+ * 把 <file> 解析为后端 sign 可用的 filePath。
+ *
+ * - `looksLikePath(input)`（`/path`、含 `/` 的 key、后端生成的 fileKey）→ 直接走 path，不反查
+ * - 其他输入按 file_name 走 FilterExpression 精确查询（多匹配 → AMBIGUOUS_FILE_NAME）
+ */
+async function resolveFilePath(appId, input) {
+    if ((0, index_1.looksLikePath)(input))
+        return (0, index_1.toAbsolutePath)(input);
+    const [resolved] = await api.file.resolveInputs({
+        appId,
+        inputs: [input],
+        forceAs: "name",
+    });
+    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 handleFileSign(file, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    let expiresSec = DEFAULT_EXPIRES_SECONDS;
+    if (opts.expires) {
+        expiresSec = (0, render_1.parseDuration)(opts.expires);
+        if (expiresSec > MAX_EXPIRES_SECONDS) {
+            throw new error_1.AppError("FILE_SIGN_DURATION_EXCEEDED", `Expires duration '${opts.expires}' exceeds the maximum of 30d`, {
+                next_actions: [
+                    `Maximum allowed value is 30d. Use \`--expires 30d\` for the longest link.`,
+                ],
+            });
+        }
+    }
+    const filePath = await resolveFilePath(appId, file);
+    const result = await api.file.signDownload({
+        appId,
+        filePath,
+        expiresIn: expiresSec,
+    });
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)({
+            file_name: result.file_name,
+            path: result.path,
+            signed_url: result.signed_url,
+            expires_at: result.expires_at,
+        });
+        return;
+    }
+    // 默认输出 URL 一行（pretty 与 non-TTY 一致）
+    (0, output_1.emit)(result.signed_url);
+}

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

@@ -0,0 +1,97 @@
+"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.handleFileStat = handleFileStat;
+const api = __importStar(require("../../../api/index"));
+const output_1 = require("../../../utils/output");
+const render_1 = require("../../../utils/render");
+const error_1 = require("../../../utils/error");
+const shared_1 = require("../../../cli/commands/shared");
+const index_1 = require("../../../api/file/index");
+/**
+ * 解析 `<file>` 为后端 head 可用的 filePath。
+ *
+ * - `looksLikePath(input)`（`/path`、含 `/` 的 key、后端生成的 fileKey）→ 直接 HEAD
+ * - 其他输入按 file_name 走 FilterExpression 精确查询（多匹配 → AMBIGUOUS_FILE_NAME）
+ */
+async function resolveFile(appId, input) {
+    if ((0, index_1.looksLikePath)(input)) {
+        return api.file.statFile({ appId, filePath: (0, index_1.toAbsolutePath)(input) });
+    }
+    const [resolved] = await api.file.resolveInputs({
+        appId,
+        inputs: [input],
+        forceAs: "name",
+    });
+    if (resolved.status === "error") {
+        throw new error_1.AppError(resolved.error.code, resolved.error.message, {
+            next_actions: resolved.error.hint ? [resolved.error.hint] : undefined,
+        });
+    }
+    const head = await api.file.statFile({ appId, filePath: resolved.file.path });
+    // head 响应的 file_name 有时为空，用 list 响应补齐
+    if (!head.file_name)
+        head.file_name = resolved.file.file_name;
+    return head;
+}
+async function handleFileStat(file, opts) {
+    const appId = (0, shared_1.resolveAppId)(opts);
+    const info = await resolveFile(appId, file);
+    if ((0, output_1.isJsonMode)()) {
+        (0, output_1.emitOk)(info);
+        return;
+    }
+    const tty = (0, render_1.isStdoutTty)();
+    const pairs = [
+        ["file_name", info.file_name || "—"],
+        ["path", info.path],
+        [
+            "size",
+            tty
+                ? `${(0, render_1.formatSize)(info.size_bytes)} (${String(info.size_bytes)} bytes)`
+                : String(info.size_bytes),
+        ],
+        ["type", info.type || "—"],
+        ["uploaded_at", (0, render_1.formatTime)(info.uploaded_at, tty)],
+    ];
+    if (info.uploaded_by) {
+        // uploaded_by 紧跟 uploaded_at 前插入（index = "uploaded_at" 之前）
+        pairs.splice(pairs.length - 1, 0, ["uploaded_by", info.uploaded_by]);
+    }
+    if (info.download_url) {
+        pairs.push(["download_url", info.download_url]);
+    }
+    (0, output_1.emit)((0, render_1.renderKeyValue)(pairs, tty));
+}

package/dist/cli/handlers/index.js

@@ -15,3 +15,5 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("../../cli/handlers/plugin/index"), exports);
+__exportStar(require("../../cli/handlers/file/index"), exports);
+__exportStar(require("../../cli/handlers/db/index"), exports);