@sonordev/site-kit 1.2.7

package/dist/blog/server.d.ts

@@ -0,0 +1,229 @@
+import { Metadata } from 'next';
+import { B as BlogPost } from '../types-D08004rU.js';
+
+/**
+ * @sonordev/site-kit/blog/server
+ *
+ * Server-side functions for Next.js blog pages.
+ * Includes metadata generation, sitemap, RSS feeds, and static params for SSG.
+ */
+
+declare const SEO_LIMITS: {
+    readonly title: {
+        readonly min: 30;
+        readonly max: 60;
+        readonly recommended: 55;
+    };
+    readonly metaDescription: {
+        readonly min: 120;
+        readonly max: 160;
+        readonly recommended: 155;
+    };
+    readonly excerpt: {
+        readonly min: 100;
+        readonly max: 300;
+        readonly recommended: 200;
+    };
+    readonly slug: {
+        readonly max: 75;
+    };
+    readonly focusKeyphrase: {
+        readonly min: 2;
+        readonly max: 4;
+        readonly words: true;
+    };
+};
+interface SeoValidationResult {
+    field: string;
+    value: string;
+    length: number;
+    limit: {
+        min?: number;
+        max: number;
+        recommended?: number;
+    };
+    status: 'good' | 'warning' | 'error';
+    message: string;
+}
+/**
+ * Validate SEO title (60 chars max, keyword-first recommended)
+ */
+declare function validateSeoTitle(title: string, focusKeyphrase?: string): SeoValidationResult;
+/**
+ * Validate meta description (150-160 chars, benefit-driven)
+ */
+declare function validateMetaDescription(description: string, focusKeyphrase?: string): SeoValidationResult;
+/**
+ * Full SEO validation for a blog post
+ */
+declare function validateBlogPostSeo(post: Partial<BlogPost>): SeoValidationResult[];
+/**
+ * Fetch a blog post by slug (server-side)
+ */
+declare function getBlogPost(slug: string): Promise<BlogPost | null>;
+/**
+ * Fetch all blog post slugs for static generation
+ */
+declare function getAllBlogSlugs(): Promise<{
+    slug: string;
+    last_modified?: string;
+}[]>;
+/**
+ * Fetch blog categories
+ */
+declare function getBlogCategories(): Promise<{
+    name: string;
+    slug: string;
+    post_count: number;
+}[]>;
+interface BlogMetadataOptions {
+    /** Site name for og:site_name */
+    siteName?: string;
+    /** Base URL of the site */
+    siteUrl?: string;
+    /** Default OG image */
+    defaultImage?: string;
+    /** Twitter handle */
+    twitterHandle?: string;
+}
+/**
+ * Generate metadata for a blog post page
+ */
+declare function generateBlogPostMetadata(slug: string, options?: BlogMetadataOptions): Promise<Metadata>;
+/**
+ * Generate metadata for the blog index page
+ */
+declare function generateBlogIndexMetadata(options: BlogMetadataOptions & {
+    title?: string;
+    description?: string;
+}): Metadata;
+/**
+ * Generate metadata for a category page
+ */
+declare function generateBlogCategoryMetadata(categoryName: string, options?: BlogMetadataOptions): Metadata;
+/**
+ * Generate static params for blog post pages
+ * Usage: export const generateStaticParams = generateBlogStaticParams
+ */
+declare function generateBlogStaticParams(): Promise<{
+    slug: string;
+}[]>;
+/**
+ * Generate static params for category pages
+ * Usage: export const generateStaticParams = generateCategoryStaticParams
+ */
+declare function generateCategoryStaticParams(): Promise<{
+    category: string;
+}[]>;
+interface SitemapEntry {
+    url: string;
+    lastModified?: Date;
+    changeFrequency?: 'always' | 'hourly' | 'daily' | 'weekly' | 'monthly' | 'yearly' | 'never';
+    priority?: number;
+}
+/**
+ * Generate sitemap entries for blog posts
+ */
+declare function generateBlogSitemap(siteUrl: string): Promise<SitemapEntry[]>;
+/**
+ * Generate JSON-LD schema for a blog post
+ */
+declare function generateBlogPostSchema(post: BlogPost, options?: {
+    siteUrl?: string;
+    siteName?: string;
+    logoUrl?: string;
+}): object;
+/**
+ * Generate JSON-LD schema for blog index/listing page
+ */
+declare function generateBlogListSchema(options?: {
+    siteUrl?: string;
+    siteName?: string;
+    description?: string;
+}): object;
+/**
+ * Generate standalone FAQ schema (great for PAA inclusion)
+ */
+declare function generateFaqSchema(faqItems: {
+    question: string;
+    answer: string;
+}[]): object | null;
+interface HowToStep {
+    name: string;
+    text: string;
+    image?: string;
+    url?: string;
+}
+/**
+ * Generate HowTo schema for step-by-step posts
+ */
+declare function generateHowToSchema(post: BlogPost, steps: HowToStep[], options?: {
+    siteUrl?: string;
+}): object;
+interface RssFeedOptions {
+    siteUrl: string;
+    siteName: string;
+    description?: string;
+    language?: string;
+    copyright?: string;
+    managingEditor?: string;
+    webMaster?: string;
+    ttl?: number;
+    imageUrl?: string;
+}
+/**
+ * Fetch all published blog posts for RSS feed
+ */
+declare function getAllBlogPosts(): Promise<BlogPost[]>;
+/**
+ * Generate RSS 2.0 feed XML
+ */
+declare function generateRssFeed(options: RssFeedOptions): Promise<string>;
+/**
+ * Generate Atom feed XML
+ */
+declare function generateAtomFeed(options: RssFeedOptions): Promise<string>;
+interface TopicCluster {
+    pillar: BlogPost;
+    supportingPosts: BlogPost[];
+    internalLinks: Array<{
+        from: string;
+        to: string;
+        anchor: string;
+    }>;
+}
+/**
+ * Fetch posts by category for topic cluster organization
+ */
+declare function getPostsByCategory(categorySlug: string): Promise<BlogPost[]>;
+/**
+ * Identify topic clusters based on category grouping
+ * Assumes the longest/most comprehensive post is the pillar
+ */
+declare function identifyTopicClusters(categorySlug: string): Promise<TopicCluster | null>;
+/**
+ * Generate "Related Insights" section data
+ */
+declare function getRelatedInsights(currentSlug: string, options?: {
+    limit?: number;
+    category?: string;
+}): Promise<BlogPost[]>;
+/**
+ * Generate BreadcrumbList schema for blog navigation
+ */
+declare function generateBreadcrumbSchema(post: BlogPost, options?: {
+    siteUrl?: string;
+    siteName?: string;
+}): object;
+/**
+ * Generate all relevant schemas for a blog post in a single array
+ * This is the recommended way to include multiple schemas.
+ * When post has E-E-A-T schema (post.schema), use it instead of generating Article/FAQ.
+ */
+declare function generateAllBlogSchemas(post: BlogPost, options?: {
+    siteUrl?: string;
+    siteName?: string;
+    logoUrl?: string;
+}): object[];
+
+export { type HowToStep, SEO_LIMITS, type SeoValidationResult, type TopicCluster, generateAllBlogSchemas, generateAtomFeed, generateBlogCategoryMetadata, generateBlogIndexMetadata, generateBlogListSchema, generateBlogPostMetadata, generateBlogPostSchema, generateBlogSitemap, generateBlogStaticParams, generateBreadcrumbSchema, generateCategoryStaticParams, generateFaqSchema, generateHowToSchema, generateRssFeed, getAllBlogPosts, getAllBlogSlugs, getBlogCategories, getBlogPost, getPostsByCategory, getRelatedInsights, identifyTopicClusters, validateBlogPostSeo, validateMetaDescription, validateSeoTitle };