growork 1.0.0

package/tests/feishu.test.ts

@@ -0,0 +1,345 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+
+// 复制 FeishuService 中的纯函数进行测试
+
+function parseDocumentId(url: string): { type: 'docx' | 'wiki'; documentId: string } {
+  const docxMatch = url.match(/\/docx\/([a-zA-Z0-9]+)/);
+  if (docxMatch) {
+    return { type: 'docx', documentId: docxMatch[1] };
+  }
+
+  const wikiMatch = url.match(/\/wiki\/([a-zA-Z0-9]+)/);
+  if (wikiMatch) {
+    return { type: 'wiki', documentId: wikiMatch[1] };
+  }
+
+  throw new Error(`无法解析飞书文档 URL: ${url}`);
+}
+
+function getLanguageName(langCode: number): string {
+  const langMap: Record<number, string> = {
+    1: 'plaintext', 7: 'bash', 9: 'cpp', 10: 'c',
+    15: 'dart', 22: 'go', 28: 'json', 29: 'java', 30: 'javascript',
+    32: 'kotlin', 47: 'python', 50: 'ruby', 51: 'rust',
+    54: 'sql', 58: 'shell', 59: 'swift', 61: 'typescript', 65: 'yaml',
+  };
+  return langMap[langCode] || '';
+}
+
+function textElementsToMarkdown(elements: any[] | undefined): string {
+  if (!elements) return '';
+
+  return elements.map(el => {
+    if (el.text_run) {
+      let text = el.text_run.content || '';
+      const style = el.text_run.text_element_style;
+
+      if (style?.bold) text = `**${text}**`;
+      if (style?.italic) text = `*${text}*`;
+      if (style?.strikethrough) text = `~~${text}~~`;
+      if (style?.inline_code) text = `\`${text}\``;
+      if (style?.link?.url) text = `[${text}](${style.link.url})`;
+
+      return text;
+    }
+    if (el.mention_user) {
+      return `@${el.mention_user.user_id || 'user'}`;
+    }
+    if (el.mention_doc) {
+      const title = el.mention_doc.title || '文档';
+      const url = el.mention_doc.url || '';
+      return `[${title}](${url})`;
+    }
+    return '';
+  }).join('');
+}
+
+describe('飞书 URL 解析', () => {
+  describe('docx 格式', () => {
+    it('应解析 feishu.cn docx URL', () => {
+      const result = parseDocumentId('https://xxx.feishu.cn/docx/abc123def');
+      assert.strictEqual(result.type, 'docx');
+      assert.strictEqual(result.documentId, 'abc123def');
+    });
+
+    it('应解析 larksuite.com docx URL', () => {
+      const result = parseDocumentId('https://xxx.larksuite.com/docx/XYZ789');
+      assert.strictEqual(result.type, 'docx');
+      assert.strictEqual(result.documentId, 'XYZ789');
+    });
+
+    it('应解析带查询参数的 docx URL', () => {
+      const result = parseDocumentId('https://xxx.feishu.cn/docx/abc123?from=share');
+      assert.strictEqual(result.type, 'docx');
+      assert.strictEqual(result.documentId, 'abc123');
+    });
+  });
+
+  describe('wiki 格式', () => {
+    it('应解析 feishu.cn wiki URL', () => {
+      const result = parseDocumentId('https://xxx.feishu.cn/wiki/node123');
+      assert.strictEqual(result.type, 'wiki');
+      assert.strictEqual(result.documentId, 'node123');
+    });
+
+    it('应解析 larksuite.com wiki URL', () => {
+      const result = parseDocumentId('https://xxx.larksuite.com/wiki/WikiToken456');
+      assert.strictEqual(result.type, 'wiki');
+      assert.strictEqual(result.documentId, 'WikiToken456');
+    });
+  });
+
+  describe('无效 URL', () => {
+    it('应拒绝不支持的 URL 格式', () => {
+      assert.throws(
+        () => parseDocumentId('https://xxx.feishu.cn/docs/abc123'),
+        /无法解析飞书文档 URL/
+      );
+    });
+
+    it('只检查路径格式，不验证域名', () => {
+      // 当前实现不验证域名，只检查路径中是否有 /docx/ 或 /wiki/
+      const result = parseDocumentId('https://example.com/docx/abc123');
+      assert.strictEqual(result.documentId, 'abc123');
+    });
+
+    it('应拒绝空路径', () => {
+      assert.throws(
+        () => parseDocumentId('https://xxx.feishu.cn/'),
+        /无法解析飞书文档 URL/
+      );
+    });
+  });
+});
+
+describe('语言代码映射', () => {
+  it('应返回正确的语言名称', () => {
+    assert.strictEqual(getLanguageName(47), 'python');
+    assert.strictEqual(getLanguageName(30), 'javascript');
+    assert.strictEqual(getLanguageName(61), 'typescript');
+    assert.strictEqual(getLanguageName(22), 'go');
+    assert.strictEqual(getLanguageName(51), 'rust');
+  });
+
+  it('应对未知代码返回空字符串', () => {
+    assert.strictEqual(getLanguageName(999), '');
+    assert.strictEqual(getLanguageName(0), '');
+  });
+});
+
+describe('文本元素转 Markdown', () => {
+  it('应处理普通文本', () => {
+    const elements = [{ text_run: { content: 'Hello World' } }];
+    assert.strictEqual(textElementsToMarkdown(elements), 'Hello World');
+  });
+
+  it('应处理粗体文本', () => {
+    const elements = [{
+      text_run: {
+        content: 'Bold',
+        text_element_style: { bold: true }
+      }
+    }];
+    assert.strictEqual(textElementsToMarkdown(elements), '**Bold**');
+  });
+
+  it('应处理斜体文本', () => {
+    const elements = [{
+      text_run: {
+        content: 'Italic',
+        text_element_style: { italic: true }
+      }
+    }];
+    assert.strictEqual(textElementsToMarkdown(elements), '*Italic*');
+  });
+
+  it('应处理删除线文本', () => {
+    const elements = [{
+      text_run: {
+        content: 'Strikethrough',
+        text_element_style: { strikethrough: true }
+      }
+    }];
+    assert.strictEqual(textElementsToMarkdown(elements), '~~Strikethrough~~');
+  });
+
+  it('应处理行内代码', () => {
+    const elements = [{
+      text_run: {
+        content: 'code',
+        text_element_style: { inline_code: true }
+      }
+    }];
+    assert.strictEqual(textElementsToMarkdown(elements), '`code`');
+  });
+
+  it('应处理链接', () => {
+    const elements = [{
+      text_run: {
+        content: 'Click here',
+        text_element_style: { link: { url: 'https://example.com' } }
+      }
+    }];
+    assert.strictEqual(textElementsToMarkdown(elements), '[Click here](https://example.com)');
+  });
+
+  it('应处理组合样式', () => {
+    const elements = [{
+      text_run: {
+        content: 'Bold Italic',
+        text_element_style: { bold: true, italic: true }
+      }
+    }];
+    assert.strictEqual(textElementsToMarkdown(elements), '***Bold Italic***');
+  });
+
+  it('应处理多个元素', () => {
+    const elements = [
+      { text_run: { content: 'Normal ' } },
+      { text_run: { content: 'Bold', text_element_style: { bold: true } } },
+      { text_run: { content: ' text' } }
+    ];
+    assert.strictEqual(textElementsToMarkdown(elements), 'Normal **Bold** text');
+  });
+
+  it('应处理 @用户', () => {
+    const elements = [{ mention_user: { user_id: 'user123' } }];
+    assert.strictEqual(textElementsToMarkdown(elements), '@user123');
+  });
+
+  it('应处理文档引用', () => {
+    const elements = [{
+      mention_doc: { title: 'My Doc', url: 'https://xxx.feishu.cn/docx/abc' }
+    }];
+    assert.strictEqual(textElementsToMarkdown(elements), '[My Doc](https://xxx.feishu.cn/docx/abc)');
+  });
+
+  it('应处理 undefined 输入', () => {
+    assert.strictEqual(textElementsToMarkdown(undefined), '');
+  });
+
+  it('应处理空数组', () => {
+    assert.strictEqual(textElementsToMarkdown([]), '');
+  });
+});
+
+describe('Block 转 Markdown', () => {
+  // 模拟 blockToMarkdown 的核心逻辑
+  function blockToMarkdown(block: any): string | null {
+    const blockType = block.block_type;
+
+    switch (blockType) {
+      case 2: // Text
+        const text = textElementsToMarkdown(block.text?.elements);
+        return text ? text + '\n' : '';
+      case 3: // Heading1
+        return `# ${textElementsToMarkdown(block.heading1?.elements)}\n`;
+      case 4: // Heading2
+        return `## ${textElementsToMarkdown(block.heading2?.elements)}\n`;
+      case 5: // Heading3
+        return `### ${textElementsToMarkdown(block.heading3?.elements)}\n`;
+      case 12: // Bullet
+        return `- ${textElementsToMarkdown(block.bullet?.elements)}`;
+      case 13: // Ordered
+        return `1. ${textElementsToMarkdown(block.ordered?.elements)}`;
+      case 14: // Code
+        const lang = getLanguageName(block.code?.style?.language || 0);
+        const codeText = textElementsToMarkdown(block.code?.elements);
+        return `\`\`\`${lang}\n${codeText}\n\`\`\`\n`;
+      case 15: // Quote
+        return `> ${textElementsToMarkdown(block.quote?.elements)}\n`;
+      case 17: // TodoList
+        const checked = block.todo?.style?.done ? 'x' : ' ';
+        return `- [${checked}] ${textElementsToMarkdown(block.todo?.elements)}`;
+      case 18: // Divider
+        return '---\n';
+      default:
+        return null;
+    }
+  }
+
+  it('应转换文本块', () => {
+    const block = {
+      block_type: 2,
+      text: { elements: [{ text_run: { content: 'Hello' } }] }
+    };
+    assert.strictEqual(blockToMarkdown(block), 'Hello\n');
+  });
+
+  it('应转换各级标题', () => {
+    assert.strictEqual(
+      blockToMarkdown({ block_type: 3, heading1: { elements: [{ text_run: { content: 'H1' } }] } }),
+      '# H1\n'
+    );
+    assert.strictEqual(
+      blockToMarkdown({ block_type: 4, heading2: { elements: [{ text_run: { content: 'H2' } }] } }),
+      '## H2\n'
+    );
+    assert.strictEqual(
+      blockToMarkdown({ block_type: 5, heading3: { elements: [{ text_run: { content: 'H3' } }] } }),
+      '### H3\n'
+    );
+  });
+
+  it('应转换无序列表', () => {
+    const block = {
+      block_type: 12,
+      bullet: { elements: [{ text_run: { content: 'Item' } }] }
+    };
+    assert.strictEqual(blockToMarkdown(block), '- Item');
+  });
+
+  it('应转换有序列表', () => {
+    const block = {
+      block_type: 13,
+      ordered: { elements: [{ text_run: { content: 'First' } }] }
+    };
+    assert.strictEqual(blockToMarkdown(block), '1. First');
+  });
+
+  it('应转换代码块', () => {
+    const block = {
+      block_type: 14,
+      code: {
+        elements: [{ text_run: { content: 'console.log("hi")' } }],
+        style: { language: 30 }
+      }
+    };
+    assert.strictEqual(blockToMarkdown(block), '```javascript\nconsole.log("hi")\n```\n');
+  });
+
+  it('应转换引用块', () => {
+    const block = {
+      block_type: 15,
+      quote: { elements: [{ text_run: { content: 'Quote text' } }] }
+    };
+    assert.strictEqual(blockToMarkdown(block), '> Quote text\n');
+  });
+
+  it('应转换待办事项（未完成）', () => {
+    const block = {
+      block_type: 17,
+      todo: {
+        elements: [{ text_run: { content: 'Todo item' } }],
+        style: { done: false }
+      }
+    };
+    assert.strictEqual(blockToMarkdown(block), '- [ ] Todo item');
+  });
+
+  it('应转换待办事项（已完成）', () => {
+    const block = {
+      block_type: 17,
+      todo: {
+        elements: [{ text_run: { content: 'Done item' } }],
+        style: { done: true }
+      }
+    };
+    assert.strictEqual(blockToMarkdown(block), '- [x] Done item');
+  });
+
+  it('应转换分割线', () => {
+    assert.strictEqual(blockToMarkdown({ block_type: 18 }), '---\n');
+  });
+});

