@fullstackdatasolutions/articles 0.8.2 → 0.10.0

package/src/server-articles.ts

@@ -4,7 +4,7 @@ import fs from 'node:fs'
 import path from 'node:path'
 import readingTime from 'reading-time'
 import { markdownToHtml, extractToc } from './markdown'
-import type { Article, CategoryInfo, FaqItem, HowToStep } from './articleTypes'
+import type { Article, AuthorProfile, CategoryInfo, FaqItem, HowToStep } from './articleTypes'
 import type { ArticlesConfig } from './articlesConfig'
 import { reportArticlesError } from './errorReporting'
 
@@ -153,7 +153,81 @@ function parseHowToSteps(raw: unknown): HowToStep[] | undefined {
   return steps.length ? steps : undefined
 }
 
-async function getArticleSummary(slug: string): Promise<Article | null> {
+function parseAuthors(raw: unknown): string[] | undefined {
+  if (!Array.isArray(raw)) return undefined
+  const authors = raw.filter(
+    (author): author is string => typeof author === 'string' && author.trim().length > 0
+  )
+  return authors
+}
+
+export function getAuthorBySlug(slug: string, config: ArticlesConfig): AuthorProfile | null {
+  const profile = config.authors?.[slug]
+  if (!profile) return null
+  return {
+    ...profile,
+    url: profile.url ?? `${config.siteUrl.replace(/\/$/, '')}/articles/authors/${profile.slug}`,
+  }
+}
+
+function getConfiguredAuthorByName(name: string, config: ArticlesConfig): AuthorProfile | null {
+  const normalizedName = name.trim().toLowerCase()
+  const profile = Object.values(config.authors ?? {}).find(
+    (author) => author.name.toLowerCase() === normalizedName
+  )
+  return profile ? getAuthorBySlug(profile.slug, config) : null
+}
+
+function resolveArticleAuthorName(
+  rawAuthor: unknown,
+  rawAuthors: unknown,
+  config?: ArticlesConfig
+): string {
+  const authorArray = parseAuthors(rawAuthors)
+  const firstAuthor = authorArray?.[0]
+  const rawAuthorValue = typeof rawAuthor === 'string' && rawAuthor.trim() ? rawAuthor : undefined
+  const author = firstAuthor ?? rawAuthorValue
+  const resolved = author ?? config?.defaultAuthor
+  if (!resolved) return ''
+  if (!config) return resolved
+  return (
+    getAuthorBySlug(resolved, config)?.name ??
+    getConfiguredAuthorByName(resolved, config)?.name ??
+    resolved
+  )
+}
+
+export function getArticleAuthors(article: Article, config: ArticlesConfig): AuthorProfile[] {
+  const fallbackAuthors = Array.from(
+    new Set(
+      [article.author, config.defaultAuthor].filter(
+        (author): author is string => typeof author === 'string' && author.trim().length > 0
+      )
+    )
+  )
+  const authorValues = article.authors ?? fallbackAuthors
+  if (authorValues.length === 0) return []
+  const resolvedAuthors = authorValues
+    .map((author) => getAuthorBySlug(author, config) ?? getConfiguredAuthorByName(author, config))
+    .filter((author): author is AuthorProfile => author !== null)
+    .filter((author, index, all) => all.findIndex((a) => a.slug === author.slug) === index)
+
+  if (resolvedAuthors.length > 0) return resolvedAuthors
+
+  return authorValues.map((fallbackName) => ({
+    name: fallbackName,
+    slug: categoryToSlug(fallbackName),
+    bio: '',
+  }))
+}
+
+export function getAllAuthors(config: ArticlesConfig): AuthorProfile[] {
+  return Object.keys(config.authors ?? {})
+    .map((slug) => getAuthorBySlug(slug, config))
+    .filter((author): author is AuthorProfile => author !== null)
+}
+
+async function getArticleSummary(slug: string, config?: ArticlesConfig): Promise<Article | null> {
   try {
     const found = findArticleFile(slug)
     if (!found) return null
@@ -171,7 +245,8 @@ async function getArticleSummary(slug: string): Promise<Article | null> {
       excerpt: data.excerpt || '',
       date: parseDateField(data.date),
       lastmod: parseDateField(data.lastmod),
-      author: data.author || 'Andrew Blase',
+      author: resolveArticleAuthorName(data.author, data.authors, config),
+      authors: parseAuthors(data.authors),
       category: categories[0],
       categories,
       readTime,
@@ -197,37 +272,39 @@ async function getArticleSummary(slug: string): Promise<Article | null> {
   }
 }
 
-export const getArticleMetadata = cache(async (slug: string): Promise<Article | null> => {
-  try {
-    const summary = await getArticleSummary(slug)
-    if (!summary) return null
-    const found = findArticleFile(slug)
-    if (!found) return null
-    const fileContent = fs.readFileSync(found.filePath, 'utf8')
-    const { content: markdownContent } = matter(fileContent)
-    const toc = await extractToc(markdownContent)
-    let htmlContent: string | undefined
-    let mdxSource: string | undefined
-    if (found.contentType === 'mdx') {
-      mdxSource = markdownContent
-    } else {
-      htmlContent = await markdownToHtml(markdownContent, slug)
+export const getArticleMetadata = cache(
+  async (slug: string, config?: ArticlesConfig): Promise<Article | null> => {
+    try {
+      const summary = await getArticleSummary(slug, config)
+      if (!summary) return null
+      const found = findArticleFile(slug)
+      if (!found) return null
+      const fileContent = fs.readFileSync(found.filePath, 'utf8')
+      const { content: markdownContent } = matter(fileContent)
+      const toc = await extractToc(markdownContent)
+      let htmlContent: string | undefined
+      let mdxSource: string | undefined
+      if (found.contentType === 'mdx') {
+        mdxSource = markdownContent
+      } else {
+        htmlContent = await markdownToHtml(markdownContent, slug, config)
+      }
+      return { ...summary, content: markdownContent, htmlContent, mdxSource, toc }
+    } catch (error) {
+      reportArticlesError({
+        code: 'article-load-failed',
+        message: 'Unable to load article metadata.',
+        error,
+        context: { slug },
+      })
+      return null
     }
-    return { ...summary, content: markdownContent, htmlContent, mdxSource, toc }
-  } catch (error) {
-    reportArticlesError({
-      code: 'article-load-failed',
-      message: 'Unable to load article metadata.',
-      error,
-      context: { slug },
-    })
-    return null
   }
-})
+)
 
-export const getAllArticles = cache(async (): Promise<Article[]> => {
+export const getAllArticles = cache(async (config?: ArticlesConfig): Promise<Article[]> => {
   const slugs = getAvailableArticleSlugs()
-  const articles = await Promise.all(slugs.map((slug) => getArticleSummary(slug)))
+  const articles = await Promise.all(slugs.map((slug) => getArticleSummary(slug, config)))
   const currentDate = new Date().toISOString().split('T')[0]
   return articles
     .filter((article): article is Article => article !== null)
@@ -337,8 +414,8 @@ export async function getAiRobotsTxtRules(): Promise<string> {
 }
 
 export async function searchArticles(query: string, config?: ArticlesConfig): Promise<Article[]> {
-  if (!query?.trim()) return getAllArticles()
-  const articles = await getAllArticles()
+  if (!query?.trim()) return getAllArticles(config)
+  const articles = await getAllArticles(config)
   const searchTerm = query.toLowerCase().trim()
   const includeAuthor = config?.showAuthor !== false
   return articles.filter((article) => {
@@ -381,11 +458,24 @@ export async function getAllCategories(): Promise<CategoryInfo[]> {
     .sort((a, b) => b.count - a.count)
 }
 
-export async function getArticlesByCategory(categorySlug: string): Promise<Article[]> {
-  const articles = await getAllArticles()
+export async function getArticlesByCategory(
+  categorySlug: string,
+  config?: ArticlesConfig
+): Promise<Article[]> {
+  const articles = await getAllArticles(config)
   return articles.filter((article) =>
     article.categories.some((cat) => categoryToSlug(cat) === categorySlug)
   )
 }
 
+export async function getArticlesByAuthor(
+  authorSlug: string,
+  config: ArticlesConfig
+): Promise<Article[]> {
+  const articles = await getAllArticles(config)
+  return articles.filter((article) =>
+    getArticleAuthors(article, config).some((author) => author.slug === authorSlug)
+  )
+}
+
 export { sanitizeImagePath }

package/src/server.ts

@@ -7,31 +7,50 @@ export {
   getArticleMarkdownResponse,
   getArticleMarkdownUrl,
   getArticleMetadata,
+  getArticleAuthors,
   getAvailableArticleSlugs,
   getAdjacentArticles,
+  getAllAuthors,
   searchArticles,
+  getAuthorBySlug,
   getAllCategories,
+  getArticlesByAuthor,
   getArticlesByCategory,
   categoryToSlug,
   sanitizeImagePath,
 } from './server-articles'
 
 export {
+  generateRssFeed,
   generateArticleStaticParams,
   generateCategoryStaticParams,
+  generateAuthorStaticParams,
   generateArticlesIndexMetadata,
   generateArticleMetadata,
   generateCategoryMetadata,
+  generateAuthorMetadata,
+  buildArticleBreadcrumbs,
+  buildCategoryBreadcrumbs,
+  buildAuthorBreadcrumbs,
+  resolveAuthorAvatar,
   getArticleSitemapEntries,
 } from './seoUtils'
 
 export { markdownToHtml, extractToc } from './markdown'
 export { setArticlesErrorHandler } from './errorReporting'
+export { getBreadcrumbsConfig } from './articlesConfig'
 export { ArticleContent } from './ArticleContent'
 export { ArticleTOC } from './ArticleTOC'
 
-export type { Article, CategoryInfo, TocItem } from './articleTypes'
-export type { ArticlesConfig } from './articlesConfig'
+export type {
+  Article,
+  AuthorProfile,
+  AuthorSocial,
+  BreadcrumbItem,
+  CategoryInfo,
+  TocItem,
+} from './articleTypes'
+export type { ArticlesConfig, LinkTargetStrategy } from './articlesConfig'
 export type {
   ArticlesErrorCode,
   ArticlesErrorContext,