feishu-docs-cli 0.1.0-beta.10

package/dist/utils/errors.js

@@ -0,0 +1,114 @@
+/**
+ * Unified error handling for feishu-docs CLI.
+ *
+ * Exit codes:
+ *   0 - success
+ *   1 - invalid args / file not found
+ *   2 - auth failure
+ *   3 - API error
+ */
+const ERROR_MAP = {
+    INVALID_ARGS: { exit: 1, type: "INVALID_ARGS" },
+    FILE_NOT_FOUND: { exit: 1, type: "FILE_NOT_FOUND" },
+    AUTH_REQUIRED: { exit: 2, type: "AUTH_REQUIRED" },
+    TOKEN_EXPIRED: { exit: 2, type: "TOKEN_EXPIRED" },
+    PERMISSION_DENIED: { exit: 2, type: "PERMISSION_DENIED" },
+    SCOPE_MISSING: { exit: 2, type: "SCOPE_MISSING" },
+    NOT_FOUND: { exit: 3, type: "NOT_FOUND" },
+    NOT_SUPPORTED: { exit: 3, type: "NOT_SUPPORTED" },
+    RATE_LIMITED: { exit: 3, type: "RATE_LIMITED" },
+    API_ERROR: { exit: 3, type: "API_ERROR" },
+};
+export class CliError extends Error {
+    exitCode;
+    errorType;
+    apiCode;
+    retryable;
+    recovery;
+    /** Scope names from API permission_violations (only for SCOPE_MISSING). */
+    missingScopes;
+    constructor(type, message, { apiCode, retryable = false, recovery, missingScopes, } = {}) {
+        super(message);
+        this.name = "CliError";
+        const info = ERROR_MAP[type] || ERROR_MAP.API_ERROR;
+        this.exitCode = info.exit;
+        this.errorType = info.type;
+        this.apiCode = apiCode;
+        this.retryable = retryable;
+        this.recovery = recovery;
+        this.missingScopes = missingScopes;
+    }
+}
+export function formatError(err, json = false) {
+    if (err instanceof CliError) {
+        if (json) {
+            return JSON.stringify({
+                success: false,
+                error: {
+                    type: err.errorType,
+                    message: err.message,
+                    api_code: err.apiCode,
+                    retryable: err.retryable,
+                    recovery: err.recovery,
+                    ...(err.missingScopes &&
+                        err.missingScopes.length > 0 && {
+                        missing_scopes: err.missingScopes,
+                    }),
+                },
+            });
+        }
+        const code = err.apiCode ? ` (code: ${err.apiCode})` : "";
+        return `feishu-docs: error: ${err.message}${code}`;
+    }
+    const safeMessage = err.message || "未知错误";
+    if (json) {
+        return JSON.stringify({
+            success: false,
+            error: {
+                type: "UNKNOWN",
+                message: safeMessage,
+                retryable: false,
+            },
+        });
+    }
+    return `feishu-docs: error: ${safeMessage}`;
+}
+export function handleError(err, json = false) {
+    process.stderr.write(formatError(err, json) + "\n");
+    const exitCode = err instanceof CliError ? err.exitCode : 1;
+    process.exit(exitCode);
+}
+export function mapApiError(err) {
+    const e = err;
+    const code = e?.code ?? e?.response?.data?.code ?? e?.response?.code;
+    const msg = e?.msg ?? e?.response?.data?.msg ?? e?.response?.msg ?? e?.message;
+    if (code === 131006) {
+        return new CliError("PERMISSION_DENIED", `权限不足，请确认文档已对当前用户开放访问权限`, {
+            apiCode: code,
+            recovery: "请求文档拥有者授予访问权限，或使用 --auth user 切换身份",
+        });
+    }
+    if (code === 131008) {
+        // 131008 is context-dependent: "permission denied" for node ops, "already exist" for member ops.
+        // Preserve apiCode so callers can distinguish at the call site.
+        return new CliError("PERMISSION_DENIED", msg || "权限不足或资源已存在", {
+            apiCode: code,
+            recovery: "请求文档拥有者授予访问权限，或使用 --auth user 切换身份",
+        });
+    }
+    if (code === 131001 || code === 131002) {
+        return new CliError("NOT_FOUND", `文档不存在或已被删除`, {
+            apiCode: code,
+        });
+    }
+    if (code === 99991400 || code === 99991663) {
+        return new CliError("TOKEN_EXPIRED", `认证已过期，请重新运行 feishu-docs login`, {
+            apiCode: code,
+            recovery: "运行 feishu-docs login 重新认证",
+        });
+    }
+    // 99991672 / 99991679 are scope errors — handled directly in fetchWithAuth
+    // before mapApiError is called. If they reach here, treat as generic API error.
+    return new CliError("API_ERROR", msg || "未知 API 错误", { apiCode: code });
+}
+//# sourceMappingURL=errors.js.map

