@fullstackdatasolutions/articles 0.8.0 → 0.8.2

package/dist/nextjs.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/nextjs.ts","../src/server-articles.ts","../src/markdown.ts","../src/errorReporting.ts"],"sourcesContent":["// Next.js API route handler factory — Node.js runtime only\n// Import from '@fullstackdatasolutions/articles/nextjs'\nimport type { NextRequest } from 'next/server'\nimport { getArticleMarkdownResponse } from './server-articles'\nimport type { ArticlesConfig } from './articlesConfig'\n\n/**\n * Returns a Next.js App Router GET handler for serving article markdown.\n *\n * Usage in app/api/articles-markdown/[...slug]/route.ts:\n *   import { createArticleMarkdownHandler } from '@fullstackdatasolutions/articles/nextjs'\n *   import { siteConfig } from '@/config/articles'\n *   export const { GET } = createArticleMarkdownHandler(siteConfig)\n */\nexport function createArticleMarkdownHandler(config: ArticlesConfig) {\n  async function GET(\n    _request: NextRequest,\n    context: { params: Promise<Record<string, string | string[]>> }\n  ) {\n    const params = await context.params\n    const slugParts = params['slug']\n    const slug = Array.isArray(slugParts) ? slugParts.join('/') : (slugParts ?? '')\n    const cleanSlug = slug.endsWith('.md') ? slug.slice(0, -3) : slug\n    return getArticleMarkdownResponse(cleanSlug, config)\n  }\n  return { GET }\n}\n","import { cache } from 'react'\nimport matter from 'gray-matter'\nimport fs from 'node:fs'\nimport path from 'node:path'\nimport readingTime from 'reading-time'\nimport { markdownToHtml, extractToc } from './markdown'\nimport type { Article, CategoryInfo, FaqItem, HowToStep } from './articleTypes'\nimport type { ArticlesConfig } from './articlesConfig'\nimport { reportArticlesError } from './errorReporting'\n\nconst articlesDirectory = path.join(/* turbopackIgnore: true */ process.cwd(), 'public/articles')\n\nfunction getReadingTime(content: string): string {\n  return readingTime(content).text\n}\n\nfunction findArticleImage(slug: string): string | null {\n  try {\n    const articleDir = path.join(articlesDirectory, slug)\n    const entries: (fs.Dirent | string)[] = fs.readdirSync(articleDir, { withFileTypes: true })\n    const names = entries\n      .map((entry) => {\n        if (typeof entry === 'string') return entry\n        if (entry && typeof entry.name === 'string') return entry.name\n        return null\n      })\n      .filter((name): name is string => Boolean(name))\n    const imageExtensions = ['.png', '.jpg', '.jpeg', '.gif', '.webp']\n    const imageFileName = names.find((name) =>\n      imageExtensions.some((ext) => name.toLowerCase().endsWith(ext))\n    )\n    return imageFileName ? sanitizeImagePath(imageFileName, slug) : null\n  } catch {\n    return null\n  }\n}\n\nfunction sanitizeImagePath(rawPath: string, articleSlug: string): string | null {\n  if (!rawPath || typeof rawPath !== 'string') return null\n  const cleanPath = rawPath.replaceAll(/[\\x00-\\x1f\\x7f-\\x9f]/g, '')\n  if (cleanPath.startsWith('http://') || cleanPath.startsWith('https://')) return cleanPath\n  if (cleanPath.includes('..') || cleanPath.includes('\\\\') || cleanPath.startsWith('/')) {\n    reportArticlesError({\n      code: 'unsafe-image-path',\n      message: 'Rejected unsafe article image path.',\n      context: { articleSlug, path: cleanPath },\n    })\n    return null\n  }\n  if (!/^[a-zA-Z0-9._/-]+$/.test(cleanPath)) {\n    reportArticlesError({\n      code: 'unsafe-image-path',\n      message: 'Rejected article image path with invalid characters.',\n      context: { articleSlug, path: cleanPath },\n    })\n    return null\n  }\n  if (cleanPath.includes('/')) {\n    const normalizedPath = path.normalize(cleanPath)\n    if (normalizedPath.startsWith('..') || normalizedPath.includes('../')) {\n      reportArticlesError({\n        code: 'unsafe-image-path',\n        message: 'Rejected article image path traversal attempt.',\n        context: { articleSlug, path: cleanPath },\n      })\n      return null\n    }\n    return `/articles/${articleSlug}/${cleanPath}`\n  }\n  return `/articles/${articleSlug}/${cleanPath}`\n}\n\nfunction findArticleFile(slug: string): { filePath: string; contentType: 'md' | 'mdx' } | null {\n  const mdPath = path.join(articlesDirectory, slug, 'article.md')\n  const mdxPath = path.join(articlesDirectory, slug, 'article.mdx')\n  if (fs.existsSync(mdPath)) return { filePath: mdPath, contentType: 'md' }\n  if (fs.existsSync(mdxPath)) return { filePath: mdxPath, contentType: 'mdx' }\n  return null\n}\n\nexport function getAvailableArticleSlugs(): string[] {\n  try {\n    if (!fs.existsSync(articlesDirectory)) return []\n    return walkArticleDir(articlesDirectory, '')\n  } catch (error) {\n    reportArticlesError({\n      code: 'article-directory-read-failed',\n      message: 'Unable to read articles directory.',\n      error,\n      context: { directory: articlesDirectory },\n    })\n    return []\n  }\n}\n\nfunction walkArticleDir(dir: string, baseSlug: string): string[] {\n  const slugs: string[] = []\n  try {\n    const items = fs.readdirSync(dir, { withFileTypes: true })\n    for (const item of items) {\n      if (!item.isDirectory()) continue\n      const slug = baseSlug ? `${baseSlug}/${item.name}` : item.name\n      if (findArticleFile(slug) !== null) {\n        slugs.push(slug)\n      }\n      slugs.push(...walkArticleDir(path.join(dir, item.name), slug))\n    }\n  } catch {\n    // ignore unreadable directories\n  }\n  return slugs\n}\n\nfunction parseDateField(rawDate: unknown): string | undefined {\n  if (!rawDate) return undefined\n  try {\n    const parsed = new Date(rawDate as string)\n    if (!Number.isNaN(parsed.getTime())) return parsed.toISOString().split('T')[0]\n  } catch {\n    // ignore invalid dates\n  }\n  return undefined\n}\n\nfunction resolveFeaturedImage(rawImage: unknown, slug: string): string {\n  const img = typeof rawImage === 'string' ? rawImage : ''\n  if (img && !img.startsWith('http')) return sanitizeImagePath(img, slug) || '/placeholder-logo.png'\n  if (!img) return findArticleImage(slug) || '/placeholder-logo.png'\n  return img\n}\n\nfunction parseFaqItems(raw: unknown): FaqItem[] | undefined {\n  if (!Array.isArray(raw)) return undefined\n  const items = raw.filter(\n    (item): item is FaqItem =>\n      typeof item === 'object' &&\n      item !== null &&\n      typeof (item as FaqItem).question === 'string' &&\n      typeof (item as FaqItem).answer === 'string'\n  )\n  return items.length ? items : undefined\n}\n\nfunction parseHowToSteps(raw: unknown): HowToStep[] | undefined {\n  if (!Array.isArray(raw)) return undefined\n  const steps = raw.filter(\n    (item): item is HowToStep =>\n      typeof item === 'object' &&\n      item !== null &&\n      typeof (item as HowToStep).name === 'string' &&\n      typeof (item as HowToStep).text === 'string'\n  )\n  return steps.length ? steps : undefined\n}\n\nasync function getArticleSummary(slug: string): Promise<Article | null> {\n  try {\n    const found = findArticleFile(slug)\n    if (!found) return null\n    const fileContent = fs.readFileSync(found.filePath, 'utf8')\n    const { data, content: markdownContent } = matter(fileContent)\n    const readTime = getReadingTime(markdownContent)\n    const allTags: string[] = Array.isArray(data.tags)\n      ? data.tags.filter((t: unknown) => typeof t === 'string' && String(t).trim())\n      : []\n    const categories: string[] =\n      allTags.length > 0 ? allTags.map((t: string) => t.replaceAll('-', ' ').trim()) : ['Campaigns']\n    return {\n      slug,\n      title: data.title || slug.replaceAll('-', ' '),\n      excerpt: data.excerpt || '',\n      date: parseDateField(data.date),\n      lastmod: parseDateField(data.lastmod),\n      author: data.author || 'Andrew Blase',\n      category: categories[0],\n      categories,\n      readTime,\n      featuredImage: resolveFeaturedImage(data.featuredImage, slug),\n      tags: data.tags || [],\n      contentType: found.contentType,\n      draft: data.draft === true,\n      faq: parseFaqItems(data.faq),\n      howTo: parseHowToSteps(data.howTo),\n      canonicalUrl: typeof data.canonicalUrl === 'string' ? data.canonicalUrl : undefined,\n      articleType: typeof data.articleType === 'string' ? data.articleType : undefined,\n      series: typeof data.series === 'string' ? data.series : undefined,\n      aiCrawl: data.aiCrawl === true,\n    }\n  } catch (error) {\n    reportArticlesError({\n      code: 'article-load-failed',\n      message: 'Unable to load article summary.',\n      error,\n      context: { slug },\n    })\n    return null\n  }\n}\n\nexport const getArticleMetadata = cache(async (slug: string): Promise<Article | null> => {\n  try {\n    const summary = await getArticleSummary(slug)\n    if (!summary) return null\n    const found = findArticleFile(slug)\n    if (!found) return null\n    const fileContent = fs.readFileSync(found.filePath, 'utf8')\n    const { content: markdownContent } = matter(fileContent)\n    const toc = await extractToc(markdownContent)\n    let htmlContent: string | undefined\n    let mdxSource: string | undefined\n    if (found.contentType === 'mdx') {\n      mdxSource = markdownContent\n    } else {\n      htmlContent = await markdownToHtml(markdownContent, slug)\n    }\n    return { ...summary, content: markdownContent, htmlContent, mdxSource, toc }\n  } catch (error) {\n    reportArticlesError({\n      code: 'article-load-failed',\n      message: 'Unable to load article metadata.',\n      error,\n      context: { slug },\n    })\n    return null\n  }\n})\n\nexport const getAllArticles = cache(async (): Promise<Article[]> => {\n  const slugs = getAvailableArticleSlugs()\n  const articles = await Promise.all(slugs.map((slug) => getArticleSummary(slug)))\n  const currentDate = new Date().toISOString().split('T')[0]\n  return articles\n    .filter((article): article is Article => article !== null)\n    .filter((article) => !article.date || article.date <= currentDate)\n    .filter((article) => !(article.draft && process.env.NODE_ENV === 'production'))\n    .sort((a, b) => {\n      if (!a.date && !b.date) return 0\n      if (!a.date) return 1\n      if (!b.date) return -1\n      return new Date(b.date).getTime() - new Date(a.date).getTime()\n    })\n})\n\nexport async function getAdjacentArticles(\n  currentSlug: string\n): Promise<{ previous: Article | null; next: Article | null }> {\n  const allArticles = await getAllArticles()\n  const currentIndex = allArticles.findIndex((article) => article.slug === currentSlug)\n  if (currentIndex === -1) return { previous: null, next: null }\n  const previous = currentIndex < allArticles.length - 1 ? allArticles[currentIndex + 1] : null\n  const next = currentIndex > 0 ? allArticles[currentIndex - 1] : null\n  return { previous, next }\n}\n\nexport async function getArticleMarkdown(slug: string): Promise<string | null> {\n  try {\n    const summary = await getArticleSummary(slug)\n    if (!summary?.aiCrawl) return null\n    const found = findArticleFile(slug)\n    if (!found) return null\n    const fileContent = fs.readFileSync(found.filePath, 'utf8')\n    const { content: markdownContent } = matter(fileContent)\n    return markdownContent\n  } catch (error) {\n    reportArticlesError({\n      code: 'article-markdown-load-failed',\n      message: 'Unable to load article markdown.',\n      error,\n      context: { slug },\n    })\n    return null\n  }\n}\n\nexport async function getArticleMarkdownResponse(\n  slug: string,\n  config: ArticlesConfig\n): Promise<Response> {\n  const markdown = await getArticleMarkdown(slug)\n  if (markdown === null) return new Response('Not Found', { status: 404 })\n  const article = await getArticleMetadata(slug)\n  return new Response(markdown, {\n    headers: {\n      'Content-Type': 'text/markdown; charset=utf-8',\n      'Cache-Control': 'public, max-age=3600, s-maxage=3600',\n      ...(article ? getArticleAiHeaders(article, config) : {}),\n    },\n  })\n}\n\nexport function getArticleMarkdownUrl(\n  article: Pick<Article, 'slug' | 'aiCrawl'>,\n  config?: Pick<ArticlesConfig, 'siteUrl'>\n): string | undefined {\n  if (article.aiCrawl !== true) return undefined\n  const pathname = `/articles/${article.slug}.md`\n  if (!config) return pathname\n  return `${config.siteUrl.replace(/\\/$/, '')}${pathname}`\n}\n\nexport function getArticleAiHeaders(\n  article: Pick<Article, 'slug' | 'aiCrawl'>,\n  config?: Pick<ArticlesConfig, 'siteUrl'>\n): Record<string, string> {\n  const markdownUrl = getArticleMarkdownUrl(article, config)\n  if (markdownUrl) {\n    return {\n      Link: `<${markdownUrl}>; rel=\"alternate\"; type=\"text/markdown\"`,\n    }\n  }\n  return {\n    'X-Robots-Tag': 'noai, noimageai',\n  }\n}\n\nexport async function getAiRobotsTxtRules(): Promise<string> {\n  const articles = await getAllArticles()\n  const blockedArticles = articles.filter((article) => article.aiCrawl !== true)\n  if (blockedArticles.length === 0) return ''\n\n  const aiCrawlers = [\n    'GPTBot',\n    'ChatGPT-User',\n    'CCBot',\n    'ClaudeBot',\n    'Claude-User',\n    'PerplexityBot',\n    'Google-Extended',\n  ]\n  const disallowRules = blockedArticles\n    .map((article) => `Disallow: /articles/${article.slug}`)\n    .join('\\n')\n\n  return aiCrawlers\n    .map((crawler) => [`User-agent: ${crawler}`, disallowRules].join('\\n'))\n    .join('\\n\\n')\n}\n\nexport async function searchArticles(query: string, config?: ArticlesConfig): Promise<Article[]> {\n  if (!query?.trim()) return getAllArticles()\n  const articles = await getAllArticles()\n  const searchTerm = query.toLowerCase().trim()\n  const includeAuthor = config?.showAuthor !== false\n  return articles.filter((article) => {\n    const matchesTitle = article.title.toLowerCase().includes(searchTerm)\n    const matchesExcerpt = article.excerpt.toLowerCase().includes(searchTerm)\n    const matchesAuthor = includeAuthor && article.author.toLowerCase().includes(searchTerm)\n    const matchesCategory = article.categories.some((cat) => cat.toLowerCase().includes(searchTerm))\n    const matchesTags = article.tags?.some((tag) => tag.toLowerCase().includes(searchTerm))\n    return (\n      matchesTitle || matchesExcerpt || matchesAuthor || matchesCategory || Boolean(matchesTags)\n    )\n  })\n}\n\nexport function categoryToSlug(category: string): string {\n  return category\n    .toLowerCase()\n    .replaceAll(/\\s+/g, '-')\n    .replaceAll(/[^a-z0-9-]/g, '')\n}\n\nexport async function getAllCategories(): Promise<CategoryInfo[]> {\n  const articles = await getAllArticles()\n  const categoryMap = new Map<string, { count: number; featuredImage: string }>()\n  for (const article of articles) {\n    for (const cat of article.categories) {\n      if (!categoryMap.has(cat)) {\n        categoryMap.set(cat, { count: 0, featuredImage: article.featuredImage })\n      }\n      categoryMap.get(cat)!.count++\n    }\n  }\n  return Array.from(categoryMap.entries())\n    .map(([name, { count, featuredImage }]) => ({\n      name,\n      slug: categoryToSlug(name),\n      count,\n      featuredImage,\n    }))\n    .sort((a, b) => b.count - a.count)\n}\n\nexport async function getArticlesByCategory(categorySlug: string): Promise<Article[]> {\n  const articles = await getAllArticles()\n  return articles.filter((article) =>\n    article.categories.some((cat) => categoryToSlug(cat) === categorySlug)\n  )\n}\n\nexport { sanitizeImagePath }\n","import type { Element, Root, ElementContent } from 'hast'\nimport rehypePrism from 'rehype-prism-plus'\nimport rehypeSanitize from 'rehype-sanitize'\nimport rehypeSlug from 'rehype-slug'\nimport rehypeStringify from 'rehype-stringify'\nimport { remark } from 'remark'\nimport remarkGfm from 'remark-gfm'\nimport remarkGithubBlockquoteAlert from 'remark-github-blockquote-alert'\nimport remarkParse from 'remark-parse'\nimport remarkRehype from 'remark-rehype'\nimport { Plugin } from 'unified'\nimport { visit } from 'unist-util-visit'\nimport type { TocItem } from './articleTypes'\nimport { reportArticlesError } from './errorReporting'\n\n// Import the sanitizeImagePath function\nfunction sanitizeImagePath(rawPath: string, articleSlug: string): string | null {\n  if (!rawPath || typeof rawPath !== 'string') {\n    return null\n  }\n\n  // Remove any null bytes or control characters\n  const cleanPath = rawPath.replaceAll(/[\\x00-\\x1f\\x7f-\\x9f]/g, '')\n\n  // Check for absolute URLs (http/https)\n  if (cleanPath.startsWith('http://') || cleanPath.startsWith('https://')) {\n    // For external URLs, just return as-is (they're safe)\n    return cleanPath\n  }\n\n  // For relative paths, ensure they don't contain dangerous patterns\n  if (cleanPath.includes('..') || cleanPath.includes('\\\\') || cleanPath.startsWith('/')) {\n    reportArticlesError({\n      code: 'unsafe-image-path',\n      message: 'Rejected unsafe markdown image path.',\n      context: { articleSlug, path: cleanPath },\n    })\n    return null\n  }\n\n  // Only allow alphanumeric characters, hyphens, underscores, dots, and forward slashes\n  if (!/^[a-zA-Z0-9._/-]+$/.test(cleanPath)) {\n    reportArticlesError({\n      code: 'unsafe-image-path',\n      message: 'Rejected markdown image path with invalid characters.',\n      context: { articleSlug, path: cleanPath },\n    })\n    return null\n  }\n\n  // Construct safe path within articles directory\n  if (cleanPath.includes('/')) {\n    // Relative path, ensure it's within the article directory\n    const normalizedPath = cleanPath.replaceAll('\\\\', '/')\n    if (normalizedPath.startsWith('..') || normalizedPath.includes('../')) {\n      reportArticlesError({\n        code: 'unsafe-image-path',\n        message: 'Rejected markdown image path traversal attempt.',\n        context: { articleSlug, path: cleanPath },\n      })\n      return null\n    }\n    return `/articles/${articleSlug}/${normalizedPath}`\n  } else {\n    // Just a filename, construct full path\n    return `/articles/${articleSlug}/${cleanPath}`\n  }\n}\n\nfunction styleFootnoteLinks(nodes: ElementContent[]): void {\n  nodes.forEach((n) => {\n    if (n.type !== 'element') return\n    const el = n as Element\n    if (el.tagName === 'a') {\n      const isBackRef =\n        el.properties?.['dataFootnoteBackref'] !== undefined ||\n        (el.children[0]?.type === 'text' && el.children[0].value === '↩')\n      if (isBackRef) {\n        el.properties.className = 'text-primary hover:underline ml-1'\n        if (typeof el.properties.href === 'string') {\n          el.properties.href = el.properties.href.replaceAll('#user-content-fnref-', '#ref-')\n        }\n      } else {\n        el.properties.className = 'text-primary hover:underline break-all'\n      }\n    }\n    if (el.children) styleFootnoteLinks(el.children)\n  })\n}\n\nfunction processFootnoteRef(node: Element): void {\n  if (\n    node.tagName !== 'sup' ||\n    node.children?.[0]?.type !== 'element' ||\n    (node.children[0] as Element).tagName !== 'a'\n  )\n    return\n\n  const link = node.children[0] as Element\n  const href = link.properties?.href\n  if (typeof href !== 'string' || !href.startsWith('#user-content-fn-')) return\n\n  delete link.properties.target\n  delete link.properties.rel\n  link.properties.className = 'text-primary hover:underline'\n  link.properties.href = href.replaceAll('#user-content-fn-', '#footnote-')\n\n  if (typeof node.properties?.id === 'string') {\n    link.properties.id = node.properties.id.replaceAll('user-content-fnref-', 'ref-')\n    delete node.properties.id\n  }\n\n  if (link.children?.[0]?.type === 'text') {\n    link.children[0].value = `[${link.children[0].value}]`\n  }\n}\n\nfunction processFootnotesSection(node: Element): void {\n  const cls = node.properties?.className\n  const isFootnotes =\n    node.tagName === 'section' &&\n    (Array.isArray(cls) ? cls.includes('footnotes') : cls === 'footnotes')\n  if (!isFootnotes) return\n\n  const olCandidate = node.children.find(\n    (child) => child.type === 'element' && (child as Element).tagName === 'ol'\n  )\n  if (olCandidate?.type !== 'element') return\n\n  const ol = olCandidate as Element\n  ol.properties.className = 'list-decimal ml-6 space-y-2 text-sm text-muted-foreground'\n\n  ol.children.forEach((li) => {\n    if (li.type !== 'element' || li.tagName !== 'li') return\n    const liEl = li as Element\n\n    if (liEl.properties) {\n      liEl.properties.className = 'pl-2'\n      if (typeof liEl.properties.id === 'string') {\n        liEl.properties.id = liEl.properties.id.replaceAll('user-content-fn-', 'footnote-')\n      }\n    }\n\n    const pIndex = liEl.children.findIndex(\n      (child) => child.type === 'element' && (child as Element).tagName === 'p'\n    )\n    if (pIndex !== -1) {\n      const p = liEl.children[pIndex] as Element\n      liEl.children.splice(pIndex, 1, ...p.children)\n    }\n\n    styleFootnoteLinks(liEl.children)\n  })\n\n  const hr: Element = {\n    type: 'element',\n    tagName: 'hr',\n    properties: { className: 'my-8 border-border' },\n    children: [],\n  }\n  const h3: Element = {\n    type: 'element',\n    tagName: 'h3',\n    properties: { className: 'text-lg font-semibold mb-4' },\n    children: [{ type: 'text', value: 'References' }],\n  }\n\n  node.children = [hr, h3, ol]\n  if (node.properties) node.properties.className = undefined\n}\n\nexport const customRenderer: Plugin<[], Root> = () => {\n  return (tree: Root) => {\n    // First pass: Apply general styles\n    visit(tree, 'element', (node: Element) => {\n      if (node.tagName) {\n        const props = node.properties || {}\n\n        switch (node.tagName) {\n          case 'h1':\n            props.className = 'text-3xl font-bold text-foreground mt-8 mb-4 scroll-mt-20'\n            break\n          case 'h2':\n            props.className = 'text-2xl font-semibold text-foreground mt-6 mb-3 scroll-mt-20'\n            break\n          case 'h3':\n            props.className = 'text-xl font-semibold text-foreground mt-4 mb-2 scroll-mt-20'\n            break\n          case 'h4':\n            props.className = 'text-lg font-semibold text-foreground mt-3 mb-2 scroll-mt-20'\n            break\n          case 'p':\n            props.className = 'text-muted-foreground leading-relaxed mb-4'\n            break\n          case 'a': {\n            props.className = 'text-primary hover:underline transition-colors duration-200'\n            const href = typeof props.href === 'string' ? props.href : ''\n            if (!href.startsWith('#')) {\n              props.target = '_blank'\n              props.rel = 'noopener noreferrer'\n            }\n            break\n          }\n          case 'ul':\n            props.className = 'list-disc list-inside mb-4 space-y-2 ml-4'\n            break\n          case 'ol':\n            props.className = 'list-decimal list-inside mb-4 space-y-2 ml-4'\n            break\n          case 'li':\n            props.className = 'mb-1'\n            break\n          case 'blockquote':\n            props.className = 'border-l-4 border-primary pl-4 italic my-4 text-muted-foreground'\n            break\n          case 'code':\n            props.className =\n              (props.className ? props.className + ' ' : '') +\n              'bg-muted px-1 py-0.5 rounded text-sm font-mono'\n            break\n          case 'pre':\n            props.className = 'bg-muted rounded-lg p-4 overflow-x-auto my-4'\n            break\n          case 'img':\n            props.className = 'rounded-lg my-6 w-full max-w-2xl mx-auto'\n            break\n          case 'table':\n            props.className = 'border-collapse border border-border my-4 w-full'\n            break\n          case 'th':\n            props.className = 'border border-border px-2 py-1 bg-muted font-semibold'\n            break\n          case 'td':\n            props.className = 'border border-border px-2 py-1'\n            break\n          case 'hr':\n            props.className = 'my-8 border-border'\n            break\n          default:\n            break\n        }\n\n        node.properties = props\n      }\n    })\n\n    // Second pass: Fix footnotes and references\n    visit(tree, 'element', (node: Element) => {\n      processFootnoteRef(node)\n      processFootnotesSection(node)\n    })\n  }\n}\n\n// Custom rehype plugin to process image URLs\nconst rehypeProcessImages: Plugin<[{ articleSlug?: string }], Root> = (options = {}) => {\n  return (tree: Root) => {\n    visit(tree, 'element', (node: Element) => {\n      if (node.tagName === 'img' && node.properties) {\n        const src = node.properties.src\n        if (src && typeof src === 'string' && options.articleSlug) {\n          // Sanitize the image path\n          const sanitizedSrc = sanitizeImagePath(src, options.articleSlug)\n          if (sanitizedSrc) {\n            node.properties.src = sanitizedSrc\n          } else {\n            // If sanitization fails, use a placeholder\n            reportArticlesError({\n              code: 'unsafe-image-path',\n              message: 'Using placeholder for unsafe markdown image path.',\n              context: { articleSlug: options.articleSlug, path: src },\n            })\n            node.properties.src = '/placeholder-logo.png'\n          }\n        }\n      }\n    })\n  }\n}\n\nexport async function markdownToHtml(markdown: string, articleSlug?: string) {\n  try {\n    // Start building the remark processor\n    let processor = remark()\n      .use(remarkParse)\n      .use(remarkGfm)\n      .use(remarkGithubBlockquoteAlert)\n      .use(remarkRehype)\n      .use(customRenderer)\n      .use(rehypeSlug)\n      // @ts-ignore\n      .use(rehypePrism)\n      .use(rehypeSanitize, {\n        attributes: {\n          '*': ['className', 'class', 'id'],\n          a: ['href', 'target', 'rel', 'id'],\n          img: ['src', 'alt'],\n        },\n      })\n\n    // Add image processing plugin if articleSlug is provided\n    if (articleSlug) {\n      processor = processor.use(rehypeProcessImages, { articleSlug })\n    }\n\n    const result = await processor.use(rehypeStringify).process(markdown)\n\n    return result.toString()\n  } catch (error) {\n    reportArticlesError({\n      code: 'markdown-conversion-failed',\n      message: 'Unable to convert markdown to HTML.',\n      error,\n      context: { articleSlug },\n    })\n    // Return the original markdown as fallback\n    return markdown\n  }\n}\n\nfunction nodeTextValue(c: ElementContent): string {\n  return c.type === 'text' ? (c as { value: string }).value : ''\n}\n\nfunction extractHeadingItem(node: Element): TocItem | null {\n  const match = /^h([1-6])$/.exec(node.tagName)\n  if (!match) return null\n  const id = typeof node.properties?.id === 'string' ? node.properties.id : ''\n  const text = node.children.map(nodeTextValue).join('')\n  if (!id || !text) return null\n  return { id, depth: Number.parseInt(match[1], 10), text }\n}\n\nexport async function extractToc(markdown: string): Promise<TocItem[]> {\n  const headings: TocItem[] = []\n  const collectHeadings: Plugin<[], Root> = () => (tree: Root) => {\n    visit(tree, 'element', (node: Element) => {\n      const item = extractHeadingItem(node)\n      if (item) headings.push(item)\n    })\n  }\n  await remark()\n    .use(remarkParse)\n    .use(remarkGfm)\n    .use(remarkRehype)\n    .use(rehypeSlug)\n    .use(collectHeadings)\n    .use(rehypeStringify)\n    .process(markdown)\n  return headings\n}\n","export type ArticlesErrorCode =\n  | 'article-directory-read-failed'\n  | 'article-load-failed'\n  | 'article-markdown-load-failed'\n  | 'markdown-conversion-failed'\n  | 'unsafe-image-path'\n\nexport type ArticlesErrorContext = Readonly<Record<string, string | number | boolean | undefined>>\n\nexport type ArticlesErrorReport = Readonly<{\n  code: ArticlesErrorCode\n  message: string\n  error?: unknown\n  context?: ArticlesErrorContext\n}>\n\nexport type ArticlesErrorHandler = (report: ArticlesErrorReport) => void\n\nfunction defaultArticlesErrorHandler(report: ArticlesErrorReport): void {\n  if (process.env.NODE_ENV === 'production') return\n  const context = report.context ? ` ${JSON.stringify(report.context)}` : ''\n  const detail = report.error instanceof Error ? `: ${report.error.message}` : ''\n  console.warn(`[articles:${report.code}] ${report.message}${context}${detail}`)\n}\n\nlet articlesErrorHandler: ArticlesErrorHandler = defaultArticlesErrorHandler\n\nexport function setArticlesErrorHandler(handler?: ArticlesErrorHandler): void {\n  articlesErrorHandler = handler ?? defaultArticlesErrorHandler\n}\n\nexport function reportArticlesError(report: ArticlesErrorReport): void {\n  articlesErrorHandler(report)\n}\n"],"mappings":"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","names":["remarkParse","remarkGfm","remarkGithubBlockquoteAlert","remarkRehype","rehypeSlug","rehypePrism","rehypeSanitize","rehypeStringify","path","readingTime","fs","sanitizeImagePath","matter","fs","matter"]}

