@sonordev/site-kit 2.2.8 → 2.5.0

package/dist/blog/server.d.ts

@@ -1,5 +1,5 @@
 import { Metadata } from 'next';
-import { B as BlogPost, a as BlogAuthor } from '../types-DWMpAtGy.js';
+import { B as BlogPost, T as TopicCluster, C as ClusterNavigation, a as BlogAuthor } from '../types-5P5B9RgV.js';
 
 /**
  * @sonordev/site-kit/blog/server
@@ -67,7 +67,9 @@ declare function getBlogPost(slug: string): Promise<BlogPost | null>;
  */
 declare function getAllBlogSlugs(): Promise<{
     slug: string;
+    id?: string;
     last_modified?: string;
+    article_type?: string;
 }[]>;
 /**
  * Fetch blog categories
@@ -186,7 +188,25 @@ declare function generateRssFeed(options: RssFeedOptions): Promise<string>;
  * Generate Atom feed XML
  */
 declare function generateAtomFeed(options: RssFeedOptions): Promise<string>;
-interface TopicCluster {
+/**
+ * Fetch all active topic clusters for the project.
+ * Uses the real cluster data from Portal API (not heuristic-based).
+ */
+declare function getTopicClusters(): Promise<TopicCluster[]>;
+/**
+ * Fetch a single topic cluster with its pillar and support articles.
+ */
+declare function getTopicCluster(slug: string): Promise<TopicCluster | null>;
+/**
+ * Get cluster navigation context for a blog post.
+ * Returns the cluster name, pillar link, and sibling articles.
+ */
+declare function getClusterNavigation(post: BlogPost): ClusterNavigation | null;
+/**
+ * @deprecated Use getTopicCluster(slug) instead. This naive heuristic picks
+ * the longest post as pillar. Real cluster data is now managed in the Sonor dashboard.
+ */
+declare function identifyTopicClusters(categorySlug: string): Promise<{
     pillar: BlogPost;
     supportingPosts: BlogPost[];
     internalLinks: Array<{
@@ -194,16 +214,68 @@ interface TopicCluster {
         to: string;
         anchor: string;
     }>;
-}
+} | null>;
 /**
  * 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
+ * Generate ItemList schema for a cluster's pillar page.
+ * Wraps supporting posts as a structured list Google can parse.
  */
-declare function identifyTopicClusters(categorySlug: string): Promise<TopicCluster | null>;
+declare function generateClusterItemListSchema(cluster: TopicCluster, options?: {
+    siteUrl?: string;
+    basePath?: string;
+}): object;
+/**
+ * Generate Article schema with cluster relationship (isPartOf / hasPart).
+ * - Support articles get `isPartOf` pointing to the pillar.
+ * - Pillar articles get `hasPart` listing all supports.
+ */
+declare function generateClusterArticleSchema(post: BlogPost, cluster: TopicCluster, options?: {
+    siteUrl?: string;
+    basePath?: string;
+    siteName?: string;
+    logoUrl?: string;
+}): object;
+/**
+ * Generate BreadcrumbList schema for a cluster-linked post.
+ * Path: Home > Blog > Cluster > Article
+ */
+declare function generateClusterBreadcrumbSchema(post: BlogPost, cluster: TopicCluster, options?: {
+    siteUrl?: string;
+    siteName?: string;
+    basePath?: string;
+}): object;
+/**
+ * Generate CollectionPage schema for a cluster landing page.
+ */
+declare function generateClusterLandingSchema(cluster: TopicCluster, options?: {
+    siteUrl?: string;
+    basePath?: string;
+    siteName?: string;
+}): object;
+/**
+ * Generate metadata for a cluster landing page (Next.js generateMetadata).
+ */
+declare function generateClusterPageMetadata(clusterSlug: string, options?: {
+    siteName?: string;
+    siteUrl?: string;
+    basePath?: string;
+}): Promise<{
+    title?: undefined;
+    description?: undefined;
+    openGraph?: undefined;
+} | {
+    title: string;
+    description: string;
+    openGraph: {
+        title: string;
+        description: string;
+        url: string;
+        type: string;
+    };
+}>;
 /**
  * Generate "Related Insights" section data
  */
@@ -268,4 +340,4 @@ declare function generateAuthorSchema(author: BlogAuthor, options?: {
     siteName?: string;
 }): object;
 
-export { BlogPost as BlogPostRecord, type HowToStep, SEO_LIMITS, type SeoValidationResult, type TopicCluster, generateAllBlogSchemas, generateAtomFeed, generateAuthorPageMetadata, generateAuthorSchema, generateAuthorStaticParams, generateBlogCategoryMetadata, generateBlogIndexMetadata, generateBlogListSchema, generateBlogPostMetadata, generateBlogPostSchema, generateBlogSitemap, generateBlogStaticParams, generateBreadcrumbSchema, generateCategoryStaticParams, generateFaqSchema, generateHowToSchema, generateRssFeed, getAllAuthorSlugs, getAllBlogPosts, getAllBlogSlugs, getAuthorBySlug, getAuthorPosts, getBlogCategories, getBlogPost, getPostsByCategory, getRelatedInsights, identifyTopicClusters, validateBlogPostSeo, validateMetaDescription, validateSeoTitle };
+export { BlogPost as BlogPostRecord, type HowToStep, SEO_LIMITS, type SeoValidationResult, generateAllBlogSchemas, generateAtomFeed, generateAuthorPageMetadata, generateAuthorSchema, generateAuthorStaticParams, generateBlogCategoryMetadata, generateBlogIndexMetadata, generateBlogListSchema, generateBlogPostMetadata, generateBlogPostSchema, generateBlogSitemap, generateBlogStaticParams, generateBreadcrumbSchema, generateCategoryStaticParams, generateClusterArticleSchema, generateClusterBreadcrumbSchema, generateClusterItemListSchema, generateClusterLandingSchema, generateClusterPageMetadata, generateFaqSchema, generateHowToSchema, generateRssFeed, getAllAuthorSlugs, getAllBlogPosts, getAllBlogSlugs, getAuthorBySlug, getAuthorPosts, getBlogCategories, getBlogPost, getClusterNavigation, getPostsByCategory, getRelatedInsights, getTopicCluster, getTopicClusters, identifyTopicClusters, validateBlogPostSeo, validateMetaDescription, validateSeoTitle };

package/dist/blog/server.js

@@ -1,133 +1,165 @@
 'use strict';
 
-var chunkGQKBGL2W_js = require('../chunk-GQKBGL2W.js');
+var chunkDZKX3GHL_js = require('../chunk-DZKX3GHL.js');
 require('../chunk-ZSMWDLMK.js');
 
 
 
 Object.defineProperty(exports, "SEO_LIMITS", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.SEO_LIMITS; }
+  get: function () { return chunkDZKX3GHL_js.SEO_LIMITS; }
 });
 Object.defineProperty(exports, "generateAllBlogSchemas", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateAllBlogSchemas; }
