@xexr/blog-platform 1.1.4 → 1.1.7

package/dist/components/TopicArchivePages.test.ts

@@ -2,10 +2,8 @@ import React from "react";
 import { renderToStaticMarkup } from "react-dom/server";
 import { describe, expect, it } from "vitest";
 
-import {
-  BlogTopicArchivePage,
-  BlogTopicsIndexPage,
-} from "./TopicArchivePages";
+import { BlogTopicArchivePage, BlogTopicsIndexPage } from "./TopicArchivePages";
+import { BlogSeriesArchivePage } from "./SeriesArchivePages";
 import type { PublishedArticle, PublishedSite } from "../types/contracts";
 
 const site: PublishedSite = {
@@ -99,3 +97,53 @@ describe("Blog topic archive pages", () => {
     expect(html).not.toContain("h-full w-full object-contain");
   });
 });
+
+function schemas(html: string): unknown[] {
+  return [
+    ...html.matchAll(/<script type="application\/ld\+json">(.*?)<\/script>/g),
+  ].flatMap((match): unknown[] => JSON.parse(match[1]!) as unknown[]);
+}
+
+it("renders topic archive collection and breadcrumbs for the listed articles", () => {
+  const data = schemas(
+    renderToStaticMarkup(
+      React.createElement(BlogTopicArchivePage, {
+        articles: [article],
+        topicSlug: "recurring-work-and-routines",
+        basePath: "/new-blog",
+      }),
+    ),
+  );
+  expect(JSON.stringify(data)).toContain(
+    "https://example.com/new-blog/useful-routines",
+  );
+  expect(JSON.stringify(data)).toContain("CollectionPage");
+  expect(JSON.stringify(data)).toContain("BreadcrumbList");
+});
+
+it("renders series archive collection and breadcrumbs for the listed articles", () => {
+  const seriesArticle = {
+    ...article,
+    series: {
+      id: "s",
+      title: "Routines",
+      slug: "routines",
+      position: 1,
+      total: 1,
+      articles: [],
+    },
+  };
+  const data = schemas(
+    renderToStaticMarkup(
+      React.createElement(BlogSeriesArchivePage, {
+        articles: [seriesArticle],
+        seriesSlug: "routines",
+      }),
+    ),
+  );
+  expect(JSON.stringify(data)).toContain(
+    "https://example.com/blog/useful-routines",
+  );
+  expect(JSON.stringify(data)).toContain("CollectionPage");
+  expect(JSON.stringify(data)).toContain("BreadcrumbList");
+});

package/dist/components/TopicArchivePages.tsx

@@ -1,4 +1,5 @@
 import React from "react";
+import { ArchiveStructuredData } from "./ArchiveStructuredData";
 import Link from "next/link.js";
 import Image from "next/image.js";
 import { formatDistanceToNow } from "date-fns";