package/dist/utils/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,MAAM,SAAS,GAAmD;IAChE,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE;IAC/C,cAAc,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,gBAAgB,EAAE;IACnD,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE;IACjD,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE;IACjD,iBAAiB,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,mBAAmB,EAAE;IACzD,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE;IACjD,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE;IACzC,aAAa,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE;IACjD,YAAY,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,cAAc,EAAE;IAC/C,SAAS,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE;CAC1C,CAAC;AAEF,MAAM,OAAO,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAS;IACjB,SAAS,CAAS;IAClB,OAAO,CAAU;IACjB,SAAS,CAAU;IACnB,QAAQ,CAAU;IAClB,2EAA2E;IAC3E,aAAa,CAAY;IAEzB,YACE,IAAe,EACf,OAAe,EACf,EACE,OAAO,EACP,SAAS,GAAG,KAAK,EACjB,QAAQ,EACR,aAAa,MACM,EAAE;QAEvB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,UAAU,CAAC;QACvB,MAAM,IAAI,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,SAAS,CAAC,SAAS,CAAC;QACpD,IAAI,CAAC,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC;QAC3B,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED,MAAM,UAAU,WAAW,CAAC,GAAY,EAAE,OAAgB,KAAK;IAC7D,IAAI,GAAG,YAAY,QAAQ,EAAE,CAAC;QAC5B,IAAI,IAAI,EAAE,CAAC;YACT,OAAO,IAAI,CAAC,SAAS,CAAC;gBACpB,OAAO,EAAE,KAAK;gBACd,KAAK,EAAE;oBACL,IAAI,EAAE,GAAG,CAAC,SAAS;oBACnB,OAAO,EAAE,GAAG,CAAC,OAAO;oBACpB,QAAQ,EAAE,GAAG,CAAC,OAAO;oBACrB,SAAS,EAAE,GAAG,CAAC,SAAS;oBACxB,QAAQ,EAAE,GAAG,CAAC,QAAQ;oBACtB,GAAG,CAAC,GAAG,CAAC,aAAa;wBACnB,GAAG,CAAC,aAAa,CAAC,MAAM,GAAG,CAAC,IAAI;wBAC9B,cAAc,EAAE,GAAG,CAAC,aAAa;qBAClC,CAAC;iBACL;aACF,CAAC,CAAC;QACL,CAAC;QACD,MAAM,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,GAAG,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC;QAC1D,OAAO,uBAAuB,GAAG,CAAC,OAAO,GAAG,IAAI,EAAE,CAAC;IACrD,CAAC;IAED,MAAM,WAAW,GAAI,GAA4B,CAAC,OAAO,IAAI,MAAM,CAAC;IACpE,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,IAAI,CAAC,SAAS,CAAC;YACpB,OAAO,EAAE,KAAK;YACd,KAAK,EAAE;gBACL,IAAI,EAAE,SAAS;gBACf,OAAO,EAAE,WAAW;gBACpB,SAAS,EAAE,KAAK;aACjB;SACF,CAAC,CAAC;IACL,CAAC;IACD,OAAO,uBAAuB,WAAW,EAAE,CAAC;AAC9C,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,GAAY,EAAE,OAAgB,KAAK;IAC7D,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,WAAW,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC;IACpD,MAAM,QAAQ,GAAG,GAAG,YAAY,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;AACzB,CAAC;AAgBD,MAAM,UAAU,WAAW,CAAC,GAAY;IACtC,MAAM,CAAC,GAAG,GAAoB,CAAC;IAC/B,MAAM,IAAI,GAAG,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC;IACrE,MAAM,GAAG,GACP,CAAC,EAAE,GAAG,IAAI,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,EAAE,OAAO,CAAC;IAErE,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,IAAI,QAAQ,CACjB,mBAAmB,EACnB,wBAAwB,EACxB;YACE,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,oCAAoC;SAC/C,CACF,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,iGAAiG;QACjG,gEAAgE;QAChE,OAAO,IAAI,QAAQ,CAAC,mBAAmB,EAAE,GAAG,IAAI,YAAY,EAAE;YAC5D,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,oCAAoC;SAC/C,CAAC,CAAC;IACL,CAAC;IACD,IAAI,IAAI,KAAK,MAAM,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACvC,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,YAAY,EAAE;YAC7C,OAAO,EAAE,IAAI;SACd,CAAC,CAAC;IACL,CAAC;IACD,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC3C,OAAO,IAAI,QAAQ,CACjB,eAAe,EACf,+BAA+B,EAC/B;YACE,OAAO,EAAE,IAAI;YACb,QAAQ,EAAE,2BAA2B;SACtC,CACF,CAAC;IACJ,CAAC;IACD,2EAA2E;IAC3E,gFAAgF;IAChF,OAAO,IAAI,QAAQ,CAAC,WAAW,EAAE,GAAG,IAAI,WAAW,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AAC1E,CAAC"}

