@asteroidcms/core-utils 0.1.7 → 0.1.8

package/dist/index.cjs

@@ -3,6 +3,7 @@
 var client = require('@apollo/client');
 var context = require('@apollo/client/link/context');
 var error = require('@apollo/client/link/error');
+var jsxRuntime = require('react/jsx-runtime');
 
 // src/apollo/createApolloClient.ts
 function createErrorLink(onError) {
@@ -1064,8 +1065,384 @@ function extractHeadingsFromElement(root, options = {}) {
   return out;
 }
 
+// src/seo/seo.builders.ts
+function applyTitleTemplate(config, title) {
+  return config.titleTemplate ? config.titleTemplate(title) : `${title} | ${config.siteName}`;
+}
+function buildOgImageUrl(config, params) {
+  if (config.getOgImageUrl) {
+    return config.getOgImageUrl(params);
+  }
+  const palette = config.ogImage?.palette;
+  if (!palette) return void 0;
+  const apiPath = config.ogImage?.apiPath ?? "/api/og";
+  const base = config.baseUrl.replace(/\/$/, "");
+  const searchParams = new URLSearchParams({
+    title: params.title,
+    type: params.type ?? "article",
+    siteName: config.siteName,
+    bg: palette.background,
+    fg: palette.foreground,
+    accent: palette.accent
+  });
+  if (params.subtitle?.trim()) searchParams.set("subtitle", params.subtitle.trim());
+  if (params.eyebrow?.trim()) searchParams.set("eyebrow", params.eyebrow.trim());
+  if (palette.accentMuted) searchParams.set("accentMuted", palette.accentMuted);
+  if (palette.mutedText) searchParams.set("muted", palette.mutedText);
+  return `${base}${apiPath}?${searchParams.toString()}`;
+}
+function buildPageSeoValues(config, options) {
+  const base = config.baseUrl.replace(/\/$/, "");
+  const path = options.path ?? "/";
+  const url = `${base}${path.startsWith("/") ? path : `/${path}`}`;
+  const description = options.description?.trim() || config.defaultDescription || `${options.title} - ${config.siteName}.`;
+  return {
+    title: applyTitleTemplate(config, options.title),
+    siteName: config.siteName,
+    twitter: config.twitter ?? "",
+    description,
+    url,
+    keywords: options.keywords ?? config.defaultKeywords ?? options.title,
+    image: options.image ?? buildOgImageUrl(config, {
+      title: options.title,
+      subtitle: description,
+      eyebrow: options.eyebrow,
+      type: options.ogType === "article" ? "article" : "listing"
+    }),
+    noindex: options.noindex ?? config.noindex,
+    manifestUrl: config.manifestUrl
+  };
+}
+function resolveArticleImage(post, config) {
+  const featuredImage = config.cmsUrl ? cmsImage(post.featured_image, { cmsUrl: config.cmsUrl }) : "";
+  if (featuredImage) return featuredImage;
+  const description = post.meta_description?.trim() || post.description?.trim() || config.defaultDescription;
+  return buildOgImageUrl(config, {
+    title: post.title,
+    subtitle: description,
+    eyebrow: config.contentLabel ?? "Article",
+    type: "article"
+  });
+}
+function buildArticleSeoValues(post, config, slug, options) {
+  const articlePath = config.articlePath ?? "/blog";
+  const url = `${config.baseUrl.replace(/\/$/, "")}${articlePath}/${slug}`;
+  const description = post.meta_description?.trim() || post.description?.trim() || config.defaultDescription || `Read the latest from ${config.siteName}.`;
+  return {
+    title: applyTitleTemplate(config, post.title),
+    siteName: config.siteName,
+    twitter: config.twitter ?? "",
+    description,
+    url,
+    keywords: config.defaultKeywords ?? post.title,
+    image: resolveArticleImage(post, config),
+    noindex: options?.noindex ?? config.noindex,
+    manifestUrl: config.manifestUrl
+  };
+}
+function buildArticleListingSeoValues(config, options) {
+  const articlePath = config.articlePath ?? "/blog";
+  const base = config.baseUrl.replace(/\/$/, "");
+  const label = config.contentLabel ?? "Articles";
+  const categoryName = options?.categoryName?.trim();
+  const categorySlug = options?.categorySlug?.trim();
+  const titleText = categoryName ? `${categoryName} ${label}` : label;
+  const description = categoryName ? `Explore ${categoryName} ${label.toLowerCase()}, guides, and the latest updates from ${config.siteName}.` : config.defaultDescription || `Browse ${label.toLowerCase()}, insights, and the latest updates from ${config.siteName}.`;
+  const url = categorySlug ? `${base}${articlePath}/category/${categorySlug}` : `${base}${articlePath}`;
+  return {
+    title: applyTitleTemplate(config, titleText),
+    siteName: config.siteName,
+    twitter: config.twitter ?? "",
+    description,
+    url,
+    keywords: config.defaultKeywords ?? (categoryName ? `${categoryName}, ${config.siteName}` : `${config.siteName} ${label.toLowerCase()}`),
+    image: buildOgImageUrl(config, {
+      title: titleText,
+      subtitle: description,
+      eyebrow: categoryName ? "Category" : label,
+      type: "listing"
+    }),
+    noindex: options?.noindex ?? config.noindex,
+    manifestUrl: config.manifestUrl
+  };
+}
+function seoValuesToClientProps(values) {
+  return {
+    title: values.title,
+    description: values.description,
+    url: values.url,
+    siteName: values.siteName,
+    keywords: values.keywords,
+    twitter: values.twitter,
+    image: values.image,
+    noindex: values.noindex
+  };
+}
+
+// src/seo/jsonld.ts
+function buildSiteJsonLd(config) {
+  const siteUrl = config.baseUrl.replace(/\/$/, "");
+  const org = config.organization;
+  const organizationNode = {
+    "@type": "Organization",
+    "@id": `${siteUrl}/#organization`,
+    name: config.siteName,
+    legalName: config.siteName,
+    url: siteUrl
+  };
+  if (org?.logoUrl) {
+    organizationNode.logo = { "@type": "ImageObject", url: org.logoUrl };
+  }
+  if (org?.contactPhone || org?.contactEmail) {
+    organizationNode.contactPoint = {
+      "@type": "ContactPoint",
+      ...org.contactPhone ? { telephone: org.contactPhone } : {},
+      ...org.contactEmail ? { email: org.contactEmail } : {},
+      contactType: "customer service"
+    };
+  }
+  if (org?.address) {
+    organizationNode.address = {
+      "@type": "PostalAddress",
+      ...org.address.street ? { streetAddress: org.address.street } : {},
+      ...org.address.city ? { addressLocality: org.address.city } : {},
+      ...org.address.country ? { addressCountry: org.address.country } : {}
+    };
+  }
+  if (org?.socials?.length) {
+    organizationNode.sameAs = org.socials;
+  }
+  const websiteNode = {
+    "@type": "WebSite",
+    "@id": `${siteUrl}/#website`,
+    url: siteUrl,
+    name: config.siteName,
+    publisher: { "@id": `${siteUrl}/#organization` },
+    inLanguage: "en-US"
+  };
+  if (config.defaultDescription) {
+    websiteNode.description = config.defaultDescription;
+  }
+  return {
+    "@context": "https://schema.org",
+    "@graph": [organizationNode, websiteNode, ...config.extraJsonLdNodes ?? []]
+  };
+}
+function buildArticleJsonLd(props) {
+  return {
+    "@context": "https://schema.org",
+    "@type": props.articleType ?? "Article",
+    headline: props.title,
+    description: props.description,
+    url: props.url,
+    ...props.image ? { image: props.image } : {},
+    ...props.publishedTime ? { datePublished: props.publishedTime } : {},
+    ...props.category ? { articleSection: props.category } : {},
+    ...props.tags && props.tags.length > 0 ? { keywords: props.tags.join(", ") } : {},
+    author: { "@type": "Person", name: props.authorName || props.siteName },
+    publisher: { "@id": `${props.siteUrl}/#organization` },
+    isPartOf: { "@id": `${props.siteUrl}/#website` },
+    inLanguage: "en-US"
+  };
+}
+function buildCollectionJsonLd(props) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "CollectionPage",
+    name: props.name,
+    description: props.description,
+    url: props.url,
+    isPartOf: { "@id": `${props.siteUrl}/#website` },
+    publisher: { "@id": `${props.siteUrl}/#organization` },
+    inLanguage: "en-US"
+  };
+}
+function buildWebPageJsonLd(props) {
+  return {
+    "@context": "https://schema.org",
+    "@type": "WebPage",
+    name: props.name,
+    description: props.description,
+    url: props.url,
+    isPartOf: { "@id": `${props.siteUrl}/#website` },
+    publisher: { "@id": `${props.siteUrl}/#organization` },
+    inLanguage: "en-US"
+  };
+}
+var DEFAULT_PALETTE = {
+  background: "#0C0D10",
+  foreground: "#FFFFFF",
+  accent: "#EDB435",
+  accentMuted: "rgba(237,180,53,0.22)",
+  mutedText: "rgba(255,255,255,0.65)"
+};
+function parseOgImageSearchParams(searchParams) {
+  const palette = {
+    background: searchParams.get("bg") ?? DEFAULT_PALETTE.background,
+    foreground: searchParams.get("fg") ?? DEFAULT_PALETTE.foreground,
+    accent: searchParams.get("accent") ?? DEFAULT_PALETTE.accent,
+    accentMuted: searchParams.get("accentMuted") ?? DEFAULT_PALETTE.accentMuted,
+    mutedText: searchParams.get("muted") ?? DEFAULT_PALETTE.mutedText
+  };
+  return {
+    title: searchParams.get("title")?.trim() || "Articles",
+    subtitle: searchParams.get("subtitle")?.trim() || void 0,
+    eyebrow: searchParams.get("eyebrow")?.trim() || void 0,
+    siteName: searchParams.get("siteName")?.trim() || void 0,
+    variant: searchParams.get("type") === "listing" ? "listing" : "article",
+    palette
+  };
+}
+function truncateText(value, maxLength) {
+  const trimmed = value.trim();
+  if (trimmed.length <= maxLength) return trimmed;
+  return `${trimmed.slice(0, maxLength - 3).trimEnd()}...`;
+}
+function toSatoriColor(color) {
+  const rgbaMatch = color.match(
+    /^rgba?\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)(?:\s*,\s*([\d.]+))?\s*\)$/i
+  );
+  if (!rgbaMatch) return color;
+  const [, r, g, b, a = "1"] = rgbaMatch;
+  const hex = [r, g, b].map((channel) => Number(channel).toString(16).padStart(2, "0")).join("");
+  const alpha = Math.round(parseFloat(a) * 255).toString(16).padStart(2, "0");
+  return `#${hex}${alpha}`;
+}
+function OgImageContent({
+  title,
+  subtitle,
+  eyebrow,
+  siteName,
+  palette,
+  variant = "article"
+}) {
+  const displayTitle = truncateText(title, 120);
+  const displaySubtitle = subtitle ? truncateText(subtitle, 160) : void 0;
+  const displayEyebrow = eyebrow?.trim() || (variant === "listing" ? "Articles" : "Article");
+  const background = toSatoriColor(palette.background);
+  const foreground = toSatoriColor(palette.foreground);
+  const accent = toSatoriColor(palette.accent);
+  const accentMuted = toSatoriColor(palette.accentMuted ?? palette.accent);
+  const mutedText = toSatoriColor(palette.mutedText ?? palette.foreground);
+  return /* @__PURE__ */ jsxRuntime.jsxs(
+    "div",
+    {
+      style: {
+        width: 1200,
+        height: 630,
+        display: "flex",
+        flexDirection: "column",
+        background,
+        color: foreground,
+        fontFamily: "sans-serif"
+      },
+      children: [
+        /* @__PURE__ */ jsxRuntime.jsx("div", { style: { height: 6, background: accent } }),
+        /* @__PURE__ */ jsxRuntime.jsxs(
+          "div",
+          {
+            style: {
+              display: "flex",
+              flexDirection: "column",
+              justifyContent: "space-between",
+              flex: 1,
+              padding: "66px 80px 72px"
+            },
+            children: [
+              /* @__PURE__ */ jsxRuntime.jsx(
+                "div",
+                {
+                  style: {
+                    display: "flex",
+                    alignItems: "center",
+                    padding: "10px 18px",
+                    borderRadius: 999,
+                    border: `1px solid ${accentMuted}`,
+                    color: accent,
+                    fontSize: 22,
+                    fontWeight: 700,
+                    letterSpacing: 0,
+                    textTransform: "uppercase",
+                    alignSelf: "flex-start"
+                  },
+                  children: displayEyebrow
+                }
+              ),
+              /* @__PURE__ */ jsxRuntime.jsxs("div", { style: { display: "flex", flexDirection: "column", maxWidth: 980 }, children: [
+                /* @__PURE__ */ jsxRuntime.jsx(
+                  "div",
+                  {
+                    style: {
+                      fontSize: displayTitle.length > 70 ? 52 : 64,
+                      fontWeight: 800,
+                      lineHeight: 1.05,
+                      letterSpacing: 0,
+                      color: foreground
+                    },
+                    children: displayTitle
+                  }
+                ),
+                displaySubtitle ? /* @__PURE__ */ jsxRuntime.jsx(
+                  "div",
+                  {
+                    style: {
+                      marginTop: 24,
+                      fontSize: 28,
+                      lineHeight: 1.4,
+                      color: mutedText,
+                      maxWidth: 900
+                    },
+                    children: displaySubtitle
+                  }
+                ) : null
+              ] }),
+              siteName ? /* @__PURE__ */ jsxRuntime.jsxs(
+                "div",
+                {
+                  style: {
+                    display: "flex",
+                    alignItems: "center",
+                    justifyContent: "space-between",
+                    fontSize: 24,
+                    fontWeight: 700,
+                    color: accent
+                  },
+                  children: [
+                    /* @__PURE__ */ jsxRuntime.jsx("span", { children: siteName }),
+                    /* @__PURE__ */ jsxRuntime.jsx(
+                      "div",
+                      {
+                        style: {
+                          width: 72,
+                          height: 4,
+                          borderRadius: 999,
+                          background: accent
+                        }
+                      }
+                    )
+                  ]
+                }
+              ) : /* @__PURE__ */ jsxRuntime.jsx("div", { style: { display: "flex" } })
+            ]
+          }
+        )
+      ]
+    }
+  );
+}
+
+exports.OgImageContent = OgImageContent;
+exports.applyTitleTemplate = applyTitleTemplate;
+exports.buildArticleJsonLd = buildArticleJsonLd;
+exports.buildArticleListingSeoValues = buildArticleListingSeoValues;
+exports.buildArticleSeoValues = buildArticleSeoValues;
 exports.buildCmsMutation = buildCmsMutation;
 exports.buildCmsQuery = buildCmsQuery;
+exports.buildCollectionJsonLd = buildCollectionJsonLd;
+exports.buildOgImageUrl = buildOgImageUrl;
+exports.buildPageSeoValues = buildPageSeoValues;
+exports.buildSiteJsonLd = buildSiteJsonLd;
+exports.buildWebPageJsonLd = buildWebPageJsonLd;
 exports.cmsImage = cmsImage;
 exports.cmsMutate = cmsMutate;
 exports.createApolloClient = createApolloClient;
@@ -1073,8 +1450,10 @@ exports.extractHeadingsFromElement = extractHeadingsFromElement;
 exports.extractHeadingsFromHtml = extractHeadingsFromHtml;
 exports.fetchCmsContent = fetchCmsContent;
 exports.getContentReadTime = getContentReadTime;
+exports.parseOgImageSearchParams = parseOgImageSearchParams;
 exports.parseRichText = parseRichText;
 exports.removeEmptyParagraphs = removeEmptyParagraphs;
+exports.seoValuesToClientProps = seoValuesToClientProps;
 exports.slugify = slugify;
 //# sourceMappingURL=index.cjs.map
 //# sourceMappingURL=index.cjs.map