feishu-docs-cli 0.1.0-beta.10

package/dist/cli.js

@@ -0,0 +1,197 @@
+/**
+ * CLI entry point: declarative command registration + routing.
+ * Supports both top-level commands and subcommands (e.g., share list).
+ */
+import { parseArgs } from "node:util";
+import { loginMeta, logoutMeta, whoamiMeta } from "./commands/login.js";
+import { meta as authorizeMeta } from "./commands/authorize.js";
+import { meta as readMeta } from "./commands/read.js";
+import { meta as spaceMeta } from "./commands/spaces.js";
+import { meta as treeMeta } from "./commands/tree.js";
+import { meta as catMeta } from "./commands/cat.js";
+import { meta as searchMeta } from "./commands/search.js";
+import { meta as createMeta } from "./commands/create.js";
+import { meta as updateMeta } from "./commands/update.js";
+import { meta as deleteMeta } from "./commands/delete.js";
+import { meta as shareMeta } from "./commands/share.js";
+import { meta as infoMeta } from "./commands/info.js";
+import { meta as lsMeta } from "./commands/ls.js";
+import { meta as mvMeta } from "./commands/mv.js";
+import { meta as cpMeta } from "./commands/cp.js";
+import { meta as mkdirMeta } from "./commands/mkdir.js";
+import { meta as wikiMeta } from "./commands/wiki.js";
+import { meta as installSkillMeta } from "./commands/install-skill.js";
+import { handleError, CliError } from "./utils/errors.js";
+import { getLocalVersion, checkForUpdates } from "./utils/version.js";
+const HELP_TEXT = `feishu-docs - AI Agent 飞书云文档 CLI 工具
+
+用法: feishu-docs <command> [options]
+
+认证:
+  login [--scope "..."] [--redirect-uri <url>] [--port <port>]
+                                           OAuth 登录（申请基础免审权限）
+  authorize [--scope "..."]               申请额外权限（可能需管理员审核）
+  logout                                   清除已保存的凭证
+  whoami                                   查看当前认证身份和模式
+
+文档:
+  read   <url|token>                       读取文档，输出 Markdown
+  create <title> [options]                 创建文档
+  update <url|token> [options]             更新文档内容
+  delete <url|token>                       删除文档
+  info   <url|token>                       查看文档元信息
+
+知识库:
+  spaces                                   列出所有知识库
+  tree   <space_id|url> [--node <token>]   展示知识库节点树
+  cat    <space_id|url> [--node <token>]   递归读取节点下所有文档
+  wiki create-space <name>                 创建知识库
+  wiki add-member <space_id> <member>      添加知识库成员
+  wiki remove-member <space_id> <member>   移除知识库成员
+  wiki rename <url> --title <new_title>    重命名节点
+  wiki move <url> --to <space_id>          移动节点
+  wiki copy <url> --to <space_id>          复制节点
+
+搜索:
+  search <query> [options]                 搜索文档
+
+云空间:
+  ls     [folder_token]                    列出文件夹内容
+  mv     <url|token> <target_folder>       移动文件
+  cp     <url|token> <target_folder>       复制文件
+  mkdir  <name> [--parent <folder_token>]  创建文件夹
+
+权限:
+  share list <url>                         查看协作者
+  share add <url> <member> --role <role>   添加协作者
+  share remove <url> <member>              移除协作者
+  share update <url> <member> --role <role> 修改协作者权限
+  share set <url> --public <mode>          修改分享设置
+
+Agent:
+  install-skill                            安装 Claude Code Skill
+
+全局选项:
+  --auth <user|tenant|auto>   认证模式（默认 auto）
+  --json                      输出 JSON 格式
+  --lark                      使用海外 Lark 域名
+  --help                      显示帮助信息
+  -v, --version               显示版本号
+`;
+const GLOBAL_OPTIONS = {
+    auth: { type: "string", default: "auto" },
+    json: { type: "boolean", default: false },
+    lark: { type: "boolean", default: false },
+    help: { type: "boolean", default: false },
+};
+/**
+ * Command registry: name → meta definition.
+ * Each meta has: { handler, options, positionals } or { subcommands }.
+ */
+const COMMANDS = {
+    login: loginMeta,
+    authorize: authorizeMeta,
+    logout: logoutMeta,
+    whoami: whoamiMeta,
+    read: readMeta,
+    spaces: spaceMeta,
+    tree: treeMeta,
+    cat: catMeta,
+    search: searchMeta,
+    create: createMeta,
+    update: updateMeta,
+    delete: deleteMeta,
+    share: shareMeta,
+    info: infoMeta,
+    ls: lsMeta,
+    mv: mvMeta,
+    cp: cpMeta,
+    mkdir: mkdirMeta,
+    wiki: wikiMeta,
+    "install-skill": installSkillMeta,
+};
+function extractGlobalOpts(values) {
+    return {
+        auth: values.auth,
+        json: values.json,
+        lark: values.lark,
+    };
+}
+/**
+ * Remap hyphenated option keys to camelCase for args.
+ */
+function remapArgs(values, optionDefs) {
+    const args = {};
+    for (const key of Object.keys(optionDefs)) {
+        const camel = key.replace(/-([a-z])/g, (_, c) => c.toUpperCase());
+        if (values[key] !== undefined) {
+            args[camel] = values[key];
+        }
+    }
+    return args;
+}
+/**
+ * Parse and dispatch a command.
+ */
+function parseAndRun(def, argv) {
+    const allOptions = { ...GLOBAL_OPTIONS, ...def.options };
+    const { values, positionals } = parseArgs({
+        args: argv,
+        options: allOptions,
+        allowPositionals: def.positionals ?? false,
+        strict: false,
+    });
+    const globalOpts = extractGlobalOpts(values);
+    const args = remapArgs(values, def.options);
+    if (def.positionals) {
+        args.positionals = positionals;
+    }
+    return { handler: def.handler, args, globalOpts };
+}
+export async function run(argv) {
+    if (argv.includes("--version") || argv.includes("-v")) {
+        process.stdout.write(`feishu-docs ${getLocalVersion()}\n`);
+        return;
+    }
+    if (argv.length === 0 || argv.includes("--help") || argv.includes("-h")) {
+        process.stdout.write(HELP_TEXT);
+        return;
+    }
+    // Non-blocking update check (runs in background, never throws)
+    const updateCheck = checkForUpdates();
+    const command = argv[0];
+    const restArgs = argv.slice(1);
+    const def = COMMANDS[command];
+    if (!def) {
+        throw new CliError("INVALID_ARGS", `未知命令: ${command}。运行 feishu-docs --help 查看可用命令`);
+    }
+    let handler, args, globalOpts;
+    if (def.subcommands) {
+        const subDef = def;
+        const subName = restArgs[0];
+        if (!subName ||
+            subName === "--help" ||
+            subName === "-h" ||
+            !subDef.subcommands[subName]) {
+            const available = Object.keys(subDef.subcommands).join(", ");
+            throw new CliError("INVALID_ARGS", `用法: feishu-docs ${command} <${available}> [options]`);
+        }
+        const subCmd = subDef.subcommands[subName];
+        const subArgs = restArgs.slice(1);
+        ({ handler, args, globalOpts } = parseAndRun(subCmd, subArgs));
+    }
+    else {
+        ({ handler, args, globalOpts } = parseAndRun(def, restArgs));
+    }
+    try {
+        await handler(args, globalOpts);
+    }
+    catch (err) {
+        handleError(err, globalOpts.json);
+    }
+    finally {
+        // Wait for background update check to complete (never throws)
+        await updateCheck;
+    }
+}
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Auth client factory and API utilities.
+ */
+import type { AuthInfo, GlobalOpts, FetchOptions, ApiResponse } from "./types/index.js";
+/**
+ * Create auth context for API calls.
+ * @param {object} options - { auth: 'user'|'tenant'|'auto', lark: boolean }
+ * @returns {{ authInfo: AuthInfo }}
+ */
+export declare function createClient(options?: Partial<GlobalOpts>, _refreshAttempt?: number): Promise<{
+    authInfo: AuthInfo;
+}>;
+/**
+ * Resolve the API base URL based on whether we're using Lark or Feishu.
+ */
+export declare function getApiBase(authInfo: AuthInfo): string;
+/**
+ * Get tenant_access_token for tenant mode API calls.
+ */
+export declare function getTenantToken(authInfo: AuthInfo): Promise<string>;
+/**
+ * Direct fetch wrapper that correctly passes user/tenant token.
+ */
+export declare function fetchWithAuth(authInfo: AuthInfo, path: string, options?: FetchOptions): Promise<ApiResponse>;
+/**
+ * Fetch binary data with auth (for APIs that return file streams).
+ */
+export declare function fetchBinaryWithAuth(authInfo: AuthInfo, path: string): Promise<ArrayBuffer>;