package/dist/utils/member.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Shared member ID utilities for wiki and share commands.
+ */
+/**
+ * Validate member_id format to prevent path injection.
+ */
+export declare function validateMemberId(memberId: string): void;
+/**
+ * Auto-detect member_type from member identifier.
+ */
+export declare function detectMemberType(memberId: string): string;

package/dist/utils/member.js

@@ -0,0 +1,30 @@
+/**
+ * Shared member ID utilities for wiki and share commands.
+ */
+import { CliError } from "./errors.js";
+const MEMBER_ID_RE = /^[A-Za-z0-9@._\-+]{1,200}$/;
+/**
+ * Validate member_id format to prevent path injection.
+ */
+export function validateMemberId(memberId) {
+    if (!MEMBER_ID_RE.test(memberId)) {
+        throw new CliError("INVALID_ARGS", `无效的 member_id 格式: ${memberId}`);
+    }
+}
+/**
+ * Auto-detect member_type from member identifier.
+ */
+export function detectMemberType(memberId) {
+    if (memberId.includes("@"))
+        return "email";
+    if (memberId.startsWith("ou_"))
+        return "openid";
+    if (memberId.startsWith("on_"))
+        return "unionid";
+    if (memberId.startsWith("oc_"))
+        return "openchat";
+    if (memberId.startsWith("od_"))
+        return "opendepartmentid";
+    return "userid";
+}
+//# sourceMappingURL=member.js.map

