/** * Data access layer for Perfect Questions Perfect Answers (PQPA). * * Reads from MongoDB via Prisma, same as the rest of the app. * PQPA is a prose/dialogue book with no volume structure — * we use volume=0 as the sentinel for "no volumes". * * Collections used: * - book_meta (via Prisma BookMeta model) * - prose_chapters (via Prisma ProseChapter model) */ import { prisma } from "@/lib/db"; import type { JsonValue } from "@prisma/client/runtime/library"; // --------------------------------------------------------------------------- // Constants // --------------------------------------------------------------------------- /** Volume sentinel for books without volumes. */ const NO_VOLUME = 0; const BOOK = "pqpa"; // --------------------------------------------------------------------------- // Types // --------------------------------------------------------------------------- export type PqpaMeta = { book: string; title: string; author: string; year: number; description: string; totalChapters: number; chapters: PqpaChapterEntry[]; }; export type PqpaChapterEntry = { number: number; title: string; }; export type PqpaIntroSegment = { slug: string; title: string; type: string; book: string; order: number; paragraphs: string[]; }; export type PqpaChapter = { book: string; chapter: number | null; title: string; type: string; slug?: string; paragraphs: string[]; }; /** Union type used in sidebar / table-of-contents navigation. */ export type PqpaSidebarItem = { /** URL-safe slug: "intro-front-pages", "1", "9", "concluding-words" */ slug: string; /** Human-readable label for the sidebar */ label: string; /** "intro-segment" | "chapter" | "conclusion" */ type: string; /** Chapter number, or null for non-chapter items */ chapter: number | null; }; // --------------------------------------------------------------------------- // HTML sanitisation (mirrors lib/api.ts) // --------------------------------------------------------------------------- function sanitizeHtml(html: string): string { let clean = html.replace(/][\s\S]*?<\/script>/gi, ""); clean = clean.replace(/][\s\S]*?<\/style>/gi, ""); clean = clean.replace(/][\s\S]*?<\/iframe>/gi, ""); clean = clean.replace( /<\/?(?:script|style|iframe|object|embed|form|input|textarea|select|button)[^>]*>/gi, "", ); clean = clean.replace(/\s+on\w+\s*=\s*(?:"[^"]*"|'[^']*'|[^\s>]+)/gi, ""); clean = clean.replace(/href\s*=\s*"javascript:[^"]*"/gi, 'href=""'); clean = clean.replace(/href\s*=\s*'javascript:[^']*'/gi, "href=''"); return clean; } /** Normalize paragraphs — handles both native arrays and stringified JSON. */ function normalizeParagraphs(paragraphs: string[] | JsonValue): string[] { let result: string[]; if (typeof paragraphs === "string") { try { const parsed = JSON.parse(paragraphs); result = Array.isArray(parsed) ? parsed : [paragraphs]; } catch { result = [paragraphs]; } } else if (Array.isArray(paragraphs)) { result = paragraphs as string[]; } else { result = []; } return result.map(sanitizeHtml); } // --------------------------------------------------------------------------- // Book meta // --------------------------------------------------------------------------- /** * Book-level metadata (title, author, chapter list, etc.) */ export async function getPqpaMeta(): Promise { const meta = await prisma.bookMeta.findUnique({ where: { book: BOOK } }); if (!meta) return null; return meta.data as unknown as PqpaMeta; } // --------------------------------------------------------------------------- // Intro segments // --------------------------------------------------------------------------- /** * All intro segments, ordered by their `order` field. */ export async function getPqpaIntroSegments(): Promise { const results = await prisma.proseChapter.findMany({ where: { book: BOOK, volume: NO_VOLUME, type: "intro-segment" }, orderBy: { order: "asc" }, }); return results.map((doc) => ({ slug: doc.slug, title: doc.title, type: doc.type, book: doc.book, order: doc.order, paragraphs: normalizeParagraphs(doc.paragraphs), })); } /** * A single intro segment by slug. * Accepts both "intro-introduction" (URL slug) and "introduction" (raw slug). */ export async function getPqpaIntroSegment( slug: string, ): Promise { // DB stores with "intro-" prefix; accept either form const dbSlug = slug.startsWith("intro-") ? slug : `intro-${slug}`; const doc = await prisma.proseChapter.findUnique({ where: { book_volume_slug: { book: BOOK, volume: NO_VOLUME, slug: dbSlug }, }, }); if (!doc) return null; return { slug: doc.slug, title: doc.title, type: doc.type, book: doc.book, order: doc.order, paragraphs: normalizeParagraphs(doc.paragraphs), }; } // --------------------------------------------------------------------------- // Chapters // --------------------------------------------------------------------------- /** * A numbered chapter (1–9). */ export async function getPqpaChapter( chapterNum: number, ): Promise { if (chapterNum < 1 || chapterNum > 9 || !Number.isInteger(chapterNum)) { return null; } const doc = await prisma.proseChapter.findUnique({ where: { book_volume_slug: { book: BOOK, volume: NO_VOLUME, slug: String(chapterNum), }, }, }); if (!doc) return null; return { book: doc.book, chapter: doc.chapter, title: doc.title, type: doc.type, slug: doc.slug, paragraphs: normalizeParagraphs(doc.paragraphs), }; } /** * The concluding words section. */ export async function getPqpaConcludingWords(): Promise { const doc = await prisma.proseChapter.findUnique({ where: { book_volume_slug: { book: BOOK, volume: NO_VOLUME, slug: "concluding-words", }, }, }); if (!doc) return null; return { book: doc.book, chapter: doc.chapter, title: doc.title, type: doc.type, slug: doc.slug, paragraphs: normalizeParagraphs(doc.paragraphs), }; } // --------------------------------------------------------------------------- // Unified content accessor // --------------------------------------------------------------------------- /** * Get content by URL slug. * * "intro-front-pages" → intro segment * "intro-introduction" → intro segment * "intro-about-the-author" → intro segment * "1" … "9" → chapter * "concluding-words" → concluding section */ export async function getPqpaContent( slug: string, ): Promise { if (slug.startsWith("intro-")) { return getPqpaIntroSegment(slug); } if (slug === "concluding-words") { return getPqpaConcludingWords(); } const num = Number(slug); if (!Number.isNaN(num) && Number.isInteger(num) && num >= 1 && num <= 9) { return getPqpaChapter(num); } return null; } // --------------------------------------------------------------------------- // Sidebar navigation // --------------------------------------------------------------------------- /** * Build the full sidebar navigation list. * * Order: front-pages → introduction → chapters 1–9 → concluding-words → about-the-author */ export async function getPqpaSidebarItems(): Promise { const [meta, allDocs] = await Promise.all([ getPqpaMeta(), prisma.proseChapter.findMany({ where: { book: BOOK, volume: NO_VOLUME }, orderBy: { order: "asc" }, select: { slug: true, title: true, type: true, chapter: true, order: true }, }), ]); if (!meta) return []; const items: PqpaSidebarItem[] = []; // Intro segments that come BEFORE chapters (order < 99) for (const doc of allDocs) { if (doc.type === "intro-segment" && (doc.order ?? 0) < 99) { items.push({ slug: doc.slug, label: doc.title, type: "intro-segment", chapter: null, }); } } // Chapters 1–9 (use meta.chapters for consistent title/ordering) for (const ch of meta.chapters) { items.push({ slug: String(ch.number), label: `Chapter ${ch.number}: ${ch.title}`, type: "chapter", chapter: ch.number, }); } // Concluding words const cw = allDocs.find((d) => d.type === "conclusion"); if (cw) { items.push({ slug: cw.slug, label: cw.title, type: "conclusion", chapter: null, }); } // Intro segments that come AFTER chapters (order >= 99, e.g. about-the-author) for (const doc of allDocs) { if (doc.type === "intro-segment" && (doc.order ?? 0) >= 99) { items.push({ slug: doc.slug, label: doc.title, type: "intro-segment", chapter: null, }); } } return items; }