feishu-docs-cli 0.1.0-beta.2

package/dist/types/index.d.ts

@@ -0,0 +1,234 @@
+/**
+ * Shared type definitions for feishu-docs CLI.
+ */
+export type ErrorType = "INVALID_ARGS" | "FILE_NOT_FOUND" | "AUTH_REQUIRED" | "TOKEN_EXPIRED" | "PERMISSION_DENIED" | "NOT_FOUND" | "NOT_SUPPORTED" | "RATE_LIMITED" | "API_ERROR";
+export interface CliErrorOptions {
+    apiCode?: number;
+    retryable?: boolean;
+    recovery?: string;
+}
+export type AuthMode = "user" | "tenant" | "auto";
+export interface AuthInfo {
+    mode: AuthMode;
+    appId?: string;
+    appSecret?: string;
+    userToken?: string;
+    tenantToken?: string;
+    expiresAt?: number;
+    refreshToken?: string;
+    useLark: boolean;
+}
+export interface TokenData {
+    user_access_token: string;
+    refresh_token: string;
+    expires_at: number;
+    token_type?: string;
+}
+export interface GlobalOpts {
+    auth: string;
+    json: boolean;
+    lark: boolean;
+}
+export interface CommandArgs {
+    positionals?: string[];
+    [key: string]: unknown;
+}
+export type CommandHandler = (args: CommandArgs, globalOpts: GlobalOpts) => Promise<void>;
+export interface OptionDef {
+    type: "string" | "boolean";
+    default?: string | boolean;
+}
+export interface CommandMeta {
+    options: Record<string, OptionDef>;
+    positionals?: boolean;
+    handler: CommandHandler;
+}
+export interface SubcommandMeta {
+    subcommands: Record<string, CommandMeta>;
+}
+export type DocType = "wiki" | "docx" | "doc" | "sheet" | "bitable" | "unknown";
+export interface ParsedDoc {
+    type: DocType;
+    token: string;
+}
+export interface DocumentInfo {
+    documentId: string;
+    objToken: string;
+    objType: string;
+    title: string;
+    url?: string;
+    revisionId?: number;
+    nodeToken?: string;
+    spaceId?: string;
+}
+export interface ApiResponse<T = unknown> {
+    code?: number;
+    msg?: string;
+    data?: T;
+}
+export interface FetchOptions {
+    method?: string;
+    params?: Record<string, string | number | string[] | undefined>;
+    body?: unknown;
+    headers?: Record<string, string>;
+}
+export interface TextElement {
+    text_run?: {
+        content: string;
+        text_element_style?: TextElementStyle;
+    };
+    mention_user?: {
+        user_id: string;
+        text_element_style?: TextElementStyle;
+    };
+    mention_doc?: {
+        token: string;
+        obj_type: number;
+        url: string;
+        title?: string;
+        text_element_style?: TextElementStyle;
+    };
+    equation?: {
+        content: string;
+        text_element_style?: TextElementStyle;
+    };
+    file?: {
+        file_token: string;
+        text_element_style?: TextElementStyle;
+    };
+    reminder?: {
+        timestamp: string;
+    };
+    undefined?: Record<string, unknown>;
+}
+export interface TextElementStyle {
+    bold?: boolean;
+    italic?: boolean;
+    strikethrough?: boolean;
+    underline?: boolean;
+    inline_code?: boolean;
+    link?: {
+        url: string;
+    };
+    text_color?: number;
+    background_color?: number;
+}
+export interface BlockText {
+    elements: TextElement[];
+    style?: {
+        align?: number;
+        done?: boolean;
+        language?: number;
+        wrap?: boolean;
+        folded?: boolean;
+    };
+}
+export interface Block {
+    block_id: string;
+    block_type: number;
+    parent_id?: string;
+    children?: string[];
+    text?: BlockText;
+    heading1?: BlockText;
+    heading2?: BlockText;
+    heading3?: BlockText;
+    heading4?: BlockText;
+    heading5?: BlockText;
+    heading6?: BlockText;
+    heading7?: BlockText;
+    heading8?: BlockText;
+    heading9?: BlockText;
+    bullet?: BlockText;
+    ordered?: BlockText;
+    code?: BlockText;
+    quote?: BlockText;
+    equation?: BlockText;
+    todo?: BlockText;
+    callout?: {
+        background_color?: number;
+        border_color?: number;
+        emoji_id?: string;
+        body?: BlockText;
+        elements?: TextElement[];
+    };
+    divider?: Record<string, never>;
+    image?: {
+        token: string;
+        width?: number;
+        height?: number;
+        align?: number;
+    };
+    file?: {
+        token: string;
+        name?: string;
+        view_type?: number;
+    };
+    table?: {
+        cells?: string[];
+        property?: {
+            row_size: number;
+            column_size: number;
+            column_width?: number[];
+            header_row?: boolean;
+            merge_info?: unknown[];
+        };
+    };
+    table_cell?: {
+        elements?: TextElement[];
+    };
+    grid?: {
+        column_size: number;
+    };
+    grid_column?: {
+        width_ratio?: number;
+    };
+    iframe?: {
+        component?: {
+            iframe_type?: number;
+            url?: string;
+        };
+    };
+    quote_container?: Record<string, never>;
+    view?: {
+        view_type?: number;
+    };
+    bitable?: {
+        token?: string;
+    };
+    sheet?: {
+        token?: string;
+    };
+    chat_card?: {
+        chat_id?: string;
+    };
+    diagram?: {
+        diagram_type?: number;
+    };
+    task?: {
+        task_id?: string;
+    };
+    [key: string]: unknown;
+}
+export interface WikiNode {
+    space_id: string;
+    node_token: string;
+    obj_token: string;
+    obj_type: string;
+    parent_node_token?: string;
+    title: string;
+    has_child: boolean;
+    node_type?: string;
+    origin_node_token?: string;
+    origin_space_id?: string;
+}
+export interface WikiSpace {
+    space_id: string;
+    name: string;
+    description?: string;
+    visibility?: string;
+}
+export interface ConvertedBlocks {
+    blocks: Block[];
+    firstLevelBlockIds: string[];
+    blockIdToImageUrls: Record<string, string>;
+}

