@md-lark-converter/core 1.0.0 → 1.2.0

package/dist/feishu.d.mts

@@ -0,0 +1,28 @@
+import { ClipboardData } from './index.mjs';
+
+interface FetchOptions {
+    cookie?: string;
+    verbose?: boolean;
+}
+/**
+ * Parse a Feishu document URL.
+ * Supports:
+ *   https://xxx.feishu.cn/wiki/TOKEN
+ *   https://xxx.feishu.cn/docx/TOKEN
+ */
+declare function parseFeishuUrl(url: string): {
+    origin: string;
+    token: string;
+    type: 'wiki' | 'docx';
+};
+/**
+ * Resolve the cookie string from various sources.
+ * Priority: --cookie flag > FEISHU_COOKIE env > config file
+ */
+declare function resolveCookie(flagCookie?: string): string;
+/**
+ * Fetch a Feishu document and return it as ClipboardData.
+ */
+declare function fetchFeishuDocument(url: string, options?: FetchOptions): Promise<ClipboardData>;
+
+export { fetchFeishuDocument, parseFeishuUrl, resolveCookie };

package/dist/feishu.d.ts

@@ -0,0 +1,28 @@
+import { ClipboardData } from './index.js';
+
+interface FetchOptions {
+    cookie?: string;
+    verbose?: boolean;
+}
+/**
+ * Parse a Feishu document URL.
+ * Supports:
+ *   https://xxx.feishu.cn/wiki/TOKEN
+ *   https://xxx.feishu.cn/docx/TOKEN
+ */
+declare function parseFeishuUrl(url: string): {
+    origin: string;
+    token: string;
+    type: 'wiki' | 'docx';
+};
+/**
+ * Resolve the cookie string from various sources.
+ * Priority: --cookie flag > FEISHU_COOKIE env > config file
+ */
+declare function resolveCookie(flagCookie?: string): string;
+/**
+ * Fetch a Feishu document and return it as ClipboardData.
+ */
+declare function fetchFeishuDocument(url: string, options?: FetchOptions): Promise<ClipboardData>;
+
+export { fetchFeishuDocument, parseFeishuUrl, resolveCookie };

package/dist/feishu.js

@@ -0,0 +1,195 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/feishuFetcher.ts
+var feishuFetcher_exports = {};
+__export(feishuFetcher_exports, {
+  fetchFeishuDocument: () => fetchFeishuDocument,
+  parseFeishuUrl: () => parseFeishuUrl,
+  resolveCookie: () => resolveCookie
+});
+module.exports = __toCommonJS(feishuFetcher_exports);
+var import_fs = require("fs");
+var import_os = require("os");
+var import_path = require("path");
+var CONFIG_PATH = (0, import_path.join)((0, import_os.homedir)(), ".md-lark-converter.json");
+function parseFeishuUrl(url) {
+  const parsed = new URL(url);
+  const pathParts = parsed.pathname.split("/").filter(Boolean);
+  if (pathParts.length < 2) {
+    throw new Error(`Invalid Feishu URL: ${url}`);
+  }
+  const docType = pathParts[0];
+  if (docType !== "wiki" && docType !== "docx") {
+    throw new Error(`Unsupported document type: ${docType}. Expected 'wiki' or 'docx'.`);
+  }
+  return {
+    origin: parsed.origin,
+    token: pathParts[1],
+    type: docType
+  };
+}
+async function resolveWikiToken(origin, wikiToken, cookie, csrfToken) {
+  const url = `${origin}/space/api/wiki/v2/tree/get_node/?wiki_token=${wikiToken}`;
+  const resp = await fetch(url, {
+    headers: {
+      "Cookie": cookie,
+      "X-CSRFToken": csrfToken
+    }
+  });
+  if (!resp.ok) {
+    throw new Error(`Failed to resolve wiki token: HTTP ${resp.status}`);
+  }
+  const body = await resp.json();
+  if (body.code !== 0) {
+    throw new Error(`Failed to resolve wiki token: ${body.msg}`);
+  }
+  return body.data.obj_token;
+}
+async function fetchClientVars(origin, objToken, cookie, csrfToken, verbose) {
+  const allBlocks = {};
+  let allSequence = [];
+  let docId = "";
+  let cursors = [];
+  let isFirst = true;
+  do {
+    const params = new URLSearchParams({
+      id: objToken,
+      mode: "7",
+      limit: "239"
+    });
+    if (!isFirst && cursors.length > 0) {
+      params.set("cursor", cursors[0]);
+    }
+    const url = `${origin}/space/api/docx/pages/client_vars?${params}`;
+    if (verbose) console.log(`Fetching: ${url}`);
+    const resp = await fetch(url, {
+      headers: {
+        "Cookie": cookie,
+        "X-CSRFToken": csrfToken,
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
+      }
+    });
+    if (!resp.ok) {
+      throw new Error(`API request failed: HTTP ${resp.status}`);
+    }
+    const body = await resp.json();
+    if (body.code !== 0) {
+      throw new Error(`API error: ${body.msg} (code: ${body.code})`);
+    }
+    const data = body.data;
+    Object.assign(allBlocks, data.block_map);
+    if (data.block_sequence) {
+      allSequence = allSequence.concat(data.block_sequence);
+    }
+    if (isFirst) {
+      docId = data.id;
+    }
+    if (verbose) {
+      const count = Object.keys(data.block_map).length;
+      console.log(`  Got ${count} blocks, has_more: ${data.has_more}`);
+    }
+    cursors = data.next_cursors || [];
+    isFirst = false;
+  } while (cursors.length > 0);
+  return {
+    block_map: allBlocks,
+    block_sequence: allSequence.length > 0 ? allSequence : Object.keys(allBlocks),
+    id: docId,
+    has_more: false,
+    next_cursors: []
+  };
+}
+function resolveCookie(flagCookie) {
+  if (flagCookie) return flagCookie;
+  const envCookie = process.env.FEISHU_COOKIE;
+  if (envCookie) return envCookie;
+  if ((0, import_fs.existsSync)(CONFIG_PATH)) {
+    try {
+      const config = JSON.parse((0, import_fs.readFileSync)(CONFIG_PATH, "utf-8"));
+      if (config.cookie) return config.cookie;
+    } catch {
+    }
+  }
+  throw new Error(
+    `No cookie provided. Use one of:
+  --cookie "your_cookie_string"
+  FEISHU_COOKIE environment variable
+  ${CONFIG_PATH} with {"cookie": "..."}`
+  );
+}
+function extractCsrfToken(cookie) {
+  const match = cookie.match(/_csrf_token=([^;]+)/);
+  return match ? match[1] : "";
+}
+function blockMapToClipboardData(data) {
+  const recordMap = {};
+  for (const [id, entry] of Object.entries(data.block_map)) {
+    recordMap[id] = {
+      id: entry.id,
+      snapshot: entry.data
+    };
+  }
+  return {
+    isCut: false,
+    rootId: data.id,
+    parentId: "",
+    blockIds: [],
+    recordIds: data.block_sequence || Object.keys(data.block_map),
+    recordMap,
+    payloadMap: {},
+    selection: [],
+    extra: {
+      channel: "",
+      pasteRandomId: "",
+      mention_page_title: {},
+      external_mention_url: {},
+      isEqualBlockSelection: false
+    },
+    isKeepQuoteContainer: false,
+    pasteFlag: ""
+  };
+}
+async function fetchFeishuDocument(url, options = {}) {
+  const { verbose = false } = options;
+  const cookie = resolveCookie(options.cookie);
+  const csrfToken = extractCsrfToken(cookie);
+  const { origin, token, type } = parseFeishuUrl(url);
+  if (verbose) console.log(`Document type: ${type}, token: ${token}`);
+  let objToken = token;
+  if (type === "wiki") {
+    if (verbose) console.log("Resolving wiki token...");
+    objToken = await resolveWikiToken(origin, token, cookie, csrfToken);
+    if (verbose) console.log(`Resolved to obj_token: ${objToken}`);
+  }
+  const data = await fetchClientVars(origin, objToken, cookie, csrfToken, verbose);
+  const blockCount = Object.keys(data.block_map).length;
+  if (verbose) console.log(`Total blocks: ${blockCount}`);
+  if (blockCount === 0) {
+    throw new Error("No blocks found. The document may be empty or inaccessible.");
+  }
+  return blockMapToClipboardData(data);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  fetchFeishuDocument,
+  parseFeishuUrl,
+  resolveCookie
+});
+//# sourceMappingURL=feishu.js.map

