@xexr/blog-platform 1.0.8 → 1.0.9

package/dist/lib/authors.ts

@@ -0,0 +1,100 @@
+import type { BlogPlatformStorage } from "./database";
+import { getStorage } from "./database";
+import type { PublishedArticle, PublishedAuthor } from "../types/contracts";
+
+export interface AuthorArchive {
+  author: PublishedAuthor;
+  articles: PublishedArticle[];
+}
+
+export interface AuthorArchiveOptions {
+  limit?: number;
+  offset?: number;
+}
+
+export function getAuthorsFromArticles(
+  articles: readonly PublishedArticle[],
+): PublishedAuthor[] {
+  const authorsBySlug = new Map<string, PublishedAuthor>();
+
+  for (const article of articles) {
+    if (article.author?.slug) {
+      authorsBySlug.set(
+        article.author.slug,
+        mergeAuthorProfile(
+          authorsBySlug.get(article.author.slug),
+          article.author,
+        ),
+      );
+    }
+  }
+
+  return Array.from(authorsBySlug.values()).sort((a, b) =>
+    a.name.localeCompare(b.name),
+  );
+}
+
+export function getAuthorArchive(
+  slug: string,
+  articles: readonly PublishedArticle[],
+): AuthorArchive | null {
+  const authorArticles = articles
+    .filter((article) => article.author?.slug === slug)
+    .sort(
+      (a, b) =>
+        new Date(b.publishedAt).getTime() - new Date(a.publishedAt).getTime(),
+    );
+
+  const author = authorArticles.reduce<PublishedAuthor | null>(
+    (preferredAuthor, article) =>
+      article.author
+        ? mergeAuthorProfile(preferredAuthor, article.author)
+        : preferredAuthor,
+    null,
+  );
+
+  if (!author) {
+    return null;
+  }
+
+  return {
+    author,
+    articles: authorArticles,
+  };
+}
+
+export async function loadAuthorArchive(
+  slug: string,
+  options: AuthorArchiveOptions = {},
+  storage: BlogPlatformStorage = getStorage(),
+): Promise<AuthorArchive | null> {
+  const { articles } = await storage.listArticles({
+    limit: options.limit ?? 1000,
+    offset: options.offset ?? 0,
+    sortBy: "publishedAt",
+    order: "desc",
+  });
+
+  return getAuthorArchive(slug, articles);
+}
+
+function mergeAuthorProfile(
+  current: PublishedAuthor | null | undefined,
+  next: PublishedAuthor,
+): PublishedAuthor {
+  if (!current) {
+    return next;
+  }
+
+  return {
+    ...current,
+    bio: current.bio ?? next.bio,
+    avatarUrl: current.avatarUrl ?? next.avatarUrl,
+    pronouns: current.pronouns ?? next.pronouns,
+    socialLinks: current.socialLinks ?? next.socialLinks,
+    toneAdjectives:
+      current.toneAdjectives.length > 0
+        ? current.toneAdjectives
+        : next.toneAdjectives,
+  };
+}

package/dist/lib/sitemap.ts

