@xexr/blog-platform 1.0.14 → 1.0.16

package/dist/lib/related-articles.d.mts

@@ -0,0 +1,17 @@
+import { P as PublishedTopic, a as PublishedArticle } from '../index-Dr8HaKGm.mjs';
+
+interface RelatedArticleCandidate {
+    readonly id: string;
+    readonly slug: string;
+    readonly title?: string;
+    readonly publishedAt: string;
+    readonly updatedAt?: string;
+    readonly topics?: readonly PublishedTopic[];
+}
+interface RelatedFeaturedArticlesOptions {
+    readonly limit?: number;
+}
+declare function getRelatedFeaturedArticles<TArticle extends RelatedArticleCandidate>(currentArticle: RelatedArticleCandidate, articles: readonly TArticle[], options?: RelatedFeaturedArticlesOptions): TArticle[];
+type RelatedPublishedArticle = PublishedArticle;
+
+export { type RelatedArticleCandidate, type RelatedFeaturedArticlesOptions, type RelatedPublishedArticle, getRelatedFeaturedArticles };

package/dist/lib/related-articles.d.ts

@@ -0,0 +1,17 @@
+import { P as PublishedTopic, a as PublishedArticle } from '../index-Dr8HaKGm.js';
+
+interface RelatedArticleCandidate {
+    readonly id: string;
+    readonly slug: string;
+    readonly title?: string;
+    readonly publishedAt: string;
+    readonly updatedAt?: string;
+    readonly topics?: readonly PublishedTopic[];
+}
+interface RelatedFeaturedArticlesOptions {
+    readonly limit?: number;
+}
+declare function getRelatedFeaturedArticles<TArticle extends RelatedArticleCandidate>(currentArticle: RelatedArticleCandidate, articles: readonly TArticle[], options?: RelatedFeaturedArticlesOptions): TArticle[];
+type RelatedPublishedArticle = PublishedArticle;
+
+export { type RelatedArticleCandidate, type RelatedFeaturedArticlesOptions, type RelatedPublishedArticle, getRelatedFeaturedArticles };

package/dist/lib/related-articles.js

@@ -0,0 +1,2 @@
+'use strict';function m(e,i,r={}){let n=r.limit??3;if(n<=0)return [];let s=o(e),t=T(e,i),d=(l,c)=>u(c)-u(l)||A(l).localeCompare(A(c)),a=s?t.filter(l=>o(l)===s).sort(d):[],p=new Set(a.map(l=>l.id)),g=t.filter(l=>!p.has(l.id)).sort(d);return [...a,...g].slice(0,n)}function T(e,i){let r=new Set,n=new Set,s=[];for(let t of i)t.id===e.id||t.slug===e.slug||r.has(t.id)||n.has(t.slug)||(r.add(t.id),n.add(t.slug),s.push(t));return s}function o(e){let i=e.topics??[];return i.find(r=>r.isPrimary)?.slug??i[0]?.slug??null}function u(e){let i=Date.parse(e.publishedAt??e.updatedAt??"");return Number.isFinite(i)?i:0}function A(e){return e.title??e.slug}exports.getRelatedFeaturedArticles=m;//# sourceMappingURL=related-articles.js.map
+//# sourceMappingURL=related-articles.js.map

