@fullstackdatasolutions/articles 0.9.0 → 0.11.0

package/dist/server.cjs

@@ -81,27 +81,38 @@ var server_exports = {};
 __export(server_exports, {
   ArticleContent: () => ArticleContent,
   ArticleTOC: () => ArticleTOC,
+  buildArticleBreadcrumbs: () => buildArticleBreadcrumbs,
+  buildAuthorBreadcrumbs: () => buildAuthorBreadcrumbs,
+  buildCategoryBreadcrumbs: () => buildCategoryBreadcrumbs,
   categoryToSlug: () => categoryToSlug,
   extractToc: () => extractToc,
   generateArticleMetadata: () => generateArticleMetadata,
   generateArticleStaticParams: () => generateArticleStaticParams,
   generateArticlesIndexMetadata: () => generateArticlesIndexMetadata,
+  generateAuthorMetadata: () => generateAuthorMetadata,
+  generateAuthorStaticParams: () => generateAuthorStaticParams,
   generateCategoryMetadata: () => generateCategoryMetadata,
   generateCategoryStaticParams: () => generateCategoryStaticParams,
   generateRssFeed: () => generateRssFeed,
   getAdjacentArticles: () => getAdjacentArticles,
   getAiRobotsTxtRules: () => getAiRobotsTxtRules,
   getAllArticles: () => getAllArticles,
+  getAllAuthors: () => getAllAuthors,
   getAllCategories: () => getAllCategories,
   getArticleAiHeaders: () => getArticleAiHeaders,
+  getArticleAuthors: () => getArticleAuthors,
   getArticleMarkdown: () => getArticleMarkdown,
   getArticleMarkdownResponse: () => getArticleMarkdownResponse,
   getArticleMarkdownUrl: () => getArticleMarkdownUrl,
   getArticleMetadata: () => getArticleMetadata,
   getArticleSitemapEntries: () => getArticleSitemapEntries,
+  getArticlesByAuthor: () => getArticlesByAuthor,
   getArticlesByCategory: () => getArticlesByCategory,
+  getAuthorBySlug: () => getAuthorBySlug,
   getAvailableArticleSlugs: () => getAvailableArticleSlugs,
+  getBreadcrumbsConfig: () => getBreadcrumbsConfig,
   markdownToHtml: () => markdownToHtml,
+  resolveAuthorAvatar: () => resolveAuthorAvatar,
   sanitizeImagePath: () => sanitizeImagePath2,
   searchArticles: () => searchArticles,
   setArticlesErrorHandler: () => setArticlesErrorHandler
@@ -578,7 +589,67 @@ function parseHowToSteps(raw) {
   );
   return steps.length ? steps : void 0;
 }
-function getArticleSummary(slug) {
+function parseAuthors(raw) {
+  if (!Array.isArray(raw)) return void 0;
+  const authors = raw.filter(
+    (author) => typeof author === "string" && author.trim().length > 0
+  );
+  return authors;
+}
+function getAuthorBySlug(slug, config) {
+  var _a, _b;
+  const profile = (_a = config.authors) == null ? void 0 : _a[slug];
+  if (!profile) return null;
+  return __spreadProps(__spreadValues({}, profile), {
+    url: (_b = profile.url) != null ? _b : `${config.siteUrl.replace(/\/$/, "")}/articles/authors/${profile.slug}`
+  });
+}
+function getConfiguredAuthorByName(name, config) {
+  var _a;
+  const normalizedName = name.trim().toLowerCase();
+  const profile = Object.values((_a = config.authors) != null ? _a : {}).find(
+    (author) => author.name.toLowerCase() === normalizedName
+  );
+  return profile ? getAuthorBySlug(profile.slug, config) : null;
+}
+function resolveArticleAuthorName(rawAuthor, rawAuthors, config) {
+  var _a, _b, _c, _d;
+  const authorArray = parseAuthors(rawAuthors);
+  const firstAuthor = authorArray == null ? void 0 : authorArray[0];
+  const rawAuthorValue = typeof rawAuthor === "string" && rawAuthor.trim() ? rawAuthor : void 0;
+  const author = firstAuthor != null ? firstAuthor : rawAuthorValue;
+  const resolved = author != null ? author : config == null ? void 0 : config.defaultAuthor;
+  if (!resolved) return "";
+  if (!config) return resolved;
+  return (_d = (_c = (_a = getAuthorBySlug(resolved, config)) == null ? void 0 : _a.name) != null ? _c : (_b = getConfiguredAuthorByName(resolved, config)) == null ? void 0 : _b.name) != null ? _d : resolved;
+}
+function getArticleAuthors(article, config) {
+  var _a;
+  const fallbackAuthors = Array.from(
+    new Set(
+      [article.author, config.defaultAuthor].filter(
+        (author) => typeof author === "string" && author.trim().length > 0
+      )
+    )
+  );
+  const authorValues = (_a = article.authors) != null ? _a : fallbackAuthors;
+  if (authorValues.length === 0) return [];
+  const resolvedAuthors = authorValues.map((author) => {
+    var _a2;
+    return (_a2 = getAuthorBySlug(author, config)) != null ? _a2 : getConfiguredAuthorByName(author, config);
+  }).filter((author) => 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: ""
+  }));
+}
+function getAllAuthors(config) {
+  var _a;
+  return Object.keys((_a = config.authors) != null ? _a : {}).map((slug) => getAuthorBySlug(slug, config)).filter((author) => author !== null);
+}
+function getArticleSummary(slug, config) {
   return __async(this, null, function* () {
     try {
       const found = findArticleFile(slug);
@@ -594,7 +665,8 @@ function getArticleSummary(slug) {
         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,
@@ -623,7 +695,7 @@ function getArticleSummary(slug) {
 var getArticleMetadata = (0, import_react.cache)(
   (slug, config) => __async(void 0, null, function* () {
     try {
-      const summary = yield getArticleSummary(slug);
+      const summary = yield getArticleSummary(slug, config);
       if (!summary) return null;
       const found = findArticleFile(slug);
       if (!found) return null;
@@ -649,9 +721,9 @@ var getArticleMetadata = (0, import_react.cache)(
     }
   })
 );
-var getAllArticles = (0, import_react.cache)(() => __async(void 0, null, function* () {
+var getAllArticles = (0, import_react.cache)((config) => __async(void 0, null, function* () {
   const slugs = getAvailableArticleSlugs();
-  const articles = yield Promise.all(slugs.map((slug) => getArticleSummary(slug)));
+  const articles = yield Promise.all(slugs.map((slug) => getArticleSummary(slug, config)));
   const currentDate = (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
   return articles.filter((article) => article !== null).filter((article) => !article.date || article.date <= currentDate).filter((article) => !(article.draft && process.env.NODE_ENV === "production")).sort((a, b) => {
     if (!a.date && !b.date) return 0;
@@ -741,8 +813,8 @@ function getAiRobotsTxtRules() {
 }
 function searchArticles(query, config) {
   return __async(this, null, function* () {
-    if (!(query == null ? void 0 : query.trim())) return getAllArticles();
-    const articles = yield getAllArticles();
+    if (!(query == null ? void 0 : query.trim())) return getAllArticles(config);
+    const articles = yield getAllArticles(config);
     const searchTerm = query.toLowerCase().trim();
     const includeAuthor = (config == null ? void 0 : config.showAuthor) !== false;
     return articles.filter((article) => {
@@ -779,14 +851,33 @@ function getAllCategories() {
     })).sort((a, b) => b.count - a.count);
   });
 }
-function getArticlesByCategory(categorySlug) {
+function getArticlesByCategory(categorySlug, config) {
   return __async(this, null, function* () {
-    const articles = yield getAllArticles();
+    const articles = yield getAllArticles(config);
     return articles.filter(
       (article) => article.categories.some((cat) => categoryToSlug(cat) === categorySlug)
     );
   });
 }
+function getArticlesByAuthor(authorSlug, config) {
+  return __async(this, null, function* () {
+    const articles = yield getAllArticles(config);
+    return articles.filter(
+      (article) => getArticleAuthors(article, config).some((author) => author.slug === authorSlug)
+    );
+  });
+}
+
+// src/articlesConfig.ts
+function breadcrumbsAreEnabled(config) {
+  var _a;
+  return config.breadcrumbs !== false && ((_a = config.breadcrumbs) == null ? void 0 : _a.show) !== false;
+}
+function getBreadcrumbsConfig(config) {
+  var _a;
+  if (config.breadcrumbs === false) return {};
+  return (_a = config.breadcrumbs) != null ? _a : {};
+}
 
 // src/seoUtils.ts
 function escapeXml(str) {
@@ -835,6 +926,10 @@ function generateCategoryStaticParams() {
     return categories.map((cat) => ({ category: cat.slug }));
   });
 }
+function generateAuthorStaticParams(config) {
+  if (config.showAuthorPage === false) return [];
+  return getAllAuthors(config).map((author) => ({ author: author.slug }));
+}
 function resolveImageUrl(featuredImage, siteUrl) {
   const base = siteUrl.replace(/\/$/, "");
   if (featuredImage.startsWith("http://") || featuredImage.startsWith("https://")) {
@@ -845,7 +940,7 @@ function resolveImageUrl(featuredImage, siteUrl) {
 function generateArticleMetadata(slug, config) {
   return __async(this, null, function* () {
     var _a, _b, _c, _d, _e, _f, _g;
-    const article = yield getArticleMetadata(slug);
+    const article = yield getArticleMetadata(slug, config);
     if (!article) {
       return {
         title: "Article Not Found",
@@ -859,6 +954,7 @@ function generateArticleMetadata(slug, config) {
     const description = (_b = article.excerpt) != null ? _b : `Read ${article.title} on ${config.siteName}.`;
     const showAuthor = config.showAuthor !== false;
     const markdownUrl = getArticleMarkdownUrl(article, config);
+    const authorNames = getArticleAuthors(article, config).map((author) => author.name);
     return {
       title: `${article.title} | ${config.siteName}`,
       description,
@@ -871,7 +967,7 @@ function generateArticleMetadata(slug, config) {
         images: [{ url: imageUrl, width: 1200, height: 630, alt: article.title }],
         locale: "en_US",
         type: "article"
-      }, article.date && { publishedTime: article.date }), article.lastmod && { modifiedTime: new Date(article.lastmod).toISOString() }), showAuthor && { authors: [article.author] }), {
+      }, article.date && { publishedTime: article.date }), article.lastmod && { modifiedTime: new Date(article.lastmod).toISOString() }), showAuthor && authorNames.length > 0 && { authors: authorNames }), {
         tags: (_d = article.tags) != null ? _d : []
       }),
       twitter: {
@@ -898,7 +994,7 @@ function generateArticleMetadata(slug, config) {
           "max-snippet": -1
         }
       },
-      other: __spreadProps(__spreadValues(__spreadValues(__spreadValues({}, showAuthor && { "article:author": article.author }), article.date && {
+      other: __spreadProps(__spreadValues(__spreadValues(__spreadValues({}, showAuthor && authorNames.length > 0 && { "article:author": authorNames.join(", ") }), article.date && {
         "article:published_time": new Date(article.date).toISOString()
       }), article.lastmod && {
         "article:modified_time": new Date(article.lastmod).toISOString()
@@ -997,11 +1093,162 @@ function generateCategoryMetadata(categorySlug, config) {
     };
   });
 }
+function generateAuthorMetadata(authorSlug, config) {
+  return __async(this, null, function* () {
+    var _a;
+    const author = getAuthorBySlug(authorSlug, config);
+    if (!author || config.showAuthorPage === false) return { title: "Author Not Found" };
+    const siteUrl = config.siteUrl.replace(/\/$/, "");
+    const authorUrl = (_a = author.url) != null ? _a : `${siteUrl}/articles/authors/${author.slug}`;
+    const title = `${author.name} Articles | ${config.siteName}`;
+    return {
+      title,
+      description: author.bio,
+      openGraph: __spreadValues({
+        title,
+        description: author.bio,
+        url: authorUrl,
+        siteName: config.siteName,
+        type: "profile",
+        locale: "en_US"
+      }, author.avatar && { images: [{ url: resolveAuthorAvatar(author, config) }] }),
+      twitter: __spreadValues({
+        card: "summary_large_image",
+        title,
+        description: author.bio
+      }, author.avatar && { images: [resolveAuthorAvatar(author, config)] }),
+      alternates: {
+        canonical: authorUrl
+      },
+      robots: {
+        index: true,
+        follow: true
+      }
+    };
+  });
+}
+function formatCategoryName(category) {
+  return category.split("-").filter(Boolean).map((part) => part.charAt(0).toUpperCase() + part.slice(1)).join(" ");
+}
+function buildArticleBreadcrumbs(article, config) {
+  var _a, _b;
+  if (!breadcrumbsAreEnabled(config)) return [];
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  const breadcrumbConfig = getBreadcrumbsConfig(config);
+  const labels = (_a = breadcrumbConfig.labels) != null ? _a : {};
+  const categorySlug = categoryToSlug(article.category);
+  const trail = (_b = breadcrumbConfig.article) != null ? _b : ["home", "articles", "primaryCategory", "articleTitle"];
+  const folderSegments = article.slug.split("/").filter(Boolean).slice(0, -1);
+  return trail.flatMap(
+    (token) => buildArticleBreadcrumbToken(token, {
+      article,
+      siteUrl,
+      categorySlug,
+      folderSegments,
+      labels
+    })
+  );
+}
+function buildCategoryBreadcrumbs(category, config, categoryName = formatCategoryName(category)) {
+  var _a, _b;
+  if (!breadcrumbsAreEnabled(config)) return [];
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  const breadcrumbConfig = getBreadcrumbsConfig(config);
+  const labels = (_a = breadcrumbConfig.labels) != null ? _a : {};
+  const trail = (_b = breadcrumbConfig.category) != null ? _b : ["home", "articles", "category"];
+  return trail.flatMap(
+    (entry) => buildCategoryBreadcrumbEntry(entry, { categoryName, siteUrl, labels })
+  );
+}
+function buildAuthorBreadcrumbs(author, config) {
+  var _a, _b;
+  if (!breadcrumbsAreEnabled(config)) return [];
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  const breadcrumbConfig = getBreadcrumbsConfig(config);
+  const labels = (_a = breadcrumbConfig.labels) != null ? _a : {};
+  const trail = (_b = breadcrumbConfig.author) != null ? _b : ["home", "articles", "authors", "authorName"];
+  return trail.flatMap(
+    (entry) => buildAuthorBreadcrumbEntry(entry, { author, siteUrl, labels })
+  );
+}
+function isCustomBreadcrumbItem(entry) {
+  return typeof entry === "object" && entry !== null && "name" in entry && "url" in entry;
+}
+function resolveCustomBreadcrumbItem(item, siteUrl) {
+  if (item.url.startsWith("/")) return { name: item.name, url: `${siteUrl}${item.url}` };
+  return { name: item.name, url: item.url };
+}
+function buildArticleBreadcrumbToken(entry, context) {
+  var _a, _b;
+  if (isCustomBreadcrumbItem(entry)) {
+    return [resolveCustomBreadcrumbItem(entry, context.siteUrl)];
+  }
+  if (entry === "home") return [{ name: (_a = context.labels.home) != null ? _a : "Home", url: context.siteUrl }];
+  if (entry === "articles") {
+    return [{ name: (_b = context.labels.articles) != null ? _b : "Articles", url: `${context.siteUrl}/articles` }];
+  }
+  if (entry === "primaryCategory") {
+    return [
+      {
+        name: context.article.category,
+        url: `${context.siteUrl}/articles/category/${context.categorySlug}`
+      }
+    ];
+  }
+  if (entry === "folderPath") {
+    return context.folderSegments.map((segment, index) => ({
+      name: formatCategoryName(segment),
+      url: `${context.siteUrl}/articles/${context.folderSegments.slice(0, index + 1).join("/")}`
+    }));
+  }
+  return [{ name: context.article.title }];
+}
+function buildCategoryBreadcrumbEntry(entry, context) {
+  var _a, _b;
+  if (isCustomBreadcrumbItem(entry)) {
+    return [resolveCustomBreadcrumbItem(entry, context.siteUrl)];
+  }
+  if (entry === "home") return [{ name: (_a = context.labels.home) != null ? _a : "Home", url: context.siteUrl }];
+  if (entry === "articles") {
+    return [{ name: (_b = context.labels.articles) != null ? _b : "Articles", url: `${context.siteUrl}/articles` }];
+  }
+  return [{ name: context.categoryName }];
+}
+function buildAuthorBreadcrumbEntry(entry, context) {
+  var _a, _b, _c;
+  if (isCustomBreadcrumbItem(entry)) {
+    return [resolveCustomBreadcrumbItem(entry, context.siteUrl)];
+  }
+  if (entry === "home") return [{ name: (_a = context.labels.home) != null ? _a : "Home", url: context.siteUrl }];
+  if (entry === "articles") {
+    return [{ name: (_b = context.labels.articles) != null ? _b : "Articles", url: `${context.siteUrl}/articles` }];
+  }
+  if (entry === "authors") {
+    return [
+      {
+        name: (_c = context.labels.authors) != null ? _c : "Authors",
+        url: `${context.siteUrl}/articles/authors`
+      }
+    ];
+  }
+  return [{ name: context.author.name }];
+}
+function resolveAuthorAvatar(author, config) {
+  if (!author.avatar) return "";
+  if (author.avatar.startsWith("http://") || author.avatar.startsWith("https://")) {
+    return author.avatar;
+  }
+  const siteUrl = config.siteUrl.replace(/\/$/, "");
+  return `${siteUrl}/articles/authors/${author.slug}/${author.avatar.replace(/^\/+/, "")}`;
+}
 function getArticleSitemapEntries(baseUrlOrConfig) {
   return __async(this, null, function* () {
     const baseUrl = (typeof baseUrlOrConfig === "string" ? baseUrlOrConfig : baseUrlOrConfig.siteUrl).replace(/\/$/, "");
     try {
-      const [articles, categories] = yield Promise.all([getAllArticles(), getAllCategories()]);
+      const [articles, categories] = yield Promise.all([
+        getAllArticles(typeof baseUrlOrConfig === "string" ? void 0 : baseUrlOrConfig),
+        getAllCategories()
+      ]);
       const articleEntries = articles.map((article) => {
         var _a;
         const dateStr = (_a = article.lastmod) != null ? _a : article.date;
@@ -1019,7 +1266,12 @@ function getArticleSitemapEntries(baseUrlOrConfig) {
         changeFrequency: "weekly",
         priority: 0.7
       }));
-      return [...articleEntries, ...categoryEntries];
+      const authorEntries = typeof baseUrlOrConfig === "string" || baseUrlOrConfig.showAuthorPage === false ? [] : getAllAuthors(baseUrlOrConfig).map((author) => ({
+        url: `${baseUrl}/articles/authors/${author.slug}`,
+        changeFrequency: "monthly",
+        priority: 0.6
+      }));
+      return [...articleEntries, ...categoryEntries, ...authorEntries];
     } catch (e) {
       return [];
     }
@@ -1039,7 +1291,7 @@ var import_jsx_runtime = require("react/jsx-runtime");
 function makeImgComponent(basePath) {
   return function MdxImage(_a) {
     var _b = _a, { src, alt } = _b, props = __objRest(_b, ["src", "alt"]);
-    const resolvedSrc = src && !src.startsWith("http") && !src.startsWith("/") ? `${basePath}/${src}` : src;
+    const resolvedSrc = typeof src === "string" && !src.startsWith("http") && !src.startsWith("/") ? `${basePath}/${src}` : src;
     return import_react2.default.createElement("img", __spreadValues({ src: resolvedSrc, alt }, props));
   };
 }
@@ -1057,7 +1309,8 @@ function renderMdxSource(source, basePath, config) {
       ]
     }));
     const Content = mdxModule.default;
-    const components = basePath ? { img: makeImgComponent(basePath) } : void 0;
+    const internalComponents = basePath ? { img: makeImgComponent(basePath) } : void 0;
+    const components = internalComponents || (config == null ? void 0 : config.mdxComponents) ? __spreadValues(__spreadValues({}, internalComponents), config == null ? void 0 : config.mdxComponents) : void 0;
     return /* @__PURE__ */ (0, import_jsx_runtime.jsx)(Content, { components });
   });
 }
@@ -1101,27 +1354,38 @@ function ArticleTOC({ toc, className }) {
 0 && (module.exports = {
   ArticleContent,
   ArticleTOC,
+  buildArticleBreadcrumbs,
+  buildAuthorBreadcrumbs,
+  buildCategoryBreadcrumbs,
   categoryToSlug,
   extractToc,
   generateArticleMetadata,
   generateArticleStaticParams,
   generateArticlesIndexMetadata,
+  generateAuthorMetadata,
+  generateAuthorStaticParams,
   generateCategoryMetadata,
   generateCategoryStaticParams,
   generateRssFeed,
   getAdjacentArticles,
   getAiRobotsTxtRules,
   getAllArticles,
+  getAllAuthors,
   getAllCategories,
   getArticleAiHeaders,
+  getArticleAuthors,
   getArticleMarkdown,
   getArticleMarkdownResponse,
   getArticleMarkdownUrl,
   getArticleMetadata,
   getArticleSitemapEntries,
+  getArticlesByAuthor,
   getArticlesByCategory,
+  getAuthorBySlug,
   getAvailableArticleSlugs,
+  getBreadcrumbsConfig,
   markdownToHtml,
+  resolveAuthorAvatar,
   sanitizeImagePath,
   searchArticles,
   setArticlesErrorHandler