+  get: function () { return chunkDZKX3GHL_js.generateAllBlogSchemas; }
 });
 Object.defineProperty(exports, "generateAtomFeed", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateAtomFeed; }
+  get: function () { return chunkDZKX3GHL_js.generateAtomFeed; }
 });
 Object.defineProperty(exports, "generateAuthorPageMetadata", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateAuthorPageMetadata; }
+  get: function () { return chunkDZKX3GHL_js.generateAuthorPageMetadata; }
 });
 Object.defineProperty(exports, "generateAuthorSchema", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateAuthorSchema; }
+  get: function () { return chunkDZKX3GHL_js.generateAuthorSchema; }
 });
 Object.defineProperty(exports, "generateAuthorStaticParams", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateAuthorStaticParams; }
+  get: function () { return chunkDZKX3GHL_js.generateAuthorStaticParams; }
 });
 Object.defineProperty(exports, "generateBlogCategoryMetadata", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateBlogCategoryMetadata; }
+  get: function () { return chunkDZKX3GHL_js.generateBlogCategoryMetadata; }
 });
 Object.defineProperty(exports, "generateBlogIndexMetadata", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateBlogIndexMetadata; }
+  get: function () { return chunkDZKX3GHL_js.generateBlogIndexMetadata; }
 });
 Object.defineProperty(exports, "generateBlogListSchema", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateBlogListSchema; }
+  get: function () { return chunkDZKX3GHL_js.generateBlogListSchema; }
 });
 Object.defineProperty(exports, "generateBlogPostMetadata", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateBlogPostMetadata; }
