feishu-docs-cli 0.1.0-beta.8 → 1.0.0

package/dist/services/doc-enrichment.js

@@ -0,0 +1,397 @@
+/**
+ * Document enrichment service.
+ *
+ * Extracts and resolves embedded content from document blocks:
+ * images, bitable tables, spreadsheets, whiteboards, and @mentions.
+ * All enrichment runs in parallel with a configurable concurrency limit.
+ */
+import { createClient, fetchWithAuth, fetchBinaryWithAuth, getTenantToken, } from "../client.js";
+import { writeFile, mkdir } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import { join } from "node:path";
+import { BlockType } from "../parser/block-types.js";
+import { CliError } from "../utils/errors.js";
+import { withScopeRecovery } from "../utils/scope-prompt.js";
+import { downloadImages } from "./image-download.js";
+import { pLimit } from "../utils/concurrency.js";
+// ── Constants ──
+const TMP_URL_BATCH_SIZE = 5;
+// ── Token extraction helpers (internal) ──
+function extractFileTokens(blocks) {
+    const tokens = [];
+    for (const block of blocks) {
+        if (block.block_type === BlockType.IMAGE && block.image?.token) {
+            tokens.push(block.image.token);
+        }
+        if (block.block_type === BlockType.FILE && block.file?.token) {
+            tokens.push(block.file.token);
+        }
+    }
+    return tokens;
+}
+function extractBitableTokens(blocks) {
+    const tokens = [];
+    for (const block of blocks) {
+        if (block.block_type === BlockType.BITABLE && block.bitable?.token) {
+            tokens.push(block.bitable.token);
+        }
+    }
+    return tokens;
+}
+function extractSheetTokens(blocks) {
+    const tokens = [];
+    for (const block of blocks) {
+        if (block.block_type === BlockType.SHEET && block.sheet?.token) {
+            tokens.push(block.sheet.token);
+        }
+    }
+    return tokens;
+}
+function extractBoardTokens(blocks) {
+    const tokens = [];
+    for (const block of blocks) {
+        if (block.block_type === BlockType.BOARD &&
+            block.board?.token) {
+            tokens.push(block.board.token);
+        }
+    }
+    return tokens;
+}
+function extractMentionUserIds(blocks) {
+    const ids = new Set();
+    for (const block of blocks) {
+        const elementSources = [
+            block.text?.elements,
+            block.heading1?.elements,
+            block.heading2?.elements,
+            block.heading3?.elements,
+            block.heading4?.elements,
+            block.heading5?.elements,
+            block.heading6?.elements,
+            block.heading7?.elements,
+            block.heading8?.elements,
+            block.heading9?.elements,
+            block.bullet?.elements,
+            block.ordered?.elements,
+            block.todo?.elements,
+            block.quote?.elements,
+        ];
+        for (const elements of elementSources) {
+            if (!elements)
+                continue;
+            for (const el of elements) {
+                if (el.mention_user?.user_id) {
+                    ids.add(el.mention_user.user_id);
+                }
+            }
+        }
+    }
+    return [...ids];
+}
+// ── Data fetching functions (exported for testing) ──
+/**
+ * Batch get temporary download URLs for file tokens (images, files).
+ * The API accepts at most 5 file_tokens per request, so larger sets
+ * are split into chunks automatically.
+ */
+async function batchGetTmpUrls(authInfo, fileTokens) {
+    if (fileTokens.length === 0)
+        return new Map();
+    const urlMap = new Map();
+    for (let i = 0; i < fileTokens.length; i += TMP_URL_BATCH_SIZE) {
+        const chunk = fileTokens.slice(i, i + TMP_URL_BATCH_SIZE);
+        const res = await fetchWithAuth(authInfo, "/open-apis/drive/v1/medias/batch_get_tmp_download_url", { params: { file_tokens: chunk } });
+        const data = res?.data;
+        const items = (data?.tmp_download_urls || []);
+        for (const item of items) {
+            urlMap.set(item.file_token, item.tmp_download_url);
+        }
+    }
+    return urlMap;
+}
+/**
+ * Fetch bitable fields and records, return as renderable data.
+ */
+export async function fetchBitableData(authInfo, fullToken) {
+    const idx = fullToken.lastIndexOf("_tbl");
+    if (idx === -1) {
+        process.stderr.write(`feishu-docs: warning: 多维表格 token 格式无法解析: ${fullToken}\n`);
+        return null;
+    }
+    const appToken = fullToken.slice(0, idx);
+    const tableId = fullToken.slice(idx + 1);
+    const [fieldsRes, recordsRes] = await Promise.all([
+        fetchWithAuth(authInfo, `/open-apis/bitable/v1/apps/${encodeURIComponent(appToken)}/tables/${encodeURIComponent(tableId)}/fields`, {}),
+        fetchWithAuth(authInfo, `/open-apis/bitable/v1/apps/${encodeURIComponent(appToken)}/tables/${encodeURIComponent(tableId)}/records`, { params: { page_size: 100 } }),
+    ]);
+    const fieldsData = fieldsRes.data;
+    const recordsData = recordsRes.data;
+    const fields = (fieldsData?.items || []).map((f) => f.field_name);
+    const records = (recordsData?.items || []).map((r) => {
+        return fields.map((name) => {
+            const val = r.fields?.[name];
+            if (val === undefined || val === null)
+                return "";
+            if (typeof val === "object")
+                return JSON.stringify(val);
+            return String(val);
+        });
+    });
+    return { fields, records };
+}
+/**
+ * Fetch sheet metadata and cell values, return as renderable data.
+ */
+export async function fetchSheetData(authInfo, sheetToken) {
+    // Sheet tokens embedded in docs have format: {spreadsheetToken}_{sheetId}
+    // The sheets API needs just the spreadsheet token; sheetId selects the tab.
+    const underscoreIdx = sheetToken.lastIndexOf("_");
+    const spreadsheetToken = underscoreIdx > 0 ? sheetToken.slice(0, underscoreIdx) : sheetToken;
+    const embeddedSheetId = underscoreIdx > 0 ? sheetToken.slice(underscoreIdx + 1) : undefined;
+    const metaRes = await fetchWithAuth(authInfo, `/open-apis/sheets/v2/spreadsheets/${encodeURIComponent(spreadsheetToken)}/metainfo`, {});
+    const metaData = metaRes.data;
+    const sheets = (metaData?.sheets || []);
+    if (sheets.length === 0)
+        return null;
+    // Prefer the embedded sheet id; fall back to first sheet
+    // Note: metainfo API returns camelCase field names (sheetId, not sheet_id)
+    const targetSheet = embeddedSheetId
+        ? sheets.find((s) => s.sheetId === embeddedSheetId) || sheets[0]
+        : sheets[0];
+    const sheetId = targetSheet.sheetId;
+    // Suppress title when it equals sheetId (default meaningless title)
+    const rawTitle = targetSheet.title || "";
+    const title = rawTitle === sheetId ? "" : rawTitle;
+    const valuesRes = await fetchWithAuth(authInfo, `/open-apis/sheets/v2/spreadsheets/${encodeURIComponent(spreadsheetToken)}/values/${encodeURIComponent(sheetId)}`, { params: { valueRenderOption: "ToString" } });
+    const valuesData = valuesRes.data;
+    const rows = (valuesData?.valueRange?.values ||
+        []);
+    if (rows.length === 0)
+        return null;
+    const maxRows = 101; // first row = header + 100 data rows
+    const limitedRows = rows.length > maxRows ? rows.slice(0, maxRows) : rows;
+    const fields = limitedRows[0].map((cell) => String(cell ?? ""));
+    const records = limitedRows
+        .slice(1)
+        .map((row) => fields.map((_, i) => String(row[i] ?? "")));
+    return { fields, records, title, truncated: rows.length > maxRows };
+}
+/**
+ * Download board/whiteboard as image and save to temp file.
+ * Returns the local file path, or null on failure.
+ */
+export async function fetchBoardImage(authInfo, boardToken) {
+    const buf = await fetchBinaryWithAuth(authInfo, `/open-apis/board/v1/whiteboards/${encodeURIComponent(boardToken)}/download_as_image`);
+    if (buf.byteLength === 0)
+        return null;
+    const dir = join(tmpdir(), "feishu-docs");
+    await mkdir(dir, { recursive: true });
+    const filePath = join(dir, `board-${boardToken}.png`);
+    await writeFile(filePath, Buffer.from(buf));
+    return filePath;
+}
+/**
+ * Batch resolve user IDs to display names.
+ * Uses tenant_access_token + contact:user.base:readonly to get name fields.
+ */
+export async function resolveUserNames(authInfo, userIds) {
+    const nameMap = new Map();
+    // Use tenant token for contact API (contact:user.base:readonly is app-identity permission)
+    let tenantToken;
+    try {
+        tenantToken = await getTenantToken(authInfo);
+    }
+    catch {
+        // Fallback: try authen API with user token for current user
+        try {
+            const self = await fetchWithAuth(authInfo, "/open-apis/authen/v1/user_info", {});
+            const selfData = self?.data;
+            if (selfData?.open_id && selfData?.name) {
+                nameMap.set(selfData.open_id, selfData.name);
+            }
+        }
+        catch {
+            // no way to resolve
+        }
+        return nameMap;
+    }
+    // Batch query users (up to 50 per request)
+    const BATCH = 50;
+    for (let i = 0; i < userIds.length; i += BATCH) {
+        const batch = userIds.slice(i, i + BATCH);
+        try {
+            const params = {
+                user_id_type: "open_id",
+                user_ids: batch,
+            };
+            const tenantAuthInfo = {
+                ...authInfo,
+                mode: "tenant",
+                tenantToken,
+            };
+            const res = await fetchWithAuth(tenantAuthInfo, "/open-apis/contact/v3/users/batch", { params });
+            const items = (res?.data?.user_list ||
+                []);
+            for (const user of items) {
+                if (user.open_id && user.name) {
+                    nameMap.set(user.open_id, user.name);
+                }
+            }
+        }
+        catch {
+            // skip batch errors
+        }
+    }
+    return nameMap;
+}
+// ── Resolve image URLs (images + download) ──
+async function resolveImageUrls(authInfo, blocks, globalOpts) {
+    const fileTokens = extractFileTokens(blocks);
+    if (fileTokens.length === 0)
+        return new Map();
+    const tmpUrlMap = await withScopeRecovery(async () => {
+        const { authInfo: freshAuth } = await createClient(globalOpts);
+        return batchGetTmpUrls(freshAuth, fileTokens);
+    }, globalOpts, ["drive:drive"]);
+    return downloadImages(tmpUrlMap);
+}
+// ── Main entry point ──
+/**
+ * Enrich document blocks with embedded content data.
+ *
+ * Resolves images, bitable tables, spreadsheets, board images,
+ * and @mention user names in parallel with concurrency control.
+ *
+ * @param authInfo - Authentication context
+ * @param blocks - Document blocks to enrich
+ * @param globalOpts - Global CLI options
+ * @param options - Control which enrichments to run and concurrency
+ * @returns Enrichment maps for blocksToMarkdown rendering
+ */
+export async function enrichBlocks(authInfo, blocks, globalOpts, options = {}) {
+    const opts = {
+        images: options.images ?? true,
+        bitable: options.bitable ?? true,
+        sheet: options.sheet ?? true,
+        board: options.board ?? true,
+        mentions: options.mentions ?? true,
+        concurrency: options.concurrency ?? 5,
+    };
+    const limit = pLimit(opts.concurrency);
+    const result = {
+        imageUrlMap: new Map(),
+        userNameMap: new Map(),
+        bitableDataMap: new Map(),
+        boardImageMap: new Map(),
+        sheetDataMap: new Map(),
+    };
+    const tasks = [];
+    // Image enrichment
+    if (opts.images) {
+        const fileTokens = extractFileTokens(blocks);
+        if (fileTokens.length > 0) {
+            tasks.push(limit(async () => {
+                try {
+                    const map = await resolveImageUrls(authInfo, blocks, globalOpts);
+                    for (const [k, v] of map)
+                        result.imageUrlMap.set(k, v);
+                }
+                catch {
+                    process.stderr.write("feishu-docs: warning: 获取图片/文件链接失败，链接将为空\n");
+                }
+            }));
+        }
+    }
+    // Mention enrichment
+    if (opts.mentions) {
+        const mentionUserIds = extractMentionUserIds(blocks);
+        if (mentionUserIds.length > 0) {
+            tasks.push(limit(async () => {
+                try {
+                    const map = await resolveUserNames(authInfo, mentionUserIds);
+                    for (const [k, v] of map)
+                        result.userNameMap.set(k, v);
+                }
+                catch {
+                    process.stderr.write("feishu-docs: warning: 解析 @用户 名称失败\n");
+                }
+            }));
+        }
+    }
+    // Bitable enrichment
+    if (opts.bitable) {
+        const bitableTokens = extractBitableTokens(blocks);
+        for (const token of bitableTokens) {
+            tasks.push(limit(async () => {
+                try {
+                    const data = await fetchBitableData(authInfo, token);
+                    if (data)
+                        result.bitableDataMap.set(token, data);
+                }
+                catch (err) {
+                    if (err instanceof CliError &&
+                        (err.errorType === "PERMISSION_DENIED" ||
+                            err.errorType === "SCOPE_MISSING")) {
+                        process.stderr.write(`feishu-docs: warning: 获取多维表格数据权限不足: ${token}\n` +
+                            '  请在飞书开发者后台开通权限后运行 feishu-docs authorize --scope "bitable:app:readonly"\n');
+                    }
+                    else {
+                        process.stderr.write(`feishu-docs: warning: 获取多维表格数据失败: ${token}\n`);
+                    }
+                }
+            }));
+        }
+    }
+    // Board enrichment
+    if (opts.board) {
+        const boardTokens = extractBoardTokens(blocks);
+        for (const token of boardTokens) {
+            tasks.push(limit(async () => {
+                try {
+                    const filePath = await fetchBoardImage(authInfo, token);
+                    if (filePath)
+                        result.boardImageMap.set(token, filePath);
+                }
+                catch (err) {
+                    if (err instanceof CliError &&
+                        (err.errorType === "PERMISSION_DENIED" ||
+                            err.errorType === "SCOPE_MISSING")) {
+                        process.stderr.write(`feishu-docs: warning: 获取画板图片权限不足: ${token}\n` +
+                            '  请在飞书开发者后台开通权限后运行 feishu-docs authorize --scope "board:whiteboard:node:read"\n');
+                    }
+                    else {
+                        process.stderr.write(`feishu-docs: warning: 获取画板图片失败: ${token}\n`);
+                    }
+                }
+            }));
+        }
+    }
+    // Sheet enrichment
+    if (opts.sheet) {
+        const sheetTokens = extractSheetTokens(blocks);
+        for (const token of sheetTokens) {
+            tasks.push(limit(async () => {
+                try {
+                    const data = await fetchSheetData(authInfo, token);
+                    if (data)
+                        result.sheetDataMap.set(token, data);
+                }
+                catch (err) {
+                    if (err instanceof CliError &&
+                        (err.errorType === "PERMISSION_DENIED" ||
+                            err.errorType === "SCOPE_MISSING")) {
+                        process.stderr.write(`feishu-docs: warning: 获取电子表格数据权限不足: ${token}\n` +
+                            '  请在飞书开发者后台开通权限后运行 feishu-docs authorize --scope "sheets:spreadsheet:readonly"\n');
+                    }
+                    else {
+                        const msg = err instanceof Error ? err.message : String(err);
+                        process.stderr.write(`feishu-docs: warning: 获取电子表格数据失败: ${token} (${msg})\n`);
+                    }
+                }
+            }));
+        }
+    }
+    await Promise.allSettled(tasks);
+    return result;
+}
+//# sourceMappingURL=doc-enrichment.js.map

