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

package/dist/api/file/parsers.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseAttachment = parseAttachment;
+exports.parseHead = parseHead;
+/** 安全读取字符串字段（空字符串回退为默认值） */
+function str(value, fallback = "") {
+    return typeof value === "string" && value.length > 0 ? value : fallback;
+}
+/** 安全读取数字字段（非正值回退到 0） */
+function int(value) {
+    if (typeof value === "number" && Number.isFinite(value) && value >= 0) {
+        return Math.trunc(value);
+    }
+    return 0;
+}
+function readSize(meta) {
+    if (!meta)
+        return 0;
+    const v = meta.size ??
+        meta.fileSize ??
+        meta.file_size ??
+        meta.contentLength ??
+        0;
+    return int(v);
+}
+/**
+ * 展示层 path 统一带前导 `/`（对齐 PRD / SKILL 里的示例）。
+ * 后端存储的 path 实际是无前导 `/` 的，这里补齐。
+ */
+function toDisplayPath(p) {
+    if (!p)
+        return p;
+    return p.startsWith("/") ? p : `/${p}`;
+}
+/** 将后端 attachment 结构映射为 CLI FileInfo（用于 ls） */
+function parseAttachment(att) {
+    const rawPath = str(att.filePath, str(att.name));
+    const info = {
+        file_name: str(att.name),
+        path: toDisplayPath(rawPath),
+        size_bytes: readSize(att.metadata),
+        type: str(att.metadata?.mimeType),
+        uploaded_at: str(att.createdAt),
+    };
+    const downloadUrl = str(att.downloadURL);
+    if (downloadUrl)
+        info.download_url = downloadUrl;
+    // uploaded_by 从 createdBy.name 映射（后端返 {userID, name, email, ...}，空代表匿名）
+    const uploader = str(att.createdBy?.name);
+    if (uploader)
+        info.uploaded_by = uploader;
+    return info;
+}
+/** 将后端 head 响应映射为 CLI FileInfo（用于 stat） */
+function parseHead(data, filePath) {
+    const outer = data?.metadata ?? {};
+    const inner = outer.metadata ?? {};
+    const info = {
+        file_name: str(outer.name),
+        path: toDisplayPath(filePath || str(outer.name)),
+        size_bytes: readSize(inner),
+        type: str(inner.mimeType),
+        uploaded_at: str(inner.lastModified),
+    };
+    const downloadUrl = str(outer.downloadURL);
+    if (downloadUrl)
+        info.download_url = downloadUrl;
+    const uploader = str(outer.createdBy?.name);
+    if (uploader)
+        info.uploaded_by = uploader;
+    return info;
+}

package/dist/api/file/types.js

@@ -0,0 +1,3 @@
+"use strict";
+// ── API 响应外层信封（file-storage inner API 统一结构） ──
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/api/index.js

@@ -0,0 +1,42 @@
+"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.db = exports.file = exports.plugin = void 0;
+const _plugin = __importStar(require("../api/plugin/index"));
+const _file = __importStar(require("../api/file/index"));
+const _db = __importStar(require("../api/db/index"));
+exports.plugin = { ..._plugin };
+exports.file = { ..._file };
+exports.db = { ..._db };

package/dist/api/plugin/api.js

