@nuasite/cms 0.18.1 → 0.19.0

package/src/editor/signals.ts

@@ -1,4 +1,5 @@
 import { batch, computed, type Signal, signal } from '@preact/signals'
+import { slugifyHref } from '../shared'
 import { fetchManifest, getMarkdownContent } from './api'
 import type { ToastMessage, ToastType } from './components/toast/types'
 import { getConfig } from './config'
@@ -18,12 +19,14 @@ import type {
 	ComponentInstance,
 	ConfirmDialogState,
 	CreatePageState,
+	DeletePageState,
 	DeploymentState,
 	DeploymentStatusType,
 	EditorState,
 	FieldDefinition,
 	MarkdownEditorState,
 	MarkdownPageEntry,
+	MdxPropsEditorState,
 	MediaItem,
 	MediaLibraryState,
 	PendingAttributeChange,
@@ -33,6 +36,7 @@ import type {
 	PendingComponentInsert,
 	PendingImageChange,
 	PendingSeoChange,
+	RedirectsManagerState,
 	SeoEditorState,
 } from './types'
 
@@ -147,6 +151,26 @@ function createInitialCreatePageState(): CreatePageState {
 		isOpen: false,
 		isCreating: false,
 		selectedCollection: null,
+		mode: 'pick',
+	}
+}
+
+function createInitialDeletePageState(): DeletePageState {
+	return {
+		isOpen: false,
+		isDeleting: false,
+		targetPage: null,
+		redirectTo: '/',
+		createRedirect: true,
+	}
+}
+
+function createInitialRedirectsManagerState(): RedirectsManagerState {
+	return {
+		isOpen: false,
+		rules: [],
+		isLoading: false,
+		editingIndex: null,
 	}
 }
 
@@ -318,6 +342,76 @@ export const currentMarkdownPage = computed(
 )
 export const isMarkdownPreview = signal(false)
 
+// ============================================================================
+// MDX Component Block State Signals
+// ============================================================================
+
+export const mdxPropsEditorState = signal<MdxPropsEditorState>({
+	isOpen: false,
+	nodePos: null,
+	componentName: null,
+	props: {},
+	cursorPos: null,
+})
+
+export const mdxComponentPickerOpen = signal(false)
+
+export function openMdxPropsEditor(nodePos: number, componentName: string, props: Record<string, string>, cursorPos: { x: number; y: number }): void {
+	mdxPropsEditorState.value = { isOpen: true, nodePos, componentName, props, cursorPos }
+}
+
+export function closeMdxPropsEditor(): void {
+	mdxPropsEditorState.value = { isOpen: false, nodePos: null, componentName: null, props: {}, cursorPos: null }
+}
+
+// ============================================================================
+// Reference Picker State Signals
+// ============================================================================
+
+export interface ReferencePickerState {
+	isOpen: boolean
+	/** CMS ID of the clicked element */
+	cmsId: string | null
+	/** Reference field name in the owning entry (e.g., 'author') */
+	fieldName: string | null
+	/** Collection to pick from (e.g., 'authors') */
+	collection: string | null
+	/** Current reference value (slug) */
+	currentValue: string | null
+	/** File path of the owning entry to update */
+	ownerPath: string | null
+	/** Whether this is an array reference (multi-select) */
+	isArray: boolean
+	/** Current array values for array references */
+	currentValues: string[]
+	/** Position for the floating panel */
+	cursorPos: { x: number; y: number } | null
+}
+
+function createInitialReferencePickerState(): ReferencePickerState {
+	return {
+		isOpen: false,
+		cmsId: null,
+		fieldName: null,
+		collection: null,
+		currentValue: null,
+		ownerPath: null,
+		isArray: false,
+		currentValues: [],
+		cursorPos: null,
+	}
+}
+
+export const referencePickerState = signal<ReferencePickerState>(createInitialReferencePickerState())
+
+export function openReferencePicker(opts: Omit<ReferencePickerState, 'isOpen'>): void {
+	referencePickerState.value = { isOpen: true, ...opts }
+}
+
+export function closeReferencePicker(): void {
+	referencePickerState.value = createInitialReferencePickerState()
+}
+
 // ============================================================================
 // Media Library State Signals
 // ============================================================================
