@xexr/blog-platform 1.0.1 → 1.0.2

package/dist/app/blog/[slug]/page.tsx

@@ -18,6 +18,8 @@ import {
   generateCompleteArticleStructuredData,
   createStructuredDataScript,
 } from "../../../lib/structured-data";
+import { articleMdxOptions } from "../../../lib/mdx";
+import { buildBlogPath, normalizeBlogBasePath } from "../../../lib/urls";
 
 interface ArticlePageProps {
   article: PublishedArticle;
@@ -37,6 +39,8 @@ interface ArticlePageProps {
       title: string;
     };
   };
+  /** Public path where this blog is mounted, e.g. "/blog" or "/new-blog". */
+  basePath?: string;
 }
 
 /**
@@ -58,7 +62,9 @@ export default function ArticlePage({
   article,
   className,
   navigation,
+  basePath = "/blog",
 }: ArticlePageProps) {
+  const normalizedBasePath = normalizeBlogBasePath(basePath) || "/";
   const publishedDate = new Date(article.publishedAt);
   const updatedDate = new Date(article.updatedAt);
   const isUpdated = updatedDate.getTime() !== publishedDate.getTime();
@@ -173,7 +179,7 @@ export default function ArticlePage({
       {/* Article Content */}
       <div className="article-content">
         <div className="prose prose-sm sm:prose-base lg:prose-lg xl:prose-xl prose-gray dark:prose-invert prose-headings:scroll-mt-20 prose-headings:font-light prose-h1:text-2xl sm:prose-h1:text-3xl lg:prose-h1:text-4xl prose-h2:text-xl sm:prose-h2:text-2xl lg:prose-h2:text-3xl prose-h3:text-lg sm:prose-h3:text-xl lg:prose-h3:text-2xl prose-p:leading-relaxed prose-img:mx-auto prose-img:rounded-lg prose-a:transition-colors max-w-none">
-          <MDXRemote source={article.content} />
+          <MDXRemote source={article.content} options={articleMdxOptions} />
         </div>
       </div>
 