package/dist/client.js

@@ -0,0 +1,256 @@
+/**
+ * Auth client factory and API utilities.
+ */
+import { resolveAuth, refreshUserToken, acquireRefreshLock } from "./auth.js";
+import { CliError, mapApiError } from "./utils/errors.js";
+const FEISHU_BASE = "https://open.feishu.cn";
+const LARK_BASE = "https://open.larksuite.com";
+/**
+ * Create auth context for API calls.
+ * @param {object} options - { auth: 'user'|'tenant'|'auto', lark: boolean }
+ * @returns {{ authInfo: AuthInfo }}
+ */
+export async function createClient(options = {}, _refreshAttempt = 0) {
+    const authMode = options.auth || "auto";
+    const useLark = options.lark || false;
+    const resolved = await resolveAuth(authMode);
+    const authInfo = { ...resolved, useLark };
+    const { appId, appSecret } = authInfo;
+    if (!appId || !appSecret) {
+        if (authInfo.mode === "user" && authInfo.userToken) {
+            // User token from env, no app credentials needed for some APIs
+            return { authInfo };
+        }
+        throw new CliError("AUTH_REQUIRED", "缺少 FEISHU_APP_ID 或 FEISHU_APP_SECRET");
+    }
+    // Auto-refresh user token if expired
+    if (authInfo.mode === "user" && authInfo.expiresAt) {
+        if (Date.now() >= authInfo.expiresAt) {
+            if (authInfo.refreshToken) {
+                try {
+                    process.stderr.write("feishu-docs: info: token 已过期，正在自动刷新...\n");
+                    const releaseLock = await acquireRefreshLock();
+                    if (!releaseLock) {
+                        if (_refreshAttempt >= 3) {
+                            throw new CliError("TOKEN_EXPIRED", "等待 token 刷新超时。如果问题持续，请手动删除 ~/.feishu-docs/.refresh.lock 后重试");
+                        }
+                        process.stderr.write("feishu-docs: info: 另一个进程正在刷新 token，等待中...\n");
+                        await new Promise((r) => setTimeout(r, 2000));
+                        return createClient(options, _refreshAttempt + 1);
+                    }
+                    try {
+                        const newTokens = await refreshUserToken(appId, appSecret, authInfo.refreshToken, { useLark });
+                        const refreshedAuthInfo = {
+                            ...authInfo,
+                            userToken: newTokens.user_access_token,
+                            expiresAt: newTokens.expires_at,
+                            refreshToken: newTokens.refresh_token,
+                        };
+                        return { authInfo: refreshedAuthInfo };
+                    }
+                    finally {
+                        await releaseLock();
+                    }
+                }
+                catch (refreshErr) {
+                    const refreshError = refreshErr;
+                    // In auto mode, fall back to tenant auth instead of failing
+                    if (authMode === "auto" && appId && appSecret) {
+                        process.stderr.write(`feishu-docs: info: 自动刷新失败 (${refreshError.message})，回退到 tenant 模式\n`);
+                        const tenantAuthInfo = {
+                            ...authInfo,
+                            mode: "tenant",
+                            userToken: undefined,
+                        };
+                        return { authInfo: tenantAuthInfo };
+                    }
+                    throw new CliError("TOKEN_EXPIRED", "自动刷新 token 失败，请重新运行 feishu-docs login", {
+                        recovery: "运行 feishu-docs login 重新认证",
+                    });
+                }
+            }
+            else {
+                // In auto mode, fall back to tenant auth instead of failing
+                if (authMode === "auto" && appId && appSecret) {
+                    process.stderr.write("feishu-docs: info: user token 已过期，回退到 tenant 模式\n");
+                    const tenantAuthInfo = {
+                        ...authInfo,
+                        mode: "tenant",
+                        userToken: undefined,
+                    };
+                    return { authInfo: tenantAuthInfo };
+                }
+                throw new CliError("TOKEN_EXPIRED", "token 已过期，请重新运行 feishu-docs login", {
+                    recovery: "运行 feishu-docs login 重新认证",
+                });
+            }
+        }
+    }
+    return { authInfo };
+}
+/**
+ * Resolve the API base URL based on whether we're using Lark or Feishu.
+ */
+export function getApiBase(authInfo) {
+    return authInfo.useLark ? LARK_BASE : FEISHU_BASE;
+}
+/**
+ * Get tenant_access_token for tenant mode API calls.
+ */
+export async function getTenantToken(authInfo) {
+    const res = await fetch(`${getApiBase(authInfo)}/open-apis/auth/v3/tenant_access_token/internal`, {
+        method: "POST",
+        headers: { "Content-Type": "application/json" },
+        body: JSON.stringify({
+            app_id: authInfo.appId,
+            app_secret: authInfo.appSecret,
+        }),
+    });
+    const body = (await res.json());
+    if (body.code !== 0) {
+        throw new CliError("AUTH_REQUIRED", `获取 tenant_access_token 失败: ${body.msg}`, {
+            apiCode: body.code,
+        });
+    }
+    if (!body.tenant_access_token) {
+        throw new CliError("AUTH_REQUIRED", "获取 tenant_access_token 失败: API 返回空值");
+    }
+    return body.tenant_access_token;
+}
+/**
+ * Build Authorization header value for any auth mode.
+ */
+async function resolveBearer(authInfo) {
+    if (authInfo.mode === "user" && authInfo.userToken) {
+        return `Bearer ${authInfo.userToken}`;
+    }
+    if (authInfo.tenantToken) {
+        return `Bearer ${authInfo.tenantToken}`;
+    }
+    const tenantToken = await getTenantToken(authInfo);
+    return `Bearer ${tenantToken}`;
+}
+/**
+ * Direct fetch wrapper that correctly passes user/tenant token.
+ */
+export async function fetchWithAuth(authInfo, path, options = {}) {
+    const base = getApiBase(authInfo);
+    const bearer = await resolveBearer(authInfo);
+    const url = new URL(path, base);
+    if (options.params) {
+        for (const [key, value] of Object.entries(options.params)) {
+            if (value === undefined || value === null)
+                continue;
+            if (Array.isArray(value)) {
+                for (const item of value) {
+                    url.searchParams.append(key, String(item));
+                }
+            }
+            else {
+                url.searchParams.set(key, String(value));
+            }
+        }
+    }
+    const fetchOpts = {
+        method: options.method || "GET",
+        headers: {
+            "Content-Type": "application/json",
+            ...options.headers,
+            Authorization: bearer,
+        },
+    };
+    if (options.body) {
+        fetchOpts.body = JSON.stringify(options.body);
+    }
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 30_000);
+    let res;
+    try {
+        res = await fetch(url.toString(), {
+            ...fetchOpts,
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        const error = err;
+        if (error.name === "AbortError") {
+            throw new CliError("API_ERROR", "API 请求超时（30秒）", {
+                retryable: true,
+            });
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+    const body = (await res.json());
+    if (body.code !== undefined && body.code !== 0) {
+        // Scope errors: extract missing scopes from permission_violations
+        if (body.code === 99991672 || body.code === 99991679) {
+            const scopes = extractScopesFromError(body);
+            const scopeStr = scopes.length > 0 ? scopes.join(" ") : "";
+            const hint = scopes.length > 0
+                ? `缺少以下权限: ${scopes.join(", ")}。运行: feishu-docs authorize --scope "${scopeStr}"`
+                : body.msg || "权限不足";
+            throw new CliError("SCOPE_MISSING", hint, {
+                apiCode: body.code,
+                missingScopes: scopes,
+                recovery: scopes.length > 0
+                    ? `feishu-docs authorize --scope "${scopeStr}"`
+                    : "检查飞书开发者后台的应用权限配置",
+            });
+        }
+        throw mapApiError({ code: body.code, msg: body.msg });
+    }
+    return body;
+}
+/**
+ * Extract scope names from Feishu API error response.
+ *
+ * Newer APIs include `error.permission_violations[].subject` with exact scope names.
+ * Older APIs may omit this field entirely — returns empty array in that case.
+ */
+function extractScopesFromError(body) {
+    const error = body.error;
+    const violations = error?.permission_violations;
+    if (!Array.isArray(violations))
+        return [];
+    return violations
+        .map((v) => v.subject)
+        .filter((s) => typeof s === "string" && s.length > 0);
+}
+/**
+ * Fetch binary data with auth (for APIs that return file streams).
+ */
+export async function fetchBinaryWithAuth(authInfo, path) {
+    const base = getApiBase(authInfo);
+    const bearer = await resolveBearer(authInfo);
+    const url = new URL(path, base);
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 60_000);
+    let res;
+    try {
+        res = await fetch(url.toString(), {
+            method: "GET",
+            headers: { Authorization: bearer },
+            signal: controller.signal,
+        });
+    }
+    catch (err) {
+        const error = err;
+        if (error.name === "AbortError") {
+            throw new CliError("API_ERROR", "API 请求超时（60秒）", {
+                retryable: true,
+            });
+        }
+        throw err;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+    if (!res.ok) {
+        throw new CliError("API_ERROR", `下载失败: HTTP ${res.status} ${res.statusText}`);
+    }
+    return res.arrayBuffer();
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/commands/authorize.d.ts

@@ -0,0 +1,12 @@
+/**
+ * authorize command: Request additional OAuth scopes on-demand.
+ *
+ * Reads currently stored scopes, merges with the requested ones, and
+ * re-runs the OAuth flow so the user grants only what is needed.
+ *
+ * Scopes to request typically come from API error messages — when a command
+ * fails with SCOPE_MISSING, the error includes the exact scope names needed.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function authorize(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;

package/dist/commands/authorize.js

@@ -0,0 +1,73 @@
+/**
+ * authorize command: Request additional OAuth scopes on-demand.
+ *
+ * Reads currently stored scopes, merges with the requested ones, and
+ * re-runs the OAuth flow so the user grants only what is needed.
+ *
+ * Scopes to request typically come from API error messages — when a command
+ * fails with SCOPE_MISSING, the error includes the exact scope names needed.
+ */
+import { oauthLogin, loadTokens } from "../auth.js";
+import { CliError } from "../utils/errors.js";
+import { BASE_SCOPES, mergeScopes } from "../scopes.js";
+/** Feishu scope tokens follow the pattern: word:word or word:word:word */
+const SCOPE_TOKEN_RE = /^\w[\w-]*:[\w.:/-]+$/;
+export const meta = {
+    options: {
+        scope: { type: "string" },
+        port: { type: "string" },
+        "redirect-uri": { type: "string" },
+    },
+    positionals: false,
+    handler: authorize,
+};
+export async function authorize(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 环境变量");
+    }
+    if (!args.scope) {
+        throw new CliError("INVALID_ARGS", `请指定 --scope 参数。\n\n` +
+            `示例:\n` +
+            `  feishu-docs authorize --scope "drive:drive"\n` +
+            `  feishu-docs authorize --scope "drive:drive contact:contact.base:readonly"\n\n` +
+            `提示: 当命令因权限不足失败时，错误信息中会包含所需的 scope 名称。`);
+    }
+    // Parse and validate scopes
+    const rawScopes = args.scope.split(/\s+/).filter(Boolean);
+    const extraScopes = [];
+    for (const s of rawScopes) {
+        if (!SCOPE_TOKEN_RE.test(s)) {
+            throw new CliError("INVALID_ARGS", `无效的 scope 格式: "${s}"。scope 应为 "namespace:resource" 或 "namespace:resource:action" 格式`);
+        }
+        extraScopes.push(s);
+    }
+    if (extraScopes.length === 0) {
+        throw new CliError("INVALID_ARGS", "未指定任何有效的 scope，操作已取消");
+    }
+    // Merge with currently stored scopes (so we don't lose existing grants).
+    const stored = await loadTokens();
+    const currentScopes = stored?.tokens?.scope
+        ? stored.tokens.scope.split(/\s+/).filter(Boolean)
+        : BASE_SCOPES;
+    const merged = mergeScopes(currentScopes, extraScopes);
+    const scopeStr = merged.join(" ");
+    process.stderr.write(`\n即将申请以下权限（包含已有权限）:\n  ${scopeStr}\n\n`);
+    const tokens = await oauthLogin(appId, {
+        scope: scopeStr,
+        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,
+            scope: scopeStr,
+            expires_at: tokens.expires_at,
+        }) + "\n");
+    }
+}
+//# sourceMappingURL=authorize.js.map

package/dist/commands/authorize.js.map

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

package/dist/commands/cat.d.ts

@@ -0,0 +1,6 @@
+/**
+ * cat command: Recursively read all documents under a knowledge base node.
+ */
+import { CommandMeta, CommandArgs, GlobalOpts } from "../types/index.js";
+export declare const meta: CommandMeta;
+export declare function cat(args: CommandArgs, globalOpts: GlobalOpts): Promise<void>;