Hynes/Void-Homelab
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(migrate): BookStack importer preserves Book › Chapter › Page hierarchy (parent_id)

Browse Source 
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This commit is contained in:
root
2026-06-04 23:25:00 +10:00
parent c32871d9d0
commit 0a490e4e68
2 changed files with 67 additions and 24 deletions
Download Patch File Download Diff File Expand all files Collapse all files

53
migrate/sources/bookstack.js
View File

@@ -4,23 +4,56 @@ import * as map from '../../lib/db/repos/migration_map.js';
const SYS = { kind: 'system', id: null };
const slugify = (s) => (s || '').toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/(^-|-$)/g, '').slice(0, 60) || 'page';
// BookStack REST: list GET /api/pages → {data:[{id,name}]}; detail GET /api/pages/:id
// → {id,name,markdown,html}. Auth header: "Token <id>:<secret>".
// BookStack REST. Auth header: "Token <id>:<secret>". Builds the hierarchy as
// parent pages: books → chapters (parent=book) → pages (parent=chapter or book),
// so Void breadcrumbs read Wiki › Book › Chapter › Page.
export async function importBookstack({ apiUrl = process.env.BOOKSTACK_URL, tokenId = process.env.BOOKSTACK_TOKEN_ID, tokenSecret = process.env.BOOKSTACK_TOKEN_SECRET, spaceId, dryRun = false, fetchImpl = fetch }) {
const headers = { Authorization: `Token ${tokenId}:${tokenSecret}` };
const listRes = await fetchImpl(`${apiUrl}/api/pages`, { headers });
if (!listRes.ok) throw new Error(`bookstack list ${listRes.status}`);
const { data = [] } = await listRes.json();
const getJson = async (path) => {
const r = await fetchImpl(`${apiUrl}${path}`, { headers });
if (!r.ok) throw new Error(`bookstack ${path} ${r.status}`);
return r.json();
};
let created = 0;
for (const item of data) {
const bookPage = new Map(); // book id → void page id
const chapterPage = new Map(); // chapter id → void page id
// 1. Books → top-level parent pages.
for (const b of ((await getJson('/api/books')).data || [])) {
let pid = await map.seen('bookstack', `book:${b.id}`, 'page');
if (!pid) {
created++;
if (!dryRun) {
const p = await pages.create({ space_id: spaceId, slug: slugify(b.name), title: b.name || 'Book', body_md: b.description || '' }, SYS);
pid = p.id; await map.record('bookstack', `book:${b.id}`, 'page', pid);
}
}
if (pid) bookPage.set(b.id, pid);
}
// 2. Chapters → pages parented to their book.
for (const c of ((await getJson('/api/chapters')).data || [])) {
let pid = await map.seen('bookstack', `chapter:${c.id}`, 'page');
if (!pid) {
created++;
if (!dryRun) {
const p = await pages.create({ space_id: spaceId, slug: slugify(c.name), title: c.name || 'Chapter', body_md: c.description || '', parent_id: bookPage.get(c.book_id) || null }, SYS);
pid = p.id; await map.record('bookstack', `chapter:${c.id}`, 'page', pid);
}
}
if (pid) chapterPage.set(c.id, pid);
}
// 3. Pages → leaf pages parented to their chapter (or book if chapter-less).
for (const item of ((await getJson('/api/pages')).data || [])) {
if (await map.seen('bookstack', `page:${item.id}`, 'page')) continue;
created++; if (dryRun) continue;
const dRes = await fetchImpl(`${apiUrl}/api/pages/${item.id}`, { headers });
if (!dRes.ok) throw new Error(`bookstack page ${item.id} ${dRes.status}`);
const d = await dRes.json();
const d = await getJson(`/api/pages/${item.id}`);
const body = d.markdown && d.markdown.trim() ? d.markdown : (d.html || '');
const p = await pages.create({ space_id: spaceId, slug: slugify(d.name), title: d.name || 'Untitled', body_md: body }, SYS);
const parent = chapterPage.get(d.chapter_id) || bookPage.get(d.book_id) || null;
const p = await pages.create({ space_id: spaceId, slug: slugify(d.name), title: d.name || 'Untitled', body_md: body, parent_id: parent }, SYS);
await map.record('bookstack', `page:${item.id}`, 'page', p.id);
}
return { created };
}