feishu-docs-cli 0.1.0-beta.2

package/dist/commands/create.d.ts

@@ -0,0 +1,6 @@
+/**
+ * create command: Create new documents in wiki or drive.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function create(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/create.js

@@ -0,0 +1,120 @@
+/**
+ * create command: Create new documents in wiki or drive.
+ */
+import { createClient, fetchWithAuth } from "../client.js";
+import { CliError } from "../utils/errors.js";
+import { convertAndWrite } from "../services/markdown-convert.js";
+import { readBody, getDocumentInfo } from "../services/block-writer.js";
+import { validateToken } from "../utils/validate.js";
+export const meta = {
+    options: {
+        wiki: { type: "string" },
+        folder: { type: "string" },
+        parent: { type: "string" },
+        body: { type: "string" },
+    },
+    positionals: true,
+    handler: create,
+};
+export async function create(args, globalOpts) {
+    const title = args.positionals[0];
+    if (!title) {
+        throw new CliError("INVALID_ARGS", "缺少文档标题。用法: feishu-docs create <title> [--wiki <space_id>] [--body <file>]");
+    }
+    const { client, authInfo } = await createClient(globalOpts);
+    let bodyContent;
+    if (args.body) {
+        bodyContent = await readBody(args.body);
+        if (!bodyContent.trim()) {
+            throw new CliError("INVALID_ARGS", "文档内容为空，至少需要一行内容");
+        }
+    }
+    if (args.wiki) {
+        validateToken(args.wiki, "space_id");
+        if (args.parent)
+            validateToken(args.parent, "parent_node_token");
+        return createInWiki(client, authInfo, title, args.wiki, args.parent, bodyContent, globalOpts);
+    }
+    if (args.folder) {
+        validateToken(args.folder, "folder_token");
+    }
+    return createDoc(client, authInfo, title, args.folder, bodyContent, globalOpts);
+}
+async function createInWiki(client, authInfo, title, spaceId, parentNodeToken, bodyContent, globalOpts) {
+    const nodeRes = await fetchWithAuth(authInfo, `/open-apis/wiki/v2/spaces/${encodeURIComponent(spaceId)}/nodes`, {
+        method: "POST",
+        body: {
+            obj_type: "docx",
+            node_type: "origin",
+            title,
+            ...(parentNodeToken && { parent_node_token: parentNodeToken }),
+        },
+    });
+    const nodeData = nodeRes?.data;
+    const node = (nodeData?.node || {});
+    const objToken = node.obj_token;
+    const nodeToken = node.node_token;
+    if (!objToken) {
+        throw new CliError("API_ERROR", "创建知识库节点成功但未返回 obj_token");
+    }
+    if (bodyContent) {
+        const docInfo = await getDocumentInfo(client, authInfo, objToken);
+        await convertAndWrite(authInfo, objToken, bodyContent, docInfo.revisionId);
+    }
+    const domain = globalOpts.lark ? "larksuite.com" : "feishu.cn";
+    const wikiUrl = `https://${domain}/wiki/${nodeToken}`;
+    const docUrl = `https://${domain}/docx/${objToken}`;
+    const output = {
+        document_id: objToken,
+        ...(nodeToken && { node_token: nodeToken }),
+        space_id: spaceId,
+        title,
+        wiki_url: wikiUrl,
+        doc_url: docUrl,
+    };
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({ success: true, ...output }, null, 2) + "\n");
+    }
+    else {
+        process.stdout.write(`文档已创建\n`);
+        process.stdout.write(`  标题: ${title}\n`);
+        process.stdout.write(`  document_id: ${objToken}\n`);
+        if (nodeToken) {
+            process.stdout.write(`  node_token: ${nodeToken}\n`);
+        }
+        process.stdout.write(`  URL: ${wikiUrl}\n`);
+    }
+}
+async function createDoc(client, authInfo, title, folderToken, bodyContent, globalOpts) {
+    const body = {
+        title,
+        ...(folderToken && { folder_token: folderToken }),
+    };
+    const res = await fetchWithAuth(authInfo, `/open-apis/docx/v1/documents`, {
+        method: "POST",
+        body,
+    });
+    const resData = res?.data;
+    const doc = (resData?.document || {});
+    const documentId = doc.document_id;
+    if (!documentId) {
+        throw new CliError("API_ERROR", "创建文档成功但未返回 document_id");
+    }
+    if (bodyContent) {
+        const docInfo = await getDocumentInfo(client, authInfo, documentId);
+        await convertAndWrite(authInfo, documentId, bodyContent, docInfo.revisionId);
+    }
+    const domain = globalOpts.lark ? "larksuite.com" : "feishu.cn";
+    const url = `https://${domain}/docx/${documentId}`;
+    const output = { document_id: documentId, title: doc.title, url };
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({ success: true, ...output }, null, 2) + "\n");
+    }
+    else {
+        process.stdout.write(`文档已创建\n`);
+        process.stdout.write(`  标题: ${doc.title}\n`);
+        process.stdout.write(`  document_id: ${documentId}\n`);
+        process.stdout.write(`  URL: ${url}\n`);
+    }
+}
+//# sourceMappingURL=create.js.map