@@ -0,0 +1,243 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPluginVersions = getPluginVersions;
+exports.getPluginVersion = getPluginVersion;
+exports.downloadPlugin = downloadPlugin;
+exports.getCachePath = getCachePath;
+exports.hasCachedPlugin = hasCachedPlugin;
+exports.listCachedPlugins = listCachedPlugins;
+exports.cleanAllCache = cleanAllCache;
+exports.cleanPluginCache = cleanPluginCache;
+exports.reportEvents = reportEvents;
+exports.reportInstallEvent = reportInstallEvent;
+exports.reportCreateInstanceEvent = reportCreateInstanceEvent;
+const http_client_1 = require("@lark-apaas/http-client");
+const http_1 = require("../../utils/http");
+const error_1 = require("../../utils/error");
+const logger_1 = require("../../utils/logger");
+const node_fs_1 = __importDefault(require("node:fs"));
+const node_path_1 = __importDefault(require("node:path"));
+// ── Plugin Version API ──
+async function getPluginVersions(keys, latestOnly = true) {
+    const client = (0, http_1.getHttpClient)();
+    const response = await client.post(`/api/v1/studio/innerapi/plugins/-/versions/batch_get?keys=${keys.join(",")}&latest_only=${String(latestOnly)}`);
+    if (!response.ok) {
+        throw new error_1.HttpError(response.status, response.url, `Failed to get plugin versions: ${String(response.status)} ${response.statusText}`);
+    }
+    const result = (await response.json());
+    if (result.status_code !== "0") {
+        throw new error_1.AppError("INTERNAL_API_ERROR", `API error: ${result.message ?? "unknown"}`);
+    }
+    return result.data.pluginVersions;
+}
+async function getPluginVersion(pluginKey, requestedVersion) {
+    const isLatest = requestedVersion === "latest";
+    const versions = await getPluginVersions([pluginKey], isLatest);
+    const pluginVersions = versions[pluginKey];
+    if (!pluginVersions || pluginVersions.length === 0) {
+        throw new error_1.AppError("PLUGIN_NOT_FOUND", `Plugin not found: ${pluginKey}`, { next_actions: ["检查包名拼写，或确认该插件已在插件市场发布"] });
+    }
+    if (isLatest) {
+        return pluginVersions[0];
+    }
+    const targetVersion = pluginVersions.find((v) => v.version === requestedVersion);
+    if (!targetVersion) {
+        throw new error_1.AppError("VERSION_NOT_FOUND", `Version ${requestedVersion} not found for plugin ${pluginKey}`, { next_actions: [`可用版本：${pluginVersions.map((v) => v.version).join(", ")}`] });
+    }
+    return targetVersion;
+}
+// ── Plugin Download ──
+function parsePluginKey(key) {
+    const match = /^(@[^/]+)\/(.+)$/.exec(key);
+    if (!match) {
+        throw new error_1.AppError("INVALID_PLUGIN_KEY", `Invalid plugin key format: ${key}`, { next_actions: ["插件 key 必须形如 @scope/name"] });
+    }
+    return { scope: match[1], name: match[2] };
+}
+async function downloadFromInner(pluginKey, version) {
+    const client = (0, http_1.getHttpClient)();
+    const { scope, name } = parsePluginKey(pluginKey);
+    const url = `/api/v1/studio/innerapi/plugins/${scope}/${name}/versions/${version}/package`;
+    const response = await client.get(url);
+    if (!response.ok) {
+        throw new error_1.HttpError(response.status, url, `Failed to download plugin: ${String(response.status)} ${response.statusText}`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    return Buffer.from(arrayBuffer);
+}
+async function downloadFromPublic(downloadURL) {
+    const client = new http_client_1.HttpClient({ timeout: 60000 });
+    const response = await client.get(downloadURL);
+    if (!response.ok) {
+        throw new error_1.HttpError(response.status, downloadURL, `Failed to download from public URL: ${String(response.status)} ${response.statusText}`);
+    }
+    const arrayBuffer = await response.arrayBuffer();
+    return Buffer.from(arrayBuffer);
+}
+const MAX_RETRIES = 2;
+async function withRetry(operation, description, maxRetries = MAX_RETRIES) {
+    let lastError;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await operation();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            if (attempt < maxRetries) {
+                (0, logger_1.log)("plugin", `${description} failed, retrying (${String(attempt + 1)}/${String(maxRetries)})...`);
+            }
+        }
+    }
+    throw lastError ?? new error_1.AppError("INTERNAL_RETRY_EXHAUSTED", `${description} failed after ${String(maxRetries)} retries`, { retryable: true, next_actions: ["检查网络后重试，--verbose 可查看重试日志"] });
+}
+/** 插件缓存目录 */
+const PLUGIN_CACHE_DIR = "node_modules/.cache/miaoda-cli/plugins";
+function getPluginCacheDir() {
+    return node_path_1.default.join(process.cwd(), PLUGIN_CACHE_DIR);
+}
+function ensureCacheDir() {
+    const cacheDir = getPluginCacheDir();
+    if (!node_fs_1.default.existsSync(cacheDir)) {
+        node_fs_1.default.mkdirSync(cacheDir, { recursive: true });
+    }
+}
+function getTempFilePath(pluginKey, version) {
+    ensureCacheDir();
+    const safeKey = pluginKey.replace(/[/@]/g, "_");
+    const filename = `${safeKey}@${version}.tgz`;
+    return node_path_1.default.join(getPluginCacheDir(), filename);
+}
+async function downloadPlugin(pluginKey, requestedVersion) {
+    const pluginInfo = await getPluginVersion(pluginKey, requestedVersion);
+    let tgzBuffer;
+    if (pluginInfo.downloadApproach === "inner") {
+        tgzBuffer = await withRetry(() => downloadFromInner(pluginKey, pluginInfo.version), "Download");
+    }
+    else {
+        tgzBuffer = await withRetry(() => downloadFromPublic(pluginInfo.downloadURL), "Download");
+    }
+    const tgzPath = getTempFilePath(pluginKey, pluginInfo.version);
+    node_fs_1.default.writeFileSync(tgzPath, tgzBuffer);
+    return {
+        tgzPath,
+        version: pluginInfo.version,
+        pluginInfo,
+    };
+}
+// ── Cache ──
+function getCachePath(pluginKey, version) {
+    ensureCacheDir();
+    const safeKey = pluginKey.replace(/[/@]/g, "_");
+    const filename = `${safeKey}@${version}.tgz`;
+    return node_path_1.default.join(getPluginCacheDir(), filename);
+}
+function hasCachedPlugin(pluginKey, version) {
+    const cachePath = getCachePath(pluginKey, version);
+    return node_fs_1.default.existsSync(cachePath);
+}
+function listCachedPlugins() {
+    const cacheDir = getPluginCacheDir();
+    if (!node_fs_1.default.existsSync(cacheDir)) {
+        return [];
+    }
+    const files = node_fs_1.default.readdirSync(cacheDir);
+    const result = [];
+    for (const file of files) {
+        if (!file.endsWith(".tgz"))
+            continue;
+        const match = /^(.+)@(.+)\.tgz$/.exec(file);
+        if (!match)
+            continue;
+        const [, rawName, version] = match;
+        const name = rawName.replace(/^_/, "@").replace(/_/, "/");
+        const filePath = node_path_1.default.join(cacheDir, file);
+        const stat = node_fs_1.default.statSync(filePath);
+        result.push({ name, version, filePath, size: stat.size, mtime: stat.mtime });
+    }
+    return result;
+}
+function cleanAllCache() {
+    const cacheDir = getPluginCacheDir();
+    if (!node_fs_1.default.existsSync(cacheDir)) {
+        return 0;
+    }
+    const files = node_fs_1.default.readdirSync(cacheDir);
+    let count = 0;
+    for (const file of files) {
+        if (file.endsWith(".tgz")) {
+            node_fs_1.default.unlinkSync(node_path_1.default.join(cacheDir, file));
+            count++;
+        }
+    }
+    return count;
+}
+function cleanPluginCache(pluginKey, version) {
+    const cacheDir = getPluginCacheDir();
+    if (!node_fs_1.default.existsSync(cacheDir)) {
+        return 0;
+    }
+    const safeKey = pluginKey.replace(/[/@]/g, "_");
+    const files = node_fs_1.default.readdirSync(cacheDir);
+    let count = 0;
+    for (const file of files) {
+        if (version) {
+            if (file === `${safeKey}@${version}.tgz`) {
+                node_fs_1.default.unlinkSync(node_path_1.default.join(cacheDir, file));
+                count++;
+            }
+        }
+        else {
+            if (file.startsWith(`${safeKey}@`) && file.endsWith(".tgz")) {
+                node_fs_1.default.unlinkSync(node_path_1.default.join(cacheDir, file));
+                count++;
+            }
+        }
+    }
+    return count;
+}
+// ── Telemetry ──
+async function reportEvents(events) {
+    if (events.length === 0)
+        return true;
+    try {
+        const client = (0, http_1.getHttpClient)();
+        const response = await client.post("/api/v1/studio/innerapi/resource_events", { events });
+        if (!response.ok) {
+            (0, logger_1.log)("telemetry", `Failed to report events: ${String(response.status)} ${response.statusText}`);
+            return false;
+        }
+        const result = (await response.json());
+        if (result.status_code !== "0") {
+            (0, logger_1.log)("telemetry", `API error: ${result.message ?? "unknown"}`);
+            return false;
+        }
+        return true;
+    }
+    catch (error) {
+        (0, logger_1.log)("telemetry", `Failed to report events: ${error instanceof Error ? error.message : String(error)}`);
+        return false;
+    }
+}
+async function reportInstallEvent(pluginKey, version) {
+    await reportEvents([
+        {
+            resourceType: "plugin",
+            resourceKey: pluginKey,
+            eventType: "install",
+            details: { version },
+        },
+    ]);
+}
+async function reportCreateInstanceEvent(pluginKey, version) {
+    await reportEvents([
+        {
+            resourceType: "plugin",
+            resourceKey: pluginKey,
+            eventType: "create_instance",
+            details: { version },
+        },
+    ]);
+}