@@ -25,8 +25,17 @@
  * ```
  */
 
-import type { PublishedArticle, PublishedSite, PublishedAuthor } from '../types/contracts';
-import { generateCanonicalUrl, normalizeDomain, type CanonicalUrlOptions } from './seo';
+import type {
+  PublishedArticle,
+  PublishedSite,
+  PublishedAuthor,
+} from "../types/contracts";
+import {
+  generateCanonicalUrl,
+  normalizeDomain,
+  type CanonicalUrlOptions,
+} from "./seo";
+import { buildAuthorPath } from "./urls";
 
 /**
  * Configuration options for sitemap generation.
@@ -76,13 +85,13 @@ export interface SitemapOptions {
  * Valid sitemap change frequency values as per XML sitemap standard.
  */
 export type SitemapChangeFreq =
-  | 'always'
-  | 'hourly'
-  | 'daily'
-  | 'weekly'
-  | 'monthly'
-  | 'yearly'
-  | 'never';
+  | "always"
+  | "hourly"
+  | "daily"
+  | "weekly"
+  | "monthly"
+  | "yearly"
+  | "never";
 
 /**
  * Next.js MetadataRoute.Sitemap compatible entry.
@@ -181,7 +190,7 @@ export async function generateBlogSitemapEntries(
   site: PublishedSite,
   articles: readonly PublishedArticle[],
   authors: readonly PublishedAuthor[] = [],
-  options: SitemapOptions = {}
+  options: SitemapOptions = {},
 ): Promise<NextjsSitemapEntry[]> {
   const {
     includeAuthorPages = true,
@@ -195,49 +204,49 @@ export async function generateBlogSitemapEntries(
   const entries: NextjsSitemapEntry[] = [];
   const baseUrl = normalizeDomain(
     options.canonical?.domain ?? site.domain,
-    options.canonical?.forceHttps ?? true
+    options.canonical?.forceHttps ?? true,
   );
 
-  const pathPrefix = options.canonical?.pathPrefix ?? '/blog';
+  const pathPrefix = options.canonical?.pathPrefix ?? "/blog";
 
   // Add blog home page
   entries.push({
     url: `${baseUrl}${pathPrefix}`,
     lastModified: getLatestModificationDate(articles),
-    changeFrequency: changeFrequency.homePage ?? 'daily',
+    changeFrequency: changeFrequency.homePage ?? "daily",
     priority: priority.homePage ?? 1.0,
   });
 
   // Add individual article pages
-  articles.forEach(article => {
+  articles.forEach((article) => {
     if (entries.length >= maxEntries) return;
 
     const articleUrl = generateCanonicalUrl(article, options.canonical);
     entries.push({
       url: articleUrl,
       lastModified: article.updatedAt,
-      changeFrequency: changeFrequency.articles ?? 'monthly',
+      changeFrequency: changeFrequency.articles ?? "monthly",
       priority: priority.articles ?? 0.8,
     });
   });
 
   // Add author pages if enabled
   if (includeAuthorPages) {
-    authors.forEach(author => {
+    authors.forEach((author) => {
       if (entries.length >= maxEntries) return;
 
-      const authorUrl = `${baseUrl}${pathPrefix}/authors/${author.slug}`;
+      const authorUrl = `${baseUrl}${buildAuthorPath(pathPrefix, author.slug)}`;
 
       // Find the latest article by this author for lastModified
-      const authorArticles = articles.filter(article =>
-        article.author?.id === author.id
+      const authorArticles = articles.filter(
+        (article) => article.author?.id === author.id,
       );
       const latestAuthorMod = getLatestModificationDate(authorArticles);
 
       entries.push({
         url: authorUrl,
         lastModified: latestAuthorMod,
-        changeFrequency: changeFrequency.authorPages ?? 'weekly',
+        changeFrequency: changeFrequency.authorPages ?? "weekly",
         priority: priority.authorPages ?? 0.6,
       });
     });
@@ -253,7 +262,7 @@ export async function generateBlogSitemapEntries(
       entries.push({
         url: `${baseUrl}${pathPrefix}?page=${page}`,
         lastModified: getLatestModificationDate(articles),
-        changeFrequency: changeFrequency.paginationPages ?? 'daily',
+        changeFrequency: changeFrequency.paginationPages ?? "daily",
         priority: priority.paginationPages ?? 0.5,
       });
     }
@@ -276,7 +285,7 @@ export function generateSitemap(
   site: PublishedSite,
   articles: readonly PublishedArticle[],
   authors: readonly PublishedAuthor[] = [],
-  options: SitemapOptions = {}
+  options: SitemapOptions = {},
 ): SitemapData {
   const {
     includeAuthorPages = true,
@@ -290,10 +299,10 @@ export function generateSitemap(
   const entries: SitemapEntry[] = [];
   const baseUrl = normalizeDomain(
     options.canonical?.domain ?? site.domain,
-    options.canonical?.forceHttps ?? true
+    options.canonical?.forceHttps ?? true,
   );
 
-  const pathPrefix = options.canonical?.pathPrefix ?? '/blog';
+  const pathPrefix = options.canonical?.pathPrefix ?? "/blog";
   const generatedAt = new Date().toISOString();
 
   // Calculate total potential entries to determine if truncation will occur
@@ -313,40 +322,40 @@ export function generateSitemap(
   entries.push({
     loc: `${baseUrl}${pathPrefix}`,
     lastmod: getLatestModificationDate(articles),
-    changefreq: changeFrequency.homePage ?? 'daily',
+    changefreq: changeFrequency.homePage ?? "daily",
     priority: priority.homePage ?? 1.0,
   });
 
   // Add individual article pages
-  articles.forEach(article => {
+  articles.forEach((article) => {
     if (entries.length >= maxEntries) return;
 
     const articleUrl = generateCanonicalUrl(article, options.canonical);
     entries.push({
       loc: articleUrl,
       lastmod: article.updatedAt,
-      changefreq: changeFrequency.articles ?? 'monthly',
+      changefreq: changeFrequency.articles ?? "monthly",
       priority: priority.articles ?? 0.8,
     });
   });
 
   // Add author pages if enabled
   if (includeAuthorPages) {
-    authors.forEach(author => {
+    authors.forEach((author) => {
       if (entries.length >= maxEntries) return;
 
-      const authorUrl = `${baseUrl}${pathPrefix}/authors/${author.slug}`;
+      const authorUrl = `${baseUrl}${buildAuthorPath(pathPrefix, author.slug)}`;
 
       // Find the latest article by this author for lastmod
-      const authorArticles = articles.filter(article =>
-        article.author?.id === author.id
+      const authorArticles = articles.filter(
+        (article) => article.author?.id === author.id,
       );
       const latestAuthorMod = getLatestModificationDate(authorArticles);
 
       entries.push({
         loc: authorUrl,
         lastmod: latestAuthorMod,
-        changefreq: changeFrequency.authorPages ?? 'weekly',
+        changefreq: changeFrequency.authorPages ?? "weekly",
         priority: priority.authorPages ?? 0.6,
       });
     });
@@ -362,7 +371,7 @@ export function generateSitemap(
       entries.push({
         loc: `${baseUrl}${pathPrefix}?page=${page}`,
         lastmod: getLatestModificationDate(articles),
-        changefreq: changeFrequency.paginationPages ?? 'daily',
+        changefreq: changeFrequency.paginationPages ?? "daily",
         priority: priority.paginationPages ?? 0.5,
       });
     }
@@ -392,10 +401,11 @@ export function generateSitemap(
  */
 export function sitemapToXml(sitemapData: SitemapData): string {
   const xmlHeader = '<?xml version="1.0" encoding="UTF-8"?>';
-  const urlsetOpen = '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">';
-  const urlsetClose = '</urlset>';
+  const urlsetOpen =
+    '<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">';
+  const urlsetClose = "</urlset>";
 
-  const urlEntries = sitemapData.entries.map(entry => {
+  const urlEntries = sitemapData.entries.map((entry) => {
     const elements: string[] = [];
 
     elements.push(`  <url>`);
@@ -406,7 +416,9 @@ export function sitemapToXml(sitemapData: SitemapData): string {
     }
 
     if (entry.changefreq) {
-      elements.push(`    <changefreq>${escapeXml(entry.changefreq)}</changefreq>`);
+      elements.push(
+        `    <changefreq>${escapeXml(entry.changefreq)}</changefreq>`,
+      );
     }
 
     if (entry.priority !== undefined) {
@@ -415,15 +427,10 @@ export function sitemapToXml(sitemapData: SitemapData): string {
 
     elements.push(`  </url>`);
 
-    return elements.join('\n');
+    return elements.join("\n");
   });
 
-  return [
-    xmlHeader,
-    urlsetOpen,
-    ...urlEntries,
-    urlsetClose,
-  ].join('\n');
+  return [xmlHeader, urlsetOpen, ...urlEntries, urlsetClose].join("\n");
 }
 
 /**
@@ -443,13 +450,14 @@ export function sitemapToXml(sitemapData: SitemapData): string {
  */
 export function generateSitemapIndex(
   sitemaps: readonly { url: string; lastmod?: string }[],
-  _baseUrl: string
+  _baseUrl: string,
 ): string {
   const xmlHeader = '<?xml version="1.0" encoding="UTF-8"?>';
-  const indexOpen = '<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">';
-  const indexClose = '</sitemapindex>';
+  const indexOpen =
+    '<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">';
+  const indexClose = "</sitemapindex>";
 
-  const sitemapEntries = sitemaps.map(sitemap => {
+  const sitemapEntries = sitemaps.map((sitemap) => {
     const elements: string[] = [];
 
     elements.push(`  <sitemap>`);
@@ -461,15 +469,10 @@ export function generateSitemapIndex(
 
     elements.push(`  </sitemap>`);
 
-    return elements.join('\n');
+    return elements.join("\n");
   });
 
-  return [
-    xmlHeader,
-    indexOpen,
-    ...sitemapEntries,
-    indexClose,
-  ].join('\n');
+  return [xmlHeader, indexOpen, ...sitemapEntries, indexClose].join("\n");
 }
 
 /**
@@ -498,14 +501,14 @@ export function validateSitemap(sitemapData: SitemapData): {
 
   // Check entry count
   if (sitemapData.entries.length === 0) {
-    errors.push('Sitemap must contain at least one URL');
+    errors.push("Sitemap must contain at least one URL");
   } else if (sitemapData.entries.length > 50000) {
-    errors.push('Sitemap contains more than 50,000 URLs (Google limit)');
+    errors.push("Sitemap contains more than 50,000 URLs (Google limit)");
   }
 
   // Check for truncation
   if (sitemapData.truncated) {
-    warnings.push('Sitemap was truncated due to size limits');
+    warnings.push("Sitemap was truncated due to size limits");
   }
 
   // Validate individual entries
@@ -518,13 +521,20 @@ export function validateSitemap(sitemapData: SitemapData): {
     }
 
     // Validate priority range
-    if (entry.priority !== undefined && (entry.priority < 0 || entry.priority > 1)) {
-      errors.push(`Invalid priority at entry ${index + 1}: must be between 0.0 and 1.0`);
+    if (
+      entry.priority !== undefined &&
+      (entry.priority < 0 || entry.priority > 1)
+    ) {
+      errors.push(
+        `Invalid priority at entry ${index + 1}: must be between 0.0 and 1.0`,
+      );
     }
 
     // Validate lastmod format
     if (entry.lastmod && !isValidISODate(entry.lastmod)) {
-      errors.push(`Invalid lastmod date at entry ${index + 1}: ${entry.lastmod}`);
+      errors.push(
+        `Invalid lastmod date at entry ${index + 1}: ${entry.lastmod}`,
+      );
     }
 
     // Check URL length (Google limit is 2048 characters)
@@ -535,7 +545,7 @@ export function validateSitemap(sitemapData: SitemapData): {
 
   // Check for duplicate URLs
   const urlCounts = new Map<string, number>();
-  sitemapData.entries.forEach(entry => {
+  sitemapData.entries.forEach((entry) => {
     const count = urlCounts.get(entry.loc) ?? 0;
     urlCounts.set(entry.loc, count + 1);
   });
@@ -556,7 +566,9 @@ export function validateSitemap(sitemapData: SitemapData): {
 /**
  * Gets the latest modification date from an array of articles.
  */
-function getLatestModificationDate(articles: readonly PublishedArticle[]): string {
+function getLatestModificationDate(
+  articles: readonly PublishedArticle[],
+): string {
   if (articles.length === 0) {
     return new Date().toISOString();
   }
@@ -594,17 +606,23 @@ export function createBlogSitemapRoute(
   site: PublishedSite,
   articles: readonly PublishedArticle[],
   authors: readonly PublishedAuthor[] = [],
-  options: SitemapOptions = {}
+  options: SitemapOptions = {},
 ) {
   return async function GET() {
-    const entries = await generateBlogSitemapEntries(site, articles, authors, options);
+    const entries = await generateBlogSitemapEntries(
+      site,
+      articles,
+      authors,
+      options,
+    );
 
     // Convert to Next.js sitemap format and return as XML
-    const xmlEntries = entries.map(entry => ({
+    const xmlEntries = entries.map((entry) => ({
       loc: entry.url,
-      lastmod: typeof entry.lastModified === 'string'
-        ? entry.lastModified
-        : entry.lastModified?.toISOString(),
+      lastmod:
+        typeof entry.lastModified === "string"
+          ? entry.lastModified
+          : entry.lastModified?.toISOString(),
       changefreq: entry.changeFrequency,
       priority: entry.priority,
     }));
@@ -616,7 +634,7 @@ export function createBlogSitemapRoute(
       generatedAt: new Date().toISOString(),
       baseUrl: normalizeDomain(
         options.canonical?.domain ?? site.domain,
-        options.canonical?.forceHttps ?? true
+        options.canonical?.forceHttps ?? true,
       ),
     };
 
@@ -624,8 +642,8 @@ export function createBlogSitemapRoute(
 
     return new Response(xml, {
       headers: {
-        'Content-Type': 'application/xml',
-        'Cache-Control': 'public, max-age=3600, s-maxage=3600',
+        "Content-Type": "application/xml",
+        "Cache-Control": "public, max-age=3600, s-maxage=3600",
       },
     });
   };
@@ -688,14 +706,14 @@ export function createDynamicBlogSitemap(config: BlogSitemapConfig) {
  */
 function escapeXml(text: string): string {
   const xmlEscapes: Record<string, string> = {
-    '&': '&amp;',
-    '<': '&lt;',
-    '>': '&gt;',
-    '"': '&quot;',
-    "'": '&#x27;',
+    "&": "&amp;",
+    "<": "&lt;",
+    ">": "&gt;",
+    '"': "&quot;",
+    "'": "&#x27;",
   };
 
-  return text.replace(/[&<>"']/g, char => xmlEscapes[char] ?? char);
+  return text.replace(/[&<>"']/g, (char) => xmlEscapes[char] ?? char);
 }
 
 /**
@@ -708,12 +726,13 @@ function isValidISODate(dateString: string): boolean {
 
     // Handle both formats: with and without milliseconds
     // 2023-01-01T00:00:00.000Z and 2023-01-01T00:00:00Z are both valid
-    const normalizedInput = dateString.endsWith('Z') && !dateString.includes('.')
-      ? dateString.replace('Z', '.000Z')
-      : dateString;
+    const normalizedInput =
+      dateString.endsWith("Z") && !dateString.includes(".")
+        ? dateString.replace("Z", ".000Z")
+        : dateString;
 
     return isoString === normalizedInput && !isNaN(date.getTime());
   } catch {
     return false;
   }
-}
+}

package/dist/lib/structured-data.ts

@@ -14,6 +14,7 @@ import type {
   PublishedAuthor,
   PublishedSite,
 } from "../types/contracts";
+import { buildAuthorPath } from "./urls";
 
 /**
  * Base schema.org context and type
@@ -277,8 +278,8 @@ export function generateAuthorStructuredData(
 
   if (author.slug?.trim()) {
     const authorUrl = customDomain
-      ? `https://${customDomain}${pathPrefix}/authors/${author.slug}`
-      : `${pathPrefix}/authors/${author.slug}`;
+      ? `https://${customDomain}${buildAuthorPath(pathPrefix, author.slug)}`
+      : buildAuthorPath(pathPrefix, author.slug);
     schema.url = authorUrl;
   }
 