@@ -247,7 +253,9 @@ export default function ArticlePage({
       {/* JSON-LD Structured Data */}
       {(() => {
         const structuredDataProps = createStructuredDataScript(
-          generateCompleteArticleStructuredData(article),
+          generateCompleteArticleStructuredData(article, {
+            pathPrefix: normalizedBasePath,
+          }),
         );
         return (
           <script
@@ -266,11 +274,15 @@ export default function ArticlePage({
  * Generate metadata for the article page for SEO optimization.
  * This function should be used in the Next.js metadata API.
  */
-export function generateArticleMetadata(article: PublishedArticle) {
+export function generateArticleMetadata(
+  article: PublishedArticle,
+  basePath = "/blog",
+) {
   const title = article.meta.title ?? article.title;
   const description = article.meta.description ?? article.excerpt;
   const canonicalUrl =
-    article.meta.canonicalUrl ?? `${article.site.domain}/blog/${article.slug}`;
+    article.meta.canonicalUrl ??
+    `${article.site.domain}${buildBlogPath(basePath, article.slug)}`;
   const ogImage = article.meta.ogImage ?? article.featuredImage;
 
   return {

package/dist/app/blog/page.tsx

@@ -11,6 +11,7 @@ import {
   generateBlogHomeStructuredData,
   createStructuredDataScript,
 } from "../../lib/structured-data";
+import { buildBlogPath, normalizeBlogBasePath } from "../../lib/urls";
 import { formatDistanceToNow } from "date-fns";
 
 interface BlogHomePageProps {
@@ -22,6 +23,8 @@ interface BlogHomePageProps {
   site?: PublishedSite;
   /** Whether to include structured data */
   includeStructuredData?: boolean;
+  /** Public path where this blog is mounted, e.g. "/blog" or "/new-blog". */
+  basePath?: string;
   /** Pagination configuration */
   pagination?: {
     currentPage: number;
@@ -44,8 +47,11 @@ export default function BlogHomePage({
   className,
   site,
   includeStructuredData = false,
+  basePath = "/blog",
   pagination,
 }: BlogHomePageProps) {
+  const normalizedBasePath = normalizeBlogBasePath(basePath) || "/";
+
   return (
     <div
       className={cn(
@@ -81,7 +87,11 @@ export default function BlogHomePage({
         ) : (
           <div className="space-y-0">
             {articles.map((article) => (
-              <ArticlePreview key={article.id} article={article} />
+              <ArticlePreview
+                key={article.id}
+                article={article}
+                basePath={normalizedBasePath}
+              />
             ))}
           </div>
         )}
@@ -92,7 +102,7 @@ export default function BlogHomePage({
             <Pagination
               currentPage={pagination.currentPage}
               totalPages={pagination.totalPages}
-              baseUrl={pagination.baseUrl ?? "/blog"}
+              baseUrl={pagination.baseUrl ?? normalizedBasePath}
               className="justify-center"
             />
           </div>
@@ -104,7 +114,9 @@ export default function BlogHomePage({
         site &&
         (() => {
           const structuredDataProps = createStructuredDataScript(
-            generateBlogHomeStructuredData(site, articles.slice(0, 5)),
+            generateBlogHomeStructuredData(site, articles.slice(0, 5), {
+              pathPrefix: normalizedBasePath,
+            }),
           );
           return (
             <script
@@ -130,8 +142,14 @@ function formatReadingTime(seconds: number): string {
 /**
  * Individual article preview component for the blog listing.
  */
-function ArticlePreview({ article }: { article: PublishedArticle }) {
-  const articleUrl = `/blog/${article.slug}`;
+function ArticlePreview({
+  article,
+  basePath,
+}: {
+  article: PublishedArticle;
+  basePath: string;
+}) {
+  const articleUrl = buildBlogPath(basePath, article.slug);
   const formattedDate = formatDistanceToNow(new Date(article.publishedAt), {
     addSuffix: true,
   });
@@ -169,7 +187,7 @@ function ArticlePreview({ article }: { article: PublishedArticle }) {
               {article.title}
             </h2>
 
-            <div className="flex flex-wrap items-center gap-x-3 gap-y-1 text-sm text-muted-foreground">
+            <div className="text-muted-foreground flex flex-wrap items-center gap-x-3 gap-y-1 text-sm">
               {article.author && (
                 <>
                   <span className="font-medium">{article.author.name}</span>
@@ -225,7 +243,7 @@ function ArticlePreview({ article }: { article: PublishedArticle }) {
               )}
             </div>
 
-            <div className="flex flex-wrap items-center gap-x-3 gap-y-1 text-sm text-muted-foreground">
+            <div className="text-muted-foreground flex flex-wrap items-center gap-x-3 gap-y-1 text-sm">
               {article.author && (
                 <>
                   <span className="font-medium">{article.author.name}</span>
@@ -261,6 +279,7 @@ export function generateBlogHomeMetadata(
     currentPage: number;
     totalPages: number;
   },
+  basePath = "/blog",
 ) {
   const baseTitle = siteName ? `${siteName} - Blog` : "Blog";
   const title =
@@ -272,7 +291,7 @@ export function generateBlogHomeMetadata(
     siteDescription ?? "Read our latest articles and insights.";
 
   // Generate pagination URLs for SEO
-  const baseUrl = "/blog";
+  const baseUrl = normalizeBlogBasePath(basePath) || "/";
   const canonicalUrl = siteUrl
     ? `${siteUrl}${pagination && pagination.currentPage > 1 ? `${baseUrl}?page=${pagination.currentPage}` : baseUrl}`
     : undefined;

package/dist/index.d.mts

@@ -18,6 +18,8 @@ interface BlogHomePageProps {
     site?: PublishedSite;
     /** Whether to include structured data */
     includeStructuredData?: boolean;
+    /** Public path where this blog is mounted, e.g. "/blog" or "/new-blog". */
+    basePath?: string;
     /** Pagination configuration */
     pagination?: {
         currentPage: number;
@@ -32,7 +34,7 @@ interface BlogHomePageProps {
  * @xexr/blog-platform package. It provides a clean, SEO-friendly
  * article listing with proper metadata.
  */
-declare function BlogHomePage({ articles, siteName, siteTagline, className, site, includeStructuredData, pagination, }: BlogHomePageProps): react_jsx_runtime.JSX.Element;
+declare function BlogHomePage({ articles, siteName, siteTagline, className, site, includeStructuredData, basePath, pagination, }: BlogHomePageProps): react_jsx_runtime.JSX.Element;
 /**
  * Generate metadata for the blog home page for SEO optimization.
  * This function should be used in the Next.js metadata API.
@@ -40,7 +42,7 @@ declare function BlogHomePage({ articles, siteName, siteTagline, className, site
 declare function generateBlogHomeMetadata(siteName?: string, siteDescription?: string, siteUrl?: string, pagination?: {
     currentPage: number;
     totalPages: number;
-}): {
+}, basePath?: string): {
     title: string;
     description: string;
     openGraph: {
@@ -81,13 +83,15 @@ interface ArticlePageProps {
             title: string;
         };
     };
+    /** Public path where this blog is mounted, e.g. "/blog" or "/new-blog". */
+    basePath?: string;
 }
-declare function ArticlePage({ article, className, navigation, }: ArticlePageProps): react_jsx_runtime.JSX.Element;
+declare function ArticlePage({ article, className, navigation, basePath, }: ArticlePageProps): react_jsx_runtime.JSX.Element;
 /**
  * Generate metadata for the article page for SEO optimization.
  * This function should be used in the Next.js metadata API.
  */
-declare function generateArticleMetadata(article: PublishedArticle): {
+declare function generateArticleMetadata(article: PublishedArticle, basePath?: string): {
     title: string;
     description: string;
     keywords: string;
@@ -202,6 +206,13 @@ declare function PaginationEllipsis({ className, ...props }: React.ComponentProp
 
 declare function cn(...inputs: ClassValue[]): string;
 
+/**
+ * URL helpers shared by package UI, metadata, and sitemap integrations.
+ */
+declare function normalizeBlogBasePath(basePath?: string): string;
+declare function buildBlogPath(basePath: string | undefined, slug?: string): string;
+declare function getPathPrefixFromBlogUrl(blogUrl: string): string;
+
 /**
  * Authentication configuration interface
  * Customers can implement this to customize authentication behavior
@@ -1796,4 +1807,4 @@ declare function OPTIONS(request: NextRequest): Promise<NextResponse>;
 
 declare const PACKAGE_VERSION: string;
 
-export { ApiKeyAuth, type AuthConfig, type AuthResult, ArticlePage as BlogArticlePage, BlogHomePage, type BlogPlatformConfig, type BlogPlatformStorage, type BlogPostingSchema, type BlogSitemapConfig, type BreadcrumbListSchema, Button, type CanonicalUrlOptions, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DrizzleStorage, EnvAuth, type GeneratedMetadata, InMemoryStorage, type LinkTag, type MetaTag, type MetadataOptions, type NextjsSitemapEntry, NoAuth, type OrganizationSchema, PACKAGE_VERSION, Pagination$1 as Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, type PersonSchema, PublishResult, PublishedArticle, PublishedAuthor, PublishedSite, type RateLimitConfig, type RateLimitResult, Pagination as ShadcnPagination, type SitemapChangeFreq, type SitemapData, type SitemapEntry, type SitemapOptions, StructuredDataError, type StructuredDataOptions, UninitializedAuth, type WebSiteSchema, autoConfigureRateLimit, bpArticles, bpOperations, buttonVariants, checkRateLimit, cn, configureRateLimit, createBlogSitemapRoute, createDynamicBlogSitemap, createRateLimitErrorResponse, createStructuredDataScript, enforceRateLimit, extractKeywordsFromArticle, extractTokenFromHeader, generateArticleMetadata, generateArticleStructuredData, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBlogSitemapEntries, generateBreadcrumbStructuredData, generateCanonicalUrl, generateCanonicalUrlFromSlug, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSiteMetadata, generateSitemap, generateSitemapIndex, generateWebSiteStructuredData, getAuthConfig, getBaseUrl, getDrizzleAdapterSql, getRateLimitHeaders, getStorage, initBlogPlatform, initBlogPlatformDev, initBlogPlatformOnce, initBlogPlatformProd, initEnvAuth, isValidCanonicalUrl, metadataToHtml, normalizeDomain, normalizeSlug, POST$1 as publishHandler, safeGenerateArticleStructuredData, setAuthConfig, setStorage, shouldSkipAuth, sitemapToXml, GET as slugExistsHandler, OPTIONS as slugExistsOptionsHandler, structuredDataToJsonLd, POST as unpublishHandler, updateArticleCanonicalUrl, usePagination, validateMetadata, validateSitemap, validateStructuredData, GET$1 as versionHandler };
+export { ApiKeyAuth, type AuthConfig, type AuthResult, ArticlePage as BlogArticlePage, BlogHomePage, type BlogPlatformConfig, type BlogPlatformStorage, type BlogPostingSchema, type BlogSitemapConfig, type BreadcrumbListSchema, Button, type CanonicalUrlOptions, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DrizzleStorage, EnvAuth, type GeneratedMetadata, InMemoryStorage, type LinkTag, type MetaTag, type MetadataOptions, type NextjsSitemapEntry, NoAuth, type OrganizationSchema, PACKAGE_VERSION, Pagination$1 as Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, type PersonSchema, PublishResult, PublishedArticle, PublishedAuthor, PublishedSite, type RateLimitConfig, type RateLimitResult, Pagination as ShadcnPagination, type SitemapChangeFreq, type SitemapData, type SitemapEntry, type SitemapOptions, StructuredDataError, type StructuredDataOptions, UninitializedAuth, type WebSiteSchema, autoConfigureRateLimit, bpArticles, bpOperations, buildBlogPath, buttonVariants, checkRateLimit, cn, configureRateLimit, createBlogSitemapRoute, createDynamicBlogSitemap, createRateLimitErrorResponse, createStructuredDataScript, enforceRateLimit, extractKeywordsFromArticle, extractTokenFromHeader, generateArticleMetadata, generateArticleStructuredData, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBlogSitemapEntries, generateBreadcrumbStructuredData, generateCanonicalUrl, generateCanonicalUrlFromSlug, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSiteMetadata, generateSitemap, generateSitemapIndex, generateWebSiteStructuredData, getAuthConfig, getBaseUrl, getDrizzleAdapterSql, getPathPrefixFromBlogUrl, getRateLimitHeaders, getStorage, initBlogPlatform, initBlogPlatformDev, initBlogPlatformOnce, initBlogPlatformProd, initEnvAuth, isValidCanonicalUrl, metadataToHtml, normalizeBlogBasePath, normalizeDomain, normalizeSlug, POST$1 as publishHandler, safeGenerateArticleStructuredData, setAuthConfig, setStorage, shouldSkipAuth, sitemapToXml, GET as slugExistsHandler, OPTIONS as slugExistsOptionsHandler, structuredDataToJsonLd, POST as unpublishHandler, updateArticleCanonicalUrl, usePagination, validateMetadata, validateSitemap, validateStructuredData, GET$1 as versionHandler };

package/dist/index.d.ts

@@ -18,6 +18,8 @@ interface BlogHomePageProps {
     site?: PublishedSite;
     /** Whether to include structured data */
     includeStructuredData?: boolean;
+    /** Public path where this blog is mounted, e.g. "/blog" or "/new-blog". */
+    basePath?: string;
     /** Pagination configuration */
     pagination?: {
         currentPage: number;
@@ -32,7 +34,7 @@ interface BlogHomePageProps {
  * @xexr/blog-platform package. It provides a clean, SEO-friendly
  * article listing with proper metadata.
  */
-declare function BlogHomePage({ articles, siteName, siteTagline, className, site, includeStructuredData, pagination, }: BlogHomePageProps): react_jsx_runtime.JSX.Element;
+declare function BlogHomePage({ articles, siteName, siteTagline, className, site, includeStructuredData, basePath, pagination, }: BlogHomePageProps): react_jsx_runtime.JSX.Element;
 /**
  * Generate metadata for the blog home page for SEO optimization.
  * This function should be used in the Next.js metadata API.
@@ -40,7 +42,7 @@ declare function BlogHomePage({ articles, siteName, siteTagline, className, site
 declare function generateBlogHomeMetadata(siteName?: string, siteDescription?: string, siteUrl?: string, pagination?: {
     currentPage: number;
     totalPages: number;
-}): {
+}, basePath?: string): {
     title: string;
     description: string;
     openGraph: {
@@ -81,13 +83,15 @@ interface ArticlePageProps {
             title: string;
         };
     };
+    /** Public path where this blog is mounted, e.g. "/blog" or "/new-blog". */
+    basePath?: string;
 }
-declare function ArticlePage({ article, className, navigation, }: ArticlePageProps): react_jsx_runtime.JSX.Element;
+declare function ArticlePage({ article, className, navigation, basePath, }: ArticlePageProps): react_jsx_runtime.JSX.Element;
 /**
  * Generate metadata for the article page for SEO optimization.
  * This function should be used in the Next.js metadata API.
  */
-declare function generateArticleMetadata(article: PublishedArticle): {
+declare function generateArticleMetadata(article: PublishedArticle, basePath?: string): {
     title: string;
     description: string;
     keywords: string;
@@ -202,6 +206,13 @@ declare function PaginationEllipsis({ className, ...props }: React.ComponentProp
 
 declare function cn(...inputs: ClassValue[]): string;
 
+/**
+ * URL helpers shared by package UI, metadata, and sitemap integrations.
+ */
+declare function normalizeBlogBasePath(basePath?: string): string;
+declare function buildBlogPath(basePath: string | undefined, slug?: string): string;
+declare function getPathPrefixFromBlogUrl(blogUrl: string): string;
+
 /**
  * Authentication configuration interface
  * Customers can implement this to customize authentication behavior
@@ -1796,4 +1807,4 @@ declare function OPTIONS(request: NextRequest): Promise<NextResponse>;
 
 declare const PACKAGE_VERSION: string;
 
-export { ApiKeyAuth, type AuthConfig, type AuthResult, ArticlePage as BlogArticlePage, BlogHomePage, type BlogPlatformConfig, type BlogPlatformStorage, type BlogPostingSchema, type BlogSitemapConfig, type BreadcrumbListSchema, Button, type CanonicalUrlOptions, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DrizzleStorage, EnvAuth, type GeneratedMetadata, InMemoryStorage, type LinkTag, type MetaTag, type MetadataOptions, type NextjsSitemapEntry, NoAuth, type OrganizationSchema, PACKAGE_VERSION, Pagination$1 as Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, type PersonSchema, PublishResult, PublishedArticle, PublishedAuthor, PublishedSite, type RateLimitConfig, type RateLimitResult, Pagination as ShadcnPagination, type SitemapChangeFreq, type SitemapData, type SitemapEntry, type SitemapOptions, StructuredDataError, type StructuredDataOptions, UninitializedAuth, type WebSiteSchema, autoConfigureRateLimit, bpArticles, bpOperations, buttonVariants, checkRateLimit, cn, configureRateLimit, createBlogSitemapRoute, createDynamicBlogSitemap, createRateLimitErrorResponse, createStructuredDataScript, enforceRateLimit, extractKeywordsFromArticle, extractTokenFromHeader, generateArticleMetadata, generateArticleStructuredData, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBlogSitemapEntries, generateBreadcrumbStructuredData, generateCanonicalUrl, generateCanonicalUrlFromSlug, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSiteMetadata, generateSitemap, generateSitemapIndex, generateWebSiteStructuredData, getAuthConfig, getBaseUrl, getDrizzleAdapterSql, getRateLimitHeaders, getStorage, initBlogPlatform, initBlogPlatformDev, initBlogPlatformOnce, initBlogPlatformProd, initEnvAuth, isValidCanonicalUrl, metadataToHtml, normalizeDomain, normalizeSlug, POST$1 as publishHandler, safeGenerateArticleStructuredData, setAuthConfig, setStorage, shouldSkipAuth, sitemapToXml, GET as slugExistsHandler, OPTIONS as slugExistsOptionsHandler, structuredDataToJsonLd, POST as unpublishHandler, updateArticleCanonicalUrl, usePagination, validateMetadata, validateSitemap, validateStructuredData, GET$1 as versionHandler };
+export { ApiKeyAuth, type AuthConfig, type AuthResult, ArticlePage as BlogArticlePage, BlogHomePage, type BlogPlatformConfig, type BlogPlatformStorage, type BlogPostingSchema, type BlogSitemapConfig, type BreadcrumbListSchema, Button, type CanonicalUrlOptions, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, DrizzleStorage, EnvAuth, type GeneratedMetadata, InMemoryStorage, type LinkTag, type MetaTag, type MetadataOptions, type NextjsSitemapEntry, NoAuth, type OrganizationSchema, PACKAGE_VERSION, Pagination$1 as Pagination, PaginationContent, PaginationEllipsis, PaginationItem, PaginationLink, PaginationNext, PaginationPrevious, type PersonSchema, PublishResult, PublishedArticle, PublishedAuthor, PublishedSite, type RateLimitConfig, type RateLimitResult, Pagination as ShadcnPagination, type SitemapChangeFreq, type SitemapData, type SitemapEntry, type SitemapOptions, StructuredDataError, type StructuredDataOptions, UninitializedAuth, type WebSiteSchema, autoConfigureRateLimit, bpArticles, bpOperations, buildBlogPath, buttonVariants, checkRateLimit, cn, configureRateLimit, createBlogSitemapRoute, createDynamicBlogSitemap, createRateLimitErrorResponse, createStructuredDataScript, enforceRateLimit, extractKeywordsFromArticle, extractTokenFromHeader, generateArticleMetadata, generateArticleStructuredData, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBlogSitemapEntries, generateBreadcrumbStructuredData, generateCanonicalUrl, generateCanonicalUrlFromSlug, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSiteMetadata, generateSitemap, generateSitemapIndex, generateWebSiteStructuredData, getAuthConfig, getBaseUrl, getDrizzleAdapterSql, getPathPrefixFromBlogUrl, getRateLimitHeaders, getStorage, initBlogPlatform, initBlogPlatformDev, initBlogPlatformOnce, initBlogPlatformProd, initEnvAuth, isValidCanonicalUrl, metadataToHtml, normalizeBlogBasePath, normalizeDomain, normalizeSlug, POST$1 as publishHandler, safeGenerateArticleStructuredData, setAuthConfig, setStorage, shouldSkipAuth, sitemapToXml, GET as slugExistsHandler, OPTIONS as slugExistsOptionsHandler, structuredDataToJsonLd, POST as unpublishHandler, updateArticleCanonicalUrl, usePagination, validateMetadata, validateSitemap, validateStructuredData, GET$1 as versionHandler };