package/dist/api/plugin/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reportCreateInstanceEvent = exports.reportInstallEvent = exports.reportEvents = exports.hasCachedPlugin = exports.getCachePath = exports.downloadPlugin = exports.getPluginVersion = exports.getPluginVersions = void 0;
+var api_1 = require("./api");
+Object.defineProperty(exports, "getPluginVersions", { enumerable: true, get: function () { return api_1.getPluginVersions; } });
+Object.defineProperty(exports, "getPluginVersion", { enumerable: true, get: function () { return api_1.getPluginVersion; } });
+Object.defineProperty(exports, "downloadPlugin", { enumerable: true, get: function () { return api_1.downloadPlugin; } });
+Object.defineProperty(exports, "getCachePath", { enumerable: true, get: function () { return api_1.getCachePath; } });
+Object.defineProperty(exports, "hasCachedPlugin", { enumerable: true, get: function () { return api_1.hasCachedPlugin; } });
+Object.defineProperty(exports, "reportEvents", { enumerable: true, get: function () { return api_1.reportEvents; } });
+Object.defineProperty(exports, "reportInstallEvent", { enumerable: true, get: function () { return api_1.reportInstallEvent; } });
+Object.defineProperty(exports, "reportCreateInstanceEvent", { enumerable: true, get: function () { return api_1.reportCreateInstanceEvent; } });