package/dist/commands/create.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.js","sourceRoot":"","sources":["../../src/commands/create.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC3D,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAC9C,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AASrD,MAAM,CAAC,MAAM,IAAI,GAAgB;IAC/B,OAAO,EAAE;QACP,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QACxB,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;QAC1B,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;KACzB;IACD,WAAW,EAAE,IAAI;IACjB,OAAO,EAAE,MAAM;CAChB,CAAC;AAEF,MAAM,CAAC,KAAK,UAAU,MAAM,CAC1B,IAAiB,EACjB,UAAsB;IAEtB,MAAM,KAAK,GAAG,IAAI,CAAC,WAAY,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IAED,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,YAAY,CAAC,UAAU,CAAC,CAAC;IAE5D,IAAI,WAA+B,CAAC;IACpC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,WAAW,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,IAAc,CAAC,CAAC;QAClD,IAAI,CAAC,WAAW,CAAC,IAAI,EAAE,EAAE,CAAC;YACxB,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;QACxD,CAAC;IACH,CAAC;IAED,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;QACd,aAAa,CAAC,IAAI,CAAC,IAAc,EAAE,UAAU,CAAC,CAAC;QAC/C,IAAI,IAAI,CAAC,MAAM;YAAE,aAAa,CAAC,IAAI,CAAC,MAAgB,EAAE,mBAAmB,CAAC,CAAC;QAC3E,OAAO,YAAY,CACjB,MAAM,EACN,QAAQ,EACR,KAAK,EACL,IAAI,CAAC,IAAc,EACnB,IAAI,CAAC,MAA4B,EACjC,WAAW,EACX,UAAU,CACX,CAAC;IACJ,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,aAAa,CAAC,IAAI,CAAC,MAAgB,EAAE,cAAc,CAAC,CAAC;IACvD,CAAC;IAED,OAAO,SAAS,CACd,MAAM,EACN,QAAQ,EACR,KAAK,EACL,IAAI,CAAC,MAA4B,EACjC,WAAW,EACX,UAAU,CACX,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,YAAY,CACzB,MAAmB,EACnB,QAAkB,EAClB,KAAa,EACb,OAAe,EACf,eAAmC,EACnC,WAA+B,EAC/B,UAAsB;IAEtB,MAAM,OAAO,GAAG,MAAM,aAAa,CACjC,QAAQ,EACR,6BAA6B,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAChE;QACE,MAAM,EAAE,MAAM;QACd,IAAI,EAAE;YACJ,QAAQ,EAAE,MAAM;YAChB,SAAS,EAAE,QAAQ;YACnB,KAAK;YACL,GAAG,CAAC,eAAe,IAAI,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC;SAC/D;KACF,CACF,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,EAAE,IAA2C,CAAC;IACtE,MAAM,IAAI,GAAG,CAAC,QAAQ,EAAE,IAAI,IAAI,EAAE,CAA2B,CAAC;IAC9D,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAAC;IAChC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,CAAC;IAElC,IAAI,CAAC,QAAQ,EAAE,CAAC;QACd,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC,CAAC;IAC7D,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,CAAC,CAAC;QAClE,MAAM,eAAe,CAAC,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,OAAO,CAAC,UAAU,CAAC,CAAC;IAC7E,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC;IAC/D,MAAM,OAAO,GAAG,WAAW,MAAM,SAAS,SAAS,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,WAAW,MAAM,SAAS,QAAQ,EAAE,CAAC;IAEpD,MAAM,MAAM,GAAG;QACb,WAAW,EAAE,QAAQ;QACrB,GAAG,CAAC,SAAS,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;QAC3C,QAAQ,EAAE,OAAO;QACjB,KAAK;QACL,QAAQ,EAAE,OAAO;QACjB,OAAO,EAAE,MAAM;KAChB,CAAC;IAEF,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAC7D,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,KAAK,IAAI,CAAC,CAAC;QACzC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,QAAQ,IAAI,CAAC,CAAC;QACrD,IAAI,SAAS,EAAE,CAAC;YACd,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,iBAAiB,SAAS,IAAI,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,OAAO,IAAI,CAAC,CAAC;IAC9C,CAAC;AACH,CAAC;AAED,KAAK,UAAU,SAAS,CACtB,MAAmB,EACnB,QAAkB,EAClB,KAAa,EACb,WAA+B,EAC/B,WAA+B,EAC/B,UAAsB;IAEtB,MAAM,IAAI,GAAG;QACX,KAAK;QACL,GAAG,CAAC,WAAW,IAAI,EAAE,YAAY,EAAE,WAAW,EAAE,CAAC;KAClD,CAAC;IAEF,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,QAAQ,EAAE,8BAA8B,EAAE;QACxE,MAAM,EAAE,MAAM;QACd,IAAI;KACL,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,GAAG,EAAE,IAA2C,CAAC;IACjE,MAAM,GAAG,GAAG,CAAC,OAAO,EAAE,QAAQ,IAAI,EAAE,CAA2B,CAAC;IAChE,MAAM,UAAU,GAAG,GAAG,CAAC,WAAW,CAAC;IAEnC,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,wBAAwB,CAAC,CAAC;IAC5D,CAAC;IAED,IAAI,WAAW,EAAE,CAAC;QAChB,MAAM,OAAO,GAAG,MAAM,eAAe,CAAC,MAAM,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACpE,MAAM,eAAe,CACnB,QAAQ,EACR,UAAU,EACV,WAAW,EACX,OAAO,CAAC,UAAU,CACnB,CAAC;IACJ,CAAC;IAED,MAAM,MAAM,GAAG,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,WAAW,CAAC;IAC/D,MAAM,GAAG,GAAG,WAAW,MAAM,SAAS,UAAU,EAAE,CAAC;IAEnD,MAAM,MAAM,GAAG,EAAE,WAAW,EAAE,UAAU,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,GAAG,EAAE,CAAC;IAElE,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;QACpB,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,IAAI,CAAC,SAAS,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,MAAM,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAC7D,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAChC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,SAAS,GAAG,CAAC,KAAK,IAAI,CAAC,CAAC;QAC7C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,kBAAkB,UAAU,IAAI,CAAC,CAAC;QACvD,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC;IAC1C,CAAC;AACH,CAAC"}