package/dist/lib/related-articles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/related-articles.ts"],"names":["getRelatedFeaturedArticles","currentArticle","articles","options","limit","currentPrimaryTopicSlug","getPrimaryTopicSlug","eligibleArticles","getUniqueEligibleArticles","byNewest","a","b","getArticleTime","getArticleTitle","samePrimaryTopic","article","sameTopicIds","fallbackArticles","seenIds","seenSlugs","uniqueArticles","topics","topic","timestamp"],"mappings":"aAiBO,SAASA,CAAAA,CAGdC,EACAC,CAAAA,CACAC,CAAAA,CAA0C,EAAC,CAC/B,CACZ,IAAMC,CAAAA,CAAQD,CAAAA,CAAQ,KAAA,EAAS,EAC/B,GAAIC,CAAAA,EAAS,EAAG,OAAO,GAEvB,IAAMC,CAAAA,CAA0BC,CAAAA,CAAoBL,CAAc,CAAA,CAC5DM,CAAAA,CAAmBC,EAA0BP,CAAAA,CAAgBC,CAAQ,EACrEO,CAAAA,CAAW,CAACC,EAAaC,CAAAA,GAC7BC,CAAAA,CAAeD,CAAC,CAAA,CAAIC,CAAAA,CAAeF,CAAC,GAAKG,CAAAA,CAAgBH,CAAC,EAAE,aAAA,CAAcG,CAAAA,CAAgBF,CAAC,CAAC,CAAA,CAExFG,CAAAA,CAAmBT,CAAAA,CACrBE,CAAAA,CACG,MAAA,CACEQ,GAAYT,CAAAA,CAAoBS,CAAO,IAAMV,CAChD,CAAA,CACC,KAAKI,CAAQ,CAAA,CAChB,EAAC,CAECO,CAAAA,CAAe,IAAI,IAAIF,CAAAA,CAAiB,GAAA,CAAKC,GAAYA,CAAAA,CAAQ,EAAE,CAAC,CAAA,CACpEE,CAAAA,CAAmBV,CAAAA,CACtB,MAAA,CAAQQ,CAAAA,EAAY,CAACC,EAAa,GAAA,CAAID,CAAAA,CAAQ,EAAE,CAAC,CAAA,CACjD,KAAKN,CAAQ,CAAA,CAEhB,OAAO,CAAC,GAAGK,CAAAA,CAAkB,GAAGG,CAAgB,CAAA,CAAE,MAAM,CAAA,CAAGb,CAAK,CAClE,CAEA,SAASI,CAAAA,CACPP,CAAAA,CACAC,CAAAA,CACY,CACZ,IAAMgB,CAAAA,CAAU,IAAI,IACdC,CAAAA,CAAY,IAAI,IAChBC,CAAAA,CAA6B,EAAC,CAEpC,IAAA,IAAWL,CAAAA,IAAWb,CAAAA,CAChBa,EAAQ,EAAA,GAAOd,CAAAA,CAAe,IAAMc,CAAAA,CAAQ,IAAA,GAASd,EAAe,IAAA,EAIpEiB,CAAAA,CAAQ,GAAA,CAAIH,CAAAA,CAAQ,EAAE,CAAA,EAAKI,EAAU,GAAA,CAAIJ,CAAAA,CAAQ,IAAI,CAAA,GAIzDG,CAAAA,CAAQ,IAAIH,CAAAA,CAAQ,EAAE,CAAA,CACtBI,CAAAA,CAAU,GAAA,CAAIJ,CAAAA,CAAQ,IAAI,CAAA,CAC1BK,CAAAA,CAAe,KAAKL,CAAO,CAAA,CAAA,CAG7B,OAAOK,CACT,CAEA,SAASd,CAAAA,CAAoBS,CAAAA,CAAiD,CAC5E,IAAMM,CAAAA,CAASN,CAAAA,CAAQ,QAAU,EAAC,CAClC,OACEM,CAAAA,CAAO,IAAA,CAAMC,CAAAA,EAAUA,CAAAA,CAAM,SAAS,CAAA,EAAG,MAAQD,CAAAA,CAAO,CAAC,GAAG,IAAA,EAAQ,IAExE,CAEA,SAAST,CAAAA,CAAeG,CAAAA,CAA0C,CAChE,IAAMQ,CAAAA,CAAY,KAAK,KAAA,CAAMR,CAAAA,CAAQ,aAAeA,CAAAA,CAAQ,SAAA,EAAa,EAAE,CAAA,CAC3E,OAAO,MAAA,CAAO,QAAA,CAASQ,CAAS,CAAA,CAAIA,EAAY,CAClD,CAEA,SAASV,CAAAA,CAAgBE,CAAAA,CAA0C,CACjE,OAAOA,CAAAA,CAAQ,KAAA,EAASA,CAAAA,CAAQ,IAClC","file":"related-articles.js","sourcesContent":["import type { PublishedArticle, PublishedTopic } from \"../types/contracts\";\n\nexport interface RelatedArticleCandidate {\n  readonly id: string;\n  readonly slug: string;\n  readonly title?: string;\n  readonly publishedAt: string;\n  readonly updatedAt?: string;\n  readonly topics?: readonly PublishedTopic[];\n}\n\nexport interface RelatedFeaturedArticlesOptions {\n  readonly limit?: number;\n}\n\nconst DEFAULT_RELATED_ARTICLE_LIMIT = 3;\n\nexport function getRelatedFeaturedArticles<\n  TArticle extends RelatedArticleCandidate,\n>(\n  currentArticle: RelatedArticleCandidate,\n  articles: readonly TArticle[],\n  options: RelatedFeaturedArticlesOptions = {},\n): TArticle[] {\n  const limit = options.limit ?? DEFAULT_RELATED_ARTICLE_LIMIT;\n  if (limit <= 0) return [];\n\n  const currentPrimaryTopicSlug = getPrimaryTopicSlug(currentArticle);\n  const eligibleArticles = getUniqueEligibleArticles(currentArticle, articles);\n  const byNewest = (a: TArticle, b: TArticle) =>\n    getArticleTime(b) - getArticleTime(a) || getArticleTitle(a).localeCompare(getArticleTitle(b));\n\n  const samePrimaryTopic = currentPrimaryTopicSlug\n    ? eligibleArticles\n        .filter(\n          (article) => getPrimaryTopicSlug(article) === currentPrimaryTopicSlug,\n        )\n        .sort(byNewest)\n    : [];\n\n  const sameTopicIds = new Set(samePrimaryTopic.map((article) => article.id));\n  const fallbackArticles = eligibleArticles\n    .filter((article) => !sameTopicIds.has(article.id))\n    .sort(byNewest);\n\n  return [...samePrimaryTopic, ...fallbackArticles].slice(0, limit);\n}\n\nfunction getUniqueEligibleArticles<TArticle extends RelatedArticleCandidate>(\n  currentArticle: RelatedArticleCandidate,\n  articles: readonly TArticle[],\n): TArticle[] {\n  const seenIds = new Set<string>();\n  const seenSlugs = new Set<string>();\n  const uniqueArticles: TArticle[] = [];\n\n  for (const article of articles) {\n    if (article.id === currentArticle.id || article.slug === currentArticle.slug) {\n      continue;\n    }\n\n    if (seenIds.has(article.id) || seenSlugs.has(article.slug)) {\n      continue;\n    }\n\n    seenIds.add(article.id);\n    seenSlugs.add(article.slug);\n    uniqueArticles.push(article);\n  }\n\n  return uniqueArticles;\n}\n\nfunction getPrimaryTopicSlug(article: RelatedArticleCandidate): string | null {\n  const topics = article.topics ?? [];\n  return (\n    topics.find((topic) => topic.isPrimary)?.slug ?? topics[0]?.slug ?? null\n  );\n}\n\nfunction getArticleTime(article: RelatedArticleCandidate): number {\n  const timestamp = Date.parse(article.publishedAt ?? article.updatedAt ?? \"\");\n  return Number.isFinite(timestamp) ? timestamp : 0;\n}\n\nfunction getArticleTitle(article: RelatedArticleCandidate): string {\n  return article.title ?? article.slug;\n}\n\nexport type RelatedPublishedArticle = PublishedArticle;\n"]}