package/dist/api/plugin/types.js

@@ -0,0 +1,3 @@
+"use strict";
+// ── Plugin (原 action-plugin) ──
+Object.defineProperty(exports, "__esModule", { value: true });

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

@@ -0,0 +1,73 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDbCommands = registerDbCommands;
+const index_1 = require("../../../cli/handlers/db/index");
+const shared_1 = require("../../../cli/commands/shared");
+function registerDbCommands(program) {
+    const dbCmd = program
+        .command("db")
+        .description("数据操作：SQL 执行、表结构查询、数据导入导出");
+    dbCmd.action(() => {
+        dbCmd.outputHelp();
+    });
+    dbCmd
+        .command("sql")
+        .description("执行任意 SQL（SELECT / DML / DDL / TCL / EXPLAIN）；query 省略时读 stdin")
+        .argument("[query]", "要执行的 SQL 语句；省略时从 stdin 读取")
+        .addOption((0, shared_1.appIdOption)())
+        .option("--env <env>", "目标环境（P0 未启用多环境）")
+        .action(async (query, opts) => {
+        await (0, index_1.handleDbSql)(query, opts);
+    });
+    // schema 二级资源分组
+    const schemaCmd = dbCmd
+        .command("schema")
+        .description("表结构查询");
+    schemaCmd.action(() => {
+        schemaCmd.outputHelp();
+    });
+    schemaCmd
+        .command("list")
+        .description("列出应用所有表（rows / size / columns / updated_at）")
+        .addOption((0, shared_1.appIdOption)())
+        .action(async (opts) => {
+        await (0, index_1.handleDbSchemaList)(opts);
+    });
+    schemaCmd
+        .command("get")
+        .description("查看单表结构（字段 / 索引 / DDL）")
+        .argument("<table>", "表名")
+        .addOption((0, shared_1.appIdOption)())
+        .option("--ddl", "TTY 下强制输出完整 DDL 而非结构化概览")
+        .action(async (table, opts) => {
+        await (0, index_1.handleDbSchemaGet)(table, opts);
+    });
+    // data 二级资源分组
+    const dataCmd = dbCmd
+        .command("data")
+        .description("数据导入 / 导出");
+    dataCmd.action(() => {
+        dataCmd.outputHelp();
+    });
+    dataCmd
+        .command("import")
+        .description("从 CSV / JSON 文件导入数据（P0：≤ 1 MB / ≤ 5000 行，单事务原子）")
+        .argument("<file>", "本地文件路径")
+        .addOption((0, shared_1.appIdOption)())
+        .option("--table <name>", "目标表名；省略时按文件名推断")
+        .option("--format <fmt>", "csv | json；省略时按文件扩展名推断")
+        .action(async (file, opts) => {
+        await (0, index_1.handleDbDataImport)(file, opts);
+    });
+    dataCmd
+        .command("export")
+        .description("导出整表到 CSV / JSON（P0：≤ 1 MB / ≤ 5000 行）")
+        .argument("<table>", "表名")
+        .addOption((0, shared_1.appIdOption)())
+        .option("--format <fmt>", "csv | json；默认 csv")
+        .option("-f, --file <path>", "输出文件路径；默认 <table>.<format>")
+        .option("--limit <n>", "最多导出行数（≤ 5000）")
+        .action(async (table, opts) => {
+        await (0, index_1.handleDbDataExport)(table, opts);
+    });
+}

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

