@xexr/blog-platform 1.0.12 → 1.0.13

package/dist/sitemap-Dz9DB7py.d.mts

@@ -0,0 +1,422 @@
+import { PublishedArticle, PublishedSite, PublishedAuthor } from './types/index.mjs';
+
+/**
+ * SEO utilities for canonical URL generation and validation.
+ *
+ * These utilities ensure proper canonical URL structure for SEO optimization,
+ * preventing duplicate content issues and improving search engine indexing.
+ */
+
+/**
+ * Configuration options for canonical URL generation.
+ */
+interface CanonicalUrlOptions {
+    /** Whether to force HTTPS protocol (default: true) */
+    forceHttps?: boolean;
+    /** Whether to remove trailing slashes (default: true) */
+    removeTrailingSlash?: boolean;
+    /** Custom domain override (uses site.domain if not provided) */
+    domain?: string;
+    /** Custom path prefix (default: '/blog') */
+    pathPrefix?: string;
+}
+/**
+ * Normalizes a domain by ensuring proper protocol and removing trailing slashes.
+ *
+ * @param domain - The domain to normalize
+ * @param forceHttps - Whether to force HTTPS protocol
+ * @returns The normalized domain
+ *
+ * @example
+ * ```typescript
+ * normalizeDomain('example.com') // 'https://example.com'
+ * normalizeDomain('http://example.com/') // 'https://example.com'
+ * normalizeDomain('https://example.com', false) // 'https://example.com'
+ * ```
+ */
+declare function normalizeDomain(domain: string, forceHttps?: boolean): string;
+/**
+ * Validates and normalizes a slug for URL usage.
+ *
+ * @param slug - The slug to validate and normalize
+ * @returns The normalized slug
+ * @throws Error if slug is invalid
+ *
+ * @example
+ * ```typescript
+ * normalizeSlug('hello-world') // 'hello-world'
+ * normalizeSlug('Hello World!') // throws Error
+ * normalizeSlug('hello--world') // 'hello-world'
+ * ```
+ */
+declare function normalizeSlug(slug: string): string;
+/**
+ * Generates a canonical URL for an article.
+ *
+ * @param article - The published article
+ * @param options - Configuration options for URL generation
+ * @returns The canonical URL
+ * @throws Error if article or site data is invalid
+ *
+ * @example
+ * ```typescript
+ * const article = {
+ *   slug: 'hello-world',
+ *   site: { domain: 'example.com' },
+ *   // ... other fields
+ * };
+ *
+ * generateCanonicalUrl(article)
+ * // 'https://example.com/blog/hello-world'
+ *
+ * generateCanonicalUrl(article, { pathPrefix: '/posts' })
+ * // 'https://example.com/posts/hello-world'
+ * ```
+ */
+declare function generateCanonicalUrl(article: PublishedArticle, options?: CanonicalUrlOptions): string;
+/**
+ * Generates a canonical URL for an article from site and slug data.
+ * Useful when you don't have a full PublishedArticle object.
+ *
+ * @param site - The published site
+ * @param slug - The article slug
+ * @param options - Configuration options for URL generation
+ * @returns The canonical URL
+ *
+ * @example
+ * ```typescript
+ * const site = { domain: 'example.com', ... };
+ * generateCanonicalUrlFromSlug(site, 'hello-world')
+ * // 'https://example.com/blog/hello-world'
+ * ```
+ */
+declare function generateCanonicalUrlFromSlug(site: PublishedSite, slug: string, options?: CanonicalUrlOptions): string;
+/**
+ * Validates if a URL is a valid canonical URL format.
+ *
+ * @param url - The URL to validate
+ * @returns True if the URL is valid for canonical use
+ *
+ * @example
+ * ```typescript
+ * isValidCanonicalUrl('https://example.com/blog/hello-world') // true
+ * isValidCanonicalUrl('http://example.com/blog/hello-world') // true
+ * isValidCanonicalUrl('example.com/blog/hello-world') // false (missing protocol)
+ * isValidCanonicalUrl('https://example.com/blog/hello world') // false (spaces)
+ * ```
+ */
+declare function isValidCanonicalUrl(url: string): boolean;
+/**
+ * Extracts the base URL (protocol + hostname + port) from a canonical URL.
+ *
+ * @param canonicalUrl - The canonical URL
+ * @returns The base URL
+ *
+ * @example
+ * ```typescript
+ * getBaseUrl('https://example.com/blog/hello-world') // 'https://example.com'
+ * getBaseUrl('https://blog.example.com:8080/posts/test') // 'https://blog.example.com:8080'
+ * ```
+ */
+declare function getBaseUrl(canonicalUrl: string): string;
+/**
+ * Updates an article's canonical URL in its meta field.
+ *
+ * @param article - The article to update
+ * @param options - Configuration options for URL generation
+ * @returns A new article object with updated canonical URL
+ *
+ * @example
+ * ```typescript
+ * const updatedArticle = updateArticleCanonicalUrl(article);
+ * console.log(updatedArticle.meta.canonicalUrl); // Generated canonical URL
+ * ```
+ */
+declare function updateArticleCanonicalUrl(article: PublishedArticle, options?: CanonicalUrlOptions): PublishedArticle;
+
+/**
+ * Next.js-compatible sitemap generation utilities for blog platform integration.
+ *
+ * These utilities generate sitemap entries that follow Next.js MetadataRoute.Sitemap
+ * conventions, allowing seamless integration with existing Next.js applications.
+ *
+ * @example Integration with existing Next.js sitemap:
+ * ```typescript
+ * // app/sitemap.ts
+ * import { generateBlogSitemapEntries } from '@xexr/blog-platform';
+ * import type { MetadataRoute } from 'next';
+ *
+ * export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+ *   // Your existing routes
+ *   const staticRoutes = [
+ *     { url: 'https://yoursite.com', lastModified: new Date(), priority: 1 },
+ *     { url: 'https://yoursite.com/about', lastModified: new Date(), priority: 0.8 }
+ *   ];
+ *
+ *   // Blog platform entries
+ *   const blogEntries = await generateBlogSitemapEntries(blogConfig);
+ *
+ *   return [...staticRoutes, ...blogEntries];
+ * }
+ * ```
+ */
+
+/**
+ * Configuration options for sitemap generation.
+ */
+interface SitemapOptions {
+    /** Canonical URL configuration */
+    canonical?: CanonicalUrlOptions;
+    /** Whether to include author pages in sitemap */
+    includeAuthorPages?: boolean;
+    /** Whether to include topic pages in sitemap */
+    includeTopicPages?: boolean;
+    /** Whether to include pagination pages in sitemap */
+    includePaginationPages?: boolean;
+    /** Number of articles per page for pagination calculation */
+    articlesPerPage?: number;
+    /** Maximum number of sitemap entries (defaults to 50,000 per Google guidelines) */
+    maxEntries?: number;
+    /** Change frequency for different page types */
+    changeFrequency?: {
+        /** Change frequency for blog home page */
+        homePage?: SitemapChangeFreq;
+        /** Change frequency for article pages */
+        articles?: SitemapChangeFreq;
+        /** Change frequency for author pages */
+        authorPages?: SitemapChangeFreq;
+        /** Change frequency for topic index and archive pages */
+        topicPages?: SitemapChangeFreq;
+        /** Change frequency for pagination pages */
+        paginationPages?: SitemapChangeFreq;
+    };
+    /** Priority values for different page types */
+    priority?: {
+        /** Priority for blog home page (0.0-1.0) */
+        homePage?: number;
+        /** Priority for article pages (0.0-1.0) */
+        articles?: number;
+        /** Priority for author pages (0.0-1.0) */
+        authorPages?: number;
+        /** Priority for topic index and archive pages (0.0-1.0) */
+        topicPages?: number;
+        /** Priority for pagination pages (0.0-1.0) */
+        paginationPages?: number;
+    };
+}
+/**
+ * Valid sitemap change frequency values as per XML sitemap standard.
+ */
+type SitemapChangeFreq = "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
+/**
+ * Next.js MetadataRoute.Sitemap compatible entry.
+ * This matches the expected format for Next.js sitemap generation.
+ */
+interface NextjsSitemapEntry {
+    /** The URL of the page */
+    url: string;
+    /** Last modification date */
+    lastModified?: string | Date;
+    /** Change frequency hint for search engines */
+    changeFrequency?: SitemapChangeFreq;
+    /** Priority relative to other URLs on the site (0.0-1.0) */
+    priority?: number;
+    /** Alternate language versions (for i18n) */
+    alternates?: {
+        languages?: Record<string, string>;
+    };
+}
+/**
+ * Legacy XML sitemap entry format (for backward compatibility).
+ * @deprecated Use NextjsSitemapEntry for new implementations
+ */
+interface SitemapEntry {
+    /** The URL of the page */
+    loc: string;
+    /** Last modification date as ISO 8601 string */
+    lastmod?: string;
+    /** Change frequency hint for search engines */
+    changefreq?: SitemapChangeFreq;
+    /** Priority relative to other URLs on the site (0.0-1.0) */
+    priority?: number;
+}
+/**
+ * Complete sitemap data structure.
+ */
+interface SitemapData {
+    /** All URL entries in the sitemap */
+    entries: SitemapEntry[];
+    /** Total number of entries */
+    totalEntries: number;
+    /** Whether the sitemap was truncated due to size limits */
+    truncated: boolean;
+    /** Generation timestamp */
+    generatedAt: string;
+    /** Base URL used for canonical URL generation */
+    baseUrl: string;
+}
+/**
+ * Generates Next.js-compatible sitemap entries for blog platform integration.
+ *
+ * @param site - The published site information
+ * @param articles - Array of published articles
+ * @param authors - Array of published authors (optional)
+ * @param options - Sitemap generation options
+ * @returns Array of Next.js MetadataRoute.Sitemap compatible entries
+ *
+ * @example
+ * ```typescript
+ * // In your Next.js app/sitemap.ts file:
+ * import { generateBlogSitemapEntries } from '@xexr/blog-platform';
+ * import type { MetadataRoute } from 'next';
+ *
+ * export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
+ *   const blogEntries = await generateBlogSitemapEntries(site, articles, authors, {
+ *     includeAuthorPages: true,
+ *     includePaginationPages: true,
+ *     changeFrequency: { articles: 'monthly' }
+ *   });
+ *
+ *   return [
+ *     // Your existing site routes
+ *     { url: 'https://yoursite.com', lastModified: new Date(), priority: 1 },
+ *     { url: 'https://yoursite.com/about', lastModified: new Date() },
+ *     // Blog entries
+ *     ...blogEntries
+ *   ];
+ * }
+ * ```
+ */
+declare function generateBlogSitemapEntries(site: PublishedSite, articles: readonly PublishedArticle[], authors?: readonly PublishedAuthor[], options?: SitemapOptions): Promise<NextjsSitemapEntry[]>;
+/**
+ * Legacy sitemap generation for backward compatibility.
+ * @deprecated Use generateBlogSitemapEntries for Next.js integration
+ *
+ * @param site - The published site information
+ * @param articles - Array of published articles
+ * @param authors - Array of published authors (optional)
+ * @param options - Sitemap generation options
+ * @returns Complete sitemap data
+ */
+declare function generateSitemap(site: PublishedSite, articles: readonly PublishedArticle[], authors?: readonly PublishedAuthor[], options?: SitemapOptions): SitemapData;
+/**
+ * Converts sitemap data to XML format.
+ *
+ * @param sitemapData - The sitemap data to convert
+ * @returns XML string in sitemap format
+ *
+ * @example
+ * ```typescript
+ * const sitemap = generateSitemap(site, articles);
+ * const xmlString = sitemapToXml(sitemap);
+ * // Use in API route response
+ * ```
+ */
+declare function sitemapToXml(sitemapData: SitemapData): string;
+/**
+ * Generates a sitemap index for large blogs that need multiple sitemaps.
+ *
+ * @param sitemaps - Array of sitemap information
+ * @param baseUrl - Base URL for the site
+ * @returns XML string for sitemap index
+ *
+ * @example
+ * ```typescript
+ * const sitemapIndex = generateSitemapIndex([
+ *   { url: 'https://example.com/sitemap-articles.xml', lastmod: '2023-01-01T00:00:00Z' },
+ *   { url: 'https://example.com/sitemap-authors.xml', lastmod: '2023-01-01T00:00:00Z' }
+ * ], 'https://example.com');
+ * ```
+ */
+declare function generateSitemapIndex(sitemaps: readonly {
+    url: string;
+    lastmod?: string;
+}[], _baseUrl: string): string;
+/**
+ * Validates sitemap data for compliance with search engine guidelines.
+ *
+ * @param sitemapData - The sitemap data to validate
+ * @returns Validation results with errors and warnings
+ *
+ * @example
+ * ```typescript
+ * const sitemap = generateSitemap(site, articles);
+ * const validation = validateSitemap(sitemap);
+ *
+ * if (validation.errors.length > 0) {
+ *   console.error('Sitemap errors:', validation.errors);
+ * }
+ * ```
+ */
+declare function validateSitemap(sitemapData: SitemapData): {
+    valid: boolean;
+    errors: string[];
+    warnings: string[];
+};
+/**
+ * Creates a separate sitemap specifically for blog content.
+ * Useful for large sites that need to split sitemaps by content type.
+ *
+ * @param site - The published site information
+ * @param articles - Array of published articles
+ * @param authors - Array of published authors (optional)
+ * @param options - Sitemap generation options
+ * @returns Next.js sitemap function
+ *
+ * @example
+ * ```typescript
+ * // app/blog-sitemap/route.ts - separate blog sitemap endpoint
+ * import { createBlogSitemapRoute } from '@xexr/blog-platform';
+ *
+ * export const GET = createBlogSitemapRoute(site, articles, authors, {
+ *   includeAuthorPages: true,
+ *   articlesPerPage: 20
+ * });
+ * ```
+ */
+declare function createBlogSitemapRoute(site: PublishedSite, articles: readonly PublishedArticle[], authors?: readonly PublishedAuthor[], options?: SitemapOptions): () => Promise<Response>;
+/**
+ * Configuration interface for blog data fetching.
+ * Used to fetch blog data for sitemap generation.
+ */
+interface BlogSitemapConfig {
+    /** Static host app routes to include before Bloggy routes */
+    staticRoutes?: readonly NextjsSitemapEntry[];
+    /** Function to fetch static host app routes */
+    getStaticRoutes?: () => Promise<readonly NextjsSitemapEntry[]>;
+    /** Function to fetch site data */
+    getSite: () => Promise<PublishedSite>;
+    /** Function to fetch published articles */
+    getArticles: () => Promise<readonly PublishedArticle[]>;
+    /** Function to fetch authors (optional) */
+    getAuthors?: () => Promise<readonly PublishedAuthor[]>;
+    /** Sitemap generation options */
+    options?: SitemapOptions;
+}
+/**
+ * Higher-order function that creates a Next.js sitemap function with data fetching.
+ * Ideal for dynamic blog content that needs to be fetched at sitemap generation time.
+ *
+ * @param config - Configuration for fetching blog data
+ * @returns Next.js sitemap function
+ *
+ * @example
+ * ```typescript
+ * // app/sitemap.ts
+ * import { createDynamicBlogSitemap } from '@xexr/blog-platform';
+ * import { getBlogData } from './lib/blog';
+ *
+ * export default createDynamicBlogSitemap({
+ *   getSite: () => getBlogData().site,
+ *   getArticles: () => getBlogData().articles,
+ *   getAuthors: () => getBlogData().authors,
+ *   options: {
+ *     includeAuthorPages: true,
+ *     changeFrequency: { articles: 'weekly' }
+ *   }
+ * });
+ * ```
+ */
+declare function createDynamicBlogSitemap(config: BlogSitemapConfig): () => Promise<NextjsSitemapEntry[]>;
+
+export { type BlogSitemapConfig as B, type CanonicalUrlOptions as C, type NextjsSitemapEntry as N, type SitemapChangeFreq as S, type SitemapData as a, type SitemapEntry as b, type SitemapOptions as c, createBlogSitemapRoute as d, createDynamicBlogSitemap as e, generateCanonicalUrl as f, generateBlogSitemapEntries as g, generateCanonicalUrlFromSlug as h, generateSitemap as i, generateSitemapIndex as j, getBaseUrl as k, isValidCanonicalUrl as l, normalizeSlug as m, normalizeDomain as n, sitemapToXml as s, updateArticleCanonicalUrl as u, validateSitemap as v };