package/dist/utils/member.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"member.js","sourceRoot":"","sources":["../../src/utils/member.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAElD;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC;QACjC,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,qBAAqB,QAAQ,EAAE,CAAC,CAAC;IACtE,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAC/C,IAAI,QAAQ,CAAC,QAAQ,CAAC,GAAG,CAAC;QAAE,OAAO,OAAO,CAAC;IAC3C,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,QAAQ,CAAC;IAChD,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,SAAS,CAAC;IACjD,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,UAAU,CAAC;IAClD,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAC1D,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/utils/scope-prompt.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Reactive scope authorization: prompt and recovery utilities.
+ *
+ * Instead of pre-flight scope checks, this module provides:
+ *
+ * - `promptScopeAuth()` — Interactive OAuth prompt for missing scopes.
+ * - `withScopeRecovery()` — Wrapper that catches SCOPE_MISSING errors,
+ *   prompts the user (if interactive), and retries the operation once.
+ *
+ * The Feishu API is the source of truth for required scopes. When an API
+ * call fails with 99991672 (app scope) or 99991679 (user scope), `fetchWithAuth`
+ * throws `CliError("SCOPE_MISSING", { missingScopes })`. This module handles
+ * the recovery.
+ */
+import type { GlobalOpts } from "../types/index.js";
+/**
+ * Prompt the user to authorize missing scopes interactively.
+ *
+ * 1. Tells the user which scopes are missing.
+ * 2. Reminds them to enable the scopes in the Feishu developer console.
+ * 3. Asks whether to run the OAuth flow now.
+ *
+ * Returns `true` if authorization succeeded, `false` otherwise.
+ * Always returns `false` in non-interactive contexts (JSON mode, non-TTY).
+ */
+export declare function promptScopeAuth(missingScopes: string[], globalOpts: GlobalOpts): Promise<boolean>;
+/**
+ * Wrap an async operation with reactive scope error recovery.
+ *
+ * When the operation throws `CliError("SCOPE_MISSING")`:
+ * - If interactive (TTY + non-JSON) and scopes are known: prompt → retry once.
+ * - Otherwise: re-throw with a clear recovery hint.
+ *
+ * @param fallbackScopes  Scope names to use when the API doesn't include
+ *   `permission_violations` (older APIs like search). When the error has
+ *   empty `missingScopes` but `fallbackScopes` is provided, these are used
+ *   for the authorization prompt.
+ */
+export declare function withScopeRecovery<T>(fn: () => Promise<T>, globalOpts: GlobalOpts, fallbackScopes?: string[]): Promise<T>;

package/dist/utils/scope-prompt.js

@@ -0,0 +1,134 @@
+/**
+ * Reactive scope authorization: prompt and recovery utilities.
+ *
+ * Instead of pre-flight scope checks, this module provides:
+ *
+ * - `promptScopeAuth()` — Interactive OAuth prompt for missing scopes.
+ * - `withScopeRecovery()` — Wrapper that catches SCOPE_MISSING errors,
+ *   prompts the user (if interactive), and retries the operation once.
+ *
+ * The Feishu API is the source of truth for required scopes. When an API
+ * call fails with 99991672 (app scope) or 99991679 (user scope), `fetchWithAuth`
+ * throws `CliError("SCOPE_MISSING", { missingScopes })`. This module handles
+ * the recovery.
+ */
+import * as readline from "node:readline";
+import { oauthLogin, loadTokens } from "../auth.js";
+import { CliError } from "./errors.js";
+import { BASE_SCOPES, mergeScopes, buildScopeHint } from "../scopes.js";
+/**
+ * Ask a yes/no question on stderr, read from stdin.
+ * Returns true only if user answers "y" or "yes".
+ */
+function askYesNo(question) {
+    return new Promise((resolve) => {
+        const rl = readline.createInterface({
+            input: process.stdin,
+            output: process.stderr,
+        });
+        rl.question(`${question} (y/N) `, (answer) => {
+            rl.close();
+            resolve(["y", "yes"].includes(answer.trim().toLowerCase()));
+        });
+    });
+}
+/**
+ * Prompt the user to authorize missing scopes interactively.
+ *
+ * 1. Tells the user which scopes are missing.
+ * 2. Reminds them to enable the scopes in the Feishu developer console.
+ * 3. Asks whether to run the OAuth flow now.
+ *
+ * Returns `true` if authorization succeeded, `false` otherwise.
+ * Always returns `false` in non-interactive contexts (JSON mode, non-TTY).
+ */
+export async function promptScopeAuth(missingScopes, globalOpts) {
+    // Non-interactive: skip prompt
+    if (globalOpts.json || !process.stdin.isTTY) {
+        return false;
+    }
+    const appId = process.env.FEISHU_APP_ID;
+    const appSecret = process.env.FEISHU_APP_SECRET;
+    if (!appId || !appSecret)
+        return false;
+    // Skip interactive OAuth when using env-var token — re-auth would save to file
+    // but createClient still prefers the env token, so retry would fail again.
+    if (process.env.FEISHU_USER_TOKEN)
+        return false;
+    const scopeList = missingScopes.join(", ");
+    const scopeStr = missingScopes.join(" ");
+    process.stderr.write(`\nfeishu-docs: 缺少以下权限: ${scopeList}\n` +
+        `请先确认已在飞书开发者后台 (https://open.feishu.cn/app) 为应用开通了对应的 API 权限。\n` +
+        `开通后，需要通过 OAuth 授权将权限授予当前用户（用户已授予的权限会累积保留）。\n` +
+        `手动授权命令: feishu-docs authorize --scope "${scopeStr}"\n\n`);
+    const yes = await askYesNo("是否现在申请授予权限?");
+    if (!yes)
+        return false;
+    // Merge missing scopes with current grants and re-run OAuth
+    const stored = await loadTokens();
+    const currentScopes = stored?.tokens?.scope
+        ? stored.tokens.scope.split(/\s+/).filter(Boolean)
+        : [...BASE_SCOPES];
+    const merged = mergeScopes(currentScopes, missingScopes);
+    try {
+        await oauthLogin(appId, {
+            scope: merged.join(" "),
+            appSecret,
+            useLark: globalOpts.lark,
+        });
+        process.stderr.write("feishu-docs: 授权成功！\n\n");
+        return true;
+    }
+    catch (err) {
+        const detail = err instanceof Error ? err.message : String(err);
+        process.stderr.write(`feishu-docs: 授权失败: ${detail}\n\n`);
+        return false;
+    }
+}
+/**
+ * Wrap an async operation with reactive scope error recovery.
+ *
+ * When the operation throws `CliError("SCOPE_MISSING")`:
+ * - If interactive (TTY + non-JSON) and scopes are known: prompt → retry once.
+ * - Otherwise: re-throw with a clear recovery hint.
+ *
+ * @param fallbackScopes  Scope names to use when the API doesn't include
+ *   `permission_violations` (older APIs like search). When the error has
+ *   empty `missingScopes` but `fallbackScopes` is provided, these are used
+ *   for the authorization prompt.
+ */
+export async function withScopeRecovery(fn, globalOpts, fallbackScopes) {
+    try {
+        return await fn();
+    }
+    catch (err) {
+        if (!(err instanceof CliError) || err.errorType !== "SCOPE_MISSING") {
+            throw err;
+        }
+        const apiScopes = err.missingScopes ?? [];
+        const scopes = apiScopes.length > 0 ? apiScopes : (fallbackScopes ?? []);
+        // No scopes from API or fallback → can't prompt meaningfully, just throw
+        if (scopes.length === 0) {
+            throw err;
+        }
+        // Tenant mode: OAuth produces a user token which tenant auth ignores,
+        // so interactive recovery would be pointless — just throw with a hint.
+        if (globalOpts.auth === "tenant") {
+            throw new CliError("AUTH_REQUIRED", buildScopeHint(scopes), {
+                apiCode: err.apiCode,
+                missingScopes: scopes,
+            });
+        }
+        // Try interactive recovery
+        const authorized = await promptScopeAuth(scopes, globalOpts);
+        if (!authorized) {
+            throw new CliError("AUTH_REQUIRED", buildScopeHint(scopes), {
+                apiCode: err.apiCode,
+                missingScopes: scopes,
+            });
+        }
+        // Retry once — if it fails again, let the error propagate
+        return await fn();
+    }
+}
+//# sourceMappingURL=scope-prompt.js.map

package/dist/utils/scope-prompt.js.map

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

package/dist/utils/url-parser.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Parse Feishu/Lark URL or raw token into { type, token }.
+ */
+import { ParsedDoc } from "../types/index.js";
+export declare function parseDocUrl(input: unknown): ParsedDoc;

package/dist/utils/url-parser.js

@@ -0,0 +1,55 @@
+/**
+ * Parse Feishu/Lark URL or raw token into { type, token }.
+ */
+import { CliError } from "./errors.js";
+const FEISHU_DOMAINS = /(?:^|\.)(feishu\.cn|larksuite\.com|larkoffice\.com)$/;
+const PATH_PATTERNS = [
+    { pattern: /^\/wiki\/([A-Za-z0-9]+)/, type: "wiki" },
+    { pattern: /^\/docx\/([A-Za-z0-9]+)/, type: "docx" },
+    { pattern: /^\/doc\/([A-Za-z0-9]+)/, type: "doc" },
+    { pattern: /^\/sheets\/([A-Za-z0-9]+)/, type: "sheet" },
+    { pattern: /^\/base\/([A-Za-z0-9]+)/, type: "bitable" },
+];
+const RAW_TOKEN_RE = /^[A-Za-z][A-Za-z0-9]{19,}$/;
+export function parseDocUrl(input) {
+    if (!input) {
+        throw new CliError("INVALID_ARGS", "缺少文档 URL 或 token", {
+            recovery: "请提供飞书文档 URL 或 token",
+        });
+    }
+    const trimmed = input.trim();
+    // Try as URL
+    if (trimmed.startsWith("http://") || trimmed.startsWith("https://")) {
+        let url;
+        try {
+            url = new URL(trimmed);
+        }
+        catch {
+            throw new CliError("INVALID_ARGS", `无效的 URL: ${trimmed}`, {
+                recovery: "请提供有效的飞书文档 URL",
+            });
+        }
+        if (!FEISHU_DOMAINS.test(url.hostname)) {
+            throw new CliError("INVALID_ARGS", "不支持的域名，请使用飞书/Lark URL", {
+                recovery: "支持的域名: feishu.cn, larksuite.com, larkoffice.com",
+            });
+        }
+        for (const { pattern, type } of PATH_PATTERNS) {
+            const match = url.pathname.match(pattern);
+            if (match) {
+                const token = match[1];
+                if (!token) {
+                    throw new CliError("INVALID_ARGS", "URL 中缺少文档 token");
+                }
+                return { type, token };
+            }
+        }
+        throw new CliError("INVALID_ARGS", `无法识别的 URL 路径: ${url.pathname}`, { recovery: "支持的路径: /wiki/, /docx/, /doc/, /sheets/, /base/" });
+    }
+    // Try as raw token
+    if (RAW_TOKEN_RE.test(trimmed)) {
+        return { type: "unknown", token: trimmed };
+    }
+    throw new CliError("INVALID_ARGS", `无法识别的输入: ${trimmed}。请输入飞书 URL 或文档 token`, { recovery: "请提供飞书文档 URL 或至少 20 位的文档 token" });
+}
+//# sourceMappingURL=url-parser.js.map

package/dist/utils/url-parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"url-parser.js","sourceRoot":"","sources":["../../src/utils/url-parser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,cAAc,GAAG,sDAAsD,CAAC;AAE9E,MAAM,aAAa,GAA8C;IAC/D,EAAE,OAAO,EAAE,yBAAyB,EAAE,IAAI,EAAE,MAAM,EAAE;IACpD,EAAE,OAAO,EAAE,yBAAyB,EAAE,IAAI,EAAE,MAAM,EAAE;IACpD,EAAE,OAAO,EAAE,wBAAwB,EAAE,IAAI,EAAE,KAAK,EAAE;IAClD,EAAE,OAAO,EAAE,2BAA2B,EAAE,IAAI,EAAE,OAAO,EAAE;IACvD,EAAE,OAAO,EAAE,yBAAyB,EAAE,IAAI,EAAE,SAAS,EAAE;CACxD,CAAC;AAEF,MAAM,YAAY,GAAG,4BAA4B,CAAC;AAElD,MAAM,UAAU,WAAW,CAAC,KAAc;IACxC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,kBAAkB,EAAE;YACrD,QAAQ,EAAE,qBAAqB;SAChC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,OAAO,GAAI,KAAgB,CAAC,IAAI,EAAE,CAAC;IAEzC,aAAa;IACb,IAAI,OAAO,CAAC,UAAU,CAAC,SAAS,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QACpE,IAAI,GAAQ,CAAC;QACb,IAAI,CAAC;YACH,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,YAAY,OAAO,EAAE,EAAE;gBACxD,QAAQ,EAAE,gBAAgB;aAC3B,CAAC,CAAC;QACL,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YACvC,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,uBAAuB,EAAE;gBAC1D,QAAQ,EAAE,iDAAiD;aAC5D,CAAC,CAAC;QACL,CAAC;QAED,KAAK,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,aAAa,EAAE,CAAC;YAC9C,MAAM,KAAK,GAAG,GAAG,CAAC,QAAQ,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC1C,IAAI,KAAK,EAAE,CAAC;gBACV,MAAM,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;gBACvB,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,iBAAiB,CAAC,CAAC;gBACxD,CAAC;gBACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;YACzB,CAAC;QACH,CAAC;QAED,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,iBAAiB,GAAG,CAAC,QAAQ,EAAE,EAC/B,EAAE,QAAQ,EAAE,gDAAgD,EAAE,CAC/D,CAAC;IACJ,CAAC;IAED,mBAAmB;IACnB,IAAI,YAAY,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/B,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC7C,CAAC;IAED,MAAM,IAAI,QAAQ,CAChB,cAAc,EACd,YAAY,OAAO,sBAAsB,EACzC,EAAE,QAAQ,EAAE,+BAA+B,EAAE,CAC9C,CAAC;AACJ,CAAC"}

package/dist/utils/validate.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Input validation utilities for API path parameters.
+ */
+/**
+ * Validate a space_id or token before interpolating into URL paths.
+ * Prevents path traversal via malformed IDs.
+ */
+export declare function validateToken(value: unknown, label?: string): void;

package/dist/utils/validate.js

@@ -0,0 +1,15 @@
+/**
+ * Input validation utilities for API path parameters.
+ */
+import { CliError } from "./errors.js";
+const TOKEN_RE = /^[A-Za-z0-9_\-]{1,100}$/;
+/**
+ * Validate a space_id or token before interpolating into URL paths.
+ * Prevents path traversal via malformed IDs.
+ */
+export function validateToken(value, label = "token") {
+    if (!value || !TOKEN_RE.test(value)) {
+        throw new CliError("INVALID_ARGS", `无效的 ${label} 格式: ${value}`);
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/utils/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../../src/utils/validate.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,MAAM,QAAQ,GAAG,yBAAyB,CAAC;AAE3C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc,EAAE,QAAgB,OAAO;IACnE,IAAI,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAe,CAAC,EAAE,CAAC;QAC9C,MAAM,IAAI,QAAQ,CAAC,cAAc,EAAE,OAAO,KAAK,QAAQ,KAAK,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC"}

package/dist/utils/version.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Version display and update check utilities.
+ */
+/**
+ * Read the local package version from package.json.
+ */
+export declare function getLocalVersion(): string;
+/**
+ * Check for updates and print a notice if a newer version is available.
+ * This is non-blocking and never throws — update check failures are silent.
+ */
+export declare function checkForUpdates(): Promise<void>;

package/dist/utils/version.js

@@ -0,0 +1,128 @@
+/**
+ * Version display and update check utilities.
+ */
+import { readFile, writeFile, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { homedir } from "node:os";
+import { createRequire } from "node:module";
+const PACKAGE_NAME = "feishu-docs-cli";
+const CONFIG_DIR = join(homedir(), ".feishu-docs");
+const UPDATE_CHECK_FILE = join(CONFIG_DIR, ".update-check.json");
+const CHECK_INTERVAL_MS = 24 * 60 * 60 * 1000; // 24 hours
+/**
+ * Read the local package version from package.json.
+ */
+export function getLocalVersion() {
+    const require = createRequire(import.meta.url);
+    const pkg = require("../../package.json");
+    return pkg.version;
+}
+/**
+ * Fetch the latest version from npm registry.
+ */
+async function fetchLatestVersion() {
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 5_000);
+    try {
+        const res = await fetch(`https://registry.npmjs.org/${PACKAGE_NAME}/latest`, { signal: controller.signal });
+        if (!res.ok)
+            return null;
+        const data = (await res.json());
+        return data.version || null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timeoutId);
+    }
+}
+/**
+ * Load the update check state from disk.
+ */
+async function loadCheckState() {
+    try {
+        const raw = await readFile(UPDATE_CHECK_FILE, "utf-8");
+        return JSON.parse(raw);
+    }
+    catch {
+        return { lastCheck: 0 };
+    }
+}
+/**
+ * Save the update check state to disk.
+ */
+async function saveCheckState(state) {
+    await mkdir(CONFIG_DIR, { recursive: true });
+    await writeFile(UPDATE_CHECK_FILE, JSON.stringify(state));
+}
+/**
+ * Compare two semver strings. Returns:
+ *  1 if a > b, -1 if a < b, 0 if equal.
+ */
+function compareSemver(a, b) {
+    const pa = a.replace(/^v/, "").split(/[-.]/).map((s) => {
+        const n = Number(s);
+        return isNaN(n) ? s : n;
+    });
+    const pb = b.replace(/^v/, "").split(/[-.]/).map((s) => {
+        const n = Number(s);
+        return isNaN(n) ? s : n;
+    });
+    const len = Math.max(pa.length, pb.length);
+    for (let i = 0; i < len; i++) {
+        const va = pa[i] ?? 0;
+        const vb = pb[i] ?? 0;
+        // A pre-release tag (string) is less than a release (number absent)
+        if (typeof va === "string" && typeof vb === "number")
+            return -1;
+        if (typeof va === "number" && typeof vb === "string")
+            return 1;
+        if (va < vb)
+            return -1;
+        if (va > vb)
+            return 1;
+    }
+    return 0;
+}
+/**
+ * Check for updates and print a notice if a newer version is available.
+ * This is non-blocking and never throws — update check failures are silent.
+ */
+export async function checkForUpdates() {
+    try {
+        const state = await loadCheckState();
+        const now = Date.now();
+        // Skip if checked recently
+        if (now - state.lastCheck < CHECK_INTERVAL_MS) {
+            // Still show cached notice if a newer version was found last time
+            if (state.latestVersion) {
+                const local = getLocalVersion();
+                if (compareSemver(state.latestVersion, local) > 0) {
+                    printUpdateNotice(local, state.latestVersion);
+                }
+            }
+            return;
+        }
+        // Fetch latest version from npm (with timeout)
+        const latest = await fetchLatestVersion();
+        const newState = {
+            lastCheck: now,
+            latestVersion: latest || undefined,
+        };
+        await saveCheckState(newState);
+        if (latest) {
+            const local = getLocalVersion();
+            if (compareSemver(latest, local) > 0) {
+                printUpdateNotice(local, latest);
+            }
+        }
+    }
+    catch {
+        // Never block CLI usage due to update check failure
+    }
+}
+function printUpdateNotice(current, latest) {
+    process.stderr.write(`feishu-docs: 发现新版本 ${latest}（当前 ${current}），运行 npm update -g ${PACKAGE_NAME} 更新\n`);
+}
+//# sourceMappingURL=version.js.map

package/dist/utils/version.js.map

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

package/package.json

@@ -0,0 +1,53 @@
+{
+  "name": "feishu-docs-cli",
+  "version": "0.1.0-beta.10",
+  "description": "CLI tool for AI Agents to read/write Feishu docs via shell commands",
+  "type": "module",
+  "bin": {
+    "feishu-docs": "./bin/feishu-docs.js"
+  },
+  "main": "./dist/cli.js",
+  "types": "./dist/cli.d.ts",
+  "files": [
+    "bin/",
+    "dist/",
+    "skills/",
+    "README.md",
+    "README.zh.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "build:check": "tsc --noEmit",
+    "pretest": "npm run build:check",
+    "test": "tsx --test test/*.test.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/cliff-byte/feishu-docs-cli.git"
+  },
+  "keywords": [
+    "feishu",
+    "lark",
+    "cli",
+    "docs",
+    "ai-agent",
+    "claude",
+    "codex"
+  ],
+  "author": "cliff-byte",
+  "license": "MIT",
+  "bugs": {
+    "url": "https://github.com/cliff-byte/feishu-docs-cli/issues"
+  },
+  "homepage": "https://github.com/cliff-byte/feishu-docs-cli#readme",
+  "engines": {
+    "node": ">=18.3.0"
+  },
+  "devDependencies": {
+    "@types/node": "^25.5.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.9.3"
+  }
+}