package/dist/lib/related-articles.mjs

@@ -0,0 +1,2 @@
+function m(e,i,r={}){let n=r.limit??3;if(n<=0)return [];let s=o(e),t=T(e,i),d=(l,c)=>u(c)-u(l)||A(l).localeCompare(A(c)),a=s?t.filter(l=>o(l)===s).sort(d):[],p=new Set(a.map(l=>l.id)),g=t.filter(l=>!p.has(l.id)).sort(d);return [...a,...g].slice(0,n)}function T(e,i){let r=new Set,n=new Set,s=[];for(let t of i)t.id===e.id||t.slug===e.slug||r.has(t.id)||n.has(t.slug)||(r.add(t.id),n.add(t.slug),s.push(t));return s}function o(e){let i=e.topics??[];return i.find(r=>r.isPrimary)?.slug??i[0]?.slug??null}function u(e){let i=Date.parse(e.publishedAt??e.updatedAt??"");return Number.isFinite(i)?i:0}function A(e){return e.title??e.slug}export{m as getRelatedFeaturedArticles};//# sourceMappingURL=related-articles.mjs.map
+//# sourceMappingURL=related-articles.mjs.map

package/dist/lib/related-articles.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/related-articles.ts"],"names":["getRelatedFeaturedArticles","currentArticle","articles","options","limit","currentPrimaryTopicSlug","getPrimaryTopicSlug","eligibleArticles","getUniqueEligibleArticles","byNewest","a","b","getArticleTime","getArticleTitle","samePrimaryTopic","article","sameTopicIds","fallbackArticles","seenIds","seenSlugs","uniqueArticles","topics","topic","timestamp"],"mappings":"AAiBO,SAASA,CAAAA,CAGdC,EACAC,CAAAA,CACAC,CAAAA,CAA0C,EAAC,CAC/B,CACZ,IAAMC,CAAAA,CAAQD,CAAAA,CAAQ,KAAA,EAAS,EAC/B,GAAIC,CAAAA,EAAS,EAAG,OAAO,GAEvB,IAAMC,CAAAA,CAA0BC,CAAAA,CAAoBL,CAAc,CAAA,CAC5DM,CAAAA,CAAmBC,EAA0BP,CAAAA,CAAgBC,CAAQ,EACrEO,CAAAA,CAAW,CAACC,EAAaC,CAAAA,GAC7BC,CAAAA,CAAeD,CAAC,CAAA,CAAIC,CAAAA,CAAeF,CAAC,GAAKG,CAAAA,CAAgBH,CAAC,EAAE,aAAA,CAAcG,CAAAA,CAAgBF,CAAC,CAAC,CAAA,CAExFG,CAAAA,CAAmBT,CAAAA,CACrBE,CAAAA,CACG,MAAA,CACEQ,GAAYT,CAAAA,CAAoBS,CAAO,IAAMV,CAChD,CAAA,CACC,KAAKI,CAAQ,CAAA,CAChB,EAAC,CAECO,CAAAA,CAAe,IAAI,IAAIF,CAAAA,CAAiB,GAAA,CAAKC,GAAYA,CAAAA,CAAQ,EAAE,CAAC,CAAA,CACpEE,CAAAA,CAAmBV,CAAAA,CACtB,MAAA,CAAQQ,CAAAA,EAAY,CAACC,EAAa,GAAA,CAAID,CAAAA,CAAQ,EAAE,CAAC,CAAA,CACjD,KAAKN,CAAQ,CAAA,CAEhB,OAAO,CAAC,GAAGK,CAAAA,CAAkB,GAAGG,CAAgB,CAAA,CAAE,MAAM,CAAA,CAAGb,CAAK,CAClE,CAEA,SAASI,CAAAA,CACPP,CAAAA,CACAC,CAAAA,CACY,CACZ,IAAMgB,CAAAA,CAAU,IAAI,IACdC,CAAAA,CAAY,IAAI,IAChBC,CAAAA,CAA6B,EAAC,CAEpC,IAAA,IAAWL,CAAAA,IAAWb,CAAAA,CAChBa,EAAQ,EAAA,GAAOd,CAAAA,CAAe,IAAMc,CAAAA,CAAQ,IAAA,GAASd,EAAe,IAAA,EAIpEiB,CAAAA,CAAQ,GAAA,CAAIH,CAAAA,CAAQ,EAAE,CAAA,EAAKI,EAAU,GAAA,CAAIJ,CAAAA,CAAQ,IAAI,CAAA,GAIzDG,CAAAA,CAAQ,IAAIH,CAAAA,CAAQ,EAAE,CAAA,CACtBI,CAAAA,CAAU,GAAA,CAAIJ,CAAAA,CAAQ,IAAI,CAAA,CAC1BK,CAAAA,CAAe,KAAKL,CAAO,CAAA,CAAA,CAG7B,OAAOK,CACT,CAEA,SAASd,CAAAA,CAAoBS,CAAAA,CAAiD,CAC5E,IAAMM,CAAAA,CAASN,CAAAA,CAAQ,QAAU,EAAC,CAClC,OACEM,CAAAA,CAAO,IAAA,CAAMC,CAAAA,EAAUA,CAAAA,CAAM,SAAS,CAAA,EAAG,MAAQD,CAAAA,CAAO,CAAC,GAAG,IAAA,EAAQ,IAExE,CAEA,SAAST,CAAAA,CAAeG,CAAAA,CAA0C,CAChE,IAAMQ,CAAAA,CAAY,KAAK,KAAA,CAAMR,CAAAA,CAAQ,aAAeA,CAAAA,CAAQ,SAAA,EAAa,EAAE,CAAA,CAC3E,OAAO,MAAA,CAAO,QAAA,CAASQ,CAAS,CAAA,CAAIA,EAAY,CAClD,CAEA,SAASV,CAAAA,CAAgBE,CAAAA,CAA0C,CACjE,OAAOA,CAAAA,CAAQ,KAAA,EAASA,CAAAA,CAAQ,IAClC","file":"related-articles.mjs","sourcesContent":["import type { PublishedArticle, PublishedTopic } from \"../types/contracts\";\n\nexport interface RelatedArticleCandidate {\n  readonly id: string;\n  readonly slug: string;\n  readonly title?: string;\n  readonly publishedAt: string;\n  readonly updatedAt?: string;\n  readonly topics?: readonly PublishedTopic[];\n}\n\nexport interface RelatedFeaturedArticlesOptions {\n  readonly limit?: number;\n}\n\nconst DEFAULT_RELATED_ARTICLE_LIMIT = 3;\n\nexport function getRelatedFeaturedArticles<\n  TArticle extends RelatedArticleCandidate,\n>(\n  currentArticle: RelatedArticleCandidate,\n  articles: readonly TArticle[],\n  options: RelatedFeaturedArticlesOptions = {},\n): TArticle[] {\n  const limit = options.limit ?? DEFAULT_RELATED_ARTICLE_LIMIT;\n  if (limit <= 0) return [];\n\n  const currentPrimaryTopicSlug = getPrimaryTopicSlug(currentArticle);\n  const eligibleArticles = getUniqueEligibleArticles(currentArticle, articles);\n  const byNewest = (a: TArticle, b: TArticle) =>\n    getArticleTime(b) - getArticleTime(a) || getArticleTitle(a).localeCompare(getArticleTitle(b));\n\n  const samePrimaryTopic = currentPrimaryTopicSlug\n    ? eligibleArticles\n        .filter(\n          (article) => getPrimaryTopicSlug(article) === currentPrimaryTopicSlug,\n        )\n        .sort(byNewest)\n    : [];\n\n  const sameTopicIds = new Set(samePrimaryTopic.map((article) => article.id));\n  const fallbackArticles = eligibleArticles\n    .filter((article) => !sameTopicIds.has(article.id))\n    .sort(byNewest);\n\n  return [...samePrimaryTopic, ...fallbackArticles].slice(0, limit);\n}\n\nfunction getUniqueEligibleArticles<TArticle extends RelatedArticleCandidate>(\n  currentArticle: RelatedArticleCandidate,\n  articles: readonly TArticle[],\n): TArticle[] {\n  const seenIds = new Set<string>();\n  const seenSlugs = new Set<string>();\n  const uniqueArticles: TArticle[] = [];\n\n  for (const article of articles) {\n    if (article.id === currentArticle.id || article.slug === currentArticle.slug) {\n      continue;\n    }\n\n    if (seenIds.has(article.id) || seenSlugs.has(article.slug)) {\n      continue;\n    }\n\n    seenIds.add(article.id);\n    seenSlugs.add(article.slug);\n    uniqueArticles.push(article);\n  }\n\n  return uniqueArticles;\n}\n\nfunction getPrimaryTopicSlug(article: RelatedArticleCandidate): string | null {\n  const topics = article.topics ?? [];\n  return (\n    topics.find((topic) => topic.isPrimary)?.slug ?? topics[0]?.slug ?? null\n  );\n}\n\nfunction getArticleTime(article: RelatedArticleCandidate): number {\n  const timestamp = Date.parse(article.publishedAt ?? article.updatedAt ?? \"\");\n  return Number.isFinite(timestamp) ? timestamp : 0;\n}\n\nfunction getArticleTitle(article: RelatedArticleCandidate): string {\n  return article.title ?? article.slug;\n}\n\nexport type RelatedPublishedArticle = PublishedArticle;\n"]}