package/dist/commands/delete.d.ts

@@ -0,0 +1,6 @@
+/**
+ * delete command: Move document to recycle bin.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function del(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/delete.js

@@ -0,0 +1,89 @@
+/**
+ * delete command: Move document to recycle bin.
+ */
+import { createClient, fetchWithAuth } from "../client.js";
+import { CliError } from "../utils/errors.js";
+import { resolveDocument } from "../utils/document-resolver.js";
+import { mapToDriveType } from "../utils/drive-types.js";
+/**
+ * Check if a node has children in the knowledge base.
+ */
+async function checkChildren(client, authInfo, spaceId, nodeToken) {
+    try {
+        const res = await fetchWithAuth(authInfo, `/open-apis/wiki/v2/spaces/${encodeURIComponent(spaceId)}/nodes`, { params: { parent_node_token: nodeToken, page_size: 1 } });
+        const data = res?.data;
+        return (data?.items?.length || 0) > 0;
+    }
+    catch {
+        return false;
+    }
+}
+export const meta = {
+    options: {
+        confirm: { type: "boolean", default: false },
+        recursive: { type: "boolean", default: false },
+    },
+    positionals: true,
+    handler: del,
+};
+export async function del(args, globalOpts) {
+    const input = args.positionals[0];
+    if (!input) {
+        throw new CliError("INVALID_ARGS", "缺少文档 URL 或 token。用法: feishu-docs delete <url|token>");
+    }
+    const { client, authInfo } = await createClient(globalOpts);
+    const doc = await resolveDocument(client, authInfo, input);
+    if (doc.objType === "doc") {
+        throw new CliError("NOT_SUPPORTED", "旧版 doc 类型不支持此操作，请在飞书客户端中将文档升级为 docx 格式");
+    }
+    // Check for children — refuse unless --recursive
+    if (doc.hasChild && doc.spaceId && doc.nodeToken) {
+        const hasChildren = await checkChildren(client, authInfo, doc.spaceId, doc.nodeToken);
+        if (hasChildren && !args.recursive) {
+            throw new CliError("INVALID_ARGS", "该节点下有子文档，删除将同时删除所有子节点。如需继续，请添加 --recursive 参数");
+        }
+    }
+    // Confirmation prompt (unless --confirm)
+    if (!args.confirm) {
+        const titleStr = doc.title || doc.objToken;
+        process.stderr.write(`\n即将删除文档:\n`);
+        process.stderr.write(`  标题: ${titleStr}\n`);
+        process.stderr.write(`  类型: ${doc.objType}\n`);
+        process.stderr.write(`  token: ${doc.objToken}\n`);
+        if (doc.spaceId) {
+            process.stderr.write(`  知识库: ${doc.spaceId}\n`);
+        }
+        process.stderr.write(`\n  文档将移入回收站，30 天后永久删除。\n`);
+        process.stderr.write(`  如需跳过此确认，请添加 --confirm 参数。\n\n`);
+        // In non-interactive mode (Agent), just output the prompt and exit
+        // Agent should use --confirm
+        throw new CliError("INVALID_ARGS", "操作已取消。Agent 调用请添加 --confirm 参数");
+    }
+    // Wiki documents cannot be deleted via Open API — the drive/v1/files DELETE
+    // endpoint only works for files in the user's personal Space, not wiki nodes.
+    if (doc.spaceId) {
+        throw new CliError("NOT_SUPPORTED", `知识库文档不支持通过 API 删除。飞书开放平台未提供删除知识库节点的 API。\n` +
+            `  请在飞书客户端中手动删除: ${doc.title || doc.objToken}\n` +
+            `  知识库: ${doc.spaceId}, 节点: ${doc.nodeToken}`);
+    }
+    // Map doc type to drive file type (personal space files only)
+    const driveType = mapToDriveType(doc.objType);
+    // Execute delete (use fetchWithAuth to avoid SDK token override)
+    await fetchWithAuth(authInfo, `/open-apis/drive/v1/files/${encodeURIComponent(doc.objToken)}`, {
+        method: "DELETE",
+        params: { type: driveType },
+    });
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({
+            success: true,
+            deleted: doc.objToken,
+            title: doc.title,
+            type: doc.objType,
+        }) + "\n");
+    }
+    else {
+        const titleStr = doc.title || doc.objToken;
+        process.stdout.write(`已将 "${titleStr}" 移入回收站\n`);
+    }
+}
+//# sourceMappingURL=delete.js.map