package/dist/nextjs.d.cts

@@ -0,0 +1,112 @@
+import { NextRequest } from 'next/server';
+
+/** Keys for each renderable section of the articles listing page. */
+type ArticlesSection = 'hero' | 'search' | 'featured' | 'latest' | 'categories' | 'newsletter';
+/**
+ * CSS custom-property overrides applied to the library's wrapper div.
+ * All fields are optional; omitted fields fall back to the consuming app's Tailwind theme.
+ */
+interface ArticlesTheme {
+    /** Font family for the articles section. Example: `"'Inter', sans-serif"` */
+    fontFamily?: string;
+    /** Color for article card titles and section headings. Example: `'#111827'` */
+    headerColor?: string;
+    /** Color for body and excerpt text. Example: `'#6b7280'` */
+    textColor?: string;
+    /** Background color for sections and cards. Example: `'#ffffff'` */
+    backgroundColor?: string;
+    /** Color for "Read More" links and inline links. Example: `'#4f46e5'` */
+    linkColor?: string;
+    /** Hover color for links. Example: `'#4338ca'` */
+    linkHoverColor?: string;
+    /** Text decoration for links. Values: `'underline'` | `'none'` */
+    linkTextDecoration?: string;
+    /** Font weight for headings. Example: `700` */
+    headerFontWeight?: string | number;
+    /** Font size for article card titles. Example: `'1.25rem'` */
+    headerFontSize?: string;
+    /** Font size for body text. Example: `'1rem'` */
+    bodyFontSize?: string;
+    /** Line height for body text. Example: `'1.75'` */
+    lineHeight?: string;
+    /** Border radius for cards. Example: `'0.5rem'` */
+    borderRadius?: string;
+}
+/** Per-category text used in meta descriptions and on the category hero page. */
+interface CategoryDescription {
+    /** Short description — used in meta description and category grid card. */
+    short: string;
+    /** Long description — rendered as a hero paragraph on the category page. */
+    long?: string;
+}
+/** Controls the comments feature. Attach to `ArticlesConfig.comments`. */
+interface CommentsConfig {
+    /** Set to `true` to enable comments globally across all articles. */
+    enabled: boolean;
+    /** Maximum reply nesting depth. Default: `1` (replies to top-level only). */
+    maxDepth?: number;
+    /**
+     * Per-article overrides keyed by slug.
+     * Example: `{ 'sensitive-article': false }` disables comments on that article only.
+     */
+    perArticleOverride?: Record<string, boolean>;
+}
+/** Text content for the hero section at the top of the articles listing page. */
+interface HeroConfig {
+    /** Main heading displayed in the hero. Default: `'Vox Populus Insights'` */
+    title?: string;
+    /** Subheading paragraph displayed beneath the title. Default: the built-in description. */
+    description?: string;
+}
+/** Top-level configuration object. Pass one instance to every library component. */
+interface ArticlesConfig {
+    /** Canonical base URL of the site, used in metadata and JSON-LD. Example: `'https://yoursite.com'` */
+    siteUrl: string;
+    /** Site name shown in metadata titles and JSON-LD publisher fields. Example: `'Vox Populus'` */
+    siteName: string;
+    /** Number of articles shown per page in the grid and loaded on each "Load more" click. Default: `6` */
+    pageSize?: number;
+    /** Number of category cards shown before a "Load more categories" button appears. Default: `8` */
+    categoriesPageSize?: number;
+    /**
+     * Ordered list of sections to render on the articles listing page.
+     * Omit a key to hide that section entirely. Default: `['hero','search','featured','latest','categories']`
+     */
+    layout?: ArticlesSection[];
+    /** CSS custom-property overrides for colors, fonts, and spacing. All fields optional. */
+    theme?: ArticlesTheme;
+    /**
+     * Descriptive text for each category, keyed by category slug.
+     * A plain string is treated as the short description only.
+     * Example: `{ 'campaigns': { short: 'Campaign tips', long: 'Full paragraph...' } }`
+     */
+    categoryDescriptions?: Record<string, string | CategoryDescription>;
+    /** Comments configuration. Omit or set `enabled: false` to hide comments entirely. */
+    comments?: CommentsConfig;
+    /** Hero section title and description. Omit to use the built-in defaults. */
+    hero?: HeroConfig;
+    /** Short description used in the RSS feed channel. Falls back to siteName if omitted. */
+    description?: string;
+    /** Set to false to hide the table of contents on article detail pages. Default: true. */
+    showToc?: boolean;
+    /** Set to false to hide the "Back to Articles" navigation link on article detail pages. Default: true. */
+    showBackToArticles?: boolean;
+    /** Set to false to hide author names from UI and metadata. Default: true. */
+    showAuthor?: boolean;
+}
+
+/**
+ * Returns a Next.js App Router GET handler for serving article markdown.
+ *
+ * Usage in app/api/articles-markdown/[...slug]/route.ts:
+ *   import { createArticleMarkdownHandler } from '@fullstackdatasolutions/articles/nextjs'
+ *   import { siteConfig } from '@/config/articles'
+ *   export const { GET } = createArticleMarkdownHandler(siteConfig)
+ */
+declare function createArticleMarkdownHandler(config: ArticlesConfig): {
+    GET: (_request: NextRequest, context: {
+        params: Promise<Record<string, string | string[]>>;
+    }) => Promise<Response>;
+};
+
+export { createArticleMarkdownHandler };