@@ -0,0 +1,67 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFileCommands = registerFileCommands;
+const index_1 = require("../../../cli/handlers/file/index");
+const shared_1 = require("../../../cli/commands/shared");
+function registerFileCommands(program) {
+    const fileCmd = program
+        .command("file")
+        .description("文件操作：上传、下载、删除、查询");
+    fileCmd.action(() => {
+        fileCmd.outputHelp();
+    });
+    fileCmd
+        .command("ls")
+        .description("列出应用下的文件")
+        .argument("[query]", "可选筛选值：形似 /path、包含 / 或 16+位 fileKey 时按 path 精确匹配；否则按 file_name 精确匹配")
+        .addOption((0, shared_1.appIdOption)())
+        .option("--path <path>", "按 path 精确匹配（跳过自动识别）")
+        .option("--name <name>", "按 file_name 精确匹配（跳过自动识别）")
+        .option("--type <mime>", "按 MIME 类型过滤（精确匹配）")
+        .option("--size-gt <size>", "大小大于，支持 B/KB/MB/GB")
+        .option("--size-lt <size>", "大小小于")
+        .option("--uploaded-since <time>", "上传时间晚于（ISO 8601）")
+        .option("--limit <n>", "返回条数上限", "50")
+        .option("--cursor <token>", "分页游标")
+        .option("--all", "自动翻页聚合全部结果")
+        .action(async (query, opts) => {
+        await (0, index_1.handleFileLs)({ ...opts, query });
+    });
+    fileCmd
+        .command("stat")
+        .description("查看指定文件的元数据")
+        .argument("<file>", "path 或 file_name：自动识别（见 ls 命令说明）")
+        .addOption((0, shared_1.appIdOption)())
+        .action(async (file, opts) => {
+        await (0, index_1.handleFileStat)(file, opts);
+    });
+    fileCmd
+        .command("cp")
+        .description("上传或下载文件（方向由 src/dst 自动判断）")
+        .argument("<src>", "源：本地路径 或 远程 /path / file_name")
+        .argument("<dst>", "目标：本地路径 或 远程路径")
+        .addOption((0, shared_1.appIdOption)())
+        .option("--rename <name>", "上传后使用的新文件名")
+        .action(async (src, dst, opts) => {
+        await (0, index_1.handleFileCp)(src, dst, opts);
+    });
+    fileCmd
+        .command("rm")
+        .description("删除一个或多个文件（best-effort）")
+        .argument("[paths...]", "path 或 file_name：形似 /path、含 / 或 16+位 fileKey 时按 path 精确删除，其余按 file_name 查找后删除")
+        .addOption((0, shared_1.appIdOption)())
+        .option("-n, --name <name>", "强制按 file_name 查找后删除（跳过自动识别）；可重复指定；多匹配报 AMBIGUOUS_FILE_NAME", (value, prev) => [...(prev ?? []), value])
+        .option("-y, --yes", "跳过交互确认")
+        .action(async (paths, opts) => {
+        await (0, index_1.handleFileRm)(paths, opts);
+    });
+    fileCmd
+        .command("sign")
+        .description("生成文件临时下载链接")
+        .argument("<file>", "path 或 file_name：自动识别（见 ls 命令说明）")
+        .addOption((0, shared_1.appIdOption)())
+        .option("--expires <duration>", "过期时长（默认 7d，最长 30d）")
+        .action(async (file, opts) => {
+        await (0, index_1.handleFileSign)(file, opts);
+    });
+}

package/dist/cli/commands/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerCommands = registerCommands;
+const index_1 = require("../../cli/commands/plugin/index");
+const index_2 = require("../../cli/commands/file/index");
+const index_3 = require("../../cli/commands/db/index");
+function registerCommands(program) {
+    (0, index_1.registerPluginCommands)(program);
+    (0, index_2.registerFileCommands)(program);
+    (0, index_3.registerDbCommands)(program);
+}