@xexr/blog-platform 1.1.5 → 1.2.0

package/dist/lib/related-articles.d.mts

@@ -1,4 +1,4 @@
-import { P as PublishedTopic, a as PublishedArticle } from '../index-CKWrb9a4.mjs';
+import { PublishedTopic, PublishedArticle } from '../index.mjs';
 
 interface RelatedArticleCandidate {
     readonly id: string;
@@ -14,4 +14,5 @@ interface RelatedFeaturedArticlesOptions {
 declare function getRelatedFeaturedArticles<TArticle extends RelatedArticleCandidate>(currentArticle: RelatedArticleCandidate, articles: readonly TArticle[], options?: RelatedFeaturedArticlesOptions): TArticle[];
 type RelatedPublishedArticle = PublishedArticle;
 
-export { type RelatedArticleCandidate, type RelatedFeaturedArticlesOptions, type RelatedPublishedArticle, getRelatedFeaturedArticles };
+export { getRelatedFeaturedArticles };
+export type { RelatedArticleCandidate, RelatedFeaturedArticlesOptions, RelatedPublishedArticle };

package/dist/lib/related-articles.d.ts

@@ -1,4 +1,4 @@
-import { P as PublishedTopic, a as PublishedArticle } from '../index-CKWrb9a4.js';
+import { PublishedTopic, PublishedArticle } from '../index.js';
 
 interface RelatedArticleCandidate {
     readonly id: string;
@@ -14,4 +14,5 @@ interface RelatedFeaturedArticlesOptions {
 declare function getRelatedFeaturedArticles<TArticle extends RelatedArticleCandidate>(currentArticle: RelatedArticleCandidate, articles: readonly TArticle[], options?: RelatedFeaturedArticlesOptions): TArticle[];
 type RelatedPublishedArticle = PublishedArticle;
 
-export { type RelatedArticleCandidate, type RelatedFeaturedArticlesOptions, type RelatedPublishedArticle, getRelatedFeaturedArticles };
+export { getRelatedFeaturedArticles };
+export type { RelatedArticleCandidate, RelatedFeaturedArticlesOptions, RelatedPublishedArticle };

package/dist/lib/sitemap.ts

@@ -56,10 +56,10 @@ export interface SitemapOptions {
   /** Whether to include series pages in sitemap */
   includeSeriesPages?: boolean;
 
-  /** Whether to include pagination pages in sitemap */
+  /** @deprecated Pagination pages are never included. */
   includePaginationPages?: boolean;
 
-  /** Number of articles per page for pagination calculation */
+  /** @deprecated Pagination pages are never included. */
   articlesPerPage?: number;
 
   /** Maximum number of sitemap entries (defaults to 50,000 per Google guidelines) */
@@ -213,8 +213,6 @@ export async function generateBlogSitemapEntries(
     includeAuthorPages = true,
     includeTopicPages = true,
     includeSeriesPages = true,
-    includePaginationPages = true,
-    articlesPerPage = 10,
     maxEntries = 50000,
     changeFrequency = {},
     priority = {},
@@ -338,22 +336,6 @@ export async function generateBlogSitemapEntries(
     });
   }
 
-  // Add pagination pages if enabled
-  if (includePaginationPages && articles.length > articlesPerPage) {
-    const totalPages = Math.ceil(articles.length / articlesPerPage);
-
-    for (let page = 2; page <= totalPages; page++) {
-      if (entries.length >= maxEntries) break;
-
-      entries.push({
-        url: `${baseUrl}${pathPrefix}?page=${page}`,
-        lastModified: getLatestModificationDate(articles),
-        changeFrequency: changeFrequency.paginationPages ?? "daily",
-        priority: priority.paginationPages ?? 0.5,
-      });
-    }
-  }
-
   return entries;
 }
 
@@ -377,8 +359,6 @@ export function generateSitemap(
     includeAuthorPages = true,
     includeTopicPages = true,
     includeSeriesPages = true,
-    includePaginationPages = true,
-    articlesPerPage = 10,
     maxEntries = 50000,
     changeFrequency = {},
     priority = {},
@@ -410,10 +390,6 @@ export function generateSitemap(
     potentialEntries +=
       sitemapAuthors.length > 0 ? sitemapAuthors.length + 1 : 0; // Authors index + author pages
   }
-  if (includePaginationPages && articles.length > articlesPerPage) {
-    const totalPages = Math.ceil(articles.length / articlesPerPage);
-    potentialEntries += totalPages - 1; // Pagination pages (excluding page 1 which is home)
-  }
 
   const willTruncate = potentialEntries > maxEntries;
 
@@ -523,22 +499,6 @@ export function generateSitemap(
     });
   }
 
-  // Add pagination pages if enabled
-  if (includePaginationPages && articles.length > articlesPerPage) {
-    const totalPages = Math.ceil(articles.length / articlesPerPage);
-
-    for (let page = 2; page <= totalPages; page++) {
-      if (entries.length >= maxEntries) break;
-
-      entries.push({
-        loc: `${baseUrl}${pathPrefix}?page=${page}`,
-        lastmod: getLatestModificationDate(articles),
-        changefreq: changeFrequency.paginationPages ?? "daily",
-        priority: priority.paginationPages ?? 0.5,
-      });
-    }
-  }
-
   return {
     entries,
     totalEntries: entries.length,

package/dist/lib/storage/drizzle.ts

@@ -100,6 +100,7 @@ function toRow(article: PublishedArticle): ArticleRow {
       __bloggyTopics: article.topics ?? [],
       __bloggySeries: article.series ?? null,
       __bloggyCta: article.cta ?? null,
+      ...(article.video && { __bloggyVideo: article.video }),
     }),
     version: article.version,
   };
@@ -128,6 +129,7 @@ function fromRow(row: ArticleRow): PublishedArticle {
     cta: extractCta(row.metaJson),
     topics: extractTopics(row.metaJson),
     series: extractSeries(row.metaJson),
+    ...withVideo(row.metaJson),
     meta: extractMeta(row.metaJson),
     version: row.version,
   };
@@ -137,6 +139,7 @@ type StoredArticleMeta = PublishedArticle["meta"] & {
   __bloggyTopics?: PublishedArticle["topics"];
   __bloggySeries?: PublishedArticle["series"] | null;
   __bloggyCta?: PublishedArticle["cta"] | null;
+  __bloggyVideo?: PublishedArticle["video"];
 };
 
 function parseStoredMeta(metaJson: string): StoredArticleMeta {
@@ -158,8 +161,14 @@ function extractSeries(metaJson: string): PublishedArticle["series"] {
   return parsed.__bloggySeries ?? undefined;
 }
 
+function withVideo(metaJson: string): Pick<PublishedArticle, "video"> {
+  const video = parseStoredMeta(metaJson).__bloggyVideo;
+  return video ? { video } : {};
+}
+
 function extractMeta(metaJson: string): PublishedArticle["meta"] {
   const parsed = parseStoredMeta(metaJson);
+  delete parsed.__bloggyVideo;
   delete parsed.__bloggyTopics;
   delete parsed.__bloggySeries;
   delete parsed.__bloggyCta;

package/dist/lib/structured-data.ts

@@ -15,6 +15,11 @@ import type {
   PublishedSite,
 } from "../types/contracts";
 import { buildAuthorPath } from "./urls";
+import {
+  buildYouTubeStructuredDataEmbedUrl,
+  buildYouTubeThumbnailUrl,
+  isYouTubeVideoId,
+} from "./video";
 
 /**
  * Base schema.org context and type
@@ -95,6 +100,21 @@ export interface BlogPostingSchema extends BaseStructuredData {
     "@type": "Thing";
     name: string;
   }[];
+  video?: VideoObjectSchema;
+}
+
+/**
+ * VideoObject schema for an article's embedded video
+ * @see https://schema.org/VideoObject
+ */
+export interface VideoObjectSchema {
+  "@type": "VideoObject";
+  name: string;
+  description: string;
+  thumbnailUrl: string[];
+  uploadDate: string;
+  duration?: string;
+  embedUrl: string;
 }
 
 /**
@@ -205,6 +225,11 @@ export function generateArticleStructuredData(
     isAccessibleForFree,
   };
 
+  const videoSchema = generateVideoStructuredData(article);
+  if (videoSchema) {
+    schema.video = videoSchema;
+  }
+
   // Add optional properties if enabled
   if (includeOptionalProperties) {
     // Featured image
@@ -222,23 +247,50 @@ export function generateArticleStructuredData(
       schema.inLanguage = language ?? article.site.locale;
     }
 
-    // Extract topics from tone adjectives or keywords for 'about' property
-    if (article.site.toneAdjectives.length > 0) {
-      schema.about = article.site.toneAdjectives.map((topic) => ({
+    const subjects = [
+      ...(article.topics ?? []).map((topic) => topic.name),
+      ...(article.series ? [article.series.title] : []),
+    ];
+    if (subjects.length) {
+      schema.about = [...new Set(subjects)].map((name) => ({
         "@type": "Thing" as const,
-        name: topic,
+        name,
       }));
     }
 
-    // Genre based on site description or tone
-    if (article.site.toneAdjectives.length > 0) {
-      schema.genre = [...article.site.toneAdjectives];
-    }
+
   }
 
   return schema;
 }
 
+/**
+ * Generate the VideoObject for an article's video, if it has a valid one
+ */
+export function generateVideoStructuredData(
+  article: PublishedArticle,
+): VideoObjectSchema | undefined {
+  const video = article.video;
+  if (!video || !isYouTubeVideoId(video.id)) {
+    return undefined;
+  }
+
+  const description = video.description?.trim() ?? "";
+
+  return {
+    "@type": "VideoObject",
+    name: video.title,
+    description: description.length > 0 ? description : article.excerpt,
+    thumbnailUrl: [
+      buildYouTubeThumbnailUrl(video.id),
+      ...(article.featuredImage ? [article.featuredImage] : []),
+    ],
+    uploadDate: video.uploadDate,
+    ...(video.duration && { duration: video.duration }),
+    embedUrl: buildYouTubeStructuredDataEmbedUrl(video.id),
+  };
+}
+
 /**
  * Generate structured data for an author
  */
@@ -288,9 +340,8 @@ export function generateAuthorStructuredData(
     schema.additionalType = "GuestAuthor";
   }
 
-  // Add knowledge areas from tone adjectives
-  if (author.toneAdjectives && author.toneAdjectives.length > 0) {
-    schema.knowsAbout = [...author.toneAdjectives];
+  if (author.expertise?.length) {
+    schema.knowsAbout = [...author.expertise];
   }
 
   return schema;

package/dist/lib/video.ts

@@ -0,0 +1,163 @@
+/**
+ * Helpers for article videos (YouTube only).
+ *
+ * Every URL built here goes through `isYouTubeVideoId` first, so a stored id
+ * can never inject markup or a different host into an embed.
+ */
+
+const YOUTUBE_VIDEO_ID_PATTERN = /^[A-Za-z0-9_-]{11}$/;
+const ISO_DURATION_PATTERN = /^PT(?=\d)(?:\d+H)?(?:\d+M)?(?:\d+(?:\.\d+)?S)?$/;
+const ISO_DATE_PREFIX_PATTERN = /^\d{4}-\d{2}-\d{2}(?:$|T)/;
+const YOUTUBE_HOSTS = new Set([
+  "youtube.com",
+  "www.youtube.com",
+  "m.youtube.com",
+  "music.youtube.com",
+  "youtube-nocookie.com",
+  "www.youtube-nocookie.com",
+  "youtu.be",
+]);
+const YOUTUBE_PATH_PREFIXES = ["embed", "shorts", "live", "v"];
+
+export const ARTICLE_VIDEO_TITLE_MAX_LENGTH = 200;
+export const ARTICLE_VIDEO_DESCRIPTION_MAX_LENGTH = 5000;
+
+export function isYouTubeVideoId(value: unknown): value is string {
+  return typeof value === "string" && YOUTUBE_VIDEO_ID_PATTERN.test(value);
+}
+
+export function isIsoDuration(value: unknown): value is string {
+  return (
+    typeof value === "string" &&
+    value !== "PT" &&
+    ISO_DURATION_PATTERN.test(value)
+  );
+}
+
+/** ISO 8601 date or date-time whose calendar date exists (no 31 February). */
+function isIsoDate(value: unknown): value is string {
+  if (typeof value !== "string" || !ISO_DATE_PREFIX_PATTERN.test(value)) {
+    return false;
+  }
+  const datePart = value.slice(0, 10);
+  const parsed = new Date(`${datePart}T00:00:00Z`);
+  return (
+    !Number.isNaN(parsed.getTime()) &&
+    parsed.toISOString().slice(0, 10) === datePart &&
+    !Number.isNaN(Date.parse(value))
+  );
+}
+
+/**
+ * Extract a YouTube video id from a bare id or a YouTube URL
+ * (watch, youtu.be, embed, nocookie embed, shorts, live).
+ */
+export function parseYouTubeVideoId(input: string): string | null {
+  const trimmed = input.trim();
+  if (YOUTUBE_VIDEO_ID_PATTERN.test(trimmed)) return trimmed;
+  if (!trimmed) return null;
+
+  let url: URL;
+  try {
+    url = new URL(
+      /^https?:\/\//i.test(trimmed) ? trimmed : `https://${trimmed}`,
+    );
+  } catch {
+    return null;
+  }
+
+  const host = url.hostname.toLowerCase();
+  if (!YOUTUBE_HOSTS.has(host)) return null;
+
+  const segments = url.pathname.split("/").filter(Boolean);
+  let candidate: string | null | undefined;
+  if (host === "youtu.be") {
+    candidate = segments[0];
+  } else if (segments[0] === "watch") {
+    candidate = url.searchParams.get("v");
+  } else if (segments[0] && YOUTUBE_PATH_PREFIXES.includes(segments[0])) {
+    candidate = segments[1];
+  }
+
+  return isYouTubeVideoId(candidate) ? candidate : null;
+}
+
+/**
+ * Validate an untrusted `video` value from a publish payload.
+ * Returns a list of human-readable errors; empty when valid.
+ */
+export function validatePublishedArticleVideo(value: unknown): string[] {
+  if (!value || typeof value !== "object" || Array.isArray(value)) {
+    return ["Article video must be an object"];
+  }
+
+  const video = value as Record<string, unknown>;
+  const errors: string[] = [];
+
+  if (video.provider !== "youtube") {
+    errors.push('Article video provider must be "youtube"');
+  }
+  if (!isYouTubeVideoId(video.id)) {
+    errors.push("Article video id must be an 11-character YouTube id");
+  }
+  if (typeof video.title !== "string" || !video.title.trim()) {
+    errors.push("Article video title is required");
+  } else if (video.title.length > ARTICLE_VIDEO_TITLE_MAX_LENGTH) {
+    errors.push(
+      `Article video title must be ${ARTICLE_VIDEO_TITLE_MAX_LENGTH} characters or fewer`,
+    );
+  }
+  if (!isIsoDate(video.uploadDate)) {
+    errors.push("Article video uploadDate must be an ISO 8601 date");
+  }
+  if (video.duration !== undefined && !isIsoDuration(video.duration)) {
+    errors.push(
+      "Article video duration must be an ISO 8601 duration such as PT4M13S",
+    );
+  }
+  if (video.verticalId !== undefined && !isYouTubeVideoId(video.verticalId)) {
+    errors.push("Article video verticalId must be an 11-character YouTube id");
+  }
+  if (video.description !== undefined) {
+    if (typeof video.description !== "string") {
+      errors.push("Article video description must be a string");
+    } else if (
+      video.description.length > ARTICLE_VIDEO_DESCRIPTION_MAX_LENGTH
+    ) {
+      errors.push(
+        `Article video description must be ${ARTICLE_VIDEO_DESCRIPTION_MAX_LENGTH} characters or fewer`,
+      );
+    }
+  }
+
+  return errors;
+}
+
+function assertYouTubeVideoId(id: string): void {
+  if (!isYouTubeVideoId(id)) {
+    throw new Error("Invalid YouTube video id");
+  }
+}
+
+/** Privacy-enhanced player URL, loaded only after the reader presses play. */
+export function buildYouTubeEmbedUrl(id: string): string {
+  assertYouTubeVideoId(id);
+  return `https://www.youtube-nocookie.com/embed/${id}?rel=0&autoplay=1`;
+}
+
+/** Canonical player URL for structured data. */
+export function buildYouTubeStructuredDataEmbedUrl(id: string): string {
+  assertYouTubeVideoId(id);
+  return `https://www.youtube.com/embed/${id}`;
+}
+
+export function buildYouTubeWatchUrl(id: string): string {
+  assertYouTubeVideoId(id);
+  return `https://www.youtube.com/watch?v=${id}`;
+}
+
+/** Thumbnail URL for structured data only; the page never requests it. */
+export function buildYouTubeThumbnailUrl(id: string): string {
+  assertYouTubeVideoId(id);
+  return `https://i.ytimg.com/vi/${id}/hqdefault.jpg`;
+}

package/dist/{sitemap-BDT3d496.d.ts → sitemap-CEjqxRaQ.d.ts}

@@ -1,4 +1,4 @@
-import { a as PublishedArticle, b as PublishedSite, c as PublishedAuthor } from './index-CKWrb9a4.js';
+import { a as PublishedArticle, b as PublishedSite, c as PublishedAuthor } from './index-CmjKzrH-.js';
 
 /**
  * SEO utilities for canonical URL generation and validation.
@@ -173,9 +173,9 @@ interface SitemapOptions {
     includeTopicPages?: boolean;
     /** Whether to include series pages in sitemap */
     includeSeriesPages?: boolean;
-    /** Whether to include pagination pages in sitemap */
+    /** @deprecated Pagination pages are never included. */
     includePaginationPages?: boolean;
-    /** Number of articles per page for pagination calculation */
+    /** @deprecated Pagination pages are never included. */
     articlesPerPage?: number;
     /** Maximum number of sitemap entries (defaults to 50,000 per Google guidelines) */
     maxEntries?: number;
@@ -425,4 +425,5 @@ interface BlogSitemapConfig {
  */
 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 };
+export { 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 };
+export type { BlogSitemapConfig as B, CanonicalUrlOptions as C, NextjsSitemapEntry as N, SitemapChangeFreq as S, SitemapData as a, SitemapEntry as b, SitemapOptions as c };

package/dist/{sitemap-D3rS0iAF.d.mts → sitemap-D1eInRA1.d.mts}

@@ -1,4 +1,4 @@
-import { a as PublishedArticle, b as PublishedSite, c as PublishedAuthor } from './index-CKWrb9a4.mjs';
+import { a as PublishedArticle, b as PublishedSite, c as PublishedAuthor } from './index-CmjKzrH-.mjs';
 
 /**
  * SEO utilities for canonical URL generation and validation.
@@ -173,9 +173,9 @@ interface SitemapOptions {
     includeTopicPages?: boolean;
     /** Whether to include series pages in sitemap */
     includeSeriesPages?: boolean;
-    /** Whether to include pagination pages in sitemap */
+    /** @deprecated Pagination pages are never included. */
     includePaginationPages?: boolean;
-    /** Number of articles per page for pagination calculation */
+    /** @deprecated Pagination pages are never included. */
     articlesPerPage?: number;
     /** Maximum number of sitemap entries (defaults to 50,000 per Google guidelines) */
     maxEntries?: number;
@@ -425,4 +425,5 @@ interface BlogSitemapConfig {
  */
 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 };
+export { 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 };
+export type { BlogSitemapConfig as B, CanonicalUrlOptions as C, NextjsSitemapEntry as N, SitemapChangeFreq as S, SitemapData as a, SitemapEntry as b, SitemapOptions as c };

package/dist/sitemap.d.mts

@@ -1,2 +1,2 @@
-import './index-CKWrb9a4.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-D3rS0iAF.mjs';
+import './index-CmjKzrH-.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-D1eInRA1.mjs';

package/dist/sitemap.d.ts

@@ -1,2 +1,2 @@
-import './index-CKWrb9a4.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-BDT3d496.js';
+import './index-CmjKzrH-.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-CEjqxRaQ.js';

package/dist/sitemap.js

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