package/dist/feishu.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/feishuFetcher.ts"],"sourcesContent":["import { readFileSync, existsSync } from 'fs';\nimport { homedir } from 'os';\nimport { join } from 'path';\nimport type { ClipboardData } from './index.js';\n\nconst CONFIG_PATH = join(homedir(), '.md-lark-converter.json');\n\ninterface FetchOptions {\n  cookie?: string;\n  verbose?: boolean;\n}\n\ninterface BlockMapEntry {\n  id: string;\n  version: number;\n  data: Record<string, unknown>;\n}\n\ninterface ClientVarResponse {\n  code: number;\n  msg: string;\n  data: {\n    block_map: Record<string, BlockMapEntry>;\n    block_sequence?: string[];\n    id: string;\n    has_more: boolean;\n    next_cursors: string[];\n    cursor?: string;\n    meta_map?: Record<string, unknown>;\n    editor_map?: Record<string, unknown>;\n    [key: string]: unknown;\n  };\n}\n\n/**\n * Parse a Feishu document URL.\n * Supports:\n *   https://xxx.feishu.cn/wiki/TOKEN\n *   https://xxx.feishu.cn/docx/TOKEN\n */\nexport function parseFeishuUrl(url: string): { origin: string; token: string; type: 'wiki' | 'docx' } {\n  const parsed = new URL(url);\n  const pathParts = parsed.pathname.split('/').filter(Boolean);\n\n  if (pathParts.length < 2) {\n    throw new Error(`Invalid Feishu URL: ${url}`);\n  }\n\n  const docType = pathParts[0] as 'wiki' | 'docx';\n  if (docType !== 'wiki' && docType !== 'docx') {\n    throw new Error(`Unsupported document type: ${docType}. Expected 'wiki' or 'docx'.`);\n  }\n\n  return {\n    origin: parsed.origin,\n    token: pathParts[1],\n    type: docType,\n  };\n}\n\n/**\n * Resolve a wiki token to its underlying docx obj_token.\n */\nasync function resolveWikiToken(\n  origin: string,\n  wikiToken: string,\n  cookie: string,\n  csrfToken: string,\n): Promise<string> {\n  const url = `${origin}/space/api/wiki/v2/tree/get_node/?wiki_token=${wikiToken}`;\n  const resp = await fetch(url, {\n    headers: {\n      'Cookie': cookie,\n      'X-CSRFToken': csrfToken,\n    },\n  });\n\n  if (!resp.ok) {\n    throw new Error(`Failed to resolve wiki token: HTTP ${resp.status}`);\n  }\n\n  const body = await resp.json() as any;\n  if (body.code !== 0) {\n    throw new Error(`Failed to resolve wiki token: ${body.msg}`);\n  }\n\n  return body.data.obj_token;\n}\n\n/**\n * Fetch document blocks via the clientvar HTTP API.\n * Handles pagination if the document is large.\n */\nasync function fetchClientVars(\n  origin: string,\n  objToken: string,\n  cookie: string,\n  csrfToken: string,\n  verbose: boolean,\n): Promise<ClientVarResponse['data']> {\n  const allBlocks: Record<string, BlockMapEntry> = {};\n  let allSequence: string[] = [];\n  let docId = '';\n  let cursors: string[] = [];\n  let isFirst = true;\n\n  do {\n    const params = new URLSearchParams({\n      id: objToken,\n      mode: '7',\n      limit: '239',\n    });\n\n    if (!isFirst && cursors.length > 0) {\n      params.set('cursor', cursors[0]);\n    }\n\n    const url = `${origin}/space/api/docx/pages/client_vars?${params}`;\n    if (verbose) console.log(`Fetching: ${url}`);\n\n    const resp = await fetch(url, {\n      headers: {\n        'Cookie': cookie,\n        'X-CSRFToken': csrfToken,\n        'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)',\n      },\n    });\n\n    if (!resp.ok) {\n      throw new Error(`API request failed: HTTP ${resp.status}`);\n    }\n\n    const body = await resp.json() as ClientVarResponse;\n    if (body.code !== 0) {\n      throw new Error(`API error: ${body.msg} (code: ${body.code})`);\n    }\n\n    const data = body.data;\n    Object.assign(allBlocks, data.block_map);\n\n    if (data.block_sequence) {\n      allSequence = allSequence.concat(data.block_sequence);\n    }\n\n    if (isFirst) {\n      docId = data.id;\n    }\n\n    if (verbose) {\n      const count = Object.keys(data.block_map).length;\n      console.log(`  Got ${count} blocks, has_more: ${data.has_more}`);\n    }\n\n    cursors = data.next_cursors || [];\n    isFirst = false;\n  } while (cursors.length > 0);\n\n  return {\n    block_map: allBlocks,\n    block_sequence: allSequence.length > 0 ? allSequence : Object.keys(allBlocks),\n    id: docId,\n    has_more: false,\n    next_cursors: [],\n  };\n}\n\n/**\n * Resolve the cookie string from various sources.\n * Priority: --cookie flag > FEISHU_COOKIE env > config file\n */\nexport function resolveCookie(flagCookie?: string): string {\n  if (flagCookie) return flagCookie;\n\n  const envCookie = process.env.FEISHU_COOKIE;\n  if (envCookie) return envCookie;\n\n  if (existsSync(CONFIG_PATH)) {\n    try {\n      const config = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));\n      if (config.cookie) return config.cookie;\n    } catch {\n      // ignore parse errors\n    }\n  }\n\n  throw new Error(\n    'No cookie provided. Use one of:\\n' +\n    '  --cookie \"your_cookie_string\"\\n' +\n    '  FEISHU_COOKIE environment variable\\n' +\n    `  ${CONFIG_PATH} with {\"cookie\": \"...\"}`\n  );\n}\n\n/**\n * Extract the _csrf_token from a cookie string.\n */\nfunction extractCsrfToken(cookie: string): string {\n  const match = cookie.match(/_csrf_token=([^;]+)/);\n  return match ? match[1] : '';\n}\n\n/**\n * Convert clientvar block_map to ClipboardData format for larkToMarkdown.\n */\nfunction blockMapToClipboardData(data: ClientVarResponse['data']): ClipboardData {\n  const recordMap: Record<string, { id: string; snapshot: Record<string, unknown> }> = {};\n\n  for (const [id, entry] of Object.entries(data.block_map)) {\n    recordMap[id] = {\n      id: entry.id,\n      snapshot: entry.data,\n    };\n  }\n\n  return {\n    isCut: false,\n    rootId: data.id,\n    parentId: '',\n    blockIds: [],\n    recordIds: data.block_sequence || Object.keys(data.block_map),\n    recordMap: recordMap as any,\n    payloadMap: {},\n    selection: [],\n    extra: {\n      channel: '',\n      pasteRandomId: '',\n      mention_page_title: {},\n      external_mention_url: {},\n      isEqualBlockSelection: false,\n    },\n    isKeepQuoteContainer: false,\n    pasteFlag: '',\n  };\n}\n\n/**\n * Fetch a Feishu document and return it as ClipboardData.\n */\nexport async function fetchFeishuDocument(\n  url: string,\n  options: FetchOptions = {}\n): Promise<ClipboardData> {\n  const { verbose = false } = options;\n\n  const cookie = resolveCookie(options.cookie);\n  const csrfToken = extractCsrfToken(cookie);\n  const { origin, token, type } = parseFeishuUrl(url);\n\n  if (verbose) console.log(`Document type: ${type}, token: ${token}`);\n\n  // Resolve wiki token to obj_token if needed\n  let objToken = token;\n  if (type === 'wiki') {\n    if (verbose) console.log('Resolving wiki token...');\n    objToken = await resolveWikiToken(origin, token, cookie, csrfToken);\n    if (verbose) console.log(`Resolved to obj_token: ${objToken}`);\n  }\n\n  // Fetch document blocks\n  const data = await fetchClientVars(origin, objToken, cookie, csrfToken, verbose);\n\n  const blockCount = Object.keys(data.block_map).length;\n  if (verbose) console.log(`Total blocks: ${blockCount}`);\n\n  if (blockCount === 0) {\n    throw new Error('No blocks found. The document may be empty or inaccessible.');\n  }\n\n  return blockMapToClipboardData(data);\n}\n"],"mappings":"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","names":[]}

package/dist/feishu.mjs

@@ -0,0 +1,168 @@
+// src/feishuFetcher.ts
+import { readFileSync, existsSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+var CONFIG_PATH = join(homedir(), ".md-lark-converter.json");
+function parseFeishuUrl(url) {
+  const parsed = new URL(url);
+  const pathParts = parsed.pathname.split("/").filter(Boolean);
+  if (pathParts.length < 2) {
+    throw new Error(`Invalid Feishu URL: ${url}`);
+  }
+  const docType = pathParts[0];
+  if (docType !== "wiki" && docType !== "docx") {
+    throw new Error(`Unsupported document type: ${docType}. Expected 'wiki' or 'docx'.`);
+  }
+  return {
+    origin: parsed.origin,
+    token: pathParts[1],
+    type: docType
+  };
+}
+async function resolveWikiToken(origin, wikiToken, cookie, csrfToken) {
+  const url = `${origin}/space/api/wiki/v2/tree/get_node/?wiki_token=${wikiToken}`;
+  const resp = await fetch(url, {
+    headers: {
+      "Cookie": cookie,
+      "X-CSRFToken": csrfToken
+    }
+  });
+  if (!resp.ok) {
+    throw new Error(`Failed to resolve wiki token: HTTP ${resp.status}`);
+  }
+  const body = await resp.json();
+  if (body.code !== 0) {
+    throw new Error(`Failed to resolve wiki token: ${body.msg}`);
+  }
+  return body.data.obj_token;
+}
+async function fetchClientVars(origin, objToken, cookie, csrfToken, verbose) {
+  const allBlocks = {};
+  let allSequence = [];
+  let docId = "";
+  let cursors = [];
+  let isFirst = true;
+  do {
+    const params = new URLSearchParams({
+      id: objToken,
+      mode: "7",
+      limit: "239"
+    });
+    if (!isFirst && cursors.length > 0) {
+      params.set("cursor", cursors[0]);
+    }
+    const url = `${origin}/space/api/docx/pages/client_vars?${params}`;
+    if (verbose) console.log(`Fetching: ${url}`);
+    const resp = await fetch(url, {
+      headers: {
+        "Cookie": cookie,
+        "X-CSRFToken": csrfToken,
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)"
+      }
+    });
+    if (!resp.ok) {
+      throw new Error(`API request failed: HTTP ${resp.status}`);
+    }
+    const body = await resp.json();
+    if (body.code !== 0) {
+      throw new Error(`API error: ${body.msg} (code: ${body.code})`);
+    }
+    const data = body.data;
+    Object.assign(allBlocks, data.block_map);
+    if (data.block_sequence) {
+      allSequence = allSequence.concat(data.block_sequence);
+    }
+    if (isFirst) {
+      docId = data.id;
+    }
+    if (verbose) {
+      const count = Object.keys(data.block_map).length;
+      console.log(`  Got ${count} blocks, has_more: ${data.has_more}`);
+    }
+    cursors = data.next_cursors || [];
+    isFirst = false;
+  } while (cursors.length > 0);
+  return {
+    block_map: allBlocks,
+    block_sequence: allSequence.length > 0 ? allSequence : Object.keys(allBlocks),
+    id: docId,
+    has_more: false,
+    next_cursors: []
+  };
+}
+function resolveCookie(flagCookie) {
+  if (flagCookie) return flagCookie;
+  const envCookie = process.env.FEISHU_COOKIE;
+  if (envCookie) return envCookie;
+  if (existsSync(CONFIG_PATH)) {
+    try {
+      const config = JSON.parse(readFileSync(CONFIG_PATH, "utf-8"));
+      if (config.cookie) return config.cookie;
+    } catch {
+    }
+  }
+  throw new Error(
+    `No cookie provided. Use one of:
+  --cookie "your_cookie_string"
+  FEISHU_COOKIE environment variable
+  ${CONFIG_PATH} with {"cookie": "..."}`
+  );
+}
+function extractCsrfToken(cookie) {
+  const match = cookie.match(/_csrf_token=([^;]+)/);
+  return match ? match[1] : "";
+}
+function blockMapToClipboardData(data) {
+  const recordMap = {};
+  for (const [id, entry] of Object.entries(data.block_map)) {
+    recordMap[id] = {
+      id: entry.id,
+      snapshot: entry.data
+    };
+  }
+  return {
+    isCut: false,
+    rootId: data.id,
+    parentId: "",
+    blockIds: [],
+    recordIds: data.block_sequence || Object.keys(data.block_map),
+    recordMap,
+    payloadMap: {},
+    selection: [],
+    extra: {
+      channel: "",
+      pasteRandomId: "",
+      mention_page_title: {},
+      external_mention_url: {},
+      isEqualBlockSelection: false
+    },
+    isKeepQuoteContainer: false,
+    pasteFlag: ""
+  };
+}
+async function fetchFeishuDocument(url, options = {}) {
+  const { verbose = false } = options;
+  const cookie = resolveCookie(options.cookie);
+  const csrfToken = extractCsrfToken(cookie);
+  const { origin, token, type } = parseFeishuUrl(url);
+  if (verbose) console.log(`Document type: ${type}, token: ${token}`);
+  let objToken = token;
+  if (type === "wiki") {
+    if (verbose) console.log("Resolving wiki token...");
+    objToken = await resolveWikiToken(origin, token, cookie, csrfToken);
+    if (verbose) console.log(`Resolved to obj_token: ${objToken}`);
+  }
+  const data = await fetchClientVars(origin, objToken, cookie, csrfToken, verbose);
+  const blockCount = Object.keys(data.block_map).length;
+  if (verbose) console.log(`Total blocks: ${blockCount}`);
+  if (blockCount === 0) {
+    throw new Error("No blocks found. The document may be empty or inaccessible.");
+  }
+  return blockMapToClipboardData(data);
+}
+export {
+  fetchFeishuDocument,
+  parseFeishuUrl,
+  resolveCookie
+};
+//# sourceMappingURL=feishu.mjs.map

package/dist/feishu.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/feishuFetcher.ts"],"sourcesContent":["import { readFileSync, existsSync } from 'fs';\nimport { homedir } from 'os';\nimport { join } from 'path';\nimport type { ClipboardData } from './index.js';\n\nconst CONFIG_PATH = join(homedir(), '.md-lark-converter.json');\n\ninterface FetchOptions {\n  cookie?: string;\n  verbose?: boolean;\n}\n\ninterface BlockMapEntry {\n  id: string;\n  version: number;\n  data: Record<string, unknown>;\n}\n\ninterface ClientVarResponse {\n  code: number;\n  msg: string;\n  data: {\n    block_map: Record<string, BlockMapEntry>;\n    block_sequence?: string[];\n    id: string;\n    has_more: boolean;\n    next_cursors: string[];\n    cursor?: string;\n    meta_map?: Record<string, unknown>;\n    editor_map?: Record<string, unknown>;\n    [key: string]: unknown;\n  };\n}\n\n/**\n * Parse a Feishu document URL.\n * Supports:\n *   https://xxx.feishu.cn/wiki/TOKEN\n *   https://xxx.feishu.cn/docx/TOKEN\n */\nexport function parseFeishuUrl(url: string): { origin: string; token: string; type: 'wiki' | 'docx' } {\n  const parsed = new URL(url);\n  const pathParts = parsed.pathname.split('/').filter(Boolean);\n\n  if (pathParts.length < 2) {\n    throw new Error(`Invalid Feishu URL: ${url}`);\n  }\n\n  const docType = pathParts[0] as 'wiki' | 'docx';\n  if (docType !== 'wiki' && docType !== 'docx') {\n    throw new Error(`Unsupported document type: ${docType}. Expected 'wiki' or 'docx'.`);\n  }\n\n  return {\n    origin: parsed.origin,\n    token: pathParts[1],\n    type: docType,\n  };\n}\n\n/**\n * Resolve a wiki token to its underlying docx obj_token.\n */\nasync function resolveWikiToken(\n  origin: string,\n  wikiToken: string,\n  cookie: string,\n  csrfToken: string,\n): Promise<string> {\n  const url = `${origin}/space/api/wiki/v2/tree/get_node/?wiki_token=${wikiToken}`;\n  const resp = await fetch(url, {\n    headers: {\n      'Cookie': cookie,\n      'X-CSRFToken': csrfToken,\n    },\n  });\n\n  if (!resp.ok) {\n    throw new Error(`Failed to resolve wiki token: HTTP ${resp.status}`);\n  }\n\n  const body = await resp.json() as any;\n  if (body.code !== 0) {\n    throw new Error(`Failed to resolve wiki token: ${body.msg}`);\n  }\n\n  return body.data.obj_token;\n}\n\n/**\n * Fetch document blocks via the clientvar HTTP API.\n * Handles pagination if the document is large.\n */\nasync function fetchClientVars(\n  origin: string,\n  objToken: string,\n  cookie: string,\n  csrfToken: string,\n  verbose: boolean,\n): Promise<ClientVarResponse['data']> {\n  const allBlocks: Record<string, BlockMapEntry> = {};\n  let allSequence: string[] = [];\n  let docId = '';\n  let cursors: string[] = [];\n  let isFirst = true;\n\n  do {\n    const params = new URLSearchParams({\n      id: objToken,\n      mode: '7',\n      limit: '239',\n    });\n\n    if (!isFirst && cursors.length > 0) {\n      params.set('cursor', cursors[0]);\n    }\n\n    const url = `${origin}/space/api/docx/pages/client_vars?${params}`;\n    if (verbose) console.log(`Fetching: ${url}`);\n\n    const resp = await fetch(url, {\n      headers: {\n        'Cookie': cookie,\n        'X-CSRFToken': csrfToken,\n        'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)',\n      },\n    });\n\n    if (!resp.ok) {\n      throw new Error(`API request failed: HTTP ${resp.status}`);\n    }\n\n    const body = await resp.json() as ClientVarResponse;\n    if (body.code !== 0) {\n      throw new Error(`API error: ${body.msg} (code: ${body.code})`);\n    }\n\n    const data = body.data;\n    Object.assign(allBlocks, data.block_map);\n\n    if (data.block_sequence) {\n      allSequence = allSequence.concat(data.block_sequence);\n    }\n\n    if (isFirst) {\n      docId = data.id;\n    }\n\n    if (verbose) {\n      const count = Object.keys(data.block_map).length;\n      console.log(`  Got ${count} blocks, has_more: ${data.has_more}`);\n    }\n\n    cursors = data.next_cursors || [];\n    isFirst = false;\n  } while (cursors.length > 0);\n\n  return {\n    block_map: allBlocks,\n    block_sequence: allSequence.length > 0 ? allSequence : Object.keys(allBlocks),\n    id: docId,\n    has_more: false,\n    next_cursors: [],\n  };\n}\n\n/**\n * Resolve the cookie string from various sources.\n * Priority: --cookie flag > FEISHU_COOKIE env > config file\n */\nexport function resolveCookie(flagCookie?: string): string {\n  if (flagCookie) return flagCookie;\n\n  const envCookie = process.env.FEISHU_COOKIE;\n  if (envCookie) return envCookie;\n\n  if (existsSync(CONFIG_PATH)) {\n    try {\n      const config = JSON.parse(readFileSync(CONFIG_PATH, 'utf-8'));\n      if (config.cookie) return config.cookie;\n    } catch {\n      // ignore parse errors\n    }\n  }\n\n  throw new Error(\n    'No cookie provided. Use one of:\\n' +\n    '  --cookie \"your_cookie_string\"\\n' +\n    '  FEISHU_COOKIE environment variable\\n' +\n    `  ${CONFIG_PATH} with {\"cookie\": \"...\"}`\n  );\n}\n\n/**\n * Extract the _csrf_token from a cookie string.\n */\nfunction extractCsrfToken(cookie: string): string {\n  const match = cookie.match(/_csrf_token=([^;]+)/);\n  return match ? match[1] : '';\n}\n\n/**\n * Convert clientvar block_map to ClipboardData format for larkToMarkdown.\n */\nfunction blockMapToClipboardData(data: ClientVarResponse['data']): ClipboardData {\n  const recordMap: Record<string, { id: string; snapshot: Record<string, unknown> }> = {};\n\n  for (const [id, entry] of Object.entries(data.block_map)) {\n    recordMap[id] = {\n      id: entry.id,\n      snapshot: entry.data,\n    };\n  }\n\n  return {\n    isCut: false,\n    rootId: data.id,\n    parentId: '',\n    blockIds: [],\n    recordIds: data.block_sequence || Object.keys(data.block_map),\n    recordMap: recordMap as any,\n    payloadMap: {},\n    selection: [],\n    extra: {\n      channel: '',\n      pasteRandomId: '',\n      mention_page_title: {},\n      external_mention_url: {},\n      isEqualBlockSelection: false,\n    },\n    isKeepQuoteContainer: false,\n    pasteFlag: '',\n  };\n}\n\n/**\n * Fetch a Feishu document and return it as ClipboardData.\n */\nexport async function fetchFeishuDocument(\n  url: string,\n  options: FetchOptions = {}\n): Promise<ClipboardData> {\n  const { verbose = false } = options;\n\n  const cookie = resolveCookie(options.cookie);\n  const csrfToken = extractCsrfToken(cookie);\n  const { origin, token, type } = parseFeishuUrl(url);\n\n  if (verbose) console.log(`Document type: ${type}, token: ${token}`);\n\n  // Resolve wiki token to obj_token if needed\n  let objToken = token;\n  if (type === 'wiki') {\n    if (verbose) console.log('Resolving wiki token...');\n    objToken = await resolveWikiToken(origin, token, cookie, csrfToken);\n    if (verbose) console.log(`Resolved to obj_token: ${objToken}`);\n  }\n\n  // Fetch document blocks\n  const data = await fetchClientVars(origin, objToken, cookie, csrfToken, verbose);\n\n  const blockCount = Object.keys(data.block_map).length;\n  if (verbose) console.log(`Total blocks: ${blockCount}`);\n\n  if (blockCount === 0) {\n    throw new Error('No blocks found. The document may be empty or inaccessible.');\n  }\n\n  return blockMapToClipboardData(data);\n}\n"],"mappings":"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","names":[]}

package/dist/image.d.mts

@@ -0,0 +1,30 @@
+import { ClipboardData } from './index.mjs';
+
+interface ImageMeta {
+    token: string;
+    width?: number;
+    height?: number;
+    mimeType?: string;
+    name?: string;
+}
+interface ImageDownloadOptions {
+    cookie: string;
+    domain: string;
+    outputDir: string;
+    concurrency?: number;
+    verbose?: boolean;
+}
+/**
+ * Extract image tokens and metadata from ClipboardData.
+ */
+declare function extractImageTokens(data: ClipboardData): ImageMeta[];
+/**
+ * Download a single image by token, returns the saved filename.
+ */
+declare function downloadImage(token: string, options: Pick<ImageDownloadOptions, 'cookie' | 'domain' | 'outputDir'>): Promise<string>;
+/**
+ * Download all images in batches, returns token → filename mapping.
+ */
+declare function downloadAllImages(images: ImageMeta[], options: ImageDownloadOptions): Promise<Map<string, string>>;
+
+export { type ImageDownloadOptions, type ImageMeta, downloadAllImages, downloadImage, extractImageTokens };

package/dist/image.d.ts

@@ -0,0 +1,30 @@
+import { ClipboardData } from './index.js';
+
+interface ImageMeta {
+    token: string;
+    width?: number;
+    height?: number;
+    mimeType?: string;
+    name?: string;
+}
+interface ImageDownloadOptions {
+    cookie: string;
+    domain: string;
+    outputDir: string;
+    concurrency?: number;
+    verbose?: boolean;
+}
+/**
+ * Extract image tokens and metadata from ClipboardData.
+ */
+declare function extractImageTokens(data: ClipboardData): ImageMeta[];
+/**
+ * Download a single image by token, returns the saved filename.
+ */
+declare function downloadImage(token: string, options: Pick<ImageDownloadOptions, 'cookie' | 'domain' | 'outputDir'>): Promise<string>;
+/**
+ * Download all images in batches, returns token → filename mapping.
+ */
+declare function downloadAllImages(images: ImageMeta[], options: ImageDownloadOptions): Promise<Map<string, string>>;
+
+export { type ImageDownloadOptions, type ImageMeta, downloadAllImages, downloadImage, extractImageTokens };

package/dist/image.js

@@ -0,0 +1,107 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/imageDownloader.ts
+var imageDownloader_exports = {};
+__export(imageDownloader_exports, {
+  downloadAllImages: () => downloadAllImages,
+  downloadImage: () => downloadImage,
+  extractImageTokens: () => extractImageTokens
+});
+module.exports = __toCommonJS(imageDownloader_exports);
+var import_promises = require("fs/promises");
+var import_path = require("path");
+function extractImageTokens(data) {
+  const seen = /* @__PURE__ */ new Set();
+  const images = [];
+  for (const record of Object.values(data.recordMap)) {
+    const snapshot = record.snapshot;
+    if (snapshot?.type === "image" && snapshot.image?.token) {
+      const img = snapshot.image;
+      if (seen.has(img.token)) continue;
+      seen.add(img.token);
+      images.push({
+        token: img.token,
+        width: img.width,
+        height: img.height,
+        mimeType: img.mimeType,
+        name: img.name
+      });
+    }
+  }
+  return images;
+}
+function extFromContentType(contentType) {
+  if (contentType.includes("jpeg") || contentType.includes("jpg")) return ".jpg";
+  if (contentType.includes("png")) return ".png";
+  if (contentType.includes("gif")) return ".gif";
+  if (contentType.includes("webp")) return ".webp";
+  if (contentType.includes("svg")) return ".svg";
+  return ".png";
+}
+async function downloadImage(token, options) {
+  if (!/^[a-zA-Z0-9_-]+$/.test(token)) {
+    throw new Error(`Invalid image token format: ${token}`);
+  }
+  const { cookie, domain, outputDir } = options;
+  const url = `${domain}/space/api/box/stream/download/all/${token}`;
+  const res = await fetch(url, {
+    headers: {
+      Cookie: cookie,
+      "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko)"
+    },
+    redirect: "follow"
+  });
+  if (!res.ok) throw new Error(`Failed to download image ${token}: ${res.status}`);
+  const contentType = res.headers.get("content-type") || "image/png";
+  const ext = extFromContentType(contentType);
+  const filename = `${token}${ext}`;
+  const buffer = Buffer.from(await res.arrayBuffer());
+  await (0, import_promises.writeFile)((0, import_path.join)(outputDir, filename), buffer);
+  return filename;
+}
+async function downloadAllImages(images, options) {
+  const { outputDir, concurrency = 5, verbose = false } = options;
+  await (0, import_promises.mkdir)(outputDir, { recursive: true });
+  const tokenToFile = /* @__PURE__ */ new Map();
+  for (let i = 0; i < images.length; i += concurrency) {
+    const batch = images.slice(i, i + concurrency);
+    const results = await Promise.allSettled(
+      batch.map((img) => downloadImage(img.token, options))
+    );
+    for (let j = 0; j < results.length; j++) {
+      const result = results[j];
+      const img = batch[j];
+      if (result.status === "fulfilled") {
+        tokenToFile.set(img.token, result.value);
+        if (verbose) console.log(`  Downloaded: ${img.token} \u2192 ${result.value}`);
+      } else {
+        console.warn(`  Failed to download ${img.token}: ${result.reason}`);
+      }
+    }
+  }
+  return tokenToFile;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  downloadAllImages,
+  downloadImage,
+  extractImageTokens
+});
+//# sourceMappingURL=image.js.map

package/dist/image.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/imageDownloader.ts"],"sourcesContent":["import { mkdir, writeFile } from 'fs/promises';\nimport { join } from 'path';\nimport type { ClipboardData } from './index.js';\n\nexport interface ImageMeta {\n  token: string;\n  width?: number;\n  height?: number;\n  mimeType?: string;\n  name?: string;\n}\n\nexport interface ImageDownloadOptions {\n  cookie: string;\n  domain: string;\n  outputDir: string;\n  concurrency?: number;\n  verbose?: boolean;\n}\n\n/**\n * Extract image tokens and metadata from ClipboardData.\n */\nexport function extractImageTokens(data: ClipboardData): ImageMeta[] {\n  const seen = new Set<string>();\n  const images: ImageMeta[] = [];\n  for (const record of Object.values(data.recordMap)) {\n    const snapshot = record.snapshot;\n    if (snapshot?.type === 'image' && snapshot.image?.token) {\n      const img = snapshot.image;\n      if (seen.has(img.token)) continue;\n      seen.add(img.token);\n      images.push({\n        token: img.token,\n        width: img.width,\n        height: img.height,\n        mimeType: img.mimeType,\n        name: img.name,\n      });\n    }\n  }\n  return images;\n}\n\nfunction extFromContentType(contentType: string): string {\n  if (contentType.includes('jpeg') || contentType.includes('jpg')) return '.jpg';\n  if (contentType.includes('png')) return '.png';\n  if (contentType.includes('gif')) return '.gif';\n  if (contentType.includes('webp')) return '.webp';\n  if (contentType.includes('svg')) return '.svg';\n  return '.png';\n}\n\n/**\n * Download a single image by token, returns the saved filename.\n */\nexport async function downloadImage(\n  token: string,\n  options: Pick<ImageDownloadOptions, 'cookie' | 'domain' | 'outputDir'>\n): Promise<string> {\n  if (!/^[a-zA-Z0-9_-]+$/.test(token)) {\n    throw new Error(`Invalid image token format: ${token}`);\n  }\n  const { cookie, domain, outputDir } = options;\n  const url = `${domain}/space/api/box/stream/download/all/${token}`;\n\n  const res = await fetch(url, {\n    headers: {\n      Cookie: cookie,\n      'User-Agent': 'Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko)',\n    },\n    redirect: 'follow',\n  });\n\n  if (!res.ok) throw new Error(`Failed to download image ${token}: ${res.status}`);\n\n  const contentType = res.headers.get('content-type') || 'image/png';\n  const ext = extFromContentType(contentType);\n  const filename = `${token}${ext}`;\n\n  const buffer = Buffer.from(await res.arrayBuffer());\n  await writeFile(join(outputDir, filename), buffer);\n\n  return filename;\n}\n\n/**\n * Download all images in batches, returns token → filename mapping.\n */\nexport async function downloadAllImages(\n  images: ImageMeta[],\n  options: ImageDownloadOptions\n): Promise<Map<string, string>> {\n  const { outputDir, concurrency = 5, verbose = false } = options;\n  await mkdir(outputDir, { recursive: true });\n\n  const tokenToFile = new Map<string, string>();\n\n  for (let i = 0; i < images.length; i += concurrency) {\n    const batch = images.slice(i, i + concurrency);\n    const results = await Promise.allSettled(\n      batch.map(img => downloadImage(img.token, options))\n    );\n    for (let j = 0; j < results.length; j++) {\n      const result = results[j];\n      const img = batch[j];\n      if (result.status === 'fulfilled') {\n        tokenToFile.set(img.token, result.value);\n        if (verbose) console.log(`  Downloaded: ${img.token} → ${result.value}`);\n      } else {\n        console.warn(`  Failed to download ${img.token}: ${result.reason}`);\n      }\n    }\n  }\n\n  return tokenToFile;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,sBAAiC;AACjC,kBAAqB;AAsBd,SAAS,mBAAmB,MAAkC;AACnE,QAAM,OAAO,oBAAI,IAAY;AAC7B,QAAM,SAAsB,CAAC;AAC7B,aAAW,UAAU,OAAO,OAAO,KAAK,SAAS,GAAG;AAClD,UAAM,WAAW,OAAO;AACxB,QAAI,UAAU,SAAS,WAAW,SAAS,OAAO,OAAO;AACvD,YAAM,MAAM,SAAS;AACrB,UAAI,KAAK,IAAI,IAAI,KAAK,EAAG;AACzB,WAAK,IAAI,IAAI,KAAK;AAClB,aAAO,KAAK;AAAA,QACV,OAAO,IAAI;AAAA,QACX,OAAO,IAAI;AAAA,QACX,QAAQ,IAAI;AAAA,QACZ,UAAU,IAAI;AAAA,QACd,MAAM,IAAI;AAAA,MACZ,CAAC;AAAA,IACH;AAAA,EACF;AACA,SAAO;AACT;AAEA,SAAS,mBAAmB,aAA6B;AACvD,MAAI,YAAY,SAAS,MAAM,KAAK,YAAY,SAAS,KAAK,EAAG,QAAO;AACxE,MAAI,YAAY,SAAS,KAAK,EAAG,QAAO;AACxC,MAAI,YAAY,SAAS,KAAK,EAAG,QAAO;AACxC,MAAI,YAAY,SAAS,MAAM,EAAG,QAAO;AACzC,MAAI,YAAY,SAAS,KAAK,EAAG,QAAO;AACxC,SAAO;AACT;AAKA,eAAsB,cACpB,OACA,SACiB;AACjB,MAAI,CAAC,mBAAmB,KAAK,KAAK,GAAG;AACnC,UAAM,IAAI,MAAM,+BAA+B,KAAK,EAAE;AAAA,EACxD;AACA,QAAM,EAAE,QAAQ,QAAQ,UAAU,IAAI;AACtC,QAAM,MAAM,GAAG,MAAM,sCAAsC,KAAK;AAEhE,QAAM,MAAM,MAAM,MAAM,KAAK;AAAA,IAC3B,SAAS;AAAA,MACP,QAAQ;AAAA,MACR,cAAc;AAAA,IAChB;AAAA,IACA,UAAU;AAAA,EACZ,CAAC;AAED,MAAI,CAAC,IAAI,GAAI,OAAM,IAAI,MAAM,4BAA4B,KAAK,KAAK,IAAI,MAAM,EAAE;AAE/E,QAAM,cAAc,IAAI,QAAQ,IAAI,cAAc,KAAK;AACvD,QAAM,MAAM,mBAAmB,WAAW;AAC1C,QAAM,WAAW,GAAG,KAAK,GAAG,GAAG;AAE/B,QAAM,SAAS,OAAO,KAAK,MAAM,IAAI,YAAY,CAAC;AAClD,YAAM,+BAAU,kBAAK,WAAW,QAAQ,GAAG,MAAM;AAEjD,SAAO;AACT;AAKA,eAAsB,kBACpB,QACA,SAC8B;AAC9B,QAAM,EAAE,WAAW,cAAc,GAAG,UAAU,MAAM,IAAI;AACxD,YAAM,uBAAM,WAAW,EAAE,WAAW,KAAK,CAAC;AAE1C,QAAM,cAAc,oBAAI,IAAoB;AAE5C,WAAS,IAAI,GAAG,IAAI,OAAO,QAAQ,KAAK,aAAa;AACnD,UAAM,QAAQ,OAAO,MAAM,GAAG,IAAI,WAAW;AAC7C,UAAM,UAAU,MAAM,QAAQ;AAAA,MAC5B,MAAM,IAAI,SAAO,cAAc,IAAI,OAAO,OAAO,CAAC;AAAA,IACpD;AACA,aAAS,IAAI,GAAG,IAAI,QAAQ,QAAQ,KAAK;AACvC,YAAM,SAAS,QAAQ,CAAC;AACxB,YAAM,MAAM,MAAM,CAAC;AACnB,UAAI,OAAO,WAAW,aAAa;AACjC,oBAAY,IAAI,IAAI,OAAO,OAAO,KAAK;AACvC,YAAI,QAAS,SAAQ,IAAI,iBAAiB,IAAI,KAAK,WAAM,OAAO,KAAK,EAAE;AAAA,MACzE,OAAO;AACL,gBAAQ,KAAK,wBAAwB,IAAI,KAAK,KAAK,OAAO,MAAM,EAAE;AAAA,MACpE;AAAA,IACF;AAAA,EACF;AAEA,SAAO;AACT;","names":[]}