package/dist/types/index.js

@@ -0,0 +1,5 @@
+/**
+ * Shared type definitions for feishu-docs CLI.
+ */
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/utils/document-resolver.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Unified URL/token → document resolution.
+ * Extracts the repeated resolve logic from read.js, write.js, delete.js.
+ */
+import * as lark from "@larksuiteoapi/node-sdk";
+import { AuthInfo, ParsedDoc } from "../types/index.js";
+export interface ResolvedDocument {
+    objToken: string;
+    objType: string;
+    title: string | undefined;
+    nodeToken: string | undefined;
+    spaceId: string | undefined;
+    hasChild: boolean;
+    parsed: ParsedDoc;
+}
+/**
+ * Resolve a URL or raw token to a fully-qualified document descriptor.
+ *
+ * @param {object} client - Lark SDK client
+ * @param {object} authInfo - Auth credentials
+ * @param {string} input - URL or raw token
+ * @param {object} options
+ * @param {boolean} options.allowFallback - If true, unknown types silently fall back to docx (default: true)
+ * @returns {{ objToken, objType, title, nodeToken, spaceId, hasChild, parsed }}
+ */
+export declare function resolveDocument(client: lark.Client, authInfo: AuthInfo, input: string, options?: {
+    allowFallback?: boolean;
+}): Promise<ResolvedDocument>;

package/dist/utils/document-resolver.js

@@ -0,0 +1,47 @@
+/**
+ * Unified URL/token → document resolution.
+ * Extracts the repeated resolve logic from read.js, write.js, delete.js.
+ */
+import { parseDocUrl } from "./url-parser.js";
+import { resolveWikiToken } from "../services/wiki-nodes.js";
+/**
+ * Resolve a URL or raw token to a fully-qualified document descriptor.
+ *
+ * @param {object} client - Lark SDK client
+ * @param {object} authInfo - Auth credentials
+ * @param {string} input - URL or raw token
+ * @param {object} options
+ * @param {boolean} options.allowFallback - If true, unknown types silently fall back to docx (default: true)
+ * @returns {{ objToken, objType, title, nodeToken, spaceId, hasChild, parsed }}
+ */
+export async function resolveDocument(client, authInfo, input, options = {}) {
+    const { allowFallback = true } = options;
+    const parsed = parseDocUrl(input);
+    let objToken = parsed.token;
+    let objType = parsed.type === "unknown" ? "docx" : parsed.type;
+    let title;
+    let nodeToken;
+    let spaceId;
+    let hasChild = false;
+    if (parsed.type === "wiki" || parsed.type === "unknown") {
+        try {
+            const wiki = await resolveWikiToken(client, authInfo, parsed.token);
+            objToken = wiki.objToken;
+            objType = wiki.objType;
+            title = wiki.title;
+            nodeToken = wiki.nodeToken;
+            spaceId = wiki.spaceId;
+            hasChild = wiki.hasChild;
+        }
+        catch (err) {
+            if (parsed.type === "unknown" && allowFallback) {
+                objType = "docx";
+            }
+            else {
+                throw err;
+            }
+        }
+    }
+    return { objToken, objType, title, nodeToken, spaceId, hasChild, parsed };
+}
+//# sourceMappingURL=document-resolver.js.map