+  get: function () { return chunkDZKX3GHL_js.generateBlogPostMetadata; }
 });
 Object.defineProperty(exports, "generateBlogPostSchema", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateBlogPostSchema; }
+  get: function () { return chunkDZKX3GHL_js.generateBlogPostSchema; }
 });
 Object.defineProperty(exports, "generateBlogSitemap", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateBlogSitemap; }
+  get: function () { return chunkDZKX3GHL_js.generateBlogSitemap; }
 });
 Object.defineProperty(exports, "generateBlogStaticParams", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateBlogStaticParams; }
+  get: function () { return chunkDZKX3GHL_js.generateBlogStaticParams; }
 });
 Object.defineProperty(exports, "generateBreadcrumbSchema", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateBreadcrumbSchema; }
+  get: function () { return chunkDZKX3GHL_js.generateBreadcrumbSchema; }
 });
 Object.defineProperty(exports, "generateCategoryStaticParams", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateCategoryStaticParams; }
+  get: function () { return chunkDZKX3GHL_js.generateCategoryStaticParams; }
+});
+Object.defineProperty(exports, "generateClusterArticleSchema", {
+  enumerable: true,
+  get: function () { return chunkDZKX3GHL_js.generateClusterArticleSchema; }
+});
+Object.defineProperty(exports, "generateClusterBreadcrumbSchema", {
+  enumerable: true,
+  get: function () { return chunkDZKX3GHL_js.generateClusterBreadcrumbSchema; }
+});
+Object.defineProperty(exports, "generateClusterItemListSchema", {
+  enumerable: true,
+  get: function () { return chunkDZKX3GHL_js.generateClusterItemListSchema; }
+});
+Object.defineProperty(exports, "generateClusterLandingSchema", {
+  enumerable: true,
+  get: function () { return chunkDZKX3GHL_js.generateClusterLandingSchema; }
+});
+Object.defineProperty(exports, "generateClusterPageMetadata", {
+  enumerable: true,
+  get: function () { return chunkDZKX3GHL_js.generateClusterPageMetadata; }
 });
 Object.defineProperty(exports, "generateFaqSchema", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateFaqSchema; }
+  get: function () { return chunkDZKX3GHL_js.generateFaqSchema; }
 });
 Object.defineProperty(exports, "generateHowToSchema", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateHowToSchema; }
+  get: function () { return chunkDZKX3GHL_js.generateHowToSchema; }
 });
 Object.defineProperty(exports, "generateRssFeed", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.generateRssFeed; }
+  get: function () { return chunkDZKX3GHL_js.generateRssFeed; }
 });
 Object.defineProperty(exports, "getAllAuthorSlugs", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.getAllAuthorSlugs; }
+  get: function () { return chunkDZKX3GHL_js.getAllAuthorSlugs; }
 });
 Object.defineProperty(exports, "getAllBlogPosts", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.getAllBlogPosts; }
+  get: function () { return chunkDZKX3GHL_js.getAllBlogPosts; }
 });
 Object.defineProperty(exports, "getAllBlogSlugs", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.getAllBlogSlugs; }
+  get: function () { return chunkDZKX3GHL_js.getAllBlogSlugs; }
 });
 Object.defineProperty(exports, "getAuthorBySlug", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.getAuthorBySlug; }
+  get: function () { return chunkDZKX3GHL_js.getAuthorBySlug; }
 });
 Object.defineProperty(exports, "getAuthorPosts", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.getAuthorPosts; }
+  get: function () { return chunkDZKX3GHL_js.getAuthorPosts; }
 });
 Object.defineProperty(exports, "getBlogCategories", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.getBlogCategories; }
+  get: function () { return chunkDZKX3GHL_js.getBlogCategories; }
 });
 Object.defineProperty(exports, "getBlogPost", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.getBlogPost; }
+  get: function () { return chunkDZKX3GHL_js.getBlogPost; }
+});
+Object.defineProperty(exports, "getClusterNavigation", {
+  enumerable: true,
+  get: function () { return chunkDZKX3GHL_js.getClusterNavigation; }
 });
 Object.defineProperty(exports, "getPostsByCategory", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.getPostsByCategory; }
+  get: function () { return chunkDZKX3GHL_js.getPostsByCategory; }
 });
 Object.defineProperty(exports, "getRelatedInsights", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.getRelatedInsights; }
