spsays-training/lib/ds.ts

/**
 * Data access layer for Dialectic Spiritualism (DS).
 *
 * Reads from MongoDB via Prisma.
 * DS is a large prose/dialogue book with 3 intro segments (front-pages,
 * foreword, preface) and 13 parent chapters, each containing philosopher
 * sub-chapters (e.g., "1-1" Socrates, "1-2" Plato, "1-3" Aristotle).
 * 38 philosopher sub-chapters total.
 *
 * 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
// ---------------------------------------------------------------------------

const BOOK = "ds";

/** Volume sentinel for books without volumes. */
const NO_VOLUME = 0;

// ---------------------------------------------------------------------------
// Types
// ---------------------------------------------------------------------------

export type DsMeta = {
  book: string;
  title: string;
  subtitle: string;
  author: string;
  year: number;
  description: string;
  totalChapters: number;
  chapters: DsParentChapter[];
};

export type DsParentChapter = {
  number: number;
  title: string;
  subChapters: DsSubChapterEntry[];
};

export type DsSubChapterEntry = {
  slug: string; // "1-1", "1-2", etc.
  title: string;
};

export type DsIntroSegment = {
  slug: string;
  title: string;
  type: string;
  book: string;
  order: number;
  paragraphs: string[];
};

export type DsChapter = {
  book: string;
  chapter: string; // "1-1", "2-1", etc.
  parentChapter: number;
  subChapter: number;
  title: string;
  parentTitle: string;
  type: string;
  paragraphs: string[];
};

/** Union type used in sidebar / table-of-contents navigation. */
export type DsSidebarItem = {
  /** URL-safe slug: "intro-front-pages", "1-1", "parent-1", etc. */
  slug: string;
  /** Human-readable label for the sidebar */
  label: string;
  /** "intro-segment" | "parent" | "sub-chapter" */
  type: string;
  /** Parent chapter number, or null for intro segments */
  parentChapter: number | null;
};

// ---------------------------------------------------------------------------
// HTML sanitisation
// ---------------------------------------------------------------------------

function sanitizeHtml(html: string): string {
  let clean = html.replace(/<script[\s>][\s\S]*?<\/script>/gi, "");
  clean = clean.replace(/<style[\s>][\s\S]*?<\/style>/gi, "");
  clean = clean.replace(/<iframe[\s>][\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 with sub-chapters, etc.)
 */
export async function getDsMeta(): Promise<DsMeta | null> {
  const meta = await prisma.bookMeta.findUnique({ where: { book: BOOK } });
  if (!meta) return null;
  return meta.data as unknown as DsMeta;
}

// ---------------------------------------------------------------------------
// Intro segments
// ---------------------------------------------------------------------------

/**
 * All intro segments, ordered by their `order` field.
 */
export async function getDsIntroSegments(): Promise<DsIntroSegment[]> {
  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-front-pages" (URL slug) and "front-pages" (raw slug).
 */
export async function getDsIntroSegment(
  slug: string,
): Promise<DsIntroSegment | null> {
  // 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 (sub-chapters like "1-1", "2-3", etc.)
// ---------------------------------------------------------------------------

/**
 * A sub-chapter by its slug (e.g. "1-1", "2-3").
 */
export async function getDsChapter(slug: string): Promise<DsChapter | null> {
  const doc = await prisma.proseChapter.findUnique({
    where: {
      book_volume_slug: {
        book: BOOK,
        volume: NO_VOLUME,
        slug,
      },
    },
  });
  if (!doc) return null;

  // Parse parentChapter and subChapter from slug "X-Y"
  const parts = slug.split("-");
  const parentChapter = parseInt(parts[0], 10);
  const subChapter = parseInt(parts[1], 10);

  // Derive parentTitle from meta if available
  const meta = await getDsMeta();
  const parentEntry = meta?.chapters.find((ch) => ch.number === parentChapter);
  const parentTitle = parentEntry?.title ?? "";

  return {
    book: doc.book,
    chapter: slug,
    parentChapter,
    subChapter,
    title: doc.title,
    parentTitle,
    type: doc.type,
    paragraphs: normalizeParagraphs(doc.paragraphs),
  };
}

// ---------------------------------------------------------------------------
// Unified content accessor
// ---------------------------------------------------------------------------

/**
 * Get content by URL slug.
 *
 *   "intro-front-pages"  → intro segment
 *   "intro-foreword"     → intro segment
 *   "intro-preface"      → intro segment
 *   "1-1", "2-3", etc.   → sub-chapter
 */
export async function getDsContent(
  slug: string,
): Promise<DsChapter | DsIntroSegment | null> {
  if (slug.startsWith("intro-")) {
    return getDsIntroSegment(slug);
  }

  // Sub-chapter slug like "1-1", "2-3"
  return getDsChapter(slug);
}

// ---------------------------------------------------------------------------
// Sidebar navigation
// ---------------------------------------------------------------------------

/**
 * Build the full sidebar navigation list with hierarchical structure.
 *
 * Order: front-pages → foreword → preface
 *        → parent-1 (label) → 1-1, 1-2, 1-3 → parent-2 (label) → 2-1, 2-2, ...
 *
 * "parent" type items are non-clickable headings. Only "intro-segment" and
 * "sub-chapter" items are navigable pages.
 */
export async function getDsSidebarItems(): Promise<DsSidebarItem[]> {
  const [meta, allDocs] = await Promise.all([
    getDsMeta(),
    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: DsSidebarItem[] = [];

  // Intro segments (all come before chapters — no back matter for DS)
  for (const doc of allDocs) {
    if (doc.type === "intro-segment") {
      items.push({
        slug: doc.slug,
        label: doc.title,
        type: "intro-segment",
        parentChapter: null,
      });
    }
  }

  // Chapters — grouped by parent chapter with sub-chapters
  for (const ch of meta.chapters) {
    // Parent heading (non-clickable label)
    items.push({
      slug: `parent-${ch.number}`,
      label: `${ch.number}. ${ch.title}`,
      type: "parent",
      parentChapter: ch.number,
    });

    // Sub-chapters under this parent
    for (const sub of ch.subChapters) {
      items.push({
        slug: sub.slug,
        label: sub.title,
        type: "sub-chapter",
        parentChapter: ch.number,
      });
    }
  }

  return items;
}

/**
 * Get the flat list of navigable sidebar items (excludes "parent" headings).
 * Used for prev/next navigation.
 */
export function getNavigableItems(items: DsSidebarItem[]): DsSidebarItem[] {
  return items.filter((item) => item.type !== "parent");
}