package/dist/lib/related-articles.ts

@@ -0,0 +1,90 @@
+import type { PublishedArticle, PublishedTopic } from "../types/contracts";
+
+export interface RelatedArticleCandidate {
+  readonly id: string;
+  readonly slug: string;
+  readonly title?: string;
+  readonly publishedAt: string;
+  readonly updatedAt?: string;
+  readonly topics?: readonly PublishedTopic[];
+}
+
+export interface RelatedFeaturedArticlesOptions {
+  readonly limit?: number;
+}
+
+const DEFAULT_RELATED_ARTICLE_LIMIT = 3;
+
+export function getRelatedFeaturedArticles<
+  TArticle extends RelatedArticleCandidate,
+>(
+  currentArticle: RelatedArticleCandidate,
+  articles: readonly TArticle[],
+  options: RelatedFeaturedArticlesOptions = {},
+): TArticle[] {
+  const limit = options.limit ?? DEFAULT_RELATED_ARTICLE_LIMIT;
+  if (limit <= 0) return [];
+
+  const currentPrimaryTopicSlug = getPrimaryTopicSlug(currentArticle);
+  const eligibleArticles = getUniqueEligibleArticles(currentArticle, articles);
+  const byNewest = (a: TArticle, b: TArticle) =>
+    getArticleTime(b) - getArticleTime(a) || getArticleTitle(a).localeCompare(getArticleTitle(b));
+
+  const samePrimaryTopic = currentPrimaryTopicSlug
+    ? eligibleArticles
+        .filter(
+          (article) => getPrimaryTopicSlug(article) === currentPrimaryTopicSlug,
+        )
+        .sort(byNewest)
+    : [];
+
+  const sameTopicIds = new Set(samePrimaryTopic.map((article) => article.id));
+  const fallbackArticles = eligibleArticles
+    .filter((article) => !sameTopicIds.has(article.id))
+    .sort(byNewest);
+
+  return [...samePrimaryTopic, ...fallbackArticles].slice(0, limit);
+}
+
+function getUniqueEligibleArticles<TArticle extends RelatedArticleCandidate>(
+  currentArticle: RelatedArticleCandidate,
+  articles: readonly TArticle[],
+): TArticle[] {
+  const seenIds = new Set<string>();
+  const seenSlugs = new Set<string>();
+  const uniqueArticles: TArticle[] = [];
+
+  for (const article of articles) {
+    if (article.id === currentArticle.id || article.slug === currentArticle.slug) {
+      continue;
+    }
+
+    if (seenIds.has(article.id) || seenSlugs.has(article.slug)) {
+      continue;
+    }
+
+    seenIds.add(article.id);
+    seenSlugs.add(article.slug);
+    uniqueArticles.push(article);
+  }
+
+  return uniqueArticles;
+}
+
+function getPrimaryTopicSlug(article: RelatedArticleCandidate): string | null {
+  const topics = article.topics ?? [];
+  return (
+    topics.find((topic) => topic.isPrimary)?.slug ?? topics[0]?.slug ?? null
+  );
+}
+
+function getArticleTime(article: RelatedArticleCandidate): number {
+  const timestamp = Date.parse(article.publishedAt ?? article.updatedAt ?? "");
+  return Number.isFinite(timestamp) ? timestamp : 0;
+}
+
+function getArticleTitle(article: RelatedArticleCandidate): string {
+  return article.title ?? article.slug;
+}
+
+export type RelatedPublishedArticle = PublishedArticle;