@@ -52,7 +53,7 @@ export function BlogTopicsIndexPage({
       <header className="mb-10 space-y-3 text-center">
         <Link
           href={normalizedBasePath}
-          className="text-muted-foreground hover:text-[var(--blog-accent)] text-sm font-medium transition-colors"
+          className="text-muted-foreground text-sm font-medium transition-colors hover:text-[var(--blog-accent)]"
         >
           Back to all articles
         </Link>
@@ -88,7 +89,7 @@ export function BlogTopicsIndexPage({
                 href={buildBlogPath(normalizedBasePath, `topics/${topic.slug}`)}
                 className="group rounded-2xl border border-[var(--blog-accent-border)] bg-[var(--blog-card-bg)] p-5 transition hover:border-[var(--blog-accent)] hover:no-underline"
               >
-                <h2 className="group-hover:text-[var(--blog-accent)] text-xl font-semibold transition-colors">
+                <h2 className="text-xl font-semibold transition-colors group-hover:text-[var(--blog-accent)]">
                   {topic.name}
                 </h2>
                 {topic.description && (
@@ -126,10 +127,19 @@ export function BlogTopicArchivePage({
         className,
       )}
     >
+      {archive && (
+        <ArchiveStructuredData
+          articles={archive.articles}
+          title={archive.topic.name}
+          kind="topics"
+          slug={topicSlug}
+          basePath={normalizedBasePath}
+        />
+      )}
       <header className="mb-10 space-y-3 text-center">
         <Link
           href={buildBlogPath(normalizedBasePath, "topics")}
-          className="text-muted-foreground hover:text-[var(--blog-accent)] text-sm font-medium transition-colors"
+          className="text-muted-foreground text-sm font-medium transition-colors hover:text-[var(--blog-accent)]"
         >
           Back to all topics
         </Link>
@@ -202,7 +212,7 @@ function TopicArticleCard({
         <span className="inline-flex rounded-full border border-[var(--blog-accent-border)] px-2.5 py-1 text-xs font-medium text-[var(--blog-text-accent)]">
           {topic.name}
         </span>
-        <h2 className="group-hover:text-[var(--blog-accent)] text-xl font-semibold text-balance transition-colors">
+        <h2 className="text-xl font-semibold text-balance transition-colors group-hover:text-[var(--blog-accent)]">
           {article.title}
         </h2>
         {article.excerpt && (

package/dist/{index-Dr8HaKGm.d.mts → index-DsXjuPn4.d.mts}

@@ -44,6 +44,8 @@ interface PublishedAuthor {
     readonly pronouns?: string;
     /** Whether this is a guest author */
     readonly isGuest: boolean;
+    /** Areas of subject expertise. */
+    readonly expertise?: readonly string[];
     /** Tone adjectives that describe this author's writing style */
     readonly toneAdjectives: readonly string[];
 }
@@ -122,6 +124,46 @@ interface PublishedTopic {
     /** Whether this is the article's primary topic */
     readonly isPrimary: boolean;
 }
+/**
+ * Compact link metadata for an article within a published series.
+ */
+interface PublishedSeriesArticleLink {
+    /** Unique article identifier */
+    readonly id: string;
+    /** URL-friendly article slug */
+    readonly slug: string;
+    /** Display title */
+    readonly title: string;
+    /** Ordered position within the series */
+    readonly position: number;
+    /** Whether this entry is the current article */
+    readonly isCurrent: boolean;
+    /** Optional excerpt for archive/list rendering */
+    readonly excerpt?: string;
+}
+/**
+ * Reader-facing series context for a published article.
+ */
+interface PublishedSeriesContext {
+    /** Unique series identifier */
+    readonly id: string;
+    /** Display title */
+    readonly title: string;
+    /** URL-friendly series slug */
+    readonly slug: string;
+    /** Optional public description */
+    readonly description?: string;
+    /** Current article position in the series */
+    readonly position: number;
+    /** Number of visible articles in the series context */
+    readonly total: number;
+    /** Previous published article in the series, when available */
+    readonly previous?: PublishedSeriesArticleLink;
+    /** Next published article in the series, when available */
+    readonly next?: PublishedSeriesArticleLink;
+    /** Ordered article list for compact navigation and archive pages */
+    readonly articles: readonly PublishedSeriesArticleLink[];
+}
 /**
  * Represents a published article with all necessary metadata for rendering
  * on external blog platforms.
@@ -153,6 +195,8 @@ interface PublishedArticle {
     readonly cta?: PublishedArticleCta;
     /** Public topic taxonomy assigned to the article */
     readonly topics?: readonly PublishedTopic[];
+    /** Optional ordered series context for article navigation */
+    readonly series?: PublishedSeriesContext;
     /** Featured image URL (optional) */
     readonly featuredImage?: string;
     /** Alt text for featured image */
@@ -226,4 +270,4 @@ interface PublishResult {
     readonly idempotencyKey: string;
 }
 
-export type { PublishedTopic as P, PublishedArticle as a, PublishedSite as b, PublishedAuthor as c, PublishedNewsletterSettings as d, PublishedArticleCta as e, PublishResult as f, PublishPayload as g, PublishedAuthorSocialLinks as h };
+export type { PublishedTopic as P, PublishedArticle as a, PublishedSite as b, PublishedAuthor as c, PublishedNewsletterSettings as d, PublishedArticleCta as e, PublishResult as f, PublishedSeriesContext as g, PublishPayload as h, PublishedAuthorSocialLinks as i };

package/dist/{index-Dr8HaKGm.d.ts → index-DsXjuPn4.d.ts}

@@ -44,6 +44,8 @@ interface PublishedAuthor {
     readonly pronouns?: string;
     /** Whether this is a guest author */
     readonly isGuest: boolean;
+    /** Areas of subject expertise. */
+    readonly expertise?: readonly string[];
     /** Tone adjectives that describe this author's writing style */
     readonly toneAdjectives: readonly string[];
 }
@@ -122,6 +124,46 @@ interface PublishedTopic {
     /** Whether this is the article's primary topic */
     readonly isPrimary: boolean;
 }
+/**
+ * Compact link metadata for an article within a published series.
+ */
+interface PublishedSeriesArticleLink {
+    /** Unique article identifier */
+    readonly id: string;
+    /** URL-friendly article slug */
+    readonly slug: string;
+    /** Display title */
+    readonly title: string;
+    /** Ordered position within the series */
+    readonly position: number;
+    /** Whether this entry is the current article */
+    readonly isCurrent: boolean;
+    /** Optional excerpt for archive/list rendering */
+    readonly excerpt?: string;
+}
+/**
+ * Reader-facing series context for a published article.
+ */
+interface PublishedSeriesContext {
+    /** Unique series identifier */
+    readonly id: string;
+    /** Display title */
+    readonly title: string;
+    /** URL-friendly series slug */
+    readonly slug: string;
+    /** Optional public description */
+    readonly description?: string;
+    /** Current article position in the series */
+    readonly position: number;
+    /** Number of visible articles in the series context */
+    readonly total: number;
+    /** Previous published article in the series, when available */
+    readonly previous?: PublishedSeriesArticleLink;
+    /** Next published article in the series, when available */
+    readonly next?: PublishedSeriesArticleLink;
+    /** Ordered article list for compact navigation and archive pages */
+    readonly articles: readonly PublishedSeriesArticleLink[];
+}
 /**
  * Represents a published article with all necessary metadata for rendering
  * on external blog platforms.
@@ -153,6 +195,8 @@ interface PublishedArticle {
     readonly cta?: PublishedArticleCta;
     /** Public topic taxonomy assigned to the article */
     readonly topics?: readonly PublishedTopic[];
+    /** Optional ordered series context for article navigation */
+    readonly series?: PublishedSeriesContext;
     /** Featured image URL (optional) */
     readonly featuredImage?: string;
     /** Alt text for featured image */
@@ -226,4 +270,4 @@ interface PublishResult {
     readonly idempotencyKey: string;
 }
 
-export type { PublishedTopic as P, PublishedArticle as a, PublishedSite as b, PublishedAuthor as c, PublishedNewsletterSettings as d, PublishedArticleCta as e, PublishResult as f, PublishPayload as g, PublishedAuthorSocialLinks as h };
+export type { PublishedTopic as P, PublishedArticle as a, PublishedSite as b, PublishedAuthor as c, PublishedNewsletterSettings as d, PublishedArticleCta as e, PublishResult as f, PublishedSeriesContext as g, PublishPayload as h, PublishedAuthorSocialLinks as i };

package/dist/index.d.mts

@@ -1,5 +1,5 @@
-import { a as PublishedArticle, b as PublishedSite, d as PublishedNewsletterSettings, e as PublishedArticleCta, c as PublishedAuthor, f as PublishResult, P as PublishedTopic } from './index-Dr8HaKGm.mjs';
-export { g as PublishPayload, h as PublishedAuthorSocialLinks } from './index-Dr8HaKGm.mjs';
+import { a as PublishedArticle, b as PublishedSite, d as PublishedNewsletterSettings, e as PublishedArticleCta, c as PublishedAuthor, f as PublishResult, P as PublishedTopic, g as PublishedSeriesContext } from './index-DsXjuPn4.mjs';
+export { h as PublishPayload, i as PublishedAuthorSocialLinks } from './index-DsXjuPn4.mjs';
 import * as React from 'react';
 import { CSSProperties, ReactElement } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -10,8 +10,8 @@ export { RelatedArticleCandidate, RelatedFeaturedArticlesOptions, getRelatedFeat
 import { NextRequest, NextResponse } from 'next/server.js';
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
 import { LibSQLDatabase } from 'drizzle-orm/libsql';
-import { C as CanonicalUrlOptions } from './sitemap-Dbl4CUGI.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, f as generateCanonicalUrl, h as generateCanonicalUrlFromSlug, i as generateSitemap, j as generateSitemapIndex, k as getBaseUrl, l as isValidCanonicalUrl, n as normalizeDomain, m as normalizeSlug, s as sitemapToXml, u as updateArticleCanonicalUrl, v as validateSitemap } from './sitemap-Dbl4CUGI.mjs';
+import { C as CanonicalUrlOptions } from './sitemap-Dy7Q4ATM.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, f as generateCanonicalUrl, h as generateCanonicalUrlFromSlug, i as generateSitemap, j as generateSitemapIndex, k as getBaseUrl, l as isValidCanonicalUrl, n as normalizeDomain, m as normalizeSlug, s as sitemapToXml, u as updateArticleCanonicalUrl, v as validateSitemap } from './sitemap-Dy7Q4ATM.mjs';
 
 interface BlogTheme {
     accentColor?: string;
@@ -159,6 +159,52 @@ declare function generateArticleMetadata(
   };
 };
 
+interface BlogSeriesPageProps {
+  articles: PublishedArticle[];
+  basePath?: string;
+  title?: string;
+  description?: string;
+  className?: string;
+  theme?: BlogTheme;
+}
+
+declare function BlogSeriesPage(
+  props: BlogSeriesPageProps,
+): ReactElement;
+
+declare function generateSeriesIndexMetadata(basePath?: string): {
+  title: string;
+  description: string;
+  alternates: {
+    canonical: string;
+  };
+};
+
+interface BlogSeriesArchiveRoutePageProps {
+  articles: PublishedArticle[];
+  seriesSlug: string;
+  basePath?: string;
+  className?: string;
+  theme?: BlogTheme;
+}
+
+declare function BlogSeriesArchiveRoutePage(
+  props: BlogSeriesArchiveRoutePageProps,
+): ReactElement;
+
+declare function generateSeriesArchiveMetadata(options: {
+  title: string;
+  description?: string;
+  slug: string;
+  basePath?: string;
+}): {
+  title: string;
+  description: string;
+  alternates: {
+    canonical: string;
+  };
+};
+
 interface AuthorPageProps {
     author: PublishedAuthor;
     articles: PublishedArticle[];
@@ -297,6 +343,7 @@ declare function cn(...inputs: ClassValue[]): string;
 declare function normalizeBlogBasePath(basePath?: string): string;
 declare function buildBlogPath(basePath: string | undefined, slug?: string): string;
 declare function buildAuthorPath(basePath: string | undefined, authorSlug: string): string;
+declare function buildSeriesPath(basePath: string | undefined, seriesSlug: string): string;
 declare function getPathPrefixFromBlogUrl(blogUrl: string): string;
 
 /**
@@ -397,6 +444,14 @@ declare function getArticlePrimaryTopic(article: PublishedArticle): PublishedTop
 declare function getAllTopics(articles: PublishedArticle[]): PublishedTopic[];
 declare function getTopicArchive(articles: PublishedArticle[], topicSlug: string): TopicArchive | null;
 
+interface SeriesArchive {
+    series: PublishedSeriesContext;
+    articles: PublishedArticle[];
+}
+declare function getAllSeries(articles: PublishedArticle[]): PublishedSeriesContext[];
+declare function getSeriesArchive(articles: PublishedArticle[], seriesSlug: string): SeriesArchive | null;
+declare function getArticleSeriesNavigation(article: PublishedArticle): PublishedSeriesContext | null;
+
 interface BlogTopicsIndexPageProps {
     articles: PublishedArticle[];
     basePath?: string;
@@ -415,6 +470,31 @@ interface BlogTopicArchivePageProps {
 declare function BlogTopicsIndexPage({ articles, basePath, title, description, className, theme, }: BlogTopicsIndexPageProps): react_jsx_runtime.JSX.Element;
 declare function BlogTopicArchivePage({ articles, topicSlug, basePath, className, theme, }: BlogTopicArchivePageProps): react_jsx_runtime.JSX.Element;
 
+interface BlogSeriesIndexPageProps {
+    articles: PublishedArticle[];
+    basePath?: string;
+    title?: string;
+    description?: string;
+    className?: string;
+    theme?: BlogTheme;
+}
+interface BlogSeriesArchivePageProps {
+    articles: PublishedArticle[];
+    seriesSlug: string;
+    basePath?: string;
+    className?: string;
+    theme?: BlogTheme;
+}
+declare function BlogSeriesIndexPage({ articles, basePath, title, description, className, theme, }: BlogSeriesIndexPageProps): react_jsx_runtime.JSX.Element;
+declare function BlogSeriesArchivePage({ articles, seriesSlug, basePath, className, theme, }: BlogSeriesArchivePageProps): react_jsx_runtime.JSX.Element;
+
+interface SeriesNavigationProps {
+    article: PublishedArticle;
+    basePath?: string;
+    className?: string;
+}
+declare function SeriesNavigation({ article, basePath, className, }: SeriesNavigationProps): react_jsx_runtime.JSX.Element | null;
+
 interface BlogAuthorsIndexPageProps {
     articles: PublishedArticle[];
     basePath?: string;
@@ -2203,4 +2283,5 @@ declare function OPTIONS(request: NextRequest): Promise<NextResponse>;
 
 declare const PACKAGE_VERSION: string;
 
-export { ApiKeyAuth, type AuthConfig, type AuthResult, type AuthorArchive, type AuthorArchiveOptions, BLOG_PLATFORM_SCHEMA_VERSION, BLOG_PLATFORM_TABLE_NAMES, ArticlePage as BlogArticlePage, AuthorPage as BlogAuthorPage, BlogAuthorsIndexPage, BlogHomePage, type BlogPlatformConfig, type BlogPlatformSchemaCheckResult, BlogPlatformSchemaError, type BlogPlatformStorage, type BlogPlatformTableName, type BlogPostingSchema, type BlogTheme, BlogTopicArchivePage, BlogTopicsIndexPage, type BreadcrumbListSchema, Button, CanonicalUrlOptions, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DrizzleStorage, EnvAuth, type GeneratedMetadata, InMemoryStorage, type LinkTag, type MetaTag, type MetadataOptions, NEWSLETTER_SUCCESS_MESSAGE, NewsletterSignup, type NewsletterSignupProps, NoAuth, type OrganizationSchema, PACKAGE_VERSION, Pagination$1 as Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, type PersonSchema, PublishResult, PublishedArticle, PublishedAuthor, PublishedNewsletterSettings, PublishedSite, PublishedTopic, type RateLimitConfig, type RateLimitResult, Pagination as ShadcnPagination, StructuredDataError, type StructuredDataOptions, type TopicArchive, UninitializedAuth, type WebSiteSchema, autoConfigureRateLimit, blogPlatformDrizzleSchema, bpArticles, bpMetadata, bpOperations, buildAuthorPath, buildBlogPath, buttonVariants, checkDrizzleAdapterSchema, checkRateLimit, cn, POST as configHandler, OPTIONS$1 as configOptionsHandler, configureRateLimit, createRateLimitErrorResponse, createStructuredDataScript, createTokenFingerprint, enforceRateLimit, ensureDrizzleAdapterSchema, extractKeywordsFromArticle, extractTableOfContents, extractTokenFromHeader, formatArticleDateMeta, generateArticleMetadata, generateArticleStructuredData, generateAuthorPageMetadata, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBreadcrumbStructuredData, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSiteMetadata, generateWebSiteStructuredData, getAllTopics, getArticlePrimaryTopic, getAuthConfig, getAuthorArchive, getAuthorsFromArticles, getBlogThemeStyle, getDrizzleAdapterSql, getPathPrefixFromBlogUrl, getRateLimitHeaders, getStorage, getTopicArchive, GET$1 as indexNowKeyRoute, initBlogPlatform, initBlogPlatformDev, initBlogPlatformOnce, initBlogPlatformProd, initEnvAuth, loadAuthorArchive, metadataToHtml, normalizeBlogBasePath, POST$2 as publishHandler, safeGenerateArticleStructuredData, setAuthConfig, setStorage, shouldSkipAuth, GET as slugExistsHandler, OPTIONS as slugExistsOptionsHandler, structuredDataToJsonLd, POST$1 as unpublishHandler, usePagination, validateMetadata, validateStructuredData, GET$2 as versionHandler };
+export { ApiKeyAuth, BLOG_PLATFORM_SCHEMA_VERSION, BLOG_PLATFORM_TABLE_NAMES, ArticlePage as BlogArticlePage, AuthorPage as BlogAuthorPage, BlogAuthorsIndexPage, BlogHomePage, BlogPlatformSchemaError, BlogSeriesArchivePage, BlogSeriesArchiveRoutePage, BlogSeriesIndexPage, BlogSeriesPage, BlogTopicArchivePage, BlogTopicsIndexPage, Button, CanonicalUrlOptions, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DrizzleStorage, EnvAuth, InMemoryStorage, NEWSLETTER_SUCCESS_MESSAGE, NewsletterSignup, NoAuth, PACKAGE_VERSION, Pagination$1 as Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PublishResult, PublishedArticle, PublishedAuthor, PublishedNewsletterSettings, PublishedSite, PublishedTopic, SeriesNavigation, Pagination as ShadcnPagination, StructuredDataError, UninitializedAuth, autoConfigureRateLimit, blogPlatformDrizzleSchema, bpArticles, bpMetadata, bpOperations, buildAuthorPath, buildBlogPath, buildSeriesPath, buttonVariants, checkDrizzleAdapterSchema, checkRateLimit, cn, POST as configHandler, OPTIONS$1 as configOptionsHandler, configureRateLimit, createRateLimitErrorResponse, createStructuredDataScript, createTokenFingerprint, enforceRateLimit, ensureDrizzleAdapterSchema, extractKeywordsFromArticle, extractTableOfContents, extractTokenFromHeader, formatArticleDateMeta, generateArticleMetadata, generateArticleStructuredData, generateAuthorPageMetadata, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBreadcrumbStructuredData, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSeriesArchiveMetadata, generateSeriesIndexMetadata, generateSiteMetadata, generateWebSiteStructuredData, getAllSeries, getAllTopics, getArticlePrimaryTopic, getArticleSeriesNavigation, getAuthConfig, getAuthorArchive, getAuthorsFromArticles, getBlogThemeStyle, getDrizzleAdapterSql, getPathPrefixFromBlogUrl, getRateLimitHeaders, getSeriesArchive, getStorage, getTopicArchive, GET$1 as indexNowKeyRoute, initBlogPlatform, initBlogPlatformDev, initBlogPlatformOnce, initBlogPlatformProd, initEnvAuth, loadAuthorArchive, metadataToHtml, normalizeBlogBasePath, POST$2 as publishHandler, safeGenerateArticleStructuredData, setAuthConfig, setStorage, shouldSkipAuth, GET as slugExistsHandler, OPTIONS as slugExistsOptionsHandler, structuredDataToJsonLd, POST$1 as unpublishHandler, usePagination, validateMetadata, validateStructuredData, GET$2 as versionHandler };
+export type { AuthConfig, AuthResult, AuthorArchive, AuthorArchiveOptions, BlogPlatformConfig, BlogPlatformSchemaCheckResult, BlogPlatformStorage, BlogPlatformTableName, BlogPostingSchema, BlogTheme, BreadcrumbListSchema, GeneratedMetadata, LinkTag, MetaTag, MetadataOptions, NewsletterSignupProps, OrganizationSchema, PersonSchema, RateLimitConfig, RateLimitResult, SeriesArchive, StructuredDataOptions, TopicArchive, WebSiteSchema };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { a as PublishedArticle, b as PublishedSite, d as PublishedNewsletterSettings, e as PublishedArticleCta, c as PublishedAuthor, f as PublishResult, P as PublishedTopic } from './index-Dr8HaKGm.js';
-export { g as PublishPayload, h as PublishedAuthorSocialLinks } from './index-Dr8HaKGm.js';
+import { a as PublishedArticle, b as PublishedSite, d as PublishedNewsletterSettings, e as PublishedArticleCta, c as PublishedAuthor, f as PublishResult, P as PublishedTopic, g as PublishedSeriesContext } from './index-DsXjuPn4.js';
+export { h as PublishPayload, i as PublishedAuthorSocialLinks } from './index-DsXjuPn4.js';
 import * as React from 'react';
 import { CSSProperties, ReactElement } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
@@ -10,8 +10,8 @@ export { RelatedArticleCandidate, RelatedFeaturedArticlesOptions, getRelatedFeat
 import { NextRequest, NextResponse } from 'next/server.js';
 import * as drizzle_orm_sqlite_core from 'drizzle-orm/sqlite-core';
 import { LibSQLDatabase } from 'drizzle-orm/libsql';
-import { C as CanonicalUrlOptions } from './sitemap-BmCh8BpN.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, f as generateCanonicalUrl, h as generateCanonicalUrlFromSlug, i as generateSitemap, j as generateSitemapIndex, k as getBaseUrl, l as isValidCanonicalUrl, n as normalizeDomain, m as normalizeSlug, s as sitemapToXml, u as updateArticleCanonicalUrl, v as validateSitemap } from './sitemap-BmCh8BpN.js';
+import { C as CanonicalUrlOptions } from './sitemap-B64QGT4l.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, f as generateCanonicalUrl, h as generateCanonicalUrlFromSlug, i as generateSitemap, j as generateSitemapIndex, k as getBaseUrl, l as isValidCanonicalUrl, n as normalizeDomain, m as normalizeSlug, s as sitemapToXml, u as updateArticleCanonicalUrl, v as validateSitemap } from './sitemap-B64QGT4l.js';
 
 interface BlogTheme {
     accentColor?: string;
@@ -159,6 +159,52 @@ declare function generateArticleMetadata(
   };
 };
 
+interface BlogSeriesPageProps {
+  articles: PublishedArticle[];
+  basePath?: string;
+  title?: string;
+  description?: string;
+  className?: string;
+  theme?: BlogTheme;
+}
+
+declare function BlogSeriesPage(
+  props: BlogSeriesPageProps,
+): ReactElement;
+
+declare function generateSeriesIndexMetadata(basePath?: string): {
+  title: string;
+  description: string;
+  alternates: {
+    canonical: string;
+  };
+};
+
+interface BlogSeriesArchiveRoutePageProps {
+  articles: PublishedArticle[];
+  seriesSlug: string;
+  basePath?: string;
+  className?: string;
+  theme?: BlogTheme;
+}
+
+declare function BlogSeriesArchiveRoutePage(
+  props: BlogSeriesArchiveRoutePageProps,
+): ReactElement;
+
+declare function generateSeriesArchiveMetadata(options: {
+  title: string;
+  description?: string;
+  slug: string;
+  basePath?: string;
+}): {
+  title: string;
+  description: string;
+  alternates: {
+    canonical: string;
+  };
+};
+
 interface AuthorPageProps {
     author: PublishedAuthor;
     articles: PublishedArticle[];
@@ -297,6 +343,7 @@ declare function cn(...inputs: ClassValue[]): string;
 declare function normalizeBlogBasePath(basePath?: string): string;
 declare function buildBlogPath(basePath: string | undefined, slug?: string): string;
 declare function buildAuthorPath(basePath: string | undefined, authorSlug: string): string;
+declare function buildSeriesPath(basePath: string | undefined, seriesSlug: string): string;
 declare function getPathPrefixFromBlogUrl(blogUrl: string): string;
 
 /**
@@ -397,6 +444,14 @@ declare function getArticlePrimaryTopic(article: PublishedArticle): PublishedTop
 declare function getAllTopics(articles: PublishedArticle[]): PublishedTopic[];
 declare function getTopicArchive(articles: PublishedArticle[], topicSlug: string): TopicArchive | null;
 
+interface SeriesArchive {
+    series: PublishedSeriesContext;
+    articles: PublishedArticle[];
+}
+declare function getAllSeries(articles: PublishedArticle[]): PublishedSeriesContext[];
+declare function getSeriesArchive(articles: PublishedArticle[], seriesSlug: string): SeriesArchive | null;
+declare function getArticleSeriesNavigation(article: PublishedArticle): PublishedSeriesContext | null;
+
 interface BlogTopicsIndexPageProps {
     articles: PublishedArticle[];
     basePath?: string;
@@ -415,6 +470,31 @@ interface BlogTopicArchivePageProps {
 declare function BlogTopicsIndexPage({ articles, basePath, title, description, className, theme, }: BlogTopicsIndexPageProps): react_jsx_runtime.JSX.Element;
 declare function BlogTopicArchivePage({ articles, topicSlug, basePath, className, theme, }: BlogTopicArchivePageProps): react_jsx_runtime.JSX.Element;
 
+interface BlogSeriesIndexPageProps {
+    articles: PublishedArticle[];
+    basePath?: string;
+    title?: string;
+    description?: string;
+    className?: string;
+    theme?: BlogTheme;
+}
+interface BlogSeriesArchivePageProps {
+    articles: PublishedArticle[];
+    seriesSlug: string;
+    basePath?: string;
+    className?: string;
+    theme?: BlogTheme;
+}
+declare function BlogSeriesIndexPage({ articles, basePath, title, description, className, theme, }: BlogSeriesIndexPageProps): react_jsx_runtime.JSX.Element;
+declare function BlogSeriesArchivePage({ articles, seriesSlug, basePath, className, theme, }: BlogSeriesArchivePageProps): react_jsx_runtime.JSX.Element;
+
+interface SeriesNavigationProps {
+    article: PublishedArticle;
+    basePath?: string;
+    className?: string;
+}
+declare function SeriesNavigation({ article, basePath, className, }: SeriesNavigationProps): react_jsx_runtime.JSX.Element | null;
+
 interface BlogAuthorsIndexPageProps {
     articles: PublishedArticle[];
     basePath?: string;
@@ -2203,4 +2283,5 @@ declare function OPTIONS(request: NextRequest): Promise<NextResponse>;
 
 declare const PACKAGE_VERSION: string;
 
-export { ApiKeyAuth, type AuthConfig, type AuthResult, type AuthorArchive, type AuthorArchiveOptions, BLOG_PLATFORM_SCHEMA_VERSION, BLOG_PLATFORM_TABLE_NAMES, ArticlePage as BlogArticlePage, AuthorPage as BlogAuthorPage, BlogAuthorsIndexPage, BlogHomePage, type BlogPlatformConfig, type BlogPlatformSchemaCheckResult, BlogPlatformSchemaError, type BlogPlatformStorage, type BlogPlatformTableName, type BlogPostingSchema, type BlogTheme, BlogTopicArchivePage, BlogTopicsIndexPage, type BreadcrumbListSchema, Button, CanonicalUrlOptions, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DrizzleStorage, EnvAuth, type GeneratedMetadata, InMemoryStorage, type LinkTag, type MetaTag, type MetadataOptions, NEWSLETTER_SUCCESS_MESSAGE, NewsletterSignup, type NewsletterSignupProps, NoAuth, type OrganizationSchema, PACKAGE_VERSION, Pagination$1 as Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, type PersonSchema, PublishResult, PublishedArticle, PublishedAuthor, PublishedNewsletterSettings, PublishedSite, PublishedTopic, type RateLimitConfig, type RateLimitResult, Pagination as ShadcnPagination, StructuredDataError, type StructuredDataOptions, type TopicArchive, UninitializedAuth, type WebSiteSchema, autoConfigureRateLimit, blogPlatformDrizzleSchema, bpArticles, bpMetadata, bpOperations, buildAuthorPath, buildBlogPath, buttonVariants, checkDrizzleAdapterSchema, checkRateLimit, cn, POST as configHandler, OPTIONS$1 as configOptionsHandler, configureRateLimit, createRateLimitErrorResponse, createStructuredDataScript, createTokenFingerprint, enforceRateLimit, ensureDrizzleAdapterSchema, extractKeywordsFromArticle, extractTableOfContents, extractTokenFromHeader, formatArticleDateMeta, generateArticleMetadata, generateArticleStructuredData, generateAuthorPageMetadata, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBreadcrumbStructuredData, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSiteMetadata, generateWebSiteStructuredData, getAllTopics, getArticlePrimaryTopic, getAuthConfig, getAuthorArchive, getAuthorsFromArticles, getBlogThemeStyle, getDrizzleAdapterSql, getPathPrefixFromBlogUrl, getRateLimitHeaders, getStorage, getTopicArchive, GET$1 as indexNowKeyRoute, initBlogPlatform, initBlogPlatformDev, initBlogPlatformOnce, initBlogPlatformProd, initEnvAuth, loadAuthorArchive, metadataToHtml, normalizeBlogBasePath, POST$2 as publishHandler, safeGenerateArticleStructuredData, setAuthConfig, setStorage, shouldSkipAuth, GET as slugExistsHandler, OPTIONS as slugExistsOptionsHandler, structuredDataToJsonLd, POST$1 as unpublishHandler, usePagination, validateMetadata, validateStructuredData, GET$2 as versionHandler };
+export { ApiKeyAuth, BLOG_PLATFORM_SCHEMA_VERSION, BLOG_PLATFORM_TABLE_NAMES, ArticlePage as BlogArticlePage, AuthorPage as BlogAuthorPage, BlogAuthorsIndexPage, BlogHomePage, BlogPlatformSchemaError, BlogSeriesArchivePage, BlogSeriesArchiveRoutePage, BlogSeriesIndexPage, BlogSeriesPage, BlogTopicArchivePage, BlogTopicsIndexPage, Button, CanonicalUrlOptions, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DrizzleStorage, EnvAuth, InMemoryStorage, NEWSLETTER_SUCCESS_MESSAGE, NewsletterSignup, NoAuth, PACKAGE_VERSION, Pagination$1 as Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, PublishResult, PublishedArticle, PublishedAuthor, PublishedNewsletterSettings, PublishedSite, PublishedTopic, SeriesNavigation, Pagination as ShadcnPagination, StructuredDataError, UninitializedAuth, autoConfigureRateLimit, blogPlatformDrizzleSchema, bpArticles, bpMetadata, bpOperations, buildAuthorPath, buildBlogPath, buildSeriesPath, buttonVariants, checkDrizzleAdapterSchema, checkRateLimit, cn, POST as configHandler, OPTIONS$1 as configOptionsHandler, configureRateLimit, createRateLimitErrorResponse, createStructuredDataScript, createTokenFingerprint, enforceRateLimit, ensureDrizzleAdapterSchema, extractKeywordsFromArticle, extractTableOfContents, extractTokenFromHeader, formatArticleDateMeta, generateArticleMetadata, generateArticleStructuredData, generateAuthorPageMetadata, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBreadcrumbStructuredData, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSeriesArchiveMetadata, generateSeriesIndexMetadata, generateSiteMetadata, generateWebSiteStructuredData, getAllSeries, getAllTopics, getArticlePrimaryTopic, getArticleSeriesNavigation, getAuthConfig, getAuthorArchive, getAuthorsFromArticles, getBlogThemeStyle, getDrizzleAdapterSql, getPathPrefixFromBlogUrl, getRateLimitHeaders, getSeriesArchive, getStorage, getTopicArchive, GET$1 as indexNowKeyRoute, initBlogPlatform, initBlogPlatformDev, initBlogPlatformOnce, initBlogPlatformProd, initEnvAuth, loadAuthorArchive, metadataToHtml, normalizeBlogBasePath, POST$2 as publishHandler, safeGenerateArticleStructuredData, setAuthConfig, setStorage, shouldSkipAuth, GET as slugExistsHandler, OPTIONS as slugExistsOptionsHandler, structuredDataToJsonLd, POST$1 as unpublishHandler, usePagination, validateMetadata, validateStructuredData, GET$2 as versionHandler };
+export type { AuthConfig, AuthResult, AuthorArchive, AuthorArchiveOptions, BlogPlatformConfig, BlogPlatformSchemaCheckResult, BlogPlatformStorage, BlogPlatformTableName, BlogPostingSchema, BlogTheme, BreadcrumbListSchema, GeneratedMetadata, LinkTag, MetaTag, MetadataOptions, NewsletterSignupProps, OrganizationSchema, PersonSchema, RateLimitConfig, RateLimitResult, SeriesArchive, StructuredDataOptions, TopicArchive, WebSiteSchema };