+  get: function () { return chunkDZKX3GHL_js.getRelatedInsights; }
+});
+Object.defineProperty(exports, "getTopicCluster", {
+  enumerable: true,
+  get: function () { return chunkDZKX3GHL_js.getTopicCluster; }
+});
+Object.defineProperty(exports, "getTopicClusters", {
+  enumerable: true,
+  get: function () { return chunkDZKX3GHL_js.getTopicClusters; }
 });
 Object.defineProperty(exports, "identifyTopicClusters", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.identifyTopicClusters; }
+  get: function () { return chunkDZKX3GHL_js.identifyTopicClusters; }
 });
 Object.defineProperty(exports, "validateBlogPostSeo", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.validateBlogPostSeo; }
+  get: function () { return chunkDZKX3GHL_js.validateBlogPostSeo; }
 });
 Object.defineProperty(exports, "validateMetaDescription", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.validateMetaDescription; }
+  get: function () { return chunkDZKX3GHL_js.validateMetaDescription; }
 });
 Object.defineProperty(exports, "validateSeoTitle", {
   enumerable: true,
-  get: function () { return chunkGQKBGL2W_js.validateSeoTitle; }
+  get: function () { return chunkDZKX3GHL_js.validateSeoTitle; }
 });
 //# sourceMappingURL=server.js.map
 //# sourceMappingURL=server.js.map

package/dist/blog/server.mjs

@@ -1,4 +1,4 @@
-export { SEO_LIMITS, generateAllBlogSchemas, generateAtomFeed, generateAuthorPageMetadata, generateAuthorSchema, generateAuthorStaticParams, generateBlogCategoryMetadata, generateBlogIndexMetadata, generateBlogListSchema, generateBlogPostMetadata, generateBlogPostSchema, generateBlogSitemap, generateBlogStaticParams, generateBreadcrumbSchema, generateCategoryStaticParams, generateFaqSchema, generateHowToSchema, generateRssFeed, getAllAuthorSlugs, getAllBlogPosts, getAllBlogSlugs, getAuthorBySlug, getAuthorPosts, getBlogCategories, getBlogPost, getPostsByCategory, getRelatedInsights, identifyTopicClusters, validateBlogPostSeo, validateMetaDescription, validateSeoTitle } from '../chunk-WRCX2NKY.mjs';
+export { SEO_LIMITS, generateAllBlogSchemas, generateAtomFeed, generateAuthorPageMetadata, generateAuthorSchema, generateAuthorStaticParams, generateBlogCategoryMetadata, generateBlogIndexMetadata, generateBlogListSchema, generateBlogPostMetadata, generateBlogPostSchema, generateBlogSitemap, generateBlogStaticParams, generateBreadcrumbSchema, generateCategoryStaticParams, generateClusterArticleSchema, generateClusterBreadcrumbSchema, generateClusterItemListSchema, generateClusterLandingSchema, generateClusterPageMetadata, generateFaqSchema, generateHowToSchema, generateRssFeed, getAllAuthorSlugs, getAllBlogPosts, getAllBlogSlugs, getAuthorBySlug, getAuthorPosts, getBlogCategories, getBlogPost, getClusterNavigation, getPostsByCategory, getRelatedInsights, getTopicCluster, getTopicClusters, identifyTopicClusters, validateBlogPostSeo, validateMetaDescription, validateSeoTitle } from '../chunk-2NM6RGAV.mjs';
 import '../chunk-4XPGGLVP.mjs';
 //# sourceMappingURL=server.mjs.map
 //# sourceMappingURL=server.mjs.map

package/dist/{chunk-WRCX2NKY.mjs → chunk-2NM6RGAV.mjs}

