@xexr/blog-platform 1.0.8 → 1.0.10

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { PublishedArticle, PublishedSite, PublishedTopic, PublishResult, PublishedAuthor } from './types/index.js';
+import { PublishedArticle, PublishedSite, PublishedAuthor, PublishResult, PublishedTopic } from './types/index.js';
 export { PublishPayload, PublishedAuthorSocialLinks } from './types/index.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import * as React from 'react';
@@ -164,6 +164,55 @@ declare function generateArticleMetadata(
   };
 };
 
+interface AuthorPageProps {
+    author: PublishedAuthor;
+    articles: PublishedArticle[];
+    site: PublishedSite;
+    className?: string;
+    basePath?: string;
+    theme?: BlogTheme;
+    pagination?: {
+        currentPage: number;
+        totalPages: number;
+        baseUrl?: string;
+        totalItems?: number;
+    };
+    navigation?: {
+        backToHome?: {
+            url: string;
+            label?: string;
+        };
+    };
+}
+declare function AuthorPage({ author, articles, site, className, basePath, theme, pagination, navigation, }: AuthorPageProps): react_jsx_runtime.JSX.Element;
+declare function generateAuthorPageMetadata(author: PublishedAuthor, site: PublishedSite, basePath?: string): {
+    title: string;
+    description: string;
+    authors: {
+        name: string;
+    }[];
+    openGraph: {
+        title: string;
+        description: string;
+        type: string;
+        url: string;
+        images: {
+            url: string;
+            alt: string;
+        }[] | undefined;
+        siteName: string;
+    };
+    twitter: {
+        card: string;
+        title: string;
+        description: string;
+        images: string[] | undefined;
+    };
+    alternates: {
+        canonical: string;
+    };
+};
+
 interface PaginationProps {
     /** Current page number (1-indexed) */
     currentPage: number;
@@ -252,8 +301,88 @@ 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 getPathPrefixFromBlogUrl(blogUrl: string): string;
 
+/**
+ * Database interface for blog platform storage
+ *
+ * This provides a simple interface for storing published articles
+ * without coupling to any specific database implementation.
+ * Customers can implement this interface with their preferred database.
+ */
+
+interface BlogPlatformStorage {
+    /**
+     * Store a published article
+     */
+    saveArticle(article: PublishedArticle, idempotencyKey: string): Promise<PublishResult>;
+    /**
+     * Get an article by slug
+     */
+    getArticle(slug: string): Promise<PublishedArticle | null>;
+    /**
+     * List all published articles
+     */
+    listArticles(options?: {
+        limit?: number;
+        offset?: number;
+        sortBy?: "publishedAt" | "updatedAt";
+        order?: "asc" | "desc";
+    }): Promise<{
+        articles: PublishedArticle[];
+        total: number;
+    }>;
+    /**
+     * Remove an article by slug
+     */
+    removeArticle(slug: string, idempotencyKey: string): Promise<PublishResult>;
+    /**
+     * Check if an operation was already performed (idempotency)
+     */
+    checkIdempotency(idempotencyKey: string): Promise<PublishResult | null>;
+    /**
+     * Store the result of an operation for idempotency
+     */
+    storeOperationResult(idempotencyKey: string, result: PublishResult): Promise<void>;
+}
+/**
+ * Default in-memory storage implementation for development/testing
+ * IMPORTANT: This is not suitable for production use!
+ */
+declare class InMemoryStorage implements BlogPlatformStorage {
+    private articles;
+    private operations;
+    saveArticle(article: PublishedArticle, idempotencyKey: string): Promise<PublishResult>;
+    getArticle(slug: string): Promise<PublishedArticle | null>;
+    listArticles(options?: {
+        limit?: number;
+        offset?: number;
+        sortBy?: "publishedAt" | "updatedAt";
+        order?: "asc" | "desc";
+    }): Promise<{
+        articles: PublishedArticle[];
+        total: number;
+    }>;
+    removeArticle(slug: string, idempotencyKey: string): Promise<PublishResult>;
+    checkIdempotency(idempotencyKey: string): Promise<PublishResult | null>;
+    storeOperationResult(idempotencyKey: string, result: PublishResult): Promise<void>;
+}
+declare function getStorage(): BlogPlatformStorage;
+declare function setStorage(storage: BlogPlatformStorage): void;
+
+interface AuthorArchive {
+    author: PublishedAuthor;
+    articles: PublishedArticle[];
+}
+interface AuthorArchiveOptions {
+    limit?: number;
+    offset?: number;
+}
+declare function getAuthorsFromArticles(articles: readonly PublishedArticle[]): PublishedAuthor[];
+declare function getAuthorArchive(slug: string, articles: readonly PublishedArticle[]): AuthorArchive | null;
+declare function loadAuthorArchive(slug: string, options?: AuthorArchiveOptions, storage?: BlogPlatformStorage): Promise<AuthorArchive | null>;
+
 interface TopicArchive {
     topic: PublishedTopic;
     articles: PublishedArticle[];
@@ -280,6 +409,16 @@ 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 BlogAuthorsIndexPageProps {
+    articles: PublishedArticle[];
+    basePath?: string;
+    title?: string;
+    description?: string;
+    className?: string;
+    theme?: BlogTheme;
+}
+declare function BlogAuthorsIndexPage({ articles, basePath, title, description, className, theme, }: BlogAuthorsIndexPageProps): react_jsx_runtime.JSX.Element;
+
 /**
  * Authentication configuration interface
  * Customers can implement this to customize authentication behavior
@@ -379,73 +518,6 @@ declare function initEnvAuth(envVarName?: string): void;
  */
 declare function shouldSkipAuth(): boolean;
 
-/**
- * Database interface for blog platform storage
- *
- * This provides a simple interface for storing published articles
- * without coupling to any specific database implementation.
- * Customers can implement this interface with their preferred database.
- */
-
-interface BlogPlatformStorage {
-    /**
-     * Store a published article
-     */
-    saveArticle(article: PublishedArticle, idempotencyKey: string): Promise<PublishResult>;
-    /**
-     * Get an article by slug
-     */
-    getArticle(slug: string): Promise<PublishedArticle | null>;
-    /**
-     * List all published articles
-     */
-    listArticles(options?: {
-        limit?: number;
-        offset?: number;
-        sortBy?: "publishedAt" | "updatedAt";
-        order?: "asc" | "desc";
-    }): Promise<{
-        articles: PublishedArticle[];
-        total: number;
-    }>;
-    /**
-     * Remove an article by slug
-     */
-    removeArticle(slug: string, idempotencyKey: string): Promise<PublishResult>;
-    /**
-     * Check if an operation was already performed (idempotency)
-     */
-    checkIdempotency(idempotencyKey: string): Promise<PublishResult | null>;
-    /**
-     * Store the result of an operation for idempotency
-     */
-    storeOperationResult(idempotencyKey: string, result: PublishResult): Promise<void>;
-}
-/**
- * Default in-memory storage implementation for development/testing
- * IMPORTANT: This is not suitable for production use!
- */
-declare class InMemoryStorage implements BlogPlatformStorage {
-    private articles;
-    private operations;
-    saveArticle(article: PublishedArticle, idempotencyKey: string): Promise<PublishResult>;
-    getArticle(slug: string): Promise<PublishedArticle | null>;
-    listArticles(options?: {
-        limit?: number;
-        offset?: number;
-        sortBy?: "publishedAt" | "updatedAt";
-        order?: "asc" | "desc";
-    }): Promise<{
-        articles: PublishedArticle[];
-        total: number;
-    }>;
-    removeArticle(slug: string, idempotencyKey: string): Promise<PublishResult>;
-    checkIdempotency(idempotencyKey: string): Promise<PublishResult | null>;
-    storeOperationResult(idempotencyKey: string, result: PublishResult): Promise<void>;
-}
-declare function getStorage(): BlogPlatformStorage;
-declare function setStorage(storage: BlogPlatformStorage): void;
-
 /**
  * Rate limiting for blog platform API endpoints
  *
@@ -822,6 +894,63 @@ declare const bpArticles: drizzle_orm_sqlite_core.SQLiteTableWithColumns<{
         }, {}, {
             length: number | undefined;
         }>;
+        featuredImageCaption: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "featured_image_caption";
+            tableName: "bp_articles";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        featuredImageCreditText: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "featured_image_credit_text";
+            tableName: "bp_articles";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
+        featuredImageCreditUrl: drizzle_orm_sqlite_core.SQLiteColumn<{
+            name: "featured_image_credit_url";
+            tableName: "bp_articles";
+            dataType: "string";
+            columnType: "SQLiteText";
+            data: string;
+            driverParam: string;
+            notNull: false;
+            hasDefault: false;
+            isPrimaryKey: false;
+            isAutoincrement: false;
+            hasRuntimeDefault: false;
+            enumValues: [string, ...string[]];
+            baseColumn: never;
+            identity: undefined;
+            generated: undefined;
+        }, {}, {
+            length: number | undefined;
+        }>;
         authorJson: drizzle_orm_sqlite_core.SQLiteColumn<{
             name: "author_json";
             tableName: "bp_articles";
@@ -1359,7 +1488,7 @@ interface SitemapOptions {
 /**
  * Valid sitemap change frequency values as per XML sitemap standard.
  */
-type SitemapChangeFreq = 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+type SitemapChangeFreq = "always" | "hourly" | "daily" | "weekly" | "monthly" | "yearly" | "never";
 /**
  * Next.js MetadataRoute.Sitemap compatible entry.
  * This matches the expected format for Next.js sitemap generation.
@@ -1875,4 +2004,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 BlogTheme, BlogTopicArchivePage, BlogTopicsIndexPage, 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, PublishedTopic, type RateLimitConfig, type RateLimitResult, Pagination as ShadcnPagination, type SitemapChangeFreq, type SitemapData, type SitemapEntry, type SitemapOptions, StructuredDataError, type StructuredDataOptions, type TopicArchive, UninitializedAuth, type WebSiteSchema, autoConfigureRateLimit, bpArticles, bpOperations, buildBlogPath, buttonVariants, checkRateLimit, cn, configureRateLimit, createBlogSitemapRoute, createDynamicBlogSitemap, createRateLimitErrorResponse, createStructuredDataScript, enforceRateLimit, extractKeywordsFromArticle, extractTableOfContents, extractTokenFromHeader, formatArticleDateMeta, generateArticleMetadata, generateArticleStructuredData, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBlogSitemapEntries, generateBreadcrumbStructuredData, generateCanonicalUrl, generateCanonicalUrlFromSlug, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSiteMetadata, generateSitemap, generateSitemapIndex, generateWebSiteStructuredData, getAllTopics, getArticlePrimaryTopic, getAuthConfig, getBaseUrl, getBlogThemeStyle, getDrizzleAdapterSql, getPathPrefixFromBlogUrl, getRateLimitHeaders, getStorage, getTopicArchive, 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 };
+export { ApiKeyAuth, type AuthConfig, type AuthResult, type AuthorArchive, type AuthorArchiveOptions, ArticlePage as BlogArticlePage, AuthorPage as BlogAuthorPage, BlogAuthorsIndexPage, BlogHomePage, type BlogPlatformConfig, type BlogPlatformStorage, type BlogPostingSchema, type BlogSitemapConfig, type BlogTheme, BlogTopicArchivePage, BlogTopicsIndexPage, 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, PublishedTopic, type RateLimitConfig, type RateLimitResult, Pagination as ShadcnPagination, type SitemapChangeFreq, type SitemapData, type SitemapEntry, type SitemapOptions, StructuredDataError, type StructuredDataOptions, type TopicArchive, UninitializedAuth, type WebSiteSchema, autoConfigureRateLimit, bpArticles, bpOperations, buildAuthorPath, buildBlogPath, buttonVariants, checkRateLimit, cn, configureRateLimit, createBlogSitemapRoute, createDynamicBlogSitemap, createRateLimitErrorResponse, createStructuredDataScript, enforceRateLimit, extractKeywordsFromArticle, extractTableOfContents, extractTokenFromHeader, formatArticleDateMeta, generateArticleMetadata, generateArticleStructuredData, generateAuthorPageMetadata, generateAuthorStructuredData, generateBlogHomeMetadata, generateBlogHomeStructuredData, generateBlogSitemapEntries, generateBreadcrumbStructuredData, generateCanonicalUrl, generateCanonicalUrlFromSlug, generateCompleteArticleStructuredData, generateOrganizationStructuredData, generatePaginationMetadata, generateSiteMetadata, generateSitemap, generateSitemapIndex, generateWebSiteStructuredData, getAllTopics, getArticlePrimaryTopic, getAuthConfig, getAuthorArchive, getAuthorsFromArticles, getBaseUrl, getBlogThemeStyle, getDrizzleAdapterSql, getPathPrefixFromBlogUrl, getRateLimitHeaders, getStorage, getTopicArchive, initBlogPlatform, initBlogPlatformDev, initBlogPlatformOnce, initBlogPlatformProd, initEnvAuth, isValidCanonicalUrl, loadAuthorArchive, 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 };