package/dist/sitemap.d.mts

@@ -0,0 +1,2 @@
+import './types/index.mjs';
+export { B as BlogSitemapConfig, N as NextjsSitemapEntry, S as SitemapChangeFreq, a as SitemapData, b as SitemapEntry, c as SitemapOptions, d as createBlogSitemapRoute, e as createDynamicBlogSitemap, g as generateBlogSitemapEntries, i as generateSitemap, j as generateSitemapIndex, s as sitemapToXml, v as validateSitemap } from './sitemap-Dz9DB7py.mjs';

package/dist/sitemap.d.ts

@@ -0,0 +1,2 @@
+import './types/index.js';
+export { B as BlogSitemapConfig, N as NextjsSitemapEntry, S as SitemapChangeFreq, a as SitemapData, b as SitemapEntry, c as SitemapOptions, d as createBlogSitemapRoute, e as createDynamicBlogSitemap, g as generateBlogSitemapEntries, i as generateSitemap, j as generateSitemapIndex, s as sitemapToXml, v as validateSitemap } from './sitemap-BPTdXb9C.js';

package/dist/sitemap.js

@@ -0,0 +1,6 @@
+'use strict';function O(e){let t=new Map;for(let r of e)r.author?.slug&&t.set(r.author.slug,q(t.get(r.author.slug),r.author));return Array.from(t.values()).sort((r,i)=>r.name.localeCompare(i.name))}function q(e,t){return e?{...e,bio:e.bio??t.bio,avatarUrl:e.avatarUrl??t.avatarUrl,pronouns:e.pronouns??t.pronouns,socialLinks:e.socialLinks??t.socialLinks,toneAdjectives:e.toneAdjectives.length>0?e.toneAdjectives:t.toneAdjectives}:t}function x(e,t=true){let r=e.trim();return r=r.replace(/\/+$/,""),/^https?:\/\//.exec(r)||(r=`${t?"https":"http"}://${r}`),t&&r.startsWith("http://")&&(r=r.replace("http://","https://")),r}function F(e){let t=e.trim();if(!t)throw new Error("Slug cannot be empty");if(!/^[a-z0-9-]+$/.test(t))throw new Error("Slug can only contain lowercase letters, numbers, and hyphens");let i=t.replace(/-+/g,"-").replace(/^-+|-+$/g,"");if(!i)throw new Error("Slug cannot consist only of hyphens");return i}function _(e,t={}){let{forceHttps:r=true,removeTrailingSlash:i=true,domain:o=e.site.domain,pathPrefix:n="/blog"}=t;if(!o)throw new Error("Domain is required for canonical URL generation");if(!e.slug)throw new Error("Article slug is required for canonical URL generation");let l=x(o,r),u=F(e.slug),c=n.replace(/^(?!\/)/,"/").replace(/\/+$/,""),a=`${l}${c}/${u}`;return i&&(a=a.replace(/\/+$/,"")),a}function T(e){let t=new Map;for(let r of e)for(let i of r.topics??[])t.has(i.slug)||t.set(i.slug,i);return Array.from(t.values()).sort((r,i)=>r.name.localeCompare(i.name))}function L(e="/blog"){let t=e.trim();return !t||t==="/"?"":t.replace(/^(?!\/)/,"/").replace(/\/+$/,"")}function b(e,t){let r=L(e),i=t?.replace(/^\/+/,"").replace(/\/+$/,"");return i?`${r}/${i}`.replace(/\/+/g,"/"):r||"/"}function v(e,t){return b(e,`authors/${t}`)}async function U(e,t,r=[],i={}){let{includeAuthorPages:o=true,includeTopicPages:n=true,includePaginationPages:l=true,articlesPerPage:u=10,maxEntries:c=5e4,changeFrequency:a={},priority:g={}}=i,s=[],m=x(i.canonical?.domain??e.domain,i.canonical?.forceHttps??true),f=i.canonical?.pathPrefix??"/blog",R=r.length>0?r:O(t),y=T([...t]);if(s.push({url:`${m}${f}`,lastModified:P(t),changeFrequency:a.homePage??"daily",priority:g.homePage??1}),t.forEach(p=>{if(s.length>=c)return;let d=_(p,i.canonical);s.push({url:d,lastModified:p.updatedAt,changeFrequency:a.articles??"monthly",priority:g.articles??.8});}),n&&y.length>0&&(s.length<c&&s.push({url:`${m}${b(f,"topics")}`,lastModified:P(t),changeFrequency:a.topicPages??"weekly",priority:g.topicPages??.6}),y.forEach(p=>{if(s.length>=c)return;let d=t.filter(S=>(S.topics??[]).some(h=>h.slug===p.slug));s.push({url:`${m}${b(f,`topics/${p.slug}`)}`,lastModified:P(d),changeFrequency:a.topicPages??"weekly",priority:g.topicPages??.6});})),o&&R.length>0&&(s.length<c&&s.push({url:`${m}${b(f,"authors")}`,lastModified:P(t),changeFrequency:a.authorPages??"weekly",priority:g.authorPages??.6}),R.forEach(p=>{if(s.length>=c)return;let d=`${m}${v(f,p.slug)}`,S=t.filter(A=>A.author?.id===p.id),h=P(S);s.push({url:d,lastModified:h,changeFrequency:a.authorPages??"weekly",priority:g.authorPages??.6});})),l&&t.length>u){let p=Math.ceil(t.length/u);for(let d=2;d<=p&&!(s.length>=c);d++)s.push({url:`${m}${f}?page=${d}`,lastModified:P(t),changeFrequency:a.paginationPages??"daily",priority:g.paginationPages??.5});}return s}function X(e,t,r=[],i={}){let{includeAuthorPages:o=true,includeTopicPages:n=true,includePaginationPages:l=true,articlesPerPage:u=10,maxEntries:c=5e4,changeFrequency:a={},priority:g={}}=i,s=[],m=x(i.canonical?.domain??e.domain,i.canonical?.forceHttps??true),f=i.canonical?.pathPrefix??"/blog",R=new Date().toISOString(),y=r.length>0?r:O(t),p=T([...t]),d=1;if(d+=t.length,n&&p.length>0&&(d+=p.length+1),o&&(d+=y.length>0?y.length+1:0),l&&t.length>u){let h=Math.ceil(t.length/u);d+=h-1;}let S=d>c;if(s.push({loc:`${m}${f}`,lastmod:P(t),changefreq:a.homePage??"daily",priority:g.homePage??1}),t.forEach(h=>{if(s.length>=c)return;let A=_(h,i.canonical);s.push({loc:A,lastmod:h.updatedAt,changefreq:a.articles??"monthly",priority:g.articles??.8});}),n&&p.length>0&&(s.length<c&&s.push({loc:`${m}${b(f,"topics")}`,lastmod:P(t),changefreq:a.topicPages??"weekly",priority:g.topicPages??.6}),p.forEach(h=>{if(s.length>=c)return;let A=t.filter($=>($.topics??[]).some(E=>E.slug===h.slug));s.push({loc:`${m}${b(f,`topics/${h.slug}`)}`,lastmod:P(A),changefreq:a.topicPages??"weekly",priority:g.topicPages??.6});})),o&&y.length>0&&(s.length<c&&s.push({loc:`${m}${b(f,"authors")}`,lastmod:P(t),changefreq:a.authorPages??"weekly",priority:g.authorPages??.6}),y.forEach(h=>{if(s.length>=c)return;let A=`${m}${v(f,h.slug)}`,$=t.filter(B=>B.author?.id===h.id),E=P($);s.push({loc:A,lastmod:E,changefreq:a.authorPages??"weekly",priority:g.authorPages??.6});})),l&&t.length>u){let h=Math.ceil(t.length/u);for(let A=2;A<=h&&!(s.length>=c);A++)s.push({loc:`${m}${f}?page=${A}`,lastmod:P(t),changefreq:a.paginationPages??"daily",priority:g.paginationPages??.5});}return {entries:s,totalEntries:s.length,truncated:S,generatedAt:R,baseUrl:m}}function C(e){let t='<?xml version="1.0" encoding="UTF-8"?>',r='<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',i="</urlset>",o=e.entries.map(n=>{let l=[];return l.push("  <url>"),l.push(`    <loc>${w(n.loc)}</loc>`),n.lastmod&&l.push(`    <lastmod>${w(n.lastmod)}</lastmod>`),n.changefreq&&l.push(`    <changefreq>${w(n.changefreq)}</changefreq>`),n.priority!==void 0&&l.push(`    <priority>${n.priority.toFixed(1)}</priority>`),l.push("  </url>"),l.join(`
+`)});return [t,r,...o,i].join(`
+`)}function J(e,t){let r='<?xml version="1.0" encoding="UTF-8"?>',i='<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',o="</sitemapindex>",n=e.map(l=>{let u=[];return u.push("  <sitemap>"),u.push(`    <loc>${w(l.url)}</loc>`),l.lastmod&&u.push(`    <lastmod>${w(l.lastmod)}</lastmod>`),u.push("  </sitemap>"),u.join(`
+`)});return [r,i,...n,o].join(`
+`)}function Q(e){let t=[],r=[];e.entries.length===0?t.push("Sitemap must contain at least one URL"):e.entries.length>5e4&&t.push("Sitemap contains more than 50,000 URLs (Google limit)"),e.truncated&&r.push("Sitemap was truncated due to size limits"),e.entries.forEach((o,n)=>{try{new URL(o.loc);}catch{t.push(`Invalid URL at entry ${n+1}: ${o.loc}`);}o.priority!==void 0&&(o.priority<0||o.priority>1)&&t.push(`Invalid priority at entry ${n+1}: must be between 0.0 and 1.0`),o.lastmod&&!M(o.lastmod)&&t.push(`Invalid lastmod date at entry ${n+1}: ${o.lastmod}`),o.loc.length>2048&&r.push(`URL at entry ${n+1} exceeds 2048 character limit`);});let i=new Map;return e.entries.forEach(o=>{let n=i.get(o.loc)??0;i.set(o.loc,n+1);}),i.forEach((o,n)=>{o>1&&t.push(`Duplicate URL found: ${n} (appears ${o} times)`);}),{valid:t.length===0,errors:t,warnings:r}}function P(e){return e.length===0?new Date().toISOString():e.reduce((r,i)=>{let o=new Date(i.updatedAt);return o>r?o:r},new Date(e[0].updatedAt)).toISOString()}function Y(e,t,r=[],i={}){return async function(){let l=(await U(e,t,r,i)).map(a=>({loc:a.url,lastmod:typeof a.lastModified=="string"?a.lastModified:a.lastModified?.toISOString(),changefreq:a.changeFrequency,priority:a.priority})),u={entries:l,totalEntries:l.length,generatedAt:new Date().toISOString(),baseUrl:x(i.canonical?.domain??e.domain,i.canonical?.forceHttps??true)},c=C(u);return new Response(c,{headers:{"Content-Type":"application/xml","Cache-Control":"public, max-age=3600, s-maxage=3600"}})}}function K(e){return async function(){let r=[...e.staticRoutes??[],...e.getStaticRoutes?await e.getStaticRoutes():[]],i=await e.getSite(),o=await e.getArticles(),n=e.getAuthors?await e.getAuthors():[];return [...r,...await U(i,o,n,e.options)]}}function w(e){let t={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#x27;"};return e.replace(/[&<>"']/g,r=>t[r]??r)}function M(e){try{let t=new Date(e),r=t.toISOString(),i=e.endsWith("Z")&&!e.includes(".")?e.replace("Z",".000Z"):e;return r===i&&!isNaN(t.getTime())}catch{return  false}}exports.createBlogSitemapRoute=Y;exports.createDynamicBlogSitemap=K;exports.generateBlogSitemapEntries=U;exports.generateSitemap=X;exports.generateSitemapIndex=J;exports.sitemapToXml=C;exports.validateSitemap=Q;//# sourceMappingURL=sitemap.js.map
+//# sourceMappingURL=sitemap.js.map

package/dist/sitemap.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/lib/authors.ts","../src/lib/seo.ts","../src/lib/topics.ts","../src/lib/urls.ts","../src/lib/sitemap.ts"],"names":["getAuthorsFromArticles","articles","authorsBySlug","article","mergeAuthorProfile","a","b","current","next","normalizeDomain","domain","forceHttps","normalized","normalizeSlug","slug","trimmed","clean","generateCanonicalUrl","options","removeTrailingSlash","pathPrefix","normalizedDomain","normalizedSlug","cleanPrefix","canonicalUrl","getAllTopics","topicsBySlug","topic","normalizeBlogBasePath","basePath","buildBlogPath","normalizedBasePath","cleanSlug","buildAuthorPath","authorSlug","generateBlogSitemapEntries","site","authors","includeAuthorPages","includeTopicPages","includePaginationPages","articlesPerPage","maxEntries","changeFrequency","priority","entries","baseUrl","sitemapAuthors","sitemapTopics","getLatestModificationDate","articleUrl","topicArticles","candidate","author","authorUrl","authorArticles","latestAuthorMod","totalPages","page","generateSitemap","generatedAt","potentialEntries","willTruncate","sitemapToXml","sitemapData","xmlHeader","urlsetOpen","urlsetClose","urlEntries","entry","elements","escapeXml","generateSitemapIndex","sitemaps","_baseUrl","indexOpen","indexClose","sitemapEntries","sitemap","validateSitemap","errors","warnings","index","isValidISODate","urlCounts","count","url","latest","articleDate","createBlogSitemapRoute","xmlEntries","xml","createDynamicBlogSitemap","config","staticRoutes","text","xmlEscapes","char","dateString","date","isoString","normalizedInput"],"mappings":"aAcO,SAASA,CAAAA,CACdC,CAAAA,CACmB,CACnB,IAAMC,EAAgB,IAAI,GAAA,CAE1B,IAAA,IAAWC,CAAAA,IAAWF,EAChBE,CAAAA,CAAQ,MAAA,EAAQ,IAAA,EAClBD,CAAAA,CAAc,IACZC,CAAAA,CAAQ,MAAA,CAAO,IAAA,CACfC,CAAAA,CACEF,CAAAA,CAAc,GAAA,CAAIC,CAAAA,CAAQ,MAAA,CAAO,IAAI,CAAA,CACrCA,CAAAA,CAAQ,MACV,CACF,EAIJ,OAAO,KAAA,CAAM,IAAA,CAAKD,CAAAA,CAAc,QAAQ,CAAA,CAAE,IAAA,CAAK,CAACG,CAAAA,CAAGC,CAAAA,GACjDD,CAAAA,CAAE,IAAA,CAAK,cAAcC,CAAAA,CAAE,IAAI,CAC7B,CACF,CA8CA,SAASF,CAAAA,CACPG,CAAAA,CACAC,CAAAA,CACiB,CACjB,OAAKD,CAAAA,CAIE,CACL,GAAGA,EACH,GAAA,CAAKA,CAAAA,CAAQ,GAAA,EAAOC,CAAAA,CAAK,IACzB,SAAA,CAAWD,CAAAA,CAAQ,SAAA,EAAaC,CAAAA,CAAK,UACrC,QAAA,CAAUD,CAAAA,CAAQ,QAAA,EAAYC,CAAAA,CAAK,SACnC,WAAA,CAAaD,CAAAA,CAAQ,WAAA,EAAeC,CAAAA,CAAK,WAAA,CACzC,cAAA,CACED,CAAAA,CAAQ,cAAA,CAAe,OAAS,CAAA,CAC5BA,CAAAA,CAAQ,cAAA,CACRC,CAAAA,CAAK,cACb,CAAA,CAbSA,CAcX,CC3DO,SAASC,EAAgBC,CAAAA,CAAgBC,CAAAA,CAAa,IAAA,CAAc,CACzE,IAAIC,CAAAA,CAAaF,CAAAA,CAAO,IAAA,EAAK,CAG7B,OAAAE,CAAAA,CAAaA,CAAAA,CAAW,OAAA,CAAQ,MAAA,CAAQ,EAAE,CAAA,CAGrC,cAAA,CAAe,IAAA,CAAKA,CAAU,IACjCA,CAAAA,CAAa,CAAA,EAAGD,CAAAA,CAAa,OAAA,CAAU,MAAM,CAAA,GAAA,EAAMC,CAAU,CAAA,CAAA,CAAA,CAI3DD,GAAcC,CAAAA,CAAW,UAAA,CAAW,SAAS,CAAA,GAC/CA,EAAaA,CAAAA,CAAW,OAAA,CAAQ,SAAA,CAAW,UAAU,GAGhDA,CACT,CAgBO,SAASC,CAAAA,CAAcC,EAAsB,CAClD,IAAMC,CAAAA,CAAUD,CAAAA,CAAK,MAAK,CAE1B,GAAI,CAACC,CAAAA,CACH,MAAM,IAAI,KAAA,CAAM,sBAAsB,CAAA,CAIxC,GAAI,CAAC,cAAA,CAAe,IAAA,CAAKA,CAAO,CAAA,CAC9B,MAAM,IAAI,KAAA,CAAM,+DAA+D,CAAA,CAOjF,IAAMC,CAAAA,CAHaD,CAAAA,CAAQ,QAAQ,KAAA,CAAO,GAAG,CAAA,CAGpB,OAAA,CAAQ,WAAY,EAAE,CAAA,CAE/C,GAAI,CAACC,EACH,MAAM,IAAI,KAAA,CAAM,qCAAqC,EAGvD,OAAOA,CACT,CAyBO,SAASC,EACdd,CAAAA,CACAe,CAAAA,CAA+B,EAAC,CACxB,CACR,GAAM,CACJ,UAAA,CAAAP,CAAAA,CAAa,IAAA,CACb,mBAAA,CAAAQ,CAAAA,CAAsB,IAAA,CACtB,OAAAT,CAAAA,CAASP,CAAAA,CAAQ,IAAA,CAAK,MAAA,CACtB,WAAAiB,CAAAA,CAAa,OACf,CAAA,CAAIF,CAAAA,CAEJ,GAAI,CAACR,CAAAA,CACH,MAAM,IAAI,MAAM,iDAAiD,CAAA,CAGnE,GAAI,CAACP,EAAQ,IAAA,CACX,MAAM,IAAI,KAAA,CAAM,uDAAuD,CAAA,CAIzE,IAAMkB,CAAAA,CAAmBZ,CAAAA,CAAgBC,EAAQC,CAAU,CAAA,CACrDW,CAAAA,CAAiBT,CAAAA,CAAcV,CAAAA,CAAQ,IAAI,CAAA,CAG3CoB,CAAAA,CAAcH,EACjB,OAAA,CAAQ,SAAA,CAAW,GAAG,CAAA,CACtB,QAAQ,MAAA,CAAQ,EAAE,CAAA,CAGjBI,CAAAA,CAAe,GAAGH,CAAgB,CAAA,EAAGE,CAAW,CAAA,CAAA,EAAID,CAAc,CAAA,CAAA,CAGtE,OAAIH,CAAAA,GACFK,CAAAA,CAAeA,EAAa,OAAA,CAAQ,MAAA,CAAQ,EAAE,CAAA,CAAA,CAGzCA,CACT,CChJO,SAASC,CAAAA,CAAaxB,CAAAA,CAAgD,CAC3E,IAAMyB,CAAAA,CAAe,IAAI,GAAA,CAEzB,IAAA,IAAWvB,CAAAA,IAAWF,CAAAA,CACpB,IAAA,IAAW0B,KAASxB,CAAAA,CAAQ,MAAA,EAAU,EAAC,CAChCuB,EAAa,GAAA,CAAIC,CAAAA,CAAM,IAAI,CAAA,EAC9BD,EAAa,GAAA,CAAIC,CAAAA,CAAM,IAAA,CAAMA,CAAK,EAKxC,OAAO,KAAA,CAAM,IAAA,CAAKD,CAAAA,CAAa,QAAQ,CAAA,CAAE,IAAA,CAAK,CAACrB,EAAGC,CAAAA,GAChDD,CAAAA,CAAE,IAAA,CAAK,aAAA,CAAcC,EAAE,IAAI,CAC7B,CACF,CCxBO,SAASsB,CAAAA,CAAsBC,CAAAA,CAAW,OAAA,CAAiB,CAChE,IAAMd,CAAAA,CAAUc,CAAAA,CAAS,IAAA,GACzB,OAAI,CAACd,CAAAA,EAAWA,CAAAA,GAAY,IAAY,EAAA,CAEjCA,CAAAA,CAAQ,OAAA,CAAQ,SAAA,CAAW,GAAG,CAAA,CAAE,OAAA,CAAQ,MAAA,CAAQ,EAAE,CAC3D,CAEO,SAASe,CAAAA,CACdD,CAAAA,CACAf,EACQ,CACR,IAAMiB,CAAAA,CAAqBH,CAAAA,CAAsBC,CAAQ,CAAA,CACnDG,CAAAA,CAAYlB,CAAAA,EAAM,OAAA,CAAQ,MAAA,CAAQ,EAAE,CAAA,CAAE,OAAA,CAAQ,OAAQ,EAAE,CAAA,CAE9D,OAAKkB,CAAAA,CAIE,GAAGD,CAAkB,CAAA,CAAA,EAAIC,CAAS,CAAA,CAAA,CAAG,QAAQ,MAAA,CAAQ,GAAG,CAAA,CAHtDD,CAAAA,EAAsB,GAIjC,CAEO,SAASE,CAAAA,CACdJ,CAAAA,CACAK,EACQ,CACR,OAAOJ,CAAAA,CAAcD,CAAAA,CAAU,WAAWK,CAAU,CAAA,CAAE,CACxD,CCuKA,eAAsBC,CAAAA,CACpBC,CAAAA,CACAnC,CAAAA,CACAoC,CAAAA,CAAsC,EAAC,CACvCnB,CAAAA,CAA0B,GACK,CAC/B,GAAM,CACJ,kBAAA,CAAAoB,EAAqB,IAAA,CACrB,iBAAA,CAAAC,CAAAA,CAAoB,IAAA,CACpB,uBAAAC,CAAAA,CAAyB,IAAA,CACzB,eAAA,CAAAC,CAAAA,CAAkB,GAClB,UAAA,CAAAC,CAAAA,CAAa,GAAA,CACb,eAAA,CAAAC,EAAkB,EAAC,CACnB,QAAA,CAAAC,CAAAA,CAAW,EACb,CAAA,CAAI1B,CAAAA,CAEE2B,CAAAA,CAAgC,EAAC,CACjCC,CAAAA,CAAUrC,CAAAA,CACdS,CAAAA,CAAQ,SAAA,EAAW,MAAA,EAAUkB,CAAAA,CAAK,MAAA,CAClClB,EAAQ,SAAA,EAAW,UAAA,EAAc,IACnC,CAAA,CAEME,EAAaF,CAAAA,CAAQ,SAAA,EAAW,UAAA,EAAc,OAAA,CAC9C6B,EACJV,CAAAA,CAAQ,MAAA,CAAS,CAAA,CAAIA,CAAAA,CAAUrC,EAAuBC,CAAQ,CAAA,CAC1D+C,CAAAA,CAAgBvB,CAAAA,CAAa,CAAC,GAAGxB,CAAQ,CAAC,CAAA,CAiFhD,GA9EA4C,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAK,GAAGC,CAAO,CAAA,EAAG1B,CAAU,CAAA,CAAA,CAC5B,YAAA,CAAc6B,CAAAA,CAA0BhD,CAAQ,CAAA,CAChD,gBAAiB0C,CAAAA,CAAgB,QAAA,EAAY,OAAA,CAC7C,QAAA,CAAUC,EAAS,QAAA,EAAY,CACjC,CAAC,CAAA,CAGD3C,EAAS,OAAA,CAASE,CAAAA,EAAY,CAC5B,GAAI0C,EAAQ,MAAA,EAAUH,CAAAA,CAAY,OAElC,IAAMQ,EAAajC,CAAAA,CAAqBd,CAAAA,CAASe,CAAAA,CAAQ,SAAS,EAClE2B,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAKK,EACL,YAAA,CAAc/C,CAAAA,CAAQ,SAAA,CACtB,eAAA,CAAiBwC,CAAAA,CAAgB,QAAA,EAAY,SAAA,CAC7C,QAAA,CAAUC,EAAS,QAAA,EAAY,EACjC,CAAC,EACH,CAAC,CAAA,CAEGL,CAAAA,EAAqBS,CAAAA,CAAc,MAAA,CAAS,IAC1CH,CAAAA,CAAQ,MAAA,CAASH,CAAAA,EACnBG,CAAAA,CAAQ,KAAK,CACX,GAAA,CAAK,CAAA,EAAGC,CAAO,GAAGhB,CAAAA,CAAcV,CAAAA,CAAY,QAAQ,CAAC,GACrD,YAAA,CAAc6B,CAAAA,CAA0BhD,CAAQ,CAAA,CAChD,gBAAiB0C,CAAAA,CAAgB,UAAA,EAAc,QAAA,CAC/C,QAAA,CAAUC,CAAAA,CAAS,UAAA,EAAc,EACnC,CAAC,EAGHI,CAAAA,CAAc,OAAA,CAASrB,CAAAA,EAAU,CAC/B,GAAIkB,CAAAA,CAAQ,MAAA,EAAUH,CAAAA,CAAY,OAElC,IAAMS,CAAAA,CAAgBlD,CAAAA,CAAS,MAAA,CAAQE,CAAAA,EAAAA,CACpCA,EAAQ,MAAA,EAAU,EAAC,EAAG,IAAA,CAAMiD,GAAcA,CAAAA,CAAU,IAAA,GAASzB,CAAAA,CAAM,IAAI,CAC1E,CAAA,CAEAkB,CAAAA,CAAQ,IAAA,CAAK,CACX,IAAK,CAAA,EAAGC,CAAO,CAAA,EAAGhB,CAAAA,CAAcV,CAAAA,CAAY,CAAA,OAAA,EAAUO,CAAAA,CAAM,IAAI,EAAE,CAAC,CAAA,CAAA,CACnE,YAAA,CAAcsB,CAAAA,CAA0BE,CAAa,CAAA,CACrD,eAAA,CAAiBR,CAAAA,CAAgB,UAAA,EAAc,SAC/C,QAAA,CAAUC,CAAAA,CAAS,UAAA,EAAc,EACnC,CAAC,EACH,CAAC,CAAA,CAAA,CAICN,CAAAA,EAAsBS,EAAe,MAAA,CAAS,CAAA,GAC5CF,CAAAA,CAAQ,MAAA,CAASH,GACnBG,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAK,GAAGC,CAAO,CAAA,EAAGhB,CAAAA,CAAcV,CAAAA,CAAY,SAAS,CAAC,CAAA,CAAA,CACtD,YAAA,CAAc6B,EAA0BhD,CAAQ,CAAA,CAChD,eAAA,CAAiB0C,CAAAA,CAAgB,aAAe,QAAA,CAChD,QAAA,CAAUC,CAAAA,CAAS,WAAA,EAAe,EACpC,CAAC,CAAA,CAGHG,CAAAA,CAAe,OAAA,CAASM,GAAW,CACjC,GAAIR,CAAAA,CAAQ,MAAA,EAAUH,EAAY,OAElC,IAAMY,CAAAA,CAAY,CAAA,EAAGR,CAAO,CAAA,EAAGb,CAAAA,CAAgBb,CAAAA,CAAYiC,CAAAA,CAAO,IAAI,CAAC,CAAA,CAAA,CAGjEE,CAAAA,CAAiBtD,CAAAA,CAAS,MAAA,CAC7BE,CAAAA,EAAYA,CAAAA,CAAQ,MAAA,EAAQ,KAAOkD,CAAAA,CAAO,EAC7C,CAAA,CACMG,CAAAA,CAAkBP,EAA0BM,CAAc,CAAA,CAEhEV,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAKS,CAAAA,CACL,YAAA,CAAcE,CAAAA,CACd,gBAAiBb,CAAAA,CAAgB,WAAA,EAAe,QAAA,CAChD,QAAA,CAAUC,EAAS,WAAA,EAAe,EACpC,CAAC,EACH,CAAC,CAAA,CAAA,CAICJ,CAAAA,EAA0BvC,CAAAA,CAAS,MAAA,CAASwC,EAAiB,CAC/D,IAAMgB,CAAAA,CAAa,IAAA,CAAK,IAAA,CAAKxD,CAAAA,CAAS,MAAA,CAASwC,CAAe,EAE9D,IAAA,IAASiB,CAAAA,CAAO,CAAA,CAAGA,CAAAA,EAAQD,GACrB,EAAAZ,CAAAA,CAAQ,MAAA,EAAUH,CAAAA,CAAAA,CADegB,IAGrCb,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAK,GAAGC,CAAO,CAAA,EAAG1B,CAAU,CAAA,MAAA,EAASsC,CAAI,CAAA,CAAA,CACzC,YAAA,CAAcT,CAAAA,CAA0BhD,CAAQ,EAChD,eAAA,CAAiB0C,CAAAA,CAAgB,eAAA,EAAmB,OAAA,CACpD,SAAUC,CAAAA,CAAS,eAAA,EAAmB,EACxC,CAAC,EAEL,CAEA,OAAOC,CACT,CAYO,SAASc,CAAAA,CACdvB,CAAAA,CACAnC,CAAAA,CACAoC,EAAsC,EAAC,CACvCnB,CAAAA,CAA0B,GACb,CACb,GAAM,CACJ,kBAAA,CAAAoB,EAAqB,IAAA,CACrB,iBAAA,CAAAC,CAAAA,CAAoB,IAAA,CACpB,uBAAAC,CAAAA,CAAyB,IAAA,CACzB,eAAA,CAAAC,CAAAA,CAAkB,GAClB,UAAA,CAAAC,CAAAA,CAAa,GAAA,CACb,eAAA,CAAAC,EAAkB,EAAC,CACnB,QAAA,CAAAC,CAAAA,CAAW,EACb,CAAA,CAAI1B,CAAAA,CAEE2B,EAA0B,EAAC,CAC3BC,CAAAA,CAAUrC,CAAAA,CACdS,EAAQ,SAAA,EAAW,MAAA,EAAUkB,CAAAA,CAAK,MAAA,CAClClB,EAAQ,SAAA,EAAW,UAAA,EAAc,IACnC,CAAA,CAEME,EAAaF,CAAAA,CAAQ,SAAA,EAAW,UAAA,EAAc,OAAA,CAC9C0C,EAAc,IAAI,IAAA,EAAK,CAAE,WAAA,GACzBb,CAAAA,CACJV,CAAAA,CAAQ,MAAA,CAAS,CAAA,CAAIA,EAAUrC,CAAAA,CAAuBC,CAAQ,CAAA,CAC1D+C,CAAAA,CAAgBvB,CAAAA,CAAa,CAAC,GAAGxB,CAAQ,CAAC,CAAA,CAG5C4D,CAAAA,CAAmB,CAAA,CAQvB,GAPAA,GAAoB5D,CAAAA,CAAS,MAAA,CACzBsC,CAAAA,EAAqBS,CAAAA,CAAc,OAAS,CAAA,GAC9Ca,CAAAA,EAAoBb,CAAAA,CAAc,MAAA,CAAS,GAEzCV,CAAAA,GACFuB,CAAAA,EAAoBd,CAAAA,CAAe,MAAA,CAAS,EAAIA,CAAAA,CAAe,MAAA,CAAS,CAAA,CAAI,CAAA,CAAA,CAE1EP,GAA0BvC,CAAAA,CAAS,MAAA,CAASwC,CAAAA,CAAiB,CAC/D,IAAMgB,CAAAA,CAAa,IAAA,CAAK,IAAA,CAAKxD,CAAAA,CAAS,MAAA,CAASwC,CAAe,CAAA,CAC9DoB,CAAAA,EAAoBJ,EAAa,EACnC,CAEA,IAAMK,CAAAA,CAAeD,EAAmBnB,CAAAA,CAiFxC,GA9EAG,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAK,CAAA,EAAGC,CAAO,CAAA,EAAG1B,CAAU,CAAA,CAAA,CAC5B,OAAA,CAAS6B,CAAAA,CAA0BhD,CAAQ,EAC3C,UAAA,CAAY0C,CAAAA,CAAgB,QAAA,EAAY,OAAA,CACxC,SAAUC,CAAAA,CAAS,QAAA,EAAY,CACjC,CAAC,EAGD3C,CAAAA,CAAS,OAAA,CAASE,CAAAA,EAAY,CAC5B,GAAI0C,CAAAA,CAAQ,MAAA,EAAUH,CAAAA,CAAY,OAElC,IAAMQ,CAAAA,CAAajC,CAAAA,CAAqBd,CAAAA,CAASe,EAAQ,SAAS,CAAA,CAClE2B,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAKK,CAAAA,CACL,OAAA,CAAS/C,CAAAA,CAAQ,UACjB,UAAA,CAAYwC,CAAAA,CAAgB,QAAA,EAAY,SAAA,CACxC,SAAUC,CAAAA,CAAS,QAAA,EAAY,EACjC,CAAC,EACH,CAAC,CAAA,CAEGL,CAAAA,EAAqBS,CAAAA,CAAc,OAAS,CAAA,GAC1CH,CAAAA,CAAQ,MAAA,CAASH,CAAAA,EACnBG,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAK,GAAGC,CAAO,CAAA,EAAGhB,CAAAA,CAAcV,CAAAA,CAAY,QAAQ,CAAC,CAAA,CAAA,CACrD,OAAA,CAAS6B,CAAAA,CAA0BhD,CAAQ,CAAA,CAC3C,UAAA,CAAY0C,CAAAA,CAAgB,UAAA,EAAc,SAC1C,QAAA,CAAUC,CAAAA,CAAS,UAAA,EAAc,EACnC,CAAC,CAAA,CAGHI,CAAAA,CAAc,OAAA,CAASrB,CAAAA,EAAU,CAC/B,GAAIkB,CAAAA,CAAQ,MAAA,EAAUH,CAAAA,CAAY,OAElC,IAAMS,CAAAA,CAAgBlD,CAAAA,CAAS,MAAA,CAAQE,CAAAA,EAAAA,CACpCA,CAAAA,CAAQ,MAAA,EAAU,IAAI,IAAA,CAAMiD,CAAAA,EAAcA,CAAAA,CAAU,IAAA,GAASzB,EAAM,IAAI,CAC1E,CAAA,CAEAkB,CAAAA,CAAQ,KAAK,CACX,GAAA,CAAK,CAAA,EAAGC,CAAO,GAAGhB,CAAAA,CAAcV,CAAAA,CAAY,CAAA,OAAA,EAAUO,CAAAA,CAAM,IAAI,CAAA,CAAE,CAAC,CAAA,CAAA,CACnE,OAAA,CAASsB,EAA0BE,CAAa,CAAA,CAChD,UAAA,CAAYR,CAAAA,CAAgB,YAAc,QAAA,CAC1C,QAAA,CAAUC,CAAAA,CAAS,UAAA,EAAc,EACnC,CAAC,EACH,CAAC,GAICN,CAAAA,EAAsBS,CAAAA,CAAe,MAAA,CAAS,CAAA,GAC5CF,EAAQ,MAAA,CAASH,CAAAA,EACnBG,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAK,CAAA,EAAGC,CAAO,CAAA,EAAGhB,EAAcV,CAAAA,CAAY,SAAS,CAAC,CAAA,CAAA,CACtD,QAAS6B,CAAAA,CAA0BhD,CAAQ,CAAA,CAC3C,UAAA,CAAY0C,EAAgB,WAAA,EAAe,QAAA,CAC3C,QAAA,CAAUC,CAAAA,CAAS,aAAe,EACpC,CAAC,CAAA,CAGHG,CAAAA,CAAe,OAAA,CAASM,CAAAA,EAAW,CACjC,GAAIR,EAAQ,MAAA,EAAUH,CAAAA,CAAY,OAElC,IAAMY,EAAY,CAAA,EAAGR,CAAO,CAAA,EAAGb,CAAAA,CAAgBb,EAAYiC,CAAAA,CAAO,IAAI,CAAC,CAAA,CAAA,CAGjEE,EAAiBtD,CAAAA,CAAS,MAAA,CAC7BE,CAAAA,EAAYA,CAAAA,CAAQ,QAAQ,EAAA,GAAOkD,CAAAA,CAAO,EAC7C,CAAA,CACMG,EAAkBP,CAAAA,CAA0BM,CAAc,CAAA,CAEhEV,CAAAA,CAAQ,KAAK,CACX,GAAA,CAAKS,CAAAA,CACL,OAAA,CAASE,CAAAA,CACT,UAAA,CAAYb,CAAAA,CAAgB,WAAA,EAAe,SAC3C,QAAA,CAAUC,CAAAA,CAAS,WAAA,EAAe,EACpC,CAAC,EACH,CAAC,CAAA,CAAA,CAICJ,CAAAA,EAA0BvC,EAAS,MAAA,CAASwC,CAAAA,CAAiB,CAC/D,IAAMgB,EAAa,IAAA,CAAK,IAAA,CAAKxD,CAAAA,CAAS,MAAA,CAASwC,CAAe,CAAA,CAE9D,IAAA,IAASiB,CAAAA,CAAO,CAAA,CAAGA,GAAQD,CAAAA,EACrB,EAAAZ,CAAAA,CAAQ,MAAA,EAAUH,GADegB,CAAAA,EAAAA,CAGrCb,CAAAA,CAAQ,IAAA,CAAK,CACX,GAAA,CAAK,CAAA,EAAGC,CAAO,CAAA,EAAG1B,CAAU,CAAA,MAAA,EAASsC,CAAI,CAAA,CAAA,CACzC,OAAA,CAAST,EAA0BhD,CAAQ,CAAA,CAC3C,UAAA,CAAY0C,CAAAA,CAAgB,iBAAmB,OAAA,CAC/C,QAAA,CAAUC,CAAAA,CAAS,eAAA,EAAmB,EACxC,CAAC,EAEL,CAEA,OAAO,CACL,OAAA,CAAAC,CAAAA,CACA,YAAA,CAAcA,CAAAA,CAAQ,OACtB,SAAA,CAAWiB,CAAAA,CACX,WAAA,CAAAF,CAAAA,CACA,QAAAd,CACF,CACF,CAeO,SAASiB,CAAAA,CAAaC,CAAAA,CAAkC,CAC7D,IAAMC,EAAY,wCAAA,CACZC,CAAAA,CACJ,8DAAA,CACIC,CAAAA,CAAc,YAEdC,CAAAA,CAAaJ,CAAAA,CAAY,OAAA,CAAQ,GAAA,CAAKK,GAAU,CACpD,IAAMC,CAAAA,CAAqB,GAE3B,OAAAA,CAAAA,CAAS,IAAA,CAAK,SAAS,EACvBA,CAAAA,CAAS,IAAA,CAAK,CAAA,SAAA,EAAYC,CAAAA,CAAUF,EAAM,GAAG,CAAC,CAAA,MAAA,CAAQ,CAAA,CAElDA,EAAM,OAAA,EACRC,CAAAA,CAAS,IAAA,CAAK,CAAA,aAAA,EAAgBC,CAAAA,CAAUF,CAAAA,CAAM,OAAO,CAAC,YAAY,CAAA,CAGhEA,CAAAA,CAAM,UAAA,EACRC,CAAAA,CAAS,KACP,CAAA,gBAAA,EAAmBC,CAAAA,CAAUF,CAAAA,CAAM,UAAU,CAAC,CAAA,aAAA,CAChD,CAAA,CAGEA,CAAAA,CAAM,QAAA,GAAa,QACrBC,CAAAA,CAAS,IAAA,CAAK,CAAA,cAAA,EAAiBD,CAAAA,CAAM,SAAS,OAAA,CAAQ,CAAC,CAAC,CAAA,WAAA,CAAa,EAGvEC,CAAAA,CAAS,IAAA,CAAK,UAAU,CAAA,CAEjBA,EAAS,IAAA,CAAK;AAAA,CAAI,CAC3B,CAAC,CAAA,CAED,OAAO,CAACL,CAAAA,CAAWC,CAAAA,CAAY,GAAGE,CAAAA,CAAYD,CAAW,CAAA,CAAE,IAAA,CAAK;AAAA,CAAI,CACtE,CAiBO,SAASK,CAAAA,CACdC,CAAAA,CACAC,EACQ,CACR,IAAMT,CAAAA,CAAY,wCAAA,CACZU,CAAAA,CACJ,oEAAA,CACIC,EAAa,iBAAA,CAEbC,CAAAA,CAAiBJ,CAAAA,CAAS,GAAA,CAAKK,CAAAA,EAAY,CAC/C,IAAMR,CAAAA,CAAqB,EAAC,CAE5B,OAAAA,CAAAA,CAAS,IAAA,CAAK,aAAa,CAAA,CAC3BA,CAAAA,CAAS,IAAA,CAAK,CAAA,SAAA,EAAYC,CAAAA,CAAUO,CAAAA,CAAQ,GAAG,CAAC,CAAA,MAAA,CAAQ,CAAA,CAEpDA,CAAAA,CAAQ,OAAA,EACVR,CAAAA,CAAS,KAAK,CAAA,aAAA,EAAgBC,CAAAA,CAAUO,CAAAA,CAAQ,OAAO,CAAC,CAAA,UAAA,CAAY,CAAA,CAGtER,CAAAA,CAAS,IAAA,CAAK,cAAc,CAAA,CAErBA,CAAAA,CAAS,IAAA,CAAK;AAAA,CAAI,CAC3B,CAAC,CAAA,CAED,OAAO,CAACL,CAAAA,CAAWU,CAAAA,CAAW,GAAGE,CAAAA,CAAgBD,CAAU,CAAA,CAAE,IAAA,CAAK;AAAA,CAAI,CACxE,CAkBO,SAASG,CAAAA,CAAgBf,EAI9B,CACA,IAAMgB,CAAAA,CAAmB,EAAC,CACpBC,CAAAA,CAAqB,EAAC,CAGxBjB,CAAAA,CAAY,OAAA,CAAQ,MAAA,GAAW,CAAA,CACjCgB,CAAAA,CAAO,KAAK,uCAAuC,CAAA,CAC1ChB,CAAAA,CAAY,OAAA,CAAQ,MAAA,CAAS,GAAA,EACtCgB,EAAO,IAAA,CAAK,uDAAuD,CAAA,CAIjEhB,CAAAA,CAAY,SAAA,EACdiB,CAAAA,CAAS,KAAK,0CAA0C,CAAA,CAI1DjB,CAAAA,CAAY,OAAA,CAAQ,OAAA,CAAQ,CAACK,EAAOa,CAAAA,GAAU,CAE5C,GAAI,CACF,IAAI,GAAA,CAAIb,EAAM,GAAG,EACnB,CAAA,KAAQ,CACNW,CAAAA,CAAO,IAAA,CAAK,wBAAwBE,CAAAA,CAAQ,CAAC,KAAKb,CAAAA,CAAM,GAAG,EAAE,EAC/D,CAIEA,CAAAA,CAAM,QAAA,GAAa,MAAA,GAClBA,CAAAA,CAAM,SAAW,CAAA,EAAKA,CAAAA,CAAM,QAAA,CAAW,CAAA,CAAA,EAExCW,CAAAA,CAAO,IAAA,CACL,6BAA6BE,CAAAA,CAAQ,CAAC,CAAA,6BAAA,CACxC,CAAA,CAIEb,CAAAA,CAAM,OAAA,EAAW,CAACc,CAAAA,CAAed,CAAAA,CAAM,OAAO,CAAA,EAChDW,CAAAA,CAAO,IAAA,CACL,iCAAiCE,CAAAA,CAAQ,CAAC,CAAA,EAAA,EAAKb,CAAAA,CAAM,OAAO,CAAA,CAC9D,EAIEA,CAAAA,CAAM,GAAA,CAAI,MAAA,CAAS,IAAA,EACrBY,CAAAA,CAAS,IAAA,CAAK,gBAAgBC,CAAAA,CAAQ,CAAC,CAAA,6BAAA,CAA+B,EAE1E,CAAC,CAAA,CAGD,IAAME,CAAAA,CAAY,IAAI,IACtB,OAAApB,CAAAA,CAAY,QAAQ,OAAA,CAASK,CAAAA,EAAU,CACrC,IAAMgB,CAAAA,CAAQD,CAAAA,CAAU,IAAIf,CAAAA,CAAM,GAAG,CAAA,EAAK,CAAA,CAC1Ce,CAAAA,CAAU,GAAA,CAAIf,EAAM,GAAA,CAAKgB,CAAAA,CAAQ,CAAC,EACpC,CAAC,CAAA,CAEDD,EAAU,OAAA,CAAQ,CAACC,CAAAA,CAAOC,CAAAA,GAAQ,CAC5BD,CAAAA,CAAQ,GACVL,CAAAA,CAAO,IAAA,CAAK,CAAA,qBAAA,EAAwBM,CAAG,CAAA,UAAA,EAAaD,CAAK,SAAS,EAEtE,CAAC,CAAA,CAEM,CACL,KAAA,CAAOL,CAAAA,CAAO,SAAW,CAAA,CACzB,MAAA,CAAAA,CAAAA,CACA,QAAA,CAAAC,CACF,CACF,CAKA,SAAShC,CAAAA,CACPhD,EACQ,CACR,OAAIA,EAAS,MAAA,GAAW,CAAA,CACf,IAAI,IAAA,EAAK,CAAE,WAAA,GAGDA,CAAAA,CAAS,MAAA,CAAO,CAACsF,CAAAA,CAAQpF,CAAAA,GAAY,CACtD,IAAMqF,CAAAA,CAAc,IAAI,IAAA,CAAKrF,CAAAA,CAAQ,SAAS,CAAA,CAC9C,OAAOqF,CAAAA,CAAcD,CAAAA,CAASC,CAAAA,CAAcD,CAC9C,CAAA,CAAG,IAAI,KAAKtF,CAAAA,CAAS,CAAC,CAAA,CAAG,SAAS,CAAC,CAAA,CAEjB,aACpB,CAuBO,SAASwF,CAAAA,CACdrD,CAAAA,CACAnC,CAAAA,CACAoC,EAAsC,EAAC,CACvCnB,CAAAA,CAA0B,EAAC,CAC3B,CACA,OAAO,gBAAqB,CAS1B,IAAMwE,CAAAA,CAAAA,CARU,MAAMvD,EACpBC,CAAAA,CACAnC,CAAAA,CACAoC,CAAAA,CACAnB,CACF,CAAA,EAG2B,GAAA,CAAKmD,IAAW,CACzC,GAAA,CAAKA,CAAAA,CAAM,GAAA,CACX,OAAA,CACE,OAAOA,EAAM,YAAA,EAAiB,QAAA,CAC1BA,CAAAA,CAAM,YAAA,CACNA,CAAAA,CAAM,YAAA,EAAc,aAAY,CACtC,UAAA,CAAYA,CAAAA,CAAM,eAAA,CAClB,QAAA,CAAUA,CAAAA,CAAM,QAClB,CAAA,CAAE,CAAA,CAEIL,CAAAA,CAAc,CAClB,OAAA,CAAS0B,CAAAA,CACT,aAAcA,CAAAA,CAAW,MAAA,CAEzB,WAAA,CAAa,IAAI,MAAK,CAAE,WAAA,EAAY,CACpC,OAAA,CAASjF,CAAAA,CACPS,CAAAA,CAAQ,WAAW,MAAA,EAAUkB,CAAAA,CAAK,OAClClB,CAAAA,CAAQ,SAAA,EAAW,YAAc,IACnC,CACF,CAAA,CAEMyE,CAAAA,CAAM5B,CAAAA,CAAaC,CAAW,EAEpC,OAAO,IAAI,QAAA,CAAS2B,CAAAA,CAAK,CACvB,OAAA,CAAS,CACP,cAAA,CAAgB,iBAAA,CAChB,eAAA,CAAiB,qCACnB,CACF,CAAC,CACH,CACF,CAkDO,SAASC,CAAAA,CAAyBC,CAAAA,CAA2B,CAClE,OAAO,gBAAwD,CAC7D,IAAMC,CAAAA,CAAe,CACnB,GAAID,EAAO,YAAA,EAAgB,EAAC,CAC5B,GAAIA,CAAAA,CAAO,eAAA,CAAkB,MAAMA,CAAAA,CAAO,eAAA,EAAgB,CAAI,EAChE,CAAA,CACMzD,EAAO,MAAMyD,CAAAA,CAAO,SAAQ,CAC5B5F,CAAAA,CAAW,MAAM4F,CAAAA,CAAO,WAAA,EAAY,CACpCxD,CAAAA,CAAUwD,CAAAA,CAAO,UAAA,CAAa,MAAMA,CAAAA,CAAO,UAAA,EAAW,CAAI,EAAC,CAEjE,OAAO,CACL,GAAGC,CAAAA,CACH,GAAI,MAAM3D,CAAAA,CACRC,CAAAA,CACAnC,EACAoC,CAAAA,CACAwD,CAAAA,CAAO,OACT,CACF,CACF,CACF,CAKA,SAAStB,CAAAA,CAAUwB,CAAAA,CAAsB,CACvC,IAAMC,CAAAA,CAAqC,CACzC,GAAA,CAAK,OAAA,CACL,GAAA,CAAK,MAAA,CACL,GAAA,CAAK,MAAA,CACL,IAAK,QAAA,CACL,GAAA,CAAK,QACP,CAAA,CAEA,OAAOD,CAAAA,CAAK,QAAQ,UAAA,CAAaE,CAAAA,EAASD,CAAAA,CAAWC,CAAI,CAAA,EAAKA,CAAI,CACpE,CAKA,SAASd,CAAAA,CAAee,CAAAA,CAA6B,CACnD,GAAI,CACF,IAAMC,CAAAA,CAAO,IAAI,IAAA,CAAKD,CAAU,CAAA,CAC1BE,EAAYD,CAAAA,CAAK,WAAA,EAAY,CAI7BE,CAAAA,CACJH,CAAAA,CAAW,QAAA,CAAS,GAAG,CAAA,EAAK,CAACA,CAAAA,CAAW,QAAA,CAAS,GAAG,CAAA,CAChDA,EAAW,OAAA,CAAQ,GAAA,CAAK,OAAO,CAAA,CAC/BA,CAAAA,CAEN,OAAOE,IAAcC,CAAAA,EAAmB,CAAC,KAAA,CAAMF,CAAAA,CAAK,OAAA,EAAS,CAC/D,CAAA,KAAQ,CACN,OAAO,MACT,CACF","file":"sitemap.js","sourcesContent":["import type { BlogPlatformStorage } from \"./database\";\nimport { getStorage } from \"./database\";\nimport type { PublishedArticle, PublishedAuthor } from \"../types/contracts\";\n\nexport interface AuthorArchive {\n  author: PublishedAuthor;\n  articles: PublishedArticle[];\n}\n\nexport interface AuthorArchiveOptions {\n  limit?: number;\n  offset?: number;\n}\n\nexport function getAuthorsFromArticles(\n  articles: readonly PublishedArticle[],\n): PublishedAuthor[] {\n  const authorsBySlug = new Map<string, PublishedAuthor>();\n\n  for (const article of articles) {\n    if (article.author?.slug) {\n      authorsBySlug.set(\n        article.author.slug,\n        mergeAuthorProfile(\n          authorsBySlug.get(article.author.slug),\n          article.author,\n        ),\n      );\n    }\n  }\n\n  return Array.from(authorsBySlug.values()).sort((a, b) =>\n    a.name.localeCompare(b.name),\n  );\n}\n\nexport function getAuthorArchive(\n  slug: string,\n  articles: readonly PublishedArticle[],\n): AuthorArchive | null {\n  const authorArticles = articles\n    .filter((article) => article.author?.slug === slug)\n    .sort(\n      (a, b) =>\n        new Date(b.publishedAt).getTime() - new Date(a.publishedAt).getTime(),\n    );\n\n  const author = authorArticles.reduce<PublishedAuthor | null>(\n    (preferredAuthor, article) =>\n      article.author\n        ? mergeAuthorProfile(preferredAuthor, article.author)\n        : preferredAuthor,\n    null,\n  );\n\n  if (!author) {\n    return null;\n  }\n\n  return {\n    author,\n    articles: authorArticles,\n  };\n}\n\nexport async function loadAuthorArchive(\n  slug: string,\n  options: AuthorArchiveOptions = {},\n  storage: BlogPlatformStorage = getStorage(),\n): Promise<AuthorArchive | null> {\n  const { articles } = await storage.listArticles({\n    limit: options.limit ?? 1000,\n    offset: options.offset ?? 0,\n    sortBy: \"publishedAt\",\n    order: \"desc\",\n  });\n\n  return getAuthorArchive(slug, articles);\n}\n\nfunction mergeAuthorProfile(\n  current: PublishedAuthor | null | undefined,\n  next: PublishedAuthor,\n): PublishedAuthor {\n  if (!current) {\n    return next;\n  }\n\n  return {\n    ...current,\n    bio: current.bio ?? next.bio,\n    avatarUrl: current.avatarUrl ?? next.avatarUrl,\n    pronouns: current.pronouns ?? next.pronouns,\n    socialLinks: current.socialLinks ?? next.socialLinks,\n    toneAdjectives:\n      current.toneAdjectives.length > 0\n        ? current.toneAdjectives\n        : next.toneAdjectives,\n  };\n}\n","/**\n * SEO utilities for canonical URL generation and validation.\n *\n * These utilities ensure proper canonical URL structure for SEO optimization,\n * preventing duplicate content issues and improving search engine indexing.\n */\n\nimport type { PublishedArticle, PublishedSite } from '../types/contracts';\n\n/**\n * Configuration options for canonical URL generation.\n */\nexport interface CanonicalUrlOptions {\n  /** Whether to force HTTPS protocol (default: true) */\n  forceHttps?: boolean;\n\n  /** Whether to remove trailing slashes (default: true) */\n  removeTrailingSlash?: boolean;\n\n  /** Custom domain override (uses site.domain if not provided) */\n  domain?: string;\n\n  /** Custom path prefix (default: '/blog') */\n  pathPrefix?: string;\n}\n\n/**\n * Normalizes a domain by ensuring proper protocol and removing trailing slashes.\n *\n * @param domain - The domain to normalize\n * @param forceHttps - Whether to force HTTPS protocol\n * @returns The normalized domain\n *\n * @example\n * ```typescript\n * normalizeDomain('example.com') // 'https://example.com'\n * normalizeDomain('http://example.com/') // 'https://example.com'\n * normalizeDomain('https://example.com', false) // 'https://example.com'\n * ```\n */\nexport function normalizeDomain(domain: string, forceHttps = true): string {\n  let normalized = domain.trim();\n\n  // Remove trailing slashes\n  normalized = normalized.replace(/\\/+$/, '');\n\n  // Add protocol if missing\n  if (!/^https?:\\/\\//.exec(normalized)) {\n    normalized = `${forceHttps ? 'https' : 'http'}://${normalized}`;\n  }\n\n  // Force HTTPS if requested\n  if (forceHttps && normalized.startsWith('http://')) {\n    normalized = normalized.replace('http://', 'https://');\n  }\n\n  return normalized;\n}\n\n/**\n * Validates and normalizes a slug for URL usage.\n *\n * @param slug - The slug to validate and normalize\n * @returns The normalized slug\n * @throws Error if slug is invalid\n *\n * @example\n * ```typescript\n * normalizeSlug('hello-world') // 'hello-world'\n * normalizeSlug('Hello World!') // throws Error\n * normalizeSlug('hello--world') // 'hello-world'\n * ```\n */\nexport function normalizeSlug(slug: string): string {\n  const trimmed = slug.trim();\n\n  if (!trimmed) {\n    throw new Error('Slug cannot be empty');\n  }\n\n  // Check if slug contains only valid characters\n  if (!/^[a-z0-9-]+$/.test(trimmed)) {\n    throw new Error('Slug can only contain lowercase letters, numbers, and hyphens');\n  }\n\n  // Remove multiple consecutive hyphens\n  const normalized = trimmed.replace(/-+/g, '-');\n\n  // Remove leading/trailing hyphens\n  const clean = normalized.replace(/^-+|-+$/g, '');\n\n  if (!clean) {\n    throw new Error('Slug cannot consist only of hyphens');\n  }\n\n  return clean;\n}\n\n/**\n * Generates a canonical URL for an article.\n *\n * @param article - The published article\n * @param options - Configuration options for URL generation\n * @returns The canonical URL\n * @throws Error if article or site data is invalid\n *\n * @example\n * ```typescript\n * const article = {\n *   slug: 'hello-world',\n *   site: { domain: 'example.com' },\n *   // ... other fields\n * };\n *\n * generateCanonicalUrl(article)\n * // 'https://example.com/blog/hello-world'\n *\n * generateCanonicalUrl(article, { pathPrefix: '/posts' })\n * // 'https://example.com/posts/hello-world'\n * ```\n */\nexport function generateCanonicalUrl(\n  article: PublishedArticle,\n  options: CanonicalUrlOptions = {}\n): string {\n  const {\n    forceHttps = true,\n    removeTrailingSlash = true,\n    domain = article.site.domain,\n    pathPrefix = '/blog'\n  } = options;\n\n  if (!domain) {\n    throw new Error('Domain is required for canonical URL generation');\n  }\n\n  if (!article.slug) {\n    throw new Error('Article slug is required for canonical URL generation');\n  }\n\n  // Validate and normalize inputs\n  const normalizedDomain = normalizeDomain(domain, forceHttps);\n  const normalizedSlug = normalizeSlug(article.slug);\n\n  // Ensure path prefix starts with '/' and doesn't end with '/'\n  const cleanPrefix = pathPrefix\n    .replace(/^(?!\\/)/, '/') // Add leading slash if missing\n    .replace(/\\/+$/, ''); // Remove trailing slashes\n\n  // Construct the canonical URL\n  let canonicalUrl = `${normalizedDomain}${cleanPrefix}/${normalizedSlug}`;\n\n  // Remove trailing slash if requested\n  if (removeTrailingSlash) {\n    canonicalUrl = canonicalUrl.replace(/\\/+$/, '');\n  }\n\n  return canonicalUrl;\n}\n\n/**\n * Generates a canonical URL for an article from site and slug data.\n * Useful when you don't have a full PublishedArticle object.\n *\n * @param site - The published site\n * @param slug - The article slug\n * @param options - Configuration options for URL generation\n * @returns The canonical URL\n *\n * @example\n * ```typescript\n * const site = { domain: 'example.com', ... };\n * generateCanonicalUrlFromSlug(site, 'hello-world')\n * // 'https://example.com/blog/hello-world'\n * ```\n */\nexport function generateCanonicalUrlFromSlug(\n  site: PublishedSite,\n  slug: string,\n  options: CanonicalUrlOptions = {}\n): string {\n  return generateCanonicalUrl(\n    {\n      slug,\n      site,\n      // Minimal required fields for canonical URL generation\n      id: '',\n      title: '',\n      excerpt: '',\n      content: '',\n      readingSeconds: 0,\n      wordCount: 0,\n      publishedAt: '',\n      updatedAt: '',\n      author: null,\n      meta: { keywords: [] },\n      version: 1\n    },\n    options\n  );\n}\n\n/**\n * Validates if a URL is a valid canonical URL format.\n *\n * @param url - The URL to validate\n * @returns True if the URL is valid for canonical use\n *\n * @example\n * ```typescript\n * isValidCanonicalUrl('https://example.com/blog/hello-world') // true\n * isValidCanonicalUrl('http://example.com/blog/hello-world') // true\n * isValidCanonicalUrl('example.com/blog/hello-world') // false (missing protocol)\n * isValidCanonicalUrl('https://example.com/blog/hello world') // false (spaces)\n * ```\n */\nexport function isValidCanonicalUrl(url: string): boolean {\n  try {\n    const parsed = new URL(url);\n\n    // Must be HTTP or HTTPS\n    if (!['http:', 'https:'].includes(parsed.protocol)) {\n      return false;\n    }\n\n    // Must have a valid hostname (not empty or just slashes)\n    if (!parsed.hostname || parsed.hostname.length === 0) {\n      return false;\n    }\n\n    // Check for URLs with empty hostname like 'https:///path'\n    if (/^https?:\\/\\/\\//.exec(url) && !/^https?:\\/\\/[^\\/]/.exec(url)) {\n      return false;\n    }\n\n    // Path should not contain unencoded spaces or other problematic characters\n    // Check the original URL string since URL constructor auto-encodes\n    if (url.includes(' ')) {\n      return false;\n    }\n\n    return true;\n  } catch {\n    return false;\n  }\n}\n\n/**\n * Extracts the base URL (protocol + hostname + port) from a canonical URL.\n *\n * @param canonicalUrl - The canonical URL\n * @returns The base URL\n *\n * @example\n * ```typescript\n * getBaseUrl('https://example.com/blog/hello-world') // 'https://example.com'\n * getBaseUrl('https://blog.example.com:8080/posts/test') // 'https://blog.example.com:8080'\n * ```\n */\nexport function getBaseUrl(canonicalUrl: string): string {\n  try {\n    const parsed = new URL(canonicalUrl);\n    return `${parsed.protocol}//${parsed.host}`;\n  } catch {\n    throw new Error('Invalid canonical URL provided');\n  }\n}\n\n/**\n * Updates an article's canonical URL in its meta field.\n *\n * @param article - The article to update\n * @param options - Configuration options for URL generation\n * @returns A new article object with updated canonical URL\n *\n * @example\n * ```typescript\n * const updatedArticle = updateArticleCanonicalUrl(article);\n * console.log(updatedArticle.meta.canonicalUrl); // Generated canonical URL\n * ```\n */\nexport function updateArticleCanonicalUrl(\n  article: PublishedArticle,\n  options: CanonicalUrlOptions = {}\n): PublishedArticle {\n  const canonicalUrl = generateCanonicalUrl(article, options);\n\n  return {\n    ...article,\n    meta: {\n      ...article.meta,\n      canonicalUrl\n    }\n  };\n}","import type { PublishedArticle, PublishedTopic } from \"../types/contracts\";\n\nexport interface TopicArchive {\n  topic: PublishedTopic;\n  articles: PublishedArticle[];\n}\n\nexport function getArticlePrimaryTopic(\n  article: PublishedArticle,\n): PublishedTopic | null {\n  const topics = article.topics ?? [];\n  return topics.find((topic) => topic.isPrimary) ?? topics[0] ?? null;\n}\n\nexport function getAllTopics(articles: PublishedArticle[]): PublishedTopic[] {\n  const topicsBySlug = new Map<string, PublishedTopic>();\n\n  for (const article of articles) {\n    for (const topic of article.topics ?? []) {\n      if (!topicsBySlug.has(topic.slug)) {\n        topicsBySlug.set(topic.slug, topic);\n      }\n    }\n  }\n\n  return Array.from(topicsBySlug.values()).sort((a, b) =>\n    a.name.localeCompare(b.name),\n  );\n}\n\nexport function getTopicArchive(\n  articles: PublishedArticle[],\n  topicSlug: string,\n): TopicArchive | null {\n  const matchingArticles = articles.filter((article) =>\n    (article.topics ?? []).some((topic) => topic.slug === topicSlug),\n  );\n\n  if (matchingArticles.length === 0) {\n    return null;\n  }\n\n  const topic =\n    matchingArticles\n      .flatMap((article) => article.topics ?? [])\n      .find((candidate) => candidate.slug === topicSlug) ?? null;\n\n  if (!topic) {\n    return null;\n  }\n\n  return {\n    topic,\n    articles: matchingArticles,\n  };\n}\n","/**\n * URL helpers shared by package UI, metadata, and sitemap integrations.\n */\n\nexport function normalizeBlogBasePath(basePath = \"/blog\"): string {\n  const trimmed = basePath.trim();\n  if (!trimmed || trimmed === \"/\") return \"\";\n\n  return trimmed.replace(/^(?!\\/)/, \"/\").replace(/\\/+$/, \"\");\n}\n\nexport function buildBlogPath(\n  basePath: string | undefined,\n  slug?: string,\n): string {\n  const normalizedBasePath = normalizeBlogBasePath(basePath);\n  const cleanSlug = slug?.replace(/^\\/+/, \"\").replace(/\\/+$/, \"\");\n\n  if (!cleanSlug) {\n    return normalizedBasePath || \"/\";\n  }\n\n  return `${normalizedBasePath}/${cleanSlug}`.replace(/\\/+/g, \"/\");\n}\n\nexport function buildAuthorPath(\n  basePath: string | undefined,\n  authorSlug: string,\n): string {\n  return buildBlogPath(basePath, `authors/${authorSlug}`);\n}\n\nexport function getPathPrefixFromBlogUrl(blogUrl: string): string {\n  const parsed = new URL(blogUrl);\n  return normalizeBlogBasePath(parsed.pathname);\n}\n","/**\n * Next.js-compatible sitemap generation utilities for blog platform integration.\n *\n * These utilities generate sitemap entries that follow Next.js MetadataRoute.Sitemap\n * conventions, allowing seamless integration with existing Next.js applications.\n *\n * @example Integration with existing Next.js sitemap:\n * ```typescript\n * // app/sitemap.ts\n * import { generateBlogSitemapEntries } from '@xexr/blog-platform';\n * import type { MetadataRoute } from 'next';\n *\n * export default async function sitemap(): Promise<MetadataRoute.Sitemap> {\n *   // Your existing routes\n *   const staticRoutes = [\n *     { url: 'https://yoursite.com', lastModified: new Date(), priority: 1 },\n *     { url: 'https://yoursite.com/about', lastModified: new Date(), priority: 0.8 }\n *   ];\n *\n *   // Blog platform entries\n *   const blogEntries = await generateBlogSitemapEntries(blogConfig);\n *\n *   return [...staticRoutes, ...blogEntries];\n * }\n * ```\n */\n\nimport type {\n  PublishedArticle,\n  PublishedSite,\n  PublishedAuthor,\n} from \"../types/contracts\";\nimport { getAuthorsFromArticles } from \"./authors\";\nimport {\n  generateCanonicalUrl,\n  normalizeDomain,\n  type CanonicalUrlOptions,\n} from \"./seo\";\nimport { getAllTopics } from \"./topics\";\nimport { buildAuthorPath, buildBlogPath } from \"./urls\";\n\n/**\n * Configuration options for sitemap generation.\n */\nexport interface SitemapOptions {\n  /** Canonical URL configuration */\n  canonical?: CanonicalUrlOptions;\n\n  /** Whether to include author pages in sitemap */\n  includeAuthorPages?: boolean;\n\n  /** Whether to include topic pages in sitemap */\n  includeTopicPages?: boolean;\n\n  /** Whether to include pagination pages in sitemap */\n  includePaginationPages?: boolean;\n\n  /** Number of articles per page for pagination calculation */\n  articlesPerPage?: number;\n\n  /** Maximum number of sitemap entries (defaults to 50,000 per Google guidelines) */\n  maxEntries?: number;\n\n  /** Change frequency for different page types */\n  changeFrequency?: {\n    /** Change frequency for blog home page */\n    homePage?: SitemapChangeFreq;\n    /** Change frequency for article pages */\n    articles?: SitemapChangeFreq;\n    /** Change frequency for author pages */\n    authorPages?: SitemapChangeFreq;\n    /** Change frequency for topic index and archive pages */\n    topicPages?: SitemapChangeFreq;\n    /** Change frequency for pagination pages */\n    paginationPages?: SitemapChangeFreq;\n  };\n\n  /** Priority values for different page types */\n  priority?: {\n    /** Priority for blog home page (0.0-1.0) */\n    homePage?: number;\n    /** Priority for article pages (0.0-1.0) */\n    articles?: number;\n    /** Priority for author pages (0.0-1.0) */\n    authorPages?: number;\n    /** Priority for topic index and archive pages (0.0-1.0) */\n    topicPages?: number;\n    /** Priority for pagination pages (0.0-1.0) */\n    paginationPages?: number;\n  };\n}\n\n/**\n * Valid sitemap change frequency values as per XML sitemap standard.\n */\nexport type SitemapChangeFreq =\n  | \"always\"\n  | \"hourly\"\n  | \"daily\"\n  | \"weekly\"\n  | \"monthly\"\n  | \"yearly\"\n  | \"never\";\n\n/**\n * Next.js MetadataRoute.Sitemap compatible entry.\n * This matches the expected format for Next.js sitemap generation.\n */\nexport interface NextjsSitemapEntry {\n  /** The URL of the page */\n  url: string;\n\n  /** Last modification date */\n  lastModified?: string | Date;\n\n  /** Change frequency hint for search engines */\n  changeFrequency?: SitemapChangeFreq;\n\n  /** Priority relative to other URLs on the site (0.0-1.0) */\n  priority?: number;\n\n  /** Alternate language versions (for i18n) */\n  alternates?: {\n    languages?: Record<string, string>;\n  };\n}\n\n/**\n * Legacy XML sitemap entry format (for backward compatibility).\n * @deprecated Use NextjsSitemapEntry for new implementations\n */\nexport interface SitemapEntry {\n  /** The URL of the page */\n  loc: string;\n\n  /** Last modification date as ISO 8601 string */\n  lastmod?: string;\n\n  /** Change frequency hint for search engines */\n  changefreq?: SitemapChangeFreq;\n\n  /** Priority relative to other URLs on the site (0.0-1.0) */\n  priority?: number;\n}\n\n/**\n * Complete sitemap data structure.\n */\nexport interface SitemapData {\n  /** All URL entries in the sitemap */\n  entries: SitemapEntry[];\n\n  /** Total number of entries */\n  totalEntries: number;\n\n  /** Whether the sitemap was truncated due to size limits */\n  truncated: boolean;\n\n  /** Generation timestamp */\n  generatedAt: string;\n\n  /** Base URL used for canonical URL generation */\n  baseUrl: string;\n}\n\n/**\n * Generates Next.js-compatible sitemap entries for blog platform integration.\n *\n * @param site - The published site information\n * @param articles - Array of published articles\n * @param authors - Array of published authors (optional)\n * @param options - Sitemap generation options\n * @returns Array of Next.js MetadataRoute.Sitemap compatible entries\n *\n * @example\n * ```typescript\n * // In your Next.js app/sitemap.ts file:\n * import { generateBlogSitemapEntries } from '@xexr/blog-platform';\n * import type { MetadataRoute } from 'next';\n *\n * export default async function sitemap(): Promise<MetadataRoute.Sitemap> {\n *   const blogEntries = await generateBlogSitemapEntries(site, articles, authors, {\n *     includeAuthorPages: true,\n *     includePaginationPages: true,\n *     changeFrequency: { articles: 'monthly' }\n *   });\n *\n *   return [\n *     // Your existing site routes\n *     { url: 'https://yoursite.com', lastModified: new Date(), priority: 1 },\n *     { url: 'https://yoursite.com/about', lastModified: new Date() },\n *     // Blog entries\n *     ...blogEntries\n *   ];\n * }\n * ```\n */\nexport async function generateBlogSitemapEntries(\n  site: PublishedSite,\n  articles: readonly PublishedArticle[],\n  authors: readonly PublishedAuthor[] = [],\n  options: SitemapOptions = {},\n): Promise<NextjsSitemapEntry[]> {\n  const {\n    includeAuthorPages = true,\n    includeTopicPages = true,\n    includePaginationPages = true,\n    articlesPerPage = 10,\n    maxEntries = 50000,\n    changeFrequency = {},\n    priority = {},\n  } = options;\n\n  const entries: NextjsSitemapEntry[] = [];\n  const baseUrl = normalizeDomain(\n    options.canonical?.domain ?? site.domain,\n    options.canonical?.forceHttps ?? true,\n  );\n\n  const pathPrefix = options.canonical?.pathPrefix ?? \"/blog\";\n  const sitemapAuthors =\n    authors.length > 0 ? authors : getAuthorsFromArticles(articles);\n  const sitemapTopics = getAllTopics([...articles]);\n\n  // Add blog home page\n  entries.push({\n    url: `${baseUrl}${pathPrefix}`,\n    lastModified: getLatestModificationDate(articles),\n    changeFrequency: changeFrequency.homePage ?? \"daily\",\n    priority: priority.homePage ?? 1.0,\n  });\n\n  // Add individual article pages\n  articles.forEach((article) => {\n    if (entries.length >= maxEntries) return;\n\n    const articleUrl = generateCanonicalUrl(article, options.canonical);\n    entries.push({\n      url: articleUrl,\n      lastModified: article.updatedAt,\n      changeFrequency: changeFrequency.articles ?? \"monthly\",\n      priority: priority.articles ?? 0.8,\n    });\n  });\n\n  if (includeTopicPages && sitemapTopics.length > 0) {\n    if (entries.length < maxEntries) {\n      entries.push({\n        url: `${baseUrl}${buildBlogPath(pathPrefix, \"topics\")}`,\n        lastModified: getLatestModificationDate(articles),\n        changeFrequency: changeFrequency.topicPages ?? \"weekly\",\n        priority: priority.topicPages ?? 0.6,\n      });\n    }\n\n    sitemapTopics.forEach((topic) => {\n      if (entries.length >= maxEntries) return;\n\n      const topicArticles = articles.filter((article) =>\n        (article.topics ?? []).some((candidate) => candidate.slug === topic.slug),\n      );\n\n      entries.push({\n        url: `${baseUrl}${buildBlogPath(pathPrefix, `topics/${topic.slug}`)}`,\n        lastModified: getLatestModificationDate(topicArticles),\n        changeFrequency: changeFrequency.topicPages ?? \"weekly\",\n        priority: priority.topicPages ?? 0.6,\n      });\n    });\n  }\n\n  // Add author pages if enabled\n  if (includeAuthorPages && sitemapAuthors.length > 0) {\n    if (entries.length < maxEntries) {\n      entries.push({\n        url: `${baseUrl}${buildBlogPath(pathPrefix, \"authors\")}`,\n        lastModified: getLatestModificationDate(articles),\n        changeFrequency: changeFrequency.authorPages ?? \"weekly\",\n        priority: priority.authorPages ?? 0.6,\n      });\n    }\n\n    sitemapAuthors.forEach((author) => {\n      if (entries.length >= maxEntries) return;\n\n      const authorUrl = `${baseUrl}${buildAuthorPath(pathPrefix, author.slug)}`;\n\n      // Find the latest article by this author for lastModified\n      const authorArticles = articles.filter(\n        (article) => article.author?.id === author.id,\n      );\n      const latestAuthorMod = getLatestModificationDate(authorArticles);\n\n      entries.push({\n        url: authorUrl,\n        lastModified: latestAuthorMod,\n        changeFrequency: changeFrequency.authorPages ?? \"weekly\",\n        priority: priority.authorPages ?? 0.6,\n      });\n    });\n  }\n\n  // Add pagination pages if enabled\n  if (includePaginationPages && articles.length > articlesPerPage) {\n    const totalPages = Math.ceil(articles.length / articlesPerPage);\n\n    for (let page = 2; page <= totalPages; page++) {\n      if (entries.length >= maxEntries) break;\n\n      entries.push({\n        url: `${baseUrl}${pathPrefix}?page=${page}`,\n        lastModified: getLatestModificationDate(articles),\n        changeFrequency: changeFrequency.paginationPages ?? \"daily\",\n        priority: priority.paginationPages ?? 0.5,\n      });\n    }\n  }\n\n  return entries;\n}\n\n/**\n * Legacy sitemap generation for backward compatibility.\n * @deprecated Use generateBlogSitemapEntries for Next.js integration\n *\n * @param site - The published site information\n * @param articles - Array of published articles\n * @param authors - Array of published authors (optional)\n * @param options - Sitemap generation options\n * @returns Complete sitemap data\n */\nexport function generateSitemap(\n  site: PublishedSite,\n  articles: readonly PublishedArticle[],\n  authors: readonly PublishedAuthor[] = [],\n  options: SitemapOptions = {},\n): SitemapData {\n  const {\n    includeAuthorPages = true,\n    includeTopicPages = true,\n    includePaginationPages = true,\n    articlesPerPage = 10,\n    maxEntries = 50000,\n    changeFrequency = {},\n    priority = {},\n  } = options;\n\n  const entries: SitemapEntry[] = [];\n  const baseUrl = normalizeDomain(\n    options.canonical?.domain ?? site.domain,\n    options.canonical?.forceHttps ?? true,\n  );\n\n  const pathPrefix = options.canonical?.pathPrefix ?? \"/blog\";\n  const generatedAt = new Date().toISOString();\n  const sitemapAuthors =\n    authors.length > 0 ? authors : getAuthorsFromArticles(articles);\n  const sitemapTopics = getAllTopics([...articles]);\n\n  // Calculate total potential entries to determine if truncation will occur\n  let potentialEntries = 1; // Home page\n  potentialEntries += articles.length; // Article pages\n  if (includeTopicPages && sitemapTopics.length > 0) {\n    potentialEntries += sitemapTopics.length + 1; // Topic index + topic pages\n  }\n  if (includeAuthorPages) {\n    potentialEntries += sitemapAuthors.length > 0 ? sitemapAuthors.length + 1 : 0; // Authors index + author pages\n  }\n  if (includePaginationPages && articles.length > articlesPerPage) {\n    const totalPages = Math.ceil(articles.length / articlesPerPage);\n    potentialEntries += totalPages - 1; // Pagination pages (excluding page 1 which is home)\n  }\n\n  const willTruncate = potentialEntries > maxEntries;\n\n  // Add blog home page\n  entries.push({\n    loc: `${baseUrl}${pathPrefix}`,\n    lastmod: getLatestModificationDate(articles),\n    changefreq: changeFrequency.homePage ?? \"daily\",\n    priority: priority.homePage ?? 1.0,\n  });\n\n  // Add individual article pages\n  articles.forEach((article) => {\n    if (entries.length >= maxEntries) return;\n\n    const articleUrl = generateCanonicalUrl(article, options.canonical);\n    entries.push({\n      loc: articleUrl,\n      lastmod: article.updatedAt,\n      changefreq: changeFrequency.articles ?? \"monthly\",\n      priority: priority.articles ?? 0.8,\n    });\n  });\n\n  if (includeTopicPages && sitemapTopics.length > 0) {\n    if (entries.length < maxEntries) {\n      entries.push({\n        loc: `${baseUrl}${buildBlogPath(pathPrefix, \"topics\")}`,\n        lastmod: getLatestModificationDate(articles),\n        changefreq: changeFrequency.topicPages ?? \"weekly\",\n        priority: priority.topicPages ?? 0.6,\n      });\n    }\n\n    sitemapTopics.forEach((topic) => {\n      if (entries.length >= maxEntries) return;\n\n      const topicArticles = articles.filter((article) =>\n        (article.topics ?? []).some((candidate) => candidate.slug === topic.slug),\n      );\n\n      entries.push({\n        loc: `${baseUrl}${buildBlogPath(pathPrefix, `topics/${topic.slug}`)}`,\n        lastmod: getLatestModificationDate(topicArticles),\n        changefreq: changeFrequency.topicPages ?? \"weekly\",\n        priority: priority.topicPages ?? 0.6,\n      });\n    });\n  }\n\n  // Add author pages if enabled\n  if (includeAuthorPages && sitemapAuthors.length > 0) {\n    if (entries.length < maxEntries) {\n      entries.push({\n        loc: `${baseUrl}${buildBlogPath(pathPrefix, \"authors\")}`,\n        lastmod: getLatestModificationDate(articles),\n        changefreq: changeFrequency.authorPages ?? \"weekly\",\n        priority: priority.authorPages ?? 0.6,\n      });\n    }\n\n    sitemapAuthors.forEach((author) => {\n      if (entries.length >= maxEntries) return;\n\n      const authorUrl = `${baseUrl}${buildAuthorPath(pathPrefix, author.slug)}`;\n\n      // Find the latest article by this author for lastmod\n      const authorArticles = articles.filter(\n        (article) => article.author?.id === author.id,\n      );\n      const latestAuthorMod = getLatestModificationDate(authorArticles);\n\n      entries.push({\n        loc: authorUrl,\n        lastmod: latestAuthorMod,\n        changefreq: changeFrequency.authorPages ?? \"weekly\",\n        priority: priority.authorPages ?? 0.6,\n      });\n    });\n  }\n\n  // Add pagination pages if enabled\n  if (includePaginationPages && articles.length > articlesPerPage) {\n    const totalPages = Math.ceil(articles.length / articlesPerPage);\n\n    for (let page = 2; page <= totalPages; page++) {\n      if (entries.length >= maxEntries) break;\n\n      entries.push({\n        loc: `${baseUrl}${pathPrefix}?page=${page}`,\n        lastmod: getLatestModificationDate(articles),\n        changefreq: changeFrequency.paginationPages ?? \"daily\",\n        priority: priority.paginationPages ?? 0.5,\n      });\n    }\n  }\n\n  return {\n    entries,\n    totalEntries: entries.length,\n    truncated: willTruncate,\n    generatedAt,\n    baseUrl,\n  };\n}\n\n/**\n * Converts sitemap data to XML format.\n *\n * @param sitemapData - The sitemap data to convert\n * @returns XML string in sitemap format\n *\n * @example\n * ```typescript\n * const sitemap = generateSitemap(site, articles);\n * const xmlString = sitemapToXml(sitemap);\n * // Use in API route response\n * ```\n */\nexport function sitemapToXml(sitemapData: SitemapData): string {\n  const xmlHeader = '<?xml version=\"1.0\" encoding=\"UTF-8\"?>';\n  const urlsetOpen =\n    '<urlset xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">';\n  const urlsetClose = \"</urlset>\";\n\n  const urlEntries = sitemapData.entries.map((entry) => {\n    const elements: string[] = [];\n\n    elements.push(`  <url>`);\n    elements.push(`    <loc>${escapeXml(entry.loc)}</loc>`);\n\n    if (entry.lastmod) {\n      elements.push(`    <lastmod>${escapeXml(entry.lastmod)}</lastmod>`);\n    }\n\n    if (entry.changefreq) {\n      elements.push(\n        `    <changefreq>${escapeXml(entry.changefreq)}</changefreq>`,\n      );\n    }\n\n    if (entry.priority !== undefined) {\n      elements.push(`    <priority>${entry.priority.toFixed(1)}</priority>`);\n    }\n\n    elements.push(`  </url>`);\n\n    return elements.join(\"\\n\");\n  });\n\n  return [xmlHeader, urlsetOpen, ...urlEntries, urlsetClose].join(\"\\n\");\n}\n\n/**\n * Generates a sitemap index for large blogs that need multiple sitemaps.\n *\n * @param sitemaps - Array of sitemap information\n * @param baseUrl - Base URL for the site\n * @returns XML string for sitemap index\n *\n * @example\n * ```typescript\n * const sitemapIndex = generateSitemapIndex([\n *   { url: 'https://example.com/sitemap-articles.xml', lastmod: '2023-01-01T00:00:00Z' },\n *   { url: 'https://example.com/sitemap-authors.xml', lastmod: '2023-01-01T00:00:00Z' }\n * ], 'https://example.com');\n * ```\n */\nexport function generateSitemapIndex(\n  sitemaps: readonly { url: string; lastmod?: string }[],\n  _baseUrl: string,\n): string {\n  const xmlHeader = '<?xml version=\"1.0\" encoding=\"UTF-8\"?>';\n  const indexOpen =\n    '<sitemapindex xmlns=\"http://www.sitemaps.org/schemas/sitemap/0.9\">';\n  const indexClose = \"</sitemapindex>\";\n\n  const sitemapEntries = sitemaps.map((sitemap) => {\n    const elements: string[] = [];\n\n    elements.push(`  <sitemap>`);\n    elements.push(`    <loc>${escapeXml(sitemap.url)}</loc>`);\n\n    if (sitemap.lastmod) {\n      elements.push(`    <lastmod>${escapeXml(sitemap.lastmod)}</lastmod>`);\n    }\n\n    elements.push(`  </sitemap>`);\n\n    return elements.join(\"\\n\");\n  });\n\n  return [xmlHeader, indexOpen, ...sitemapEntries, indexClose].join(\"\\n\");\n}\n\n/**\n * Validates sitemap data for compliance with search engine guidelines.\n *\n * @param sitemapData - The sitemap data to validate\n * @returns Validation results with errors and warnings\n *\n * @example\n * ```typescript\n * const sitemap = generateSitemap(site, articles);\n * const validation = validateSitemap(sitemap);\n *\n * if (validation.errors.length > 0) {\n *   console.error('Sitemap errors:', validation.errors);\n * }\n * ```\n */\nexport function validateSitemap(sitemapData: SitemapData): {\n  valid: boolean;\n  errors: string[];\n  warnings: string[];\n} {\n  const errors: string[] = [];\n  const warnings: string[] = [];\n\n  // Check entry count\n  if (sitemapData.entries.length === 0) {\n    errors.push(\"Sitemap must contain at least one URL\");\n  } else if (sitemapData.entries.length > 50000) {\n    errors.push(\"Sitemap contains more than 50,000 URLs (Google limit)\");\n  }\n\n  // Check for truncation\n  if (sitemapData.truncated) {\n    warnings.push(\"Sitemap was truncated due to size limits\");\n  }\n\n  // Validate individual entries\n  sitemapData.entries.forEach((entry, index) => {\n    // Validate URL format\n    try {\n      new URL(entry.loc);\n    } catch {\n      errors.push(`Invalid URL at entry ${index + 1}: ${entry.loc}`);\n    }\n\n    // Validate priority range\n    if (\n      entry.priority !== undefined &&\n      (entry.priority < 0 || entry.priority > 1)\n    ) {\n      errors.push(\n        `Invalid priority at entry ${index + 1}: must be between 0.0 and 1.0`,\n      );\n    }\n\n    // Validate lastmod format\n    if (entry.lastmod && !isValidISODate(entry.lastmod)) {\n      errors.push(\n        `Invalid lastmod date at entry ${index + 1}: ${entry.lastmod}`,\n      );\n    }\n\n    // Check URL length (Google limit is 2048 characters)\n    if (entry.loc.length > 2048) {\n      warnings.push(`URL at entry ${index + 1} exceeds 2048 character limit`);\n    }\n  });\n\n  // Check for duplicate URLs\n  const urlCounts = new Map<string, number>();\n  sitemapData.entries.forEach((entry) => {\n    const count = urlCounts.get(entry.loc) ?? 0;\n    urlCounts.set(entry.loc, count + 1);\n  });\n\n  urlCounts.forEach((count, url) => {\n    if (count > 1) {\n      errors.push(`Duplicate URL found: ${url} (appears ${count} times)`);\n    }\n  });\n\n  return {\n    valid: errors.length === 0,\n    errors,\n    warnings,\n  };\n}\n\n/**\n * Gets the latest modification date from an array of articles.\n */\nfunction getLatestModificationDate(\n  articles: readonly PublishedArticle[],\n): string {\n  if (articles.length === 0) {\n    return new Date().toISOString();\n  }\n\n  const latestDate = articles.reduce((latest, article) => {\n    const articleDate = new Date(article.updatedAt);\n    return articleDate > latest ? articleDate : latest;\n  }, new Date(articles[0]!.updatedAt));\n\n  return latestDate.toISOString();\n}\n\n/**\n * Creates a separate sitemap specifically for blog content.\n * Useful for large sites that need to split sitemaps by content type.\n *\n * @param site - The published site information\n * @param articles - Array of published articles\n * @param authors - Array of published authors (optional)\n * @param options - Sitemap generation options\n * @returns Next.js sitemap function\n *\n * @example\n * ```typescript\n * // app/blog-sitemap/route.ts - separate blog sitemap endpoint\n * import { createBlogSitemapRoute } from '@xexr/blog-platform';\n *\n * export const GET = createBlogSitemapRoute(site, articles, authors, {\n *   includeAuthorPages: true,\n *   articlesPerPage: 20\n * });\n * ```\n */\nexport function createBlogSitemapRoute(\n  site: PublishedSite,\n  articles: readonly PublishedArticle[],\n  authors: readonly PublishedAuthor[] = [],\n  options: SitemapOptions = {},\n) {\n  return async function GET() {\n    const entries = await generateBlogSitemapEntries(\n      site,\n      articles,\n      authors,\n      options,\n    );\n\n    // Convert to Next.js sitemap format and return as XML\n    const xmlEntries = entries.map((entry) => ({\n      loc: entry.url,\n      lastmod:\n        typeof entry.lastModified === \"string\"\n          ? entry.lastModified\n          : entry.lastModified?.toISOString(),\n      changefreq: entry.changeFrequency,\n      priority: entry.priority,\n    }));\n\n    const sitemapData = {\n      entries: xmlEntries,\n      totalEntries: xmlEntries.length,\n      truncated: false,\n      generatedAt: new Date().toISOString(),\n      baseUrl: normalizeDomain(\n        options.canonical?.domain ?? site.domain,\n        options.canonical?.forceHttps ?? true,\n      ),\n    };\n\n    const xml = sitemapToXml(sitemapData);\n\n    return new Response(xml, {\n      headers: {\n        \"Content-Type\": \"application/xml\",\n        \"Cache-Control\": \"public, max-age=3600, s-maxage=3600\",\n      },\n    });\n  };\n}\n\n/**\n * Configuration interface for blog data fetching.\n * Used to fetch blog data for sitemap generation.\n */\nexport interface BlogSitemapConfig {\n  /** Static host app routes to include before Bloggy routes */\n  staticRoutes?: readonly NextjsSitemapEntry[];\n\n  /** Function to fetch static host app routes */\n  getStaticRoutes?: () => Promise<readonly NextjsSitemapEntry[]>;\n\n  /** Function to fetch site data */\n  getSite: () => Promise<PublishedSite>;\n\n  /** Function to fetch published articles */\n  getArticles: () => Promise<readonly PublishedArticle[]>;\n\n  /** Function to fetch authors (optional) */\n  getAuthors?: () => Promise<readonly PublishedAuthor[]>;\n\n  /** Sitemap generation options */\n  options?: SitemapOptions;\n}\n\n/**\n * Higher-order function that creates a Next.js sitemap function with data fetching.\n * Ideal for dynamic blog content that needs to be fetched at sitemap generation time.\n *\n * @param config - Configuration for fetching blog data\n * @returns Next.js sitemap function\n *\n * @example\n * ```typescript\n * // app/sitemap.ts\n * import { createDynamicBlogSitemap } from '@xexr/blog-platform';\n * import { getBlogData } from './lib/blog';\n *\n * export default createDynamicBlogSitemap({\n *   getSite: () => getBlogData().site,\n *   getArticles: () => getBlogData().articles,\n *   getAuthors: () => getBlogData().authors,\n *   options: {\n *     includeAuthorPages: true,\n *     changeFrequency: { articles: 'weekly' }\n *   }\n * });\n * ```\n */\nexport function createDynamicBlogSitemap(config: BlogSitemapConfig) {\n  return async function sitemap(): Promise<NextjsSitemapEntry[]> {\n    const staticRoutes = [\n      ...(config.staticRoutes ?? []),\n      ...(config.getStaticRoutes ? await config.getStaticRoutes() : []),\n    ];\n    const site = await config.getSite();\n    const articles = await config.getArticles();\n    const authors = config.getAuthors ? await config.getAuthors() : [];\n\n    return [\n      ...staticRoutes,\n      ...(await generateBlogSitemapEntries(\n        site,\n        articles,\n        authors,\n        config.options,\n      )),\n    ];\n  };\n}\n\n/**\n * Escapes special XML characters for safe inclusion in XML content.\n */\nfunction escapeXml(text: string): string {\n  const xmlEscapes: Record<string, string> = {\n    \"&\": \"&amp;\",\n    \"<\": \"&lt;\",\n    \">\": \"&gt;\",\n    '\"': \"&quot;\",\n    \"'\": \"&#x27;\",\n  };\n\n  return text.replace(/[&<>\"']/g, (char) => xmlEscapes[char] ?? char);\n}\n\n/**\n * Validates if a string is a valid ISO 8601 date.\n */\nfunction isValidISODate(dateString: string): boolean {\n  try {\n    const date = new Date(dateString);\n    const isoString = date.toISOString();\n\n    // Handle both formats: with and without milliseconds\n    // 2023-01-01T00:00:00.000Z and 2023-01-01T00:00:00Z are both valid\n    const normalizedInput =\n      dateString.endsWith(\"Z\") && !dateString.includes(\".\")\n        ? dateString.replace(\"Z\", \".000Z\")\n        : dateString;\n\n    return isoString === normalizedInput && !isNaN(date.getTime());\n  } catch {\n    return false;\n  }\n}\n"]}

package/dist/sitemap.mjs

@@ -0,0 +1,6 @@
+function O(e){let t=new Map;for(let r of e)r.author?.slug&&t.set(r.author.slug,q(t.get(r.author.slug),r.author));return Array.from(t.values()).sort((r,i)=>r.name.localeCompare(i.name))}function q(e,t){return e?{...e,bio:e.bio??t.bio,avatarUrl:e.avatarUrl??t.avatarUrl,pronouns:e.pronouns??t.pronouns,socialLinks:e.socialLinks??t.socialLinks,toneAdjectives:e.toneAdjectives.length>0?e.toneAdjectives:t.toneAdjectives}:t}function x(e,t=true){let r=e.trim();return r=r.replace(/\/+$/,""),/^https?:\/\//.exec(r)||(r=`${t?"https":"http"}://${r}`),t&&r.startsWith("http://")&&(r=r.replace("http://","https://")),r}function F(e){let t=e.trim();if(!t)throw new Error("Slug cannot be empty");if(!/^[a-z0-9-]+$/.test(t))throw new Error("Slug can only contain lowercase letters, numbers, and hyphens");let i=t.replace(/-+/g,"-").replace(/^-+|-+$/g,"");if(!i)throw new Error("Slug cannot consist only of hyphens");return i}function _(e,t={}){let{forceHttps:r=true,removeTrailingSlash:i=true,domain:o=e.site.domain,pathPrefix:n="/blog"}=t;if(!o)throw new Error("Domain is required for canonical URL generation");if(!e.slug)throw new Error("Article slug is required for canonical URL generation");let l=x(o,r),u=F(e.slug),c=n.replace(/^(?!\/)/,"/").replace(/\/+$/,""),a=`${l}${c}/${u}`;return i&&(a=a.replace(/\/+$/,"")),a}function T(e){let t=new Map;for(let r of e)for(let i of r.topics??[])t.has(i.slug)||t.set(i.slug,i);return Array.from(t.values()).sort((r,i)=>r.name.localeCompare(i.name))}function L(e="/blog"){let t=e.trim();return !t||t==="/"?"":t.replace(/^(?!\/)/,"/").replace(/\/+$/,"")}function b(e,t){let r=L(e),i=t?.replace(/^\/+/,"").replace(/\/+$/,"");return i?`${r}/${i}`.replace(/\/+/g,"/"):r||"/"}function v(e,t){return b(e,`authors/${t}`)}async function U(e,t,r=[],i={}){let{includeAuthorPages:o=true,includeTopicPages:n=true,includePaginationPages:l=true,articlesPerPage:u=10,maxEntries:c=5e4,changeFrequency:a={},priority:g={}}=i,s=[],m=x(i.canonical?.domain??e.domain,i.canonical?.forceHttps??true),f=i.canonical?.pathPrefix??"/blog",R=r.length>0?r:O(t),y=T([...t]);if(s.push({url:`${m}${f}`,lastModified:P(t),changeFrequency:a.homePage??"daily",priority:g.homePage??1}),t.forEach(p=>{if(s.length>=c)return;let d=_(p,i.canonical);s.push({url:d,lastModified:p.updatedAt,changeFrequency:a.articles??"monthly",priority:g.articles??.8});}),n&&y.length>0&&(s.length<c&&s.push({url:`${m}${b(f,"topics")}`,lastModified:P(t),changeFrequency:a.topicPages??"weekly",priority:g.topicPages??.6}),y.forEach(p=>{if(s.length>=c)return;let d=t.filter(S=>(S.topics??[]).some(h=>h.slug===p.slug));s.push({url:`${m}${b(f,`topics/${p.slug}`)}`,lastModified:P(d),changeFrequency:a.topicPages??"weekly",priority:g.topicPages??.6});})),o&&R.length>0&&(s.length<c&&s.push({url:`${m}${b(f,"authors")}`,lastModified:P(t),changeFrequency:a.authorPages??"weekly",priority:g.authorPages??.6}),R.forEach(p=>{if(s.length>=c)return;let d=`${m}${v(f,p.slug)}`,S=t.filter(A=>A.author?.id===p.id),h=P(S);s.push({url:d,lastModified:h,changeFrequency:a.authorPages??"weekly",priority:g.authorPages??.6});})),l&&t.length>u){let p=Math.ceil(t.length/u);for(let d=2;d<=p&&!(s.length>=c);d++)s.push({url:`${m}${f}?page=${d}`,lastModified:P(t),changeFrequency:a.paginationPages??"daily",priority:g.paginationPages??.5});}return s}function X(e,t,r=[],i={}){let{includeAuthorPages:o=true,includeTopicPages:n=true,includePaginationPages:l=true,articlesPerPage:u=10,maxEntries:c=5e4,changeFrequency:a={},priority:g={}}=i,s=[],m=x(i.canonical?.domain??e.domain,i.canonical?.forceHttps??true),f=i.canonical?.pathPrefix??"/blog",R=new Date().toISOString(),y=r.length>0?r:O(t),p=T([...t]),d=1;if(d+=t.length,n&&p.length>0&&(d+=p.length+1),o&&(d+=y.length>0?y.length+1:0),l&&t.length>u){let h=Math.ceil(t.length/u);d+=h-1;}let S=d>c;if(s.push({loc:`${m}${f}`,lastmod:P(t),changefreq:a.homePage??"daily",priority:g.homePage??1}),t.forEach(h=>{if(s.length>=c)return;let A=_(h,i.canonical);s.push({loc:A,lastmod:h.updatedAt,changefreq:a.articles??"monthly",priority:g.articles??.8});}),n&&p.length>0&&(s.length<c&&s.push({loc:`${m}${b(f,"topics")}`,lastmod:P(t),changefreq:a.topicPages??"weekly",priority:g.topicPages??.6}),p.forEach(h=>{if(s.length>=c)return;let A=t.filter($=>($.topics??[]).some(E=>E.slug===h.slug));s.push({loc:`${m}${b(f,`topics/${h.slug}`)}`,lastmod:P(A),changefreq:a.topicPages??"weekly",priority:g.topicPages??.6});})),o&&y.length>0&&(s.length<c&&s.push({loc:`${m}${b(f,"authors")}`,lastmod:P(t),changefreq:a.authorPages??"weekly",priority:g.authorPages??.6}),y.forEach(h=>{if(s.length>=c)return;let A=`${m}${v(f,h.slug)}`,$=t.filter(B=>B.author?.id===h.id),E=P($);s.push({loc:A,lastmod:E,changefreq:a.authorPages??"weekly",priority:g.authorPages??.6});})),l&&t.length>u){let h=Math.ceil(t.length/u);for(let A=2;A<=h&&!(s.length>=c);A++)s.push({loc:`${m}${f}?page=${A}`,lastmod:P(t),changefreq:a.paginationPages??"daily",priority:g.paginationPages??.5});}return {entries:s,totalEntries:s.length,truncated:S,generatedAt:R,baseUrl:m}}function C(e){let t='<?xml version="1.0" encoding="UTF-8"?>',r='<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',i="</urlset>",o=e.entries.map(n=>{let l=[];return l.push("  <url>"),l.push(`    <loc>${w(n.loc)}</loc>`),n.lastmod&&l.push(`    <lastmod>${w(n.lastmod)}</lastmod>`),n.changefreq&&l.push(`    <changefreq>${w(n.changefreq)}</changefreq>`),n.priority!==void 0&&l.push(`    <priority>${n.priority.toFixed(1)}</priority>`),l.push("  </url>"),l.join(`
+`)});return [t,r,...o,i].join(`
+`)}function J(e,t){let r='<?xml version="1.0" encoding="UTF-8"?>',i='<sitemapindex xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">',o="</sitemapindex>",n=e.map(l=>{let u=[];return u.push("  <sitemap>"),u.push(`    <loc>${w(l.url)}</loc>`),l.lastmod&&u.push(`    <lastmod>${w(l.lastmod)}</lastmod>`),u.push("  </sitemap>"),u.join(`
+`)});return [r,i,...n,o].join(`
+`)}function Q(e){let t=[],r=[];e.entries.length===0?t.push("Sitemap must contain at least one URL"):e.entries.length>5e4&&t.push("Sitemap contains more than 50,000 URLs (Google limit)"),e.truncated&&r.push("Sitemap was truncated due to size limits"),e.entries.forEach((o,n)=>{try{new URL(o.loc);}catch{t.push(`Invalid URL at entry ${n+1}: ${o.loc}`);}o.priority!==void 0&&(o.priority<0||o.priority>1)&&t.push(`Invalid priority at entry ${n+1}: must be between 0.0 and 1.0`),o.lastmod&&!M(o.lastmod)&&t.push(`Invalid lastmod date at entry ${n+1}: ${o.lastmod}`),o.loc.length>2048&&r.push(`URL at entry ${n+1} exceeds 2048 character limit`);});let i=new Map;return e.entries.forEach(o=>{let n=i.get(o.loc)??0;i.set(o.loc,n+1);}),i.forEach((o,n)=>{o>1&&t.push(`Duplicate URL found: ${n} (appears ${o} times)`);}),{valid:t.length===0,errors:t,warnings:r}}function P(e){return e.length===0?new Date().toISOString():e.reduce((r,i)=>{let o=new Date(i.updatedAt);return o>r?o:r},new Date(e[0].updatedAt)).toISOString()}function Y(e,t,r=[],i={}){return async function(){let l=(await U(e,t,r,i)).map(a=>({loc:a.url,lastmod:typeof a.lastModified=="string"?a.lastModified:a.lastModified?.toISOString(),changefreq:a.changeFrequency,priority:a.priority})),u={entries:l,totalEntries:l.length,generatedAt:new Date().toISOString(),baseUrl:x(i.canonical?.domain??e.domain,i.canonical?.forceHttps??true)},c=C(u);return new Response(c,{headers:{"Content-Type":"application/xml","Cache-Control":"public, max-age=3600, s-maxage=3600"}})}}function K(e){return async function(){let r=[...e.staticRoutes??[],...e.getStaticRoutes?await e.getStaticRoutes():[]],i=await e.getSite(),o=await e.getArticles(),n=e.getAuthors?await e.getAuthors():[];return [...r,...await U(i,o,n,e.options)]}}function w(e){let t={"&":"&amp;","<":"&lt;",">":"&gt;",'"':"&quot;","'":"&#x27;"};return e.replace(/[&<>"']/g,r=>t[r]??r)}function M(e){try{let t=new Date(e),r=t.toISOString(),i=e.endsWith("Z")&&!e.includes(".")?e.replace("Z",".000Z"):e;return r===i&&!isNaN(t.getTime())}catch{return  false}}export{Y as createBlogSitemapRoute,K as createDynamicBlogSitemap,U as generateBlogSitemapEntries,X as generateSitemap,J as generateSitemapIndex,C as sitemapToXml,Q as validateSitemap};//# sourceMappingURL=sitemap.mjs.map
+//# sourceMappingURL=sitemap.mjs.map