package/dist/commands/delete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"delete.js","sourceRoot":"","sources":["../../src/commands/delete.ts"],"names":[],"mappings":"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"}

package/dist/commands/info.d.ts

@@ -0,0 +1,6 @@
+/**
+ * info command: Display document metadata.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function info(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/info.js

@@ -0,0 +1,69 @@
+/**
+ * info command: Display document metadata.
+ */
+import { createClient } from "../client.js";
+import { CliError } from "../utils/errors.js";
+import { resolveDocument } from "../utils/document-resolver.js";
+import { getDocumentInfo } from "../services/block-writer.js";
+export const meta = {
+    options: {},
+    positionals: true,
+    handler: info,
+};
+export async function info(args, globalOpts) {
+    const input = args.positionals[0];
+    if (!input) {
+        throw new CliError("INVALID_ARGS", "缺少文档 URL 或 token。用法: feishu-docs info <url|token>");
+    }
+    const { client, authInfo } = await createClient(globalOpts);
+    const doc = await resolveDocument(client, authInfo, input);
+    if (doc.objType === "doc") {
+        throw new CliError("NOT_SUPPORTED", "旧版 doc 类型不支持此操作，请在飞书客户端中将文档升级为 docx 格式");
+    }
+    // Fetch additional document info for docx type
+    let revisionId;
+    let docTitle = doc.title;
+    if (doc.objType === "docx") {
+        try {
+            const docInfo = await getDocumentInfo(client, authInfo, doc.objToken);
+            docTitle = docTitle || docInfo.title;
+            revisionId = docInfo.revisionId;
+        }
+        catch (err) {
+            process.stderr.write(`feishu-docs: warning: 获取文档详情失败: ${err.message}\n`);
+        }
+    }
+    const domain = globalOpts.lark ? "larksuite.com" : "feishu.cn";
+    const url = doc.spaceId
+        ? `https://${domain}/wiki/${doc.parsed.token}`
+        : `https://${domain}/${doc.objType}/${doc.objToken}`;
+    const output = {
+        title: docTitle,
+        type: doc.objType,
+        token: doc.objToken,
+        url,
+        ...(doc.nodeToken && { node_token: doc.nodeToken }),
+        ...(doc.spaceId && { space_id: doc.spaceId }),
+        ...(revisionId !== undefined && { revision: revisionId }),
+    };
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({ success: true, ...output }, null, 2) + "\n");
+    }
+    else {
+        if (docTitle)
+            process.stdout.write(`标题: ${docTitle}\n`);
+        process.stdout.write(`类型: ${doc.objType}\n`);
+        process.stdout.write(`URL:  ${url}\n`);
+        process.stdout.write(`token: ${doc.objToken}\n`);
+        if (doc.spaceId) {
+            process.stdout.write(`知识库: ${doc.spaceId}\n`);
+        }
+        if (doc.nodeToken) {
+            process.stdout.write(`node_token: ${doc.nodeToken}\n`);
+        }
+        if (revisionId !== undefined) {
+            process.stdout.write(`版本: ${revisionId}\n`);
+        }
+    }
+}
+//# sourceMappingURL=info.js.map