@@ -328,10 +422,6 @@ export const mediaLibraryState = signal<MediaLibraryState>(
 
 // Convenience computed signals for media library
 export const isMediaLibraryOpen = computed(() => mediaLibraryState.value.isOpen)
-export const mediaLibraryItems = computed(() => mediaLibraryState.value.items)
-export const isMediaLibraryLoading = computed(
-	() => mediaLibraryState.value.isLoading,
-)
 
 // ============================================================================
 // Create Page State Signals
@@ -345,6 +435,25 @@ export const createPageState = signal<CreatePageState>(
 export const isCreatePageOpen = computed(() => createPageState.value.isOpen)
 export const isCreatingPage = computed(() => createPageState.value.isCreating)
 export const selectedCollection = computed(() => createPageState.value.selectedCollection)
+export const createPageMode = computed(() => createPageState.value.mode)
+
+// ============================================================================
+// Delete Page State Signals
+// ============================================================================
+
+export const deletePageState = signal<DeletePageState>(
+	createInitialDeletePageState(),
+)
+export const isDeletePageOpen = computed(() => deletePageState.value.isOpen)
+
+// ============================================================================
+// Redirects Manager State Signals
+// ============================================================================
+
+export const redirectsManagerState = signal<RedirectsManagerState>(
+	createInitialRedirectsManagerState(),
+)
+export const isRedirectsManagerOpen = computed(() => redirectsManagerState.value.isOpen)
 
 // ============================================================================
 // Collections Browser State Signals
@@ -806,6 +915,9 @@ export function setMarkdownActiveElement(elementId: string | null): void {
 
 export function updateMarkdownFrontmatter(updates: Partial<import('./types').BlogFrontmatter>): void {
 	if (markdownEditorState.value.currentPage) {
+		// Auto-sync derived fields (e.g. categoryHref from category)
+		const derivedUpdates = computeDerivedUpdates(updates)
+
 		markdownEditorState.value = {
 			...markdownEditorState.value,
 			currentPage: {
@@ -813,6 +925,7 @@ export function updateMarkdownFrontmatter(updates: Partial<import('./types').Blo
 				frontmatter: {
 					...markdownEditorState.value.currentPage.frontmatter,
 					...updates,
+					...derivedUpdates,
 				},
 				isDirty: true,
 			},
@@ -820,6 +933,33 @@ export function updateMarkdownFrontmatter(updates: Partial<import('./types').Blo
 	}
 }
 
+function computeDerivedUpdates(updates: Record<string, unknown>): Record<string, unknown> {
+	const fields = markdownEditorState.value.collectionDefinition?.fields
+	if (!fields) return {}
+
+	const result: Record<string, unknown> = {}
+	for (const field of fields) {
+		if (!field.derivedFrom || !field.hidden) continue
+		const sourceValue = updates[field.derivedFrom]
+		if (typeof sourceValue !== 'string') continue
+		result[field.name] = slugifyHref(sourceValue)
+	}
+	return result
+}
+
+export function updateMarkdownPageMeta(patch: Partial<Pick<MarkdownPageEntry, 'slug' | 'filePath'>>): void {
+	if (markdownEditorState.value.currentPage) {
+		markdownEditorState.value = {
+			...markdownEditorState.value,
+			currentPage: {
+				...markdownEditorState.value.currentPage,
+				...patch,
+				isDirty: true,
+			},
+		}
+	}
+}
+
 export function resetMarkdownEditorState(): void {
 	markdownEditorState.value = createInitialMarkdownEditorState()
 }
@@ -923,6 +1063,7 @@ export function openMarkdownEditorForNewPage(
 	const initialFrontmatter: Record<string, unknown> = {}
 	for (const field of collectionDefinition.fields) {
 		if (field.name === 'title') continue // title handled separately via the header
+		if (field.hidden) continue // derived fields are auto-computed
 		if (field.defaultValue !== undefined) {
 			initialFrontmatter[field.name] = field.defaultValue
 		} else {
@@ -975,14 +1116,6 @@ export function setMediaLibraryOpen(open: boolean): void {
 	mediaLibraryState.value = { ...mediaLibraryState.value, isOpen: open }
 }
 
-export function setMediaLibraryItems(items: MediaItem[]): void {
-	mediaLibraryState.value = { ...mediaLibraryState.value, items }
-}
-
-export function setMediaLibraryLoading(loading: boolean): void {
-	mediaLibraryState.value = { ...mediaLibraryState.value, isLoading: loading }
-}
-
 export function setMediaLibrarySelectedItem(item: MediaItem | null): void {
 	mediaLibraryState.value = { ...mediaLibraryState.value, selectedItem: item }
 }
@@ -1012,7 +1145,11 @@ export function resetMediaLibraryState(): void {
 // ============================================================================
 
 export function setCreatePageOpen(open: boolean): void {
-	createPageState.value = { ...createPageState.value, isOpen: open }
+	createPageState.value = { ...createPageState.value, isOpen: open, mode: 'pick' }
+}
+
+export function setCreatePageMode(mode: CreatePageState['mode']): void {
+	createPageState.value = { ...createPageState.value, mode }
 }
 
 export function setCreatingPage(creating: boolean): void {
@@ -1027,6 +1164,54 @@ export function resetCreatePageState(): void {
 	createPageState.value = createInitialCreatePageState()
 }
 
+// ============================================================================
+// Delete Page State Mutations
+// ============================================================================
+
+export function openDeletePageDialog(page: { pathname: string; title?: string }): void {
+	deletePageState.value = {
+		...createInitialDeletePageState(),
+		isOpen: true,
+		targetPage: page,
+	}
+}
+
+export function setDeletePageRedirectTo(redirectTo: string): void {
+	deletePageState.value = { ...deletePageState.value, redirectTo }
+}
+
+export function setDeletePageCreateRedirect(createRedirect: boolean): void {
+	deletePageState.value = { ...deletePageState.value, createRedirect }
+}
+
+export function setDeletingPage(isDeleting: boolean): void {
+	deletePageState.value = { ...deletePageState.value, isDeleting }
+}
+
+export function resetDeletePageState(): void {
+	deletePageState.value = createInitialDeletePageState()
+}
+
+// ============================================================================
+// Redirects Manager State Mutations
+// ============================================================================
+
+export function openRedirectsManager(): void {
+	redirectsManagerState.value = { ...createInitialRedirectsManagerState(), isOpen: true, isLoading: true }
+}
+
+export function setRedirectsManagerRules(rules: RedirectsManagerState['rules']): void {
+	redirectsManagerState.value = { ...redirectsManagerState.value, rules, isLoading: false }
+}
+
+export function setRedirectsManagerEditing(index: number | null): void {
+	redirectsManagerState.value = { ...redirectsManagerState.value, editingIndex: index }
+}
+
+export function closeRedirectsManager(): void {
+	redirectsManagerState.value = createInitialRedirectsManagerState()
+}
+
 // ============================================================================
 // Collections Browser State Mutations
 // ============================================================================
@@ -1311,6 +1496,12 @@ export function setConfig(newConfig: CmsConfig): void {
 	config.value = newConfig
 }
 
+export function setFeatures(features: CmsConfig['features']): void {
+	const current = config.value.features
+	if (current?.selectElement === features?.selectElement) return
+	config.value = { ...config.value, features: { ...current, ...features } }
+}
+
 // ============================================================================
 // Change Navigation Mutations
 // ============================================================================
@@ -1389,6 +1580,8 @@ export function resetAllState(): void {
 		markdownEditorState.value = createInitialMarkdownEditorState()
 		mediaLibraryState.value = createInitialMediaLibraryState()
 		createPageState.value = createInitialCreatePageState()
+		deletePageState.value = createInitialDeletePageState()
+		redirectsManagerState.value = createInitialRedirectsManagerState()
 		collectionsBrowserState.value = createInitialCollectionsBrowserState()
 		deploymentState.value = createInitialDeploymentState()
 		colorEditorState.value = createInitialColorEditorState()

package/src/editor/types.ts

@@ -1,4 +1,4 @@
-import type { Attribute, CmsManifest, CollectionDefinition, ComponentInstance } from '../types'
+import type { Attribute, CmsFeatures, CmsManifest, CollectionDefinition, ComponentInstance, RedirectRule } from '../types'
 
 // Re-export shared types from @nuasite/cms-marker (source of truth)
 export type {
@@ -50,6 +50,7 @@ export interface CmsConfig {
 	debug: boolean
 	theme?: CmsThemeConfig
 	themePreset?: CmsThemePreset
+	features?: CmsFeatures
 }
 
 export interface ComponentProp {
@@ -379,8 +380,11 @@ export interface MediaItem {
 	width?: number
 	height?: number
 	uploadedAt?: string
+	folder?: string
 }
 
+export type { MediaFolderItem, MediaTypeFilter } from '../media/types'
+
 export interface MediaLibraryState {
 	isOpen: boolean
 	items: MediaItem[]
@@ -393,6 +397,37 @@ export interface CreatePageState {
 	isOpen: boolean
 	isCreating: boolean
 	selectedCollection: string | null
+	mode: 'pick' | 'new' | 'duplicate' | 'collection'
+}
+
+export interface DeletePageState {
+	isOpen: boolean
+	isDeleting: boolean
+	targetPage: { pathname: string; title?: string } | null
+	redirectTo: string
+	createRedirect: boolean
+}
+
+// Re-export shared page/redirect types from the canonical source
+export type {
+	AddRedirectRequest,
+	CreatePageRequest,
+	DeletePageRequest,
+	DeleteRedirectRequest,
+	DuplicatePageRequest,
+	GetRedirectsResponse,
+	LayoutInfo,
+	PageOperationResponse,
+	RedirectOperationResponse,
+	RedirectRule,
+	UpdateRedirectRequest,
+} from '../types'
+
+export interface RedirectsManagerState {
+	isOpen: boolean
+	rules: RedirectRule[]
+	isLoading: boolean
+	editingIndex: number | null
 }
 
 export interface CollectionsBrowserState {
@@ -412,6 +447,8 @@ export interface CreateMarkdownPageRequest {
 	frontmatter?: Partial<BlogFrontmatter>
 	/** Optional markdown content */
 	content?: string
+	/** File extension override for data collections (e.g. 'json', 'yaml') */
+	fileExtension?: string
 }
 
 export interface CreateMarkdownPageResponse {
@@ -657,6 +694,20 @@ export type UndoAction =
 	| UndoSeoAction
 	| UndoBgImageAction
 
+// ============================================================================
+// MDX Component Block Types
+// ============================================================================
+
+export interface MdxPropsEditorState {
+	isOpen: boolean
+	/** ProseMirror document position of the node being edited */
+	nodePos: number | null
+	componentName: string | null
+	props: Record<string, string>
+	/** Position for the floating editor panel */
+	cursorPos: { x: number; y: number } | null
+}
+
 declare global {
 	interface Window {
 		NuaCmsConfig?: Partial<CmsConfig>

package/src/handlers/api-routes.ts

@@ -0,0 +1,251 @@
+import type { IncomingMessage, ServerResponse } from 'node:http'
+import path from 'node:path'
+import { scanCollections } from '../collection-scanner'
+import { getProjectRoot } from '../config'
+import { expectedDeletions } from '../dev-middleware'
+import type { ManifestWriter } from '../manifest-writer'
+import { listProjectImages } from '../media/project-images'
+import type { MediaStorageAdapter } from '../media/types'
+import { handleAddArrayItem, handleRemoveArrayItem } from './array-ops'
+import { handleInsertComponent, handleRemoveComponent } from './component-ops'
+import { handleCreateMarkdown, handleDeleteMarkdown, handleGetMarkdownContent, handleRenameMarkdown, handleUpdateMarkdown } from './markdown-ops'
+import { handleCheckSlugExists, handleCreatePage, handleDeletePage, handleDuplicatePage, handleGetLayouts } from './page-ops'
+import { handleAddRedirect, handleDeleteRedirect, handleGetRedirects, handleUpdateRedirect } from './redirect-ops'
+import { parseJsonBody, parseMultipartFile, readBody, sendError, sendJson } from './request-utils'
+import { handleUpdate } from './source-writer'
+
+export interface RouteContext {
+	req: IncomingMessage
+	res: ServerResponse
+	route: string
+	manifestWriter: ManifestWriter
+	contentDir: string
+	mediaAdapter?: MediaStorageAdapter
+}
+
+type RouteHandler = (ctx: RouteContext) => Promise<void>
+
+function requireMedia(ctx: RouteContext): ctx is RouteContext & { mediaAdapter: MediaStorageAdapter } {
+	if (!ctx.mediaAdapter) {
+		sendError(ctx.res, 'Media storage not configured', 501)
+		return false
+	}
+	return true
+}
+
+function getQuery(ctx: RouteContext): URLSearchParams {
+	return new URL(ctx.req.url!, `http://${ctx.req.headers.host}`).searchParams
+}
+
+// -- Route helper factories --
+
+/** POST route: parse JSON body → handler(body, manifestWriter) → sendJson */
+function post<T>(route: string, handler: (body: T, mw: ManifestWriter) => Promise<unknown>): [string, RouteHandler] {
+	return [`POST:${route}`, async ({ req, res, manifestWriter }) => {
+		const body = await parseJsonBody<T>(req)
+		sendJson(res, await handler(body, manifestWriter))
+	}]
+}
+
+/** POST route: parse JSON body → handler(body) → sendJson with success-based status */
+function postWithStatus<T>(route: string, handler: (body: T) => Promise<{ success: boolean }>): [string, RouteHandler] {
+	return [`POST:${route}`, async ({ req, res }) => {
+		const body = await parseJsonBody<T>(req)
+		const result = await handler(body)
+		sendJson(res, result, result.success ? 200 : 400)
+	}]
+}
+
+/** GET route: handler() → sendJson */
+function get(route: string, handler: () => Promise<unknown>): [string, RouteHandler] {
+	return [`GET:${route}`, async ({ res }) => {
+		sendJson(res, await handler())
+	}]
+}
+
+/** Custom handler for routes that don't fit the patterns above */
+function custom(method: string, route: string, handler: RouteHandler): [string, RouteHandler] {
+	return [`${method}:${route}`, handler]
+}
+
+/** Allowed MIME types for media uploads */
+const ALLOWED_UPLOAD_TYPES = new Set([
+	'image/jpeg',
+	'image/png',
+	'image/gif',
+	'image/webp',
+	'image/avif',
+	'image/x-icon',
+	'video/mp4',
+	'video/webm',
+	'application/pdf',
+])
+
+/** O(1) route lookup map: "METHOD:route" → handler */
+const routeMap = new Map<string, RouteHandler>([
+	// Source editing
+	post('update', (body: Parameters<typeof handleUpdate>[0], mw) => handleUpdate(body, mw)),
+	post('insert-component', (body: Parameters<typeof handleInsertComponent>[0], mw) => handleInsertComponent(body, mw)),
+	post('remove-component', (body: Parameters<typeof handleRemoveComponent>[0], mw) => handleRemoveComponent(body, mw)),
+	post('add-array-item', (body: Parameters<typeof handleAddArrayItem>[0], mw) => handleAddArrayItem(body, mw)),
+	post('remove-array-item', (body: Parameters<typeof handleRemoveArrayItem>[0], mw) => handleRemoveArrayItem(body, mw)),
+
+	// Markdown CRUD
+	custom('GET', 'markdown/content', async ({ req, res }) => {
+		const filePath = getQuery({ req } as RouteContext).get('filePath')
+		if (!filePath) {
+			sendError(res, 'filePath query parameter required')
+			return
+		}
+		const result = await handleGetMarkdownContent(filePath)
+		if (!result) {
+			sendError(res, 'File not found', 404)
+			return
+		}
+		sendJson(res, result)
+	}),
+	custom('POST', 'markdown/update', async ({ req, res, manifestWriter }) => {
+		const body = await parseJsonBody<Parameters<typeof handleUpdateMarkdown>[0]>(req)
+		sendJson(res, await handleUpdateMarkdown(body, manifestWriter.getComponentDefinitions()))
+	}),
+	post('markdown/rename', (body: Parameters<typeof handleRenameMarkdown>[0]) => handleRenameMarkdown(body)),
+	postWithStatus('markdown/create', (body: Parameters<typeof handleCreateMarkdown>[0]) => handleCreateMarkdown(body)),
+	custom('POST', 'markdown/delete', async ({ req, res, manifestWriter, contentDir }) => {
+		const body = await parseJsonBody<Parameters<typeof handleDeleteMarkdown>[0]>(req)
+		const fullPath = path.resolve(getProjectRoot(), body.filePath?.replace(/^\//, '') ?? '')
+		expectedDeletions.add(fullPath)
+		const result = await handleDeleteMarkdown(body)
+		if (result.success) {
+			manifestWriter.setCollectionDefinitions(await scanCollections(contentDir))
+		} else {
+			expectedDeletions.delete(fullPath)
+		}
+		sendJson(res, result, result.success ? 200 : 400)
+	}),
+
+	// Media
+	custom('GET', 'media/list', async (ctx) => {
+		if (!requireMedia(ctx)) return
+		const params = getQuery(ctx)
+		const parsedLimit = parseInt(params.get('limit') ?? '50', 10)
+		const limit = Number.isNaN(parsedLimit) || parsedLimit < 1 ? 50 : Math.min(parsedLimit, 1000)
+		const folder = params.get('folder') ?? undefined
+		sendJson(ctx.res, await ctx.mediaAdapter.list({ limit, cursor: params.get('cursor') ?? undefined, folder }))
+	}),
+	custom('GET', 'media/project-images', async (ctx) => {
+		const excludeDir = ctx.mediaAdapter?.staticFiles?.dir
+		const items = await listProjectImages({ excludeDir })
+		sendJson(ctx.res, { items })
+	}),
+	custom('POST', 'media/upload', async (ctx) => {
+		if (!requireMedia(ctx)) return
+		const contentType = ctx.req.headers['content-type'] ?? ''
+		if (!contentType.includes('multipart/form-data')) {
+			sendError(ctx.res, 'Expected multipart/form-data')
+			return
+		}
+		const folder = getQuery(ctx).get('folder') ?? undefined
+		const body = await readBody(ctx.req, 50 * 1024 * 1024)
+		const file = parseMultipartFile(body, contentType)
+		if (!file) {
+			sendError(ctx.res, 'No file found in request')
+			return
+		}
+		// Block SVG (can contain scripts) unless explicitly served with safe headers
+		if (!ALLOWED_UPLOAD_TYPES.has(file.contentType)) {
+			sendError(ctx.res, `File type not allowed: ${file.contentType}`)
+			return
+		}
+		sendJson(ctx.res, await ctx.mediaAdapter.upload(file.buffer, file.filename, file.contentType, { folder }))
+	}),
+	custom('POST', 'media/folder', async (ctx) => {
+		if (!requireMedia(ctx)) return
+		if (!ctx.mediaAdapter.createFolder) {
+			sendError(ctx.res, 'Folder creation not supported by this storage adapter', 501)
+			return
+		}
+		const body = await parseJsonBody<{ folder: string }>(ctx.req)
+		if (!body.folder || typeof body.folder !== 'string') {
+			sendError(ctx.res, 'folder field is required')
+			return
+		}
+		if (body.folder.includes('..')) {
+			sendError(ctx.res, 'Invalid folder name')
+			return
+		}
+		const result = await ctx.mediaAdapter.createFolder(body.folder)
+		sendJson(ctx.res, result, result.success ? 200 : 400)
+	}),
+
+	// Page operations
+	postWithStatus('page/create', (body: Parameters<typeof handleCreatePage>[0]) => handleCreatePage(body)),
+	custom('POST', 'page/duplicate', async ({ req, res }) => {
+		const body = await parseJsonBody<Parameters<typeof handleDuplicatePage>[0]>(req)
+		const result = await handleDuplicatePage(body)
+		if (result.success && body.createRedirect) {
+			await handleAddRedirect({ source: body.sourcePagePath, destination: result.url!, statusCode: 307 })
+		}
+		sendJson(res, result, result.success ? 200 : 400)
+	}),
+	custom('POST', 'page/delete', async ({ req, res }) => {
+		const body = await parseJsonBody<Parameters<typeof handleDeletePage>[0]>(req)
+		const result = await handleDeletePage(body)
+		if (result.success && result.filePath) {
+			expectedDeletions.add(path.resolve(getProjectRoot(), result.filePath))
+		}
+		if (result.success && body.createRedirect && body.redirectTo) {
+			await handleAddRedirect({ source: body.pagePath, destination: body.redirectTo, statusCode: 307 })
+		}
+		sendJson(res, result, result.success ? 200 : 400)
+	}),
+	custom('GET', 'page/check-slug', async (ctx) => {
+		const slug = getQuery(ctx).get('slug')
+		if (!slug) {
+			sendError(ctx.res, 'slug query parameter required')
+			return
+		}
+		sendJson(ctx.res, await handleCheckSlugExists(slug))
+	}),
+	get('page/layouts', async () => ({ layouts: await handleGetLayouts() })),
+
+	// Redirects
+	get('redirects', () => handleGetRedirects()),
+	postWithStatus('redirects/add', (body: Parameters<typeof handleAddRedirect>[0]) => handleAddRedirect(body)),
+	postWithStatus('redirects/update', (body: Parameters<typeof handleUpdateRedirect>[0]) => handleUpdateRedirect(body)),
+	postWithStatus('redirects/delete', (body: Parameters<typeof handleDeleteRedirect>[0]) => handleDeleteRedirect(body)),
+
+	// Deployment
+	get('deployment/status', async () => ({ currentDeployment: null, pendingCount: 0, deploymentEnabled: false })),
+])
+
+export async function handleCmsApiRoute(
+	route: string,
+	req: IncomingMessage,
+	res: ServerResponse,
+	manifestWriter: ManifestWriter,
+	contentDir: string,
+	mediaAdapter?: MediaStorageAdapter,
+): Promise<void> {
+	const ctx: RouteContext = { req, res, route, manifestWriter, contentDir, mediaAdapter }
+
+	// Exact match lookup
+	const handler = routeMap.get(`${req.method}:${route}`)
+	if (handler) {
+		await handler(ctx)
+		return
+	}
+
+	// DELETE /_nua/cms/media/<id> — dynamic route with ID segment
+	if (req.method === 'DELETE' && route.startsWith('media/')) {
+		if (!requireMedia(ctx)) return
+		const id = route.slice('media/'.length)
+		if (!id || id === 'list' || id === 'upload') {
+			sendError(res, 'Not found', 404)
+			return
+		}
+		sendJson(res, await ctx.mediaAdapter!.delete(decodeURIComponent(id)))
+		return
+	}
+
+	sendError(res, 'Not found', 404)
+}