package/dist/{sitemap-BPTdXb9C.d.ts → sitemap-BmCh8BpN.d.ts}

@@ -1,4 +1,4 @@
-import { PublishedArticle, PublishedSite, PublishedAuthor } from './types/index.js';
+import { a as PublishedArticle, b as PublishedSite, c as PublishedAuthor } from './index-Dr8HaKGm.js';
 
 /**
  * SEO utilities for canonical URL generation and validation.

package/dist/{sitemap-Dz9DB7py.d.mts → sitemap-Dbl4CUGI.d.mts}

@@ -1,4 +1,4 @@
-import { PublishedArticle, PublishedSite, PublishedAuthor } from './types/index.mjs';
+import { a as PublishedArticle, b as PublishedSite, c as PublishedAuthor } from './index-Dr8HaKGm.mjs';
 
 /**
  * SEO utilities for canonical URL generation and validation.

package/dist/sitemap.d.mts

@@ -1,2 +1,2 @@
-import './types/index.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, i as generateSitemap, j as generateSitemapIndex, s as sitemapToXml, v as validateSitemap } from './sitemap-Dz9DB7py.mjs';
+import './index-Dr8HaKGm.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, i as generateSitemap, j as generateSitemapIndex, s as sitemapToXml, v as validateSitemap } from './sitemap-Dbl4CUGI.mjs';

package/dist/sitemap.d.ts

@@ -1,2 +1,2 @@
-import './types/index.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, i as generateSitemap, j as generateSitemapIndex, s as sitemapToXml, v as validateSitemap } from './sitemap-BPTdXb9C.js';
+import './index-Dr8HaKGm.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, i as generateSitemap, j as generateSitemapIndex, s as sitemapToXml, v as validateSitemap } from './sitemap-BmCh8BpN.js';

package/dist/types/contracts.ts

@@ -115,6 +115,34 @@ export interface PublishedNewsletterSettings {
   readonly publicSubscribeToken: string;
 }
 
+/**
+ * Public post-article CTA configuration.
+ */
+export interface PublishedArticleCta {
+  /** CTA heading */
+  readonly title: string;
+
+  /** Optional supporting copy */
+  readonly description?: string;
+
+  /** Primary sign-up action */
+  readonly primary?: PublishedArticleCtaAction;
+
+  /** Secondary learn-more action */
+  readonly secondary?: PublishedArticleCtaAction;
+}
+
+/**
+ * Public post-article CTA link.
+ */
+export interface PublishedArticleCtaAction {
+  /** Button label */
+  readonly label: string;
+
+  /** Safe http(s) URL or same-site relative path */
+  readonly href: string;
+}
+
 /**
  * Public topic/category taxonomy assigned to published articles.
  */