package/tests/notion.test.ts

@@ -0,0 +1,273 @@
+import { describe, it } from 'node:test';
+import assert from 'node:assert';
+
+// 复制 NotionService 中的纯函数进行测试
+
+function parsePageId(url: string): string {
+  const match = url.match(/([a-f0-9]{32})|([a-f0-9]{8}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{4}-[a-f0-9]{12})/i);
+  if (!match) {
+    throw new Error(`无法解析 Notion 页面 URL: ${url}`);
+  }
+  return match[0].replace(/-/g, '');
+}
+
+function extractPropertyValue(prop: any): string {
+  if (!prop) return '';
+  switch (prop.type) {
+    case 'title':
+      return prop.title?.map((t: any) => t.plain_text).join('') || '';
+    case 'rich_text':
+      return prop.rich_text?.map((t: any) => t.plain_text).join('') || '';
+    case 'select':
+      return prop.select?.name || '';
+    case 'multi_select':
+      return prop.multi_select?.map((s: any) => s.name).join(', ') || '';
+    case 'number':
+      return prop.number?.toString() ?? '';
+    case 'checkbox':
+      return prop.checkbox ? '✓' : '';
+    case 'date':
+      return prop.date?.start || '';
+    case 'url':
+      return prop.url || '';
+    case 'files':
+      return prop.files?.map((f: any) => f.name || 'file').join(', ') || '';
+    default:
+      return '';
+  }
+}
+
+describe('Notion URL 解析', () => {
+  describe('标准 32 字符 ID', () => {
+    it('应解析简单 URL', () => {
+      const result = parsePageId('https://www.notion.so/abc123def456789012345678901234ab');
+      assert.strictEqual(result, 'abc123def456789012345678901234ab');
+    });
+
+    it('应解析带工作区前缀的 URL', () => {
+      const result = parsePageId('https://www.notion.so/myworkspace/Page-Title-abc123def456789012345678901234ab');
+      assert.strictEqual(result, 'abc123def456789012345678901234ab');
+    });
+
+    it('应解析带查询参数的 URL', () => {
+      const result = parsePageId('https://www.notion.so/abc123def456789012345678901234ab?v=viewid123');
+      assert.strictEqual(result, 'abc123def456789012345678901234ab');
+    });
+
+    it('应解析 notion.so 域名（无 www）', () => {
+      const result = parsePageId('https://notion.so/abc123def456789012345678901234ab');
+      assert.strictEqual(result, 'abc123def456789012345678901234ab');
+    });
+  });
+
+  describe('UUID 格式 (带连字符)', () => {
+    it('应解析 UUID 格式并移除连字符', () => {
+      const result = parsePageId('https://www.notion.so/abc12345-6789-0abc-def1-234567890123');
+      assert.strictEqual(result, 'abc1234567890abcdef1234567890123');
+    });
+
+    it('应解析带标题的 UUID URL', () => {
+      const result = parsePageId('https://www.notion.so/workspace/My-Page-abc12345-6789-0abc-def1-234567890123');
+      assert.strictEqual(result, 'abc1234567890abcdef1234567890123');
+    });
+  });
+
+  describe('无效 URL', () => {
+    it('应拒绝没有 ID 的 URL', () => {
+      assert.throws(
+        () => parsePageId('https://www.notion.so/'),
+        /无法解析 Notion 页面 URL/
+      );
+    });
+
+    it('应拒绝 ID 太短的 URL', () => {
+      assert.throws(
+        () => parsePageId('https://www.notion.so/abc123'),
+        /无法解析 Notion 页面 URL/
+      );
+    });
+
+    it('只检查 ID 格式，不验证域名', () => {
+      // 当前实现不验证域名，只检查是否存在 32 位十六进制 ID
+      const result = parsePageId('https://example.com/abc123def456789012345678901234ab');
+      assert.strictEqual(result, 'abc123def456789012345678901234ab');
+    });
+
+    it('应拒绝包含非法字符的 ID', () => {
+      assert.throws(
+        () => parsePageId('https://www.notion.so/xyz!@#$%^&*()'),
+        /无法解析 Notion 页面 URL/
+      );
+    });
+  });
+});
+
+describe('Notion 属性值提取', () => {
+  describe('title 属性', () => {
+    it('应提取 title 文本', () => {
+      const prop = {
+        type: 'title',
+        title: [{ plain_text: 'Page Title' }]
+      };
+      assert.strictEqual(extractPropertyValue(prop), 'Page Title');
+    });
+
+    it('应合并多个 title 片段', () => {
+      const prop = {
+        type: 'title',
+        title: [{ plain_text: 'Hello ' }, { plain_text: 'World' }]
+      };
+      assert.strictEqual(extractPropertyValue(prop), 'Hello World');
+    });
+
+    it('应处理空 title', () => {
+      const prop = { type: 'title', title: [] };
+      assert.strictEqual(extractPropertyValue(prop), '');
+    });
+  });
+
+  describe('rich_text 属性', () => {
+    it('应提取富文本', () => {
+      const prop = {
+        type: 'rich_text',
+        rich_text: [{ plain_text: 'Some text' }]
+      };
+      assert.strictEqual(extractPropertyValue(prop), 'Some text');
+    });
+  });
+
+  describe('select 属性', () => {
+    it('应提取选项名称', () => {
+      const prop = {
+        type: 'select',
+        select: { name: 'Option A' }
+      };
+      assert.strictEqual(extractPropertyValue(prop), 'Option A');
+    });
+
+    it('应处理空选择', () => {
+      const prop = { type: 'select', select: null };
+      assert.strictEqual(extractPropertyValue(prop), '');
+    });
+  });
+
+  describe('multi_select 属性', () => {
+    it('应提取多个选项', () => {
+      const prop = {
+        type: 'multi_select',
+        multi_select: [{ name: 'Tag1' }, { name: 'Tag2' }, { name: 'Tag3' }]
+      };
+      assert.strictEqual(extractPropertyValue(prop), 'Tag1, Tag2, Tag3');
+    });
+
+    it('应处理空多选', () => {
+      const prop = { type: 'multi_select', multi_select: [] };
+      assert.strictEqual(extractPropertyValue(prop), '');
+    });
+  });
+
+  describe('number 属性', () => {
+    it('应转换数字为字符串', () => {
+      const prop = { type: 'number', number: 42 };
+      assert.strictEqual(extractPropertyValue(prop), '42');
+    });
+
+    it('应处理浮点数', () => {
+      const prop = { type: 'number', number: 3.14 };
+      assert.strictEqual(extractPropertyValue(prop), '3.14');
+    });
+
+    it('应处理零', () => {
+      const prop = { type: 'number', number: 0 };
+      assert.strictEqual(extractPropertyValue(prop), '0');
+    });
+
+    it('应处理 null 数字', () => {
+      const prop = { type: 'number', number: null };
+      assert.strictEqual(extractPropertyValue(prop), '');
+    });
+  });
+
+  describe('checkbox 属性', () => {
+    it('应返回勾选标记', () => {
+      const prop = { type: 'checkbox', checkbox: true };
+      assert.strictEqual(extractPropertyValue(prop), '✓');
+    });
+
+    it('应返回空字符串表示未勾选', () => {
+      const prop = { type: 'checkbox', checkbox: false };
+      assert.strictEqual(extractPropertyValue(prop), '');
+    });
+  });
+
+  describe('date 属性', () => {
+    it('应提取开始日期', () => {
+      const prop = {
+        type: 'date',
+        date: { start: '2024-01-15' }
+      };
+      assert.strictEqual(extractPropertyValue(prop), '2024-01-15');
+    });
+
+    it('应处理带时间的日期', () => {
+      const prop = {
+        type: 'date',
+        date: { start: '2024-01-15T10:30:00' }
+      };
+      assert.strictEqual(extractPropertyValue(prop), '2024-01-15T10:30:00');
+    });
+
+    it('应处理空日期', () => {
+      const prop = { type: 'date', date: null };
+      assert.strictEqual(extractPropertyValue(prop), '');
+    });
+  });
+
+  describe('url 属性', () => {
+    it('应提取 URL', () => {
+      const prop = {
+        type: 'url',
+        url: 'https://example.com'
+      };
+      assert.strictEqual(extractPropertyValue(prop), 'https://example.com');
+    });
+
+    it('应处理空 URL', () => {
+      const prop = { type: 'url', url: null };
+      assert.strictEqual(extractPropertyValue(prop), '');
+    });
+  });
+
+  describe('files 属性', () => {
+    it('应提取文件名', () => {
+      const prop = {
+        type: 'files',
+        files: [{ name: 'doc.pdf' }, { name: 'image.png' }]
+      };
+      assert.strictEqual(extractPropertyValue(prop), 'doc.pdf, image.png');
+    });
+
+    it('应处理无文件名的情况', () => {
+      const prop = {
+        type: 'files',
+        files: [{ url: 'https://...' }]
+      };
+      assert.strictEqual(extractPropertyValue(prop), 'file');
+    });
+  });
+
+  describe('边界情况', () => {
+    it('应处理 null 属性', () => {
+      assert.strictEqual(extractPropertyValue(null), '');
+    });
+
+    it('应处理 undefined 属性', () => {
+      assert.strictEqual(extractPropertyValue(undefined), '');
+    });
+
+    it('应处理未知属性类型', () => {
+      const prop = { type: 'unknown_type', value: 'test' };
+      assert.strictEqual(extractPropertyValue(prop), '');
+    });
+  });
+});

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2020",
+    "module": "ESNext",
+    "moduleResolution": "node",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "declaration": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}