domma-cms 0.13.5 → 0.14.0

package/server/services/content.js

@@ -1,334 +1,334 @@
-/**
- * Content Service
- * File-based CRUD for pages and media.
- * Pages live in content/pages/ mirroring URL structure.
- */
-import fs from 'fs/promises';
-import path from 'path';
-import {parseMarkdown, serialiseMarkdown} from './markdown.js';
-import {config} from '../config.js';
-import {hooks} from './hooks.js';
-import {createVersion, deleteAllVersions, renameVersionDir} from './versions.js';
-
-const CONTENT_DIR = config.content.contentDir;
-const PAGES_DIR = path.join(CONTENT_DIR, 'pages');
-const MEDIA_DIR = config.content.mediaDir;
-
-// ---------------------------------------------------------------------------
-// Pages
-// ---------------------------------------------------------------------------
-
-/**
- * Recursively list all .md files under PAGES_DIR.
- * Returns parsed page objects sorted by sortOrder then title.
- *
- * @returns {Promise<object[]>}
- */
-export async function listPages() {
-    const files = await collectMdFiles(PAGES_DIR);
-    const pages = await Promise.all(files.map(filePath => readPageFile(filePath)));
-    return pages.sort((a, b) => (a.sortOrder ?? 99) - (b.sortOrder ?? 99) || a.title.localeCompare(b.title));
-}
-
-/**
- * Get a single page by its URL path (e.g. '/about' or '/services/web-dev').
- * The empty string / '/' resolves to index.md.
- *
- * @param {string} urlPath
- * @returns {Promise<object|null>}
- */
-export async function getPage(urlPath) {
-    const filePath = await resolveExistingFilePath(urlPath);
-    try {
-        return await readPageFile(filePath);
-    } catch {
-        return null;
-    }
-}
-
-/**
- * Create a new page. Auto-creates parent directories.
- *
- * @param {string} urlPath
- * @param {object} frontmatter
- * @param {string} body
- * @returns {Promise<object>}
- */
-export async function createPage(urlPath, frontmatter, body) {
-    const filePath = urlPathToFilePath(urlPath);
-    await fs.mkdir(path.dirname(filePath), { recursive: true });
-
-    const defaults = config.content.pageDefaults;
-    const now = new Date().toISOString();
-    const meta = {
-        title: frontmatter.title || 'Untitled',
-        slug: slugFromPath(urlPath),
-        description: frontmatter.description || '',
-        layout: frontmatter.layout || defaults.layout,
-        status: frontmatter.status || defaults.status,
-        sortOrder: frontmatter.sortOrder ?? defaults.sortOrder,
-        showInNav: frontmatter.showInNav ?? false,
-        sidebar: frontmatter.sidebar ?? false,
-        seo: frontmatter.seo || {},
-        dconfig: frontmatter.dconfig || null,
-        createdAt: now,
-        updatedAt: now
-    };
-
-    await fs.writeFile(filePath, serialiseMarkdown(meta, body || ''), 'utf8');
-    const page = await readPageFile(filePath);
-    hooks.emit('content:pageCreated', {page, urlPath});
-    return page;
-}
-
-/**
- * Update an existing page.
- *
- * @param {string} urlPath
- * @param {object} frontmatter
- * @param {string} body
- * @param {{ author?: string }} options
- * @returns {Promise<object>}
- */
-export async function updatePage(urlPath, frontmatter, body, {author} = {}) {
-    const filePath = await resolveExistingFilePath(urlPath);
-    const existing = await readPageFile(filePath);
-    const { urlPath: _u, content: existingContent, html: _h, ...existingMeta } = existing;
-
-    const meta = {
-        ...existingMeta,
-        ...frontmatter,
-        updatedAt: new Date().toISOString()
-    };
-
-    if (existingMeta.createdAt) meta.createdAt = existingMeta.createdAt;
-
-    try {
-        await createVersion(urlPath, {author, type: 'auto', label: null});
-    } catch {
-        // Versioning failure must not break saves
-    }
-
-    await fs.writeFile(filePath, serialiseMarkdown(meta, body ?? existingContent), 'utf8');
-    const page = await readPageFile(filePath);
-    hooks.emit('content:pageUpdated', {page, urlPath});
-    return page;
-}
-
-/**
- * Rename (move) a page to a new URL path.
- * Creates any required parent directories for the destination.
- *
- * @param {string} oldUrlPath
- * @param {string} newUrlPath
- * @returns {Promise<void>}
- */
-export async function renamePage(oldUrlPath, newUrlPath) {
-    const oldFile = await resolveExistingFilePath(oldUrlPath);
-    const newFile = urlPathToFilePath(newUrlPath);
-    await fs.mkdir(path.dirname(newFile), { recursive: true });
-    await fs.rename(oldFile, newFile);
-    try {
-        await renameVersionDir(oldUrlPath, newUrlPath);
-    } catch {
-        // Version directory move failure is non-fatal
-    }
-}
-
-/**
- * Delete a page file.
- *
- * @param {string} urlPath
- * @returns {Promise<void>}
- */
-export async function deletePage(urlPath) {
-    const filePath = await resolveExistingFilePath(urlPath);
-    await fs.unlink(filePath);
-    hooks.emit('content:pageDeleted', {urlPath});
-    try {
-        await deleteAllVersions(urlPath);
-    } catch {
-        // Version cleanup failure is non-fatal
-    }
-}
-
-// ---------------------------------------------------------------------------
-// Media
-// ---------------------------------------------------------------------------
-
-/**
- * List all files in the media directory.
- *
- * @returns {Promise<object[]>}
- */
-export async function listMedia() {
-    await fs.mkdir(MEDIA_DIR, { recursive: true });
-    const files = await fs.readdir(MEDIA_DIR);
-    const stats = await Promise.all(
-        files.map(async (file) => {
-            const filePath = path.join(MEDIA_DIR, file);
-            const stat = await fs.stat(filePath);
-            return {
-                name: file,
-                url: `/media/${file}`,
-                size: stat.size,
-                createdAt: stat.birthtime.toISOString()
-            };
-        })
-    );
-    return stats.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
-}
-
-/**
- * Save an uploaded file to the media directory.
- *
- * @param {string} filename
- * @param {Buffer} buffer
- * @returns {Promise<object>}
- */
-export async function saveMedia(filename, buffer) {
-    await fs.mkdir(MEDIA_DIR, { recursive: true });
-    const filePath = path.join(MEDIA_DIR, filename);
-    await fs.writeFile(filePath, buffer);
-    hooks.emit('content:mediaUploaded', {filename});
-    return { name: filename, url: `/media/${filename}` };
-}
-
-/**
- * Delete a media file.
- *
- * @param {string} filename
- * @returns {Promise<void>}
- */
-export async function deleteMedia(filename) {
-    const filePath = path.join(MEDIA_DIR, filename);
-    await fs.unlink(filePath);
-    hooks.emit('content:mediaDeleted', {filename});
-}
-
-/**
- * Rename a media file.
- *
- * @param {string} oldName - Current filename
- * @param {string} newName - Desired filename
- * @returns {Promise<{ name: string, url: string }>}
- * @throws {Error} If the destination already exists
- */
-export async function renameMedia(oldName, newName) {
-  const srcPath = path.join(MEDIA_DIR, oldName);
-  const destPath = path.join(MEDIA_DIR, newName);
-
-  try {
-    await fs.access(destPath);
-    throw new Error(`A file named "${newName}" already exists.`);
-  } catch (err) {
-    if (err.code !== 'ENOENT') throw err;
-  }
-
-  await fs.rename(srcPath, destPath);
-  return {name: newName, url: `/media/${newName}`};
-}
-
-// ---------------------------------------------------------------------------
-// Helpers
-// ---------------------------------------------------------------------------
-
-/**
- * Resolve the actual file path for an existing page.
- * Tries the direct file first (e.g. about.md), then the directory index (e.g. blog/index.md).
- *
- * @param {string} urlPath
- * @returns {Promise<string>}
- */
-export async function resolveExistingFilePath(urlPath) {
-    const directFile = urlPathToFilePath(urlPath);
-    try {
-        await fs.access(directFile);
-        return directFile;
-    } catch {
-        const normalised = urlPath === '/' || !urlPath ? 'index' : urlPath.replace(/^\//, '').replace(/\/$/, '');
-        const fallbackPath = path.join(PAGES_DIR, normalised, 'index.md');
-        if (!fallbackPath.startsWith(PAGES_DIR + path.sep)) {
-            throw new Error('Path traversal detected in URL path');
-        }
-        return fallbackPath;
-    }
-}
-
-/**
- * Recursively collect all .md file paths under a directory.
- *
- * @param {string} dir
- * @returns {Promise<string[]>}
- */
-async function collectMdFiles(dir) {
-    let results = [];
-    let entries;
-    try {
-        entries = await fs.readdir(dir, { withFileTypes: true });
-    } catch {
-        return results;
-    }
-    for (const entry of entries) {
-        const full = path.join(dir, entry.name);
-        if (entry.isDirectory()) {
-            results = results.concat(await collectMdFiles(full));
-        } else if (entry.isFile() && entry.name.endsWith('.md')) {
-            results.push(full);
-        }
-    }
-    return results;
-}
-
-/**
- * Read and parse a single .md file, injecting the derived urlPath.
- *
- * @param {string} filePath
- * @returns {Promise<object>}
- */
-async function readPageFile(filePath) {
-    const raw = await fs.readFile(filePath, 'utf8');
-    const { data, content, html } = await parseMarkdown(raw);
-    const urlPath = filePathToUrlPath(filePath);
-    return { ...data, urlPath, content, html };
-}
-
-/**
- * Derive the URL path from a file path.
- * e.g. content/pages/services/web-dev.md → /services/web-dev
- *      content/pages/index.md            → /
- *      content/pages/services/index.md   → /services
- */
-function filePathToUrlPath(filePath) {
-    const relative = path.relative(PAGES_DIR, filePath);
-    const withoutExt = relative.replace(/\.md$/, '');
-    if (withoutExt === 'index') return '/';
-    const parts = withoutExt.split(path.sep);
-    if (parts[parts.length - 1] === 'index') parts.pop();
-    return '/' + parts.join('/');
-}
-
-/**
- * Derive the file path from a URL path.
- * e.g. /             → content/pages/index.md
- *      /about        → content/pages/about.md
- *      /services     → content/pages/services/index.md (checked second)
- */
-function urlPathToFilePath(urlPath) {
-    const normalised = urlPath === '/' || !urlPath ? 'index' : urlPath.replace(/^\//, '').replace(/\/$/, '');
-    const result = path.join(PAGES_DIR, normalised + '.md');
-    const resolved = path.resolve(result);
-    if (!resolved.startsWith(path.resolve(PAGES_DIR))) {
-        throw new Error('Invalid path: outside content directory');
-    }
-    return result;
-}
-
-/**
- * Extract a slug from a URL path.
- */
-function slugFromPath(urlPath) {
-    if (urlPath === '/' || !urlPath) return 'index';
-    const parts = urlPath.split('/').filter(Boolean);
-    return parts[parts.length - 1] || 'index';
-}
+/**
+ * Content Service
+ * File-based CRUD for pages and media.
+ * Pages live in content/pages/ mirroring URL structure.
+ */
+import fs from 'fs/promises';
+import path from 'path';
+import {parseMarkdown, serialiseMarkdown} from './markdown.js';
+import {config} from '../config.js';
+import {hooks} from './hooks.js';
+import {createVersion, deleteAllVersions, renameVersionDir} from './versions.js';
+
+const CONTENT_DIR = config.content.contentDir;
+const PAGES_DIR = path.join(CONTENT_DIR, 'pages');
+const MEDIA_DIR = config.content.mediaDir;
+
+// ---------------------------------------------------------------------------
+// Pages
+// ---------------------------------------------------------------------------
+
+/**
+ * Recursively list all .md files under PAGES_DIR.
+ * Returns parsed page objects sorted by sortOrder then title.
+ *
+ * @returns {Promise<object[]>}
+ */
+export async function listPages() {
+    const files = await collectMdFiles(PAGES_DIR);
+    const pages = await Promise.all(files.map(filePath => readPageFile(filePath)));
+    return pages.sort((a, b) => (a.sortOrder ?? 99) - (b.sortOrder ?? 99) || a.title.localeCompare(b.title));
+}
+
+/**
+ * Get a single page by its URL path (e.g. '/about' or '/services/web-dev').
+ * The empty string / '/' resolves to index.md.
+ *
+ * @param {string} urlPath
+ * @returns {Promise<object|null>}
+ */
+export async function getPage(urlPath) {
+    const filePath = await resolveExistingFilePath(urlPath);
+    try {
+        return await readPageFile(filePath);
+    } catch {
+        return null;
+    }
+}
+
+/**
+ * Create a new page. Auto-creates parent directories.
+ *
+ * @param {string} urlPath
+ * @param {object} frontmatter
+ * @param {string} body
+ * @returns {Promise<object>}
+ */
+export async function createPage(urlPath, frontmatter, body) {
+    const filePath = urlPathToFilePath(urlPath);
+    await fs.mkdir(path.dirname(filePath), { recursive: true });
+
+    const defaults = config.content.pageDefaults;
+    const now = new Date().toISOString();
+    const meta = {
+        title: frontmatter.title || 'Untitled',
+        slug: slugFromPath(urlPath),
+        description: frontmatter.description || '',
+        layout: frontmatter.layout || defaults.layout,
+        status: frontmatter.status || defaults.status,
+        sortOrder: frontmatter.sortOrder ?? defaults.sortOrder,
+        showInNav: frontmatter.showInNav ?? false,
+        sidebar: frontmatter.sidebar ?? false,
+        seo: frontmatter.seo || {},
+        dconfig: frontmatter.dconfig || null,
+        createdAt: now,
+        updatedAt: now
+    };
+
+    await fs.writeFile(filePath, serialiseMarkdown(meta, body || ''), 'utf8');
+    const page = await readPageFile(filePath);
+    hooks.emit('content:pageCreated', {page, urlPath});
+    return page;
+}
+
+/**
+ * Update an existing page.
+ *
+ * @param {string} urlPath
+ * @param {object} frontmatter
+ * @param {string} body
+ * @param {{ author?: string }} options
+ * @returns {Promise<object>}
+ */
+export async function updatePage(urlPath, frontmatter, body, {author} = {}) {
+    const filePath = await resolveExistingFilePath(urlPath);
+    const existing = await readPageFile(filePath);
+    const { urlPath: _u, content: existingContent, html: _h, ...existingMeta } = existing;
+
+    const meta = {
+        ...existingMeta,
+        ...frontmatter,
+        updatedAt: new Date().toISOString()
+    };
+
+    if (existingMeta.createdAt) meta.createdAt = existingMeta.createdAt;
+
+    try {
+        await createVersion(urlPath, {author, type: 'auto', label: null});
+    } catch {
+        // Versioning failure must not break saves
+    }
+
+    await fs.writeFile(filePath, serialiseMarkdown(meta, body ?? existingContent), 'utf8');
+    const page = await readPageFile(filePath);
+    hooks.emit('content:pageUpdated', {page, urlPath});
+    return page;
+}
+
+/**
+ * Rename (move) a page to a new URL path.
+ * Creates any required parent directories for the destination.
+ *
+ * @param {string} oldUrlPath
+ * @param {string} newUrlPath
+ * @returns {Promise<void>}
+ */
+export async function renamePage(oldUrlPath, newUrlPath) {
+    const oldFile = await resolveExistingFilePath(oldUrlPath);
+    const newFile = urlPathToFilePath(newUrlPath);
+    await fs.mkdir(path.dirname(newFile), { recursive: true });
+    await fs.rename(oldFile, newFile);
+    try {
+        await renameVersionDir(oldUrlPath, newUrlPath);
+    } catch {
+        // Version directory move failure is non-fatal
+    }
+}
+
+/**
+ * Delete a page file.
+ *
+ * @param {string} urlPath
+ * @returns {Promise<void>}
+ */
+export async function deletePage(urlPath) {
+    const filePath = await resolveExistingFilePath(urlPath);
+    await fs.unlink(filePath);
+    hooks.emit('content:pageDeleted', {urlPath});
+    try {
+        await deleteAllVersions(urlPath);
+    } catch {
+        // Version cleanup failure is non-fatal
+    }
+}
+
+// ---------------------------------------------------------------------------
+// Media
+// ---------------------------------------------------------------------------
+
+/**
+ * List all files in the media directory.
+ *
+ * @returns {Promise<object[]>}
+ */
+export async function listMedia() {
+    await fs.mkdir(MEDIA_DIR, { recursive: true });
+    const files = await fs.readdir(MEDIA_DIR);
+    const stats = await Promise.all(
+        files.map(async (file) => {
+            const filePath = path.join(MEDIA_DIR, file);
+            const stat = await fs.stat(filePath);
+            return {
+                name: file,
+                url: `/media/${file}`,
+                size: stat.size,
+                createdAt: stat.birthtime.toISOString()
+            };
+        })
+    );
+    return stats.sort((a, b) => b.createdAt.localeCompare(a.createdAt));
+}
+
+/**
+ * Save an uploaded file to the media directory.
+ *
+ * @param {string} filename
+ * @param {Buffer} buffer
+ * @returns {Promise<object>}
+ */
+export async function saveMedia(filename, buffer) {
+    await fs.mkdir(MEDIA_DIR, { recursive: true });
+    const filePath = path.join(MEDIA_DIR, filename);
+    await fs.writeFile(filePath, buffer);
+    hooks.emit('content:mediaUploaded', {filename});
+    return { name: filename, url: `/media/${filename}` };
+}
+
+/**
+ * Delete a media file.
+ *
+ * @param {string} filename
+ * @returns {Promise<void>}
+ */
+export async function deleteMedia(filename) {
+    const filePath = path.join(MEDIA_DIR, filename);
+    await fs.unlink(filePath);
+    hooks.emit('content:mediaDeleted', {filename});
+}
+
+/**
+ * Rename a media file.
+ *
+ * @param {string} oldName - Current filename
+ * @param {string} newName - Desired filename
+ * @returns {Promise<{ name: string, url: string }>}
+ * @throws {Error} If the destination already exists
+ */
+export async function renameMedia(oldName, newName) {
+  const srcPath = path.join(MEDIA_DIR, oldName);
+  const destPath = path.join(MEDIA_DIR, newName);
+
+  try {
+    await fs.access(destPath);
+    throw new Error(`A file named "${newName}" already exists.`);
+  } catch (err) {
+    if (err.code !== 'ENOENT') throw err;
+  }
+
+  await fs.rename(srcPath, destPath);
+  return {name: newName, url: `/media/${newName}`};
+}
+
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+
+/**
+ * Resolve the actual file path for an existing page.
+ * Tries the direct file first (e.g. about.md), then the directory index (e.g. blog/index.md).
+ *
+ * @param {string} urlPath
+ * @returns {Promise<string>}
+ */
+export async function resolveExistingFilePath(urlPath) {
+    const directFile = urlPathToFilePath(urlPath);
+    try {
+        await fs.access(directFile);
+        return directFile;
+    } catch {
+        const normalised = urlPath === '/' || !urlPath ? 'index' : urlPath.replace(/^\//, '').replace(/\/$/, '');
+        const fallbackPath = path.join(PAGES_DIR, normalised, 'index.md');
+        if (!fallbackPath.startsWith(PAGES_DIR + path.sep)) {
+            throw new Error('Path traversal detected in URL path');
+        }
+        return fallbackPath;
+    }
+}
+
+/**
+ * Recursively collect all .md file paths under a directory.
+ *
+ * @param {string} dir
+ * @returns {Promise<string[]>}
+ */
+async function collectMdFiles(dir) {
+    let results = [];
+    let entries;
+    try {
+        entries = await fs.readdir(dir, { withFileTypes: true });
+    } catch {
+        return results;
+    }
+    for (const entry of entries) {
+        const full = path.join(dir, entry.name);
+        if (entry.isDirectory()) {
+            results = results.concat(await collectMdFiles(full));
+        } else if (entry.isFile() && entry.name.endsWith('.md')) {
+            results.push(full);
+        }
+    }
+    return results;
+}
+
+/**
+ * Read and parse a single .md file, injecting the derived urlPath.
+ *
+ * @param {string} filePath
+ * @returns {Promise<object>}
+ */
+async function readPageFile(filePath) {
+    const raw = await fs.readFile(filePath, 'utf8');
+    const { data, content, html, usedComponents } = await parseMarkdown(raw);
+    const urlPath = filePathToUrlPath(filePath);
+    return { ...data, urlPath, content, html, usedComponents };
+}
+
+/**
+ * Derive the URL path from a file path.
+ * e.g. content/pages/services/web-dev.md → /services/web-dev
+ *      content/pages/index.md            → /
+ *      content/pages/services/index.md   → /services
+ */
+function filePathToUrlPath(filePath) {
+    const relative = path.relative(PAGES_DIR, filePath);
+    const withoutExt = relative.replace(/\.md$/, '');
+    if (withoutExt === 'index') return '/';
+    const parts = withoutExt.split(path.sep);
+    if (parts[parts.length - 1] === 'index') parts.pop();
+    return '/' + parts.join('/');
+}
+
+/**
+ * Derive the file path from a URL path.
+ * e.g. /             → content/pages/index.md
+ *      /about        → content/pages/about.md
+ *      /services     → content/pages/services/index.md (checked second)
+ */
+function urlPathToFilePath(urlPath) {
+    const normalised = urlPath === '/' || !urlPath ? 'index' : urlPath.replace(/^\//, '').replace(/\/$/, '');
+    const result = path.join(PAGES_DIR, normalised + '.md');
+    const resolved = path.resolve(result);
+    if (!resolved.startsWith(path.resolve(PAGES_DIR))) {
+        throw new Error('Invalid path: outside content directory');
+    }
+    return result;
+}
+
+/**
+ * Extract a slug from a URL path.
+ */
+function slugFromPath(urlPath) {
+    if (urlPath === '/' || !urlPath) return 'index';
+    const parts = urlPath.split('/').filter(Boolean);
+    return parts[parts.length - 1] || 'index';
+}