feishu-docs-cli 0.1.0-beta.10

package/dist/services/markdown-convert.js

@@ -0,0 +1,217 @@
+/**
+ * Convert Markdown to Feishu blocks via server-side Convert API,
+ * then write to document via Descendant API.
+ *
+ * This replaces the local md-to-blocks parser + multi-step block-writer
+ * table assembly with just 2 API calls:
+ *   1. Convert API: Markdown string -> block tree (server-side parsing)
+ *   2. Descendant API: Write entire block tree in one call (no 9-row table limit)
+ *
+ * Notes:
+ *   - Descendant API accepts at most 1000 blocks per call; large content is
+ *     automatically split into batches at top-level block boundaries.
+ *   - Read-only fields returned by Convert API (parent_id, comment_ids,
+ *     merge_info) are stripped before writing to avoid validation errors.
+ */
+import { fetchWithAuth } from "../client.js";
+import { CliError } from "../utils/errors.js";
+/** Maximum blocks the Descendant API accepts per call. */
+const MAX_BLOCKS_PER_CALL = 1000;
+/**
+ * Language aliases that Feishu Convert API does not recognize.
+ * Maps unrecognized names → recognized names so code blocks render correctly.
+ */
+const LANG_ALIASES = {
+    "objective-c": "objc",
+    "obj-c": "objc",
+};
+/**
+ * Normalize code-fence language names in markdown before sending to Convert API.
+ * Replaces unrecognized aliases with their recognized equivalents.
+ */
+export function normalizeLangNames(markdown) {
+    return markdown.replace(/^(```)([\w+#.-]+)/gm, (match, fence, lang) => {
+        const alias = LANG_ALIASES[lang.toLowerCase()];
+        return alias ? fence + alias : match;
+    });
+}
+/**
+ * Convert markdown string to Feishu block array via Convert API.
+ * Requires scope: docx:document.block:convert
+ *
+ * @returns {{ blocks: Array, firstLevelBlockIds: string[], blockIdToImageUrls: Object }}
+ */
+export async function convertMarkdown(authInfo, markdown) {
+    const res = await fetchWithAuth(authInfo, "/open-apis/docx/v1/documents/blocks/convert", {
+        method: "POST",
+        body: { content: normalizeLangNames(markdown), content_type: "markdown" },
+    });
+    const data = res?.data;
+    if (!data?.blocks || !data?.first_level_block_ids) {
+        throw new CliError("API_ERROR", "Convert API 返回数据格式不正确");
+    }
+    return {
+        blocks: data.blocks,
+        firstLevelBlockIds: data.first_level_block_ids,
+        blockIdToImageUrls: data.block_id_to_image_urls || {},
+    };
+}
+/**
+ * Read-only / server-generated fields that the Descendant API rejects.
+ * These are returned by the Convert API but must not be sent back.
+ */
+const READ_ONLY_BLOCK_FIELDS = ["parent_id", "comment_ids"];
+/**
+ * Sanitize blocks for the Descendant API by removing read-only fields.
+ *
+ * Strips:
+ *  - top-level read-only fields: parent_id, comment_ids
+ *  - table.property.merge_info (read-only attribute)
+ *
+ * Returns a new array (immutable).
+ */
+export function sanitizeBlocks(blocks) {
+    return blocks.map((block) => {
+        let cleaned = block;
+        // Strip top-level read-only fields
+        for (const field of READ_ONLY_BLOCK_FIELDS) {
+            if (field in cleaned) {
+                const { [field]: _, ...rest } = cleaned;
+                cleaned = rest;
+            }
+        }
+        // Strip table.property.merge_info
+        if (cleaned.table?.property?.merge_info) {
+            const { merge_info, ...restProperty } = cleaned.table.property;
+            cleaned = {
+                ...cleaned,
+                table: { ...cleaned.table, property: restProperty },
+            };
+        }
+        return cleaned;
+    });
+}
+/**
+ * Collect all descendant block IDs reachable from a set of top-level IDs.
+ * Traverses the children tree in the block array.
+ */
+function collectDescendantIds(topLevelIds, blockMap) {
+    const ids = new Set();
+    const queue = [...topLevelIds];
+    while (queue.length > 0) {
+        const id = queue.pop();
+        if (ids.has(id))
+            continue;
+        ids.add(id);
+        const block = blockMap.get(id);
+        if (block?.children) {
+            queue.push(...block.children);
+        }
+    }
+    return ids;
+}
+/**
+ * Build a ConvertedBlocks batch from a subset of blocks.
+ * Filters blockIdToImageUrls to only include entries for blocks in this batch.
+ */
+function buildBatch(topIds, blockIds, allBlocks, source) {
+    const imageUrls = Object.fromEntries(Object.entries(source.blockIdToImageUrls).filter(([id]) => blockIds.has(id)));
+    return {
+        firstLevelBlockIds: topIds,
+        blocks: allBlocks.filter((b) => blockIds.has(b.block_id)),
+        blockIdToImageUrls: imageUrls,
+    };
+}
+/**
+ * Split converted blocks into batches that each stay within
+ * MAX_BLOCKS_PER_CALL. Splits at top-level block boundaries so
+ * parent–child relationships are preserved within each batch.
+ */
+export function splitIntoBatches(converted) {
+    const allBlocks = sanitizeBlocks(converted.blocks);
+    if (allBlocks.length <= MAX_BLOCKS_PER_CALL) {
+        return [{ ...converted, blocks: allBlocks }];
+    }
+    const blockMap = new Map(allBlocks.map((b) => [b.block_id, b]));
+    const batches = [];
+    let batchTopIds = [];
+    let batchBlockCount = 0;
+    for (const topId of converted.firstLevelBlockIds) {
+        const descendantIds = collectDescendantIds([topId], blockMap);
+        const subtreeSize = descendantIds.size;
+        // A single top-level subtree that exceeds the limit cannot be split further
+        if (subtreeSize > MAX_BLOCKS_PER_CALL) {
+            throw new CliError("API_ERROR", `单个顶层块的后代数量 (${subtreeSize}) 超过 Descendant API 限制 (${MAX_BLOCKS_PER_CALL})，无法拆分`);
+        }
+        // If adding this top-level block would exceed the limit, flush current batch
+        if (batchBlockCount > 0 &&
+            batchBlockCount + subtreeSize > MAX_BLOCKS_PER_CALL) {
+            const batchIds = collectDescendantIds(batchTopIds, blockMap);
+            batches.push(buildBatch(batchTopIds, batchIds, allBlocks, converted));
+            batchTopIds = [];
+            batchBlockCount = 0;
+        }
+        batchTopIds.push(topId);
+        batchBlockCount += subtreeSize;
+    }
+    // Flush remaining
+    if (batchTopIds.length > 0) {
+        const batchIds = collectDescendantIds(batchTopIds, blockMap);
+        batches.push(buildBatch(batchTopIds, batchIds, allBlocks, converted));
+    }
+    return batches;
+}
+/**
+ * Write blocks to document via Descendant API.
+ * Automatically batches when block count exceeds 1000.
+ *
+ * @param {object} authInfo - Auth credentials
+ * @param {string} documentId - Target document ID
+ * @param {string} parentBlockId - Parent block (usually same as documentId for top-level)
+ * @param {object} converted - Output from convertMarkdown()
+ * @param {number} revisionId - Document revision ID
+ * @param {number} index - Insert position (0 = beginning, -1 = append to end)
+ * @returns {number} Updated revision ID
+ */
+export async function writeDescendant(authInfo, documentId, parentBlockId, converted, revisionId, index = 0) {
+    const batches = splitIntoBatches(converted);
+    if (batches.length > 1) {
+        process.stderr.write(`feishu-docs: info: 内容较大 (${converted.blocks.length} blocks)，分 ${batches.length} 批写入\n`);
+    }
+    let rev = revisionId;
+    for (let i = 0; i < batches.length; i++) {
+        const batch = batches[i];
+        // First batch uses caller-specified index; subsequent batches append
+        const batchIndex = i === 0 ? index : -1;
+        const res = await fetchWithAuth(authInfo, `/open-apis/docx/v1/documents/${encodeURIComponent(documentId)}/blocks/${encodeURIComponent(parentBlockId)}/descendant`, {
+            method: "POST",
+            body: {
+                children_id: batch.firstLevelBlockIds,
+                descendants: batch.blocks,
+                index: batchIndex,
+            },
+            params: {
+                document_revision_id: rev,
+            },
+        });
+        rev =
+            res?.data
+                ?.document_revision_id ?? rev;
+    }
+    return rev;
+}
+/**
+ * High-level: Convert markdown and write to document in 2 API calls.
+ *
+ * @param {object} authInfo - Auth credentials
+ * @param {string} documentId - Target document ID
+ * @param {string} markdown - Raw Markdown content
+ * @param {number} revisionId - Current document revision ID
+ * @param {number} index - Insert position (0 = beginning, -1 = append)
+ * @returns {number} Updated revision ID
+ */
+export async function convertAndWrite(authInfo, documentId, markdown, revisionId, index = 0) {
+    const converted = await convertMarkdown(authInfo, markdown);
+    return writeDescendant(authInfo, documentId, documentId, converted, revisionId, index);
+}
+//# sourceMappingURL=markdown-convert.js.map

package/dist/services/markdown-convert.js.map

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

package/dist/services/wiki-nodes.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Shared wiki node helpers.
+ */
+import { AuthInfo, WikiNode } from "../types/index.js";
+export interface ResolvedWikiNode {
+    objToken: string;
+    objType: string;
+    title: string;
+    nodeToken: string;
+    spaceId: string;
+    hasChild: boolean;
+}
+/**
+ * Fetch child nodes of a parent node (or space root).
+ */
+export declare function fetchChildren(authInfo: AuthInfo, spaceId: string, parentNodeToken?: string): Promise<WikiNode[]>;
+/**
+ * Resolve wiki token to actual document token + type.
+ */
+export declare function resolveWikiToken(authInfo: AuthInfo, wikiToken: string): Promise<ResolvedWikiNode>;

package/dist/services/wiki-nodes.js

@@ -0,0 +1,46 @@
+/**
+ * Shared wiki node helpers.
+ */
+import { fetchWithAuth } from "../client.js";
+import { CliError } from "../utils/errors.js";
+/**
+ * Fetch child nodes of a parent node (or space root).
+ */
+export async function fetchChildren(authInfo, spaceId, parentNodeToken) {
+    const nodes = [];
+    let pageToken;
+    do {
+        const params = {
+            page_size: 50,
+            ...(pageToken && { page_token: pageToken }),
+            ...(parentNodeToken && { parent_node_token: parentNodeToken }),
+        };
+        const res = await fetchWithAuth(authInfo, `/open-apis/wiki/v2/spaces/${encodeURIComponent(spaceId)}/nodes`, { params });
+        const data = res?.data;
+        if (data?.items) {
+            nodes.push(...data.items);
+        }
+        pageToken = data?.has_more ? data.page_token : undefined;
+    } while (pageToken);
+    return nodes;
+}
+/**
+ * Resolve wiki token to actual document token + type.
+ */
+export async function resolveWikiToken(authInfo, wikiToken) {
+    const res = await fetchWithAuth(authInfo, "/open-apis/wiki/v2/spaces/get_node", { params: { token: wikiToken, obj_type: "wiki" } });
+    const data = res?.data;
+    const node = data?.node;
+    if (!node) {
+        throw new CliError("NOT_FOUND", `知识库节点不存在: ${wikiToken}`);
+    }
+    return {
+        objToken: node.obj_token ?? "",
+        objType: node.obj_type ?? "",
+        title: node.title ?? "",
+        nodeToken: node.node_token ?? "",
+        spaceId: node.space_id ?? "",
+        hasChild: node.has_child || false,
+    };
+}
+//# sourceMappingURL=wiki-nodes.js.map

package/dist/services/wiki-nodes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wiki-nodes.js","sourceRoot":"","sources":["../../src/services/wiki-nodes.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,oBAAoB,CAAC;AAY9C;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,aAAa,CACjC,QAAkB,EAClB,OAAe,EACf,eAAwB;IAExB,MAAM,KAAK,GAAe,EAAE,CAAC;IAC7B,IAAI,SAA6B,CAAC;IAElC,GAAG,CAAC;QACF,MAAM,MAAM,GAAgD;YAC1D,SAAS,EAAE,EAAE;YACb,GAAG,CAAC,SAAS,IAAI,EAAE,UAAU,EAAE,SAAS,EAAE,CAAC;YAC3C,GAAG,CAAC,eAAe,IAAI,EAAE,iBAAiB,EAAE,eAAe,EAAE,CAAC;SAC/D,CAAC;QAEF,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,QAAQ,EACR,6BAA6B,kBAAkB,CAAC,OAAO,CAAC,QAAQ,EAChE,EAAE,MAAM,EAAE,CACX,CAAC;QAEF,MAAM,IAAI,GAAG,GAAG,EAAE,IAA2C,CAAC;QAC9D,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,KAAK,CAAC,IAAI,CAAC,GAAI,IAAI,CAAC,KAAoB,CAAC,CAAC;QAC5C,CAAC;QACD,SAAS,GAAG,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAE,IAAI,CAAC,UAAqB,CAAC,CAAC,CAAC,SAAS,CAAC;IACvE,CAAC,QAAQ,SAAS,EAAE;IAEpB,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,QAAkB,EAClB,SAAiB;IAEjB,MAAM,GAAG,GAAG,MAAM,aAAa,CAC7B,QAAQ,EACR,oCAAoC,EACpC,EAAE,MAAM,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,CACnD,CAAC;IAEF,MAAM,IAAI,GAAG,GAAG,EAAE,IAA2C,CAAC;IAC9D,MAAM,IAAI,GAAG,IAAI,EAAE,IAA2C,CAAC;IAC/D,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,QAAQ,CAAC,WAAW,EAAE,aAAa,SAAS,EAAE,CAAC,CAAC;IAC5D,CAAC;IAED,OAAO;QACL,QAAQ,EAAG,IAAI,CAAC,SAAoB,IAAI,EAAE;QAC1C,OAAO,EAAG,IAAI,CAAC,QAAmB,IAAI,EAAE;QACxC,KAAK,EAAG,IAAI,CAAC,KAAgB,IAAI,EAAE;QACnC,SAAS,EAAG,IAAI,CAAC,UAAqB,IAAI,EAAE;QAC5C,OAAO,EAAG,IAAI,CAAC,QAAmB,IAAI,EAAE;QACxC,QAAQ,EAAG,IAAI,CAAC,SAAqB,IAAI,KAAK;KAC/C,CAAC;AACJ,CAAC"}

package/dist/types/index.d.ts

@@ -0,0 +1,236 @@
+/**
+ * Shared type definitions for feishu-docs CLI.
+ */
+export type ErrorType = "INVALID_ARGS" | "FILE_NOT_FOUND" | "AUTH_REQUIRED" | "TOKEN_EXPIRED" | "PERMISSION_DENIED" | "SCOPE_MISSING" | "NOT_FOUND" | "NOT_SUPPORTED" | "RATE_LIMITED" | "API_ERROR";
+export interface CliErrorOptions {
+    apiCode?: number;
+    retryable?: boolean;
+    recovery?: string;
+    /** Scope names extracted from API permission_violations (for SCOPE_MISSING errors). */
+    missingScopes?: 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,26 @@
+/**
+ * Unified URL/token → document resolution.
+ * Extracts the repeated resolve logic from read.js, write.js, delete.js.
+ */
+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} 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(authInfo: AuthInfo, input: string, options?: {
+    allowFallback?: boolean;
+}): Promise<ResolvedDocument>;

package/dist/utils/document-resolver.js

@@ -0,0 +1,46 @@
+/**
+ * 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} 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(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(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;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAC;AAC9C,OAAO,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAa7D;;;;;;;;GAQG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,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,QAAQ,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5D,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,23 @@
+/**
+ * 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;
+    /** Scope names from API permission_violations (only for SCOPE_MISSING). */
+    missingScopes?: string[];
+    constructor(type: ErrorType, message: string, { apiCode, retryable, recovery, missingScopes, }?: 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;