@moxn/kb-migrate 0.4.10 → 0.4.12

package/dist/targets/notion.js

@@ -62,17 +62,11 @@ function stripInvalidLinks(text) {
         return displayText;
     });
 }
-/**
- * Convert a KB document's sections into a single markdown string.
- * Section names become H2 headings (mirrors the import convention).
- *
- * If extractReferences is true, also extracts KB path references from
- * the content and returns them separately (for two-pass export).
- */
 function sectionsToMarkdown(sections, options) {
     const parts = [];
     const allReferences = [];
     const databaseIds = [];
+    const media = [];
     const extractRefs = options?.extractReferences ?? false;
     for (const section of sections) {
         parts.push(`## ${section.name}\n`);
@@ -91,15 +85,21 @@ function sectionsToMarkdown(sections, options) {
                 parts.push('');
             }
             else if (block.blockType === 'image' && block.url) {
-                parts.push(`![${block.alt || ''}](${block.url})`);
+                const token = `MOXNMEDIA${media.length}PLACEHOLDER`;
+                media.push({ token, type: 'image', url: block.url, alt: block.alt });
+                parts.push(token);
                 parts.push('');
             }
             else if (block.blockType === 'document' && block.url) {
-                parts.push(`[${block.filename || 'document'}](${block.url})`);
+                const token = `MOXNMEDIA${media.length}PLACEHOLDER`;
+                media.push({ token, type: 'file', url: block.url, filename: block.filename });
+                parts.push(token);
                 parts.push('');
             }
             else if (block.blockType === 'csv' && block.url) {
-                parts.push(`[${block.filename || 'data.csv'}](${block.url})`);
+                const token = `MOXNMEDIA${media.length}PLACEHOLDER`;
+                media.push({ token, type: 'embed', url: block.url, filename: block.filename || 'data.csv' });
+                parts.push(token);
                 parts.push('');
             }
             else if (block.blockType === 'database_embed' && block.databaseId) {
@@ -111,7 +111,60 @@ function sectionsToMarkdown(sections, options) {
             }
         }
     }
-    return { markdown: parts.join('\n').trim(), references: allReferences, databaseIds };
+    return { markdown: parts.join('\n').trim(), references: allReferences, databaseIds, media };
+}
+/**
+ * Replace media placeholder paragraphs in Notion blocks with proper
+ * image/file/embed blocks. Martian doesn't support images, so we
+ * post-process the converted blocks.
+ */
+function injectMediaBlocks(blocks, media) {
+    if (media.length === 0)
+        return blocks;
+    // Build a lookup from token to media info
+    const tokenMap = new Map(media.map((m) => [m.token, m]));
+    return blocks.map((block) => {
+        // Check if this is a paragraph containing a media placeholder
+        const b = block;
+        if (b.type !== 'paragraph' || !b.paragraph?.rich_text)
+            return block;
+        const text = b.paragraph.rich_text.map((rt) => rt.text?.content ?? '').join('').trim();
+        const mediaInfo = tokenMap.get(text);
+        if (!mediaInfo)
+            return block;
+        // Replace with proper Notion block
+        if (mediaInfo.type === 'image') {
+            return {
+                object: 'block',
+                type: 'image',
+                image: {
+                    type: 'external',
+                    external: { url: mediaInfo.url },
+                    ...(mediaInfo.alt ? { caption: [{ type: 'text', text: { content: mediaInfo.alt } }] } : {}),
+                },
+            };
+        }
+        if (mediaInfo.type === 'file') {
+            return {
+                object: 'block',
+                type: 'file',
+                file: {
+                    type: 'external',
+                    external: { url: mediaInfo.url },
+                    caption: [{ type: 'text', text: { content: mediaInfo.filename || 'document' } }],
+                },
+            };
+        }
+        // For CSV/embeds, use a bookmark block (Notion doesn't have native CSV embed)
+        return {
+            object: 'block',
+            type: 'bookmark',
+            bookmark: {
+                url: mediaInfo.url,
+                caption: [{ type: 'text', text: { content: mediaInfo.filename || 'file' } }],
+            },
+        };
+    });
 }
 // Max 100 blocks per API call
 const MAX_BLOCKS_PER_APPEND = 100;
@@ -360,8 +413,8 @@ export class NotionExportTarget extends ExportTarget {
     // Notion page creation / update
     // ============================================
     async createNotionPage(doc) {
-        const { markdown } = sectionsToMarkdown(doc.sections, { extractReferences: true });
-        const blocks = markdownToBlocks(markdown);
+        const { markdown, media } = sectionsToMarkdown(doc.sections, { extractReferences: true });
+        const blocks = injectMediaBlocks(markdownToBlocks(markdown), media);
         // First batch: up to 100 blocks as children of the new page
         const firstBatch = blocks.slice(0, MAX_BLOCKS_PER_APPEND);
         const remainingBlocks = blocks.slice(MAX_BLOCKS_PER_APPEND);
@@ -393,8 +446,8 @@ export class NotionExportTarget extends ExportTarget {
             },
         });
         await this.clearPageContent(notionPageId);
-        const { markdown } = sectionsToMarkdown(doc.sections, { extractReferences: true });
-        const blocks = markdownToBlocks(markdown);
+        const { markdown, media } = sectionsToMarkdown(doc.sections, { extractReferences: true });
+        const blocks = injectMediaBlocks(markdownToBlocks(markdown), media);
         await this.appendRemainingBlocks(notionPageId, blocks);
     }
     async clearPageContent(pageId) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@moxn/kb-migrate",
-  "version": "0.4.10",
+  "version": "0.4.12",
   "description": "Migration tool for importing documents into Moxn Knowledge Base from local files, Notion, Google Docs, and more",
   "type": "module",
   "main": "dist/index.js",