package/dist/utils/document-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"document-resolver.js","sourceRoot":"","sources":["../../src/utils/document-resolver.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAa7D;;;;;;;;;GASG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAmB,EACnB,QAAkB,EAClB,KAAa,EACb,UAAuC,EAAE;IAEzC,MAAM,EAAE,aAAa,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACzC,MAAM,MAAM,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC;IAClC,IAAI,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC;IAC5B,IAAI,OAAO,GAAW,MAAM,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC;IACvE,IAAI,KAAyB,CAAC;IAC9B,IAAI,SAA6B,CAAC;IAClC,IAAI,OAA2B,CAAC;IAChC,IAAI,QAAQ,GAAG,KAAK,CAAC;IAErB,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACxD,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YACpE,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;YACzB,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YACvB,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;YACnB,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC;YAC3B,OAAO,GAAG,IAAI,CAAC,OAAO,CAAC;YACvB,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC;QAC3B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,aAAa,EAAE,CAAC;gBAC/C,OAAO,GAAG,MAAM,CAAC;YACnB,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,CAAC;YACZ,CAAC;QACH,CAAC;IACH,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;AAC5E,CAAC"}

package/dist/utils/drive-types.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Map document object type to Feishu Drive API type parameter.
+ */
+export declare function mapToDriveType(objType: string): string;

package/dist/utils/drive-types.js

@@ -0,0 +1,16 @@
+/**
+ * Map document object type to Feishu Drive API type parameter.
+ */
+const DRIVE_TYPE_MAP = {
+    docx: "docx",
+    doc: "doc",
+    sheet: "sheet",
+    bitable: "bitable",
+    mindnote: "mindnote",
+    board: "board",
+    wiki: "wiki",
+};
+export function mapToDriveType(objType) {
+    return DRIVE_TYPE_MAP[objType] || "docx";
+}
+//# sourceMappingURL=drive-types.js.map

package/dist/utils/drive-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"drive-types.js","sourceRoot":"","sources":["../../src/utils/drive-types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,MAAM,cAAc,GAA2B;IAC7C,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,IAAI,EAAE,MAAM;CACb,CAAC;AAEF,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,OAAO,cAAc,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC;AAC3C,CAAC"}

package/dist/utils/errors.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Unified error handling for feishu-docs CLI.
+ *
+ * Exit codes:
+ *   0 - success
+ *   1 - invalid args / file not found
+ *   2 - auth failure
+ *   3 - API error
+ */
+import { ErrorType, CliErrorOptions } from "../types/index.js";
+export declare class CliError extends Error {
+    exitCode: number;
+    errorType: string;
+    apiCode?: number;
+    retryable: boolean;
+    recovery?: string;
+    constructor(type: ErrorType, message: string, { apiCode, retryable, recovery }?: CliErrorOptions);
+}
+export declare function formatError(err: unknown, json?: boolean): string;
+export declare function handleError(err: unknown, json?: boolean): never;
+export declare function mapApiError(err: unknown): CliError;

package/dist/utils/errors.js

@@ -0,0 +1,110 @@
+/**
+ * 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" },
+    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;
+    constructor(type, message, { apiCode, retryable = false, recovery } = {}) {
+        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;
+    }
+}
+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,
+                },
+            });
+        }
+        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 重新认证",
+        });
+    }
+    if (code === 99991672) {
+        return new CliError("RATE_LIMITED", `API 请求频率超限，请稍后重试`, {
+            apiCode: code,
+            retryable: true,
+        });
+    }
+    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":"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"}

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/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"}