@@ -261,6 +261,7 @@ async function generateCategoryStaticParams() {
 async function generateBlogSitemap(siteUrl) {
   const slugs = await getAllBlogSlugs();
   const categories = await getBlogCategories();
+  const clusters = await getTopicClusters();
   const entries = [
     // Blog index
     {
@@ -269,6 +270,13 @@ async function generateBlogSitemap(siteUrl) {
       priority: 0.8
     }
   ];
+  clusters.forEach((cluster) => {
+    entries.push({
+      url: `${siteUrl}/blog/cluster/${cluster.cluster_slug}`,
+      changeFrequency: "weekly",
+      priority: 0.8
+    });
+  });
   categories.forEach((cat) => {
     entries.push({
       url: `${siteUrl}/blog/category/${cat.slug}`,
@@ -277,11 +285,12 @@ async function generateBlogSitemap(siteUrl) {
     });
   });
   slugs.forEach((post) => {
+    const isPillar = post.article_type === "pillar";
     entries.push({
       url: `${siteUrl}/blog/${post.slug}`,
       lastModified: post.last_modified ? new Date(post.last_modified) : void 0,
-      changeFrequency: "weekly",
-      priority: 0.7
+      changeFrequency: isPillar ? "weekly" : "monthly",
+      priority: isPillar ? 0.9 : 0.7
     });
   });
   return entries;
@@ -534,23 +543,83 @@ async function generateAtomFeed(options) {
   atom += `</feed>`;
   return atom;
 }
-async function getPostsByCategory(categorySlug) {
+async function getTopicClusters() {
   const { apiUrl, apiKey } = getConfig();
   if (!apiKey) return [];
   try {
-    const response = await fetch(`${apiUrl}/public/blog/posts?category=${categorySlug}&limit=50`, {
+    const response = await fetch(`${apiUrl}/public/blog/clusters`, {
       headers: { "x-api-key": apiKey },
       next: { revalidate: 300 }
     });
     if (!response.ok) return [];
     const data = await response.json();
-    return data.posts || [];
+    return (data.clusters || []).map((c) => ({
+      id: c.id,
+      cluster_name: c.cluster_name,
+      cluster_slug: c.cluster_slug,
+      core_topic: c.core_topic,
+      primary_entity: c.primary_entity,
+      industry: c.industry,
+      geo_target: c.geo_target,
+      commercial_goal: c.commercial_goal,
+      pillar_post_id: c.pillar_post_id,
+      target_service_page: c.target_service_page,
+      article_count: c.article_count,
+      pillar: null,
+      supports: [],
+      interlink_map: []
+    }));
   } catch (error) {
-    console.error("[Blog] Error fetching category posts:", error);
+    console.error("[Blog] Error fetching topic clusters:", error);
     return [];
   }
 }
+async function getTopicCluster(slug) {
+  const { apiUrl, apiKey } = getConfig();
+  if (!apiKey) return null;
+  try {
+    const response = await fetch(`${apiUrl}/public/blog/clusters/${slug}`, {
+      headers: { "x-api-key": apiKey },
+      next: { revalidate: 300 }
+    });
+    if (!response.ok) return null;
+    const data = await response.json();
+    return {
+      id: data.id,
+      cluster_name: data.cluster_name,
+      cluster_slug: data.cluster_slug,
+      core_topic: data.core_topic,
+      primary_entity: data.primary_entity,
+      industry: data.industry,
+      geo_target: data.geo_target,
+      commercial_goal: data.commercial_goal,
+      pillar_post_id: data.pillar?.id,
+      target_service_page: data.target_service_page,
+      article_count: data.article_count,
+      pillar: data.pillar || null,
+      supports: data.supports || [],
+      interlink_map: data.interlink_map || []
+    };
+  } catch (error) {
+    console.error("[Blog] Error fetching topic cluster:", error);
+    return null;
+  }
+}
+function getClusterNavigation(post) {
+  if (!post.cluster_id && !post.cluster_slug) return null;
+  const isPillar = post.article_type === "pillar";
+  return {
+    cluster_name: post.cluster_name || "",
+    cluster_slug: post.cluster_slug || "",
+    pillar: isPillar ? null : post.parent_pillar_slug ? { slug: post.parent_pillar_slug, title: post.parent_pillar_title || "" } : null,
+    siblings: post.sibling_articles || [],
+    is_pillar: isPillar
+  };
+}
 async function identifyTopicClusters(categorySlug) {
+  console.warn(
+    "[Blog] identifyTopicClusters() is deprecated. Use getTopicCluster(slug) for real cluster data managed in the Sonor dashboard."
+  );
   const posts = await getPostsByCategory(categorySlug);
   if (posts.length < 3) return null;
   const sortedByLength = [...posts].sort((a, b) => (b.word_count || 0) - (a.word_count || 0));
@@ -558,23 +627,158 @@ async function identifyTopicClusters(categorySlug) {
   const supportingPosts = sortedByLength.slice(1);
   const internalLinks = [];
   for (const support of supportingPosts) {
-    internalLinks.push({
-      from: pillar.slug,
-      to: support.slug,
-      anchor: support.title
-    });
+    internalLinks.push({ from: pillar.slug, to: support.slug, anchor: support.title });
+    internalLinks.push({ from: support.slug, to: pillar.slug, anchor: pillar.title });
   }
-  for (const support of supportingPosts) {
-    internalLinks.push({
-      from: support.slug,
-      to: pillar.slug,
-      anchor: pillar.title
+  return { pillar, supportingPosts, internalLinks };
+}
+async function getPostsByCategory(categorySlug) {
+  const { apiUrl, apiKey } = getConfig();
+  if (!apiKey) return [];
+  try {
+    const response = await fetch(`${apiUrl}/public/blog/posts?category=${categorySlug}&limit=50`, {
+      headers: { "x-api-key": apiKey },
+      next: { revalidate: 300 }
     });
+    if (!response.ok) return [];
+    const data = await response.json();
+    return data.posts || [];
+  } catch (error) {
+    console.error("[Blog] Error fetching category posts:", error);
+    return [];
+  }
+}
+function generateClusterItemListSchema(cluster, options = {}) {
+  const { siteUrl = "", basePath = "/blog" } = options;
+  return {
+    "@context": "https://schema.org",
+    "@type": "ItemList",
+    name: cluster.cluster_name,
+    description: `Articles about ${cluster.core_topic}`,
+    numberOfItems: cluster.supports.length,
+    itemListElement: cluster.supports.map((post, i) => ({
+      "@type": "ListItem",
+      position: i + 1,
+      name: post.title,
+      url: `${siteUrl}${basePath}/${post.slug}`
+    }))
+  };
+}
+function generateClusterArticleSchema(post, cluster, options = {}) {
+  const { siteUrl = "", basePath = "/blog", siteName, logoUrl } = options;
+  const isPillar = post.article_type === "pillar";
+  const schema = {
+    "@context": "https://schema.org",
+    "@type": "Article",
+    headline: post.title,
+    description: post.excerpt || post.meta_description,
+    url: `${siteUrl}${basePath}/${post.slug}`,
+    datePublished: post.published_at,
+    dateModified: post.updated_at,
+    author: {
+      "@type": "Person",
+      name: typeof post.author === "string" ? post.author : post.author?.name
+    },
+    keywords: post.focus_keyphrase || post.keywords
+  };
+  if (post.featured_image) {
+    schema.image = {
+      "@type": "ImageObject",
+      url: post.featured_image,
+      width: post.featured_image_width || 1200,
+      height: post.featured_image_height || 630
+    };
   }
+  if (siteName || logoUrl) {
+    schema.publisher = {
+      "@type": "Organization",
+      name: siteName,
+      ...logoUrl && { logo: { "@type": "ImageObject", url: logoUrl } }
+    };
+  }
+  if (isPillar && cluster.supports.length > 0) {
+    schema.hasPart = cluster.supports.map((s) => ({
+      "@type": "Article",
+      headline: s.title,
+      url: `${siteUrl}${basePath}/${s.slug}`
+    }));
+  } else if (!isPillar && cluster.pillar) {
+    schema.isPartOf = {
+      "@type": "Article",
+      headline: cluster.pillar.title,
+      url: `${siteUrl}${basePath}/${cluster.pillar.slug}`
+    };
+  }
+  if (cluster.geo_target) {
+    schema.spatialCoverage = {
+      "@type": "Place",
+      name: cluster.geo_target
+    };
+  }
+  return schema;
+}
+function generateClusterBreadcrumbSchema(post, cluster, options = {}) {
+  const { siteUrl = "", siteName = "Home", basePath = "/blog" } = options;
+  const items = [
+    { "@type": "ListItem", position: 1, name: siteName, item: siteUrl },
+    { "@type": "ListItem", position: 2, name: "Blog", item: `${siteUrl}${basePath}` },
+    {
+      "@type": "ListItem",
+      position: 3,
+      name: cluster.cluster_name,
+      item: `${siteUrl}${basePath}/cluster/${cluster.cluster_slug}`
+    },
+    {
+      "@type": "ListItem",
+      position: 4,
+      name: post.title,
+      item: `${siteUrl}${basePath}/${post.slug}`
+    }
+  ];
+  return {
+    "@context": "https://schema.org",
+    "@type": "BreadcrumbList",
+    itemListElement: items
+  };
+}
+function generateClusterLandingSchema(cluster, options = {}) {
+  const { siteUrl = "", basePath = "/blog", siteName } = options;
+  return {
+    "@context": "https://schema.org",
+    "@type": "CollectionPage",
+    name: cluster.cluster_name,
+    description: `Comprehensive guide to ${cluster.core_topic}`,
+    url: `${siteUrl}${basePath}/cluster/${cluster.cluster_slug}`,
+    ...siteName && {
+      isPartOf: { "@type": "WebSite", name: siteName, url: siteUrl }
+    },
+    mainEntity: cluster.pillar ? {
+      "@type": "Article",
+      headline: cluster.pillar.title,
+      url: `${siteUrl}${basePath}/${cluster.pillar.slug}`
+    } : void 0,
+    hasPart: cluster.supports.map((s) => ({
+      "@type": "Article",
+      headline: s.title,
+      url: `${siteUrl}${basePath}/${s.slug}`
+    }))
+  };
+}
+async function generateClusterPageMetadata(clusterSlug, options = {}) {
+  const cluster = await getTopicCluster(clusterSlug);
+  if (!cluster) return {};
+  const { siteName = "", siteUrl = "", basePath = "/blog" } = options;
+  const title = `${cluster.cluster_name}${siteName ? ` | ${siteName}` : ""}`;
+  const description = `Comprehensive guide to ${cluster.core_topic}. ${cluster.article_count} articles covering everything you need to know.`;
   return {
-    pillar,
-    supportingPosts,
-    internalLinks
+    title,
+    description,
+    openGraph: {
+      title,
+      description,
+      url: `${siteUrl}${basePath}/cluster/${cluster.cluster_slug}`,
+      type: "website"
+    }
   };
 }
 async function getRelatedInsights(currentSlug, options = {}) {
@@ -794,6 +998,6 @@ function generateAuthorSchema(author, options = {}) {
   return schema;
 }
 
-export { SEO_LIMITS, generateAllBlogSchemas, generateAtomFeed, generateAuthorPageMetadata, generateAuthorSchema, generateAuthorStaticParams, generateBlogCategoryMetadata, generateBlogIndexMetadata, generateBlogListSchema, generateBlogPostMetadata, generateBlogPostSchema, generateBlogSitemap, generateBlogStaticParams, generateBreadcrumbSchema, generateCategoryStaticParams, generateFaqSchema, generateHowToSchema, generateRssFeed, getAllAuthorSlugs, getAllBlogPosts, getAllBlogSlugs, getAuthorBySlug, getAuthorPosts, getBlogCategories, getBlogPost, getPostsByCategory, getRelatedInsights, identifyTopicClusters, validateBlogPostSeo, validateMetaDescription, validateSeoTitle };
-//# sourceMappingURL=chunk-WRCX2NKY.mjs.map
-//# sourceMappingURL=chunk-WRCX2NKY.mjs.map
+export { SEO_LIMITS, generateAllBlogSchemas, generateAtomFeed, generateAuthorPageMetadata, generateAuthorSchema, generateAuthorStaticParams, generateBlogCategoryMetadata, generateBlogIndexMetadata, generateBlogListSchema, generateBlogPostMetadata, generateBlogPostSchema, generateBlogSitemap, generateBlogStaticParams, generateBreadcrumbSchema, generateCategoryStaticParams, generateClusterArticleSchema, generateClusterBreadcrumbSchema, generateClusterItemListSchema, generateClusterLandingSchema, generateClusterPageMetadata, generateFaqSchema, generateHowToSchema, generateRssFeed, getAllAuthorSlugs, getAllBlogPosts, getAllBlogSlugs, getAuthorBySlug, getAuthorPosts, getBlogCategories, getBlogPost, getClusterNavigation, getPostsByCategory, getRelatedInsights, getTopicCluster, getTopicClusters, identifyTopicClusters, validateBlogPostSeo, validateMetaDescription, validateSeoTitle };
+//# sourceMappingURL=chunk-2NM6RGAV.mjs.map
+//# sourceMappingURL=chunk-2NM6RGAV.mjs.map