fix: page import task (#1551)

* fix import

* - fix notion importer
- support notion page icon import
- fix horizontal rule css
- rename service file

* sync

* 3 mins delay
This commit is contained in:
Philip Okugbe
2025-09-13 03:14:59 +01:00
committed by GitHub
parent 47c54174b3
commit 7ada3cb1f9
7 changed files with 253 additions and 202 deletions
@@ -94,8 +94,7 @@
hr { hr {
border: none; border: none;
border-top: 2px solid #ced4da; border-top: 1px solid #ced4da;
margin: 2rem 0;
&:hover { &:hover {
cursor: pointer; cursor: pointer;
@@ -2,7 +2,7 @@ import { Module } from '@nestjs/common';
import { ImportService } from './services/import.service'; import { ImportService } from './services/import.service';
import { ImportController } from './import.controller'; import { ImportController } from './import.controller';
import { StorageModule } from '../storage/storage.module'; import { StorageModule } from '../storage/storage.module';
import { FileTaskService } from './services/file-task.service'; import { FileImportTaskService } from './services/file-import-task.service';
import { FileTaskProcessor } from './processors/file-task.processor'; import { FileTaskProcessor } from './processors/file-task.processor';
import { ImportAttachmentService } from './services/import-attachment.service'; import { ImportAttachmentService } from './services/import-attachment.service';
import { FileTaskController } from './file-task.controller'; import { FileTaskController } from './file-task.controller';
@@ -11,7 +11,7 @@ import { PageModule } from '../../core/page/page.module';
@Module({ @Module({
providers: [ providers: [
ImportService, ImportService,
FileTaskService, FileImportTaskService,
FileTaskProcessor, FileTaskProcessor,
ImportAttachmentService, ImportAttachmentService,
], ],
@@ -2,7 +2,7 @@ import { Logger, OnModuleDestroy } from '@nestjs/common';
import { OnWorkerEvent, Processor, WorkerHost } from '@nestjs/bullmq'; import { OnWorkerEvent, Processor, WorkerHost } from '@nestjs/bullmq';
import { Job } from 'bullmq'; import { Job } from 'bullmq';
import { QueueJob, QueueName } from 'src/integrations/queue/constants'; import { QueueJob, QueueName } from 'src/integrations/queue/constants';
import { FileTaskService } from '../services/file-task.service'; import { FileImportTaskService } from '../services/file-import-task.service';
import { FileTaskStatus } from '../utils/file.utils'; import { FileTaskStatus } from '../utils/file.utils';
import { StorageService } from '../../storage/storage.service'; import { StorageService } from '../../storage/storage.service';
@@ -11,7 +11,7 @@ export class FileTaskProcessor extends WorkerHost implements OnModuleDestroy {
private readonly logger = new Logger(FileTaskProcessor.name); private readonly logger = new Logger(FileTaskProcessor.name);
constructor( constructor(
private readonly fileTaskService: FileTaskService, private readonly fileTaskService: FileImportTaskService,
private readonly storageService: StorageService, private readonly storageService: StorageService,
) { ) {
super(); super();
@@ -33,8 +33,8 @@ import { PageService } from '../../../core/page/services/page.service';
import { ImportPageNode } from '../dto/file-task-dto'; import { ImportPageNode } from '../dto/file-task-dto';
@Injectable() @Injectable()
export class FileTaskService { export class FileImportTaskService {
private readonly logger = new Logger(FileTaskService.name); private readonly logger = new Logger(FileImportTaskService.name);
constructor( constructor(
private readonly storageService: StorageService, private readonly storageService: StorageService,
@@ -266,7 +266,7 @@ export class FileTaskService {
attachmentCandidates, attachmentCandidates,
}); });
const { html, backlinks } = await formatImportHtml({ const { html, backlinks, pageIcon } = await formatImportHtml({
html: htmlContent, html: htmlContent,
currentFilePath: page.filePath, currentFilePath: page.filePath,
filePathToPageMetaMap: filePathToPageMetaMap, filePathToPageMetaMap: filePathToPageMetaMap,
@@ -286,6 +286,7 @@ export class FileTaskService {
id: page.id, id: page.id,
slugId: page.slugId, slugId: page.slugId,
title: title || page.name, title: title || page.name,
icon: pageIcon || null,
content: prosemirrorJson, content: prosemirrorJson,
textContent: jsonToText(prosemirrorJson), textContent: jsonToText(prosemirrorJson),
ydoc: await this.importService.createYdoc(prosemirrorJson), ydoc: await this.importService.createYdoc(prosemirrorJson),
@@ -35,7 +35,7 @@ interface DrawioPair {
@Injectable() @Injectable()
export class ImportAttachmentService { export class ImportAttachmentService {
private readonly logger = new Logger(ImportAttachmentService.name); private readonly logger = new Logger(ImportAttachmentService.name);
private readonly CONCURRENT_UPLOADS = 3; private readonly CONCURRENT_UPLOADS = 5;
private readonly MAX_RETRIES = 2; private readonly MAX_RETRIES = 2;
private readonly RETRY_DELAY = 2000; private readonly RETRY_DELAY = 2000;
@@ -53,6 +53,7 @@ export class ImportAttachmentService {
fileTask: FileTask; fileTask: FileTask;
attachmentCandidates: Map<string, string>; attachmentCandidates: Map<string, string>;
pageAttachments?: AttachmentInfo[]; pageAttachments?: AttachmentInfo[];
isConfluenceImport?: boolean;
}): Promise<string> { }): Promise<string> {
const { const {
html, html,
@@ -62,6 +63,7 @@ export class ImportAttachmentService {
fileTask, fileTask,
attachmentCandidates, attachmentCandidates,
pageAttachments = [], pageAttachments = [],
isConfluenceImport,
} = opts; } = opts;
const attachmentTasks: (() => Promise<void>)[] = []; const attachmentTasks: (() => Promise<void>)[] = [];
@@ -90,7 +92,10 @@ export class ImportAttachmentService {
>(); >();
// Analyze attachments to identify Draw.io pairs // Analyze attachments to identify Draw.io pairs
const { drawioPairs, skipFiles } = this.analyzeAttachments(pageAttachments); const { drawioPairs, skipFiles } = this.analyzeAttachments(
pageAttachments,
isConfluenceImport,
);
// Map to store processed Draw.io SVGs // Map to store processed Draw.io SVGs
const drawioSvgMap = new Map< const drawioSvgMap = new Map<
@@ -235,49 +240,17 @@ export class ImportAttachmentService {
const pageDir = path.dirname(pageRelativePath); const pageDir = path.dirname(pageRelativePath);
const $ = load(html); const $ = load(html);
// Cache for resolved paths to avoid repeated lookups // image
const resolvedPathCache = new Map<string, string | null>(); for (const imgEl of $('img').toArray()) {
const $img = $(imgEl);
const src = cleanUrlString($img.attr('src') ?? '')!;
if (!src || src.startsWith('http')) continue;
const getCachedResolvedPath = (rawPath: string): string | null => { const relPath = resolveRelativeAttachmentPath(
if (resolvedPathCache.has(rawPath)) { src,
return resolvedPathCache.get(rawPath)!;
}
const resolved = resolveRelativeAttachmentPath(
rawPath,
pageDir, pageDir,
attachmentCandidates, attachmentCandidates,
); );
resolvedPathCache.set(rawPath, resolved);
return resolved;
};
// Cache for file stats to avoid repeated file system calls
const statCache = new Map<string, any>();
const getCachedStat = async (absPath: string) => {
if (statCache.has(absPath)) {
return statCache.get(absPath);
}
const stat = await fs.stat(absPath);
statCache.set(absPath, stat);
return stat;
};
// Single DOM traversal for all attachment elements
const selector =
'img, video, div[data-type="attachment"], a, div[data-type="excalidraw"], div[data-type="drawio"]';
const elements = $(selector).toArray();
for (const element of elements) {
const $el = $(element);
const tagName = element.tagName.toLowerCase();
// Process based on element type
if (tagName === 'img') {
const src = cleanUrlString($el.attr('src') ?? '');
if (!src || src.startsWith('http')) continue;
const relPath = getCachedResolvedPath(src);
if (!relPath) continue; if (!relPath) continue;
// Check if this image is part of a Draw.io pair // Check if this image is part of a Draw.io pair
@@ -291,52 +264,66 @@ export class ImportAttachmentService {
.attr('data-align', 'center') .attr('data-align', 'center')
.attr('data-attachment-id', drawioSvg.attachmentId); .attr('data-attachment-id', drawioSvg.attachmentId);
$el.replaceWith($drawio); $img.replaceWith($drawio);
unwrapFromParagraph($, $drawio); unwrapFromParagraph($, $drawio);
continue; continue;
} }
const { attachmentId, apiFilePath, abs } = processFile(relPath); const { attachmentId, apiFilePath } = processFile(relPath);
const stat = await getCachedStat(abs);
$el const width = $img.attr('width') ?? '100%';
const align = $img.attr('data-align') ?? 'center';
$img
.attr('src', apiFilePath) .attr('src', apiFilePath)
.attr('data-attachment-id', attachmentId) .attr('data-attachment-id', attachmentId)
.attr('data-size', stat.size.toString()) .attr('width', width)
.attr('width', $el.attr('width') ?? '100%') .attr('data-align', align);
.attr('data-align', $el.attr('data-align') ?? 'center');
unwrapFromParagraph($, $el); unwrapFromParagraph($, $img);
} else if (tagName === 'video') { }
const src = cleanUrlString($el.attr('src') ?? '');
// video
for (const vidEl of $('video').toArray()) {
const $vid = $(vidEl);
const src = cleanUrlString($vid.attr('src') ?? '')!;
if (!src || src.startsWith('http')) continue; if (!src || src.startsWith('http')) continue;
const relPath = getCachedResolvedPath(src); const relPath = resolveRelativeAttachmentPath(
src,
pageDir,
attachmentCandidates,
);
if (!relPath) continue; if (!relPath) continue;
const { attachmentId, apiFilePath, abs } = processFile(relPath); const { attachmentId, apiFilePath } = processFile(relPath);
const stat = await getCachedStat(abs);
$el const width = $vid.attr('width') ?? '100%';
const align = $vid.attr('data-align') ?? 'center';
$vid
.attr('src', apiFilePath) .attr('src', apiFilePath)
.attr('data-attachment-id', attachmentId) .attr('data-attachment-id', attachmentId)
.attr('data-size', stat.size.toString()) .attr('width', width)
.attr('width', $el.attr('width') ?? '100%') .attr('data-align', align);
.attr('data-align', $el.attr('data-align') ?? 'center');
unwrapFromParagraph($, $el); unwrapFromParagraph($, $vid);
} else if (tagName === 'div') { }
const dataType = $el.attr('data-type');
if (dataType === 'attachment') { // <div data-type="attachment">
const rawUrl = cleanUrlString($el.attr('data-attachment-url') ?? ''); for (const el of $('div[data-type="attachment"]').toArray()) {
const $oldDiv = $(el);
const rawUrl = cleanUrlString($oldDiv.attr('data-attachment-url') ?? '')!;
if (!rawUrl || rawUrl.startsWith('http')) continue; if (!rawUrl || rawUrl.startsWith('http')) continue;
const relPath = getCachedResolvedPath(rawUrl); const relPath = resolveRelativeAttachmentPath(
rawUrl,
pageDir,
attachmentCandidates,
);
if (!relPath) continue; if (!relPath) continue;
const { attachmentId, apiFilePath, abs } = processFile(relPath); const { attachmentId, apiFilePath, abs } = processFile(relPath);
const stat = await getCachedStat(abs);
const fileName = path.basename(abs); const fileName = path.basename(abs);
const mime = getMimeType(abs); const mime = getMimeType(abs);
@@ -345,39 +332,23 @@ export class ImportAttachmentService {
.attr('data-attachment-url', apiFilePath) .attr('data-attachment-url', apiFilePath)
.attr('data-attachment-name', fileName) .attr('data-attachment-name', fileName)
.attr('data-attachment-mime', mime) .attr('data-attachment-mime', mime)
.attr('data-attachment-size', stat.size.toString())
.attr('data-attachment-id', attachmentId); .attr('data-attachment-id', attachmentId);
$el.replaceWith($newDiv); $oldDiv.replaceWith($newDiv);
unwrapFromParagraph($, $newDiv);
} else if (dataType === 'excalidraw' || dataType === 'drawio') {
const rawSrc = cleanUrlString($el.attr('data-src') ?? '');
if (!rawSrc || rawSrc.startsWith('http')) continue;
const relPath = getCachedResolvedPath(rawSrc);
if (!relPath) continue;
const { attachmentId, apiFilePath, abs } = processFile(relPath);
const stat = await getCachedStat(abs);
const fileName = path.basename(abs);
const $newDiv = $('<div>')
.attr('data-type', dataType)
.attr('data-src', apiFilePath)
.attr('data-title', fileName)
.attr('data-width', $el.attr('data-width') || '100%')
.attr('data-size', stat.size.toString())
.attr('data-align', $el.attr('data-align') || 'center')
.attr('data-attachment-id', attachmentId);
$el.replaceWith($newDiv);
unwrapFromParagraph($, $newDiv); unwrapFromParagraph($, $newDiv);
} }
} else if (tagName === 'a') {
const href = cleanUrlString($el.attr('href') ?? ''); // rewrite other attachments via <a>
for (const aEl of $('a').toArray()) {
const $a = $(aEl);
const href = cleanUrlString($a.attr('href') ?? '')!;
if (!href || href.startsWith('http')) continue; if (!href || href.startsWith('http')) continue;
const relPath = getCachedResolvedPath(href); const relPath = resolveRelativeAttachmentPath(
href,
pageDir,
attachmentCandidates,
);
if (!relPath) continue; if (!relPath) continue;
// Check if this is a Draw.io file // Check if this is a Draw.io file
@@ -391,32 +362,30 @@ export class ImportAttachmentService {
.attr('data-align', 'center') .attr('data-align', 'center')
.attr('data-attachment-id', drawioSvg.attachmentId); .attr('data-attachment-id', drawioSvg.attachmentId);
$el.replaceWith($drawio); $a.replaceWith($drawio);
unwrapFromParagraph($, $drawio); unwrapFromParagraph($, $drawio);
continue; continue;
} }
// Skip files that should be ignored // Skip files that should be ignored
if (skipFiles.has(relPath)) { if (skipFiles.has(relPath)) {
$el.remove(); $a.remove();
continue; continue;
} }
const { attachmentId, apiFilePath, abs } = processFile(relPath); const { attachmentId, apiFilePath, abs } = processFile(relPath);
const stat = await getCachedStat(abs);
const ext = path.extname(relPath).toLowerCase(); const ext = path.extname(relPath).toLowerCase();
if (ext === '.mp4') { if (ext === '.mp4') {
const $video = $('<video>') const $video = $('<video>')
.attr('src', apiFilePath) .attr('src', apiFilePath)
.attr('data-attachment-id', attachmentId) .attr('data-attachment-id', attachmentId)
.attr('data-size', stat.size.toString())
.attr('width', '100%') .attr('width', '100%')
.attr('data-align', 'center'); .attr('data-align', 'center');
$el.replaceWith($video); $a.replaceWith($video);
unwrapFromParagraph($, $video); unwrapFromParagraph($, $video);
} else { } else {
const confAliasName = $el.attr('data-linked-resource-default-alias'); const confAliasName = $a.attr('data-linked-resource-default-alias');
let attachmentName = path.basename(abs); let attachmentName = path.basename(abs);
if (confAliasName) attachmentName = confAliasName; if (confAliasName) attachmentName = confAliasName;
@@ -425,13 +394,44 @@ export class ImportAttachmentService {
.attr('data-attachment-url', apiFilePath) .attr('data-attachment-url', apiFilePath)
.attr('data-attachment-name', attachmentName) .attr('data-attachment-name', attachmentName)
.attr('data-attachment-mime', getMimeType(abs)) .attr('data-attachment-mime', getMimeType(abs))
.attr('data-attachment-size', stat.size.toString())
.attr('data-attachment-id', attachmentId); .attr('data-attachment-id', attachmentId);
$el.replaceWith($div); $a.replaceWith($div);
unwrapFromParagraph($, $div); unwrapFromParagraph($, $div);
} }
} }
// excalidraw and drawio
for (const type of ['excalidraw', 'drawio'] as const) {
for (const el of $(`div[data-type="${type}"]`).toArray()) {
const $oldDiv = $(el);
const rawSrc = cleanUrlString($oldDiv.attr('data-src') ?? '')!;
if (!rawSrc || rawSrc.startsWith('http')) continue;
const relPath = resolveRelativeAttachmentPath(
rawSrc,
pageDir,
attachmentCandidates,
);
if (!relPath) continue;
const { attachmentId, apiFilePath, abs } = processFile(relPath);
const fileName = path.basename(abs);
const width = $oldDiv.attr('data-width') || '100%';
const align = $oldDiv.attr('data-align') || 'center';
const $newDiv = $('<div>')
.attr('data-type', type)
.attr('data-src', apiFilePath)
.attr('data-title', fileName)
.attr('data-width', width)
.attr('data-align', align)
.attr('data-attachment-id', attachmentId);
$oldDiv.replaceWith($newDiv);
unwrapFromParagraph($, $newDiv);
}
} }
// Collect all attachment IDs in the HTML in a single DOM traversal - O(n) // Collect all attachment IDs in the HTML in a single DOM traversal - O(n)
@@ -492,9 +492,6 @@ export class ImportAttachmentService {
// This attachment was in the list but not referenced in HTML - add it // This attachment was in the list but not referenced in HTML - add it
const { attachmentId, apiFilePath, abs } = processFile(href); const { attachmentId, apiFilePath, abs } = processFile(href);
try {
const stat = await fs.stat(abs);
const mime = mimeType || getMimeType(abs); const mime = mimeType || getMimeType(abs);
// Add as attachment node at the end // Add as attachment node at the end
@@ -503,13 +500,9 @@ export class ImportAttachmentService {
.attr('data-attachment-url', apiFilePath) .attr('data-attachment-url', apiFilePath)
.attr('data-attachment-name', fileName) .attr('data-attachment-name', fileName)
.attr('data-attachment-mime', mime) .attr('data-attachment-mime', mime)
.attr('data-attachment-size', stat.size.toString())
.attr('data-attachment-id', attachmentId); .attr('data-attachment-id', attachmentId);
$.root().append($attachmentDiv); $.root().append($attachmentDiv);
} catch (error) {
this.logger.error(`Failed to process attachment ${fileName}:`, error);
}
} }
// wait for all uploads & DB inserts // wait for all uploads & DB inserts
@@ -534,16 +527,49 @@ export class ImportAttachmentService {
} }
} }
// Post-process DOM elements to add file sizes after uploads complete
// This avoids blocking file operations during initial DOM processing
const elementsNeedingSize = $('[data-attachment-id]:not([data-size])');
for (const element of elementsNeedingSize.toArray()) {
const $el = $(element);
const attachmentId = $el.attr('data-attachment-id');
if (!attachmentId) continue;
// Find the corresponding processed file info
const processedEntry = Array.from(processed.values()).find(
(entry) => entry.attachmentId === attachmentId,
);
if (processedEntry) {
try {
const stat = await fs.stat(processedEntry.abs);
$el.attr('data-size', stat.size.toString());
} catch (error) {
this.logger.debug(
`Could not get size for ${processedEntry.abs}:`,
error,
);
}
}
}
return $.root().html() || ''; return $.root().html() || '';
} }
private analyzeAttachments(attachments: AttachmentInfo[]): { private analyzeAttachments(
attachments: AttachmentInfo[],
isConfluenceImport?: boolean,
): {
drawioPairs: Map<string, DrawioPair>; drawioPairs: Map<string, DrawioPair>;
skipFiles: Set<string>; skipFiles: Set<string>;
} { } {
const drawioPairs = new Map<string, DrawioPair>(); const drawioPairs = new Map<string, DrawioPair>();
const skipFiles = new Set<string>(); const skipFiles = new Set<string>();
if (!isConfluenceImport) {
return { drawioPairs, skipFiles };
}
// Group attachments by type // Group attachments by type
const drawioFiles: AttachmentInfo[] = []; const drawioFiles: AttachmentInfo[] = [];
const pngByBaseName = new Map<string, AttachmentInfo[]>(); const pngByBaseName = new Map<string, AttachmentInfo[]>();
@@ -807,7 +833,7 @@ export class ImportAttachmentService {
attempts: 1, attempts: 1,
backoff: { backoff: {
type: 'exponential', type: 'exponential',
delay: 30 * 1000, delay: 3 * 60 * 1000,
}, },
deduplication: { deduplication: {
id: attachmentId, id: attachmentId,
@@ -4,6 +4,11 @@ import { v7 } from 'uuid';
import { InsertableBacklink } from '@docmost/db/types/entity.types'; import { InsertableBacklink } from '@docmost/db/types/entity.types';
import { Cheerio, CheerioAPI, load } from 'cheerio'; import { Cheerio, CheerioAPI, load } from 'cheerio';
// Check if text contains Unicode characters (for emojis/icons)
function isUnicodeCharacter(text: string): boolean {
return text.length > 0 && text.codePointAt(0)! > 127; // Non-ASCII characters
}
export async function formatImportHtml(opts: { export async function formatImportHtml(opts: {
html: string; html: string;
currentFilePath: string; currentFilePath: string;
@@ -16,7 +21,11 @@ export async function formatImportHtml(opts: {
workspaceId: string; workspaceId: string;
pageDir?: string; pageDir?: string;
attachmentCandidates?: string[]; attachmentCandidates?: string[];
}): Promise<{ html: string; backlinks: InsertableBacklink[] }> { }): Promise<{
html: string;
backlinks: InsertableBacklink[];
pageIcon?: string;
}> {
const { const {
html, html,
currentFilePath, currentFilePath,
@@ -28,6 +37,17 @@ export async function formatImportHtml(opts: {
const $: CheerioAPI = load(html); const $: CheerioAPI = load(html);
const $root: Cheerio<any> = $.root(); const $root: Cheerio<any> = $.root();
let pageIcon: string | null = null;
// extract notion page icon
const headerIconSpan = $root.find('header .page-header-icon .icon');
if (headerIconSpan.length > 0) {
const iconText = headerIconSpan.text().trim();
if (iconText && isUnicodeCharacter(iconText)) {
pageIcon = iconText;
}
}
notionFormatter($, $root); notionFormatter($, $root);
defaultHtmlFormatter($, $root); defaultHtmlFormatter($, $root);
@@ -44,6 +64,7 @@ export async function formatImportHtml(opts: {
return { return {
html: $root.html() || '', html: $root.html() || '',
backlinks, backlinks,
pageIcon: pageIcon || undefined,
}; };
} }
@@ -69,6 +90,10 @@ export function defaultHtmlFormatter($: CheerioAPI, $root: Cheerio<any>) {
} }
export function notionFormatter($: CheerioAPI, $root: Cheerio<any>) { export function notionFormatter($: CheerioAPI, $root: Cheerio<any>) {
// remove page header icon and cover image
$root.find('.page-header-icon').remove();
$root.find('.page-cover-image').remove();
// remove empty description paragraphs // remove empty description paragraphs
$root.find('p.page-description').each((_, el) => { $root.find('p.page-description').each((_, el) => {
if (!$(el).text().trim()) $(el).remove(); if (!$(el).text().trim()) $(el).remove();