package/dist/services/doc-enrichment.js.map

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

package/dist/services/image-download.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Download document images to local persistent storage.
+ *
+ * Images are saved to ~/.feishu-docs/images/{fileToken}.{ext} and served
+ * via local file paths in Markdown output. Already-downloaded images are
+ * skipped (disk cache by file_token).
+ */
+export declare const IMAGES_DIR: string;
+export declare const CONTENT_TYPE_EXT: Record<string, string>;
+/** Maximum age for cached images (30 days in milliseconds). */
+export declare const IMAGE_TTL_MS: number;
+/**
+ * Resolve content-type to file extension. Defaults to ".png".
+ */
+export declare function resolveExtension(contentType: string): string;
+/**
+ * Find a cached image file for the given token (any known extension).
+ * Returns the file path if found, or null.
+ */
+export declare function findCachedImage(fileToken: string, dir?: string): Promise<string | null>;
+/**
+ * Remove cached image files older than IMAGE_TTL_MS.
+ * Errors are caught and logged to stderr -- never throws.
+ */
+export declare function cleanExpiredImages(dir: string): Promise<void>;
+/**
+ * Download images from temporary URLs and save to local directory.
+ * Returns a map of file_token → local file path. Already-downloaded images
+ * are skipped (simple disk cache by file_token).
+ */
+export declare function downloadImages(tmpUrlMap: Map<string, string>, dir?: string): Promise<Map<string, string>>;