package/dist/lib/urls.ts

@@ -23,6 +23,13 @@ export function buildBlogPath(
   return `${normalizedBasePath}/${cleanSlug}`.replace(/\/+/g, "/");
 }
 
+export function buildAuthorPath(
+  basePath: string | undefined,
+  authorSlug: string,
+): string {
+  return buildBlogPath(basePath, `authors/${authorSlug}`);
+}
+
 export function getPathPrefixFromBlogUrl(blogUrl: string): string {
   const parsed = new URL(blogUrl);
   return normalizeBlogBasePath(parsed.pathname);

package/dist/types/contracts.ts

@@ -18,6 +18,9 @@ export interface PublishedAuthorSocialLinks {
   /** X/Twitter profile URL */
   readonly x?: string;
 
+  /** Legacy Twitter profile URL */
+  readonly twitter?: string;
+
   /** LinkedIn profile URL */
   readonly linkedin?: string;
 

package/dist/types/index.d.mts

@@ -15,6 +15,8 @@ interface PublishedAuthorSocialLinks {
     readonly website?: string;
     /** X/Twitter profile URL */
     readonly x?: string;
+    /** Legacy Twitter profile URL */
+    readonly twitter?: string;
     /** LinkedIn profile URL */
     readonly linkedin?: string;
     /** GitHub profile URL */

package/dist/types/index.d.ts

@@ -15,6 +15,8 @@ interface PublishedAuthorSocialLinks {
     readonly website?: string;
     /** X/Twitter profile URL */
     readonly x?: string;
+    /** Legacy Twitter profile URL */
+    readonly twitter?: string;
     /** LinkedIn profile URL */
     readonly linkedin?: string;
     /** GitHub profile URL */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@xexr/blog-platform",
-  "version": "1.0.8",
+  "version": "1.0.9",
   "description": "SEO-friendly blog platform for Next.js 15 with Bloggy integration",
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",