package/dist/commands/info.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"info.js","sourceRoot":"","sources":["../../src/commands/info.ts"],"names":[],"mappings":"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"}

package/dist/commands/login.d.ts

@@ -0,0 +1,10 @@
+/**
+ * login / logout / whoami commands.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const loginMeta: CommandMeta;
+export declare const logoutMeta: CommandMeta;
+export declare const whoamiMeta: CommandMeta;
+export declare function login(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;
+export declare function logout(_args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;
+export declare function whoami(_args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/login.js

@@ -0,0 +1,90 @@
+/**
+ * login / logout / whoami commands.
+ */
+import { oauthLogin, clearTokens, resolveAuth } from "../auth.js";
+import { CliError } from "../utils/errors.js";
+export const loginMeta = {
+    options: {
+        scope: { type: "string" },
+        port: { type: "string" },
+        "redirect-uri": { type: "string" },
+    },
+    positionals: false,
+    handler: login,
+};
+export const logoutMeta = {
+    options: {},
+    positionals: false,
+    handler: logout,
+};
+export const whoamiMeta = {
+    options: {},
+    positionals: false,
+    handler: whoami,
+};
+export async function login(args, globalOpts) {
+    const appId = process.env.FEISHU_APP_ID;
+    const appSecret = process.env.FEISHU_APP_SECRET;
+    if (!appId || !appSecret) {
+        throw new CliError("AUTH_REQUIRED", "请先设置 FEISHU_APP_ID 和 FEISHU_APP_SECRET 环境变量");
+    }
+    const scope = args.scope ||
+        "wiki:wiki docx:document docx:document.block:convert drive:drive contact:contact.base:readonly board:whiteboard:node:read bitable:app:readonly";
+    const tokens = await oauthLogin(appId, {
+        scope,
+        appSecret,
+        port: args.port,
+        redirectUri: args.redirectUri,
+        useLark: globalOpts.lark,
+    });
+    process.stderr.write("feishu-docs: 登录成功！token 已加密保存。\n");
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({ success: true, expires_at: tokens.expires_at }) + "\n");
+    }
+}
+export async function logout(_args, globalOpts) {
+    await clearTokens();
+    process.stderr.write("feishu-docs: 已清除保存的凭证。\n");
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({ success: true }) + "\n");
+    }
+}
+export async function whoami(_args, globalOpts) {
+    try {
+        const authInfo = await resolveAuth(globalOpts.auth || "auto");
+        if (globalOpts.json) {
+            process.stdout.write(JSON.stringify({
+                success: true,
+                mode: authInfo.mode,
+                app_id: authInfo.appId,
+                has_user_token: !!authInfo.userToken,
+            }) + "\n");
+        }
+        else {
+            process.stdout.write(`认证模式: ${authInfo.mode}\n`);
+            if (authInfo.appId) {
+                process.stdout.write(`App ID: ${authInfo.appId}\n`);
+            }
+            if (authInfo.userToken) {
+                process.stdout.write(`User Token: ${authInfo.userToken.slice(0, 10)}...\n`);
+                if (authInfo.expiresAt) {
+                    const expires = new Date(authInfo.expiresAt).toLocaleString();
+                    const expired = Date.now() >= authInfo.expiresAt;
+                    process.stdout.write(`过期时间: ${expires}${expired ? " (已过期)" : ""}\n`);
+                }
+            }
+        }
+    }
+    catch (err) {
+        if (globalOpts.json) {
+            process.stdout.write(JSON.stringify({
+                success: false,
+                error: err.message,
+            }) + "\n");
+        }
+        else {
+            process.stdout.write(`未认证: ${err.message}\n`);
+        }
+    }
+}
+//# sourceMappingURL=login.js.map