package/dist/services/image-download.js

@@ -0,0 +1,127 @@
+/**
+ * Download document images to local persistent storage.
+ *
+ * Images are saved to ~/.feishu-docs/images/{fileToken}.{ext} and served
+ * via local file paths in Markdown output. Already-downloaded images are
+ * skipped (disk cache by file_token).
+ */
+import { writeFile, mkdir, stat, readdir, unlink } from "node:fs/promises";
+import { homedir } from "node:os";
+import { join } from "node:path";
+import { validateToken } from "../utils/validate.js";
+export const IMAGES_DIR = join(homedir(), ".feishu-docs", "images");
+export const CONTENT_TYPE_EXT = {
+    "image/png": ".png",
+    "image/jpeg": ".jpg",
+    "image/gif": ".gif",
+    "image/webp": ".webp",
+    "image/svg+xml": ".svg",
+};
+/** Maximum age for cached images (30 days in milliseconds). */
+export const IMAGE_TTL_MS = 30 * 24 * 60 * 60 * 1000;
+const KNOWN_EXTENSIONS = Object.values(CONTENT_TYPE_EXT);
+/**
+ * Check if a file already exists.
+ */
+async function fileExists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * Resolve content-type to file extension. Defaults to ".png".
+ */
+export function resolveExtension(contentType) {
+    return CONTENT_TYPE_EXT[contentType.split(";")[0].trim()] || ".png";
+}
+/**
+ * Find a cached image file for the given token (any known extension).
+ * Returns the file path if found, or null.
+ */
+export async function findCachedImage(fileToken, dir = IMAGES_DIR) {
+    for (const ext of KNOWN_EXTENSIONS) {
+        const p = join(dir, `${fileToken}${ext}`);
+        if (await fileExists(p))
+            return p;
+    }
+    return null;
+}
+/**
+ * Remove cached image files older than IMAGE_TTL_MS.
+ * Errors are caught and logged to stderr -- never throws.
+ */
+export async function cleanExpiredImages(dir) {
+    try {
+        const files = await readdir(dir);
+        const now = Date.now();
+        let cleaned = 0;
+        for (const file of files) {
+            try {
+                const filePath = join(dir, file);
+                const fileStat = await stat(filePath);
+                if (now - fileStat.mtimeMs > IMAGE_TTL_MS) {
+                    await unlink(filePath);
+                    cleaned++;
+                }
+            }
+            catch {
+                // Individual file cleanup failure -- skip silently
+            }
+        }
+        if (cleaned > 0) {
+            process.stderr.write(`feishu-docs: info: 已清理 ${cleaned} 个过期图片缓存\n`);
+        }
+    }
+    catch {
+        process.stderr.write("feishu-docs: warning: 图片缓存清理失败\n");
+    }
+}
+/**
+ * Download images from temporary URLs and save to local directory.
+ * Returns a map of file_token → local file path. Already-downloaded images
+ * are skipped (simple disk cache by file_token).
+ */
+export async function downloadImages(tmpUrlMap, dir = IMAGES_DIR) {
+    if (tmpUrlMap.size === 0)
+        return new Map();
+    await mkdir(dir, { recursive: true });
+    void cleanExpiredImages(dir);
+    const localMap = new Map();
+    for (const [fileToken, tmpUrl] of tmpUrlMap) {
+        // Validate token before using as filename to prevent path traversal
+        try {
+            validateToken(fileToken, "file_token");
+        }
+        catch {
+            continue;
+        }
+        // Check disk cache (any known extension)
+        const cached = await findCachedImage(fileToken, dir);
+        if (cached) {
+            localMap.set(fileToken, cached);
+            continue;
+        }
+        try {
+            const res = await fetch(tmpUrl);
+            if (!res.ok)
+                continue;
+            const contentType = res.headers.get("content-type") || "";
+            const ext = resolveExtension(contentType);
+            const filePath = join(dir, `${fileToken}${ext}`);
+            const buf = await res.arrayBuffer();
+            if (buf.byteLength === 0)
+                continue;
+            await writeFile(filePath, Buffer.from(buf));
+            localMap.set(fileToken, filePath);
+        }
+        catch {
+            // Download failed for this image — skip it
+        }
+    }
+    return localMap;
+}
+//# sourceMappingURL=image-download.js.map