package/dist/nextjs.d.ts

@@ -0,0 +1,112 @@
+import { NextRequest } from 'next/server';
+
+/** Keys for each renderable section of the articles listing page. */
+type ArticlesSection = 'hero' | 'search' | 'featured' | 'latest' | 'categories' | 'newsletter';
+/**
+ * CSS custom-property overrides applied to the library's wrapper div.
+ * All fields are optional; omitted fields fall back to the consuming app's Tailwind theme.
+ */
+interface ArticlesTheme {
+    /** Font family for the articles section. Example: `"'Inter', sans-serif"` */
+    fontFamily?: string;
+    /** Color for article card titles and section headings. Example: `'#111827'` */
+    headerColor?: string;
+    /** Color for body and excerpt text. Example: `'#6b7280'` */
+    textColor?: string;
+    /** Background color for sections and cards. Example: `'#ffffff'` */
+    backgroundColor?: string;
+    /** Color for "Read More" links and inline links. Example: `'#4f46e5'` */
+    linkColor?: string;
+    /** Hover color for links. Example: `'#4338ca'` */
+    linkHoverColor?: string;
+    /** Text decoration for links. Values: `'underline'` | `'none'` */
+    linkTextDecoration?: string;
+    /** Font weight for headings. Example: `700` */
+    headerFontWeight?: string | number;
+    /** Font size for article card titles. Example: `'1.25rem'` */
+    headerFontSize?: string;
+    /** Font size for body text. Example: `'1rem'` */
+    bodyFontSize?: string;
+    /** Line height for body text. Example: `'1.75'` */
+    lineHeight?: string;
+    /** Border radius for cards. Example: `'0.5rem'` */
+    borderRadius?: string;
+}
+/** Per-category text used in meta descriptions and on the category hero page. */
+interface CategoryDescription {
+    /** Short description — used in meta description and category grid card. */
+    short: string;
+    /** Long description — rendered as a hero paragraph on the category page. */
+    long?: string;
+}
+/** Controls the comments feature. Attach to `ArticlesConfig.comments`. */
+interface CommentsConfig {
+    /** Set to `true` to enable comments globally across all articles. */
+    enabled: boolean;
+    /** Maximum reply nesting depth. Default: `1` (replies to top-level only). */
+    maxDepth?: number;
+    /**
+     * Per-article overrides keyed by slug.
+     * Example: `{ 'sensitive-article': false }` disables comments on that article only.
+     */
+    perArticleOverride?: Record<string, boolean>;
+}
+/** Text content for the hero section at the top of the articles listing page. */
+interface HeroConfig {
+    /** Main heading displayed in the hero. Default: `'Vox Populus Insights'` */
+    title?: string;
+    /** Subheading paragraph displayed beneath the title. Default: the built-in description. */
+    description?: string;
+}
+/** Top-level configuration object. Pass one instance to every library component. */
+interface ArticlesConfig {
+    /** Canonical base URL of the site, used in metadata and JSON-LD. Example: `'https://yoursite.com'` */
+    siteUrl: string;
+    /** Site name shown in metadata titles and JSON-LD publisher fields. Example: `'Vox Populus'` */
+    siteName: string;
+    /** Number of articles shown per page in the grid and loaded on each "Load more" click. Default: `6` */
+    pageSize?: number;
+    /** Number of category cards shown before a "Load more categories" button appears. Default: `8` */
+    categoriesPageSize?: number;
+    /**
+     * Ordered list of sections to render on the articles listing page.
+     * Omit a key to hide that section entirely. Default: `['hero','search','featured','latest','categories']`
+     */
+    layout?: ArticlesSection[];
+    /** CSS custom-property overrides for colors, fonts, and spacing. All fields optional. */
+    theme?: ArticlesTheme;
+    /**
+     * Descriptive text for each category, keyed by category slug.
+     * A plain string is treated as the short description only.
+     * Example: `{ 'campaigns': { short: 'Campaign tips', long: 'Full paragraph...' } }`
+     */
+    categoryDescriptions?: Record<string, string | CategoryDescription>;
+    /** Comments configuration. Omit or set `enabled: false` to hide comments entirely. */
+    comments?: CommentsConfig;
+    /** Hero section title and description. Omit to use the built-in defaults. */
+    hero?: HeroConfig;
+    /** Short description used in the RSS feed channel. Falls back to siteName if omitted. */
+    description?: string;
+    /** Set to false to hide the table of contents on article detail pages. Default: true. */
+    showToc?: boolean;
+    /** Set to false to hide the "Back to Articles" navigation link on article detail pages. Default: true. */
+    showBackToArticles?: boolean;
+    /** Set to false to hide author names from UI and metadata. Default: true. */
+    showAuthor?: boolean;
+}
+
+/**
+ * Returns a Next.js App Router GET handler for serving article markdown.
+ *
+ * Usage in app/api/articles-markdown/[...slug]/route.ts:
+ *   import { createArticleMarkdownHandler } from '@fullstackdatasolutions/articles/nextjs'
+ *   import { siteConfig } from '@/config/articles'
+ *   export const { GET } = createArticleMarkdownHandler(siteConfig)
+ */
+declare function createArticleMarkdownHandler(config: ArticlesConfig): {
+    GET: (_request: NextRequest, context: {
+        params: Promise<Record<string, string | string[]>>;
+    }) => Promise<Response>;
+};
+
+export { createArticleMarkdownHandler };