package/dist/commands/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../../src/commands/login.ts"],"names":[],"mappings":"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"}

package/dist/commands/ls.d.ts

@@ -0,0 +1,6 @@
+/**
+ * ls command: List files in a drive folder.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function ls(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/ls.js

@@ -0,0 +1,76 @@
+/**
+ * ls command: List files in a drive folder.
+ */
+import { createClient, fetchWithAuth } from "../client.js";
+import { CliError } from "../utils/errors.js";
+import { validateToken } from "../utils/validate.js";
+export const meta = {
+    options: {
+        type: { type: "string" },
+        limit: { type: "string" },
+    },
+    positionals: true,
+    handler: ls,
+};
+const TYPE_LABELS = {
+    doc: "文档",
+    docx: "新文档",
+    sheet: "表格",
+    bitable: "多维表格",
+    mindnote: "思维导图",
+    file: "文件",
+    folder: "文件夹",
+    slides: "幻灯片",
+};
+export async function ls(args, globalOpts) {
+    const { authInfo } = await createClient(globalOpts);
+    const folderToken = args.positionals[0] || undefined;
+    if (folderToken)
+        validateToken(folderToken, "folder_token");
+    const limit = args.limit ? Number(args.limit) : 50;
+    if (!Number.isInteger(limit) || limit < 1 || limit > 1000) {
+        throw new CliError("INVALID_ARGS", "--limit 必须是 1-1000 之间的整数");
+    }
+    if (args.type) {
+        const ALLOWED_TYPES = new Set(Object.keys(TYPE_LABELS));
+        if (!ALLOWED_TYPES.has(args.type)) {
+            throw new CliError("INVALID_ARGS", `无效的文件类型: ${args.type}。可选值: ${[...ALLOWED_TYPES].join(", ")}`);
+        }
+    }
+    const typeStr = args.type;
+    const params = {
+        page_size: Math.min(limit, 50),
+        ...(folderToken && { folder_token: folderToken }),
+        ...(typeStr && { type: typeStr }),
+    };
+    const items = [];
+    let pageToken;
+    do {
+        if (pageToken)
+            params.page_token = pageToken;
+        const res = await fetchWithAuth(authInfo, "/open-apis/drive/v1/files", {
+            params,
+        });
+        const data = res?.data;
+        if (data?.files) {
+            items.push(...data.files);
+        }
+        pageToken = data?.has_more ? data.next_page_token : undefined;
+    } while (pageToken && items.length < limit);
+    const trimmed = items.slice(0, limit);
+    if (globalOpts.json) {
+        process.stdout.write(JSON.stringify({ success: true, count: trimmed.length, files: trimmed }, null, 2) + "\n");
+        return;
+    }
+    if (trimmed.length === 0) {
+        process.stdout.write("文件夹为空\n");
+        return;
+    }
+    for (const f of trimmed) {
+        const name = f.name || "(未命名)";
+        const type = TYPE_LABELS[f.type] || f.type || "unknown";
+        const token = f.token || "";
+        process.stdout.write(`  ${name}  [${type}]  ${token}\n`);
+    }
+}
+//# sourceMappingURL=ls.js.map

package/dist/commands/ls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ls.js","sourceRoot":"","sources":["../../src/commands/ls.ts"],"names":[],"mappings":"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"}

package/dist/commands/read.d.ts

@@ -0,0 +1,6 @@
+/**
+ * read command: Read a Feishu document and output as Markdown.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function read(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;