package/dist/services/image-download.js.map

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

package/dist/services/markdown-convert.d.ts

@@ -19,6 +19,26 @@ import { AuthInfo, ConvertedBlocks, Block } from "../types/index.js";
  * Replaces unrecognized aliases with their recognized equivalents.
  */
 export declare function normalizeLangNames(markdown: string): string;
+/**
+ * Extract the first top-level heading (# title) from markdown.
+ *
+ * Returns the title text and the remaining body with the heading line removed.
+ * Only matches `# heading` (H1), not `## heading` (H2+).
+ * Ignores leading blank lines before the heading.
+ * If no H1 heading is found, returns null title and the original markdown.
+ */
+export declare function extractMarkdownTitle(markdown: string): {
+    title: string | null;
+    body: string;
+};
+/**
+ * Replace literal `\n` with `<br>` inside mermaid code blocks.
+ *
+ * Claude and other AI tools generate mermaid node labels with `\n` for
+ * line breaks (e.g. `A[Line 1\nLine 2]`), but standard mermaid syntax
+ * requires `<br>` (e.g. `A[Line 1<br>Line 2]`).
+ */
+export declare function normalizeMermaidLineBreaks(markdown: string): string;
 /**
  * Convert markdown string to Feishu block array via Convert API.
  * Requires scope: docx:document.block:convert