@@ -173,6 +201,9 @@ export interface PublishedArticle {
   /** Site information */
   readonly site: PublishedSite;
 
+  /** Optional post-article call-to-action */
+  readonly cta?: PublishedArticleCta;
+
   /** Public topic taxonomy assigned to the article */
   readonly topics?: readonly PublishedTopic[];
 

package/dist/types/index.d.mts

@@ -1,205 +1 @@
-/**
- * Public API contracts for the @xexr/blog-platform package.
- *
- * These types define the public interface between Bloggy and external blog platforms.
- * They must remain stable and backward-compatible to ensure smooth upgrades.
- *
- * IMPORTANT: These contracts should never import from the main Bloggy application
- * to maintain clean separation of concerns and prevent coupling.
- */
-/**
- * Public profile and social links for an author.
- */
-interface PublishedAuthorSocialLinks {
-    /** Author website or profile URL */
-    readonly website?: string;
-    /** X/Twitter profile URL */
-    readonly x?: string;
-    /** Legacy Twitter profile URL */
-    readonly twitter?: string;
-    /** LinkedIn profile URL */
-    readonly linkedin?: string;
-    /** GitHub profile URL */
-    readonly github?: string;
-    /** Public contact email address */
-    readonly email?: string;
-}
-/**
- * Represents a published author with essential information for bylines and attribution.
- */
-interface PublishedAuthor {
-    /** Unique identifier for the author */
-    readonly id: string;
-    /** Author's full name */
-    readonly name: string;
-    /** URL-friendly slug for author pages */
-    readonly slug: string;
-    /** Author's bio/description (optional) */
-    readonly bio?: string;
-    /** Author avatar image URL (optional) */
-    readonly avatarUrl?: string;
-    /** Public profile and social links (optional) */
-    readonly socialLinks?: PublishedAuthorSocialLinks;
-    /** Pronouns for proper attribution */
-    readonly pronouns?: string;
-    /** Whether this is a guest author */
-    readonly isGuest: boolean;
-    /** Tone adjectives that describe this author's writing style */
-    readonly toneAdjectives: readonly string[];
-}
-/**
- * Represents a published site with essential metadata for blog rendering.
- */
-interface PublishedSite {
-    /** Unique identifier for the site */
-    readonly id: string;
-    /** Site name/title */
-    readonly name: string;
-    /** Site tagline/subtitle */
-    readonly tagline: string;
-    /** Site description */
-    readonly description: string;
-    /** Primary domain for the site */
-    readonly domain: string;
-    /** Site-wide tone adjectives for content context */
-    readonly toneAdjectives: readonly string[];
-    /** Default locale/language code */
-    readonly locale: string;
-    /** Optional Bloggy-owned newsletter capture configuration */
-    readonly newsletter?: PublishedNewsletterSettings;
-}
-/**
- * Public configuration for Bloggy-owned newsletter capture.
- */
-interface PublishedNewsletterSettings {
-    /** Whether the capture form should render */
-    readonly enabled: boolean;
-    /** Form heading */
-    readonly title: string;
-    /** Form supporting copy */
-    readonly description: string;
-    /** Submit button label */
-    readonly buttonLabel: string;
-    /** Base URL for the Bloggy instance that receives subscriptions */
-    readonly captureBaseUrl: string;
-    /** Site-scoped public token used to validate public submissions */
-    readonly publicSubscribeToken: string;
-}
-/**
- * Public topic/category taxonomy assigned to published articles.
- */
-interface PublishedTopic {
-    /** Unique identifier for the topic */
-    readonly id: string;
-    /** Display name */
-    readonly name: string;
-    /** URL-friendly slug for topic archive routing */
-    readonly slug: string;
-    /** Optional public description */
-    readonly description?: string;
-    /** Whether this is the article's primary topic */
-    readonly isPrimary: boolean;
-}
-/**
- * Represents a published article with all necessary metadata for rendering
- * on external blog platforms.
- */
-interface PublishedArticle {
-    /** Unique identifier for the article */
-    readonly id: string;
-    /** URL-friendly slug for routing */
-    readonly slug: string;
-    /** Article title/headline */
-    readonly title: string;
-    /** Brief excerpt/summary for meta descriptions and previews */
-    readonly excerpt: string;
-    /** Full article content in markdown format */
-    readonly content: string;
-    /** Estimated reading time in seconds */
-    readonly readingSeconds: number;
-    /** Word count for analytics */
-    readonly wordCount: number;
-    /** Publication date as ISO 8601 string */
-    readonly publishedAt: string;
-    /** Last updated date as ISO 8601 string */
-    readonly updatedAt: string;
-    /** Author information (can be null for anonymous posts) */
-    readonly author: PublishedAuthor | null;
-    /** Site information */
-    readonly site: PublishedSite;
-    /** Public topic taxonomy assigned to the article */
-    readonly topics?: readonly PublishedTopic[];
-    /** Featured image URL (optional) */
-    readonly featuredImage?: string;
-    /** Alt text for featured image */
-    readonly featuredImageAlt?: string;
-    /** Caption displayed with the featured image */
-    readonly featuredImageCaption?: string;
-    /** Credit text displayed with the featured image */
-    readonly featuredImageCreditText?: string;
-    /** Optional URL for the featured image credit */
-    readonly featuredImageCreditUrl?: string;
-    /** Featured image R2 key for CDN optimization (optional) */
-    readonly featuredImageKey?: string;
-    /** SEO meta tags */
-    readonly meta: {
-        /** Meta title (defaults to article title if not provided) */
-        readonly title?: string;
-        /** Meta description (defaults to excerpt if not provided) */
-        readonly description?: string;
-        /** Canonical URL for SEO */
-        readonly canonicalUrl?: string;
-        /** Keywords for SEO */
-        readonly keywords: readonly string[];
-        /** Open Graph image URL */
-        readonly ogImage?: string;
-    };
-    /** Article version for optimistic locking */
-    readonly version: number;
-}
-/**
- * Payload structure for publishing operations.
- * Used when sending publish/unpublish requests to blog platforms.
- */
-interface PublishPayload {
-    /** The article to publish */
-    readonly article: PublishedArticle;
-    /** Idempotency key to prevent duplicate operations */
-    readonly idempotencyKey: string;
-    /** Optional slug override (defaults to article.slug) */
-    readonly slug?: string;
-    /** Optional meta description override (defaults to article.excerpt) */
-    readonly metaDescription?: string;
-    /** Platform-specific configuration */
-    readonly platformConfig?: Record<string, unknown>;
-    /** Whether this is a dry run (validation only) */
-    readonly dryRun?: boolean;
-}
-/**
- * Result structure returned from publishing operations.
- */
-interface PublishResult {
-    /** Whether the operation was successful */
-    readonly success: boolean;
-    /** The published article URL if successful */
-    readonly url?: string;
-    /** Platform-specific post ID */
-    readonly platformPostId?: string;
-    /** Publication timestamp as ISO 8601 string */
-    readonly publishedAt?: string;
-    /** Error information if unsuccessful */
-    readonly error?: {
-        /** Error code (PUB001-PUB011) */
-        readonly code: string;
-        /** Human-readable error message */
-        readonly message: string;
-        /** Additional error details */
-        readonly details?: Record<string, unknown>;
-    };
-    /** Validation warnings (for dry runs or minor issues) */
-    readonly warnings?: readonly string[];
-    /** Idempotency key used for this operation */
-    readonly idempotencyKey: string;
-}
-
-export type { PublishPayload, PublishResult, PublishedArticle, PublishedAuthor, PublishedAuthorSocialLinks, PublishedNewsletterSettings, PublishedSite, PublishedTopic };
+export { g as PublishPayload, f as PublishResult, a as PublishedArticle, c as PublishedAuthor, h as PublishedAuthorSocialLinks, d as PublishedNewsletterSettings, b as PublishedSite, P as PublishedTopic } from '../index-Dr8HaKGm.mjs';

package/dist/types/index.d.ts

@@ -1,205 +1 @@
-/**
- * Public API contracts for the @xexr/blog-platform package.
- *
- * These types define the public interface between Bloggy and external blog platforms.
- * They must remain stable and backward-compatible to ensure smooth upgrades.
- *
- * IMPORTANT: These contracts should never import from the main Bloggy application
- * to maintain clean separation of concerns and prevent coupling.
- */
-/**
- * Public profile and social links for an author.
- */
-interface PublishedAuthorSocialLinks {
-    /** Author website or profile URL */
-    readonly website?: string;
-    /** X/Twitter profile URL */
-    readonly x?: string;
-    /** Legacy Twitter profile URL */
-    readonly twitter?: string;
-    /** LinkedIn profile URL */
-    readonly linkedin?: string;
-    /** GitHub profile URL */
-    readonly github?: string;
-    /** Public contact email address */
-    readonly email?: string;
-}
-/**
- * Represents a published author with essential information for bylines and attribution.
- */
-interface PublishedAuthor {
-    /** Unique identifier for the author */
-    readonly id: string;
-    /** Author's full name */
-    readonly name: string;
-    /** URL-friendly slug for author pages */
-    readonly slug: string;
-    /** Author's bio/description (optional) */
-    readonly bio?: string;
-    /** Author avatar image URL (optional) */
-    readonly avatarUrl?: string;
-    /** Public profile and social links (optional) */
-    readonly socialLinks?: PublishedAuthorSocialLinks;
-    /** Pronouns for proper attribution */
-    readonly pronouns?: string;
-    /** Whether this is a guest author */
-    readonly isGuest: boolean;
-    /** Tone adjectives that describe this author's writing style */
-    readonly toneAdjectives: readonly string[];
-}
-/**
- * Represents a published site with essential metadata for blog rendering.
- */
-interface PublishedSite {
-    /** Unique identifier for the site */
-    readonly id: string;
-    /** Site name/title */
-    readonly name: string;
-    /** Site tagline/subtitle */
-    readonly tagline: string;
-    /** Site description */
-    readonly description: string;
-    /** Primary domain for the site */
-    readonly domain: string;
-    /** Site-wide tone adjectives for content context */
-    readonly toneAdjectives: readonly string[];
-    /** Default locale/language code */
-    readonly locale: string;
-    /** Optional Bloggy-owned newsletter capture configuration */
-    readonly newsletter?: PublishedNewsletterSettings;
-}
-/**
- * Public configuration for Bloggy-owned newsletter capture.
- */
-interface PublishedNewsletterSettings {
-    /** Whether the capture form should render */
-    readonly enabled: boolean;
-    /** Form heading */
-    readonly title: string;
-    /** Form supporting copy */
-    readonly description: string;
-    /** Submit button label */
-    readonly buttonLabel: string;
-    /** Base URL for the Bloggy instance that receives subscriptions */
-    readonly captureBaseUrl: string;
-    /** Site-scoped public token used to validate public submissions */
-    readonly publicSubscribeToken: string;
-}
-/**
- * Public topic/category taxonomy assigned to published articles.
- */
-interface PublishedTopic {
-    /** Unique identifier for the topic */
-    readonly id: string;
-    /** Display name */
-    readonly name: string;
-    /** URL-friendly slug for topic archive routing */
-    readonly slug: string;
-    /** Optional public description */
-    readonly description?: string;
-    /** Whether this is the article's primary topic */
-    readonly isPrimary: boolean;
-}
-/**
- * Represents a published article with all necessary metadata for rendering
- * on external blog platforms.
- */
-interface PublishedArticle {
-    /** Unique identifier for the article */
-    readonly id: string;
-    /** URL-friendly slug for routing */
-    readonly slug: string;
-    /** Article title/headline */
-    readonly title: string;
-    /** Brief excerpt/summary for meta descriptions and previews */
-    readonly excerpt: string;
-    /** Full article content in markdown format */
-    readonly content: string;
-    /** Estimated reading time in seconds */
-    readonly readingSeconds: number;
-    /** Word count for analytics */
-    readonly wordCount: number;
-    /** Publication date as ISO 8601 string */
-    readonly publishedAt: string;
-    /** Last updated date as ISO 8601 string */
-    readonly updatedAt: string;
-    /** Author information (can be null for anonymous posts) */
-    readonly author: PublishedAuthor | null;
-    /** Site information */
-    readonly site: PublishedSite;
-    /** Public topic taxonomy assigned to the article */
-    readonly topics?: readonly PublishedTopic[];
-    /** Featured image URL (optional) */
-    readonly featuredImage?: string;
-    /** Alt text for featured image */
-    readonly featuredImageAlt?: string;
-    /** Caption displayed with the featured image */
-    readonly featuredImageCaption?: string;
-    /** Credit text displayed with the featured image */
-    readonly featuredImageCreditText?: string;
-    /** Optional URL for the featured image credit */
-    readonly featuredImageCreditUrl?: string;
-    /** Featured image R2 key for CDN optimization (optional) */
-    readonly featuredImageKey?: string;
-    /** SEO meta tags */
-    readonly meta: {
-        /** Meta title (defaults to article title if not provided) */
-        readonly title?: string;
-        /** Meta description (defaults to excerpt if not provided) */
-        readonly description?: string;
-        /** Canonical URL for SEO */
-        readonly canonicalUrl?: string;
-        /** Keywords for SEO */
-        readonly keywords: readonly string[];
-        /** Open Graph image URL */
-        readonly ogImage?: string;
-    };
-    /** Article version for optimistic locking */
-    readonly version: number;
-}
-/**
- * Payload structure for publishing operations.
- * Used when sending publish/unpublish requests to blog platforms.
- */
-interface PublishPayload {
-    /** The article to publish */
-    readonly article: PublishedArticle;
-    /** Idempotency key to prevent duplicate operations */
-    readonly idempotencyKey: string;
-    /** Optional slug override (defaults to article.slug) */
-    readonly slug?: string;
-    /** Optional meta description override (defaults to article.excerpt) */
-    readonly metaDescription?: string;
-    /** Platform-specific configuration */
-    readonly platformConfig?: Record<string, unknown>;
-    /** Whether this is a dry run (validation only) */
-    readonly dryRun?: boolean;
-}
-/**
- * Result structure returned from publishing operations.
- */
-interface PublishResult {
-    /** Whether the operation was successful */
-    readonly success: boolean;
-    /** The published article URL if successful */
-    readonly url?: string;
-    /** Platform-specific post ID */
-    readonly platformPostId?: string;
-    /** Publication timestamp as ISO 8601 string */
-    readonly publishedAt?: string;
-    /** Error information if unsuccessful */
-    readonly error?: {
-        /** Error code (PUB001-PUB011) */
-        readonly code: string;
-        /** Human-readable error message */
-        readonly message: string;
-        /** Additional error details */
-        readonly details?: Record<string, unknown>;
-    };
-    /** Validation warnings (for dry runs or minor issues) */
-    readonly warnings?: readonly string[];
-    /** Idempotency key used for this operation */
-    readonly idempotencyKey: string;
-}
-
-export type { PublishPayload, PublishResult, PublishedArticle, PublishedAuthor, PublishedAuthorSocialLinks, PublishedNewsletterSettings, PublishedSite, PublishedTopic };
+export { g as PublishPayload, f as PublishResult, a as PublishedArticle, c as PublishedAuthor, h as PublishedAuthorSocialLinks, d as PublishedNewsletterSettings, b as PublishedSite, P as PublishedTopic } from '../index-Dr8HaKGm.js';